








	*DCOLLECT Tools*

DCOLLECT Type V Record

This table shows the record layout for type V DCOLLECT records
(Volume Information).

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 V records contain volume information. One of these records is created for each volume scanned. These records are collected when the VOLUME, or STORAGEGROUP, or both parameters are selected, and the NOVOLUMEINFO parameter is not specified. The record type for this record is V.

It's easy to report on DCOLLECT type V 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 V Record -- Volume Information
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
* ******************************************************************** * * VOLUME INFORMATION (RECORD TYPE 'V') * * * Contains volume information. * * * One of these records is created for each volume scanned (as long * * * as the NODATAINFO parameter is not specified.) * * ********************************************************************
0	DCVVOLSR	6	Character	VOLUME SERIAL NUMBER
6	DCVFLAG1	1	Character	INFORMATION FLAG #1 • DCVINXST X'C0' INDEX STATUS • DCVINXEX X'80' INDEXED VTOC EXISTS • DCVINXEN X'40' INDEXED VTOC IS ENABLED • DCVUSATR X'38' USE ATTRIBUTE • DCVUSPVT X'20' PRIVATE • DCVUSPUB X'10' PUBLIC • DCVUSSTO X'08' STORAGE • DCVSHRDS X'04' DEVICE IS SHAREABLE • DCVPHYST X'03' PHYSICAL STATUS
7	DCVERROR	1	Character	ERROR INFORMATION FLAG • DCVEVLCP X'80' ERROR CALCULATING VOL CAPACITY • DCVEBYTK X'40' ERROR CALCULATING BYTES/TRK • DCVELSPC X'20' ERROR DURING LSPACE PROCESSING
8		3	Character	RESERVED
11	DCVPERCT	1	Binary	PERCENT FREESPACE ON VOLUME
12	DCVFRESP	4	Binary	FREESPACE ON VOLUME (IN KB)
16	DCVALLOC	4	Binary	ALLOCATED SPACE ON VOL (IN KB)
20	DCVVLCAP	4	Binary	TOTAL CAPACITY OF VOL (IN KB)
24	DCVFRAGI	4	Binary	FRAGMENTATION INDEX
28	DCVLGEXT	4	Binary	LARGEST FREE EXTENT ON VOLUME
32	DCVFREXT	4	Binary	NUMBER OF FREE EXTENTS
36	DCVFDSCB	4	Binary	FREE DSCBS IN VTOC
40	DCVFVIRS	4	Binary	FREE VIRS
44	DCVDVTYP	8	Character	DEVICE TYPE
52	DCVDVNUM	2	Binary	DEVICE NUMBER
54		2	Character	RESERVED
56	DCVSTGGP	32	Character
56	DCVSGLNG	2	Binary	STORAGE GROUP NAME LENGTH
58	DCVSGTCL	30	Character	STORAGE GROUP NAME
88	DCVDPTYP	8	Character	PHYSICAL DEVICE TYPE
96	DCVTRPCT	1	Binary	PERCENT FREESP ON TRK MANAGED PART EAV
97	DCVEAVOL	1	Character	EAV INDICATOR FLAG • DCVCYLMG X'80' VOLUME CONTAINS GT 65,520 CYL
97		2	Character	RESERVED
100	DCVTRFSP	4	Binary	FREE SPACE IN MEGABYTES OF TRK MGD EAV
104	DCVTRALC	4	Binary	ALLOCATED SPACE IN MB OF TRK MGD EAV
108	DCVTRVLC	4	Binary	TOTAL CAPACITY OF TRK MGD PART OF EAV
112	DCVTRFRG	4	Binary	FRAG INDEX FOR TRK MGD PART OF EAV
116	DCVTRLGE	4	Binary	LARGEST EXT FOR TRK MGD PART OF EAV
120	DCVTRFRX	4	Binary	NO OF FREE EXTENTS FOR TRK MGD PART EAV
124	DCVFCYLS	4	Binary	FREE CYLINDERS ON VOLUME
128	DCVFTRKS	4	Binary	FREE TRACKS ON VOLUME
132		4	Character	RESERVED

Sample Disk Volume Statistics Report
from DCOLLECT Type V 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 V (Disk Volume Information) records. (See DCOLLECT type V record layout.)

Our report shows the volume's total capacity, free capacity and percent of free capacity. It also shows the fradementation index. We examine the "public" and "private" bit flags in the record; we use them to set a user-friendly type field to show in the report.

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: TYPE = WHEN(DCVUSPVT) ASSIGN('PRIVATE')             
                WHEN(DCVUSPUB) ASSIGN('PUBLIC')              

INCLUDEIF: DCURCTYP = 'V'                                    

COLUMNS:                                                     
  DCVVOLSR('VOLUME')                                         
  TYPE                                                       
  DCVFRESP('FREE|SPACE|KB' 10)                               
  DCVVLCAP('VOLUME|CAPACITY|KB' 10)                          
  DCVPERCT('PERCENT|FREE|SPACE' 7)                           
  DCVFRAGI('FRAGMENTATION|INDEX')                            

SORT:  DCVVOLSR                                              

TITLE: 'VOLUME STATISTICS'

Produce This DCOLLECT Report:


                    VOLUME STATISTICS                      

                  FREE      VOLUME   PERCENT                
                 SPACE     CAPACITY    FREE  FRAGMENTATION  
VOLUME  TYPE       KB         KB      SPACE      INDEX      
______ _______ __________ __________ _______ ______________ 
                                                           
VPWRKA PRIVATE  1,476,528  2,490,117      59              4    
VPWRKB PRIVATE  1,519,137  2,490,117      61              4    
VPWRKC PRIVATE    853,003  2,490,117      34             42    
VPWRKD PRIVATE  2,342,314  2,490,117      94              0    
                                                               
*** GRAND TOTAL (     4 ITEMS)                                 
                6,190,982  9,960,468     248             50

See other sample DCOLLECT reports.

Spectrum SMF Writer - the 4GL SMF Report Writer.