CALL Program for a Function Key
Required Parameter Group for Single Parameter Interface:
1 | Function key information | Input | Char(*) |
QSYSINC Member Name: EUIFKCL
Required Parameter Group for Multiple Parameter Interface:
Interface Level 1:
1 | Type of call | Input | Binary(4) |
2 | Application handle | Input | Char(8) |
3 | Panel name | Input | Char(10) |
4 | Function key pressed | Input | Binary(4) |
Interface Level 2:
No additional parameters are required for interface level 2.
Function keys can be assigned to the CALL dialog command on the ACTION attribute of the key item (KEYI) tag. When the function key is pressed, the UIM calls the specified program.
The CALL dialog command is assigned to a function key to process requests that are specific to the application. These requests either do not have a command interface or require more knowledge about the current application than can normally be passed through a command.
The application can perform most functions, but the application developer must be aware of the effects of changing dialog variables, displaying other panels, and so on.
Authorities and Locks
None.
Required Parameter Group
- Function key information
- INPUT; CHAR(*)
A structure that provides information related to the user request. For details, see Single Parameter Structure.
- Type of call
- INPUT; BINARY(4)
This parameter must be set to the following value:
1 Processes a function key.
- Application handle
- INPUT; CHAR(8)
The application handle of the application that is currently being processed by the UIM.
- Panel name
- INPUT; CHAR(10)
The name of the panel that is currently being processed by the UIM.
- Function key pressed
- INPUT; BINARY(4)
The function key that is pressed:
1-24 A function key (F1-F24) is processed. 26 The default action when the Enter key is pressed.
Single Parameter Structure
For detailed descriptions of the fields in this table, see Field Descriptions.
Offset | Type | Field | |
---|---|---|---|
Dec | Hex | ||
0 | 0 | BINARY(4) | Structure level |
4 | 4 | CHAR(8) | Reserved |
12 | C | BINARY(4) | Type of call |
16 | 10 | CHAR(8) | Application handle |
24 | 18 | CHAR(10) | Panel name |
34 | 22 | BINARY(4) | Function key pressed |
Field Descriptions
Application handle. The application handle of the application that is currently being processed by the UIM.
Function key pressed. The function key that is pressed:
1-24 | A function key (F1-F24) is processed. |
26 | The default action when the Enter key is pressed. |
Panel name. The name of the panel that is currently being processed by the UIM.
Reserved. A reserved field.
Structure level. The interface level supported by this structure, indicating which fields and values are available for the current interface level.
Type of call. This field must be set to the following value:
1 | Processes a function key. |
Exit program introduced: V2R2
[ Back to top | User Interface Manager APIs | APIs by category ]