dliVar (Systemvariable)
Die dliVar-Systemvariablen enthalten Informationen zur jüngsten DL/I-Datenbank-Ein-/Ausgabe.
Diese Variablen sind nur dann verfügbar, wenn Sie Ihrem Programm die komplexe Eigenschaft '@DLI' zuordnen.
Mit Ausnahme von 'dliVar.handleHardDLIErrors' und 'dliVar.cicsRestart' verhalten sich sämtliche
dliVar-Variablen wie folgt:
- Die Variablen werden auf Typbasis initialisiert, wenn
- ein Programm startet.
- ein Programmspezifikationsblock (PSB) in der CICS-Umgebung beendet wird.
- ein weiteres Programm aufgerufen wird.
- Die Variablen werden nach jeder DL/I-Datenbank-Ein-/Ausgabe zurückgesetzt. Die Informationen stammen aus dem Datenbank-PCB (Programmkommunikationsblock), der im jüngsten DL/I-E/A-Aufruf verwendet wird.
- Die Variablen werden nicht nach Aufrufen an 'dliLib.AIBTDLI()', 'dliLib.EGLTDLI()' oder 'vgLib.VGTDLI()' bzw. nach DL/I-Aufrufen an IMS-Nachrichtenwarteschlangen oder GSAM-Dateien gesetzt.
Erläuterung der Variablen:
| Variablenname | Beschreibung |
|---|---|
| cicsCondition | CICS-Bedingungscode (sofern vorhanden) für den zuletzt abgesetzten DL/I-E/A-Aufruf. |
| cicsError | CICS-Fehlercode (sofern vorhanden) für den zuletzt abgesetzten DL/I-E/A-Aufruf. |
| cicsRestart | Unter CICS gibt diese Variable an, ob das DL/I-Programm nach einem Deadlock erneut gestartet wurde. |
| dbName | Der Name der DL/I-Datenbank, auf die mit dem zuletzt abgesetzten DL/I-E/A-Aufruf zugegriffen wurde. |
| handleHardDLIErrors | Steuert, ob die Ausführung eines Programms beim Auftreten eines permanenten Fehlers bei einer DL/I-E/A-Operation fortgesetzt wird. Sie müssen sich im V6-Ausnahmemodus befinden, und die Anweisung muss sich in einem try-Block befinden. |
| keyArea | Der verknüpfte Schlüssel des Segments auf der niedrigsten Stufe im zuletzt abgesetzten DL/I-E/A-Aufruf. |
| keyAreaLen | Die Anzahl der Byte des Felds 'keyArea', die im zuletzt abgesetzten DL/I-E/A-Aufruf verwendet wurden. |
| numSensitiveSegs | Die Anzahl der Segmenttypen, die ein Programm für die Datenbank verarbeiten kann, auf die während der letzten DL/I-E/A-Funktion zugegriffen wurde. |
| procOptions | Die DL/I-Optionen für die Datenbank, auf die durch den zuletzt abgesetzten DL/I-E/A-Aufruf zugegriffen wurde. |
| segmentLevel | Die Ebenennummer des Segments der niedrigsten Ebene, auf das im zuletzt abgesetzten DL/I-E/A-Aufruf zugegriffen wurde. (Die Stammebene ist 01.) |
| segmentName | Der Name des Segments der niedrigsten Ebene, auf das mit dem zuletzt abgesetzten DL/I-E/A-Aufruf zugegriffen wurde. |
| statusCode | Der DL/I-Statuscode für den zuletzt abgesetzten DL/I-E/A-Aufruf. |