FTMGET

Einsatzhinweis

Funktion: Ferne Dateien holen

Benutzergruppe: FT-Benutzer

Funktionsbeschreibung

Mit dem Kommando FTMGET können Sie mehrere Dateien synchron oder asynchron von einem entfernten Partnersystem holen. Die Namen der entfernten Dateien können Sie mit Hilfe von Wildcards angeben. FTMGET verwendet dazu intern u.a. das Kommando FTSCOPY (synchron) bzw. NCOPY (asynchron). Die Übertragungsart (synchron oder asynchron) wird über den Operanden TRANSFER-MODE gesteuert.

Format

FTMGET

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

,LOCAL-PARAMETER = *PAR AMETERS (...)

*PARAMETERS (...)

FILE-NAME = *SAME / <text 2..59> / <c-string_1..512_with-low>

,PASSWORD = *NONE / <alphanum-name 1..8>

,TRANSFER-ADMISSION = *SAME / <alphanum-name 8..32> / <x-string 15..64> /

<c-string 8..32 with-low> / *PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <name 1..8>

,ACCOUNT = *NONE / <alphanum-name 1..40> / c-string 1..40>

,PASSWORD = *NONE / <alphanum-name 1..8>

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

,REMOTE-PARAMETER = *BS2 000(...) / *MSP(...) / *ANY(...)

* BS2 000(...)

FILE-NAME = <filename 1..54> / <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...) /

*LIBRARY-ELEMENT(...)

LIBRARY = <filename 1..54>

,ELEMENT = <filename 1..64>(...) / <c-string 1..64 with low>(...)

<filename>(...) / <c-string>(...)

,VERSION = *STD / <text 1..24>

,TYPE = <name 1..8>

,PASSWORD = *SAME / *NONE / <c-string 1..4> / <x-string 1..8> /

<integer -2147483648..2147483647>

,TRANSFER-ADMISSION = <alphanum-name 8..32> / <x-string 15..64> /

<c-string 8..32 with-low> / *PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <alphanum-name 1..8>

,ACCOUNT = *NONE / <alphanum-name 1..8>

,PASSWORD = *NONE / <c-string 1..8> / <c-string 9..32> / <x-string 1..16>

,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <alphanum-name 1..8>

,ACCOUNT = *NONE / <alphanum-name 1..8>

,PASSWORD = *NOsNE / <c-string 1..8> / <c-string 9..32> / <x-string 1..16>

,SUCCESS-PROCESSING = *NONE / <c-string 1..1000 with-low>

,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low>

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

*MSP(...)

FILE-NAME = <filename 1..59> / <c-string 1..512 with-low>

,PASSWORD = *NONE / <alphanum-name 1..8>

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

*PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <name1..8>

,ACCOUNT = *NONE / <alphanum-name 1..40> / <c-string 1..40>

,PASSWORD = *NONE / <alphanum-name 1..8>

,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <name 1..8>

,ACCOUNT = *NONE / <alphanum-name 1..40> / <c-string 1..40>

,PASSWORD = *NONE / <alphanum-name 1..8>

,SUCCESS-PROCESSING = *NONE /<c-string 1..1000 with-low>

,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low>

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

*ANY(...)

FILE-NAME = <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...)

*LIBRARY-ELEMENT(...)

LIBRARY = <c-string 1..63 with-low>

,ELEMENT = <c-string 1..64 with-low>(...)

<c-string 1..64 with-low>(...)

VERSION = *NONE / *STD / <c-string 1..24 with-low>

,TYPE =<name 1..8>

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

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

<c-string 8..32 with-low> / *PARAMETERS(...)

*PARAMETERS(...)

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

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

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

,PROCESSING-ADMISSION = *SAME / *NONE / *PARAMETERS(...)

*PARAMETERS(...)

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

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

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

,SUCCESS-PROCESSING = *NON E /<c-string 1..1000 with-low>

,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low>

,CODED-CHARACTER-SET = *STD / <c-string 1..8 with-low>

,TRANSFER- MODE = *SYNCHRONOUS / *ASYNCHRONOUS(...)

*ASYNCHRONOUS (...)

,LOCAL-PARAMETER = *PARAMETERS (...)

*PARAMETERS (...)

,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...)

*PARAMETERS(...)

USER-IDENTIFICATION = <name 1..8>

,ACCOUNT = *NONE / <alphanum-name 1..40> / c-string 1..40>

,PASSWORD = *NONE / <alphanum-name 1..8>

,SUCCESS-PROCESSING = *NONE /<c-string 1..1000 with-low>

,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low>

,LISTING = *STD / *NONE / *SYSLST / *LISTFILE / *PARAMETERS(...)

*PARAMETERS(...)

OUTPUT = *SYSLST / *LISTFILE

,CONDITION = *ANY / *ON-FAILURE-ONLY

,PRIORITY = *NORMAL / *HIGH / *LOW

,START = * SOON / *EARLIEST(...)

*EARLIEST(...)

DATE = * TODAY / *TOMORROW / <date 8..10>

,TIME = 00:00 / <time 1..8>

,CANCEL = *N O / *AT(...)

*AT(...)

DATE = *TODAY / *TOMORROW / <date 8..10>

,TIME = 23:59 / <time 1..8>

,CASE-SENSITIVE = * BY-PARTNER / *NO / *YES

,COMPRESS = *NONE / *BYTE-REPETITION / *ZIP

,WRITE-MODE = *REPLACE -FILE / *NEW-FILE / *EXTEND-FILE

,DATA-TYPE = *NOT-SPECIFIED / *CHARACTER (...) / *BINARY (...) / *USER

*CHARACTER(...)

TRANSPARENT = *NO / *YES

*BINARY(...)

TRANSPARENT = *NO / *YES

,DATA-ENCRYPTION = *NO / *YES / *ONLY-DATA-INTEGRITY

,RECORD-SIZE = *NOT-SPECIFIED /<integer 1..32756>

,RECORD-FORMAT = *STD / *FIXED / *VARIABLE / *UNDEFINED

,TABULATOR = *AUTO / *ON / *OFF

,TARGET-FILE-FORMAT = *SAME / *BLOCK-ORIENTED / *SEQUENTIAL(...)

*SEQUENTIAL(...)

RECORD-FORMAT = *SAME / *UNDEFINED

Beschreibung der Operanden

Im Folgenden werden nur die Differenzen im Vergleich zu dn Kommandos FTSCOPY bzw. NCOPY beschrieben.

LOCAL-PARAMETER = *PARAMETERS(...)

FILE-NAME =

Bestimmt die Namen der Emfpangsdateien im lokalen System.

FILE-NAME = *SAME
Die Dateinamen werden unverändert übernommen.

FILE-NAME = <text 2..59> / <c-string_1..512_with-low>
Die Dateinamen werden mit einem Präfix versehen.
Das Präfix muss mit einem Punkt (.), einem Schrägstrich (/) oder einem Gegenschrägstrich (\) enden. Das %-Zeichen wird durch den letzten Teil des fernen Dateinamens ersetzt.

Der letzte Namensteil beginnt hinter dem letzten Schrägstrich (/) oder
Gegenschrägstrich (\) oder einem entsprechenden Zeichen im fernen System.

Das Präfix kann auch den absoluten oder relativen Pfad eines auf dem lokalen Rechner existierenden Verzeichnisses enthalten. Wenn das angegebene Verzeichnis nicht existiert, dann wird FTMGET nicht ausgeführt.

Bitte beachten Sie, dass der resultierende Dateiname den Regeln des lokalen Systems entsprechen muss, andernfalls werden die Dateien nicht übertragen.

REMOTE-PARAMETER = *PARAMETERS(...)

FILE-NAME = <file name with wildcard ...> /LIBRARY-ELEMENT(ELEMENT=filename 1..64 without-gen-vers with wildcard)

Gibt an, welche Dateien oder Bibliothekselemente aus dem fernen System geholt werden sollen.

Wildcard-Symbole dürfen Sie nur im letzten Namensteil nach dem letzten Schrägstrich (/ bei Unix-Systemen) bzw. Gegenschrägstrich (\ bei Windows-Systemen) verwenden. Ein BS2000-Partner wird als POSIX-System angesehen, wenn der angegebene Dateiname ein POSIX-Pfadname ist, also mit / oder ./ beginnt.

Die folgenden Zeichen können zur Definition eines Wildcard-Musters verwendet werden:

*	als Platzhalter für eine beliebige (auch leere) Zeichenfolge.
	Für BS2000-Partner gilt: Beginnt die gesuchte Zeichenfolge mit einem * (Stern), dann müssen Sie den Stern verdoppeln (d.h. **), wenn die gesuchte Zeichenfolge noch weitere Zeichen enthält und Sie keine anderen Wildcards angegeben haben.
?	als Platzhalter für ein beliebiges einzelnes Zeichen.
[chars]	als Platzhalter für ein einzelnes Zeichen aus dem durch chars festgelegten Zeichenvorrat. Sie können in chars einzelne Zeichen aufzählen oder einen bzw. mehrere Zeichenbereiche in der Form a-z angeben. Dadurch werden alle Zeichen zwischen a und z (einschließlich) ausgewählt.
	Beispiel: [aeiX-Z] steht für eines der Zeichen a e i X Y Z.
\x	x als Platzhalter für ein einzelnes der nachfolgend aufgelisteten Zeichen:* ? [ ] \
	Der Gegenschrägstrich dient dazu, die spezielle Bedeutung dieser Zeichen im angegebenen Wildcard-Muster zu entwerten.

TRANSFER- MODE =
Gibt den Übertragungsmodus an.

TRANSFER- MODE = *SYNCHRONOUS
Die Dateien werden synchron übertragen. Dazu startet openFT intern pro Datei einen Übertragungsauftrag mit FTSCOPY.

TRANSFER- MODE = *ASYNCHRONOUS(...)

Die Dateien werden asynchron übertragen. Dazu wird intern pro Datei ein Übertragungsauftrag mit NCOPY gestartet. Die weiteren Parameter (z.B. für Folgeverarbeitung) gelten dann für alle Übertragungsaufträge.

CASE-SENSITIVE =
Bestimmt, ob die Groß- / Kleinschreibung beim Suchen der Dateien berücksichtigt wird.

CASE-SENSITIVE = *BY-PARTNER
Das Verhalten wird durch das Partnersystem bestimmt:

• Für Unix- und POSIX-Partner wird zwischen Groß- und Kleinschreibung unterschieden.

• Für andere Partnersysteme wird nicht zwischen Groß- und Kleinschreibung unterschieden.

CASE-SENSITIVE = *NO
Beim Suchen der Dateien wird nicht zwischen Groß- und Kleinschreibung unterschieden.

CASE-SENSITIVE = *YES
Beim Suchen der Dateien wird zwischen Groß- und Kleinschreibung unterschieden.

Falls bei REMOTE-PARAMETER=*ANY und bei TRANSFER-ADMISSION keine Zugangsberechtigung mit Dateinamenpräfix angegeben wurde, dann gilt für BS2000- und z/OS-Systeme Folgendes:

• BS2000-Partner: FTMGET holt nur Dateien oder Bibliothekselemente, wenn bei FILE-NAME Kleinbuchstaben angegeben wurden.

• z/OS-Partner: FTMGET holt nur Dateien oder Bibliothekselemente, wenn bei FILE-NAME Großbuchstaben angegeben wurden.

DATA-ENCRYPTION =
Steuert die Verschlüsselungsoption für Benutzerdaten und für Datei-/Verzeichnisattribute. D.h. die Angaben gelten auch für Dateimanagementaufträge (anders als bei Dateiübertragungskommandos).

Ergebnismeldungen und Returncodes

Im Erfolgsfall gibt FTMGET eine der folgenden Meldungen aus:

FTR0505 Requests carried out; <n> files were transferred (synchrone Übertragung)

FTR0511 Requests accepted; <n> file transfers initiated (asynchrone Übertragung)

Dabei steht <n> für die Anzahl der synchron übertragenen Dateien bzw. der Anzahl der initiierten asynchronen Übertragungsaufträge. Wurden keine Dateien auf dem entfernten System gefunden, die dem spezifizierten Muster entsprechen, kommt stattdessen die Meldung:

FTR2174 No files corresponding to specified pattern found

Weitere Meldungen:

Ausgabe ( STDERR )	Bedeutung
FTR0707 Invalid parameter	Syntax von lokalem Dateinamen, Bibiotheksnamen oder -element oder Element-Typ ist ungültig.
FTR0865 Not all files transferred successfully	Mindestens eine Quelldatei konnte nicht in das lokale System übertragen werden.
FTR2047 Request rejected by local FTAC	Ungültige Werte bei LOCAL-PARAMETER=..
FTR2155 File / directory not found	Der bei REMOTE PARAMETER=... für den Dateinamen angegebene Pfad ist nicht korrekt.
FTR2169 transfer admission invalid	Auftrag abgewiesen. Fernes System: Zugangsberechtigung ungültig, d.h. Zugangsberechtigung fehlerhaft oder fehlende Berechtigungen von FTAC.

Beispiel

Sie möchten alle Dateien aus dem z/OS-System zos1 holen, die mit CFG beginnen, und sie im lokalen System mit dem Präfix SAV speichern.

FTMGET ZOS1,(SAV.),(C'CFG*',,'TRANSADM')

Dasselbe Kommando für asynchrone Übertragung, wenn die Übertragung morgen gestartet werden soll:

FTMGET ZOS1,(SAV.),(C'CFG*',,'TRANSADM'),TRANS-MODE=*A(START=(*TOM))