Rückinformationen und Fehleranzeigen

Nach jedem CALL-Aufruf an openFT (BS2000) werden Rückinformationen in die Struktur FT-RETURN-INFO bereitgestellt.

FT-RETURN-INFO

Der Bereich FT-RETURN-INFO beschreibt die von openFT (BS2000) gelieferte Rückinformation. FT-RETURN-INFO muss in der WORKING-STORAGE SECTION definiert sein und kann mit der Anweisung

COPY FTRETC OF linkname.

dorthin kopiert werden.

FT-RETURN-INFO ist folgendermaßen definiert:

 01  FT-RETURN-INFO.
     05 FILLER                  PIC X(4)   VALUE "V300".
     05 TRANSFER-ID             PIC X(10).
*
     05 FT-RETURN-CODE.
         10 MAIN-RETURN-CODE    PIC S9(5) COMP.
             88 OKAY                       VALUE 0.
         10 SUB-RETURN-CODE     PIC S9(5) COMP.
*
         10 DMS-RETCODE         PIC X(8).
         10 LINK-RETCODE REDEFINES DMS-RETCODE PIC X(8).
*

Die am Anfang der Struktur stehende Versionsangabe dient zur Identifikation des COPY-Elements und darf vom Benutzer nicht überschrieben werden.

Beschreibung der Datenfelder

TRANSFER-ID	Das Feld enthält nach einem erfolgreichen NCOPY-Aufruf die Auftragsidentifikation des erzeugten Auftrags (linksbündig, rechts mit Leerzeichen aufgefüllt) oder nach einem nicht erfolgreichen NCOPY-Aufruf die Zeichenkette ’##########’. Bei einem NCANCEL-/NSTATUS-Aufruf wird das Feld nicht geändert. Bei einem NMOD-/NSHOW-/NDEL-/NLMOD- und NLSHOW-Aufruf ist das Feld bedeutungslos.
FT-RETURN-CODE	enthält die Rückmeldungen.

Aufbau der Feldes FT-RETURN-CODE

Das Feld für den Returncode hat folgendes Format:

Das Feld mit dem Returncode genügt den Konventionen für den Returncode ab BS2000 Version 9.