Functions

@@0 Numeric Validation

Numeric validation is a special function that is used in almost all applications. It ensures that if an entry is not placed between specified numeric boundaries it will not be accepted into the field.  Instead an error message is displayed and the cursor is positioned in the field containing the invalid value. If the field is not changed, then no validation check is performed.

Syntax

Field ID

The field ID is the direct address to data.  It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note: If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Max. Value

The maximum value (included) can be defined as an integer or a real number with decimal points.

Min. Value

The minimum value (included) can be defined as an integer or a real number with decimal points.

Example

#500;1;-1;-2;-3;01;00;79;

@@28;SWT;3;65;100;19;150;Example;

@@24;\OK;0;7;?0;;;P;T;F0;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

@@0;*87;1;3;

_

_Value_(1-3)_*_87&

_

_$\OK___&_$Cancel&_$Help__&

@@1 Text Validation

To validate a new text string specific fields must be tested (against at least 10 already accepted text strings). You can ensure that the third character in a compound key is always A or B. Text validation occurs automatically if at least one character has been changed or not a space.

If the validation fails, then an error message is displayed and the cursor is positioned in the field where the failure occurred.

Note:  Text validation is only applied to text fields (fields beginning with $).

Syntax

Field ID

The field ID is the direct address to data.  It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field. Note: If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Example

#500;1;-1;-2;-3;01;00;79;

@@28;SWT;3;65;100;19;150;Example;

@@24;\OK;0;7;?0;;;P;T;F0;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

@@1;$42;1;3;MON;TUE;WED;THU;FRI;

_

_Day_$42_&

_$\OK___&_$Cancel&_$Help__&

@@5 Data Transfer from Indexed Files

To view panel descriptions without having to specify vast amounts of data, transfer an indexed file directly into the panel by following the procedure illustrated below.

Syntax

File Name

These file names are available with the @@5 function:

File name Description
DPRE Shift model days (daily production time)
UPRE Shift pattern lines (weekly production time)
AKRE Capacity adjustments
RCRE Work center resources
MGRE Work centers
PKRE Non-working days
TTRE Transit time matrix
ORDH End item orders
MRED Parallel operations
SEQC Sequence optimization controls
SHIP Order links

Index

The index number as defined in the PMSTYF99.DAT file.

Search Key

This feature defines a search key, which can be used to identify records in the REGS file. You can use the field number or the field reference as the search key. If you require several fields for your definition, a slash [/] can be used to connect the fields you want to apply. In the case of @@30, the search key can be set to null. In this case all entries would be searched.

Receiving Field

To define the field to which data is transferred, you can use the field number or field reference.

Offset in Source

The offset position in the REGS file record is the start point from which the data transfer begins. The transfer of data to the field defined as the receiving field continues until the field is filled. (The number of bytes transferred is equal to the length of the receiving field).

Example

#80;1;-1;-2;-3;01;00;79;

@@28;SWT;5;28;100;4;180;Order_Export;

@@33;CRPORT00;

@@24;OK;1;7;?0;-2;;PNPF3;T;F3;

@@24;Help;1;7;?0;-2;;PH;

_

_

_$OK_________$Help______&

#81;1;-1;-2;-3;01;00;79;

_!Item_number_______________!Field_1_______!Field_2___!Field_3____!Field_4

#82;1;-1;-2;-3;01;00;79;

@@5;EXOI;1;$113;$875;34;$888;74;$897;114;$907;154;

_$113______________________&$875__________&$888______&$897_______&$907__&

@@6 Inclusion of Control Character

When you place a start control character in the first field, it is applied to all the fields in a given string. If a start control character is not present, the panel system defines the position as being the first character in the field and the space position is omitted. You can place different fields side by side without space separation. This method is useful when consolidating strings that do not follow a field reference.

Note:  You cannot include the end control character (&) in the field.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Example

#23;1;-1;-2;-3;00;01;79;

@@6;$45;

$45__________&$69__&$57__________*_21&_`45_`46_`47_&`7__`8__`9__&_~48__~49_&_+3_:__+4_:__+5_:__+1_:__+2_:__&__+30:__&_*58&

@@7 Calculation Field Definition

The @@7 function can be used in panel fields to perform simple calculations such as plus, minus, multiply and divide. Nevertheless, possible rounding off errors may occur under these circumstances. We recommend that you avoid use of the REAL format whenever possible.

If you use dates in your calculations, then specify the dates in seconds use an [~] instead of a [^]. For further detail refer to Example number 2 shown below.

Note:  There might be a minor calculation error when small or large numbers are included in this function.

Syntax

Receiving Field

To define the field to which data is transferred, you can use the field number or field reference.

X (first calculation number)

X is the first number in the calculation.

Note:  A K must precede the number if its value is a constant.

Operator

The operator can be P (plus), M (minus), G (multiply) or D (divide).

Y (second calculation number)

Y is the second number in the calculation.

Note:  If the number is a constant, then you must place a K just before it.

Example 1

@@7;14;`50DK750;

$625_________________~136______&_________`29______.&^56____"56__^57____"57__ù65:__ù22_:__&*70*125&$385_________&$171_______&`____&

The value in the field with offset `50 is divided with the constant 750. The result of the calculation is placed in field 14 shown below:

Example 2

@@7;16;~56M~37DK3600;

$625_________________~136______$269_________&^107___"107_&*__181&^56____"56__ù65:__&$159_________&*70*125$_129&_^37____"37__&~________&

The two dates are subtracted and the result is given in number of hours.

@@13 Exit Action

The exit action (or after-process function) is activated when you have finish editing the panel and before returning to the application. At this point, you can re-edit or insert default values into various data areas, regardless of the content of the fields.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field value

The value to be inserted into the field at exit, regardless of the field content.

Special Action

These special actions can be used:

RETURN VALUE Action

Syntax: FIELD REFERENCE; VALUE RETURNED

This action returns values to the field described by the field reference The control character in the field reference gives the field type.

REXX Call Action

Syntax: Cx

"x" is the REXX command number with a range from 1 to 99.

In the startup CMD file you can specify environment variables to define the REXX command file attached to the REXX command number, such as SET REXXC1 = C:\REXX\BACKUP.CMD. If no environment variables are defined, then the default REXX command filenames are REXXC1.CMD, REXXC2.CMD, and REXXC99.CMD.

PANEL Action

Syntax: Sx

"x" is a positive number, interpreted here as a panel number. Without returning to the calling program, the panel system handles the panel that is specified in the action as if a call was made to display the panel. You can divide one panel into other panels without changing the calling program.
Note: The data arrays are the same for the whole series of panels.

TERMINATE WINDOW Action

Syntax: T

The window is terminated.

FUNCTION KEY Action

Syntax: Fx

where "x" is defined as the function key number to be simulated. It can contain be one or more digits The action simulates the use of the key and is performed immediately such that the rest of the special function definition is skipped. F0 is treated as if the Enter (Return) key was pressed and F3 is treated as the Escape (Esc) key.

DELAY Action

Syntax: Wx

Where "x" is a positive number interpreted as a delay in seconds.

The panel system waits the specified number of seconds before resuming.

Example

#20;1;-1;-2;-3;00;00;79;

@@28;SwTSbE;1;80;90;50;50;Work_Center_Resources;

@@33;CRCREG00;

@@31;$1;0;15;?65001;"Work_center_resources";;1;MLWf;0;

@@27;LBOX;TECLShSv;?65001;;;11;1000;0;;D-6;D-4;D+1;D+3;F2;

@@24;Search;1;7;?0;"Search";;1;SL02TNpF5;.ICO=14;CN;F6;

@@24;Open;1;7;?0;"Open";20;1;SL02DTK(\OPEN);.ICO=66;CN;F2;

@@24;New;1;7;?0;"New";;1;SL02TK(INSERT)D(2);.ICO=59;CN;F4;

@@24;Delete;1;7;?0;"Delete";;1;SL02TK(L:DELETE)D(2);.ICO=103;CN;F5;

@@24;Print;1;7;?0;"Print";;1;SL02TK(\PRINT);.ICO=57;CN;F9;

@@24;Close;1;7;?0;"Close";20;1;SL02TF3;.ICO=13;CN;T;F3;

@@24;Help;1;7;?0;"Help";;1;SL02TH;.ICO=71;LM;

@@13;*101;4;*102;1;*103;22;*104;23;*105;21;$211;N;

@@24;[Open;0;7;;;;MLK(\OPEN);F2;

@@24;[New;0;7;;;;MLK(INSERT)D(2);F4;

@@24;[Delete;0;7;;;;MLK(L:DELETE)D(2);F5;

@@24;[Print;0;7;;;;MsLK(\PRINT);F9;

@@24;[Refresh_list;0;7;;;;MWLK(F5);F6;

@@13;*101;4;*102;1;*103;22;*104;23;*105;21;$211;N;

$1___________&________$Search$Open$New_$Delete$Print__$Close$Help____&

$LBOX&

$[Open_______________&

$[New________________&

$[Delete_____________&

$[Print______________&

$[Refresh_list________&

@@14 Panel Timeout

By using the panel timeout function you can control timed actions or display ongoing progress panels. The timer starts when the panel is created.

Syntax

Timeout Value

Value used to define the number of seconds to wait. These values are available:

< 0         The number of seconds to wait is taken from the system parameter.

= 0         There is no waiting (used in-progress windows).

> 0         The number of seconds to wait.

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Value Field

Shows the values/columns in the list box where the calculations will be performed.

Disable Action

Syntax:   Dx, D+x, D-x

For Dx, "x" is a positive number interpreted as the absolute field number.

For D+x or D-x, "x" is a positive number interpreted as the relative field number to the current field.

Examples

@@27;LBOX;HTE;?2002;;;10;1000;0;;D4;D6;F2;

@@24;\Item_number;1;7;?10231;;;R;*231;3;D+4;

@@24;\All;1;7;?10231;;;R;D2;*231;1;D-1;D-4;

Special Action

These special actions can be used:

RETURN VALUE Action

Syntax: FIELD REFERENCE; VALUE RETURNED

This action returns values to the field described by the field reference. The control character in the field reference gives the field type.

REXX Call Action

Syntax: Cx

"x" is the REXX command number with a range from 1 to 99.

In the startup CMD file you can specify environment variables to define the REXX command file attached to the REXX command number, such as SET REXXC1 = C:\REXX\BACKUP.CMD. If no environment variables are defined, then the default REXX command filenames are REXXC1.CMD, REXXC2.CMD, and REXXC99.CMD.

FUNCTION KEY Action

Syntax: Fx

where "x" is defined as the function key number to be simulated. It can contain be one or more digits. The action simulates the use of the key and is performed immediately such that the rest of the special function definition is skipped. F0 is treated as if the Enter (Return) key was pressed and F3 is treated as the Escape (Esc) key.

PANEL Action

Syntax: Sx

 "x" is a positive number, interpreted here as a panel number. Without returning to the calling program, the panel system handles the panel that is specified in the action as if a call was made to display the panel. You can divide one panel into other panels without changing the calling program.
Note: The data arrays are the same for the whole series of panels.

TERMINATE WINDOW Action

Syntax: T

The window is terminated.

DELAY Action

Syntax: Wx

Where "x" is a positive number interpreted as a delay in seconds.

The panel system waits the specified number of seconds before resuming.

Example

#13;2;-1;-2;-3;01;00;79;

@@28;SWT;3;66;100;8;150;AT_Timing_Function;

@@14;60;F0;

@@24;OK;0;7;?0;;;PNPF3;T;F4;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

_Press_OK_in_order_to_execute_function_immidiately:______<$1___&>

_

_Scheduled_at:____<^1_____"1_____&_Time_is_now:____^2_____"2_____&>

_

_Press_Cancel_in_order_to_exit_macro_mode.

_

_$OK________________&$Cancel___________&$Help_____________&

@@15 Data Input from External File

This function is used when data from an external system is specified into the REGS register. Data in the external file is mapped through the use of a panel. After being formatted as a sequential access file, each record in the external file is transferred to a record in the REGS register. Validations can be conducted by using ordinary panel functions. If there are any errors or problems, you can make adjustments based on the use of functional definitions.

File Name

These file names are available with the @@15 function:

File name Description
DPRE Shift model days (daily production time)
UPRE Shift pattern lines (weekly production time)
AKRE Capacity adjustments
RCRE Work center resources
MGRE Work centers
PKRE Non-working days
TTRE Transit time matrix
ORDH End item orders
MRED Parallel operations
SEQC Sequence optimization controls
SHIP Order links

Validation Actions

These variables can be used for validation actions:

Variable Action
W Waits for corrective input from the user. The user can alter the field in the panel.
X Excludes the record if an error occurred. The entire record is skipped.
ADD The record is added to the file database through the index. If it already exists the record will be ignored.
INS The record is inserted in the file database without using index. The indexes are generated later. This input method is faster than ADD but requires unique records.
REP The record is replaced in the file database if it exists.
DEL The record is deleted in the file database if it exists.
Index The index number as defined in the PMSTYF99.DAT file.
S The input file format is based on semi-colon separated fields.
F The input file format is based on fixed positioned fields.
N No display. When reading the data file nothing is displayed on the screen - faster read.

Example

@@15;RCRE;X;ADD;1;F;

Machine_number_$45__________&

Description____$85____________________________&

Location_______$73__________&

@@21 Insert Actual Date and Time

This function can only be used to specify the actual (system) date and time and to insert it into the available date and time fields.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Example

@@21;^2;

@@21;"2;

Start_of_the_schedule___^2_____"2___&

@@22 Inclusion of Report Line

This function is used to validate the content of the data that are specified in the reference. If the value is greater than or equal to the "from" value and less than or equal to the "to" value then the report line is displayed. If the value does not fall within this definition the report line will not be displayed.

Note:  Only used in list report body panels.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Max. Value

The maximum value (included) can be defined as an integer or a real number with decimal points.

Min. Value

The minimum value (included) can be defined as an integer or a real number with decimal points.

Example

#23;1;-1;-2;-3;00;01;79;

@@22;`45;100.0;200.0;

@@22;`46;100.0;200.0;

@@22;`47;100.0;200.0;

$45__________&$69__&$57__________*_21&_`45_`46_`47_&`7__`8__`9__&_~48__~49_&_+3_:__+4_:__+5_:__+1_:__+2_:__&__+30:__&_*58&

@@23 Exclusion of Report Line

This function is also used to validate the content of the data specified in the reference. If this value is less than the "from" value and greater than the "to" value then the report line is displayed. If this criterion is not met then the report line will not be displayed.

Note:  Only used in list report body panels.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Max. Value

The maximum value (included) can be defined as an integer or a real number with decimal points.

Min. Value

The minimum value (included) can be defined as an integer or a real number with decimal points.

Example

#23;1;-1;-2;-3;00;01;79;

@@23;`45;0.0;99.9;

@@23;`46;0.0;99.9;

@@23;`47;0.0;99.9;

$45__________&$69__&$57__________*_21&_`45_`46_`47_&`7__`8__`9__&_~48__~49_&_+3_:__+4_:__+5_:__+1_:__+2_:__&__+30:__&_*58&

@@24 Button Definition

Use this function to redefine the fields associated with a button. Possible button types are:

  • Push button
  • Radio button
  • Check box

The type of button is defined by control attributes.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with he ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field text

For the most part, the field text definition is used for the following @@ functions to establish a connection between the function and the field: @@24 Button Definition, @@27 Listbox Definition and @@29 Static Control Definition.

Use the starting control characters together with the field text.

Note:  If the field text in the @@ function and the related field does not correspond, the field is an entry field.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Group Number

The group number is only important for radio buttons. It determines how the click and unclick of the radio buttons are performed.  Radio buttons that are grouped together must have a unique group number greater than zero. To move the cursor focus within a group, use the arrow keys on your keyboard. The [TAB] key can be made to jump between groups.

Note:  If the group number = 0, then the control will be in its own group. If the group number < 0 the control will has not been created.

Color Code

Color includes both the foreground and the background color.  The color code is calculated by the using this formula:

Color code = 100 X FOREGROUND COLOR CODE + BACKGROUND COLOR CODE

Note:  The default color can not be changed when using the @@29 - @@32 functions.

Examples

The number (7) represents a pale grey background with black text.

The number (0313) represents a dark cyan background with yellow text.

Color Code Table

Code Color   Code Color
00 Black   10 Dark red
01 Red   11 Dark pink
02 Dark green   12 Green
03 Yellow   13 Dark cyan
04 Blue   14 Brown
05 Pink   15 White
06 Cyan   16 Light green
07 Pale grey   17 Pale green
08 Dark grey   18 Default list box yellow
09 Dark blue   19 Light yellow

Help Number

Syntax:        ?x

The "x" is the help ID in the IPF file and is an integer from 1 to 65535. If ? 0 is given, then the help ID is calculated with respect to the field.

The help number is reserved in this way:

Value Reserved
1 <= x = 999 Panel help
1000 = x = 9999 Component help
10000 = x = 19999 Field help (2 byte integer)
20000 = x = 29999 Field help (4 byte integer, real, date and time)
30000 = x = 39999 Field help (Characters)
30001 = x = 65535 General help

Relative Character Position

This function defines a relative character position as it relates to a current character position. If no value is given the character position is defined as the current character position.

Relative Line Position

This function defines the relative line position as it relates to the current line position. If no value is given the position is defined as the current line position.

Control attributes

Control character Add-ons Description Example
C   Check box @@24;PEG_ID_suffix;5;7;?0;;;C;*184;1;|;*184;0;
D   Default button @@24;\View_now;0;7;?0;- -;;PD;F0;
E (New)   Tab button @@24;\Standard;0;7;?0;;;ED;F10021;
     I  (New) Icon on tab button @@24;\Standard;0;7;?0;;;EiD;F10021;
Fxx   Attach to function key xx, xx={2,3,...,12} @@24;Cancel;0;7;?0;;;- PNPF3;T;F3;
H   Help button @@24;Help;0;7;?0;;;PH;
K( )  (New)   Hotkey @@24;Print;0;7;?0;"Print...";1;SL02TK(CONTROL+P);.ICO=57;CN;F9;
L01 (New)   Link type 1 (bitmap/text pushbutton with no raised border) @@24;Print;0;7;?0;"Print...";;1;SL01TK(CONTROL+P);.ICO=57;CN;F9;
L02 (New)   Link type 2 (bitmap/text pushbutton with single border) @@24;Print;0;7;?0;"Print...";;1;SL02TK(CONTROL+P);.ICO=57;CN;F9;
L03 (New)   Link type 3 (color) @@24;*100;0;7;?0;"";;;L03;;;*145;1;F2;
L04 (New)   Link type 4 (Change the background/ foreground color by holding down the left mouse button and clicking on the field you want to change) @@24;\Orders;1;1530;?40500;;;SL04;0931;M;$3;DSCH;
L05 (New)   Link type 5 (Like  L04,but with a frame) @@24;\Orders;1;1530;?40500;;;SL05;0931;M;$3;DSCH;
L06 (New)   Link type 6 (Raises a flat icon when the mouse is placed on the field.) @@24;I60;0;7;?0;"Scenario__(Home)";5;;SL06K(HOME);.ICO=60;CN;F2;
L07 (New)   Link type 7 (Used for color buttons) @@24;04;2;00;?0;Color_0;4;;L07T;;;~1;00;F0;
M (New)   Pop up menu @@24;Open_resource...__(Alt+O);0;7;;;;Ml;F2;
  s (New) Separator line @@24;Print...__(Control+P);0;7;;;;Msl;F9;
  b (New) Menu break @@24;Print...__(Control+P);0;7;;;;Mbl;F9;
  c (New) Use checkmark @@24;Delay;1;7;;;;Mcl;*33;3;F40;
  l (New) Linked to list box @@24;Open_resource...__(Alt+O);0;7;;;;Ml;F2;
  w (New) Linked to windows @@24;Update_list__(Control+F);0;7;;;;Mwl;F6;
  a (New) Linked to all @@24;Open_resource...__(Alt+O);0;7;;;;Mal;F2;
  xx (New) Linked to field number @@24;Delete_log_file...__(Alt+D);0;7;;;;M9;F5;
Np   No pointer focus @@24;Cancel;0;7;?0;;;P NPF3;T;F3;
P   Push button @@24;OK;0;7;?0;;;P;F0;
  i Icon Push button @@24;I20;0;7;?0;;;PINP--;*2;0;F8;
R   Radio button @@24;\Delay;1;7;?0;;;R--;*172;2;
S   Dynamic size  
T (New)   Toolbar control @@24;Print;0;7;?0;"Print...";;1;SL02TK(CONTROL+P);.ICO=57;CN;F9;
X   Disable if read-only mode @@24;Backup;0;7;?0;;;P- X;F0;

Value Field

Shows the values/columns in the list box where the calculations will be performed.

Disable Action

Syntax:   Dx, D+x, D-x

For Dx, "x" is a positive number interpreted as the absolute field number.

For D+x or D-x, "x" is a positive number interpreted as the relative field number to the current field.

Special Action

These special actions can be used:

RETURN VALUE Action

Syntax: FIELD REFERENCE; VALUE RETURNED

This action returns values to the field described by the field reference. The control character in the field reference gives the field type.

REXX Call Action

Syntax: Cx

"x" is the REXX command number with a range from 1 to 99.

In the startup CMD file you can specify environment variables to define the REXX command file attached to the REXX command number, such as SET REXXC1 = C:\REXX\BACKUP.CMD. If no environment variables are defined, then the default REXX command filenames are REXXC1.CMD, REXXC2.CMD, and REXXC99.CMD.

FUNCTION KEY Action

Syntax: Fx

where "x" is defined as the function key number to be simulated. It can contain be one or more digits. The action simulates the use of the key and is performed immediately such that the rest of the special function definition is skipped. F0 is treated as if the Enter (Return) key was pressed and F3 is treated as the Escape (Esc) key.

PANEL Action

Syntax: Sx

"x" is a positive number, interpreted here as a panel number. Without returning to the calling program, the panel system handles the panel that is specified in the action as if a call was made to display the panel. You can divide one panel into other panels without changing the calling program. 
Note: The data arrays are the same for the whole series of panels.

TERMINATE WINDOW Action

Syntax: T

The window is terminated.

DELAY Action

Syntax: Wx

Where "x" is a positive number interpreted as a delay in seconds.

The panel system waits the specified number of seconds before resuming.

Example

#500;1;-1;-2;-3;01;00;79;

@@28;SWT;5;25;100;5;200;Titlebar_text;

@@24;\OK;0;7;?0;;;PD;F0;

_

_Button_example

_

_______$\OK___&

@@25 Message Box Creation Definition

This function is used to create a standard message box. You can define the type of icons and buttons you prefer.

Syntax

Icon Type

Control character Description
N No icon
? Query
W Warning
I Information
E Error
C Critical

Button Types

Control character Description
A Abort  Retry  Ignore
C Cancel
E Enter
EC Enter  Cancel
H Help
O OK
OC OK  Cancel
R Retry  Cancel
Y Yes  No
YC Yes  No  Cancel
1 Button 1 is default
2 Button 2 is default
3 Button 3 is default

Title Bar Text

Text length must not exceed 60 characters.

Always use underscores [ _ ] as spaces.

Example

#114;1;144;144;144;01;00;79;

@@25;W;Y;System_message_99114W;

@@26;Y;F0;

@@26;N;F3;

@@26;C;F3;

Dimension_of_list_is_reached.

Max_dimension_is_*1___&lines.

_

Clear_list_and_continue?

_

@@26 Message Box Action Definition

This function is used to determine what actions message box buttons must execute.

Syntax

Action button

Control character Action
A Abort
C Cancel
E Enter
H Help
I Ignore
N No
O OK
R Retry
Y Yes

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Value Field

Shows the values/columns in the list box where the calculations will be performed.

Special Action

These special actions can be used:

RETURN VALUE Action

Syntax: FIELD REFERENCE; VALUE RETURNED

This action returns values to the field described by the field reference. The control character in the field reference gives the field type.

REXX Call Action

Syntax: Cx

"x" is the REXX command number with a range from 1 to 99.

In the startup CMD file you can specify environment variables to define the REXX command file attached to the REXX command number, such as SET REXXC1 = C:\REXX\BACKUP.CMD. If no environment variables are defined, the default REXX command filenames are REXXC1.CMD, REXXC2.CMD, and REXXC99.CMD.

FUNCTION KEY Action

Syntax: Fx

where "x" is defined as the function key number to be simulated. It can contain be one or more digits. The action simulates the use of the key and is performed immediately such that the rest of the special function definition is skipped. F0 is treated as if the Enter (Return) key was pressed and F3 is treated as the Escape (Esc) key.

PANEL Action

Syntax: Sx

"x" is a positive number, interpreted here as a panel number. Without returning to the calling program, the panel system handles the panel that is specified in the action as if a call was made to display the panel. You can divide one panel into other panels without changing the calling program.
Note: The data arrays are the same for the whole series of panels.

TERMINATE WINDOW Action

Syntax: T

The window is terminated.

DELAY Action

Syntax: Wx

Where "x" is a positive number interpreted as a delay in seconds.

The panel system waits the specified number of seconds before resuming.

Example

#114;1;144;144;144;01;00;79;

@@25;W;Y;System_message_99114W;

@@26;Y;F0;

@@26;N;F3;

@@26;C;F3;

Dimension_of_list_is_reached.

Max_dimension_is_*1___&lines.

_

Clear_list_and_continue?

_

Note:  Use @@26;C;F3; if you want the action to occur when the message box system menu is closed.

@@27 List Box Definition

This function is used to redefine a field as a list box. A list box can contain colored text and bar graphs. Refer to the following for further details.

In all installed panels the field text LBOX are used as a link between the @@ function and the field.

Disable action will be executed when nothing is selected in the list box. This function is used to disable, for example, the Open and Delete buttons in the example given below.

Double clicking in the list box will initiate a Special action.

If no selection is made, the color code for the list box will be the same as the one for the background default screen.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field text

For the most part, the field text definition is used for the following @@ functions to establish a connection between the function and the field: @@24 Button Definition, @@27 Listbox Definition and @@29 Static Control Definition.

Use the starting control characters together with the field text.

Note:  If the field text in the @@ function and the related field does not correspond, the field is an entry field.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field. I: If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Control attributes

Control character Description Example
H Horizontal scrollbar @@27;LBOX;HTE;?2002;;;10;1000;0;;D4;D6;F2;
N No selection @@27;LBOX;G1TN;?0;;;11;1000;0;;F99;
M Multiple selection @@27;LBOX;G1MT;?0;;;11;1000;0;;F2;
E Extended selection @@27;LBOX;HTE;?2002;;;10;1000;0;;D4;D6;F2;
T Table header visible @@27;LBOX;HTE;?2002;;;10;1000;0;;D4;D6;F2;
G (default) Owner drawn text list box @@27;LBOX;GHTE;?2002;;;10;1000;0;;D4;D6;F2
G0 Standard list box @@27;LBOX;G0HTE;?2002;;;10;1000;0;;D4;D6;F2;
G1 Owner drawn text and bar graphic list box @@27;LBOX;G1T;?0;;;11;1000;0;;F2;

Help Number

Syntax:        ?x

The "x" is the help ID in the IPF file and is an integer from 1 to 65535. If ? 0 is given, then the help ID is calculated with respect to the field.

The help number is reserved in this way:

Value Reserved
1 <= x = 999 Panel help
1000 = x = 9999 Component help
10000 = x = 19999 Field help (2 byte integer)
20000 = x = 29999 Field help (4 byte integer, real, date and time)
30000 = x = 39999 Field help (Characters)
30001 = x = 65535 General help

Relative Character Position

This function defines a relative character position as it relates to a current character position. If no value is given the character position is defined as the current character position.

Relative Line Position

This function defines the relative line position as it relates to the current line position. If no value is given the position is defined as the current line position.

Visible Lines

This value defines the height measured in number of lines in the panel.

Max. Number of Lines

This value defines the maximum number of lines allowed (most often set to 1000 lines).

Visible Characters

Integer > 0 and < 132. This defines the number of visible characters. If no value is given, then the length of the field defines the number of visible characters.

Color Code

Color includes both the foreground and the background color. The color code is calculated by the using this formula:

Color code = 100 X FOREGROUND COLOR CODE + BACKGROUND COLOR CODE

Note:  The default color can not be changed when using the @@29 - @@32 functions

Examples

The number (7) represents a pale grey background with black text.

The number (0313) represents a dark cyan background with yellow text.

Color Code Table

Code Color   Code Color
00 Black   10 Dark red
01 Red   11 Dark pink
02 Dark green   12 Green
03 Yellow   13 Dark cyan
04 Blue   14 Brown
05 Pink   15 White
06 Cyan   16 Light green
07 Pale grey   17 Pale green
08 Dark grey   18 Default list box yellow
09 Dark blue   19 Light yellow

Value Field

Shows the values/columns in the list box where the calculations will be performed.

Disable Action

Syntax:   Dx, D+x, D-x

For Dx, "x" is a positive number interpreted as the absolute field number.

For D+x or D-x, "x" is a positive number interpreted as the relative field number to the current field.

Special Action

These special actions can be used:

RETURN VALUE Action

Syntax: FIELD REFERENCE; VALUE RETURNED

This action returns values to the field described by the field reference. The control character in the field reference gives the field type.

REXX Call Action

Syntax: Cx

"x" is the REXX command number with a range from 1 to 99.

In the startup CMD file you can specify environment variables to define the REXX command file attached to the REXX command number, such as SET REXXC1 = C:\REXX\BACKUP.CMD. If no environment variables are defined, then the default REXX command filenames are REXXC1.CMD, REXXC2.CMD, and REXXC99.CMD.

FUNCTION KEY Action

Syntax: Fx

where "x" is defined as the function key number to be simulated. It can contain be one or more digits. The action simulates the use of the key and is performed immediately such that the rest of the special function definition is skipped. F0 is treated as if the Enter (Return) key was pressed and F3 is treated as the Escape (Esc) key.

PANEL Action

Syntax: Sx

"x" is a positive number, interpreted here as a panel number. Without returning to the calling program, the panel system handles the panel that is specified in the action as if a call was made to display the panel. You can divide one panel into other panels without changing the calling program.
Note: The data arrays are the same for the whole series of panels.

TERMINATE WINDOW Action

Syntax: T

The window is terminated.

DELAY Action

Syntax: Wx

Where "x" is a positive number interpreted as a delay in seconds.

The panel system waits the specified number of seconds before resuming.

Example

#20;1;-1;-2;-3;01;00;79;

@@28;SWT;3;80;100;17;200;Work_Center_Resources;

@@33;CRCREG00;

@@27;LBOX;HTE;?2002;;;10;1000;0;;D4;D6;F2;

@@24;\Open;0;7;?2003;;;PD;F2;

@@24;\Search;0;7;?0;;;P;F6;

@@24;\New;0;7;?0;;;P;F4;

@@24;\Delete;0;7;?0;;;P;F5;

@@24;\Print;0;7;?0;;;P;F9;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

@@13;*101;4;*102;1;*103;22;*104;23;*105;21;$211;N;

__Machine_number_$1___________&____$\Search__&

_

$LBOX_______________________________________________________________________&

_

_

_

_

_

_

_

_

_

_

_

_

<$\Open____&>$\New...__&$\Delete__&$\Print...&_$Cancel___&_$Help_____&

@@28 Window Definition

This function is used to define a window. You can use this function in all panel files except those associated with these elements:

  • Message box
  • Spool file
  • List box header
  • Body panels

Syntax

Window Attributes

Control character Description
B Border (not together with D or SB)
D Dialog border (not together with B or SB)
H Horizontal scrollbar (not used)
MX Maximum button
MN Minimum button
MA Mouse align
N No move with owner
P0 Set previous window as parent (prevents the previous window from overlapping the current window)
S System menu
SA Screen alignment
SP Shell position
SB Size border (not together with B or D)
SM System modal
SW Standard window (B and MN)
SW0 Standard window (destroy other windows first)
SW1 No title bar
T Title bar text is set to current text, not to text of the previous window
V Vertical scrollbar (not used)

Position

The table below shows all possible values of the position code, and the position of Window #2 as it relates to Window 1 or the Desktop.

Position code Position   Position code Position
0   6
1   7
2   8
3   9
4   Default
5      

Width

Use this function to define the window width in standard characters. A standard character is taken from a mono-spaced font with a certain width so that 80 standard characters are displayed in one line of the screen.

Width depends on character spacing.

Character Spacing

Use this function to define the character spacing for the standard font.

If the character spacing is defined as 100 (%), then there are a maximum of 80 characters on each line. If you reduce the character spacing to 80 (%), the number of characters increases from 80 to a 100, to generate a window that matches the size of the screen.

Height

Use this function to define window height in standard characters. A standard character is taken from a mono-spaced font of a certain height so that 37 lines of standard characters are displayed on the screen.

Height depends on line spacing.

Line Spacing

Use this function to define the line spacing of the standard font.

If the line spacing is set at 100 (%), then the maximum height is 37 lines. If you increase the line spacing to 185 (%), for example, then the number of lines will be reduced from 37 to 20 so that they will not be larger than the size of the screen.

Title Bar Text

Text length must not exceed 60 characters.

Always use underscores [ _ ] as spaces.

Example

#500;1;-1;-2;-3;01;00;79;

@@28;SWT;5;25;100;5;200;Titlebar_text;

@@24;\OK;0;7;?0;;;PD;F0;

_

_Button_example

_

_______$\OK___&

@@29 Static Control Definition

The static control definition is used to define static control in, for example, a group box (shown below). You can create color rectangles where the color is controlled by the field value.

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out

Field text

For the most part, the field text definition is used for the following @@ functions to establish a connection between the function and the field: @@24 Button Definition, @@27 Listbox Definition and @@29 Static Control Definition.

Use the starting control characters together with the field text.

Note:  If the field text in the @@ function and the related field does not correspond, the field is an entry field.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Group Number

The group number is only important for radio buttons. It determines how the click and unclick of the radio buttons are performed. Radio buttons that are grouped together must have a unique group number greater than zero. To move the cursor focus within a group, use the arrow keys on your keyboard. The [TAB] key can be made to jump between groups.

Note:  If the group number = 0 the control will be in its own group. If the group number < 0 the control will has not been created.

Color Code

Color includes both the foreground and the background color. The color code is calculated by the using this formula:

Color code = 100 X FOREGROUND COLOR CODE + BACKGROUND COLOR CODE

Note:  The default color can not be changed when using the @@29 - @@32 functions.

Examples

The number (7) represents a pale grey background with black text.

The number (0313) represents a dark cyan background with yellow text.

Color Code Table

Code Color   Code Color
00 Black   10 Dark red
01 Red   11 Dark pink
02 Dark green   12 Green
03 Yellow   13 Dark cyan
04 Blue   14 Brown
05 Pink   15 White
06 Cyan   16 Light green
07 Pale grey   17 Pale green
08 Dark grey   18 Default list box yellow
09 Dark blue   19 Light yellow

Relative Character Position

This function defines a relative character position as it relates to a current character position. If no value is given the character position is defined as the current character position.

Relative Line Position

This function defines the relative line position as it relates to the current line position. If no value is given the position is defined as the current line position.

Control attributes

Control character Description
FF Foreground color frame. The color code is taken from the field.
FR Foreground color rectangle. The color code is taken from the field.
G Group box
I Icon
TL Text, left aligned
TR Text, right aligned
TC Text, centered

Height

Defines the static control height (lines) in standard characters.

Example

#672;1;-1;-2;-3;01;00;79;

@@28;SW;3;63;100;12;180;_-_Operation_status;

@@33;CSGPDS00;

@@29;Operation_status_coloring;0;7;;;G;10;

@@29;Default_color;0;7;;;G;5;

@@29;Active;0;7;;;TL;1;

@@29;*75;0;7;;;FR;1;

@@29;*76;0;7;;;FR;1;

@@29;*77;0;7;;;FR;1;

@@29;*78;0;7;;;FR;1;

@@29;*79;0;7;;;FR;1;

@@29;*80;0;7;;;FR;1;

@@24;7;3;7;?0;;;CNP;*9;1;|;*9;0;

@@24;10;3;7;?0;;;CNP;*10;1;|;*10;0;

@@24;14;3;7;?0;;;CNP;*11;1;|;*11;0;

@@24;17;3;7;?0;;;CNP;*12;1;|;*12;0;

@@24;20;3;7;?0;;;CNP;*13;1;|;*13;0;

@@24;C\hange_color;0;7;?0;;;PS;F6;

@@24;\Change_color;0;7;?0;;;PS;F2;

@@24;Planned;2;7;?0;;;R;*3;1;

@@24;Received;2;7;?0;;;R;*3;2;

@@24;In_process;2;7;?0;;;R;*3;3;

@@24;Sequence_locked;2;7;?0;;;R;*3;4;

@@24;Fixed_locked;2;7;?0;;;R;*3;5;

@@24;\OK;0;7;?0;;;PD;T;F0;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

õOperation_status_coloring____________________&õDefault_color_&

_____________________________________õActive&______*80___&

_$Planned_(10,70)&____________*75___&_$&

_$Received_(30,40,45)&________*76___&_$&________$C\hange_color...&

_$In_process,_started_(50,55)&*77___&_$&

_$Sequence_locked_(15)&_______*78___&_$&

_$Fixed_locked_(20)&__________*79___&_$&

_

_$\Change_color...&

_

_$\OK___&_$Cancel&_$Help__&

@@30 Combination Box Definition

This function is used to define a combination box. This can be presented in any one of these ways:

  • Dropdown
  • Dropdown list
  • Simple dropdown

Syntax

Field ID

The field ID is the direct address to data. It consists of a starting control character followed by a reference number and it ends with the ending control character ampersand (&) or a new starting control character.

Note:  All control characters are replaced by a space when you display the panel on-screen or print it out.

Field text

For the most part, the field text definition is used for the following @@ functions to establish a connection between the function and the field: @@24 Button Definition, @@27 Listbox Definition and @@29 Static Control Definition.

Use the starting control characters together with the field text.

Note:  If the field text in the @@ function and the related field does not correspond, the field is an entry field.

Field Number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note:  If the field number in the @@ function and the related field do not correspond, the field is as entry field.

Use the starting control characters together with the field number.

Caution: Every time a new field is inserted or removed you must recheck field positions.  Therefore, you must use the field reference number or field text functions instead.

Group Number

The group number is only important for radio buttons. It determines how the click and unclick of the radio buttons are performed. Radio buttons that are grouped together must have a unique group number greater than zero. To move the cursor focus within a group, use the arrow keys on your keyboard. The [TAB] key can be made to jump between groups.

Note:  If the group number = 0 the control will be in its own group. If the group number < 0 the control will has not been created.

Help Number

Syntax:        ?x

The "x" is the help ID in the IPF file and is an integer from 1 to 65535. If ? 0 is given, then the help ID is calculated with respect to the field.

The help number is reserved in this way:

Value Reserved
1 <= x = 999 Panel help
1000 = x = 9999 Component help
10000 = x = 19999 Field help (2 byte integer)
20000 = x = 29999 Field help (4 byte integer, real, date and time)
30000 = x = 39999 Field help (Characters)
30001 = x = 65535 General help

Relative Character Position

This function defines a relative character position as it relates to a current character position. If no value is given the character position is defined as the current character position.

Relative Line Position

This function defines the relative line position as it relates to the current line position. If no value is given the position is defined as the current line position.

Control attributes

Control character Description Example
B List box @@30;$269;8;7;?0;;0;BI;0;3;100;C;WM;$257;
D Dropdown @@30;$257;1;7;?0;;;DI;0;5;1000;C;SW;;
I Initialize list on creation @@30;$257;1;7;?0;;;DI;0;5;1000;C;SW;;
L Dropdown list @@30;*62;1;7;?0;;;LZI;24;10;100;C;WL;;
R Refresh list on dropdown @@30;$1;0;7;?0;;;DR;0;4;100;R;ORDF;1;$1;113;
S Simple @@30;$1;1;7;?0;;;SI;0;10;100;C;WC;$1;
P Palette @@30;*58;0;7;?0;;;PI;10;17;100;C;SC;;
Z Zero-based index is returned on selection.  Only for L. @@30;*62;1;7;?0;;;LZI;24;10;100;C;WL;;

Visible Characters

Integer > 0 and < 132. This defines the number of visible characters. If no value is given, then the length of the field defines the number of visible characters.

Visible Lines

This value defines the height measured in number of lines in the panel.

Max. Number of Lines

This value defines the maximum number of lines allowed. This value is most often set to 1000 lines.

Source ID

The source ID determines what to put in the combination box.

Source ID Description Example
C Common

@@30;$269;8;7;?0;;0;BI;0;3;100;C;WM;$257;

I Immediate

@@30;*182;0;7;?0;;;LZI;40;10;10;I;+; Item;+; Shop_order;+; Coloring_group;+; Order_network_and_Gantt;+; Delay;+; Throughput_time;+; |;1;2;3;4;5;6;

R REGS @@30;$1;0;7;?0;;;DR;0;4;100;R;ORDF;1;$1;113;

Source Parameters

The syntax of the source parameters depends on the source ID.

Source ID Syntax
C
I
R

@@31 Entry Field Definition

The entry field definition overrides default entry field attributes. This definition, for example, will allow you to substitute a yellow background for the background color that comes standard with the system.

Syntax

--@@31-;---field ID-------;-group number-;-help number-;--

           |-field text---|

           +-field number-+

 ----------------------------------;------------------------------

   |                             |   |                         |

   +-Relative Character Position-+   +-Relative Line Position--+

 ---control attributes-;------------------------;--

                         |                    |

                         +-Visible Characters-+

Example

#633;1;-1;-2;-3;01;00;79;

@@28;SWT;5;80;100;19;180;Spool_file;

@@31;$1;0;7;?0;;;OL;0;

@@31;$5;0;7;?0;;;OL;0;

@@27;LBOX;HTE;?0;;-1;14;2000;131;;F99;

@@24;\Print;0;7;?0;;;P;F9;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

_$1___&__$5______________________________&

$LBOX________________________________________________________________________&

_

_

_

_

_

_

_

_

_

_

_

_

_

_

_

_$\Print...&_$Cancel___&_$Help_____&

@@32 Numeric Spin Button Definition

This function is used to define a numeric spin button as shown in the example below:

Syntax

--@@32-;---field ID-------;-group number-;-color code-;-help number-;--

           |-field text---|

           +-field number-+

 ----------------------------------;------------------------------

   |                             |   |                         |

   +-Relative Character Position-+   +-Relative Line Position--+

 ---control attributes-;-Lower Value-;-Upper Value-;--

Example

#05;1;-1;-2;-3;01;00;79;

@@28;SWT;5;69;100;10;180;Gantt_chart_-_Settings;

@@33;CRPORT00;

@@29;Workcenter_selection;0;7;;;G;4;

@@24;\Workcenter;1;7;?10189;;;R;D7;*189;0;

@@24;Workcenter_\list;1;7;?10189;;;R;D3;D5;*189;1;

@@30;$196;8;7;?0;;;D;0;5;100;C;WC;;

@@30;$208;10;7;?0;;;D;0;5;100;C;WC;;

@@30;*62;1;7;?0;;;LZI;24;10;100;C;WL;;

@@24;Include_balance_profile;2;7;?10064;;;C;*64;2;|;*64;1;

@@24;\View_now;0;7;?0;;;PD;F0;

@@24;Cancel;0;7;?0;;;PNPF3;F3;

@@24;Help;0;7;?0;;;PH;

@@32;*32;0;7;?0;;;D;1;2000;

@@13;T;

$Workcenter_selection_______________________________________________&

_$\Workcenter&_________from$196_________&_____õto_$208_________&

_$Workcenter_\list&____list*62_&

_

__Report_start_date^2_____&õMaximum_No._of_days_*32__&

_

_$Include_balance_profile&

_

_$\View_now&_$Cancel___&_$Help_____&

@@33 Help File Definition

This function is used to load extra help files into a panel. You can also use it to load field context help files.

Syntax

  --@@33-;------------------------

           |                   |

           +-Help File Name-;--+

                              |

            +-----------------+

Example

This example shows the order links field help file (CRSHIP00.HLP) being loaded.

#48;1;-1;-2;-3;01;00;79;

@@28;SWT;5;74;100;14;180;Orders_-_Order_Links;

@@33;CRSHIP00;

@@29;Parent_order;0;7;;;G;4;

@@29;Component_order;0;7;;;G;4;

@@24;Cancel;0;7;?0;;;PNPF3;F3;

@@24;Help;0;7;?0;;;PH;

@@13;T;

___Status<$_30&__Type_$_29&

_

___Availability_date^4_____&"4___&__________Required_quantity`5_______&>

_

_$Parent_order__________________________________________________________&

__Item_number______$49_______________________&_Order_number_~11______&

___Operation_number_~12___&

_

_$Component_order_______________________________________________________&

__Item_number______$74_______________________&_Order_number_~9_______&

___Operation_number_~10___&

_

_$Cancel&_$Help__&

@@34 Internal Field Number Definition

This function is used to define an internal field number in a panel field. The internal field number is used by the system to disable controls.

Note:  If this function is present it should not be removed or changed.

Syntax

  --@@34-;---field ID-------;-internal number-;--

           |-field text---|

           +-field number-+

Example

In the example below the checked box Big profile has an internal field number of (1).

#15;1;-1;-2;-3;01;00;79;

@@28;SWTP0;5;45;100;5;200;Select_item;

@@30;$1;0;7;?0;;;DR;0;4;100;R;ORDF;1;$1;113;

@@24;\Big_profile;2;7;?0;;;C;*1;1;|;*1;2;

@@34;2;1;

@@24;\OK;0;7;?0;;;PD;T;F0;

@@24;Cancel;0;7;?0;;;PNPF3;T;F3;

@@24;Help;0;7;?0;;;PH;

__Item_number__$1________________________&

_$\Big_profile&

_

_$\OK___&_$Cancel_&_$Help___&

@@35 List Box Value Field Definition

The @@35 function is used to specify the list box field values and the columns that you want to use in your calculations. This function should be included in panels that already have their list box data defined, such as the Body Panel.

Syntax: @@35;<Value Field>;<Field ID>;

See @@36 List Box Value Field Calculation.

@@36 List Box Value Field Calculation

Function @@36 defines which calculations you want to conduct on given values in the list box column. For convenience, you must insert one or more of the @@36 functions that you are using in the Main panel.

Important notes:The calculation function should be written in upper case. Only one calculation can be associated with each @@36function.

Syntax

@@36;<Value Field>;<Field ID>;<Calculation Function>;

Example with a Main Panel

#20;1;-1;-2;-3;01;00;79;

.

.

@@36;1;1;SUM;

@@36;2;1;SUMS;

@@36;3;1;MIN;

@@36;4;1;MINS;

@@36;5;1;MAX;

@@36;6;1;MAXS;

@@36;7;0;CNT;

@@36;8;0;CNTS;

@@36;9;1;AVG;

@@36;10;1;AVGS;

Dummy fields are placed to show the results:

.

.

_SUM<`_______.&>____SUMS<`_______.&>

_MIN<`_______.&>____MINS<`_______.&>

_MAX<`_______.&>____MAXS<`_______.&>

_CNT<`_______.&>____CNTS<`_______.&>

_AVG<`_______.&>____AVGS<`_______.&>

Calculation results are shown after the entire list box is full. When you select a calculation (such as SUMS, MINS, MAXS, AVGS and CNTS), the results of this calculation will not appear until the panel is updated.

If you use the list box attribute W and @@14 you can see the results immediately after each calculation is specified. There will be a brief pause, the main panel is displayed again and the information pertaining to the calculation will be updated and presented.

The W function must be included in the @@27. The W will act as a reminder that if the @@14 function is defined, it has to be executed each time a selection is made in the list box.

@@37 Exporting Data to External Programs

If data from a report in Infor M3 SWB has to be handled by an external program, you can export from the report directly to the program concerned. This applies to the following reports in Infor M3 SWB:

  • Work Center Schedule
  • Load Profile
  • Load Report
  • Order Analysis

To be able to export data to external programs you must specify a function for each relevant panel in the panel files.

For example, to export data from the Order Analysis report (PMDSCH__.SKM) to an Excel spreadsheet in a panel file, you must specify the @@37 function for the panel that contains data definition information applicable to the relevant list box. To clarify this process the example below shows the procedure in detail (using panel #82).

Syntax

Function

Defines path and file name for the data file

Example

#80;1;-1;-2;-3;01;00;79;

@@28;SWT;5;28;100;4;180;Order_Export;

@@33;COHEAD00;CRPORT00;

@@24;\OK;1;7;?0;-2;;PNPF3;T;F3;

@@24;\Help;1;7;?0;-2;;PH;

_

____$\OK______$\Help__&

#81;1;-1;-2;-3;01;00;79;

_

#82;1;-1;-2;-3;01;00;79;

@@37;%MOVEXDIR%\CONTROL\PMEXPO.FID;DSCH;%DATA%\PMDSCH.TXT; START_K:\MSOffice\EXCEL.EXE_/R_C:\MVXAPP11\CONTROL\PMMADSCH.XLS

Note:  A macro configuration (which is user-defined) automatically starts Excel, but the actual transfer of data occurs manually. If you want help in configuring special functions and macros, contact your implementation consultant at Infor.

@@38 Colors and Bar Graphs in List Boxes

The @@38 function is used to convert character strings (typically letters) into plain text, bitmaps or icons. It is most commonly used in list boxes. For example, in the Machine View list box, information can be displayed using colors and bar graphs instead of only in numbers.

This function can be of assistance in obtaining a quick overview of the contents of a list box. The @@38 function can be introduced in two different ways dependent on the type of representation you choose, that is, substitution, color, bar graph representing percent, etc. Refer to the examples below for further detail.

Syntax (Type = 0)

--@@38-;-Field Number-;-Type=0-;-Data Reference-;--

---Data value-;-Text-;-------;----------;

                       + | +   +-Text-+

Syntax (Type > 0)

--@@38-;-Field Number-;-Type>0-;-Attribute-;

@@39 Background Bitmaps

The @@39 function is used to place background pictures (bitmaps) into the panel screen.

Note:  @@39 functions can only be used to create bitmaps (.BMP files) and not icons (.ICO files).

Syntax

--@@39-;-Image ID-;---------------;--

                    +-Attribute-+

-----------------------;----------------------;

  +-Delta X Position (pixels)-+   +-Delta y Position (pixels)-+

Note:  The delta X and Y positions must be specified in pixels and not in 1/10 delta positions (standard).

Example

The following is an example from the main menu in Infor M3 SWB:

#30;1;-1;-2;-3;01;00;79;

@@28;SW0SbTASh;5;80;100;34;100;Main_Menu;

@@39;500;LT;;;

...

The above @@39 function places the bitmap file 500.bmp as background in the panel screen #30.

@@40 Progress Bar

When you execute a command, a progress bar gives you a way to estimate the length of time it will take for it to be completed. It does this by giving you the percent of information that has already been processed. You can then estimate how much time the remaining information processing will take. For directions in setting up the progress bar refer to the example shown below.

Syntax

--@@40-;-Field Number-;-Group Number-;--

---Color Code-;-Help Number-;----------------------;--

                          +-Delta X Position-+

-----------------------;-Attribute-;--

  +-Delta y Position-+

------------------;-----------------;

  +-Minimum Value-+   +-Maximum Value-+

Example

The following example refers to a progress bar that is used to show how long a planning order compilation will take.

#68;2;144;144;144;01;00;79;

@@28;DT;5;45;100;5;185;Planlægger;

@@14;0;

@@24;Fortryd_planlægning;0;7;?0;;;PNPF3;T;F3;

@@24;Stop_planlægning;0;7;?0;;;PNPF4;T;F4;

@@40;`1;0;7;?0;10;;ST;;;

_

__Udført`1_______________________&

_

_$Fortryd_planlægning&_$Stop_planlægning&

The above set up gives you a panel screen in which the progress bar information reflects the percent of the planning task completed.

@@41 Panel Tabs

When you create panel tabs, every tab is also a separate panel in and of itself. The panels are defined by the @@41 function, while the content of each tab is defined by using the @@24 function.

Syntax

--@@41-;-Field Number-;-Group Number-;--

---Color Code-;-Help Number-;----------------------;--

                          +-Delta X Position-+

-----------------------;-Attribute-;-Height-;

  +-Delta y Position-+

Examples

This example is extracted from the Order component:

#30;1;-1;-2;-3;01;00;79;

...

@@41;TABC;0;7;?0;;;SHF;188;

@@24;\Standard;0;7;?0;;;ED;S30;   (Note 1)

@@24;\Mere;0;7;?0;;;E;S31;

$TABC&                            (Note 2)

$\Standard$\Mere&

...

#31;1;-1;-2;-3;01;00;79;

...

@@41;TABC;0;7;?0;;;SHF;188;

@@24;\Standard;0;7;?0;;;E;S30;

@@24;\Mere;0;7;?0;;;ED;S31;

$TABC&

$\Standard$\Mere&

...

Note:  in the example above ED is displayed in the first line, and E in the second. An E identifies a tab. D on the other hand, means that the tab being referenced is the default tab (which is the first tab to be displayed when the screen is opened).

In screen panel #30 the standard tab is displayed first. In screen #31 the supporting tab is first to be displayed. In line @@24;\Standard& the last panel is called 30 (S30) and in line @@24;More& the panel is called S31. Even though they appear to be the same, they are in fact two different panels. Therefore, you must define TAB C, by using both \Standard and \More and to include in your definition any of the other controls relevant to each tab definition.

Note:  TAB C must be referred to as \Standard and \More, otherwise the tab will not be correctly defined.

You can also make tabs that use icons instead of words for tab labels. The following is an example of how you do this using the component machines.

#21;1;-1;-2;-3;01;00;79;

...

@@41;TABC;0;7;?0;;;SHF;197;

@@24;\Standard;0;7;?0;"Standard";;;EiD;.ICO=16;C;S21;

@@24;\Mere;0;7;?0;"Mere";;;Ei;.ICO=56;C;S27;

@@24;O\pstillingstid;0;7;?0;"Opstillingstid";;;Ei;.ICO=70;C;S25;

$TABC&

$\Standard$\Mere$O\pstillingstid&

...

#25;1;-1;-2;-3;01;00;79;

...

@@41;TABC;0;7;?0;;;SHF;197;

@@24;\Standard;0;7;?0;"Standard";;;Ei;.ICO=16;C;S21;

@@24;\Mere;0;7;?0;"Mere";;;Ei;.ICO=56;C;S27;

@@24;O\pstillingstid;0;7;?0;"Opstillingstid";;;EiD;.ICO=70;C;S25;

$TABC&

$\Standard$\Mere$O\pstillingstid&

...

#27;1;-1;-2;-3;01;00;79;

...

@@41;TABC;0;7;?0;;;SHF;197;

@@24;\Standard;0;7;?0;"Standard";;;Ei;.ICO=16;C;S21;

@@24;\Mere;0;7;?0;"Mere";;;EiD;.ICO=56;C;S27;

@@24;O\pstillingstid;0;7;?0;"Opstillingstid";;;Ei;.ICO=70;C;S25;

$TABC&

$\Standard$\Mere$O\pstillingstid&

...

@@42 Positioning Columns in List Box

In every panel a certain amount of space is allocated to a list box. This space is consistent with the requirements for the individual fields. An item number requires 25 characters for example, therefore the list box is provided with enough space for 25 Ws, (where the W character absorbs most of the space available). Because an item number seldom takes much space in the panel, you can decrease the column width by using the @@42 function and still not decrease the actual size of the field.

You must apply the @@42 function to both the main panel and the body panel if you want to move the column header (along with the corresponding data in the column) to a list box. We recommend that you also replace the column header and data to their original position.

Syntax

--@@42-;--------;--------;...;--------;

         +-C1-+   +-C2-+       +-Cn-+

Example

The following example shows the panel file for weekly production time patterns. To decrease the Monday column by two characters, add the function @@42 to both the main and the body panel.

#22;1;-1;-2;-3;00;01;79;

@@42;;;-20;

_Week___Monday_____Tuesday____Wednesday__Thursday___Friday_____Saturday___Sunday

#23;1;-1;-2;-3;00;01;79;

@@42;;;-20;

$1___&_$5___&_____$9___&_____$13__&_____$17__&_____$21__&_____$25__&_____$29__&

This operation will move the third column (Tuesday) two characters to the left. The second column (Monday) will be decreased by two characters correspondingly.

Note:  In addition, the following columns will also be moved. If you want to avoid this specify the position of each of the columns in the manner shown below:

@@42;;;-20;-40;-60;-80;-100;-120

@@43 Security Level

The Security Level function is only accessible when Infor M3 SWB is used together with the Infor M3 BE server.

This section describes the programming syntax that is used for setting up the security level. If you make any customization of this function, then the changes must be inherited in all panel files containing the @@43 control function.

Syntax

@@43;<SL>;<DF>;----;

               |  |

               <ER>

<SL> Security bit mask
>0 True
<0 False
A Any level except 0
  Use & for logical AND
<DF> Disable function
F Disable all fields except Push button, tab and list box.
A Disable all fields except tab and list box and F3 (Cancel) and F1 (help).
P Disable all pushbuttons except F3 (Cancel) and F1 (help).
<ER> Enable reference
  <FIELD1>;<FIELD1>;
  <FROM>;...;<TO>;
  ...;<TO>;
  <FROM>;...;
  <FKEY1>;<FKEY2>;
  and combinations.

Examples

Syntax Description

@@43;2;F;

All fields are disabled except Push button, tab and list box when security level (IPASCL) has bit0 set.

@@43;-2;F;

All fields are disabled except Push button, tab and list box when security level (IPASCL) has bit0 cleared.

@@43;3;A;F0;F7;8;...;11;

All fields disabled except tab, list box, field #8 to #11 and Push buttons with action F0 and F7 when security level (IPASCL) is 3 (bit0 and bit1 set).

@@43;2;P;

All Push buttons except F3 (cancel) and F1 (help) are disabled.

@@43;1&-2;P;

Disable all Push buttons except F3 (Cancel) and F1 (help) when security level (IPASCL) has bit0 set and bit1 cleared.