EXECUTE-REMOTE-CMD

Einsatzhinweis

Funktion: Fernes Kommando ausführen

Benutzergruppe: FT-Benutzer

Aliasname: FTEXEC

Funktionsbeschreibung

Mit dem Kommando EXECUTE-REMOTE-CMD können Sie im fernen System Betriebssystemkommandos ausführen. Die dabei entstehenden Ausgaben für Standardausgabe und Standardfehlerausgabe können im lokalen System entweder auf *SYSLST, *SYSOUT oder in eine Datei ausgegeben werden.

EXECUTE-REMOTE-CMD steht nur für openFT-Partner und FTAM-Partner von Fujitsu Technology Solutions zur Verfügung.

Der Exit-Code, d.h. das Ergebnis des Kommandos, wird im lokalen System als Subcode 2 des EXECUTE-REMOTE-CMD-Kommandos ausgegeben. Wenn der empfangene Exit-Code den Wertebereich des lokalen Exit-Code überschreitet (BS2000-Systeme haben nur einen 1-Byte-Exit-Code, Windows-Systeme dagegen 4 Byte), so wird nur der Inhalt des niederwertigsten Byte ausgegeben.

Kommt es nicht zur Ausführung des Kommandos im fernen System, so wird ein Exit-Code des Übertragungskommandos auf STDOUT ausgegeben und EXECUTE-REMOTE-CMD beendet sich mit dem Exit-Code 255. Der Exit-Code hat systemspezifische Bedeutung.

Für Ausgaben auf *SYSLST können Zeichensätze eingestellt werden.

Für Ausgaben auf *SYSOUT wird der im lokalenSystem eingestellte Zeichensatz verwendet.

Format

EXECUTE-REMOTE-CMD / FTEXEC

PARTNER = <text 1..200 with-low>

,CMD= *NOT-SPECIFIED / <c-string 1..400 with-low> (...)

CODED-CHARACTER-SET = *STD / <name 1..8>

,TRANSFER-ADMISSION = *NONE / <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64> /

*SECRET / *PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <name 1..8> / <c-string 1..67 with-low>

,ACCOUNT = *NONE / <c-string 1..64 with-low> / <text 1..64>

,PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128> / <alphanum-name 1..19> /

*SECRET

,OUTPUT = *SYSOUT / *SYSLST / *FILE(...)

*FILE(...)

FILE-NAME = <filename 1..54>

,CODED-CHARACTER-SET = *STD / <alphanum-name 1..8>

,DATA-TYPE = *CHARCTER / *BINARY

,DATA-ENCRYPTION = *NO / *YES

,FILE-NAME-ENCODING = *TRANSPARENT / *CHARACTER

Beschreibung der Operanden

PARTNER = <text 1..200 with-low>

Name des Partnersystems, wie ihn der FT-Verwalter in der Partnerliste festgelegt hat oder die Adresse des Partnersystems. Näheres zur Adressangabe siehe Abschnitt „Partneradressen angeben“.

CMD =
Kommando in der Syntax des fernen FT-Partnersystems. Eine Kommandofolge im fernen System kann nur dann verarbeitet werden, wenn im fernen System ein FT-Produkt eingesetzt wird, das diese Funktion unterstützt.

CMD = *NOT-SPECIFIED
Es wird kein Kommandostring übergeben. *NOT-SPECIFIED muss verwendet werden, wenn in TRANSFER-ADMISSION ein Berechtigungsprofil angegeben wird, in dem eine Kommandofolge fest vorgegeben ist.

CMD = <c-string 1..400 with-low>
Kommandofolge. Diese Kommandofolge darf maximal 400 Zeichen lang sein, wobei Sonderzeichen doppelt (als zwei Zeichen) gezählt werden müssen.

CODED-CHARACTER-SET =

Gibt an, mit welcher Codierung (Zeichensatz) die Daten der Standardausgabe des fernen Kommandos gelesen werden.

CODED-CHARACTER-SET = *STD
Der im fernen System als Standard eingestellte Zeichensatz wird verwendet.

CODED-CHARACTER-SET = <name 1..8>
Der angegebene Zeichnsatz (CCS) wird verwendet. Dieser muss im fernen System bekannt sein. Diese Angabe darf nicht mit DATA-TYPE=*BIN kombiniert werden.

TRANSFER-ADMISSION =
Enthält Angaben über die Zugangsberechtigung im fernen System.

TRANSFER-ADMISSION = *NONE
Das ferne System benötigt bzw. kennt keine Benutzerberechtigung.

TRANSFER-ADMISSION = <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64>
Wenn im fernen System die FTAC-Funktionalität eingesetzt ist, kann die Zugangsberechtigung für das ferne System über ein Berechtigungsprofil definiert sein. Dann wird an dieser Stelle nur die im Berechtigungsprofil festgelegte TRANSFER-ADMISSION angegeben. Bei der alphanumerischen Eingabe werden Großbuchstaben intern in Kleinbuchstaben umgewandelt.

TRANSFER-ADMISSION = *SECRET
Sie erhalten vom System die Aufforderung, die Zugangsberechtigung einzugeben. Diese wird aber nicht auf dem Bildschirm sichtbar.

TRANSFER-ADMISSION = *PARAMETERS(...)
Identifikation, Abrechnungsnummer und Kennwort des Benutzers im fernen System. Die Operanden in der Klammer können Sie auch als Stellungsoperanden ohne ihre Schlüsselwörter verwenden.

USER-IDENTIFICATION = <name 1..8> / <c-string 1..67 with-low>
Identifikation des Benutzers im fernen System. Die Identifikation muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.

ACCOUNT = *NONE / <c-string 1..64 with-low> / <text 1..64>
Abrechnungsnummer des Benutzers im fernen System. Die Abrechnungsnummer muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.

PASSWORD =
Kennwort, das den Benutzer zum Zugang in das ferne System berechtigt.

PASSWORD = *NONE
Der Zugang ist ohne Kennwort möglich.

PASSWORD = <c-string 1..64 with-low> / <x-string 1..128> / <alphanum-name 1..19>

Kennwort, das den Benutzer zum Zugang in das ferne System berechtigt. Das Kennwort muss in der Syntax des fernen Systems angegeben werden, den Konventionen des fernen Systems entsprechen und dort bekannt sein.

PASSWORD = *SECRET
Sie erhalten vom System die Aufforderung, das Kennwort einzugeben. Ihre Eingabe erscheint aber nicht auf dem Bildschirm.

OUTPUT =
Gibt an, wohin die durch das Kommando erzeugten Daten nach der Übertragung im lokalen System ausgegeben werden.
Ist der Partner ein BS2000-System, so wird die SYSLST-Ausgabe des fernen Kommandos auf den hier angegebenen Kanal umgelenkt. Die SYSOUT-Ausgabe wird lokal immer auf SYSOUT angezeigt.

OUTPUT = *SYSOUT
Die Daten werden nach *SYSOUT geschrieben.

OUTPUT = *SYSLST
Die Daten werden nach *SYSLST geschrieben.

OUTPUT = *FILE(...)
Die Daten werden auf Datei geschrieben. Beachten Sie, dass nur diejenigen Daten auf Datei geschrieben werden, die das bei CMD angegebene Kommando auf *SYSLST (BS2000) bzw. *STDOUT (auf z/OS) bzw. stdout (auf Unix-/Windows-System) ausgibt.

FILE-NAME = <filename 1..54>
Name der Ausgabedatei.

CODED-CHARACTER-SET =
Gibt an, mit welcher Codierung (Zeichensatz) die Daten geschrieben werden.

CODED-CHARACTER-SET = *STD
Der durch XHCS vorgegebene Zeichensatz wird verwendet.

CODED-CHARACTER-SET = <alphanum-name 1..8>
Name des Zeichensatzes (CCS) der verwendet werden soll. Dieser Zeichensatz muss im lokalen System bekannt sein.

Diese Angabe darf nicht mit DATA-TYPE=*BIN kombiniert werden.

DATA-TYPE =
Übertragungsformat der Daten.

DATA-TYPE = *CHARACTER
Die Daten werden als Textdatei übertragen.

DATA-TYPE = *BINARY

Die Daten werden binär übertragen.

DATA-ENCRYPTION =
Gibt an, ob die Daten verschlüsselt übertragen werden. Die Verschlüsselung der Auftragsbeschreibungsdaten wird von diesem Operanden nicht beeinflusst.

DATA-ENCRYPTION = *NO
Die Daten werden nicht unverschlüsselt übertragen.

DATA-ENCRYPTION = *YES
Die Daten werden verschlüsselt übertragen.

FILE-NAME-ENCODING =

Gibt den Codierungsmodus für die im fernen System auszuführenden Kommandos an.

FILE-NAME-ENCODING = *TRANSPARENT
Angabe der im fernen System auszuführenden Kommandos im transparenten Modus (kompatibel zu den bisherigen Versionen).

FILE-NAME-ENCODING = *CHARACTER
Angabe der im fernen System auszuführenden Kommandos im Zeichenmodus. Die Kommandos werden entsprechend dem Zeichencode des fernen Systems interpretiert, bei Unix-Partnern also entsprechend der dort eingestellten openFT-Betriebsparameter-Option (ftmodo -fnccs).

FILE-NAME-ENCODING=*CHARACTER ist nur für Partner mit openFT ab V12.1 erlaubt.

Kommando-Returncodes

(SC2)	SC1	Maincode	Bedeutung / garantierte Meldungen
108	128	FTR0108	Auftrag abgewiesen. Fernes System nicht verfügbar.
4	1	CMD0202	Die gewählten Parameter dürfen nicht gleichzeitig angegeben werden.
33	32	CMD0221	Auftrag abgewiesen. Interner Fehler.
36	32	CMD0221	Auftrag abgewiesen. Inkonsistente Auftragsdaten.
83	32	CMD0221	Interner Fehler.
51	64	FTR2051	Verschlüsselung der Benutzerdaten für diesen Auftrag nicht möglich
125	128	FTR2125	Auftrag abgewiesen. Transportverbindung abgebrochen.
169	64	FTR2169	Auftrag abgewiesen. Fernes System: Zugangsberechtigung ungültig. Transfer-Admission fehlerhaft oder fehlende Berechtigungen von FTAC.
170	64	FTR2170	Auftrag abgewiesen. Fernes System: Funktion nicht unterstützt.
rc	64	FTR2207	Das Kommando hat im fernen System einen Fehler geliefert. Der Exit-Code des fernen Kommandos kann über Subcode 2 (rc) abgefragt werden.
SC1/2 = Subcode 1/2 in Dezimal-Darstellung Zusätzliche Informationen finden Sie im Abschnitt „Kommando-Returncodes“.

Beispiele

1. Der Partner ist ein BS2000-System, Ausgabe in die lokale Datei ex.out:

   FTEXEC BS2PART,'/SH-FT-LOG ,3 ,OUTPUT=SYSLST',(userId,acct,'passw'),

   OUTPUT=*FILE(ex.out),DATA-TYPE=*CHAR

2. Partner Unix-System, Ausgabe auf *STDOUT:

   FTEXEC PARTUX,'ftshwl -nb=10',uxtransadm,,*CHAR