DATASET
The DATASET control statement requests the Dataset Activity Report.
{,REPORT=(DATASET|,JOB|,VOLUME,ALL)}
{,TYPE=SUMMARY|DETAIL|BOTH}
{,THRESHLD=nnnnn}
{,SUMLIMIT=40|nnn}
{,DSN=dsn_range_list}
{,JOB=job_range_list}
{,VOL=volume_range_list}
The data for this report is obtained from SMF type 42-6 records written by the IBM MVS DFSMS component.
The Dataset Activity Report consists of the following detail and summary sections:
- Dataset Activity Detail by DSN
- Dataset Activity Summary by DSN
- Dataset Activity Detail by Job Name
- Dataset Activity Summary by Job Name
- Dataset Activity Detail by Volume
- Dataset Activity Summary by Volume
This report is produced from SMF 42-6 records. These records are produced by SMS, and not CMF Extractor. To produce a valid report, the SMF type 42-6 records must remain in the order in which they were written (SYSID, DATE, and TIME). The following sort control statement will sort the records in their original order:
Parameters
The parameters for the DATASET control statement are as follows:
REPORT= | specifies which report is to be produced:
|
|---|---|
TYPE= | specifies the section types to be produced:
|
THRESHLD= | specifies the I/O count threshold for the data set, below which the data set is omitted from the report This parameter applies to detail reports only. The value specified must be an integer with a value between 1 and 999,999,999. If you do not specify the THRESHLD parameter, no threshold test is performed. |
SUMLIMIT= | specifies the number of summary lines that are to appear on the summary reports This parameter applies to summary reports only. Any numeric value can be specified in the range of 1 to 999. If you do not specify the SUMLIMIT parameter, the value will be the default of 40, thus providing single-page summary reports. |
DSN= | specifies up to 10 DSNs or DSN ranges that are to be included on the report With the exception of a terminating asterisk, a DSN must follow the rules of JCL DSN construction and cannot exceed 44 characters in length. A DSN range is simply a from/through set of two DSNs that are separated by a colon (:). The from DSN must be less than the through DSN. A DSN can terminate with an asterisk (*), thus specifying a begins with value. Commas (,) are used to separate DSNs and DSN ranges; for example DSN=(SYS1.AA:SYS1.ZZ,MY.DSN.ONE,MY.DSN.TWO,YOUR.DSN.*) If you do not specify the DSN parameter, all DSNs are eligible for the report. |
JOB= | specifies up to 10 job names or job name ranges that are to be included on the report With the exception of a terminating asterisk, a job name must follow the rules of JCL job name construction and cannot exceed 8 characters in length. A job name range is simply a from/through set of two job names that are separated by a colon (:). The from job name must be less than the through job name. A job name can terminate with an asterisk (*), thus specifying a begins with value. Commas (,) are used to separate job names and job name ranges; for example DSN=(MYJOBAA:MYJOBZZ,PAYROLL,CHECKRUN,YOURJOB*) If you do not specify the JOB parameter, all job names are eligible for the report. |
VOL= | specifies up to 10 volume IDs or volume ID ranges that are to be included on the report With the exception of a terminating asterisk, a volume ID must follow the rules of JCL volume ID construction and cannot exceed 6 characters in length. A volume ID range is simply a from/through set of two volume IDs that are separated by a colon (:). The from volume ID must be less than the through volume ID. A volume ID can terminate with an asterisk (*), thus specifying a begins with value. Commas (,) are used to separate volume IDs and volume ID ranges; for example VOL=(LIB001:LIB999,DATAAA:DATAZZ,SYS*) If you do not specify the VOL parameter, all volume IDs are eligible for the report. |
Examples
The following examples illustrate the use of the DATASET control statement.