Einsatzhinweis
Funktion: Dateiübertragungszustand abfragen
Benutzergruppe: FT-Benutzer und FT-Verwalter
Aliasname: FTSHWREQ
Funktionsbeschreibung
Mit dem Kommando NSTATUS können Sie Informationen über Dateiübertragungsaufträge anfordern. Dabei können Sie ähnlich wie beim NCANCEL Auswahlkriterien für die Sie interessierenden FT-Aufträge angeben.
Als FT-Benutzer sind für Sie nur Informationen über die FT-Aufträge zugänglich, für die Sie auch Eigentümer sind.
Als FT-Verwalter können Sie sich über Aufträge beliebiger Eigentümer informieren. Dazu müssen Sie das Kommando NSTATUS im FT-Administrationsmodus eingeben.
Eigentümer für Aufträge, die im lokalen System gestellt wurden, ist die Kennung, unter der die Aufträge abgesetzt wurden. Eigentümer für Aufträge, die im fernen System gestellt wurden, ist die Kennung im lokalen System, mit der diese Aufträge durchgeführt werden.
Den Umfang der auszugebenden Information können Sie wählen. Standardmäßig erhalten Sie als Antwort des Systems auf das Kommando NSTATUS folgende Angaben:
die Auftrags-Identifikation des Auftrags
den Initiator des Auftrags (lokales oder fernes System)
den Betriebszustand des Auftrags (Näheres finden Sie in der Erklärung der Operanden)
das Partnersystem
die Übertragungsrichtung
den Namen der zu übertragenden Datei im lokalen System
die Anzahl der übertragenen Bytes
Mit der Angabe INFORMATION=*ALL im Kommando NSTATUS fordern Sie eine umfangreichere Information an. openFT gibt Ihnen dann zusätzlich zur Standardausgabe die Werte weitere Operanden des Übertragungs-Kommandos aus, mit denen der Auftrag gestellt wurde. Welche Ausgabeparameter angezeigt werden, hängt von den Parametern ab, die beim Auftrag angegeben wurden.
Die vollständige Beschreibung aller möglichen Ausgabeparameter und -werte finden Sie im .
Je präziser Sie den Auftrag eingrenzen, über den Sie sich informieren wollen, desto weniger „uninteressante“ Aufträge werden mit ausgegeben.
Mit der Angabe INFORMATION=*SUMMARY erhalten Sie eine kleine Tabelle mit der Anzahl der Aufträge in den verschiedenen Auftragszuständen.
Format
NSTATUS / FTSHWREQ |
TRANSFER-ID = *ALL / <integer 1..2147483647> ,SELECT = *OWN / *PARAMETERS(...) *PARAMETERS(...) OWNER-IDENTIFICATION = *OWN / *ALL / <name 1..8> ,INITIATOR = ( *LOC AL, *REMOTE ) / list-poss(2): *LOCAL / *REMOTE ,PARTNER = *ALL (...) / <text 1..200 with-low> *ALL(...) PARTNER-STATE = *ALL / *ACTIVE ,FILE-NAME = *ALL / <filename 1..59> / <c-string 1..512 with-low> ,MONJV = *NONE / ,JV-PASSWORD = *NONE ,STATE = *ALL / *SUSPEND / *LOCKED / *WAIT / *ACTIVE / *CANCELLED / *FINISHED / *HOLD ,GLOBAL-REQUEST-ID = *ALL / <alphanum-name 1..10> ,INFORMATION = *STD / *ALL / *SUMMARY ,OUTPUT = *STDERR (...) / *STDOUT(...) *STDERR (...) / *STDOUT(...) LAYOUT = *STD / *CSV |
Beschreibung der Operanden
TRANSFER-ID =
Auftrags-Identifikation des Auftrags, über den Informationen abgefragt werden.
TRANSFER-ID = *ALL
Informiert über alle FT-Aufträge des Eigentümers.
Als FT-Benutzer können Sie sich nur über die aktuellen FT-Aufträge informieren, für die Sie Eigentümer sind.
Als FT-Verwalter können Sie sich über alle aktuellen FT-Aufträge informieren, die auf Ihr System zugreifen.
TRANSFER-ID = <integer 1..2147483647>
Auftrags-Identifikation, die dem lokalen System in der FT-Auftragsbestätigung mitgeteilt wurde.
SELECT =
Enthält Auswahlkriterien für FT-Aufträge, die abgefragt werden. Informationen über einen FT-Auftrag werden dann ausgegeben, wenn alle angegebenen Kriterien für ihn zutreffen.
SELECT = *OWN
Informiert über alle vorhandenen FT-Aufträge, für die Sie Eigentümer sind.
SELECT = *PARAMETERS(...)
OWNER-IDENTIFICATION =
Eigentümer der FT-Aufträge. Dieser Operand ist nur für Sie als FT-Verwalter uneingeschränkt nutzbar.
OWNER-IDENTIFICATION = *OWN
Informiert nur über FT-Aufträge der eigenen Kennung.
OWNER-IDENTIFICATION = *ALL
Informiert über FT-Aufträge aller Kennungen.
OWNER-IDENTIFICATION = <name 1..8>
Spezielle Kennung, über deren FT-Aufträge informiert werden soll. Als FT-Benutzer dürfen jeweils nur die eigene Kennung angeben. Die Angabe entspricht der für *OWN.
INITIATOR =
Gibt an, wo die Initiative für die interessierenden FT-Aufträge lag.
INITIATOR = ( *LOCAL,*REMOTE )
Informiert über FT-Aufträge, die im lokalen oder im fernen System gestellt wurden.
INITIATOR = *LOCAL
Informiert über FT-Aufträge, die im lokalen System gestellt wurden.
INITIATOR = *REMOTE
Informiert über FT-Aufträge, die im fernen System gestellt wurden.
PARTNER =
Wählt FT-Aufträge aus, die mit einem bestimmten Partnersystem durchgeführt werden.
PARTNER = *ALL (...)
Das Partnersystem wird nicht als Auswahlkriterium für die Informationsausgabe gewählt.
PARTNER-STATE =
Der Status des Partnersystems wird als Auswahlkriterium verwendet.
PARTNER-STATE = *ALL
Die Aufträge werden unabhängig vom Status des Partnersystems ausgewählt.
PARTNER-STATE = *ACTIVE
Nur die Aufträge von und zu den aktiven Partnern werden ausgewählt.
PARTNER = <text 1..200 with-low>
Name oder Adresse eines Partnersystems. Es werden Informationen über die FT-Aufträge angefordert, die mit diesem System durchgeführt werden. Näheres zur Adressangabe siehe Abschnitt „Partneradressen angeben“.
FILE-NAME =
Wählt FT-Aufträge aus, die im lokalen System auf diese Datei als Sende- oder Empfangsdatei zugreifen. Der Datei- bzw. Bibliothekselementname muss genauso angegeben werden wie im Dateiübertragungsauftrag. Wurden Dateinamen mit %UNIQUE erzeugt, dann muss hier der von openFT erzeugte Dateiname als Auswahlkriterium angegeben werden.
FILE-NAME = *ALL
Der Dateiname wird nicht als Auswahlkriterium für die Informationsausgabe gewählt.
FILE-NAME = <filename 1..59> / <c-string 1..512 with-low>
Name einer Datei. Über die FT-Aufträge, die auf diese Datei zugreifen, werden Informationen abgefragt.
auf zugreifenMONJV = *NONE
Der Parameter wird nur aus Kompatibilitätsgründen unterstützt.
JV-PASSWORD = *NONE
Der Parameter wird nur aus Kompatibilitätsgründen unterstützt.
STATE =
Wählt jene FT-Aufträge aus, die sich im angegebenen Betriebszustand befinden. In der Zeit zwischen der Eingabe des Kommandos und der Ausgabe der Information kann sich der Zustand eines Auftrags gerade ändern. Das führt dazu, dass Sie gelegentlich auch Aufträge zu sehen bekommen, die sich in einem anderen Zustand als dem von Ihnen mit STATE gewählten befinden.
STATE = *ALL
Der Zustand eines Auftrags wird nicht als Kriterium für die Informationsausgabe gewählt.
STATE = *SUSPEND
Fordert Informationen über FT-Aufträge an, die sich im Betriebszustand SUSPEND befinden (= unterbrochen, z.B. durch das Kommando FTMODOPT STATE=*INAC-TIVE im Partnersystem oder durch einen FT-Auftrag hoher Priorität).
STATE = *LOCKED
Fordert Informationen über FT-Aufträge an, die sich im Betriebszustand LOCKED befinden (= vorübergehend wegen länger andauerndem Betriebsmittelengpass gesperrt).
STATE = *WAIT
Fordert Informationen über FT-Aufträge an, die sich im Betriebszustand WAIT befinden (= Warten auf Betriebsmittel).
STATE = *ACTIVE
Fordert Informationen über FT-Aufträge an, die sich im Betriebszustand ACTIVE befinden (= in Bearbeitung).
STATE = *CANCELLED
Fordert Informationen über FT-Aufträge an, die abgebrochen wurden und auf die Beendigung der Aushandlung mit dem Kommunikationspartner warten. Diese Aufträge sind nur für den FT-Verwalter sichtbar!
STATE = *FINISHED
Fordert Informationen über FT-Aufträge an, die sich im Betriebszustand FINISHED befinden (= beendet oder abgebrochen, aber Benutzer noch nicht benachrichtigt).
STATE = *HOLD
Fordert Informationen über FT-Aufträge an, die sich im Betriebszustand HOLD befinden (= angehalten bis zur Startzeit).
GLOBAL-REQUEST-ID =
Wählt die FT-Aufträge anhand der globalen Auftrags-Identifikation aus.
GLOBAL-REQUEST-ID = *ALL
Die globale Auftrags-Identifikation ist kein Suchkriterium.
GLOBAL-REQUEST-ID = <alphanum-name 1..10>
Fordert Informationen über den FT-Auftrag mit einer bestimmten globalen Auftrags-Identifikation an. Die globale Auftrags-Identifikation ist nur für Inbound-Aufträge von openFT-Partnern relevant. Sie wird vom Initiator des Auftrags vergeben (Transfer-ID) und an das lokale System übermittelt.
INFORMATION =
Umfang der Ausgabe.
INFORMATION = *STD
Die Ausgabe erfolgt in Kurzform und enthält folgende Informationen (siehe Abschnitt„Beschreibung der Kurzausgabe von NSTATUS“):
Transfer-ID
Initiator
Status des Auftrags
Partner
Senderichtung
Bytezähler
Datei- bzw. Elementbezeichnung im lokalen System
INFORMATION = *ALL
Die Ausgabe erfolgt in Langform. Zusätzlich zur Kurzform werden weitere Informationen über Operanden im Kommando NCOPY ausgegeben (siehe dazu Abschnitt „Beschreibungder Langausgabe von NSTATUS“).
INFORMATION = *SUMMARY
Die Ausgabe erfolgt als Summenangabe. Mit der Angabe INFORMATION=*SUMMARY können Sie die ausgegebene Information auf eine Statistik der aktuell vorhandenen Aufträge beschränken. Die Anzeige ist dabei gegliedert nach den Zuständen, in denen sich die Aufträge befinden. Die angezeigte Summe kann die Summe der Einzelspalten übersteigen, da alle Aufträge gezählt werden, auch diejenigen, die noch keinen Auftragszustand haben. Es wird ausgegeben, wie viele Aufträge sich in den einzelnen Auftragszuständen befinden (siehe Abschnitt „Beschreibung der Summenausgabe von NSTATUS“).
OUTPUT =
Ausgabemedium.
OUTPUT = *STDERR (...)
Die Ausgabe erfolgt auf SYSTSPRT bzw. auf SYSERR, wenn dieser DDNAME definiert ist.
OUTPUT = *STDOUT(...)
Die Ausgabe erfolgt auf SYSPRINT.
LAYOUT = *STD
Die Ausgabe wird in eine vom Anwender leicht lesbare Form gebracht.
LAYOUT = *CSV
Die Ausgabe erfolgt im Character Separated Values Format. Dies ist ein speziell im PC-Umfeld weit verbreitetes, tabellenartiges Format, bei dem die einzelnen Felder durch das Separatorenzeichen Semikolon “;“ getrennt sind (siehe Abschnitt NSTATUS).
Wenn im Kommando NSTATUS Auswahlkriterien angegeben werden, und kein Auftrag gefunden wird, der allen diesen Kriterien entspricht, wird das Kommando mit der Meldung quittiert:
FTR0504 OPENFT: No requests available for the selection criteria