RECBK - 32-bit CP - V4R4.0

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 V4R4.0. Last updated on 29 Jul 2003 at 16:11:16 EDT.
Copyright IBM Corporation, 1990, 2003