Der EI liefert die Elementinformation bei den TOC-Funktionen. Er ist ein reiner Rückkehrparameter. Ohne Erweiterungen ist EI identisch mit dem Format von ED. Man kann sich mit TOC den Bibliotheksinhalt auflisten lassen und die gelieferte Elementinformation sofort für die Bearbeitung des Elementes verwenden. Beim Aufruf von TOCPRIM wird die Erweiterung 1 und 3, beim Aufruf von TOCSEC werden die Erweiterungen 2 und 3 versorgt, wenn der Subcode=LONG gesetzt ist. Die Felder USER-DATE und USER-TIME werden nur bei Subcode=LONG versorgt. CSECT-Namen mit mehr als 32 Zeichen werden zur Ausgabe im Feld SEC-NAME auf 32 Zeichen abgeschnitten.
Aktuell nicht ausgaberelevante Felder sind mit ihren Initialisierungswerten versorgt.
Die Erweiterung 3 erhält bis auf die Kennwörter die Felder von PA, den CCS-Namen, den Elementzustand (FREE/INHOLD), die USERID des Holders und die Felder ACCESS-DATE, ACCESS-TIME und ELEMENT-SIZE. In dem PA sind auch die möglichen Angaben für die einzelnen Anzeigefelder der Schutzattribute beschrieben (siehe "PA Protection Attributes").
Durch die Erweiterung 3 ist die Anzeige von Schutzattributen möglich. Kennwörter werden nicht angezeigt. Es wird jedoch ausgegeben, ob ein Kennwort vergeben ist.
Zudem kann zu jedem Element der gespeicherte Zeichensatz-Name ausgegeben werden. Dabei bedeutet die Ausgabe ́*NONE ́ die Ausgabe von „kein Code“.
Ist der Elementzustand INHOLD, wird im Feld HOLDER die USERID des Holders ausgegeben (Holder ist derjenige, der den Elementzustand von FREE auf INHOLD änderte), sonst Leerzeichen. Im Feld ELEMENT-SIZE wird die Anzahl der PAM-Seiten (2K-Einheit) für die Speicherplatzbelegung des Elements angezeigt.
Feld | Bedeutung | Länge | Inhalt nach der |
TYP | Elementtyp | 8 | 8 x X'40' |
NAME | Elementname | 64 | 64 x X'40' |
VERSION | Elementversion | 24 | 24 x X'40' |
STORE-FORM | Speicherungsform des Elementes ́D ́: DELTA: Delta-Speicherung ́V ́: FULL: Voll-Speicherung | 1 | 1 x X'40' |
USER-DATE | vom Benutzer vergebenes Datum | 14 | 14 x X'40' |
USER-TIME | vom Benutzer vergebene Uhrzeit | 8 | 8 x X'40' |
*********** Erweiterung 1 *** | |||
CREATION-DATE | Datum der Erzeugung des Elementes | 14 | 14 x X'40' |
CREATION-TIME | Uhrzeit der Erzeugung des Elementes | 8 | 8 x X'40' |
MODIFI-DATE | Datum der letzten Änderung des Elementes | 14 | 14 x X'40' |
MODIFI-TIME | Uhrzeit der letzten Änderung des Elementes | 8 | 8 x X'40' |
*********** Erweiterung 2 *** | |||
SEC-NAME | Referenzname | 32 | 32 x X'40' |
SEC-ATTRIBUTE | Referenzattribut | 8 | 8 x X'40' |
reserviert | 5 | 5 x X'40' | |
*********** Erweiterung 3 *** | |||
P-TIND-READ | Anzeigefeld für Leserecht | 1 | 1 x X'40' |
P-READ-OWN | Anzeigefeld für Leserecht (Eigentümer) | 1 | 1 x X'40' |
P-READ-GRP | Anzeigefeld für Leserecht (Gruppe) | 1 | 1 x X'40' |
P-READ-OTH | Anzeigefeld für Leserecht (andere) | 1 | 1 x X'40' |
P-READ-PIND | Anzeigefeld für Leserecht-Kennwort | 1 | 1 x X'40' |
reserviert | 4 | 4 x X'00' | |
P-TIND-WRIT | Anzeigefeld für Schreibrecht | 1 | 1 x X'40' |
P-WRIT-OWN | Anzeigefeld für Schreibrecht (Eigentümer) | 1 | 1 x X'40' |
P-WRIT-OTH | Anzeigefeld für Schreibrecht (andere) | 1 | 1 x X'40' |
P-WRIT-PIND | Anzeigefeld für Schreibrecht-Kennwort | 1 | 1 x X'40' |
reserviert | 4 | 4 x X'00' | |
P-TIND-EXEC | Anzeigefeld für Ausführungsrecht | 1 | 1 x X'40' |
P-EXEC-OWN | Anzeigefeld für Ausführungsrecht (Eigentümer) | 1 | 1 x X'40' |
P-EXEC-GRP | Anzeigefeld für Ausführungsrecht (Gruppe) | 1 | 1 x X'40' |
P-EXEC-OTH | Anzeigefeld für Ausführungsrecht (andere) | 1 | 1 x X'40' |
P-EXEC-PIND | Anzeigefeld für Ausführungsrecht-Kennwort | 1 | 1 x X'40' |
reserviert | 4 | 4 x X'00' | |
P-GUARD-READ | Anzeigefeld für Leseguard | 18 | 18 x X'40' |
P-GUARD-WRIT | Anzeigefeld für Schreibguard | 18 | 18 x X'40' |
P-GUARD-EXEC | Anzeigefeld für Ausführungsguard | 18 | 18 x X'40' |
CCS-NAME | Coded-Character-Set-Name | 8 | 8 x X'40' |
P-TIND-HOLD | Anzeigefeld für Ausleihrecht | 1 | 1 x X'40' |
P-HOLD-OWN | Anzeigefeld für Ausleihrecht (Eigentümer) | 1 | 1 x X'40' |
P-HOLD-GRP | Anzeigefeld für Ausleihrecht (Gruppe) | 1 | 1 x X'40' |
P-HOLD-OTH | Anzeigefeld für Ausleihrecht (andere) | 1 | 1 x X'40' |
P-HOLD-PIND | Anzeigefeld für Ausleih-Kennwort | 1 | 1 x X'40' |
reserviert | 4 | 4 x X'40' | |
P-GUARD-HOLD | Anzeigefeld für Ausleihguard | 18 | 18 x X'40' |
HOLD-STATE | Hold Flag: Zustand, der dem Element zugeordnet '-': FREE 'H': INHOLD | 1 | 1 x X'40' |
HOLDER | USERID des Holders | 8 | 8 x X'40' |
ACCESS-DATE | Datum des letzten Zugriffs für das Element | 14 | 14 x X'40' |
ACCESS-TIME | Uhrzeit des letzten Zugriffs für das Element | 8 | 8 x X'40' |
reserviert | 1 | 1 x X'40' | |
ELEMENT-SIZE | Anzeigefeld für Elementgröße | 4 | 4 x X‘00‘ |
DESTROY-DATA | Indikator für physikalisches Überschreiben | 1 | 1 x X‘00‘ |
reserviert | 39 | 39 x X‘40‘ |
Der TOC-Parameter EI wird bei folgenden Funktionen benötigt:
TOC, TOCPRIM, TOCSEC.