EVALDUMP subcommand — format dump attributes

Use the EVALDUMP subcommand to retrieve information from a source description and format that information in CLIST variables, REXX variables, or ISPF function pool dialog variables.

The source description is for an unformatted source that IPCS can format, for example, an SVC dump, a stand-alone dump, an SYSMDUMP dump, a trace data set, a data set, or active storage. The source description is in a directory allocated with ddname IPCSDDIR and is your current dump directory. The current dump directory is your user dump directory or, for users with access authority, might be the sysplex dump directory.

The source description is for a source that IPCS has initialized or for a source IPCS accessed during processing of an ADDDUMP subcommand.

• Related subcommands
  • EQUATE
  • EVALDEF
  • EVALMAP
  • EVALSYM
• Syntax

   EVALDUMP   [ relational-operator ]
  
              [ CLIST(var-list)  ]
              [ DIALOG(var-list) ]
              [ REXX(var-list)   ]
              [ INDATASET(dsname) | INFILE(ddname) ]

  -------- SETDEF-Defined Parameter --------------------------
  Note: You can override the following SETDEF parameter.
  See SETDEF subcommand — set defaults.

              [ ACTIVE | MAIN | STORAGE          ]
              [ DSNAME(dsname) | DATASET(dsname) ]
              [ FILE(ddname) | DDNAME(ddname)    ]
              [ PATH(path-name)     ] 
              [ TEST | NOTEST ]

• Parameters

  relational-operator

  Specifies a symbolic or programming operators to be used with the source to identify the source description to be retrieved from the dump directory. The syntax for relational-operator is as follows:

        [  < | LT ]
        [ <= | LE ]
        [  > | GT ]
        [ >= | GE ]
        [ ¬> | NG ]
        [ ¬< | NL ]
        [  = | EQ ]

  For example, the less than (<|LT) relationship is satisfied by the highest-collating source name that also collates lower than the source name specified on the EVALDUMP subcommand.

  CLIST(var-list)

  DIALOG(var-list)

  REXX(var-list)

  Specifies how the default values are to be formatted.

  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.

  INDATASET(dsname)

  INDSNAME(dsname)

  Requests allocation of directory dsname and use of the contents of that directory by the subcommand.

  INFILE(ddname)

  INDDNAME(ddname)

  Requests use of a directory that the IPCS user has allocated to ddname and use of the contents of that directory by the subcommand.

  The syntax for var-list is as follows:

       [ DECIMAL | F     ]
       [ HEXADECIMAL | X ]
       [ BLOCKS(blocks) ]
       [ BYTES(bytes) ]
       [ QUALIFICATION(qualification) ]
       [ SOURCE(var-name)|DATASET(var-name)|DSNAME(var-name) ]

  DECIMAL or F

  HEXADECIMAL or X

  Specifies the format of the number of blocks.

  DECIMAL or F designates that IPCS format the number of blocks using decimal digits. The default is DECIMAL.

  HEXADECIMAL or X designates that IPCS format the number of blocks using hexadecimal digits.

  BLOCKS(blocks)

  Places the number of blocks contained in the dump to be formatted in the variable blocks.

  BYTES(bytes)

  Formats and places the number of bytes contained in the dump in the variable bytes. IPCS always uses decimal for the number of bytes.

  QUALIFICATION(qualification)

  Formats and places the address qualifiers that describe the default address space for the dump in the variable qualification.

  SOURCE(var-name) | DATASET(var-name) | DSNAME(var-name)

  Places the name of the retrieved data set in the variable var-name.

• SETDEF-Defined Parameters

  ACTIVE or MAIN or STORAGE

  DSNAME(dsname) or DATASET(dsname)

  FILE(ddname) or DDNAME(ddname)

  Specifies the source of the source description from which you want to retrieve information. If one of these parameters is not specified, IPCS uses your current source.

• Return Codes

  See Standard subcommand return codes for a description of the return codes produced by the EVALDUMP subcommand.

• Example: The BLSCEDUM CLIST lists the number of blocks and bytes for each source in the dump directory. It uses the EVALDUMP subcommand to retrieve the information as follows:

  EVALDUMP >= ACTIVE CLIST(SOURCE(SRC) BLOCKS(JL) BYTES(JY))

  See the BLSCEDUM member of SYS1.SBLSCLI0 for the complete listing.