Go to Home Page
Questions?
Call 1-800-572-5517
 
  Go to Home Page  
  See all products
  See price schedules
  See manuals, tutorials, articles
  Download a free 30-day trial
  See user testimonials
  About Pacific Systems Group
 
 
DCOLLECT Tools
  See DCOLLECT Record Layouts
  See Sample DCOLLECT Reports
  Learn How to Export SMF Data
  Download Free DCOLLECT  Reporting Software (30 days)
 
  Choose Spectrum Writer to add 4GL to your product
  Free 60-Page Book (PDF) - How to Make an SMF Report
Spectrum DCOLLECT Reporter - the 4GL DCOLLECT Report Writer.

Spectrum SMF Writer - the 4GL SMF Report Writer.

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)

DCOLLECT Spectrum WRITER
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.
 
Try It FREE Now!

DCOLLECT Type D Record -- Active Data Set Record
Offset
(Dec.)
NameLengthFormatDescription
* ********************************************************************
* * HEADER PORTION OF DATA COLLECTION UTILITY OUTPUT RECORD. EACH *
* * DATA SECTION IS PRECEDED BY THIS HEADER. *
* ********************************************************************
0DCURDW4BinaryRECORD DESCRIPTOR WORD
0DCULENG2BinaryLENGTH OF THIS RECORD
22CharacterRESERVED
4DCURCTYP2CharacterRECORD TYPE FOR THIS RECORD
6DCUVERS2BinaryVERSION
8DCUSYSID4CharacterSYSTEM ID FOR THIS OPERATION
12DCUTMSTP8CharacterTIMESTAMP FIELD
12DCUTIME4BinaryTIME IN SMF HEADER FORMAT
16DCUDATE4CharacterDATE IN SMF FORMAT (CCYYDDDF)
204CharacterRESERVED
24DCUDATA1CharacterEND 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.) *
* ********************************************************************
0DCDADSI1Character
0DCDDSNAM44CharacterDATA SET NAME
44DCDERROR1CharacterERROR 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
45DCDFLAG11CharacterINFORMATION 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
46DCDFLAG21CharacterINFORMATION 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
47DCDFLAG31CharacterINFORMATION 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
482Characterreserved
50DCDDSORG2CharacterDATA SET ORGANIZATION
50DCDDSOR01CharacterDATA 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
51DCDDSOR11CharacterDATA SET ORGANIZATION BYTE 1
• DCDDSGGS X'80' GS GRAPHICS ORGANIZATION
• DCDDSGVS X'08' VS VSAM DATA SET
52DCDRECRD1CharacterRECORD 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
53DCDNMEXT1BinaryNUMBER OF EXTENTS USED
54DCDVOLSR6CharacterVOLUME SERIAL NUMBER
60DCDBKLNG2BinaryBLOCK LENGTH
62DCDLRECL2BinaryRECORD 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
*
64DCDALLSP4Binary31 BIT SPACE ALLOCATED TO DATA SET IN KB (1024). ONLY VALID WHEN DCDUSEFG = ON.
68DCDUSESP4Binary31 BIT SPACE USED BY DATA SET IN KB (1024). ONLY VALID WHEN DCDUSEFG = ON.
72DCDSCALL4Binary31 BIT SECONDARY ALLOCATION IN KB (1024). ONLY VALID WHEN DCDUSEFG = ON.
76DCDNMBLK4Binary31 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.

* ---------------------------------------------------------------
80DCDCREDT4CharacterCREATION DATE (YYYYDDDF)
84DCDEXPDT4CharacterEXPIRATION DATE (YYYYDDDF)
88DCDLSTRF4CharacterDATE LAST REFERENCED (YYYYDDDF)
92DCDDSSER6CharacterDATA SET SERIAL NUMBER
98DCDVOLSQ2CharacterVOLUME SEQUENCE NUMBER
100DCDLBKDT8CharacterLAST BACKUP TIME & DATE
108DCDDCLAS32Character
108DCDDCLNG2BinaryDATA CLASS NAME LENGTH
110DCDDATCL30CharacterDATA CLASS NAME
140DCDSCLAS32Character
140DCDSCLNG2BinarySTORAGE CLASS NAME LENGTH
142DCDSTGCL30CharacterSTORAGE CLASS NAME
172DCDMCLAS32Character
172DCDMCLNG2BinaryMANAGEMENT CLASS NAME LENGTH
174DCDMGTCL30CharacterMANAGEMENT CLASS NAME
204DCDSTOGP32Character
204DCDSGLNG2BinarySTORAGE GROUP NAME LENGTH
206DCDSTGRP30CharacterSTORAGE GROUP NAME
236DCDCCSID2CharacterCODED CHAR SET IDENTIFIER
238DCDCATF1CharacterCATALOG FLAGS ! EQU X'F4' RESERVED
• DCDEATRC X'03' EATTR IN CATALOG BITS
239DCDDSCBF1CharacterVTOC FLAGS ! EQU X'F4' RESERVED
• DCDEATRV X'03' EATTR IN VTOC BITS
240DCDUDSIZ8CharacterUSER DATA SIZE (64 BIT UNSIGNED BINARY NUMBER)
248DCDCUDSZ8CharacterCOMPRESSED DATA SET SIZE (64 BIT UNSIGNED BINARY NUMBER)
256DCDEXFLG2CharacterCOMPRESSION FLAGS
• DCDBDSZ X'80' INVALID DATA SIZES
258DCDSCNT2BinaryStripe Count
260DCDOVERA4BinaryOVER ALLOCATED SPACE
264DCDACCT32CharacterAccount Information
296DCDFLAG51CharacterINFORMATION 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
2973CharacterINFORMATION FLAG # 6 7 8 RESERVED
3003CharacterRESERVED
303DCDDS9F11CharacterFORMAT 9 DSCB FLAG1
• DCDDS9CR X'80' FORMAT 9 DSCB BUILT BY CREATE
304DCDJBNMC8CharacterJobname used to create the data set
312DCDSTNMC8CharacterStepname used to create the dataset
320DCDTIMEC6CharacterMICROSECONDS SINCE MIDNIGHT, LOCAL TIME, THAT THE DATA SET DESCRIBED BY ITS FORMAT 8 DSCB WAS CREATED, SEE FIELD DCDCREDT FOR THE DATE
3262CharacterRESERVED
328DCDALLSX8Binary63 BIT SPACE ALLOCATED TO DATA SET IN KB (1024). ONLY VALID WHEN DCDALLFX = ON
336DCDUSESX8Binary63 BIT SPACE USED BY DATA SET IN KB (1024). ONLY VALID WHEN DCDUSEFX = ON
344DCDSCALX8Binary63 BIT SECONDARY ALLOCATION IN KB (1024). ONLY VALID WHEN DCDSCAFX = ON
352DCDNMBLX8Binary63 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
360DCDXPSEV1BinaryPS EXTENDED FORMAT VERSION NUMBER. 0 = DS not created in Extended Format (default). 1/2 = DS created in Extended Format version 1 or 2.
3611CharacterRESERVE
362DCDAENCR66CharacterEncryption Type
362DCDATYPE2CharacterENCRYPTION TYPE
364DCDAKLBL64CharacterENCRYPTION KEY LABEL
42816CharacterRESERVED
444DCDADSIE1CharacterEND OF DCUDSET
44416CharacterRESERVED

 

 
 


 
 

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.

Copyright 2018.
Pacific Systems Group.
All rights reserved.


Spectrum Writer 4GL - the economical alternative to SAS, Easytrieve, DYL-280...

Home | Products | Prices | Documentation | 30-Day Trials | Customer Reviews | Company
Send Your Comments or Questions