Extract data set vital record specification record: EDGRKEXT

EDGRKEXT maps the vital record specification record in the DFSMSrmm extract data set. See Using the extract data set for more information about the DFSMSrmm extract data set.

    Common Name:          RMM Report Extract File VRS Record
    Macro ID:             EDGRKEXT
    DSECT Name:           RKEXT
    Owning Component:     DFSMSrmm (DF186)
    Eye-Catcher ID:       K
    Storage Attributes:   Subpool: N/A
                          Key: N/A
                          Residency: N/A
    Size:                 RKRCLNG
    Created by:           EDGHSKP
    Pointed to by:        Assembler - USING on RKEXT
                          PL/X - %INCLUDE EDGRKEXT
    Serialization:        None
    Function:             Maps the RMM report extract file VRS
                          record.
    In this record the date format depends on the DATEFORM selected
    by EDGHSKP execution parameter or the parmlib specified value.

Table 1. Structure RKEXT
`Offset`	`Offset`
`Dec`	`Hex`	`Type`	`Len`	`Name(Dim)`	`Description`
`0`	`(0)`	`STRUCTURE`	`246`	`RKEXT`	`Start of structure`
`0`	`(0)`	`CHARACTER`	`1`	`RKTYPE`	`Record type C'K'`
`1`	`(1)`	`CHARACTER`	`1`	`RKTYPE2`	`VRS type: one of V - volume, D - data set, N - name`
`3`	`(3)`	`CHARACTER`	`44`	`RKDSNAME`	`Data set name mask`
`3`	`(3)`	`CHARACTER`	`8`	`RKNAME`	`VRS name`
`3`	`(3)`	`CHARACTER`	`6`	`RKVOLSER`	`Volume serial mask`
`47`	`(2F)`	`CHARACTER`	`1`	`RKGENKEY`	`Data set/volume mask contains generic characters Y-yes, N-no`
`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`	`RKCRDATE`	`Create date of VRS record`
`58`	`(3A)`	`CHARACTER`	`6`	`RKCRTIME`	`Create time of VRS record`
`64`	`(40)`	`CHARACTER`	`8`	`RKCRSID`	`Create system ID of VRS record`
`72`	`(48)`	`CHARACTER`	`10`	`RKLCDATE`	`Last change date of VRS record`
`82`	`(52)`	`CHARACTER`	`6`	`RKLCTIME`	`Last change time (HHMMSST) of VRS record`
`88`	`(58)`	`CHARACTER`	`8`	`RKLCUID`	`Last change user ID of VRS record`
`96`	`(60)`	`CHARACTER`	`8`	`RKLCSID`	`Last change system ID of VRS rec`
`End of common fields`
`104`	`(68)`	`CHARACTER`	`8`	`RKCRTJBN`	`Job name mask`
`112`	`(70)`	`CHARACTER`	`1`	`RKRETNC`	`Retain based on number of cycles: Y, N`
`113`	`(71)`	`CHARACTER`	`1`	`RKRETND`	`Retain based on number of days: Y, N`
`114`	`(72)`	`CHARACTER`	`1`	`RKRETNR`	`Retain based on number of days unreferenced: Y, N`
`115`	`(73)`	`CHARACTER`	`1`	`RKRETNW`	`Retain while data set is cataloged: Y, N`
`116`	`(74)`	`CHARACTER`	`1`	`RKRETNX`	`Retain until expired: Y, N`
`117`	`(75)`	`CHARACTER`	`1`	`RKRETNXD`	`Retain based on extra days Since VRS matched: Y, N`
`118`	`(76)`	`CHARACTER`	`1`	`RKRETNCD`	`Retain based on BYDAYSCYCLE all copies on one day are treated as one cycle: Y, N`
`119`	`(77)`	`CHARACTER`	`1`	`RKRETAND`	`Retention must be ANDed with the next VRS in the chain: Y, N`
`125`	`(7D)`	`CHARACTER`	`1`	`RKDSNG`	`Data set name mask is for a GDG: Y=GDG, P=PSEUDO-GDG ,N=NOGDG`
`126`	`(7E)`	`CHARACTER`	`1`	`RKLOCTYP`	`Location type: one of A - Auto, M - Manual, S - Store or Blank`
`127`	`(7F)`	`CHARACTER`	`8`	`RKLOC`	`Name of location to be stored: one of HOME, storage location, or SMS-defined library name`
`135`	`(87)`	`CHARACTER`	`8`	`RKNEXT`	`Name of next VRS in the chain`
`143`	`(8F)`	`CHARACTER`	`5`	`RKCOUNT`	`Vital record count (number of cycles or elapsed days or volumes to be kept in total)`
`148`	`(94)`	`CHARACTER`	`5`	`RKSTNUM`	`Store keep number (number of cycles or days or volumes to be kept in store)`
`153`	`(99)`	`CHARACTER`	`5`	`RKDELAY`	`Number of elapsed days delay before being selected for the first location`
`158`	`(9E)`	`CHARACTER`	`8`	`RKOWNER`	`Vital record owner`
`166`	`(A6)`	`CHARACTER`	`10`	`RKDELDAT`	`Date the VRS is to be deleted`
`176`	`(B0)`	`CHARACTER`	`30`	`RKDESC`	`Description`
`206`	`(CE)`	`CHARACTER`	`8`	`RKRELOPT`	`VRS release options`
`206`	`(CE)`	`CHARACTER`	`1`	`RKRELIXD`	`Ignore expiration date: Y, N`
`207`	`(CF)`	`CHARACTER`	`1`	`RKRELSI`	`Scratch immediate: Y, N`
`214`	`(D6)`	`CHARACTER`	`10`	`RKLRDATE`	`Last reference date`
`224`	`(E0)`	`CHARACTER`	`6`	`RKLRTIME`	`Last reference time`
`230`	`(E6)`	`CHARACTER`	`10`	`RKUCDATE`	`Last "user" change date`
`240`	`(F0)`	`CHARACTER`	`6`	`RKUCTIME`	`Last "user" change time (HHMMSS)`
`246`	`(F6)`	`CHARACTER`	`0`	`RKRCEND`	`End of RKEXT`

Table 2. Constants for RKEXT
`Len`	`Type`	`Value`	`Name`	`Description`
`1`	`CHARACTER`	`V`	`RKTYPVOL`	`Volume VRS`
`1`	`CHARACTER`	`D`	`RKTYPDSN`	`Data set VRS`
`1`	`CHARACTER`	`N`	`RKTYPNAM`	`Name VRS`
`2`	`DECIMAL`	`246`	`RKRCLNG`	`Control block length`

Table 3. Cross reference for RKEXT
`Name`	`Offset`	`Level`
`RKCOUNT`	`8F`	`2`
`RKCRDATE`	`30`	`2`
`RKCRSID`	`40`	`2`
`RKCRTIME`	`3A`	`2`
`RKCRTJBN`	`68`	`2`
`RKDELAY`	`99`	`2`
`RKDELDAT`	`A6`	`2`
`RKDESC`	`B0`	`2`
`RKDSNAME`	`3`	`2`
`RKDSNG`	`7D`	`2`
`RKEXT`	`0`	`1`
`RKGENKEY`	`2F`	`2`
`RKLCDATE`	`48`	`2`
`RKLCSID`	`60`	`2`
`RKLCTIME`	`52`	`2`
`RKLCUID`	`58`	`2`
`RKLOC`	`7F`	`2`
`RKLOCTYP`	`7E`	`2`
`RKLRDATE`	`D6`	`2`
`RKLRTIME`	`E0`	`2`
`RKNAME`	`3`	`3`
`RKNEXT`	`87`	`2`
`RKOWNER`	`9E`	`2`
`RKRCEND`	`F6`	`2`
`RKRELIXD`	`CE`	`3`
`RKRELOPT`	`CE`	`2`
`RKRELSI`	`CF`	`3`
`RKRETAND`	`77`	`2`
`RKRETNC`	`70`	`2`
`RKRETNCD`	`76`	`2`
`RKRETND`	`71`	`2`
`RKRETNR`	`72`	`2`
`RKRETNW`	`73`	`2`
`RKRETNX`	`74`	`2`
`RKRETNXD`	`75`	`2`
`RKSTNUM`	`94`	`2`
`RKTYPE`	`0`	`2`
`RKTYPE2`	`1`	`2`
`RKUCDATE`	`E6`	`2`
`RKUCTIME`	`F0`	`2`
`RKVOLSER`	`3`	`4`