CALL Program for a Function Key

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.


Single Parameter Interface

QSYSINC Member Name: EUIFKCL

Structure level
BINARY(4); positions 1-4

The interface level supported by this structure, indicating which fields and values are available for the current interface level.

Reserved
CHAR(8); positions 5-12

Type of call
BINARY(4); positions 13-16

Set to the following value:

1 Processes a function key.

Application handle
CHAR(8); positions 17-24

The application handle of the application currently being processed by the UIM.

Panel name
CHAR(10); positions 25-34

The name of the panel currently being processed by the UIM.

Function key pressed
BINARY(4); positions 35-38

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.

Multiple Parameter Interface

The description of parameters listed in the following table is the same as the corresponding field in the structure for a single parameter interface. The positions listed for each field in the structure do not apply to the multiple parameter interface.


  Parameters for 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)

  No additional parameters are required for interface level 2.



Exit program introduced: V2R2
Top | User Interface Manager (UIM) APIs | APIs by category