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.