Mit dem Aufruf CALL "NSTATUS"... kann der Benutzer Informationen über Dateiübertragungsaufträge anfordern. Der Funktionsumfang entspricht dem Kommando SHOW-FILE-TRANSFER (NSTATUS).
Aufruf
Die Funktion können Sie wie folgt aufrufen:
CALL "NSTATUS" USING FT-NSTATUS-LIST FT-RETURN-INFO.
FT-NSTATUS-LIST
Der Bereich FT-NSTATUS-LIST beschreibt die Parameterliste für den NSTATUS-Aufruf. FT-NSTATUS-LIST muss in der WORKING-STORAGE-SECTION definiert sein und kann mit der Anweisung
COPY FTNSTAT of linkname.
dorthin kopiert werden.
Vor dem Aufruf müssen Sie die gewünschten Felder ausfüllen. Soll ein Parameter nicht angegeben werden bzw. auf den Standardwert Bezug genommen werden, so muss diesem Feld der Wert LOW-VALUE zugewiesen werden.
FT-NSTATUS-LIST ist folgendermaßen definiert:
01 FT-NSTATUS-LIST.
*
02 FILLER PIC X(4) VALUE "1000".
*
02 USER-PARAMETERS.
*
05 TRANSFER-ID PIC X(10).
88 SELECT-ALL VALUE LOW-VALUE.
*
05 SELECT-PARAMETER.
*
10 OWNER-IDENTIFICATION PIC X(8).
88 OWN VALUE LOW-VALUE.
88 SELECT-ALL VALUE " ".
*
10 INITIATOR PIC X(1).
88 SELECT-ALL VALUE LOW-VALUE.
88 LOCAL VALUE "L".
88 REMOTE VALUE "R".
*
10 PARTNER-NAME PIC X(200).
88 SELECT-ALL VALUE LOW-VALUE.
*
10 FILE-NAME PIC X(512).
88 SELECT-ALL VALUE LOW-VALUE.
10 LIBRARY PIC X(56).
88 SELECT-ALL VALUE LOW-VALUE.
10 ELEMENT PIC X(64).
88 SELECT-ALL VALUE LOW-VALUE.
10 TYP PIC X(8).
88 SELECT-ALL VALUE LOW-VALUE.
10 VERSION PIC X(24).
88 SELECT-ALL VALUE LOW-VALUE.
*
10 MONJV PIC X(56).
88 NONE VALUE LOW-VALUE.
*
10 JV-PASSWORD PIC X(11).
88 NONE VALUE LOW-VALUE.
*
10 STATE PIC X(1).
88 SELECT-ALL VALUE LOW-VALUE.
88 SUSP VALUE "S".
88 LOCKED VALUE "L".
88 WAIT VALUE "W".
88 ACTIVE VALUE "A".
88 FIN VALUE "F".
88 HOLD VALUE "H".
88 CANCELLED VALUE "C".
*
05 INFORMATION PIC X(1).
88 STD VALUE LOW-VALUE.
88 SUMMARY VALUE "U"
88 SELECT-ALL VALUE HIGH-VALUE.
*
05 OUTPUT-DESTINATION PIC X(1).
88 SYSOUT VALUE LOW-VALUE.
88 SYSLST VALUE HIGH-VALUE.
88 SYSOUTCSV VALUE "O".
88 SYSLSTCSV VALUE "L".
Wenn im NSTATUS-Aufruf mehrere Auswahlkriterien angegeben werden, kann ein Auftrag überbestimmt sein (zum Beispiel durch Angaben für TRANSFER-ID und MONJV). Wenn in einem solchen Fall die Kriterien einander widersprechen, wird der NSTATUS-Aufruf nicht ausgeführt.
Beschreibung der Datenfelder
Die Parameter der FT-NSTATUS-LIST haben dieselben Namen und Funktionen wie die entsprechenden Operanden des Kommandos SHOW-FILE-TRANSFER (NSTATUS). Bitte beachten Sie daher die entsprechende Kommandobeschreibung im Handbuch "openFT (BS2000) - Kommandoschnittstelle".