Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

RECBK

Prolog  

Control Block Contents  
   RECBK DSECT

Storage Layout  

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.) NOTES : The following
                                        field is used to indicate when
                                        the RECBK format has changed and
                                        what that change was due to. Any
                                        code defined here should be
                                        checked in HCPRECKP when old
                                        format RECBKs are read from the
                                        checkpoint cylinders. The old
                                        format RECBKs should then be
                                        updated appropriately to the new
                                        format. Code should also be added
                                        to HCPRIUCF and HCPRECRI to set
                                        the code for any RECBKs that are
                                        being newly created AFTER the
                                        format change. A new code should
                                        only need to be defined here when
                                        a change to the RECBK causes it
                                        to be incompatible with a
                                        previous format (as in the case
                                        of the RECTCNT field being
                                        expanded from a halfword to a
                                        fullword). Due to compatibility,
                                        the displacement of this field
                                        should NEVER change. Previous
                                        versions of this control block
                                        had this field marked 'RESERVED'
                                        and the field was known to be
                                        zero. Therefore, previous
                                        versions were version X'00'.
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.
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
-------------- ---- -----
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

This information is based on z/VM V5R2.0. Last updated on 12 Apr 2006 at 17:21:06 EDT.
Copyright IBM Corporation, 1990, 2005