CALL Program for a Menu Item


  Required Parameter Group for Single Parameter Interface:

1 Menu Item information Input Char(*)

  QSYSINC Member Name: EUIMICL

  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 Menu option Input Binary(4)

  Interface Level 2:

  No additional parameters are required for interface level 2.

Menu items can be assigned to the CALL dialog command on the ACTION attribute of the menu item (MENUI) tag. When the menu item is selected, the UIM calls the specified program.

The CALL dialog command is assigned to a menu item 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

Menu item 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:

2 Processes a menu item.

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.

Menu option
INPUT; BINARY(4)

The option number of the menu item that is selected by the user.


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) Menu option


Field Descriptions

Application handle. The application handle of the application that is currently being processed by the UIM.

Menu option. The option number of the menu item that is selected by the user.

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:

2 Processes a menu item.



Exit program introduced: V2R2

[ Back to top | User Interface Manager APIs | APIs by category ]