SCC-DLimit reporting - syncsort_scc_monitor - Latest

JCL Statements

The following examples show the required JCL statements for SCC-DLimit reporting.

The first step invokes DLMAINT to select the desired records from the SCC-DLimit database. The second step produces the report.

-- Step 1: Extract records with DLMAINT
//BACKDB  EXEC PGM=DLMAINT,REGION=4M
//STEPLIB DD  DISP=SHR,DSN=DTS.R71.LOADLIB
//EXTRACT  DD  DSN=&&EXTRACT,DISP=(,PASS),UNIT=SYSDA,
//             SPACE=(CYL,(1,1),RLSE)
//SYSPRINT DD  SYSOUT=*
//SYSIN    DD  *
  INCLUDE ACCOUNT(*)
  BACKUP TODD(EXTRACT)
*
    

Figure 8-1. Sample report JCL - step 1 - data extraction

-- Step 2: Run MONRUN to generate the report
//REPORT  EXEC PGM=MONRUN,REGION=4M
//STEPLIB DD  DISP=SHR,DSN=DTS.R71.LOADLIB
//EXTRACT  DD  DSN=*.DLMAINT.EXTRACT,DISP=SHR
//SYSPRINT DD  SYSOUT=*
//SYSOUT   DD  SYSOUT=*
//TOOLMSG  DD  SYSOUT=*
//DFSMSG   DD  SYSOUT=*
//SYSUT1   DD  SPACE=(CYL,(2,1)),UNIT=SYSDA,
//             DCB=(RECFM=FB,LRECL=250,DSORG=PS)
//SYSUT2   DD  SPACE=(CYL,(2,1)),UNIT=SYSDA
//SYSUT3   DD  SPACE=(CYL,(2,1)),UNIT=SYSDA
//SYSIN    DD  *   control statement
//RULE     DD  *   rule statements
*
    

DLimit reporting control statements

The following control statements may be specified in the SYSIN stream of the EXEC PGM=MONRUNstep. These control statements specify the location of the RULE data set, the format of the report output, sort and control break summarization fields, column headings, and other information that is needed to produce the report output.

DSL(DDNAME(ddname))

Specifies the DD name of the data set containing SCC-DLimit database records which are input to reporting. These records are created by extracting information on desired accounts via the BACKUP function of DLMAINT.

RULES(NAME(RULE) PARMLIB() LIST))

Specifies the DD name of the RULE data set. The RULE data set contains SCC-DLimit rules that specify which fields are needed in the report. Further filtering may be performed by IF statements in the RULE data set, and new fields may be defined by the rules. If the RULE data set is a sequential data set or included instream, the PARMLIB operand may be empty. If the RULE data set is a member of a PDS, the PARMLIB operand must specify the DDname of the PDS while the RULE operand specifies the member name. The LIST operand is optional and causes the contents of the RULE data set to be displayed on SYSPRINT.

SORT(field_name, A | D, field_name, A | D, ...)

Specifies fields on which report detail records are sorted. Fields must have been included in the DEFREC statement in the RULE data set. Use A for ascending or D for descending order.

FORMAT ( DATE( abcd )

FIELD( field_names )

LINES( num )

MAX( 'text' )

MIN( 'text' )

TIME( abc )

TITLE( 'text' )

TOTAL( 'text' ))

The FORMAT statement defines report output: which fields are included, column headings, titles, and general layout. The following subparameters may be specified in FORMAT:

• DATE(abcd) — Print the date in the report title. Format is specified by combination of M, D, Y or 4 (each once). 'd' is a separator character. Default: DATE(MD4/).
• FIELD(field_name, field_name, ...) — Which fields (for example, account name, current space amount) appear in the report. Fields appear in columns in the order specified. If no column heading is specified via HEADER in DEFREC, the field name becomes the heading. Field names must be defined in DEFREC and can be found in the Symbolic Fields chapter.
• LINES(num) — Number of lines per page. Default: 61.
• MAX('text') — Identify maximum values in numeric fields and include them in a summary at the end of the report. The parameter text is the title line for the maximum values.
• MIN('text') — Identify minimum values in numeric fields and include them in an end-of-report summary.
• TIME(12 | 24 x) — Print time in the report title in 12- or 24-hour format. Separator character x defaults to ':'.
• TITLE('text') — Specify a report title. Enclose text in quotes if it contains embedded blanks. The title line is printed at the top of each page and includes title string, date, time and page number. A blank line follows the title line.
• TOTAL('text') — Identify and sum numeric fields and include totals in an end-of-report summary. The parameter text is the title line for the totals.

Sample reports

Several sample reports are included in the SCC-DLimit Sample Library. These reports provide examples of how to use the SCC-DLimit reporting facilities to produce detail and summary reports that give a clearer picture of DASD space use across the installation.

Account detail report

This is member DSLRPT1 in the Sample Library. For selected accounts, show the current total space assigned to the account, maximum space limit, and other account information.

Accounts over limit report

This is member DSLRPT2 in the Sample Library. Display all SCC-DLimit accounts which have exceeded either their specified limit (MAX) or their warning levels.

High-watermark report

This is member DSLRPT3 in the Sample Library. For selected accounts, show the highest amount of space ever assigned to the account (the high-water mark) and the date on which it occurred.