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.

Default option discusses the processing of the EVALUATE subcommand when the CHECK, CLIST, REXX, and DIALOG parameters are all omitted. This is an archaic form of the EVALUATE subcommand that should not be used in new CLISTs, REXX execs, or dialogs. When existing CLISTs and REXX execs are updated, the old subcommand should be replaced with an EVALUATE subcommand using a CLIST, REXX, or DIALOG parameter. See CLIST, REXX, or DIALOG option.

Note:

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.