This appendix contains General-use Programming Interface and Associated
Guidance Information.
This appendix is intended to help you to interpret DCOLLECT output.
DCOLLECT provides you with data set information, volume usage information,
and information about data sets and storage controlled by DFSMShsm.
Running DCOLLECT produces a snapshot of the requested information
as it exists at that time. DCOLLECT does not monitor the information
continuously. This information can then be used for accounting, planning,
statistical, and other purposes.
The following output record types are included in this appendix:
- Type
- Name
- D
- Active Data Set Record
- A
- VSAM Association Information
- V
- Volume Information
- M
- Migrated Data Set Information
- B
- Backup Data Set Information
- C
- DASD Capacity Planning Information
- T
- Tape Capacity Planning Information
- DC
- Data Class construct information
- SC
- Storage Class construct information
- MC
- Management Class construct Information
- BC
- Base Configuration Information
- SG
- Storage Group construct Information
- VL
- Storage Group volume Information
- AG
- Aggregate Group Information
- DR
- OAM Drive Record Information
- LB
- OAM Library Record Information
- CN
- Cache Names from the Base Configuration Information
- AI
- Accounting Information from the ACS routines
The output data set used by DCOLLECT must be created prior to calling
the function. It must have a physical sequential organization (PS)
and a record format of variable (V) or variable blocked (VB). Using the following guidelines,
the primary space for the data set can be estimated:
- Volume list
- Size of record (336 + 4) * average number of data sets on volume
* number of volumes scanned.
- Storage Group list
- Size of record (260 + 4) * average number of data sets on volume
* number of volumes in the each storage group * number of storage
groups.
- Migration data
- Size of record (248 + 4) * number of data sets migrated.
- Backup data
- Size of record (228 + 4) * number of data set backup versions.
- Data Class Construct
- Size of record (316 + 4) * number of data class constructs.
- Storage Class Construct
- Size of record (280 + 4) * number of storage class constructs.
- Management Class Construct
- Size of record (308 + 4) * number of management class constructs.
- Storage Group Construct
- Size of record (848 + 4) * number of storage group constructs.
- SMS Managed volumes
- Size of record (440 + 4) * number of SMS managed volumes.
- Base Configuration
- Size of record (984+4).
- Aggregate Group Constructs
- Size of record (640 + 4) * number of aggregate group constructs.
- Optical Drives
- Size of record (424 + 4) * number of optical drives.
- Optical Libraries
- Size of record (448 + 4) * number of optical libraries.
- Cache Names
- Size of record (176 + 4) * number of cache names.
- Accounting Information
- Size of record (352 + 4) * number of records.
Note: The fields described here are available in a macro form that
can be included in an application program. Record formats for the
D, A, and V records are mapped by IDCDOUT available in SYS1.MACLIB.
Record formats for the M, B, C, and T records are available in ARCUTILP,
also available in SYS1.MACLIB.