Exit Program for a Cursor-Sensitive Prompt

An exit program for handling a cursor prompt request can be specified on the PROMPT attribute of the data item (DATAI), data item extender (DATAIX), and list column (LISTCOL) tags. This attribute specifies the name of a dialog variable identifying the program to call.

This dialog variable cannot be blanks or nulls. The UIM cannot process a prompt request without the exit program.

Normally, the exit program displays a selection list panel. Such a list panel allows the user to select one or more entries from a list of possible choices. The application then sets the selected choices in the appropriate dialog variables, which are shown when the UIM redisplays the panel where the prompt function was requested.

The exit and cancel flags for the job are not reset before the exit program is called, and the flags are not checked after the exit program returns control to the UIM. Therefore, the exit and cancel flags should not be turned on by the exit program.

Single Parameter Interface

QSYSINC Member Name: EUICSEX

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:

8	The exit program is called to provide cursor-sensitive prompting.

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.

Panel element type

CHAR(1); positions 35-35

One of the following values identify the type of panel element prompt:

1	Prompts for a data item (DATAI tag).
2	Prompts for a data item extender (DATAIX tag).
3	Prompts for a list column (LISTCOL tag).

Reserved

CHAR(1); positions 36-36

Dialog variable name

CHAR(10); positions 37-46

The name of the dialog variable where the cursor was positioned when the prompt function was requested.

List name

CHAR(10); positions 47-56

The name of the list where the cursor was positioned when the prompt function was requested. This field is set only when the panel element type field indicates a LISTCOL tag is prompted.

List entry handle

CHAR(4); positions 57-60

The list entry handle where the cursor was positioned when the prompt function was requested. This field is set only when the panel element type field indicates a LISTCOL tag is prompted.

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.