COMMSTOR

The COMMSTOR control statement requests either the Common Storage Usage Summary Report or the Common Storage Usage Detail Report.

COMMSTOR
[REPORT={SUMMARY|DETAIL}]
[,SELECT=(name1,...,name32)]
[,SORT=([CSA<,AVG|MAX|MIN],|
    [CSA>,AVG|MAX|MIN],|
    [CSA,AVG|MAX|MIN],|
    [SQA<,AVG|MAX|MIN],|
    [SQA>,AVG|MAX|MIN],|
    [SQA,AVG|MAX|MIN])]
[,LIMIT=nnnn]
[TBLSIZE={20,000|nnnnnn}]

Related topics

Report control statements (Analyzer)
CSMON
Common Storage Usage Summary Report
Common-Storage-Usage-Detail-Report

If a summary report is requested, the average CSA and SQA usage by job name values are printed. If a detail report is requested, the average, maximum, and minimum CSA and SQA usage by job name values, and the date and time stamps of these values, are printed.

The COMMSTOR statement uses data that is collected by the CSMON Extractor control statement.

Parameters

The parameters for the COMMSTOR control statement are as follows:

REPORT=

specifies a type of report; possible values are:

  • DETAIL—-requests the Common Storage Usage Detail Report
  • SUMMARY—requests the Common Storage Usage Summary Report; this value is the default

SELECT=

optionally specifies from 1 to 32 specific job names or selection masks; data for all other jobs is ignored

If SELECT is not specified, all job names are selected. The following wildcard characters can be used to define groups of job names:

  • + (plus sign)—any character
  • * (asterisk)—any combination of characters

Important

Use the * wildcard character only at the end of a string. The + wildcard character can be used in any position within the string.

Example

The parameter SELECT=(+MF) would select only those job names that are three characters long and where the first character is any character, but the second and third characters are MF. On the other hand, the parameter SELECT=(+MF*) would select those job names that are from three to eight characters long and where the first character is any character, the second and third characters are MF, and the remaining characters are in any number and combination.

SORT=

optionally specifies the sort sequence for the report; the parameter has two parts or entries:

The first entry specifies what data area is to be the sort sequence. Permitted values and their meanings are:

  • CSA<—CSA below 16-MB line
  • CSA>—CSA above 16-MB line
  • CSA—all CSA
  • SQA<—SQA below 16-MB line
  • SQA>—SQA above 16-MB line
  • SQA—all SQA

The second SORT entry defines whether to use the average, maximum, or the minimum value as the sort sequence for the DETAIL report. Permitted values and their meanings are:

  • MIN—minimum value; sort sequence ascending
  • MAX—maximum value; sort sequence descending
  • AVG—average value; sort sequence descending

If SORT is not specified, the sort is by job name. Job names are printed in alphabetical order.

LIMIT=

specifies that only the firstnnnn job name entries are displayed in the report

This parameter is useful if you want to produce a short report with the 'worst offenders' of CSA or SQA usage.

TBLSIZE=

specifies how much storage is allocated for an internal table used by the COMMSTOR report modules

The table is used to store job names and address space IDs (ASIDs) as ten-byte entries for each recording interval. The default size of the table is 20,000 bytes, which can store up to 2,000 entries.

Important

This parameter should be used only if error message CMF07385 is issued.

Examples

The following examples illustrate the use of the COMMSTOR control statement.

Example
 COMMSTOR  REPORT=DETAIL,SELECT=(ADMPRINT,ALT1),SORT=(CSA,AVG)

A Common Storage Usage Detail Report is produced, containing CSA usage data for the jobs ADMPRINT and ALT1 only. The selected data is sorted by average total CSA (all CSA) and printed in descending order.

Example
COMMSTOR REPORT=SUMMARY,SORT=(CSA,MAX),LIMIT=50

A Common Storage Usage Summary Report is produced, showing the 50 jobs that used the most CSA.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*