In diesem Abschnitt werden die Parameter beschrieben, die in der konfigurierbaren FTP-Server-Servicedefinition festgelegt werden können.
Wenn Sie einen konfigurierbaren FTP-Server-Service über den Befehl mqsicreateconfigurableservice definieren,
können Sie den Namen dieses konfigurierbaren Service in der Eigenschaft FTP-Server und -Port auf der Registerkarte FTP der FileInput- und FileOutput-Knoten angeben.
Die Befehlssyntax zur Erstellung eines konfigurierbaren FTP-Server-Service lautet wie folgt:
. Dabei ist
Objektname der Name des konfigurierbaren Service und
Eigenschaftsname eine oder mehrere der in diesem Abschnitt beschriebenen Eigenschaften.
Wenn Sie einen konfigurierbaren FTP-Server-Service definieren,
müssen Sie einen Wert für die Eigenschaft 'serverName' angeben.
Alle anderen Eigenschaften sind optional.
- serverName
- Die Internetadresse und optional die Portnummer für den fernen FTP-Server.
Die Syntax für die Eigenschaft ist mit der gültigen Syntax für die Eigenschaft FTP-Server und -Port der FileInput- und FileOutput-Knoten identisch
(ausgenommen davon ist der Name eines konfigurierbaren FTP-Server-Service).
- accountInfo
- Für einige FTP-Server ist ein Accountname während des FTP-Anmeldeverfahrens erforderlich.
Wenn eine Angabe für diese Eigenschaft erfolgt, entspricht der Wert dem Accountnamen, der bei der FTP-Anmeldung angegeben wird.
Wenn keine Angabe für diese Eigenschaft erfolgt und der Server einen Accountnamen anfordert, schlägt die FTP-Übertragung fehl.
- scanDelay
- Hier kann angegeben werden, wie viele Sekunden gewartet werden soll, wenn bei einem Suchlauf für das Verzeichnis keine Dateien für die Verarbeitung identifiziert werden konnten. Der Standardwert beträgt 60 Sekunden. Ist diese Eigenschaft gesetzt, wird damit die Option Scan-Verzögerung auf der Registerkarte
FTP des FileInput-Knotens überschrieben, der diesen Service verwendet.
- transferMode
- Der Übertragungsmodus der FTP-Verbindung. Hierfür kommen die Optionen BINARY oder ASCII in Frage.
Die Standardeinstellung ist BINARY. Ist diese Eigenschaft gesetzt, wird damit die Option Transfermodus auf der Registerkarte
FTP des FileInput-Knotens bzw. FileOutput-Knotens überschrieben, der diesen Service verwendet.
- connectionType
- Die Socketverbindung für FTP-Daten. Hierfür kommen die Optionen ACTIVE oder PASSIVE in Frage.
- remoteDirectory
- Der relative oder absolute Verzeichnisname auf dem fernen FTP-Server. Ist diese Eigenschaft gesetzt, wird damit die Option Serververzeichnis auf der Registerkarte
FTP des FileInput-Knotens bzw. FileOutput-Knotens überschrieben, der diesen Service verwendet.
- securityIdentity
- Der Name der über den Befehl mqsisetdbparms definierten Sicherheitsidentität.
Ist diese Eigenschaft gesetzt, wird damit die Option Sicherheitsidentität auf der Registerkarte
FTP des FileInput-Knotens bzw. FileOutput-Knotens überschrieben, der diesen Service verwendet. Wenn diese Eigenschaft den Wert 'secId' hat, müssen Sie die Sicherheitsidentität mit folgendem Befehl definieren:
mqsisetdbparms -n ftp::secId -u Benutzername -p Kennwort
Standardmäßig ist keine dieser Eigenschaften in der konfigurierbaren Servicedefinition für den FTP-Server gesetzt. Bei der Definition eines konfigurierbaren FTP-Server-Service muss als einzige Eigenschaft unbedingt der Servername angegeben werden.
Es folgt ein Beispiel für den Befehl
mqsicreateconfigurableservice, mit dem ein konfigurierbarer FTP-Server-Service erstellt wird:
mqsicreateconfigurableservice WBRK6_DEFAULT_BROKER -c FtpServer -o Server01 -n serverName,scanDelay,transferMode,connectionType,securityIdentity -v one.hursley.abc.com:123,20,ACTIVE,secId
Mit Ausnahme der Eigenschaften 'accountInfo' und 'connectionType', die Sie nur in der Definition des konfigurierbaren FTP-Server-Service festlegen können, können Sie diese Eigenschaften in der Definition des konfigurierbaren FTP-Server-Service oder auf der Registerkarte FTP
der FileInput- und FileOutput-Knoten setzen.
Werte, die in den Eigenschaften in der Definition des konfigurierbaren FTP-Server-Service gesetzt wurden, setzen die Werte außer Kraft, die in den entsprechenden Eigenschaften der FileInput- und FileOutput-Knoten definiert wurden.
Wenn die Eigenschaft 'accountInfo' definiert wird, werden die Angaben während des Anmeldeprotokolls beim Erstellen einer Verbindung zum konfigurierbaren FTP-Server-Service nach Angabe von Benutzer-ID und Kennwort verwendet. Diese Informationen werden manchmal von FTP-Servern benötigt und im Rahmen des Anmeldeprotokolls angefordert. Mit dieser Einstellung können FileInput- und FileOutput-Knoten bei der Anmeldung ordnungsgemäß antworten.
Wenn Sie die Eigenschaft 'connectionType' festlegen, wird dadurch der Typ des für den Austausch von Dateien mit dem FTP-Server verwendeten Datensockets geändert.
Wenn diese Eigenschaft auf ACTIVE gesetzt wird, bezieht sich dies auf einen vom fernen Server zum Client hergestellten Socket (Broker-Nachrichtenfluss).
Wird diese Eigenschaft auf PASSIVE gesetzt, bezieht sich dies auf einen vom Client zum fernen Server hergestellten Socket (z. B. Anmelde- oder Steuersocket). Der Standardwert lautet PASSIVE. Bei dieser Einstellung ist die Wahrscheinlichkeit größer, dass sie von den meisten Arten von Firewallschutz angenommen wird. Dadurch ist bereits eine Client-Anmeldung möglich. Sie können diese Eigenschaft auf ACTIVE setzen, wenn der FTP-Server keine passiven Verbindungen (PASSIVE) unterstützt oder wenn Sie in Ihrer Konfiguration bestimmte Vereinbarungen berücksichtigen müssen.