FTEXEC

Einsatzhinweis

Funktion: Fernes Kommando ausführen

Benutzergruppe: FT-Benutzer

Funktionsbeschreibung

Mit dem Kommando FTEXEC 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 *STDERR, *STDOUT oder in eine Datei ausgegeben werden.

FTEXEC steht nur für openFT-Partner von Fujitsu Technology Solutions zur Verfügung.

Im Erfolgsfall liefert FTEXEC 0 und im Fehlerfall den Returncode 12. Das Ergebnis des ausgeführten Kommandos wird mitübertragen.

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

Für Ausgaben auf *STDOUT wird der im lokalen System eingestellte Zeichensatz verwendet.

Format

FTEXEC

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

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

CODED-CHARACTER-SET = <alphanum-name 1..8>

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

*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>

,OUTPUT = *STDERR / *STDOUT / *FILE(...)

*FILE(...)

FILE-NAME = <filename 1..59>

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

,DATA-TYPE = *CHAR ACTER / *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 = <alphanum-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 = *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.

OUTPUT =
Gibt an, wohin die durch das Kommando erzeugten Daten nach der Übertragung im lokalen System ausgegeben werden.

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

OUTPUT = *STDOUT
Die Daten werden nach *STDOUT 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..59>
Name der Ausgabedatei.

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

CODED-CHARACTER-SET = *STD
Der durch das System 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.

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

3. Der Partner ist ein z/OS-System:

   a) FTEXEC ZOS1,'ftshwopt',transadm

   b) FTEXEC ZOS2,'ftshwlog,10,out=*stdout',transadm,out=*file(ex.out)