OS/400-Agent - FileEvent-Unterstützung

OS/400

Agent - Kommandos

---

OS/400-Agent - FileTransfer-Unterstützung

Bei der Verwendung von FileTransfers mit einem OS/400 Agenten sind einige Besonderheiten zu berücksichtigen.

Damit das neue FileTransfer-Protokoll zum Einsatz kommt, müssen OS/400-Agenten der Version 9.00A oder höher als multithreadfähiger Prozess gestartet werden. Dazu ist in der JOBD des Agenten der Parameter ALWMLTTHD auf den Wert *YES zu setzen.

IFS wird nur beim neuen FileTransfer-Protokoll unterstützt!

Der neue FileTransfer wird in Threads abgewickelt, wodurch nur folgende Dateisysteme verwendet werden können:

• "Root" (/)
• QOpenSys
• User-defined
• QNTC
• QSYS.LIB
• Independent ASP QSYS.LIB
• QOPT
• Network File System
• QFileSvr.400

Betrifft das neue FileTransfer-Protokoll:
Für die Übertragung der Dateien werden die Betriebssystem-Befehle CRTPF und ADDPFM verwendet. Die Parameter von CRTPF können daher direkt bei den Attributen im FileTransfer angegeben werden.
CRTPF wird aufgerufen, wenn die Datei neu erstellt werden soll. ADDPFM wird dann durchgeführt, wenn die Datei schon existiert und nur ein Member hinzugefügt werden soll.
Kommt es bei einem FileTransfer zu einem Fehler, der eine unklare Bedeutung aus AE-Sicht hat (beispielsweise: "CPF0001 - Error found on ADDPFM command"), handelt es sich dabei eventuell um einen Fehler bei der Durchführung dieser Befehle. In diesem Fall finden Sie mehr Informationen im Joblog, welches sich direkt am Betriebssystem befindet.

Angabe von Dateien

QSYS-Dateisystem

Die Syntax für die Übertragung einer QSYS-Datei lautet:

Name der Bibliothek/Dateiname (Membername)

In der Angabe des Datei- oder Membernamens können Sie auch die Wildcardzeichen * und ? verwenden. * - Platzhalter für eine beliebige Anzahl von Zeichen (auch keines), ? - genau ein beliebiges Zeichen

Wenn Sie im Dateinamen Wildcardzeichen nutzen, darf kein Membername angegeben werden!

Detaillierte Informationen zu Wildcards finden Sie im Kapitel Teilqualifizierter FileTransfer.

Beispiel:

Übertragung aller Member der Datei TEST.

AE/TEST(*)
bzw.
AE/TEST()

Übertragung aller Member der Datei TEST deren Name mit dem Buchstaben "A" beginnt.

AE/TEST(A*)

Übertragung aller Member der Datei TEST deren Name 3 Zeichen aufweist und mit "A" beginnt sowie mit "B" endet.

AE/TEST(A?B)

Übertragung des Members ABC der Datei TEST.

AE/TEST(ABC)

Übertragung aller Dateien deren Name mit TEST beginnt.

AE/TEST*

IFS-Dateisystem 

Bei IFS (Integrated Filesystem) handelt es sich um ein UNIX-basiertes Dateisystem. IFS-Dateien sind mit immer mit absolutem Pfad (ausgehend von Root) und anschließendem Dateinamen anzugeben.
Enthält die Datei-Angabe das Zeichen /, so nimmt der Agent an, dass es sich um eine IFS-Datei handelt.

Beispiel:

/home/uc4/test.txt

Um teilqualifizierte FileTransfers durchzuführen, stehen die Wildcardzeichen * und ? zur Verfügung, die beliebig innerhalb des Pfades und/oder Dateinamens verwendet werden können.

Bei Einzel-FileTransfer ist Pfad und Dateiname nicht case-sensitive. Folgende 2 Angaben sind daher identisch:

/home/AbC.txt
/HOME/ABC.txt

Bei Wildcard-FileTransfers ist jedoch auf Klein und Großschreibung zu achten! Folgende 2 Angabe sind somit unterschiedlich:

/home/AB*
/home/ab*

(Eine Ausnahme bildet QOpenSys. Hier ist die Groß- und Kleinschreibung für Wildcard-Dateisystem-Ereignisse nicht relevant.)

Attribute

Für das Ziel des FileTransfers können Sie abhängig vom Dateisystem alle Attribute angeben, die von OS/400 unterstützt werden. Mehrere Attribute sind durch Komma zu trennen. Ungültige Angaben werden ignoriert.

QSYS-Dateisystem

Der OS/400-Agent kann Dateien des Typs *FILE und SAVF übertragen. Andere Dateiarten wie z.B. *PGM, *RPG, *CLLE müssen vor dem Transfer in SAVF Dateien gesammelt werden. 

Die folgenden Punkte sind bei einer SAVF Dateiübertragung zu beachten: 

• Setzen Sie im FileTransfer-Objekt bei der Quelldatei das Attribut reclen=528.
• Wählen Sie sowohl bei der Quell- als auch bei der Zieldatei die Codepage UC_CODE aus.

Für alle anderen Dateien gilt:

• Ist die Ziel-Datei nicht vorhanden, so wird sie erstellt. Dafür wird der CRTPF-Befehl verwendet. Bei den Attributen, welche für das Ziel im FileTransfer angegeben werden können, handelt es sich daher um die Parameter dieses Befehls.
  Werden keine Attribute spezifiziert, so wird die Datei standardmäßig mit einer Recordlänge von 80 Bytes angelegt. Bei Wildcard-FileTransfers wird standardmäßig MAXMBRS(*NOMAX) gesetzt (die Datei besitzt somit kein Member-Limit). Bei Einzel-FileTransfers wird für MAXMBRS der Standardwert des System verwendet.
  
• Existiert die Zieldatei bereits, so können deren Attribute nur überschrieben werden, wenn die Option "Original-Datei-Attribute beibehalten" im FileTransfer-Objekt gesetzt ist. Dafür dient der Befehl CHGPF, dessen Parameter als Ziel-Attribute im FileTransfer-Objekt angegeben werden können.

Durch die Option Original-Datei-Attribute beibehalten im FileTransfer-Objekt werden die Dateiattribute der Quelle für die Zieldatei(en) übernommen. Dies ist jedoch nur möglich wenn Quell- und Ziel-Agent das selbe Betriebsystem (in diesem Fall OS/400) und Automation Engine Version 9.00A (oder höher) aufweisen. Andernfalls wird diese Einstellung ignoriert.

Dabei können folgende Dabei-Attribute übernommen werden:

• ACCPTHSIZ - Access path size
• ALWUPD - Allow update operation (ALWUPD). If on, records are not allowed to be updated in the file (*NO).
• ALWDLT - Allow delete operation (ALWDLT). If on, records are not allowed to be deleted from the file (*NO).
• CCSID - Coded character set ID
• EXPDATE - Expiration date for member
• FRCACCPTH - Force keyed access path
• FRCRATIO - Records to force a write
• LANGID - Language ID
• MAINT - Access path maintenance
• MAXMBRS - Maximum members
• PAGESIZE - Access path logical page size
• RCDLEN - Record length, if no DDS, DDS contains the full record format (Keys, Fields, Relations, etc.)
• REUSEDLT - Reuse deleted records
• SHARE - Share open data path
• SIZE - Member size, Initial number of records, Increment number of records, Maximum increments
• TEXT - Text 'description'

Die Reihenfolge der Parameter spielen dabei keine Rolle.

Beispiele:
In folgendem Fall wird die Datei mit einer Recordlänge von 256 bytes erzeugt und als Beschreibung der Text 'FT File' eingetragen:
RCDLEN(256) TEXT('FT File')

Im zweiten Beispiel wird eine Datei mit maximaler Memberanzahl, ohne Größen-Beschränkung und der Wiederverwendung von gelöschten Records erstellt:
MAXMBRS(*NOMAX) SIZE(*NOMAX) REUSEDLT(*YES)

Zusätzlich ist es möglich den speziellen Parameter TRIM=YES im Feld Attribute der FileTransfer-Quelle zu verwenden. Diese Option ist kein eigentliches Dateiattribut, sondern eine spezielle Funktion von UC4. Sie bewirkt, dass Leerzeichen am Beginn und Ende jeder Zeile der zu übertragenden Dateien automatisch entfernt werden. Diese Option kann nicht im Zusammenhang mit dem IFS-Dateisystem eingesetzt werden.

Zusätzlich ist es möglich den speziellen Parameter TRIM=YES im Feld Attribute der FileTransfer-Quelle zu verwenden. Diese Option ist kein eigentliches Dateiattribut sondern eine spezielle Funktion von AE. Sie bewirkt, dass Leerzeichen am Beginn und Ende jeder Zeile der zu übertragenden Dateien automatisch entfernt werden. Diese Option kann nicht im Zusammenhang mit dem IFS-Dateisystem eingesetzt werden.

IFS-Dateisystem:

Bei IFS Dateien können folgende Attribute angegeben bzw. übernommen werden:

• ccsid - Die CCSID hat Bedeutung für den Inhalt der Datei oder die erweiterten Attribute des Verzeichnisses.
• codepage - Die Codepage, welche über die CCSID ermittelt wird, wird für den Dateiinhalt oder die erweiterten Verzeichnisattribute verwendet.
• readonly - Legt fest, ob die Datei schreibgeschützt angelegt werden soll

In folgendem Beispiel wird wird die Datei mit der Codepage (ccsid) 550 angelegt und besitzt zusätzlich das Attibute READ-ONLY:
ccsid=550, readonly=YES

IFS: Es ist auch für IFS möglich, die Attribute der Original-Datei für die Zieldatei zu übernehmen, falls dies im FileTransfer-Objekt definiert ist. Die Attribute "readonly", "hidden", "system" und "archive" können auch plattformübergreifend für oder von Windows-Dateien übernommen werden. Es ist auch möglich, diese Attribute bei der Angabe der Zieldatei zu übersteuern. Die Attribute "ccsid" und "codepage" sind nur für OS/400-Dateien gültig.

Siehe auch:

Registerkarte FileTransfer