|
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.
RELOCATION CONSIDERATIONS : None
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.
| |