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 V5R2.0. Last updated on 12 Apr 2006 at 16:58:29 EDT.
Copyright IBM Corporation, 1990, 2005