Invoke dialog panel fields

To call a function, you must specify a value for either the PANEL, CMD, or PGM field. You cannot specify more than one of these fields.

The fields on the Invoke Dialog Function/Selection Panel function as follows:

Invoke selection panel:

Use these fields to call a selection panel:

PANEL: The name of the selection panel to be displayed.
OPT: An optional parameter indicating the first selection option that must be valid from the specified selection panel. This input field continues onto the next line on the panel.

Invoke command:

Use these fields to call a command:

CMD

The name of a command procedure written in CLIST or REXX, or any TSO command, to be called as a dialog function. You can include command parameters.

Use the percent sign (%) as a prefix symbol to tell ISPF to remove the Invoke Dialog Function/Selection Panel and use the full screen to display the results of a CLIST or REXX exec call. A complete CLIST or REXX exec call is indicated by three asterisks. Press the Enter key to return to the Invoke Dialog Function/Selection Panel.

If you omit the % prefix, ISPF interprets the command as a TSO command, using line mode to display the command results at the bottom of the Invoke Dialog Function/Selection Panel.

LANG

An optional parameter used to specify APL or CREX.

Type APL in this field to specify the use of the APL language. If this is your first APL request during the session, the command specified in the CMD keyword is called and an APL2® environment is established. If this is not your first APL request during this session, the string specified after the CMD keyword is passed to the APL2 workspace and processed.

Type CREX in this field to specify that the command specified in the CMD keyword is a REXX exec that has been compiled and link-edited into a load module, and that a CLIST/REXX function pool is to be used rather than an ISPF module function pool. LANG(CREX) is optional if the compiled REXX has been link-edited to include any of the stubs EAGSTCE, EAGSTCPP, or EAGSTMP.

See z/OS ISPF Dialog Developer's Guide and Reference for more information about Compiled REXX processing.

To specify any language other than APL or Compiled REXX, leave this field blank.

MODE

An optional parameter that overrides:

Automatic line mode entry, caused when a TSO command is entered.
Automatic full-screen display caused by the % CLIST or REXX exec prefix. However, it does not prevent ISPF from calling the command as a CLIST or REXX exec.

If you leave this field blank, the % prefix has its normal effect. The valid values for this field are:

LINE: Used to enter line mode when calling a CLIST or REXX exec.
FSCR: Used to enter full-screen mode when calling a TSO command.

Invoke program:

Use these fields to call a program:

PGM

The name of a program to be called as a dialog function.

PARM

Optional parameters to be passed to the program. This input field continues onto the next line on the panel.

MODE

An optional parameter used to tell ISPF whether to display the program results in line mode or full-screen mode. If you leave this field blank, ISPF uses line mode as the default. The valid values for this field are:

LINE: Used to enter line mode when calling a program. Results of the program are displayed at the bottom of the Invoke Dialog Function/Selection Panel.
FSCR: Used to enter full-screen mode when calling a program. ISPF removes the Invoke Dialog Function/Selection Panel and uses the full screen to display the program results. Three asterisks show program completion. Press the Enter key to return to the Invoke Dialog Function/Selection Panel.

Invoke request:

Use this field to call a workstation command:

WSCMD: A fully qualified workstation command with any of its parameters.

Options:

Use a slash to select these options:

NEWAPPL: Indication of whether a new application is being called. Select this option if the function is a new application.
ID: A 1- to 4-character ID for a new application. If you call a new application and leave the ID field blank, the default ID of ISP is used. Note that the ID determines the names of the profile and the command table to be used for the application.
NEWPOOL: Indication of whether a new shared variable pool is to be created. Select this option if you want to create a new shared variable pool; however, the selection is ignored if NEWAPPL is selected.
PASSLIB: Shows that the current set of application-level ISPF libraries, if any sets exist, is to be used by the application being selected. You can select PASSLIB only if you also select NEWAPPL.
Note: For more information about the PASSLIB field, see the description of the SELECT service in z/OS ISPF Services Guide.