EVALUATE subcommand — retrieve dump data for a variable
Use the EVALUATE subcommand to retrieve information from a dump and format that information in CLIST variables, REXX variables, or ISPF function pool dialog variables.
- EVALUATE might modify X, the current address.
- With TSO/E Release 2 installed, you can use this subcommand to update global CLIST variables. For information about using global variables and writing your own CLISTs, see z/OS TSO/E CLISTs and z/OS MVS IPCS User's Guide.
- Related subcommands
- EVALSYM
- Syntax
{ EVALUATE } data-descr { EVAL } [ CLIST(var-list) [ MASK(mask) ] ] [ DIALOG(var-list) [ MASK(mask) ] ] [ REXX(var-list) [ MASK(mask) ] ] [ CHECK ]
-------- SETDEF-Defined Parameter --------------------------
Note: You can override the following SETDEF parameter.
See SETDEF subcommand — set defaults.[ TEST | NOTEST ]
- Parameters
- data-descr
- Specifies the data description parameter, which consists of five
parts:
- An address (required)
- Address processing parameters (optional)
- An attribute parameter (optional)
- Array parameters (optional)
- A remark parameter (optional)
Data description parameter explains the use and syntax of the data description parameter.
- MASK(mask)
- Defines a value that is logically ANDed with the retrieved information. The AND operation occurs before the retrieved information is formatted into a variable. The mask must be the same length as the retrieved information. The mask value must be a general value. See Literal values for more information about specifying a general value.
- CHECK
- Directs IPCS to inform a CLIST, REXX exec, or ISPF dialog whether 1 to 4 bytes of storage can be accessed in a dump. CHECK option below discusses this option further.
- CLIST(var-list)
- DIALOG(var-list)
- REXX(var-list)
- Specifies how to format the information.
CLIST(var-list) designates that the information be formatted into CLIST variables.
DIALOG(var-list) designates that the information be formatted into ISPF function pool dialog variables.
REXX(var-list) designates that the information be formatted into REXX variables.
The syntax for var-list is as follows:
[ ENQUOTE|UNQUOTE|NOQUOTES ] [ NOBLANKS ] [ PROTECTION(protection) ] [ STORAGE(storage) ] [ FORMATTED|UNFORMATTED ]
- ENQUOTE or UNQUOTE or NOQUOTES
- Specifies how CHARACTER data is to be formatted:
- ENQUOTE requests a quoted string.
- UNQUOTE and NOQUOTES request that apostrophes (X'7D') translated to periods.
- NOBLANKS
- Requests that blanks (X'40') in CHARACTER data be translated to periods.
- PROTECTION(protection)
- Specifies the name of the CLIST, REXX, or ISPF dialog variable into which IPCS
places the formatted protection key. Note: When no storage key is known for a block of storage, IPCS supplies the value X'FF' This occurs when IPCS processes DOMAIN(SUMDUMP) records and active storage. The following topic, CLIST, REXX, or DIALOG option, discusses the processing performed.
- STORAGE(storage)
- Specifies the name of the variable into which IPCS places the formatted storage.
- FORMATTED or UNFORMATTED
- Specifies how the information is to be returned:
- FORMATTED
Formatted data is returned. This is the default.
- UNFORMATTED Unformatted data is returned. This option is mutually exclusive with the following var-list keywords:
- ENQUOTE | UNQUOTE | NOQUOTES
- NOBLANKS
The UNFORMATTED keyword causes the storage variable, if specified, to receive an image of the data requested. The storage that can be processed is 32760 bytes.
- FORMATTED