Ein-/Ausgabezustände - Fujitsu BS2000/OSD COBOL2000 V1.5 Benutzerhandbuch

Verarbeiten von POSIX-Dateien
14.6.3 Ein-/Ausgabezustände
Jeder Datei im Programm können mit der FILE STATUS-Klausel Datenfelder zugeordnet
werden, in denen das Laufzeitsystem nach jedem Zugriff auf die Datei Informationen darü-
ber hinterlegt,
– ob die Ein-/Ausgabeoperation erfolgreich war und
– welcher Art ggf. die dabei aufgetretenen Fehler sind.
Diese Informationen können z.B. in den DECLARATIVES durch USE-Prozeduren ausge-
wertet werden und gestatten eine Analyse von Ein-/Ausgabefehlern durch das Programm.
Als Erweiterung zum COBOL-Standard bietet COBOL2000 die Möglichkeit, in diese Analy-
se auch die Schlüssel der POSIX-Fehlermeldungen einzubeziehen. Dadurch lässt sich
eine feinere Differenzierung der Fehlerursachen erreichen. Die FILE STATUS-Klausel wird
im FILE-CONTROL-Paragrafen der ENVIRONMENT DIVISION angegeben; ihr Format ist
z.B. in Abschnitt „Ein-/Ausgabezustände" auf Seite 235
Die beiden in der FILE STATUS-Klausel defibrinieren Datenfelder haben folgende Fun-
ktion:
datenname-1
enthält nach jeder Ein-/Ausgabeoperation auf die zugeordnete Datei einen zweistelligen
numerischen Zustandscode.
datenname-2
ist unterteilt in datenname-2-1 und datenname-2-2. Es dient der Aufnahme des SIS-Codes
(POSIX) zum jeweiligen Ein-/Ausgabezustand und enthält nach jedem Zugriff auf die zuge-
ordnete Datei einen Wert, der vom Inhalt des Feldes datenname-1 abhängt und sich aus
folgender Zusammenstellung ergibt:
Inhalt von
datenname-1
ungleich 0?
nein
Bei Programmablauf im BS2000 lässt sich der Bedeutungstext des jeweiligen SIS-Codes
mit dem Kommando HELP-MSG-INFORMATION SIS<datenname-2-2> ausgeben.
Der einfache und der erweiterte Ein-/Ausgabezustand sind in den beiden folgenden Tabel-
len beschrieben.
330
SIS-Code
ungleich 0?
nicht relevant
ja nein
ja ja
dargestellt.
Wert von
datenname-2-1
undefiniert
0
96 SIS-Code der zugeordneten
COBOL2000 und POSIX
Wert von
datenname-2-2
undefiniert
undefiniert
Fehlermeldung
U41113-J-Z125-6