REMOTE-PARAMETER =
Enthält die Angaben über bzw. für das ferne System. Mit dieser Angabe wird der Typ des fernen Systems festgelegt. Dadurch wird auch bestimmt, in welcher Syntax das ferne System die Wertzuweisungen erwartet.
REMOTE-PARAMETER = *BS2000 (...)
Die Wertzuweisungen für das ferne System sind in der Syntax des BS2000 dargestellt. Das lokale System überprüft bereits, ob die angegebenen Werte dieser Syntax entsprechen.
REMOTE-PARAMETER = *MSP(...)
Die Wertzuweisungen für das ferne System sind in der Syntax des des z/OS-Systems dargestellt. Das lokale System überprüft bereits, ob die angegebenen Werte dieser Syntax entsprechen.
REMOTE-PARAMETER = *ANY(...)
Im lokalen System wird nicht überprüft, in welcher Syntax die Wertzuweisungen für das ferne System angegeben werden. Wertzuweisungen für das lokale System können nicht als Standardwerte für das ferne System übernommen werden. Die Wertzuweisungen müssen in Hochkommata angegeben werden. Die Hochkommata innerhalb einer Wertzuweisung müssen verdoppelt werden (Beispiel: PASSWORD = ’C’’ABCD’’’).
FILE-NAME =
Name der Datei oder der Bibliothek im fernen System (Sende- oder Empfangsdatei). Er muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
REMOTE- | *BS2000 | *MSP | *ANY |
relevant für: | X | X | X |
Standardwert: | *NOT-SPECIFIED | *NOT-SPECIFIED | *NOT-SPECIFIED |
openFT Partner bieten die Möglichkeit, automatisch eindeutige Dateinamen zu generieren, um Konfliktfälle auf einfache Weise ausschließen zu können. Dies geschieht durch die Angabe der Zeichenkette %UNIQUE im Dateinamen.
FILE-NAME = *NOT-SPECIFIED
relevant für *BS2000, *MSP und *ANY:
Der Name der Datei ist dem fernen System bekannt, da er zum Beispiel in dem im fernen System angesprochenen FTAC-Profil bereits vollständig festgelegt ist.
FILE-NAME = <filename 1..54> / <filename 1..59> / <c-string 1..512 with-low>
Name der Datei oder Vorverarbeitungskommando beim Empfangen oder Nachverarbeitungskommando beim Senden. Die Angaben ohne Vor-/Nachverarbeitung und mit Vor-/Nachverarbeitung unterscheiden sich.
REMOTE- | *BS2000 | *MSP | *ANY |
FILE-NAME= | <filename 1..54> *POSIX(NAME = | <filename 1..59> | <c-string 1..512 withlow> |
Angaben bei FILE-NAME ohne Vor- oder Nachverarbeitung
Name der Datei im fernen System (Sende- oder Empfangsdatei):
Bei *BS2000 und *MSP kann dieser Dateiname ohne Benutzerkennung angegeben werden, wenn die Datei unter der Benutzerkennung katalogisiert ist, für die die Dateiübertragung durchgeführt wird (Operand TRANSFER-ADMISSION).
Dieser Dateiname muss mit Benutzerkennung ($userid.dateiname) angegeben werden, wenn die Datei nicht unter der Benutzerkennung katalogisiert ist, für die die Dateiübertragung durchgeführt wird (Operand TRANSFER-ADMISSION).
Mit FILE-NAME =<filename 1..59> können auch Bibliothekselemente im z/OS adressiert werden, wenn das im Partnersystem eingesetzte FT-Produkt das Übertragen von Bibliothekselementen unterstützt. Für einen BS2000-Partner verwenden Sie die Struktur *LIBRARY-ELEMENT.
Wenn Sie den Datentyp c-string für einen teilqualifizierten Dateinamen in einem z/OS-Partnersystem (*MSP) verwenden, müssen Sie ihn in der Form C’FILE.XYZ’ angeben.
Wenn vollständige PO- bzw. PDSE-Datasets übertragen werden sollen, muss die Empfangsdatei mit dem entsprechenden Typ :O: bzw. :E: im Auftrag spezifiziert werden, sofern der Partner noch openFT auf z/OS mit einer Version < V10 ist.
Wenn im fernen BS2000 ein FT-Produkt eingesetzt wird, das die im BS2000 übliche Ergänzung von Dateinamen der Form $dateiname um die
Standardbenutzerkennung durchführt, ist eine solche Angabe zulässig. Andernfalls führt sie zu einem Fehler.
Angaben bei FILE-NAME mit Vor- oder Nachverarbeitung
Wenn Sie beim Empfangen ein Vorverarbeitungskommando angeben, dann wird das Ergebnis des Vorverarbeitungskommandos auf die Standardausgabe des fernen Systems ausgegeben (BS2000-Systeme: SYSLST; z/OS: SYSPRINT) und anschließend übertragen. Sie können die Ausgabe des Vorverarbeitungskommandos
auch über die Variable %TEMPFILE ansprechen. Dies hat den Vorteil, dass die Ausgabe ein beliebiges Dateiformat besitzen kann und die Datei in diesem Format übertragen wird. Wenn Sie %TEMPFILE nicht angeben, dann muss die Ausgabe ein Format haben, das in der Standardausgabe des fernen Systems zulässig ist, d.h. in BS2000-Systemen muss es eine SAM-V-Datei sein. Auf z/OS ist es eine PS-Datei mit variabler Blocksize.
Wenn Sie beim Senden ein Nachverarbeitungskommando angeben, dann wird die übertragene Datei als Eingabe für das Nachverarbeitungskommando verwendet. Diese Datei kann mit der Variable %TEMPFILE angesprochen werden. Falls %TEMPFILE nicht angegeben wird, wird über Standardeingabe (BS2000: SYSDTA, z/OS:SYSUT1) eingelesen. Ist das ferne System ein BS2000-System, dann muss die Datei eine
SAM-V oder ISAM-V Datei sein. Auf z/OS ist es eine PS-Datei mit variabler Blocksize.
Sowohl bei der Vorverarbeitung als auch bei der Nachverarbeitung muss bei FILE-NAME ein c-string angegeben werden. Das erste Zeichen muss ein Pipe-Zeichen '|' sein, gefolgt vom Kommandostring. Werden mehrere Kommandos angegeben, dann müssen diese durch ein Semikolon (’;’) getrennt sein.
Beispiel
FILE-NAME = C‘|Kommando1;Kommando2;Kommando3; ...‘
Die maximale Länge des gesamten Kommandos ist auf die Maximallänge des Dateinamens beschränkt. Bitte beachten Sie zum Thema Vorverarbeitung und Nachverarbeitung auch die Beispiele i Abschnitt Beispiele zum NCOPY-Kommando.
Tritt beim Ausführen der einzelnen Kommandos ein Fehler auf, so wird die Übertragung mit der Meldung FTR2206 bzw. FTR2207 abgebrochen.
Soll ein Übertragungsauftrag mit Vor- oder Nachverarbeitung wiederanlauffähig sein, dann muss die Zeichenfolge ’|&’ anstelle von ’|’ angegeben werden.
Beispiel
FILE-NAME = C‘|&Kommando1;Kommando2;Kommando3; ...‘
FILE-NAME = *LIBRARY-ELEMENT(...)
REMOTE- | *BS2000 | *MSP | *ANY |
nur relevant für: | X | 1 | X |
Standardwert: | *NOT-SPECIFIED |
Der Operand gibt an, dass ein Bibliothekselement übertragen werden soll. Sie dürfen nicht für alle drei Operanden aus der Elementbezeichnung *NOT-SPECIFIED angeben, da in diesem Fall nicht garantiert werden kann, dass im fernen System auf ein Bibliothekselement zugegriffen wird.
Außerdem muss das ferne System Bibliothekselemente verarbeiten können.
LIBRARY =
Name der Bibliothek im fernen System.
LIBRARY = *NOT-SPECIFIED
relevant für *BS2000 und *ANY.
Wird im fernen System die FTAC-Funktionalität eingesetzt, kann der Name der Bibliothek in einem Berechtigungsprofil fest vorgegeben sein. Dann darf der Name der Bibliothek dem Auftraggeber nicht bekannt sein und auch nicht im Kommando angegeben werden.
LIBRARY = <filename 1..64> / <c-string 1..512 with-low>
relevant für *ANY.
Name der Bibliothek im fernen System. Er muss den Konventionen des fernen Systems entsprechend angegeben werden.
LIBRARY = <filename 1..54> / <c-string 1..512 with-low>
relevant für *BS2000.
Name der Bibliothek im fernen System. Er muss den Konventionen des fernen Systems entsprechend angegeben werden.
ELEMENT =
Name des Elements der Bibliothek im fernen System.
ELEMENT = *NOT-SPECIFIED
relevant für *BS2000 und *ANY.
Wird im fernen System die FTAC-Funktionalität eingesetzt, kann der Name des Bibliothekselements in einem Berechtigungsprofil fest vorgegeben sein. Dann darf der Name des Bibliothekselements dem Auftraggeber nicht bekannt sein und darf auch nicht im Kommando angegeben werden.
ELEMENT = <filename 1..64 without-gen-vers>(...) /
<composed-name 1..64 with-under>
relevant für *BS2000.
Name des Bibliothekselements im fernen System. Er muss den Konventionen des fernen Systems entsprechend angegeben werden.
ELEMENT = <c-string 1..64 with-low>(...)
relevant für *ANY.
Name des Bibliothekselements im fernen System. Er muss den Konventionen des fernen Systems entsprechend angegeben werden.
VERSION =
Version des Elements im fernen System.
VERSION = *NONE
relevant für *ANY.
Es muss keine Angabe über die Version im fernen System gemacht werden.
VERSION = *STD
relevant für *BS2000 und *ANY.
Höchste Version des Elements.
VERSION = <text 1..24>
relevant für *BS2000.
Version des Elements.
VERSION = <c-string 1..24 with-low>
relevant für *ANY.
Version des Elements. Sie muss den Konventionen des fernen Systems entsprechen.
TYPE =
Typ des Elements im fernen System.
TYPE = *NONE
relevant für *ANY.
Der Elementtyp muss im fernen System nicht angegeben werden.
TYPE = *NOT-SPECIFIED
relevant für *BS2000 und *ANY.
Wird im fernen System die FTAC-Funktionalität eingesetzt, kann der Typ des Bibliothekselements in einem Berechtigungsprofil fest vorgegeben sein. Dann darf der Typ des Bibliothekselements dem Auftraggeber nicht bekannt sein und darf auch nicht im Kommando angegeben werden.
TYPE = <name 1..8>
relevant für *BS2000.
Typ des Elements im fernen System. Er muss den Konventionen des fernen Systems entsprechend angegeben werden.
TYPE = <c-string 1..8 with-low>
relevant für *ANY.
Typ des Elements im fernen System. Er muss den Konventionen des fernen Systems entsprechend angegeben werden.
PASSWORD =
REMOTE- | *BS2000 | *MSP | *ANY |
relevant für: | X | X | X |
Standardwert: | *NONE | *NONE |
Dateikennwort, das zum Zugriff auf die Datei im fernen System berechtigt. Das Dateikennwort muss in der Syntax des fernen Systems angegeben werden und den Konventionen des fernen Systems entsprechen.
Ist die Datei im fernen System mit einem Kennwort geschützt, so muss das Kennwort in diesem Operanden angegeben werden, und zwar:
ein Schreib-Kennwort bei einer Empfangsdatei bzw.
ein Lese-Kennwort bei einer Sendedatei oder einer Empfangsdatei, die nicht mit einem Schreib-Kennwort, aber mit einem Lese-Kennwort geschützt ist bzw.
ein Kennwort für die Ausführung einer Datei bei einer Sende- oder Empfangsdatei, die weder mit einem Lese- noch mit einem Schreib-Kennwort, aber mit einem Ausführungs-Kennwort geschützt ist.
Empfangsdateien, die neu eingerichtet werden, erhalten durch diesen Operanden kein Kennwort. PASSWORD wird in diesem Fall ignoriert.
PASSWORD = *NONE
relevant für *BS2000, *MSP und *ANY.
Der Zugriff ist ohne Dateikennwort möglich.
PASSWORD = <c-string 1..4> / <x-string 1..8> /
<integer -2147483648..2147483647>
relevant für *BS2000.
Angabe des BS2000-Dateikennworts.
PASSWORD = <alphanum-name 1..8>
relevant für *MSP.
Angabe des z/OS-Dateikennworts.
PASSWORD = <c-string 1..64 with-low> / <x-string 1..128>
relevant für *ANY.
Bei *ANY muss das Dateikennwort stets in Hochkommata eingeschlossen werden.
TRANSFER-ADMISSION =
Enthält Angaben über die Zugangsberechtigung im fernen System zur Dateiübertragung.
REMOTE- | *BS2000 | *MSP | *ANY |
relevant für: | X | X | X |
Standardwert: | Pflichtangabe | Pflichtangabe | *NONE |
TRANSFER-ADMISSION = *NONE
relevant für *ANY.
Das ferne System benötigt bzw. kennt keine Benutzerberechtigung.
TRANSFER-ADMISSION = <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low>
relevant für *BS2000, *MSP und *ANY.
Im fernen System wird die FTAC-Funktionalität eingesetzt, es darf nur die im Berechtigungsprofil festgelegte TRANSFER-ADMISSION angegeben werden. Die alphanumerische Eingabe wird intern in Kleinbuchstaben umgewandelt.
Bei Eingabe der Zugangsberechtigung als c-string beachten Sie bitte den Hinweis zur Unterscheidung zwischen Groß- und Kleinbuchstaben in Abschnitt „FT-Kommandoseingeben“. Bei einem z/OS-Partnersystem ist zu beachten, dass im z/OS eine als cstring definierte Zugangsberechtigung im Profil in Großbuchstaben abgelegt wird. Passend dazu muss sie auch im NCOPY-Kommando eingegeben werden, d.h. eine Konvertierung in Kleinbuchstaben muss vermieden werden.
TRANSFER-ADMISSION = *PARAMETERS(...)
Identifikation, Abrechnungsnummer und Kennwort des Benutzers für das ferne System, den dortigen Konventionen entsprechend. Die Operanden in der Klammer können Sie auch als Stellungsoperanden ohne ihre Schlüsselwörter verwenden.
REMOTE- | *BS2000 | *MSP | *ANY |
USER- | <alphanum-name 1..8> | <name 1..8> | <c-string 1..67 withlow> |
ACCOUNT= | *NONE | *NONE <alphanumname1..40> / <c-string | *NONE |
PASSWORD= | *NONE | *NONE | *NONE |
USER-IDENTIFICATION =
relevant für *BS2000, *MSP und *ANY.
Identifikation des Benutzers (Benutzerkennung) im fernen System.
ACCOUNT =
relevant für *BS2000, *MSP und *ANY.
Abrechnungsnummer des Benutzers im fernen System.
ACCOUNT = *NONE
relevant für *BS2000, *MSP und *ANY.
Das ferne System benötigt keine Abrechnungsnummer.
PASSWORD =
relevant für *BS2000, *MSP und *ANY.
Kennwort, das den Benutzer zum Zugang in das ferne System berechtigt.
PASSWORD = *NONE
relevant für *BS2000, *MSP und *ANY.
Der Zugang ist ohne Kennwort möglich.
PROCESSING-ADMISSION =
relevant für *BS2000, *MSP und *ANY.
Enthält Angaben über die Berechtigung eines Benutzers im fernen System zur Folgeverarbeitung.
FTP-Partner unterstützen keine ferne Folgeverarbeitung.
PROCESSING-ADMISSION = *SAME
Es gelten die entsprechenden Werte der REMOTE TRANSFER-ADMISSION.
PROCESSING-ADMISSION = *NONE
relevant für *ANY.
Für die Folgeverarbeitung wird keine Zugangsberechtigung benötigt. Siehe auch Beschreibung von PROCESSING-ADMISSION=*NOT-SPECIFIED.
PROCESSING-ADMISSION = *NOT-SPECIFIED
Wird im fernen System die FTAC-Funktionalität eingesetzt, kann die PROCESSING-ADMISSION in einem Berechtigungsprofil fest vorgegeben sein. Dann darf sie dem Auftraggeber nicht bekannt sein und auch nicht im Kommando angegeben werden.
PROCESSING-ADMISSION = *PARAMETERS(...)
Identifikation, Abrechnungsnummer und Kennwort des Benutzers im fernen System, für die die Folgeverarbeitung durchgeführt werden soll. Die Operanden in der Klammer können Sie auch als Stellungsoperanden ohne ihre Schlüsselwörter verwenden.
REMOTE- | *BS2000 | *MSP | *ANY |
USER- | <alphanum-name 1..8> | <name 1..8> | <c-string 1..67 withlow> |
ACCOUNT = | *NONE | *NONE <alphanumname1..40> / | *NONE |
PASSWORD = | *NONE | *NONE | *NONE |
USER-IDENTIFICATION =
Identifikation des Benutzers (Benutzerkennung) im fernen System.
ACCOUNT =
Abrechnungsnummer des Benutzers im fernen System.
ACCOUNT = *NONE
relevant für *BS2000, *MSP und *ANY.
Das ferne System benötigt keine Abrechnungsnummer.
PASSWORD =
Kennwort, das den Benutzer zum Zugang in das ferne System berechtigt.
PASSWORD = *NONE
relevant für *BS2000, *MSP und *ANY.
Der Zugang ist ohne Kennwort möglich.