|
Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM. |
RECBK
Control Block Contents
RECBK DSECT
Cross Reference (Contains links to field and bit definitions)
RECBK Prolog
NAME : HCPRECBK
DESCRIPTION: RECORDING RECORD FORMAT BLOCK
DSECT : RECBK
FUNCTION : MAPS THE ENTRIES IN THE RECORDING TABLE OF
SUBSCRIBERS TO VARIOUS RECORDING SYSTEM SERVICES
LOCATED BY : RTHDATA
CREATED BY : HCPREC ASSEMBLY
DELETED BY : NONE
NOTES : This control block gets checkpointed during SHUTDOWN and
will be read back in during a WARM start. Therefore, if
the format of the block changes due to service being
applied before the warm start, code should be in place to
distinguish between the old and new format. (See the note
below describing the RECTVERS field.)
RECBK Control Block Content
RECBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure RECBK RECORDING RECORD FORMAT BLOCK 0000 0 Character 8 RECTNAM RECORDING SYSTEM SERVICE REQUESTED 0008 8 Character 8 RECTUID USERID OF RECORD REQUESTOR 0010 16 Signed 4 RECTIXBK POINTER TO THIS EXTRIES IX BLOCK 0014 20 Signed 2 RECTPATH IUCV PATH ID 0016 22 Bitstring 1 RECTLMT THRESHOLD VALUE FOR WARNING MESSAGES COMMON LIMIT VALUES FOR RECTLMT 00000014 RECALMT 20 ACCOUNTING THRESHOLD WARNING LIMIT 00000002 RECELMT 2 EREP THRESHOLD WARNING LIMIT 00000002 RECSLMT 2 SYMPTOM THRESHOLD WARNING LIMIT 000000FF RECCLMT 255 CONFIGURATION THRESHOLD WARNING LIMIT 0017 23 Bitstring 1 RECTRID RECORD ID (GSDBK GSDRID VALUE FOR FOR EREP, LOGREC, ETC.) 0018 24 Signed 4 RECTQUE QUEUE POINTER FOR THIS ENTRY 001C 28 Signed 4 RECTCNT NUMBER OF RECORDS ENQUEUED FOR THIS REQUESTOR 0020 32 Signed 4 RECTMSGL MESSAGE NUMBER OF THE LAST SYSTEM RECORD CHECKED AGAINST THIS ENTRY 0024 36 Bitstring 1 * RESERVED FOR IBM USE 0025 37 Bitstring 1 RECTFLG2 General Recording flag number 2 1... .... RECOLDTQ X'80' RECTQUE flag is not current (i.e. it has the message number of an RSSBK that has not been retrieved from the checkpoint area yet.) 0026 38 Bitstring 1 RECTVERS RECBK VERSION INDICATOR 00000000 RECTVN00 X'00' For version 00, original format 00000001 RECTVN01 X'01' FOR VERSION 01, THE RECTCNT FIELD WAS EXPANDED FROM A HALFWORD TO FULLWORD 00000002 RECTVN02 X'02' FOR VERSION 02, RECBK INCREASED IN SIZE TO ACCOUNT FOR RECTMSGN AND RECTMSGL GOING FROM HALFWORD TO FULLWORD FIELDS NOTES : THE LAST BYTE OF THE RECBK MUST BE THE FLAG BYTE. THIS IS DONE TO PROVIDE A METHOD FOR DETECTING IF THE ENTRY WAS BEING UPDATED WHEN A SYSTEM FAILURE OCCURED. 00000000 * 0027 39 Bitstring 1 RECTFLG RECORDING STATUS 1... .... RECTOFF X'80' RECORDING TURNED OFF FOR THIS ENTRY .1.. .... RECTAUT X'40' USER CONNECTED VIA IUCV ..1. .... RECTINT X'20' EXTERNAL INTERRUPT PENDING ...1 .... RECT2WAY X'10' IUCV 2 WAY PROTOCOL .... 1... RECTEND X'08' END OF THE RECORDING TABLE .... .1.. RECTXTNT X'04' LAST ACTIVE ENTRY IN THE TABLE .... ..1. RECTWRN X'02' WARNING MESSAGE SENT ONCE .... ...1 RECTINC X'01' INCOMPLETE UPDATE TO ENTRY 00000028 RECBLEN *-RECBK RECBK ENTRY IN BYTES 00000005 RECSIZE (*-RECBK+7)/8 RECBK ENTRY IN DOUBLEWORDS 00000028 RECTNEXT * NEXT RECBK ENTRY IN THE TABLE The following mapping shows what the fields changed for the Version 01 RECBK looked like in Version 00. The following fields are used when updating Version 00 RECBKs to Version 01. 001C 28 Signed 2 RECV00CT NUMBER OF RECORDS ENQUEUED FOR THIS REQUESTOR (VERSION 00 FORMAT) 001E 30 Signed 2 RECV00MN MESSAGE NUMBER OF THE MESSAGE POINTED TO BY RECTQUE (VERSION 00 FORMAT) 0020 32 Signed 2 RECV00ML MESSAGE NUMBER OF THE LAST SYSTEM RECORD CHECKED AGAINST THIS ENTRY (VERSION 00 FORMAT) 0022 34 Bitstring 1 RECV00SV (5) RESERVED (VERSION 00 FORMAT) The following mapping shows what the fields changed for the Version 02 RECBK looked like in Version 01. The following fields are used when updating Version 01 RECBKs to Version 02. 0020 32 Signed 2 RECV01MN RECTMSGN FIELD AS A HALFWORD 0022 34 Signed 2 RECV01ML RECTMSGL FIELD AS A HALFWORD
RECBK Storage Layout
*** RECBK - RECORDING RECORD FORMAT BLOCK
*
* +-------------------------------------------------------+
* 0 | RECTNAM |
* +-------------------------------------------------------+
* 8 | RECTUID |
* +---------------------------+-------------+------+------+
* 10 | RECTIXBK | RECTPATH |:TLMT |:TRID |
* +---------------------------+-------------+------+------+
* 18 | RECTQUE | RECTCNT |
* +---------------------------+------+------+------+------+
* 20 | RECTMSGL |//////|:TFLG2|:TVERS|:TFLG |
* +---------------------------+------+------+------+------+
* 28
*
*** RECBK - RECORDING RECORD FORMAT BLOCK
*** Overlay for RECTCNT in RECBK
*
* +-------------+-------------+
* 18 ... 1C | RECV00CT | RECV00MN |
* +-------------+-------------+-------------+------+------+
* 20 | RECV00ML | RECV00SV | 27
* +-------------+----------------------------------+
*
*** Overlay for RECTCNT in RECBK
*** Overlay for RECTMSGL in RECBK
*
* +-------------+-------------+
* 20 | RECV01MN | RECV01ML | 24
* +-------------+-------------+
*
*** Overlay for RECTMSGL in RECBK
RECBK Cross Reference
Symbol Dspl Value -------------- ---- ----- * 0026 00000000 RECALMT 0016 00000014 RECBLEN 0027 00000028 RECCLMT 0016 000000FF RECELMT 0016 00000002 RECOLDTQ 0025 80 RECSIZE 0027 00000005 RECSLMT 0016 00000002 RECTAUT 0027 40 RECTCNT 001C RECTEND 0027 08 RECTFLG 0027 RECTFLG2 0025 RECTINC 0027 01 RECTINT 0027 20 RECTIXBK 0010 RECTLMT 0016 RECTMSGL 0020 RECTNAM 0000 RECTNEXT 0027 00000028 RECTOFF 0027 80 RECTPATH 0014 RECTQUE 0018 RECTRID 0017 RECTUID 0008 RECTVERS 0026 RECTVN00 0026 00000000 RECTVN01 0026 00000001 RECTVN02 0026 00000002 RECTWRN 0027 02 RECTXTNT 0027 04 RECT2WAY 0027 10 RECV00CT 001C RECV00ML 0020 RECV00MN 001E RECV00SV 0022 RECV01ML 0022 RECV01MN 0020
Last updated on 5 Jun 2001 at 16:24:15 EDT.
Copyright IBM Corporation, 1990, 2001