z/OS V1R6.0 DFSMS Access Method Services for Catalogs

DCOLLECTRestriction: Use the DCOLLECT command only with volumes that contain anMVS VTOC. If you use the DCOLLECT command with volumes that contain a VMVTOC, the DCOLLECT command fails and error message IDC21804I is displayed.For information on calling DCOLLECT from ISMF, see z/OS DFSMSdfp StorageAdministration Reference. For information on using DCOLLECT to monitor spaceusage, see .The syntax of the DCOLLECT command is:||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}][DDCRECTE{DDCRTNUL|DDC18TRK|DDC36TRK|DDC128TK|DDC256TK|DDC384TK|DDCEFMT1}][ERRORLIMIT(value)][EXITNAME(entrypoint)][MIGRSNAPALL|MIGRSNAPERR][NODATAINFO][NOVOLUMEINFO][REPLACE|APPEND]DCOLLECT can be abbreviated: DCOLException: Although BACKUPDATA, CAPPLANDATA, MIGRATEDATA,SMSDATA, STORAGEGROUP, and VOLUMES are designated as optionalparameters, you must use at least one of them. You can use any combination ofthese parameters; use at least one.DCOLLECT User Exit:For a description of the DCOLLECT User Exit, refer to Appendix E,“DCOLLECT User Exit,” on page 431.DCOLLECT OutputFor an explanation of how to interpret DCOLLECT output, see Appendix F,“Interpreting DCOLLECT Output,” on page 437.DCOLLECT Security ConsiderationsAPF Authorization: For information on a program calling DCOLLECT seeAppendix D, “Invoking Access Method Services from Your Program,” on page421.DCOLLECT HFS ConsiderationsThe information in DCOLLECT type ’D’ records for HFS files are not allcontained in the VTOC, VVDS or catalog. You must define an appropriateOMVS segment in order to gather all statistics.114 z/OS V1R6.0 DFSMS Access Method Services for Catalogs