MRC - Transient data VSAM control

       DESCRIPTIVE NAME = Transient Data VSAM Control
                          CICS/ESA AP Domain
           Licensed Materials - Property of IBM
            Restricted Materials of IBM 
           5655-Y04
           (C) Copyright IBM Corp. 1982, 1994 
      FUNCTION =
           Copybook DFHMRCPS provides structures, DFHMRCA and
           DFHMRCB and DFHMRSD.
           DFHMRCA describes the String Common Area (MRCA),
           only one MRCA is allocated.
           DFHMRCB describes the String Control Block (MRCB),
           one MRCB is allocated for each VSAM string.
           DFHMRSD describes the Segment Descriptor (MRSD),
           the number of MRSDs allocated depends on the size
           of the intrapartition data set.
      LIFETIME =
           The lifetime of the control blocks and I/O buffers
           is essentially that of CICS.
      STORAGE CLASS =
           The control blocks are located in storage allocated
           from the DFHTDG31 subpool.
           Note that the number of VSAM strings is defined as
           a SIT parameter / override.
      LOCATION =
           The MRCA is located from the TDST.
           MRCBs, if unallocated, are located on a chain whose
           anchor is located in the MRCA.
           MRSDs are located on a chain whose anchor is located
           in the MRCA.
           Note that the update ACB and output ACB are located
           from the MRCA.
           Note also that the RPL and VSAM Error Message Area
           (VEMA) are located from the associated MRCB.
      INNER CONTROL BLOCKS =
           There are no inner control blocks.
      NOTES :
       DEPENDENCIES =
           S/370
       RESTRICTIONS =
           There are no restrictions.
       MODULE TYPE =
           Control block definition.
                 MULTIPLE STRINGS - STRING COMMON AREA (MRCA)
Table 1.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 212 DFHMRCA
(0) CHARACTER 16 MRCA_PREFIX prefix
(0) HALFWORD 2 MRCA_LENGTH - length
(2) CHARACTER 1 MRCA_ARROW - value - '>'
(3) CHARACTER 3 MRCA_DFH - value - 'DFH'
(6) CHARACTER 2 MRCA_DOMID - value - 'TD'
(8) CHARACTER 8 MRCA_BLOCK - value - 'MRCA '
(10) CHARACTER 4 MRCA_DFP DFP release level
(10) BIT(8) 1 MRCA_DFP_VR - version, release
(11) BIT(8) 1 MRCA_DFP_M0 - modification, 0
(12) BIT(16) 2 * - reserved
(14) CHARACTER 64 MRCA_ACB ACB
(14) CHARACTER 8 MRCA_DDNAME - DDNAME
(1C) CHARACTER 44 MRCA_DSNAME - DSNAME
(48) FULLWORD 4 MRCA_STR_N - #(strings)
(4C) ADDRESS 4 MRCA_UACB_P - A(update ACB)
(50) ADDRESS 4 MRCA_OACB_P - A(output ACB)
(54) CHARACTER 24 MRCA_DS data set
(54) FULLWORD 4 MRCA_CI_L - L(control interval)
(58) FULLWORD 4 MRCA_MIN_L - L(user data) - minimum
(5C) FULLWORD 4 MRCA_MAX_L - L(user data) - maximum
(60) FULLWORD 4 MRCA_I_RBA - initial RBA
(64) FULLWORD 4 MRCA_N_RBA - next RBA
(68) FULLWORD 4 MRCA_H_RBA - high RBA
(6C) CHARACTER 8 MRCA_CSM CI status map
(6C) ADDRESS 4 MRCA_MRSD_P - A(first MRSD) or 0
(70) FULLWORD 4 MRCA_MRSD_N - #(MRSDs allocated)
(74) CHARACTER 8 MRCA_SRC_1 MRCB allocation chain
(74) ADDRESS 4 MRCA_TCA_P - A(owning TCA) or 0
(78) ADDRESS 4 MRCA_MWCB_P - A(first MWCB) or 0
(7C) CHARACTER 8 MRCA_SRC_2 CI formatting chain
(7C) ADDRESS 4 * - A(owning TCA) or 0
(80) ADDRESS 4 * - A(first MWCB) or 0
(84) CHARACTER 4 MRCAECB ECB WORD
(84) 1... ....   * - ECB BYTE
(84) .1.. ....   MRCACSMI - CSM BUILD COMPLETE
(84) BIT(22) POS(3) 3 * RESERVED
(87) UNSIGNED 1 MRCAERC1 - RETURN CODE
(88) CHARACTER 4 * MRCA STATUS
(88) CHARACTER 1 MRCAFLG0 - DATASET
(88) 1... ....   MRCAOPEN - OPENED
(88) .1.. ....   MRCAESDS - VSAM ESDS
(88) ..1. ....   MRCADDST - DD STATEMENT
(88) ...1 1111   * - RESERVED
(89) CHARACTER 1 MRCAFLG1 - CONTENTS
(89) 1... ....   MRCAMPTY - EMPTY (INITIALLY)
(89) .1.. ....   MRCAFULL - FULL
(89) ..11 1111   * - RESERVED
(8A) CHARACTER 1 MRCAFLG2 - CSM INITALIZATION
(8A) 1... ....   MRCACSMR - REQUIRED
(8A) .1.. ....   MRCACSMP - IN PROGRESS
(8A) ..1. ....   MRCACSMC - COMPLETE
(8A) ...1 1111   * - RESERVED
(8B) CHARACTER 1 MRCAFLG3 - RESERVED
(8B) BIT(8) 1 * - RESERVED
(8C) CHARACTER 16 * MRCB CHAIN ANCHORS
(8C) CHARACTER 8 MRCACHN1 - UNALLOCATED CHAIN
(8C) ADDRESS 4 MRCAFCN1 - A(FIRST MRCB)
(90) ADDRESS 4 MRCABCN1 - A(LAST MRCB)
(94) CHARACTER 8 MRCACHNS - STATIC CHAIN
(94) ADDRESS 4 MRCAFCNS - A(FIRST MRCB)
(98) ADDRESS 4 * - RESERVED
(9C) CHARACTER 24 * MRCB STATISTICS
(9C) CHARACTER 12 * - ALLOCATION REQUESTS
(9C) FULLWORD 4 MRCATNAL - TOTAL
(A0) FULLWORD 4 MRCACNAL - CURRENT CONCURRENT
(A4) FULLWORD 4 MRCAMXAL - MAXIMUM CONCURRENT
(A8) CHARACTER 12 * - QUEUED REQUESTS
(A8) FULLWORD 4 MRCATNWT - TOTAL
(AC) FULLWORD 4 MRCACNWT - CURRENT CONCURRENT
(B0) FULLWORD 4 MRCAMXWT - MAXIMUM CONCURRENT
(B4) CHARACTER 32 * DATASET STATISTICS
(B4) FULLWORD 4 MRCANCIS - CURRENT CIS FORMATTED
(B8) FULLWORD 4 MRCACTCI - CURRENT CIS ALLOCATED
(BC) FULLWORD 4 MRCAMXCI - MAXIMUM CIS ALLOCATED
(C0) FULLWORD 4 MRCANOSP - NOSPACE RETURNED
(C4) FULLWORD 4 MRCACTPT - PUT REQUESTS
(C8) FULLWORD 4 MRCACTGT - GET REQUESTS
(CC) FULLWORD 4 MRCACTFT - FORMAT REQUESTS
(D0) FULLWORD 4 MRCACTIO - I/O ERRORS
(D4) CHARACTER 0 *
                 MULTIPLE STRINGS - STRING CONTROL BLOCK (MRCB)
Table 2.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 32 DFHMRCB
(0) CHARACTER 16 * MRCB chains
(0) ADDRESS 4 MRCBFCHN - A(next inactive MRCB)
(4) ADDRESS 4 MRCBBCHN - A(previous inactive MRCB)
(8) ADDRESS 4 MRCBSCHN - A(next static MRCB) or 0
(C) ADDRESS 4 * - reserved
(10) CHARACTER 16 * associated control blocks
(10) ADDRESS 4 MRCB_RPL_P - A(RPL)
(14) ADDRESS 4 MRCB_VEMA_P - A(VSAM error message area)
(18) ADDRESS 4 MRCB_MBCB_P - A(MBCB) or 0
(1C) ADDRESS 4 MRCB_MWCB_P - A(MWCB) or 0
(20) CHARACTER 0 *
                 CI STATUS MAP - SEGMENT DESCRIPTOR (MRSD)
Table 3.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 576 DFHMRSD
(0) CHARACTER 16 MRSD_PREFIX prefix
(0) HALFWORD 2 MRSD_LENGTH - length
(2) CHARACTER 1 MRSD_ARROW - value - '>'
(3) CHARACTER 3 MRSD_DFH - value - 'DFH'
(6) CHARACTER 2 MRSD_DOMID - value - 'TD'
(8) CHARACTER 8 MRSD_BLOCK - value - 'MRSD '
(10) CHARACTER 8 MRSD_STATS
(10) FULLWORD 4 MRSD_CIS_ALLOCATED CIs allocated
(14) FULLWORD 4 * Reserved
(18) CHARACTER 20 MRSDPFIX SEGMENT PREFIX
(18) CHARACTER 4 MRSDPFID - EYE CATCHER
(1C) FULLWORD 4 MRSDPFLN - LENGTH
(20) FULLWORD 4 MRSDPFLL - #(FIRST CI IN SEGMENT)
(24) FULLWORD 4 MRSDPFUL - #(LAST CI IN SEGMENT)
(28) ADDRESS 4 MRSDPFCN - A(NEXT SEGMENT) OR 0
(2C) CHARACTER 512 * SEGMENT DATA
(2C) CHARACTER 256 MRSDSEGM - MASTER AS SCALAR
(2C) CHARACTER 1 MRSDSARM (0:255) - MASTER AS ARRAY
(12C) CHARACTER 256 MRSDSEGB - BACK-UP AS SCALAR
(12C) CHARACTER 1 MRSDSARB (0:255) - BACK-UP AS ARRAY
(22C) CHARACTER 20 MRSDSFIX SEGMENT SUFFIX
(22C) CHARACTER 4 MRSDSFID - EYE CATCHER
(230) FULLWORD 4 MRSDSFLN - LENGTH
(234) FULLWORD 4 MRSDSFLL - #(FIRST CI IN SEGMENT)
(238) FULLWORD 4 MRSDSFUL - #(LAST CI IN SEGMENT)
(23C) ADDRESS 4 MRSDSFCN - A(NEXT SEGMENT) OR 0
(240) CHARACTER 0 *

Constants

Table 4.
Len Type Value Name Description
1 HEX 21 MRCA_DFP_21 - V2 R1
1 HEX 22 MRCA_DFP_22 - V2 R2
1 HEX 23 MRCA_DFP_23 - V2 R3