About cookies on this site Our websites require some cookies to function properly (required). In addition, other cookies may be used with your consent to analyze site usage, improve the user experience and for advertising. For more information, please review your options. By visiting our website, you agree to our processing of information as described in IBM’sprivacy statement. To provide a smooth navigation, your cookie preferences will be shared across the IBM web domains listed here.
HRLBK | Back to Index page |
Prolog Control Block Contents HRLBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
|
HRLBK Prolog | Top of page |
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. |
HRLBK Control Block Content | Top of page |
|
HRLBK Storage Layout | Top of page |
*** 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 | Top of page |
Symbol Dspl Value -------------- ---- ----- HRLSEG1 0000 HRLSEG2 0008 HRLSEG3 0010 HRLSEG4 0018 HRLSEG5 0020 HRLSIZE 0020 00000005 |
Copyright IBM Corporation, 1990, 2024