|
Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
HRLBK
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
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----HRLSEG1 0000
HRLSEG2 0008
HRLSEG3 0010
HRLSEG4 0018
HRLSEG5 0020
HRLSIZE 0020 00000005
Last updated on 3 Aug 1999 at 12:04:44 EDT.
Copyright IBM Corporation, 1990, 1999