INCLUDE / EXCLUDE

The information to be processed can be filtered by one or more INCLUDE / EXCLUDE statements. Valid values that can be specified in these INCLUDE / EXCLUDE statements are listed in the appendix that discusses logical field names for the Control-M/Tape Repository in the INCONTROL for z/OS Administrator Guide.

If no INCLUDE / EXCLUDE statement is specified, a report is created for all records in the Stacking database.

For more information about INCLUDE / EXCLUDE statements, see Record Selection Logic (INCLUDE / EXCLUDE Statements) (CTM). Optional.

REPORT

The report to be produced by the utility. Mandatory.

• NAME — Report name. Mandatory. Valid value is:

  - STACKING — Stacking Statistics Report listing all requested statistics for the Control-M/Tape controlled data sets.

• FOLD – Indicates whether all report data is printed in uppercase. Valid values are:

  - YES — Print all report data in uppercase.

  - NO — Print report data in upper and lowercase. Default.

• PAGESIZE — Maximum lines in a page, where p is a numeric value between 21 and 16383. Optional. Default: 63.
• LINESIZE — Maximum characters in a line, where s is a numeric value not greater than 255. Optional. Default: 127.
• MARGINS=m-n — Lowest (m) and highest (n) columns in a line, where m is a numeric value greater than 0 and n is a numeric value greater than m but not greater than s (the value of LINESIZE). Optional. Defaults: m=1 and n=s.
• SUMMARY=YES|NO — Indicates whether to show a summary line for each field break. Optional. Default: NO
  A field break occurs when there is a change in value for a field that is specified in a SORTBY statement with option /BRK, (or /B).
• OUTDD — JCL DD name of the output. Default: REPOUT

FIELDS

Fields to print in the report. The fields are printed in the order specified. Available fields:

• JOBNAME – Name of the job that created the data set
• DSNAME – Name of the data set
• STATUS – Whether the data set is stackable
• UNIT – Unit name on which the data set was created
• RFORMAT – Track recording format with which the data set was recorded
• OBSERVE – Number of observations of the data set that were used to determine statistics for the data set
• MAXSIZE – Maximum data set size in Kilobytes (KB)
• MINSIZE – Minimum data set size in Kilobytes (KB)
• TOTSIZQ – Sum of the square of data set size for all previous observations in Kilobytes (KB)
• STDDEV – Standard deviation (in Kilobytes) of data set size for all observations
• AVGSIZE – Average data set size in Kilobytes (KB)
• PREDICTD – Predicted data set size in Kilobytes (KB)
• AVGSIZEU – Average uncompressed data set size in Kilobytes
• DATEUPD – Last update date of the stacking record
• TIMEUPD – Last update time of the stacking record
• PREDICTU – Average predicted uncompressed data set size in Kilobytes
• LIFEOBS – Total number of observations of the data set (including observations that were not used to calculate data set statistics). This field is relevant only for data sets with nonspecific retention (for example, CATALOG or LAST ACCESS).
• LIFESPAN – Average life span of the data set in days. This field is relevant only for data sets with nonspecific retention (for example, CATALOG or LAST ACCESS).

SORTBY

Order in which the report is sorted. Optional. (Available fields are listed above, under parameter FIELDS.) The /B (or /BRK) option can be added as a suffix to any field to indicate that a page break is inserted in the report when the field changes its value.

ATTR

Override of default attributes defined for a field. For more information, see the FIELDS parameter in this table. Optional.

BREAK

Attributes of the summary header lines printed when a field break occurs. Optional.

Note: For a description of the options of these statements, see the FIELDS, SORTBY, ATTR, and BREAK statements in CTTRPT – Database extraction and report utility.