Einsatzhinweis
Funktion: Dateiübertragungszustand abfragen
Benutzergruppe: FT-Benutzer und FT-Verwalter
Aliasnamen: SHFT / NSTATUS / FTSHWREQ
Funktionsbeschreibung
Mit dem Kommando SHOW-FILE-TRANSFER können Sie Informationen über Dateiübertragungsaufträge anfordern. Dabei können Sie ähnlich wie beim CANCEL-FILE-TRANSFER 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.
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 SHOW-FILE-TRANSFER 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 (bzw. des Bibliothekselements) im lokalen System
die Anzahl der übertragenen Bytes
Mit der Angabe INFORMATION=*ALL im Kommando SHOW-FILE-TRANSFER 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 Abschnitt „Beschreibung der Langausgabe von SHOW-FILE-TRANSFER“.
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
SHOW-FILE-TRANSFER / SHFT / 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..54> / <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...) / *POSIX(NAME=<posix-pathname 1..510>) / *PUBSET(PUBSET=<cat-id 1..4>) *LIBRARY-ELEMENT(...) LIBRARY = *ALL / <filename 1..54> ,ELEMENT = *ALL / <filename 1..64 without-gen-vers>(...) / <composed-name 1..64 with-under>(...) <filename>(...) / composed-name>(...) VERSION = *ALL / <text 1..24> ,TYPE = *ALL / <name 1..8> ,MONJV = *NONE / <filename 1..54 without-gen-vers> ,JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET ,STATE = *ALL / *SUSPEND / *LOCKED / *WAIT / *ACTIVE / *CANCELLED / *FINISHED / *HOLD ,GLOBAL-REQUEST-ID = *ALL / <alphanum-name 1..10> ,INFORMATION = *STD / *ALL / *SUMMARY ,OUTPUT = *SYSOUT (...) / *SYSLST(...) *SYSOUT (...) / *SYSLST(...) 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, dieses Pubset bzw. auf dieses Bibliothekselement 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..54> / <c-string 1..512 with-low> /
*POSIX(NAME = <posix-pathname 1..510>)
Name einer Datei. Über die FT-Aufträge, die auf diese Datei zugreifen, werden Informationen abgefragt.
FILE-NAME = *PUBSET(PUBSET = <cat-id 1..4>)
Zeigt Infomationen über alle FT-Aufträge an, die auf Dateien auf dem angegebenen Pubset zugreifen.
FILE-NAME = *LIBRARY-ELEMENT(...)
Gibt Informationen über Aufträge aus, die im lokalen System auf Bibliothekselemente zugreifen.
LIBRARY =
Wählt die betroffene Bibliothek aus.
LIBRARY = *ALL
Der Bibliotheksname wird nicht als Auswahlkriterium für die Informationsausgabe gewählt.
LIBRARY = <filename 1..54>
Name einer Bibliothek. Über die FT-Aufträge, die auf diese Bibliothek zugreifen, werden Informationen abgefragt.
ELEMENT =
Wählt ein Bibliothekselement aus. Es werden Informationen über alle FT-Aufträge gewünscht, die auf dieses Element zugreifen.
ELEMENT = *ALL
Der Name des Bibliothekselements wird nicht als Auswahlkriterium für die Informationsausgabe gewählt.
ELEMENT = <filename 1..64 without-gen-vers>(...) /
<composed-name 1..64 with-under>(...)
Name eines Bibliothekselements. Es werden Informationen über die FT-Aufträge gewünscht, die auf dieses Bibliothekselement zugreifen.
VERSION =
Version des Elements.
VERSION = *ALL
Über alle FT-Aufträge, die auf irgendeine Version des Elements zugreifen, werden Informationen gewünscht.
VERSION = <text 1..24>
Über FT-Aufträge, die auf eine bestimmte Version des Bibliothekselements zugreifen, werden Informationen gewünscht.
TYPE =
Typ der Bibliothekselemente.
TYPE = *ALL
Der Elementtyp wird nicht als Auswahlkriterium für die Informationsausgabe gewählt.
TYPE = <name 1..8>
Gibt nur Informationen über Aufträge aus, die auf Bibliothekselemente dieses Typs zugreifen.
MONJV =
Wählt ggf. jenen FT-Auftrag aus, der von dieser Jobvariablen überwacht wird.
MONJV = *NONE
Es wird keine Jobvariable als Auswahlkriterium für die Informationsausgabe gewählt.
MONJV = <filename 1..54 without-gen-vers>
Informiert über den von dieser Jobvariablen überwachten FT-Auftrag.
JV-PASSWORD =
Gibt ggf. das Kennwort an, das zum Zugriff auf die Jobvariable benötigt wird.
Haben Sie dem System das Kennwort zuvor durch das BS2000-Kommando ADD-PASSWORD bekannt gemacht, müssen Sie JV-PASSWORD nicht angeben.
JV-PASSWORD = *NONE
Die Jobvariable ist nicht mit einem Kennwort geschützt.
JV-PASSWORD = <c-string 1..4> / <x-string 1..8> /
<integer -2147483648..2147483647>
Dieses Kennwort wird für die Jobvariable benötigt.
JV-PASSWORD = *SECRET
Sie erhalten vom System die Aufforderung, das Kennwort einzugeben. Die Eingabe erscheint aber nicht auf dem Bildschirm.
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).
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- und FTAM-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 SHOW-FILE-TRANSFER“):
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 TRANSFER-FILEausgegeben (siehe dazu Abschnitt „Beschreibung der Langausgabe von SHOW-FILE-TRANSFER“).
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 SHOW-FILE-TRANSFER“).
OUTPUT =
Ausgabemedium.
OUTPUT = * SYSOUT (...)
Die Ausgabe erfolgt auf SYSOUT.
OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt auf SYSLST.
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 SHOW-FILE-TRANSFER).
Wenn im Kommando SHOW-FILE-TRANSFER Auswahlkriterien angegeben werden, und kein Auftrag gefunden wird, der allen diesen Kriterien entspricht, wird das Kommando mit der Meldung quittiert:
% FTR0504 OPENFT: Keine Auftraege zum Auswahlkriterium gefunden
In Prozeduren wird in einem solchen Fall nicht zum nächsten SET-JOB-STEP verzweigt.
Kommando-Returncodes
(SC2) | SC1 | Maincode | Bedeutung |
0 | 0 | CMD0001 | Keine Aufträge gefunden, die den angegebenen |
33 | 32 | CMD0221 | Auftrag abgewiesen. Interner Fehler. |
36 | 32 | CMD0221 | Auftrag abgewiesen. Inkonsistente Auftragsdaten. |
82 | 32 | CMD0221 | Interner Fehler. Jobvariable nicht zugänglich. |
83 | 32 | CMD0221 | Interner Fehler. |
88 | 32 | CMD0221 | Fehler bei OPS-Ausgabe. |
36 | 64 | FTR1036 | Benutzer nicht für andere Kennung berechtigt. |
47 | 64 | FTR1047 | Auftrag mit angegebener Transfer-ID nicht gefunden. |
226 | 64 | FTR2226 | Inhalt der Jobvariablen inkonsistent. |
227 | 64 | FTR2227 | Jobvariable wird nicht von openFT verwendet. |
228 | 64 | FTR2228 | Jobvariable nicht vorhanden. |
SC1/2 = Subcode 1/2 in Dezimal-Darstellung Zusätzliche Informationen finden Sie im Abschnitt „Kommando-Returncodes“. | |||
OPS-Variablen
Die folgende Tabelle zeigt die OPS-Variablen des Kommandos SHOW-FILE-TRANSFER mit dem Operanden INF=*ALL. Die unterstrichenen Werte gelten für die Ausgabe mit dem Operanden INF=*STD. Die Tabelle darunter zeigt die OPS-Variablen für die Ausgabe mit dem Operanden INF=*SUMMARY.
Element | Typ | Ausgabe |
TRANS-ID | Integer | |
STA | String | *SUSPEND / *LOCK / *WAIT / *ACTIVE / *FINISH / |
BYTE-COUNT | Integer | |
PRIO | String | *NORM / *HIGH / *LOW |
INIT | String | *LOC / *REM |
TRANS-DIRECT | String | *TO-PARTNER / *FROM-PARTNER |
PARTNER-NAME | String | |
COMPRESS | String | *NONE / *BYTE-REPETITION / *ZIP |
DATA-ENC | String | *YES / *NO |
DICHECK | String | *YES / *NO |
WRITE-MODE | String | *REPL-FILE / *NEW-FILE / *EXT-FILE |
FILE-SIZE | String | Wert |
REC-SIZE | String | Wert |
REC-FORMAT | String | *STD / *VARIABLE / *FIXED / *UNDEFINED |
START | Struct | |
.DATE | String | *SOON / yyyy-mm-dd |
.TIME | String | *SOON / hh:mm:ss |
CANCEL | Struct | |
.DATE | String | *NO / yyyy-mm-dd |
.TIME | String | *NO / hh:mm:ss |
OWNER | String | |
DATA-TYPE | String | *CHAR / *BINARY / *NOT-SPEC |
TRANSP | String | *YES / *NO |
LOC-PAR | Struct | |
.F-TYPE 1 | String | *FILE / *LIB |
.F-NAME | String | |
.LIB | String | |
.ELEM | String | |
.VERSION | String | |
.TYPE | String | |
.TRANS-ADMIS | Struct | |
.USER-ID | String | |
.ACCOUNT | String | |
.PROF-NAME 2 | String | |
.PROCESS-ADMIS | Struct | |
.USER-ID | String | |
.ACCOUNT | String | |
.SUCC-PROCESS | String | *SECRET / success-processing |
.FAIL-PROCESS | String | *SECRET / failure-processing |
.LISTING | String | *NONE / *SYSLST / *LISTFILE / *FAIL-SYSLST / |
.MONJV | String | |
.CCS-NAME | String | *STD / Wert |
REM-PAR | Struct | |
.F-TYPE 1 | String | *FILE / *LIB |
.F-NAME | String | |
.LIB | String | |
.ELEM | String | |
.VERSION | String | |
.TYPE | String | |
.TRANS-ADMIS | Struct | |
.USER-ID 3 | String | *REM-PROF / user-id |
.ACCOUNT 3 | String | *REM-PROF / account |
.PROCESS-ADMIS | Struct | |
.USER-ID | String | |
.ACCOUNT | String | |
.SUCC-PROCESS | String | *SECRET / success-processing |
.FAIL-PROCESS | String | *SECRET / failure-processing |
.CCS-NAME | String | *STD / Wert |
TARGET | Struct | |
.FILE-FORMAT | String | *SAME / *BLOCK / *SEQ |
.REC-FORMAT | String | *SAME / *UNDEF |
PROTECTION | String | *STD / *SAME |
GLOBAL-REQ-ID | Integer |
1Bei F-Type=*FILE werden LIB, ELEM, VERSION und TYPE nicht angezeigt.
2USER-ID und ACCOUNT werden nicht versorgt, wenn ein FTAC-Profil angegeben wird.
3Da bei Angabe einer fernen FTAC-Transfer-Admission diese nicht ausgegeben werden kann, werden in diesem Fall USER-ID und ACCOUNT mit *REM-PROFILE versorgt.
Die folgende Tabelle zeigt die OPS-Variablen für die Ausgabe mit dem Operanden INF = *SUMMARY.
Element | Typ | Ausgabe |
NUM-ACTIVE | Integer | |
NUM-WAIT | Integer | |
NUM-LOCK | Integer | |
NUM-SUSPEND | Integer | |
NUM-HOLD | Integer | |
NUM-FINISHED | Integer | |
NUM-SUMM 1 | Integer |