Built-in DOP functions
GET_MSG function
Role This function is used to display, on the screen of a CCX 17 console, a message with a variable which can be modified by the operator.
The entry is made in multiple mode. The operator thus has the possibility of entering several variables successively, and the PLC program processes the entered value when the variable appears.
Implementation Implementation of the GET_MSG function is developed in the Description of parameters (See Description of the parameters common to the different DOP
functions, p. 276) section.
Specific parameter: Value
The Value parameter specifies the characteristics of the value which is associated to the variable.
If the choice is… The value…
Not checked entry on the CCX 17 console keyboard is free (1).
Limited
Increment entry on the CCX 17 console keyboard must be within the limits defined by the Min and Max values in the Entry field in order to be taken into account by the application (1).
display on the CCX 17 console screen is incremented or decremented from the value of the increment (1).
Key
(1) The value or the increment entered on the CCX 17 console keyboard follows the display format (e.g.: 9999.99), this determines the whole parts and decimal parts authorized by the user entry.
Example of application
The example given below makes use of the GET_MSG function to display a status message containing a variable which can be modified on the screen of a T CCX
1720 W console without application.
This is connected to a TSX Premium via the AUX port (configured in UNI-TELWAY link, addresses 4 - 5).
Note: This same example, using a CCX 17 with application, is shown using the
GET_VALUE function.
TLX DS 37 PL7 xxE
295
Built-in DOP functions
Application description Variables used
Initial conditions l l l writing the console address (ADR#0.04) in a table of words, adjustment of timeout to 50 s, condition of execution,
Application: The aim of this example is, on user request: l to display a status message on the console screen: l Temperature = xxx °C (standard format, automatic centering,
Line 6, variable with attributes: increment of 50, three-digit integer, l periodic refreshing), storing the function execution.
%MW0:6: console address
%KW80:x: data to be sent.
%MW100:4: report
%MW100:X0: activity bit
%MW102: timeout
%M102: activation condition
%MW10: Temperature variable
Introduction to the console
Message displayed on user request
Temperature = xxx °C
Program corresponding to the application
( * INIT console address, condition, timeout
*)
IF %S1.3 THEN
%MW0:6:=ADR#0.0.4;
%MW102:=500;
%M102:=0;
END_IF;
(* Write message Temp… *)
IF NOT %M102 AND NOT %MW100:X0 THEN
GET_MSG(%MW0:6,%KW100:28,%MW100:4);
SET %M102;
END_IF;
296
TLX DS 37 PL7 xxE
TLX DS 37 PL7 xxE
Built-in DOP functions
Entry help screen corresponding to the application:
GET_MSG
Parameters
Console address:
Data to Send:
%MW0
%KW1000 34
Message
Text: Temperature=____°C
Position
Mode
Manual
Line 6 Column
Column alignment
Auto Left
11
Centered Right
Report:
Print
Attributes
Flashing
%MW100
Reverse video
Size
4
Standard
Double
Field
Symbol:
Comment:
Display format
Entry
Value
Not Checked
Address:
Limited
%MV10
999
Update
Modify
Increment
Increment: 50
Ok Cancel
297
