DCOLLECT

The DFSMS Data Collection Facility (DCOLLECT) is a function of access method services. DCOLLECT collects stored data set, volume and policy values into a sequential file you can use as input to other programs or applications.

Note: There is a Report Generator option in the ISMF storage Administrator primary panel 'G' Report Generator that can be sued to create reports based on the sequential file contents that DCOLLECT produces. The report generator ships sample report types for DCOLLECT, both DFSMSdfp and DFSMShsm DCOLLECT record types. In addition, it will ship some sample reports based on those.
DCOLLECT obtains data on:
  • Active Data Sets

    DCOLLECT provides data about space use and data set attributes and indicators on the selected volumes and storage groups.

  • VSAM Data Set Information

    DCOLLECT provides specific information relating to VSAM data sets residing on the selected volumes and storage groups.

  • Volumes

    DCOLLECT provides statistics and information on volumes that are selected for collection.

  • Inactive Data
    DCOLLECT produces output for DFSMShsm-managed data, (inactive data management), which includes both migrated and backed up data sets.
    • Migrated Data Sets: DCOLLECT provides information on space utilization and data set attributes for data sets migrated by DFSMShsm.
    • Backed Up Data Sets: DCOLLECT provides information on space utilization and data set attributes for every version of a data set backed up by DFSMShsm.
  • Capacity Planning
    Capacity planning for DFSMShsm-managed data (inactive data management) includes the collection of both DASD and tape capacity planning.
    • DASD Capacity Planning: DCOLLECT provides information and statistics for volumes managed by DFSMShsm (ML0 and ML1).
    • Tape Capacity Planning: DCOLLECT provides statistics for tapes managed by DFSMShsm.
  • SMS Configuration Information

    DCOLLECT provides information about the SMS configurations. The information can be from either an active control data set (ACDS) or a source control data set (SCDS), or the active configuration.

    DCOLLECT provides attributes that are in the selected configuration for the following:
    • Data Class Constructs
    • Storage Class Constructs
    • Management Class Constructs
    • Storage Group Constructs
    • SMS Volume Information
    • SMS Base Configuration Information
    • Aggregate Group Construct Information
    • Optical Drive Information
    • Optical Library Information
    • Cache Names
    • Accounting Information for the ACS routines

Restriction: Use the DCOLLECT command only with volumes that contain an MVS™ VTOC. If you use the DCOLLECT command with volumes that contain a VM VTOC, the DCOLLECT command fails and error message IDC21804I is displayed.

For information on calling DCOLLECT from ISMF, see z/OS DFSMSdfp Storage Administration. For information on using DCOLLECT to monitor space usage, see Using the Data Collection Application in z/OS DFSMSdfp Storage Administration.

The syntax of the DCOLLECT command is:

Command Parameters
DCOLLECT {OUTFILE(ddname)|
     OUTDATASET(entryname)}
  {[VOLUMES(volser[ volser...])]
     [BACKUPDATA]
     [CAPPLANDATA]
     [EXCLUDEVOLUMES(volser[ volser...])]
     [MIGRATEDATA]
     [SMSDATA(SCDSNAME(entryname)|ACTIVE)]
     [STORAGEGROUP(sgname[ sgname...])]}
  [DDCMEDIA{DDCMENUL|DDCMEDA1|DDCMEDA2|
    DDCMEDA3|DDCMEDA4|DDCMEDA5|DDCMEDA6|
    DDCMEDA7|DDCMEDA8|DDCMEDA9|DDCMEDA10|
    DDCMED11|DDCMED12|DDCMED13}]
  [DDCRECTE{DDCRTNUL|DDC18TRK|DDC36TRK|
    DDC128TK|DDC256TK|DDC384TK|DDCEFMT1|DDCEFMT2|
    DDCEFMT2|DDCEFMT3|DDCEFMT4|DDCEEFM3|DDCEEFM4}]
  [ERRORLIMIT(value)]
  [EXITNAME(entrypoint)]
  [MIGRSNAPALL|MIGRSNAPERR]
  [NODATAINFO]
  [NOVOLUMEINFO]
  [REPLACE|APPEND]
   

DCOLLECT can be abbreviated: DCOL

Exception: Although BACKUPDATA, CAPPLANDATA, MIGRATEDATA, SMSDATA, STORAGEGROUP, and VOLUMES are designated as optional parameters, you must use at least one of them. You can use any combination of these parameters; use at least one.
DCOLLECT User Exit:
For a description of the DCOLLECT User Exit, refer to DCOLLECT User Exit.
DCOLLECT Output
For an explanation of how to interpret DCOLLECT output, see Interpreting DCOLLECT Output.
DCOLLECT Security Considerations
APF Authorization: For information on a program calling DCOLLECT see Invoking Access Method Services from Your Program.
DCOLLECT HFS Considerations
The information in DCOLLECT type 'D' records for HFS files are not all contained in the VTOC, VVDS or catalog. You must define an appropriate OMVS segment in order to gather all statistics.
 
RACF® Authorization: To control access to the DCOLLECT function, a RACF check for authorization is made for a FACILITY class profile of STGADMIN.IDC.DCOLLECT. If this profile exists, then read authority is necessary. The command will not be successful if the user is not authorized.