CALL Program for an Action List Option or Pull-Down Field Choice
Required Parameter Group for Single Parameter Interface:
| 1 | Action list or pull-down information | Input | Char(*) |
QSYSINC Member Name: EUIALCL
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 | List name | Input | Char(10) |
| 5 | List entry handle | Input | Char(4) |
| 6 | Option number | Input | Binary(4) |
| 7 | Function qualifier | Input | Binary(4) |
Interface Level 2:
| 8 | Pull-down field name | Input | Char(10) |
QSYSINC Member Name: EUIALCL
An action list option can specify the CALL dialog command on the ENTER, EXTENTER, PROMPT, and EXTPROMPT attributes of the list action (LISTACT) tag. When processing an action list, the UIM calls the specified program, sending the information related as parameters.
A pull-down choice can specify the CALL dialog command on the ACTION attribute of the pull-down field choice (PDFLDC) tag. When processing a selected pull-down choice, the UIM calls the specified program, sending the information related as parameters.
The CALL dialog command on an action list or pull-down choice with ACTFOR=LIST on the PDFLDC tag allows the application to handle a request for a single list entry. When processing the list, the UIM calls the program once for each selected entry in the list. Care must be taken in changing other list entries and the current position because the UIM is accessing the same information to perform the remaining action list processing. For example, changing the current position past some selected list entries causes the UIM to not process the skipped ones.
The CALL dialog command on a pull-down choice with ACTFOR=PANEL on the PDFLDC tag allows the application to handle a request related to the panel as a whole. The UIM calls the program only once before redisplaying the panel.
An escape message received by the UIM while performing list processing stops the processing and displays the messages. The action or selection field still contains the option number or selection character and is marked in error.
Authorities and Locks
None.
Required Parameter Group
- Action list or pull-down 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)
Specifies whether CALL is due to an Action List Option or a Pull-Down field choice. UIM sets one of the following values:
3 A program is called for action list option processing or pull-down choice processing when ACTFOR=LIST is specified on the PDFLDC tag. 9 A pull-down choice. A program is called for pull-down choice processing when ACTFOR=PANEL is specified on the PDFLDC tag.
- 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.
- List name
- INPUT; CHAR(10)
The name of the list that is currently being processed by the UIM. Blanks indicate that the pull-down choice being processed does not operate against a list entry because ACTFOR=PANEL is specified on the PDFLDC tag.
- List entry handle
- INPUT; CHAR(4)
The list entry handle that is currently being processed by the UIM. Hexadecimal zeros indicate that the pull-down choice being processed does not operate against a list entry. The following value can be used:
EXTE Processes the extended action entry.
- Option number
- INPUT; BINARY(4)
The option number of the list action or pull-down choice that is being processed.
- Function qualifier
- INPUT; BINARY(4)
Indicates the action to be performed. Here are the possible values:
0 Performs the action specified on the ENTER or EXTENTER attribute of the LISTACT tag or the ACTION attribute of the PDFLDC tag. -10 Performs the action specified on the PROMPT or EXTPROMPT attribute of the LISTACT tag.
- Pull-down field name
- INPUT; CHAR(10)
The name of the pull-down field from which the pull-down choice is selected. If the pull-down field does not have a name, this parameter is set to blanks. This parameter is available only when the interface level is set to two or greater.
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 | CHAR(10) | List name |
| 44 | 2C | CHAR(4) | List entry handle |
| 48 | 30 | BINARY(4) | Option number |
| 52 | 34 | BINARY(4) | Function qualifier |
| 56 | 38 | CHAR(10) | Pull-down field name |
Field Descriptions
Application handle. The application handle of the application that is currently being processed by the UIM.
Function qualifier. Indicates the action to be performed. Here are the possible values:
| 0 | Performs the action specified on the ENTER or EXTENTER attribute of the LISTACT tag or the ACTION attribute of the PDFLDC tag. |
| -10 | Performs the action specified on the PROMPT or EXTPROMPT attribute of the LISTACT tag. |
List entry handle. The list entry handle that is currently being processed by the UIM. Hexadecimal zeros indicate that the pull-down choice being processed does not operate against a list entry. The following value can be used:
| EXTE | Processes the extended action entry. |
List name. The name of the list that is currently being processed by the UIM. Blanks indicate that the pull-down choice being processed does not operate against a list entry because ACTFOR=PANEL is specified on the PDFLDC tag.
Option number. The option number of the list action or pull-down choice that is being processed.
Panel name. The name of the panel that is currently being processed by the UIM.
Pull-down field name. The name of the pull-down field from which the pull-down choice is selected. If the pull-down field does not have a name, this field is set to blanks. This field is available only when the structure level field is set to two or greater.
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. Specifies whether CALL is due to an Action List Option or a Pull-Down field choice. UIM sets one of the following values:
| 3 | A program is called for action list option processing or pull-down choice processing when ACTFOR=LIST is specified on the PDFLDC tag. |
| 9 | A pull-down choice. A program is called for pull-down choice processing when ACTFOR=PANEL is specified on the PDFLDC tag. |
Exit program introduced: V2R2
[ Back to top | User Interface Manager APIs | APIs by category ]