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 ]