VTOC Scan EXTRACT batch job
To perform batch reporting, a VTOC Scan collection data set must be reformatted.
The EXTRACT batch job performs this process. The batch job uses a VTOC Scan collection data set as input, which can be an existing data set or a new one that you create. The output from the EXTRACT batch job is a reformatted data set, which can be input to the VTOC_DSN or VTOC_VOL batch reporting jobs or your own reporting software. The VTOC_DSN and VTOC_VOL jobs are discussed in more detail in Using-MainView-SRM-Reporting.
The VTOC_DSN and VTOC_VOL batch jobs use the EXTRACT-created file to produce its output. The file can that is created from the VTOC Scan can be a user-defined GDG or some other Physical Sequential file.
To create the VTOC Scan EXTRACT batch job
- Determine the VTOC Scan collection data set to use as input to the EXTRACT batch job: either an existing collection data set or a new one.To use a new one, initiate a new VTOC Scan collection (for instructions, see Initiating-a-VTOC-scan).
Modify and submit the VTOC Scan EXTRACT file JCL in ?prefix.BBSAMP(SVWXTJCL).
//* CREATE VTOCSCAN EXTRACT FILE *
//* -------------------------------- *
//* *
//* REPLACE <libhlq> WITH THE HLQ SELECTED FOR THE LIBRARIES *
//* *
//* REPLACE <vscanfile> WITH THE NAME OF EITHER THE VTOC SCAN MASTER *
//* DATA SET OR ANOTHER VTOC SCAN COLLECTION DATA SET. THESE DATA *
//* SETS ARE FILES CREATED FROM A PREVIOUSLY EXECUTED VTOC SCAN. *
//* REFER TO VTOC SCAN PROCESSING IN THE MainView SRM REPORTING *
//* REFERENCE MANUAL FOR MORE INFORMATION ON EXECUTING A VTOC SCAN. *
//* *
//* REPLACE <usergdg> WITH THE NAME OF A GENERATION DATA GROUP *
//* *
//* PLEASE ENSURE THAT THE GENERATION DATA GROUP BASE EXISTS. *
//* *
//* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
//* *
//COSSR400 EXEC PGM=COSSR400,REGION=0M
//STEPLIB DD DISP=SHR,DSN=<libhlq>.BBLINK
//VSCANINP DD DISP=SHR,DSN=<vscanfile>
//VTOCDATA DD DSN=<usergdg>(+1),UNIT=SYSALLDA,
// SPACE=(CYL,(100,50),RLSE),DISP=(,CATLG),
// DCB=(BUFNO=100,BLKSIZE=0)You can now input the extraction data set to the VTOC_DSN or VTOC_VOL reports, or to your own reporting software. The following figure shows sample records in an extraction data set.
VTOC Scan EXTRACT layout
Offsets Length Type Description
------- ------ ----------- ---------------------------------
0 1 CHARACTER RECORD ID 1 = VOL, 2 = DSN
---------------------------------------------------------------
Volume Record
---------------------------------------------------------------
1 6 CHARACTER VOLUME
7 1 CHARACTER Alignment Filler
8 4 FULLWORD DATA SET RECORDS (TOTAL)
12 4 FULLWORD DATA SET RECORDS (NOT COMPLETE)
16 3 CHARACTER MOUNT STATUS
19 2 HEXADECIMAL UCB
21 8 CHARACTER DEVICE TYPE
29 6 CHARACTER EMULATED TYPE
35 4 HEXADECIMAL PERCENTAGE FULL
39 1 CHARACTER Alignment Filler
40 4 FULLWORD LARGEST PRIMARY ALLOCATION (CYL)
44 4 FULLWORD LARGEST PRIMARY ALLOCATION (TRK)
48 4 FULLWORD PERCENTAGE VTOC FULL
52 4 FULLWORD FREE DSCB(S) COUNT
56 4 FULLWORD FREE CYLINDERS COUNT
60 4 FULLWORD FREE TRACKS COUNT
64 4 FULLWORD FREE VIR COUNT
68 4 FULLWORD LARGEST CONTIGUOUS CYLS FREE
72 4 FULLWORD LARGEST CONTIGUOUS TRKS FREE
76 4 FULLWORD VTOC SIZE IN TRACKS
80 4 FULLWORD FRAGMENTATION INDEX
84 30 CHARACTER SMS GROUP
114 3 CHARACTER VTOC INDEX INDICATOR
117 2 CHARACTER SMS INDICATOR
119 1 CHARACTER PAGING DEVICE INDICATOR
120 1 CHARACTER VIO ELIGIBLE INDICATOR
121 1 CHARACTER CACHE WRITE FAST SUPPORT IND
122 1 CHARACTER CACHE SUPPORT IND
123 1 CHARACTER DUAL COPY SUPPORT IND
124 1 CHARACTER DASD WRITE FAST SUPPORT IND
125 1 CHARACTER CACHE WRITE FAST ACTIVE IND
126 1 CHARACTER CACHE ACTIVE ACTIVE IND
127 1 CHARACTER DUAL COPY ACTIVE INDICATOR
128 1 CHARACTER DASD WRITE FAST ACTIVE IND
129 11 CHARACTER PHYSICAL DISK ID
140 4 CHARACTER SUBSYSTEM ID
144 12 CHARACTER Control UNIT SERIAL NUMBER
156 8 CHARACTER Control UNIT TYPE-MODEL
164 3 CHARACTER DEVICE VENDOR
167 10 CHARACTER RAID TYPE
177 1 CHARACTER PAV INDICATOR
Offsets Length Type Description
------- ------ ----------- ---------------------------------
178 2 HEXADECIMAL ALIAS UCB COUNT
180 4 HEXADECIMAL RETURN CODE
184 4 HEXADECIMAL REASON CODE
188 4 HEXADECIMAL SUB-FUNCTION RETURN CODE
192 4 HEXADECIMAL SUB-FUNCTION REASON CODE
196 4 HEXADECIMAL SUB-FUNCTION FEEDBACK
200 20 CHARACTER ERROR MESSAGE
220 4 FULLWORD Volume Size in tracks
224 4 FULLWORD VIR size in tracks
228 4 FULLWORD PERCENTAGE VIR FULL
232 4 FULLWORD VVDS size in tracks
236 4 FULLWORD PERCENTAGE VVDS FULL
240 4 FULLWORD FREE EXTENT COUNT
244 8 CHARACTER Time Volume Scanned
252 10 CHARACTER Date Volume Scanned
262 2 CHARACTER Alignment Filler
264 4 FULLWORD POOL COUNT
268 8 CHARACTER POOL1 NAME
276 1 CHARACTER POOL1 TYPE
277 8 CHARACTER POOL2 NAME
285 1 CHARACTER POOL2 TYPE
286 8 CHARACTER POOL3 NAME
294 1 CHARACTER POOL3 TYPE
295 8 CHARACTER POOL4 NAME
303 1 CHARACTER POOL4 TYPE
304 8 CHARACTER POOL5 NAME
312 1 CHARACTER POOL5 TYPE
313 8 CHARACTER POOL6 NAME
321 1 CHARACTER POOL6 TYPE
322 8 CHARACTER POOL7 NAME
330 1 CHARACTER POOL7 TYPE
331 8 CHARACTER POOL8 NAME
339 1 CHARACTER POOL8 TYPE
---------------------------------------------------------------
Dataset Record
---------------------------------------------------------------
1 44 CHARACTER DATA SET NAME
45 6 CHARACTER VOLUME
51 1 CHARACTER Alignment Filler
52 2 HALFWORD VOLUME SEQUENCE NUMBER
54 1 CHARACTER CATALOGED INDICATOR
55 1 CHARACTER Alignment Filler
56 2 HALFWORD UCB
58 2 CHARACTER Alignment Filler
60 4 FULLWORD RECORD LENGTH
64 4 FULLWORD BLOCK SIZE
68 4 FULLWORD BLOCKING EFFICIENCY
72 4 FULLWORD BLOCKS PER TRACK
Offsets Length Type Description
------- ------ ----------- ---------------------------------
76 4 FULLWORD EXTENTS
80 4 FULLWORD ALLOCATION SIZE (IN K)
84 4 FULLWORD TRACKS ALLOCATED
88 4 FULLWORD TRACKS USED
92 4 FULLWORD TRACKS FREE
96 4 FULLWORD ALLOCATION PERCENTAGE USED
100 4 FULLWORD CA SPLITS
104 4 FULLWORD CI SPLITS
108 4 FULLWORD DAYS SINCE REFERENCED
112 10 CHARACTER LAST REFERENCE DATE
122 10 CHARACTER CREATION DATE
132 10 CHARACTER EXPIRATION DATE
142 5 CHARACTER RECORD FORMAT
147 4 CHARACTER DATA SET ORGANIZATION
151 1 CHARACTER CHANGED INDICATOR
152 1 CHARACTER REBLOCKABLE INDICATOR
153 2 CHARACTER SMS INDICATOR
155 8 CHARACTER SMS STORAGE CLASS
163 8 CHARACTER SMS DATA CLASS
171 8 CHARACTER SMS MANAGEMENT CLASS
179 16 CHARACTER SG-CNTL ACCOUNT LEVEL 1
195 16 CHARACTER SG-CNTL ACCOUNT LEVEL 2
211 16 CHARACTER SG-CNTL ACCOUNT LEVEL 3
227 16 CHARACTER SG-CNTL ACCOUNT LEVEL 4
243 1 CHARACTER Alignment Filler
244 4 FULLWORD RETURN CODE
248 4 FULLWORD REASON CODE
252 4 FULLWORD SUB-FUNCTION RETURN CODE
256 4 FULLWORD SUB-FUNCTION REASON CODE
260 4 FULLWORD SUB-FUNCTION FEEDBACK
264 20 CHARACTER ERROR MESSAGE
284 30 CHARACTER SMS Storage Group
314 2 CHARACTER Alignment Filler
316 4 FULLWORD Device Occupancy Percentage Used
320 8 CHARACTER Pool Name
328 1 CHARACTER Pool Type
329 8 CHARACTER DSN HLQ
337 1 CHARACTER Alignment Filler
338 2 HALFWORD Days Range 0 thru 10
340 4 FULLWORD Days Range specified in PARMLIB
344 4 FULLWORD Size Range specified in PARMLIB
348 2 HALFWORD Size Range 0 thru 10
350 2 HALFWORD Percent Used Range 0 thru 10
352 4 FULLWORD % Used Range specified in PARMLIB
356 144 CHARACTER Reserved for future growth
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*