HRLBK

Prolog  

Control Block Contents  
   HRLBK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

HRLBK Prolog

 NAME       : HCPHRLBK
 DESCRIPTION: Human Readable Label Table Block
 DSECT      : HRLBK
 FUNCTION   :
                     Each doubleword entry in this control block contains
                     an address field and an length field.  These are the
                     addresses and lengths of sections of the Human
                     Readable Label Table (the 'HR table).  The maximum
                     size of the HR table is greater than the maximum
                     size of contiguous virtual free storage that can be
                     obtained, so the HR table is separated into 'segments'
                     which are stored in discontiguous pieces of virtual
                     free storage.  The beginning (or all if it's small enough)
                     of the table is in the storage pointed to by the first
                     word of HRLSEG1 and it continues on through as many
                     segments as are required to hold the complete table
                     (maximum of five segments).  If an address field of
                     an entry is zero, then the complete table has been
                     stored in the previous segments.  The length field
                     of each doubleword entry contains the length in bytes
                     of the segment located by the address field in the
                     same entry.
 Notes      :        Virtual free storage is accessible only in
                            Access register mode.
                     The HR table associates human readable descriptions
                     with SECLABELS (Security labels).  Each entry in the
                     table has the following format:
                     --------------------------------------------------------
                     | SECLABEL | LENGTH |  Text describing the SECLABEL    |
                     --------------------------------------------------------
                      (8 bytes)  (1 byte)   (Variable - length in bytes is
                                                        given by the LENGTH
                                                        field and is a maximum
                                                        of 132 characters.
                     The last eight bytes of the table contain x'FF''s
                     (i.e. the last eight bytes in the last (nonzero)
                     segment are 'FFFFFFFFFFFFFFFF.')
                     There is not a control block to map out the entries of
                     the table.
 LOCATED BY : The SYSSECTB field of SYSCM
 CREATED BY : HCPRPF34
 DELETED BY : HCPRPF34
 REFERENCES : None
 SERIALIZED :   Use of the SYSSECTB in SYSCM is serialized.  SYSSECTB contains
                the address of the HRLBK for the current Human Readable Label
                Table.  While reading the HR table, SYSHRTLK should be held
                shared mode (it should be obtained before getting the address
                from SYSSECTB).   While updating the SYSSECTB field, SYSHRTLK
                should be held exclusive mode.
 NOTES      :   This control block is bilingual.  The fields within it can
                be referenced in either ASSEMBLER or PLAS modules.

HRLBK Control Block Content

HRLBK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      HRLBK          Human Readable Label Table Block
0000    0 Dbl-Word     8 HRLSEG1        First word contains the address
                                        in virtual free storage of
                                        segment 1. The second word
                                        contains the length in bytes of
                                        the data in segment 1.
0008    8 Dbl-Word     8 HRLSEG2        Address and length of segment 2
0010   16 Dbl-Word     8 HRLSEG3        Address and length of segment 3
0018   24 Dbl-Word     8 HRLSEG4        Address and length of segment 4
0020   32 Dbl-Word     8 HRLSEG5        Address and length of segment 5
          00000005       HRLSIZE        (*-HRLBK+7)/8

HRLBK Storage Layout

          
*** HRLBK - Human Readable Label Table Block
*
*     +-------------------------------------------------------+
*   0 |                       HRLSEG1                         |
*     +-------------------------------------------------------+
*   8 |                       HRLSEG2                         |
*     +-------------------------------------------------------+
*  10 |                       HRLSEG3                         |
*     +-------------------------------------------------------+
*  18 |                       HRLSEG4                         |
*     +-------------------------------------------------------+
*  20 |                       HRLSEG5                         |
*     +-------------------------------------------------------+
*  28
*
*** HRLBK - Human Readable Label Table Block

HRLBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
HRLSEG1        0000
HRLSEG2        0008
HRLSEG3        0010
HRLSEG4        0018
HRLSEG5        0020
HRLSIZE        0020 00000005