Space banner

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Usage notes for all reports

The following information is helpful in generating reports:
  • The operands and values listed as option keywords are used during the data collection phase of the report processing. Values specified for these operands control which data is collected from the catalog, HSM Control Data Sets, or Volume Table of Contents. Values used in these option keywords have the most affect on the processing time and memory usage requirements of a given report.

    Warning

    Exercise caution when developing a report requesting very large amounts of data. Report requests that exceed the memory limits of the address space can result in an 878, 80A, or 40D abend code. Use option keywords and filters to break up a large, single job step report into a multi-step job with each step producing a portion of the report.

  • The data-output field names can be used in SORT and ORDER statements. Also, except where noted, filters can be specified for most of these fields. Using filters with one or more data-output field names offers great flexibility in tailoring the report output. However, care should be used when specifying multiple filters, since only lines that match all filter criteria specified will be printed.

  • To prevent line wrapping, you can use the LRECL parameter on DD statements related to the DD names specified by control parameters SYSPRINT(ddname).

  • Batch reports can use any of the following comparison operators, depending on the specified keyword:

    Operator

    Name

    Description

    =

    Equals

    The value of the parameter at run time must equal the specified value. This is the default operator.

    <

    Less than

    The value of the parameter at run time must be less than the specified value.

    >

    Greater than

    The value of the parameter at run time must be greater than the specified value.

    ¬= or ¬ or MISSING SYMBOLS

    Not equals

    The value of the parameter at run time must be a value other than the specified value (the logical not symbol preceding the equals symbol is EBCDIC X'5F').

  • There are three classes of keywords that can be used in the various reports:

    • Static keywords

      These are keywords that accept only standardized parameters. For example, the SYSPRINT keyword will accept only a valid DD name; no operator or masking is allowed. The static keywords are COMPANY, CONTEXT, DAY, DSTYPE, FRSTDATE, FRSTTIME, HSMHOST, LASTDATE, LASTTIME, LINECT, MONTH, NMBRDAYS, NMBBRHRS, ORDER, SHOWCAT, SMSIND, SORT, SYSPRINT, SYSTEMID, TAPETYPE, TITLE, TYPE, VOLRANGE, and WEEK.

    • Selection keywords

      These are keywords that provide very early filtering. As each record is encountered, these parameters allow or disallow its processing. Other filtering takes place after all allowed records have had their initial processing. The selection keywords are DSN, DSNMASK, PREFIX, SMSGROUP, and VOLSER. These keywords accept the equal and not equal operators, but not the less than or greater than operators. These are the only keywords that accept masking (an ending slash.) They are also the only keywords that can be used directly with an operator as well as with the Keyword(OperatorValue) format. For example DSN^SYS1.V/ can be used instead of DSN(^SYS1./).

    • Field keywords

      These are the keywords that are accepted within the ORDER keyword (excluding the selection keywords above). All operators are accepted within the value for the keyword, but masking is not accepted. Examples: LRECL(>80), DSORG(^=VS).

  • Individual reports can have specific restrictions or requirements for their keywords.

  • You can specify the order in which fields are printed on the report and the sequence of report output.

  • You can generate multiple reports in a single batch job.

Note

Less than or equal to and greater than or equal to are not supported.

Was this page helpful? Yes No Submitting... Thank you

Comments