CALL Program for an Action List Option and Pull-Down Field Choice

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.

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.

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.

Single Parameter Interface

QSYSINC Member Name: EUIALCL

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 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

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.

List name

CHAR(10); positions 35-44

The name of the list 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

CHAR(4); positions 45-48

The list entry handle 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 may be used:

EXTE	Processes the extended action entry.

Option number

BINARY(4); positions 49-52

The option number of the list action or pull-down choice being processed.

Function qualifier

BINARY(4); positions 53-56

One of the following 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

CHAR(10); positions 57-66

The name of the pull-down field from which the pull-down choice is selected. If this pull-down field does not have a name, this field is set to blanks.

This field is only available when the field for the structure level is set to two or greater.

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.