EVALDEF subcommand — format defaults

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.