Funktion
Die FILE STATUS-Klausel gibt ein Datenfeld an, das den Zustand einer XML-Datei-Operation anzeigt. Ferner wird bei Angabe eines weiteren Datenfeldes zusätzlich ein Fehlerschlüssel zur Verfügung gestellt.
Format
FILE STATUS IS datenname-1 [datenname-2]
Syntaxregeln
datenname-1 und datenname-2 müssen in der WORKING-STORAGE SECTION, LOCAL-STORAGE SECTION oder LINKAGE SECTION der DATA DIVISION definiert sein.
datenname-1 muss ein zwei Zeichen langes alphanumerisches Datenfeld sein.
datenname-2 muss ein sechs Bytes langes Gruppenfeld mit folgenden Aufbau sein:
01 datenname-2.
02 datenname-2-1 PIC 9(2) COMP.
02 datenname-2-2 PIC X(4).
Allgemeine Regeln
Wenn die FILE STATUS-Klausel angegeben ist, wird nach einer Ein-/Ausgabe-Anweisung für diejenige Datei, deren Dateisteuereintrag diese Klausel untergeordnet ist, der Ein-/Ausgabe-Zustand nach datenname-1 übertragen.
Falls angegeben, ist datenname-2 wie folgt belegt:
Wenn der Inhalt von datenname-1 den Wert Null hat, ist der Inhalt von datenname-2 undefiniert.
Wenn der Inhalt von datenname-1 einen von Null verschiedenen Wert hat, enthält datenname-2 den zusätzlichen Fehlerschlüssel. Der Wert 96 in datenname-2-1 zeigt an, dass es sich um den SIS-Code (POSIX) handelt. Der Wert 231 zeigt an, dass es sich um den CBX-Code (Fehlerschlüssel des XML-Parsers) handelt.
Das Kommando HELP SIS <Inhalt von datenname-2-2> bzw. HELP CBX <Inhalt von datenname-2-2> liefert nähere Informationen zum jeweiligen Fehlerschlüssel.
Übertragen wird der Ein-/Ausgabe-Zustand während der Ausführung jeder OPEN-, OPEN DOCUMENT-, CLOSE-, CLOSE DOCUMENT, READ- oder START-Anweisung, die sich auf die angegebene Datei bezieht, und zwar vor Ausführung jeder entsprechenden USE-Prozedur (siehe Abschnitt "Ein-/Ausgabe-Zustand für XML-Dateien").