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 |
* |
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 |