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 ]