The parameter EI provides member information for the TOC functions. It is a return parameter. Without extensions, EI is identical to the format of ED. The library contents can be listed using TOC and the resulting member information can be immediately used for processing the member. When TOCPRIM is called, extensions 1 and 3 are supplied; when TOCSEC is called, extensions 2 and 3 are supplied (if subcode=LONG is set). The USER-DATE and USER-TIME fields are only given values in the case of subcode=LONG. CSECT names which exceed 32 characters are truncated to this length for output in the SEC-NAME field.
Fields with no current output relevance contain their initial values.
Extension 3 contains the PA fields (except for the passwords), the CCS name, the member state (FREE/INHOLD), the holder’s user ID and the ACCESS-DATE, ACCESS-TIME and ELEMENT-SIZE fields. The possible entries for the individual display fields of the protection attributes are described under PA (see "PA (Protection Attributes)").
Extension 3 permits protection attributes to be displayed. Passwords are not displayed. However, the user is informed if a password has been allocated. In addition, the stored character set name can be output for each member. The output ’*NONE’ means that “no code” is output.
If the member state is INHOLD, the user ID of the holder is output in the HOLDER field (the holder being the one who changed the member state from FREE to INHOLD); otherwise a blank is output. The ELEMENT-SIZE field displays the number of PAM pages (2-K units) the member requires in the memory.
Field | Meaning | Length | Contents after |
TYP | Member type | 8 | 8 x X'40' |
NAME | Member name | 64 | 64 x X'40' |
VERSION | Member version | 24 | 24 x X'40' |
STORE-FORM | Storage mode of member ́D ́: DELTA: delta member ́V ́: FULL: non-delta member | 1 | 1 x X'40' |
USER-DATE | Date specified by user | 14 | 14 x X'40' |
USER-TIME | Time of day specified by user | 8 | 8 x X'40' |
*********** Extension 1 *** | |||
CREATION-DATE | Date of member generation | 14 | 14 x X'40' |
CREATION-TIME | Time of member generation | 8 | 8 x X'40' |
MODIFI-DATE | Date of last update | 14 | 14 x X'40' |
MODIFI-TIME | Time of last update | 8 | 8 x X'40' |
*********** Extension 2 *** | |||
SEC-NAME | Reference name | 32 | 32 x X'40' |
SEC-ATTRIBUTE | Reference attribute | 8 | 8 x X'40' |
reserved | 5 | 5 x X'40' | |
*********** Extension 3 *** | |||
P-TIND-READ | Protection type indicator for read | 1 | 1 x X'40' |
P-READ-OWN | Read indicator for owner | 1 | 1 x X'40' |
P-READ-GRP | Read indicator for group | 1 | 1 x X'40' |
P-READ-OTH | Read indicator for others | 1 | 1 x X'40' |
P-READ-PIND | Read password indicator | 1 | 1 x X'40' |
reserved | 4 | 4 x X'00' | |
P-TIND-WRIT | Protection type indicator for write | 1 | 1 x X'40' |
P-WRIT-OWN | Write indicator for owner | 1 | 1 x X'40' |
P-WRIT-OTH | Write indicator for others | 1 | 1 x X'40' |
P-WRIT-PIND | Write password indicator | 1 | 1 x X'40' |
reserved | 4 | 4 x X'00' | |
P-TIND-EXEC | Protection type indicator for execute | 1 | 1 x X'40' |
P-EXEC-OWN | Exec indicator for owner | 1 | 1 x X'40' |
P-EXEC-GRP | Exec indicator for group | 1 | 1 x X'40' |
P-EXEC-OTH | Exec indicator for others | 1 | 1 x X'40' |
P-EXEC-PIND | Exec password indicator | 1 | 1 x X'40' |
reserved | 4 | 4 x X'00' | |
P-GUARD-READ | Read guard indicator | 18 | 18 x X'40' |
P-GUARD-WRIT | Write guard indicator | 18 | 18 x X'40' |
P-GUARD-EXEC | Exec guard indicator | 18 | 18 x X'40' |
CCS-NAME | Coded Character Set name | 8 | 8 x X'40' |
P-TIND-HOLD | Borrowing privilege indicator | 1 | 1 x X'40' |
P-HOLD-OWN | Borrowing privilege indicator for owner | 1 | 1 x X'40' |
P-HOLD-GRP | Borrowing privilege indicator for group | 1 | 1 x X'40' |
P-HOLD-OTH | Borrowing privilege indicator for others | 1 | 1 x X'40' |
P-HOLD-PIND | Borrowing password indicator | 1 | 1 x X'40' |
reserved | 4 | 4 x X'40' | |
P-GUARD-HOLD | Borrowing guard indicator | 18 | 18 x X'40' |
HOLD-STATE | Hold flag: state assigned to the member '-': FREE 'H': INHOLD | 1 | 1 x X'40' |
HOLDER | User ID of the holder | 8 | 8 x X'40' |
ACCESS-DATE | Date of last access to member | 14 | 14 x X'40' |
ACCESS-TIME | Time of last access to member | 8 | 8 x X'40' |
reserved | 1 | 1 x X'40' | |
ELEMENT-SIZE | Member size indicator | 4 | 4 x X‘00‘ |
DESTROY-DATA | Destroy indicator | 1 | 1x X‘40‘ |
reserved | 39 | 39 x X‘40‘ |
The TOC parameter EI is required in the following functions:
TOC, TOCPRIM, TOCSEC.