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.
- 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
- 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.