








	*DCOLLECT Tools*

DCOLLECT Type D Record

This table shows the record layout for type D DCOLLECT records
(Active Data Set Record).

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

The DCOLLECT output file consists of a number of different record types.

Type D records contain active data set information. One of these records is created for each data set encountered on every volume scanned (as long as the NODATAINFO parameter is *not* specified.)

It's easy to report on DCOLLECT type D records! (Jump to sample reports)

We have a low-cost 4GL report writer especially for DCOLLECT files. It's called Spectrum DCOLLECT Reporter.

Spectrum DCOLLECT Reporter handles the difficult DCOLLECT record parsing for you automatically. You just specify which fields you want to see.

Spectrum DCOLLECT Reporter also converts the arcane date and time fields and reformats them into an attractive report. It defines the individual bit flags for easy testing or printing.

Plus, Spectrum DCOLLECT Reporter can export DCOLLECT data as comma delimited files to use on your PC.

DCOLLECT Type D Record -- Active Data Set Record
Offset (Dec.)	Name	Length	Format	Description
* ******************************************************************** * * HEADER PORTION OF DATA COLLECTION UTILITY OUTPUT RECORD. EACH * * * DATA SECTION IS PRECEDED BY THIS HEADER. * * ********************************************************************
0	DCURDW	4	Binary	RECORD DESCRIPTOR WORD
0	DCULENG	2	Binary	LENGTH OF THIS RECORD
2		2	Character	RESERVED
4	DCURCTYP	2	Character	RECORD TYPE FOR THIS RECORD
6	DCUVERS	2	Binary	VERSION
8	DCUSYSID	4	Character	SYSTEM ID FOR THIS OPERATION
12	DCUTMSTP	8	Character	TIMESTAMP FIELD
12	DCUTIME	4	Binary	TIME IN SMF HEADER FORMAT
16	DCUDATE	4	Character	DATE IN SMF FORMAT (CCYYDDDF)
20		4	Character	RESERVED
24	DCUDATA	1	Character	END OF HEADER
* ******************************************************************** * * ACTIVE DATA SET INFORMATION (RECORD TYPE 'D') * * * Contains data set information. * * * One of these records is created for each data set encountered * * * on every volume scanned (as long as the NODATAINFO parameter is * * * not specified.) * * ********************************************************************
0	DCDADSI	1	Character
0	DCDDSNAM	44	Character	DATA SET NAME
44	DCDERROR	1	Character	ERROR INFORMATION FLAGS • DCDEMNGD X'80' SMS MANAGED INCONSISTENCY • DCDEDVVR X'40' DUPLICATE VVR FOUND • DCDNOSPC X'20' NO SPACE INFORMATION PROVIDED • DCDVSAMI X'10' VSAM INDICATORS INCONSISTENT • DCDNOFM1 X'08' NO FMT 1 DSCB FOR THIS DATA SET
45	DCDFLAG1	1	Character	INFORMATION FLAG #1 • DCDRACFD X'80' DATA SET IS RACF DEFINED • DCDSMSM X'40' SMS MANAGED DATA SET • DCDTEMP X'20' TEMPORARY DATA SET • DCDPDSE X'10' PARTITIONED DATA SET (EXTENDED) • DCDGDS X'08' GENERATION DATA GROUP DATA SET • DCDREBLK X'04' DATA SET MAY BE REBLOCKED • DCDCHIND X'02' CHANGE INDICATOR • DCDCKDSI X'01' CHECKPOINT DATA SET INDICATOR
46	DCDFLAG2	1	Character	INFORMATION FLAG #2 • DCDNOVVR X'80' NO VVR FOR THIS DATA SET • DCDINTCG X'40' DATA SET IS AN ICF CATALOG • DCDINICF X'20' DATA SET IS CATALOGED IN ICF CAT • DCDALLFG X'08' 31BIT ALLOCATED SPACE AVAILABLE • DCDUSEFG X'04' 31BIT USED SPACE AVAILABLE • DCDSECFG X'02' 31BIT SECONDARY SPACE AVAILABLE • DCDNMBFG X'01' 31BIT UNUSEABLE SPACE AVAILABLE
47	DCDFLAG3	1	Character	INFORMATION FLAG #3 • DCDPDSEX X'80' POSIX FILE SYSTEM FILE • DCDSTRP X'40' EXTENDED FORMAT • DCDDDMEX X'20' DDM INFO EXIST FOR THIS DS • DCDCPOIT X'10' CHECKPOINTED DATASETS • DCDGT64K X'08' GT 64K TRK FLAG
48		2	Character	reserved
50	DCDDSORG	2	Character	DATA SET ORGANIZATION
50	DCDDSOR0	1	Character	DATA SET ORGANIZATION BYTE 0 • DCDDSGIS X'80' IS INDEXED SEQUENTIAL ORG • DCDDSGPS X'40' PS PHYSICAL SEQUENTIAL ORG • DCDDSGDA X'20' DA DIRECT ORGANIZATION • DCDDSGPO X'02' PO PARTITIONED ORGANIZATION • DCDDSGU X'01' U UNMOVEABLE DATA SET
51	DCDDSOR1	1	Character	DATA SET ORGANIZATION BYTE 1 • DCDDSGGS X'80' GS GRAPHICS ORGANIZATION • DCDDSGVS X'08' VS VSAM DATA SET
52	DCDRECRD	1	Character	RECORD FORMAT BYTE • DCDRECFM X'C0' RECORD FORMAT BITS • DCDRECFT X'20' TRACK OVERFLOW • DCDRECFB X'10' BLOCKED RECORDS • DCDRECFS X'08' STANDARD BLOCKS(F) OR SPANNED(V) • DCDRECFA X'04' ANSI CONTROL CHARACTER • DCDRECFC X'02' MACHINE CONTROL CHARACTER
53	DCDNMEXT	1	Binary	NUMBER OF EXTENTS USED
54	DCDVOLSR	6	Character	VOLUME SERIAL NUMBER
60	DCDBKLNG	2	Binary	BLOCK LENGTH
62	DCDLRECL	2	Binary	RECORD LENGTH
* --------------------------------------------------------------- * Extended Address Volume EAV support has introduced new fields * to contain the following data set sizes in 63 bit format. New * and migrating applications should be changed to reference the * 63 bit values: DCDALLSX DCDUSESX DCDSCALX DCDNMBLX *
64	DCDALLSP	4	Binary	31 BIT SPACE ALLOCATED TO DATA SET IN KB (1024). ONLY VALID WHEN DCDUSEFG = ON.
68	DCDUSESP	4	Binary	31 BIT SPACE USED BY DATA SET IN KB (1024). ONLY VALID WHEN DCDUSEFG = ON.
72	DCDSCALL	4	Binary	31 BIT SECONDARY ALLOCATION IN KB (1024). ONLY VALID WHEN DCDUSEFG = ON.
76	DCDNMBLK	4	Binary	31 BIT NUMBER OF KILOBYTES (1024) THAT COULD BE ADDED TO THE USED SPACE IF THE BLOCK SIZE OR CI SIZE WERE OPTIMIZED. ONLY VALID WHEN DCDNMBFG = ON.
* ---------------------------------------------------------------
80	DCDCREDT	4	Character	CREATION DATE (YYYYDDDF)
84	DCDEXPDT	4	Character	EXPIRATION DATE (YYYYDDDF)
88	DCDLSTRF	4	Character	DATE LAST REFERENCED (YYYYDDDF)
92	DCDDSSER	6	Character	DATA SET SERIAL NUMBER
98	DCDVOLSQ	2	Character	VOLUME SEQUENCE NUMBER
100	DCDLBKDT	8	Character	LAST BACKUP TIME & DATE
108	DCDDCLAS	32	Character
108	DCDDCLNG	2	Binary	DATA CLASS NAME LENGTH
110	DCDDATCL	30	Character	DATA CLASS NAME
140	DCDSCLAS	32	Character
140	DCDSCLNG	2	Binary	STORAGE CLASS NAME LENGTH
142	DCDSTGCL	30	Character	STORAGE CLASS NAME
172	DCDMCLAS	32	Character
172	DCDMCLNG	2	Binary	MANAGEMENT CLASS NAME LENGTH
174	DCDMGTCL	30	Character	MANAGEMENT CLASS NAME
204	DCDSTOGP	32	Character
204	DCDSGLNG	2	Binary	STORAGE GROUP NAME LENGTH
206	DCDSTGRP	30	Character	STORAGE GROUP NAME
236	DCDCCSID	2	Character	CODED CHAR SET IDENTIFIER
238	DCDCATF	1	Character	CATALOG FLAGS ! EQU X'F4' RESERVED • DCDEATRC X'03' EATTR IN CATALOG BITS
239	DCDDSCBF	1	Character	VTOC FLAGS ! EQU X'F4' RESERVED • DCDEATRV X'03' EATTR IN VTOC BITS
240	DCDUDSIZ	8	Character	USER DATA SIZE (64 BIT UNSIGNED BINARY NUMBER)
248	DCDCUDSZ	8	Character	COMPRESSED DATA SET SIZE (64 BIT UNSIGNED BINARY NUMBER)
256	DCDEXFLG	2	Character	COMPRESSION FLAGS • DCDBDSZ X'80' INVALID DATA SIZES
258	DCDSCNT	2	Binary	Stripe Count
260	DCDOVERA	4	Binary	OVER ALLOCATED SPACE
264	DCDACCT	32	Character	Account Information
296	DCDFLAG5	1	Character	INFORMATION FLAG # 5 • DCDALLFX X'80' 63BIT ALLOCATED SPACE IN DCDALLSX • DCDUSEFX X'40' 63BIT USED SPACE AVAILABLE IN DCDUSESX • DCDSCAFX X'20' 63BIT SECONDARY SPACE IN DCDSCALX • DCDNMBFX X'10' 63BIT UNUSABLE SPACE IN DCDNMBLX
297		3	Character	INFORMATION FLAG # 6 7 8 RESERVED
300		3	Character	RESERVED
303	DCDDS9F1	1	Character	FORMAT 9 DSCB FLAG1 • DCDDS9CR X'80' FORMAT 9 DSCB BUILT BY CREATE
304	DCDJBNMC	8	Character	Jobname used to create the data set
312	DCDSTNMC	8	Character	Stepname used to create the dataset
320	DCDTIMEC	6	Character	MICROSECONDS SINCE MIDNIGHT, LOCAL TIME, THAT THE DATA SET DESCRIBED BY ITS FORMAT 8 DSCB WAS CREATED, SEE FIELD DCDCREDT FOR THE DATE
326		2	Character	RESERVED
328	DCDALLSX	8	Binary	63 BIT SPACE ALLOCATED TO DATA SET IN KB (1024). ONLY VALID WHEN DCDALLFX = ON
336	DCDUSESX	8	Binary	63 BIT SPACE USED BY DATA SET IN KB (1024). ONLY VALID WHEN DCDUSEFX = ON
344	DCDSCALX	8	Binary	63 BIT SECONDARY ALLOCATION IN KB (1024). ONLY VALID WHEN DCDSCAFX = ON
352	DCDNMBLX	8	Binary	63 BIT NUMBER OF KILOBYTES (1024) THAT COULD BE ADDED TO THE USED SPACE IF THE BLOCK SIZE OR CI SIZE WERE OPTIMIZED. ONLY VALID WHEN DCDNMBFX = ON
360	DCDXPSEV	1	Binary	PS EXTENDED FORMAT VERSION NUMBER. 0 = DS not created in Extended Format (default). 1/2 = DS created in Extended Format version 1 or 2.
361		1	Character	RESERVE
362	DCDAENCR	66	Character	Encryption Type
362	DCDATYPE	2	Character	ENCRYPTION TYPE
364	DCDAKLBL	64	Character	ENCRYPTION KEY LABEL
428		16	Character	RESERVED
444	DCDADSIE	1	Character	END OF DCUDSET
444		16	Character	RESERVED

Sample Space Usage Report
from DCOLLECT Type D Records

The sample DCOLLECT report below was created with Spectrum DCOLLECT Reporter, Pacific Systems Group's low-cost 4GL DCOLLECT report writer.

It reads as input the DCOLLECT file and selects just the type D (Active Data Set) records. (See DCOLLECT type D record layout.)

We select only datasets residing on the volume we are interested in (volume serial VPWRKC). For each active dataset, we compute the percentage of allocated space that is actually used. We only include in our report just thoses datasets whose percent of allocated spaced used is at least 90%.

Our report shows the allocated and used space information, as well as some dataset attributes (LRECL, BLKSIZE and Creation Date). The report is printed in descending order of percentage space used.

All of this with just a few lines of code!
Why not install a Spectrum DCOLLECT Reporter trial right now and start making your own DCOLLECT reports!

These Spectrum DCOLLECT Reporter Statements:

INPUT:  DCOLLECT                                              

COMPUTE: PERCENT_USED(0,DIVTOTS) = (DCDUSESP * 100) / DCDALLSP 

INCLUDEIF: DCURCTYP = 'D'                                      
           AND DCDVOLSR = 'VPWRKC'                             
           AND PERCENT_USED >= 90                              

COLUMNS:                                                       
  DCDDSNAM(30)                                                 
  DCDALLSP('ALLOC|SPACE' 7)                                    
  DCDUSESP('USED|SPACE' 7)                                     
  PERCENT_USED(7 NOACC)                                        
  DCDBKLNG('BLKSIZE' 7 NOACC)                                  
  DCDLRECL('LRECL' 6 NOACC)  
  DCDCREDT('CREATED')     
                                 
SORT:  PERCENT_USED(D)                                
BREAK: DSDVOLSR NOTOTALS                                       

TITLE: 'DATASETS USING 90% OR MORE OF ALLOCATED SPACE'         
TITLE: 'FOR VOLUME: VPWRKC'

Produce This DCOLLECT Report:


                DATASETS USING 90% OR MORE OF ALLOCATED SPACE                 
                                VOLUME: VPWRKC                                

                                ALLOC   USED   PERCENT                        
           DCDDSNAM             SPACE   SPACE   USED   BLKSIZE LRECL  CREATED 
______________________________ _______ _______ _______ _______ ______ ________
                                                                              
SYS1.VTOCIX.VPWRKC                 775     775     100   2,048  2,048 08/14/07
USRACCT.SPLWORK2.COPYLIB           830     830     100  23,440     80 01/08/12
USRACCT.TEMP.VBFILE84.DATA          55      55     100  23,300     84 12/21/14
USRACCT.BNK182.DATA            214,150 213,652     100  27,998 32,767 07/20/09
USRACCT.BNK.ASM                 37,352  36,798      99  23,440     80 02/25/11
USRACCT.BNK100.INTSAVL.DATA     10,791  10,569      98  27,998 32,760 09/15/13
USRACCT.QW200.BK141118          57,217  55,779      97  23,440     80 11/18/14
USRACCT.TEMP.QWROUND.DATA        1,162   1,107      95  23,440     80 12/06/14
USRACCT.TEMP.DYLROUND.DATA       1,162   1,107      95  23,440     80 12/06/14
USRACCT.BNK30.UBS2STEP.DATA     10,791  10,182      94  32,760 32,756 02/13/13
USRACCT.BNK.UBS120.DATA          2,490   2,324      93  32,004 32,000 03/22/11
USRACCT.ST400.ASM               49,802  46,095      93  23,440     80 10/19/12
USRACCT.SPBNKINF.COPYLIB        41,502  37,960      91  23,440     80 08/30/09
                                                                              
*** GRAND TOTAL (    13 ITEMS) 428,079 417,233

See other sample DCOLLECT reports.

Spectrum SMF Writer - the 4GL SMF Report Writer.