z/OS DFSMSrmm Reporting
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Extract data set volume record: EDGRVEXT

z/OS DFSMSrmm Reporting
SC23-6875-00

EDGRVEXT maps the volume record in the DFSMSrmm extract data set. See Using the security report for more information about the DFSMSrmm extract data set.

    Common Name:          RMM Extract File Volume Record
    Macro ID:             EDGRVEXT
    DSECT Name:           RVEXT
    Owning Component:     DFSMSrmm (DF186)
    Eye-Catcher ID:       V
    Storage Attributes:   Subpool: N/A
                          Key: N/A
                          Residency: N/A
    Size:                 See STRUCTURE length
    Created by:           EDGHSKP
    Pointed to by:        Assembler - USING on RVEXT
                          PL/X - %INCLUDE EDGRVEXT
    Serialization:        None
    Function:             Maps the RVEXT structure to identify
                          the details within the RMM extract file
                          volume record.
    In this record the date format depends on the DATEFORM selected
    by EDGHSKP execution parameter or the parmlib specified value.
                          -
    Section RVEXT1 contains the data elements which are copied to
                   section XVEXT1 of the extented (X) record as
                   one block.
    Section RVEXT2 contains the data elements which are copied to
                   section XXMERGED of the extented (X) record on
                   field level.
Table 1. Structure RVEXT
Offset Offset
Dec Hex Type Len Name(Dim) Description
0 (0) STRUCTURE 1105 RVEXT
0 (0) CHARACTER 796  RVEXT1 First data section
0 (0) CHARACTER 1   RVTYPE Record type: C'V'
4 (4) CHARACTER 6   RVVOLSER Volume serial number
10 (A) CHARACTER 6   RVPVOL Previous volume in sequence
16 (10) CHARACTER 6   RVNVOL Next volume in sequence
22 (16) CHARACTER 6   RVSTVOL Stacked volume serial number
  RVMDMVID: Is a unique token assigned to every volume and every
            data set in a multi volume set.
28 (1C) CHARACTER 8   RVMDMVID Multi data set multi volume ID
  Start of common fields:
  The common fields are in the same place in each record type
  in the report extract file. This allows common processing of
  these fields across multiple record types.
48 (30) CHARACTER 10   RVCRDATE Create date of volume record
58 (3A) CHARACTER 6   RVCRTIME Create time (HHMMSS) of volume record
64 (40) CHARACTER 8   RVCRSID Create system ID of volume record
72 (48) CHARACTER 10   RVLCDATE Last change date of volume record
82 (52) CHARACTER 6   RVLCTIME Last change time (HHMMSS) of volume record
88 (58) CHARACTER 8   RVLCUID Last change user ID of volume record
96 (60) CHARACTER 8   RVLCSID Last change system ID of volume record
104 (68) CHARACTER 10   RVEXPDTO Expiration date - original
114 (72) CHARACTER 10   RVEXPDT Expiration date - current
124 (7C) CHARACTER 4   RVDEN Recording density
128 (80) CHARACTER 1   RVCOMP Compaction used: Y, N
129 (81) CHARACTER 4   RVDSNNO_OLD Number of data sets on volume <=9999
133 (85) CHARACTER 10   RVTUSE Tape usage in kilobytes
143 (8F) CHARACTER 4   RVUSE_OLD Volume use count <=9999, a -1 value indicates to use RVAPPUSE
147 (93) CHARACTER 4   RVLABNO1_OLD Label number of first file <=9999
151 (97) CHARACTER 8   RVSTORID Current location name, one of: SHELF, LOCAL, REMOTE, DISTANT, installation-defined store, SMS-defined library name
159 (9F) CHARACTER 8   RVDEST Destination name, one of: SHELF, LOCAL, REMOTE, DISTANT, installation-defined store, SMS-defined library name
  Bin Numbers: If a volume is not moving (RVTRANS=N), and is in a
               storage location, RVSTBIN contains the current bin
               number and RVOBIN the bin number in the previous
               location.
               If a volume is moving (RVTRANS=Y), and moving to a
               storage location, RVSTBIN contains the target bin
               number and RVOBIN the bin number in the source
               location.
167 (A7) CHARACTER 6   RVSTBIN Store bin number
173 (AD) CHARACTER 6   RVOBIN Old bin number
179 (B3) CHARACTER 10   RVSTDATE Date stored
189 (BD) CHARACTER 10   RVRETDAT Retention date calculated by VRS processing
199 (C7) CHARACTER 8   RVLONLOC Loan location
207 (CF) CHARACTER 8   RVOLNLOC Previous loan location
215 (D7) CHARACTER 10   RVLRDDAT Date volume last read
225 (E1) CHARACTER 10   RVLWTDAT Date volume last written
  Assigned date and time:
     These fields are set each time a volume changes either from
     or to scratch status.
235 (EB) CHARACTER 10   RVASDATE Assigned date
245 (F5) CHARACTER 6   RVASTIME Assigned time (HHMMSS)
251 (FB) CHARACTER 8   RVOWNID Volume owner user ID
259 (103) CHARACTER 8   RVCRUID Creating user ID
267 (10B) CHARACTER 8   RVCRJOB Creating job name
275 (113) CHARACTER 8   RVSECLEV Security level - short
283 (11B) CHARACTER 30   RVSECLNG Security level - long
313 (139) CHARACTER 4   RVVOLSEQ Volume sequence number
317 (13D) CHARACTER 8   RVSTATUS Volume status, one of: MASTER, USER, SCRATCH, INIT, ENTRY
325 (145) CHARACTER 1   RVPENDRS Volume pending release: Y, N
326 (146) CHARACTER 1   RVVRS Volume retained by VRS: Y, N
327 (147) CHARACTER 1   RVLOAN Volume on load: Y, N
328 (148) CHARACTER 1   RVOPEN Volume is opened: Y, N
329 (149) CHARACTER 1   RVOCER Volume recorded by O/C/EOV: Y,
330 (14A) CHARACTER 1   RVDEFRET Parmlib default retention used to generate the volume expiration date: Y, N
331 (14B) CHARACTER 1   RVPPTAPE Program product tape: Y, N
  Labels: The RVLABEL field provides information about what label
          types may be written on the volume. If BLP output has
          been used, the volume may no longer match this
          information. Any BLP output beyond the first file on a
          volume is not recorded by RMM.
332 (14C) CHARACTER 3   RVLABEL Label type: SL, AL, NL, SUL, AUL
335 (14F) CHARACTER 1   RVBLP Volume last written BLP: Y, N
  Release Actions: The following 5 fields list the actions to be
               set for the volume when it is released. These are
               not the current actions. See RVACTION for the
               pending actions.
336 (150) CHARACTER 8   RVRETS Return action: OWNER, SCRATCH
344 (158) CHARACTER 1   RVREPL Replace on release: Y, N
345 (159) CHARACTER 1   RVINIT Reinitialize: Y, N
346 (15A) CHARACTER 1   RVERASE Security erase: Y, N
347 (15B) CHARACTER 1   RVNTFY Notify owner: Y, N
348 (15C) CHARACTER 1   RVOWNAC Owner access: R, U, A
349 (15D) CHARACTER 1   RVUSERAC User access: R, U
350 (15E) CHARACTER 1   RVVMUSE VM use: Y, N
351 (15F) CHARACTER 1   RVMVSUSE MVS use: Y, N
352 (160) CHARACTER 8   RVNAME Media name
352 (160) CHARACTER 8    RVUNIT Old name for RVNAME field
360 (168) CHARACTER 6   RVRACK Rack number
366 (16E) CHARACTER 4   RVTRERR_OLD Temporary read errors <=9999
370 (172) CHARACTER 4   RVTWERR_OLD Temporary write errors <=9999
374 (176) CHARACTER 4   RVPRERR_OLD Permanent read errors <=9999
378 (17A) CHARACTER 4   RVPWERR_OLD Permanent write errors <=9999
  Product Information: Includes number, release and feature code
382 (17E) CHARACTER 8   RVPPNUM Program product number
390 (186) CHARACTER 6   RVVER Version / release / modification level
396 (18C) CHARACTER 4   RVFEAT Feature code
400 (190) CHARACTER 40   RVACCINF Accounting information
440 (1B8) CHARACTER 30   RVUSEFLD User description
470 (1D6) CHARACTER 3   RVACCLST Number of access list entries
473 (1D9) CHARACTER 96   RVAUTIDS Authorized user IDs area
569 (239) CHARACTER 8   RVHLOC Home location name
577 (241) CHARACTER 1   RVTRANS Volume in transit: Y, N
578 (242) CHARACTER 1   RVLOCTYP Location type, one of: A-auto, M-manual, S-store, blank
579 (243) CHARACTER 1   RVDESTYP Destination type, one of: A-auto, M-manual, S-store, blank
580 (244) CHARACTER 8   RVOLOC Previous location name
588 (24C) CHARACTER 8   RVSGNAME Storage group name
596 (254) CHARACTER 8   RVMEDREC Volume recording format, one of: *, 18TRACK, 36TRACK, 128TRACK, 256TRACK, 384TRACK, EFMT1, EFMT2, EEFMT2, EFMT3, EEFMT3, EFMT4, OR EEFMT4
604 (25C) CHARACTER 8   RVMEDTY Volume media type, one of: *, CST, ECCST, HPCT, EHPCT, MEDIA5 - ETC, MEDIA6 - EWTC, MEDIA7 - EETC, MEDIA8 - EEWTC, MEDIA9 - EXTC, MEDIA10 - EXWTC MEDIA13 - EAETC
612 (264) CHARACTER 8   RVMEDCMP Compaction technique, one of: *, NONE, YES
620 (26C) CHARACTER 8   RVMEDATR Special attributes: NONE, RDCOMPAT
628 (274) CHARACTER 44   RVDSNAM1 First file data set name
672 (2A0) CHARACTER 1   RVMVMODE Move mode: A-automove, M-manualmove
673 (2A1) CHARACTER 1   RVDSNREC Data set recording: Y, N
674 (2A2) CHARACTER 2   RVALVERS ANSI label versions
674 (2A2) CHARACTER 1    RVALCUR Current label version
675 (2A3) CHARACTER 1    RVALREQ Required label version
676 (2A4) CHARACTER 8   RVBMEDN Bin media name
684 (2AC) CHARACTER 8   RVOBMEDN Old bin media name
692 (2B4) CHARACTER 8   RVNLOC Next location name
700 (2BC) CHARACTER 4   RVLUDEV Last used drive
  Pending Actions: The following fields list the actions required
               for the volume. See RVRETS for the actions set
               when the volume is released.
704 (2C0) CHARACTER 8   RVACTION Pending actions:
704 (2C0) CHARACTER 1    RVACTSCR Return to scratch: Y, N
705 (2C1) CHARACTER 1    RVACTREP Replace volume: Y, N
706 (2C2) CHARACTER 1    RVACTRET Return to owner: Y, N
707 (2C3) CHARACTER 1    RVACTINI Initialize: Y, N
708 (2C4) CHARACTER 1    RVACTERA Erase: Y, N
709 (2C5) CHARACTER 1    RVACTNOT Notify: Y, N
710 (2C6) CHARACTER 2    RVACTRSV Reserved
712 (2C8) CHARACTER 1   RVABEND Data set closed by ABEND: Y, N
713 (2C9) CHARACTER 1   RVHOMTYP Home location type, one of: A-AUTO, M-MANUAL, blank
714 (2CA) CHARACTER 1   RVNEXTYP Next location type, one of: A-AUTO, M-MANUAL, S-STORE, blank
715 (2CB) CHARACTER 1   RVVOLTYPE Volume type
716 (2CC) CHARACTER 8   RVVRSREL VRS release options:
716 (2CC) CHARACTER 1    RVRELIXD Ignore expiration date: Y, N
717 (2CD) CHARACTER 1    RVRELSI Scratch immediate Y, N
718 (2CE) CHARACTER 6    RVRELRSV Reserved
724 (2D4) CHARACTER 16   RVCONTNR In container name
724 (2D4) CHARACTER 6    RVCONTNR_STV Stacked volume container
740 (2E4) CHARACTER 4   RVRQPRTY Movement priority
744 (2E8) CHARACTER 10   RVCAPACITY Volume capacity in megabytes RVCAPACITY is factored
754 (2F2) CHARACTER 1   RVRBYSET Volume is retained by set: Y, N
755 (2F3) CHARACTER 1   RVSTACKVOL_ENABLED Stacked volume records enabled and synchronized
756 (2F4) CHARACTER 8   RVEXPTOKEN Export token, unique value created at start of export to a new stacked volume
764 (2FC) CHARACTER 10   RVSTACKED_VOLCOUNT Count of volumes stacked on a volume
774 (306) CHARACTER 3   RVPERCENT Volume percentage full
777 (309) CHARACTER 5   RVDSNNO Number of data sets on volume
782 (30E) CHARACTER 5   RVLABNO1 Label number of first file
787 (313) CHARACTER 8   RVDCRSID First file creation system ID
796 (31C) CHARACTER 309  RVEXT2 Second data section
796 (31C) CHARACTER 6   RVDESTBIN Destination bin number
802 (322) CHARACTER 8   RVDESTBINMEDIA Destination bin media number
810 (32A) CHARACTER 6   RVVOL1 VOL1 label volser
816 (330) CHARACTER 8   RVVENDOR Vendor information
824 (338) CHARACTER 24   RVWWID Unique world wide ID
848 (350) CHARACTER 5   RVVWMC Write mount count
853 (355) CHARACTER 5   RVTRERR Temporary read errors
858 (35A) CHARACTER 5   RVTWERR Temporary write errors
863 (35F) CHARACTER 5   RVPRERR Permanent read errors
868 (364) CHARACTER 5   RVPWERR Permanent write errors
   RvKeyLabel1/RvKeyLabel2:
                These fields may contain unprintable characters.
873 (369) CHARACTER 64   RVKEYLABEL1 Encryption key label 1
937 (3A9) CHARACTER 5   RVKEYENCOD1 Encryption encoding method 1
942 (3AE) CHARACTER 64   RVKEYLABEL2 Encryption key label 2
1006 (3EE) CHARACTER 5   RVKEYENCOD2 Encryption encoding method 2
1011 (3F3) CHARACTER 8   RVMEDINF Media information
1019 (3FB) CHARACTER 1   RVIRMMUSE IRMM use: Y, N
1020 (3FC) CHARACTER 1   RVWORM WORM: Y, N
1021 (3FD) CHARACTER 2   RVFACTOR Space/size factor, applies to RVCAPACITY, RVAPPUSE, RVPhys_Used
1023 (3FF) CHARACTER 10   RVAPPUSE Data written, RVAPPUSE is factored
1033 (409) CHARACTER 5   RVUSE Volume use count
1038 (40E) CHARACTER 1   RVHOLD Volume hold: Y, N
1039 (40F) CHARACTER 10   RVESB Expdt set by
1049 (419) CHARACTER 10   RVUCDATE Last "user" change date
1059 (423) CHARACTER 6   RVUCTIME Last "user" change time (HHMMSS)
1065 (429) CHARACTER 5   RVRETMET Retention Method
1070 (42E) CHARACTER 10   RVRMSB Retention Method Set By
1080 (438) CHARACTER 6   RVCOMP_RAT Compression ratio for the volume in hundredths. Always showing 2 decimal places.
1086 (43E) CHARACTER 10   RVPHYS_USED Actual space used by all files after compaction ( FACTORED )
1096 (448) CHARACTER 9   RVEXRB EXPDT RetainBy
1105 (451) CHARACTER 0  RVRCEND End of RVEXT
Table 2. Constants for RVEXT
Len Type        Value Name Description
     Contants
1 CHARACTER L RVVOLTYPE_LOGICAL
1 CHARACTER P RVVOLTYPE_PHYSICAL
1 CHARACTER S RVVOLTYPE_STACKED
2 CHARACTER MB RVFACTOR_MB
2 CHARACTER GB RVFACTOR_GB
2 CHARACTER TB RVFACTOR_TB
10 CHARACTER RVESB_UNDEFINED
10 CHARACTER CMD RVESB_CMD
10 CHARACTER CMD_DEF RVESB_CMD_DEF
10 CHARACTER CMD_VOLCAT RVESB_CMD_VOLCAT
10 CHARACTER OCE_JFCB RVESB_OCE_JFCB
10 CHARACTER OCE_EXIT RVESB_OCE_EXIT
10 CHARACTER OCE_DEF RVESB_OCE_DEF
10 CHARACTER OCE_MAX RVESB_OCE_MAX
10 CHARACTER OCE_VOLCAT RVESB_OCE_VOLCAT
10 CHARACTER LCS RVESB_LCS
10 CHARACTER LCS_DEF RVESB_LCS_DEF
10 CHARACTER TVEXTPURGE RVESB_TVEXTPURGE
10 CHARACTER CNVT RVESB_CNVT
10 CHARACTER EXPORT RVESB_EXPORT
10 CHARACTER LASTREF RVESB_LASTREF
10 CHARACTER OCE_MC RVESB_OCE_MC
5 CHARACTER VRSEL RVRETMET_VRSEL
5 CHARACTER EXPDT RVRETMET_EXPDT
10 CHARACTER UNDEFINED RVRMSB_UNDEFINED
10 CHARACTER CMD RVRMSB_CMD
10 CHARACTER CMD_DEF RVRMSB_CMD_DEF
10 CHARACTER OCE_DEF RVRMSB_OCE_DEF
10 CHARACTER OCE_EXIT RVRMSB_OCE_EXIT
10 CHARACTER LCS_DEF RVRMSB_LCS_DEF
10 CHARACTER CNVT RVRMSB_CNVT
10 CHARACTER EXPORT_DEF RVRMSB_EXPORT_DEF
10 CHARACTER INERS_DEF RVRMSB_INERS_DEF
9 CHARACTER VOLUME RVEXRB_VOLUME
9 CHARACTER FIRSTFILE RVEXRB_FIRSTFILE
9 CHARACTER SET RVEXRB_SET
Table 3. Cross reference for RVEXT
Name Offset Hex Tag Level
RVABEND 2C8 3
RVACCINF 190 3
RVACCLST 1D6 3
RVACTERA 2C4 4
RVACTINI 2C3 4
RVACTION 2C0 3
RVACTNOT 2C5 4
RVACTREP 2C1 4
RVACTRET 2C2 4
RVACTRSV 2C6 4
RVACTSCR 2C0 4
RVALCUR 2A2 4
RVALREQ 2A3 4
RVALVERS 2A2 3
RVAPPUSE 3FF 3
RVASDATE EB 3
RVASTIME F5 3
RVAUTIDS 1D9 3
RVBLP 14F 3
RVBMEDN 2A4 3
RVCAPACITY 2E8 3
RVCOMP 80 3
RVCOMP_RAT 438 3
RVCONTNR 2D4 3
RVCONTNR_STV 2D4 4
RVCRDATE 30 3
RVCRJOB 10B 3
RVCRSID 40 3
RVCRTIME 3A 3
RVCRUID 103 3
RVDCRSID 313 3
RVDEFRET 14A 3
RVDEN 7C 3
RVDEST 9F 3
RVDESTBIN 31C 3
RVDESTBINMEDIA 322 3
RVDESTYP 243 3
RVDSNAM1 274 3
RVDSNNO 309 3
RVDSNNO_OLD 81 3
RVDSNREC 2A1 3
RVERASE 15A 3
RVESB 40F 3
RVEXPDT 72 3
RVEXPDTO 68 3
RVEXPTOKEN 2F4 3
RVEXRB 448 3
RVEXT 0 1
RVEXT1 0 2
RVEXT2 31C 2
RVFACTOR 3FD 3
RVFEAT 18C 3
RVHLOC 239 3
RVHOLD 40E 3
RVHOMTYP 2C9 3
RVINIT 159 3
RVIRMMUSE 3FB 3
RVKEYENCOD1 3A9 3
RVKEYENCOD2 3EE 3
RVKEYLABEL1 369 3
RVKEYLABEL2 3AE 3
RVLABEL 14C 3
RVLABNO1 30E 3
RVLABNO1_OLD 93 3
RVLCDATE 48 3
RVLCSID 60 3
RVLCTIME 52 3
RVLCUID 58 3
RVLOAN 147 3
RVLOCTYP 242 3
RVLONLOC C7 3
RVLRDDAT D7 3
RVLUDEV 2BC 3
RVLWTDAT E1 3
RVMDMVID 1C 3
RVMEDATR 26C 3
RVMEDCMP 264 3
RVMEDINF 3F3 3
RVMEDREC 254 3
RVMEDTY 25C 3
RVMVMODE 2A0 3
RVMVSUSE 15F 3
RVNAME 160 3
RVNEXTYP 2CA 3
RVNLOC 2B4 3
RVNTFY 15B 3
RVNVOL 10 3
RVOBIN AD 3
RVOBMEDN 2AC 3
RVOCER 149 3
RVOLNLOC CF 3
RVOLOC 244 3
RVOPEN 148 3
RVOWNAC 15C 3
RVOWNID FB 3
RVPENDRS 145 3
RVPERCENT 306 3
RVPHYS_USED 43E 3
RVPPNUM 17E 3
RVPPTAPE 14B 3
RVPRERR 35F 3
RVPRERR_OLD 176 3
RVPVOL A 3
RVPWERR 364 3
RVPWERR_OLD 17A 3
RVRACK 168 3
RVRBYSET 2F2 3
RVRCEND 451 2
RVRELIXD 2CC 4
RVRELRSV 2CE 4
RVRELSI 2CD 4
RVREPL 158 3
RVRETDAT BD 3
RVRETMET 429 3
RVRETS 150 3
RVRMSB 42E 3
RVRQPRTY 2E4 3
RVSECLEV 113 3
RVSECLNG 11B 3
RVSGNAME 24C 3
RVSTACKED_VOLCOUNT 2FC 3
RVSTACKVOL_ENABLED 2F3 3
RVSTATUS 13D 3
RVSTBIN A7 3
RVSTDATE B3 3
RVSTORID 97 3
RVSTVOL 16 3
RVTRANS 241 3
RVTRERR 355 3
RVTRERR_OLD 16E 3
RVTUSE 85 3
RVTWERR 35A 3
RVTWERR_OLD 172 3
RVTYPE 0 3
RVUCDATE 419 3
RVUCTIME 423 3
RVUNIT 160 4
RVUSE 409 3
RVUSE_OLD 8F 3
RVUSEFLD 1B8 3
RVUSERAC 15D 3
RVVENDOR 330 3
RVVER 186 3
RVVMUSE 15E 3
RVVOLSEQ 139 3
RVVOLSER 4 3
RVVOLTYPE 2CB 3
RVVOL1 32A 3
RVVRS 146 3
RVVRSREL 2CC 3
RVVWMC 350 3
RVWORM 3FC 3
RVWWID 338 3

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014