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

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

This information is based on z/VM V4R2.0. Last updated on 30 Oct 2001 at 15:39:08 EDT.
Copyright IBM Corporation, 1990, 2001