Use the EVALDEF subcommand to retrieve SETDEF-defined default values
and format the values in CLIST variables, REXX variables, or ISPF function
pool dialog variables. The default values can be for:
- Local defaults. These values are currently in use for an ISPF
screen in the IPCS dialog, for a batch IPCS session, or for an IPCS
interactive line-mode session.
- Global defaults. These values are used to establish the local
defaults when IPCS processing starts in an ISPF screen, a batch IPCS
session, or an IPCS interactive line-mode session.
The default values are part of a source description. The source
description is in the dump directory allocated with ddname IPCSDDIR
and is your current dump directory. The current dump directory is
your user dump directory or, for users with write access authority,
might be the sysplex dump directory.
Note: With TSO/E Release 2 installed, you can use this subcommand
to update GLOBAL CLIST variables. See
z/OS TSO/E CLISTs for
information.
- Related subcommands
- EQUATE
- EVALDUMP
- EVALMAP
- EVALSYM
- Syntax
EVALDEF { LOCAL | GLOBAL }
{ CLIST(var-list) }
{ DIALOG(var-list) }
{ REXX(var-list) }
-------- SETDEF-Defined Parameter --------------------------
Note: You can override the following SETDEF parameter.
See SETDEF subcommand — set defaults.
[ TEST | NOTEST ]
- Parameters
- LOCAL or GLOBAL
- Identifies the type of default values to be retrieved.
LOCAL
requests the default values that are currently used.
GLOBAL
requests the default values to be used when local values are not specified.
- CLIST(var-list)
- DIALOG(var-list)
- REXX(var-list)
- Specifies how the default values are to be formatted.
CLIST(var-list)
designates that the values be formatted into CLIST variables.
DIALOG(var-list)
designates that the values be formatted into ISPF function pool dialog
variables.
REXX(var-list) designates that the values be formatted
into REXX variables.
The syntax for var-list is
as follows:
[ DECIMAL | F ]
[ HEXADECIMAL | X ]
[ CONFIRM(confirm) ]
[ DISPLAY(display) ]
[ FLAG(flag) ]
[ LENGTH(length) ]
[ PRINT(print) ]
[ PROBLEM(problem) ]
[ QUALIFICATION(qualification) ]
[ SOURCE(var-name)|DATASET(var-name)|DSNAME(var-name) ]
[ TERMINAL(terminal) ]
[ TEST(test) ]
[ VERIFY(verify) ]
- DECIMAL or F
- HEXADECIMAL or X
- Specifies the format of the default length.
DECIMAL or F designates
that the default length be formatted using decimal digits.
HEXADECIMAL
or X designates that the default length be formatted using hexadecimal
digits.
- CONFIRM(confirm)
- Places the parameter CONFIRM or NOCONFIRM in the variable confirm.
- DISPLAY(display)
- Places one of each of the following options of the DISPLAY parameter
in the variable display:
- [NO]MACHINE
- [NO]REMARK
- [NO]REQUEST
- [NO]STORAGE
- [NO]SYMBOL
- SOURCE(var-name) or DATASET(var-name) or DSNAME(var-name)
- Places the parameter SOURCE, DATASET, or DSNAME and the default
dump source name or the parameter NODSNAME in the variable var-name.
- FLAG(flag)
- Places one of the following options of the FLAG parameter, in
the variable flag:
- INFORMATIONAL
- WARNING
- ERROR
- SERIOUS
- TERMINATING
- LENGTH(length)
- Formats and places the default data length in the variable length.
The length is in DECIMAL unless HEXADECIMAL is specified.
- PRINT(print)
- Places the parameter PRINT or NOPRINT in the variable print.
- PROBLEM(problem)
- Places the PROBLEM parameter and the default problem number or
the parameter NOPROBLEM in the variable problem.
- QUALIFICATION(qualification)
- Places the default address qualifiers for the default data set
in the variable qualification.
- TERMINAL(terminal)
- Places the parameter TERMINAL or NOTERMINAL in the variable terminal.
- TEST(test)
- Places the parameter TEST or NOTEST in the variable test.
- VERIFY(verify)
- Places the parameter VERIFY or NOVERIFY in the variable verify.
- Return Codes
See Standard subcommand return codes for
a description of the return codes produced by the EVALDEF subcommand.
- Example: The BLSCSETD CLIST formats the current
SETDEF-defined defaults for display on an ISPF data entry panel.
It supports option 0 (DEFAULTS) of the IPCS dialog when TSO/E Release
2 (or a later release of that product) is installed. The first part
of the CLIST uses the EVALDEF subcommand to obtain the SETDEF-defined
defaults as follows. The defaults shown will, by default, be the local
defaults.
EVALDEF CLIST(SOURCE(SRC) CONFIRM(CON) DISPLAY(DSP) +
FLAG(FLG) PRINT(PRI) TERMINAL(TER) VERIFY(VER))
SET CONTROL=FLAG(&FLG) &CON &VER
SET ROUTE=&PRI &TER
IF &LASTCC=8 THEN EXIT
EVALDEF CLIST(QUALIFICATION(QUAL))
See the BLSCSETD
member of SYS1.SBLSCLI0 for the complete listing.