OS/400-Agent - FileTransfer-Unterstützung

OS/400

PeopleSoft

---

Agent - Kommandos

Mit dem Agenten werden zusätzliche Programme und Kommandos ausgeliefert. Diese dienen zu einem dazu, den Agenten einfach starten bzw. beenden zu können, ohne vorher eine CL-Routine erstellen zu müssen. Zum anderen wird ein Programm für die Generierung der Meldungsbibliothek bereitgestellt, welches im Fehlerfall hilfreich ist.

Voraussetzung ist, dass der neueste Agent der Version 9.00A verwendet wird und die Bibliothek, in der sich die Programmdateien befinden, in die Library-List des Systems aufgenommen wurde. Siehe: Installationsanleitung des OS/400-Agenten.

Starten des Agenten

Ausgelieferte Objekte:
Programm: STRUCAGENT
Befehl: STRUCAGENT

Kommando für den Start eines beliebigen AE-Agenten, ohne dafür eine CL-Routine erstellen zu müssen. Dabei ist dabei die Bibliothek anzugeben, in der sich der Agent befindet. Weiters ist die INI-Datei des Agenten entweder für das IFS- oder das QSYS-Dateisystem zu spezifizieren. Ersetzt die UCEX_RUN Routine.

Parameter:
LIB(Bibliothek)
MBR(QSYS INI-Datei) oder PATH(IFS-Pfad und Name der INI-Datei)

Beispiele:

STRUCAGENT LIB(UC4) FILE(UC4/INI) MBR(UCXJO41)
Agent aus der Bibliothek UC4 unter Verwendung der INI-Datei UC4/INI(UCXJO41) starten.

STRUCAGENT LIB(UC4) PATH('/user/uc4/ucxjo41.ini')
Agent der Bibliothek UC4 starten, wobei die INI-Datei ucxjo41.ini verwendet wird, die im IFS-Dateipfad /user/uc4/ zu finden ist.

Agent beenden

Ausgelieferte Objekte:
Programm: ENDUCAGENT
Befehl: ENDUCAGENT

Agent, der aus einer bestimmten Bibliothek gestartet wurde, entweder kontrolliert oder sofort beenden. Kann anstelle der UCEX_END Routine verwendet werden.

Parameter:
LIB(Bibliothek)
OPTION(Ende)

Beispiele:

ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)
Agent, der aus der Bibliothek UC4 gestartet wurde, kontrolliert beenden. Durch das Kommando wird dem Agenten ein Ende-Signal geschickt, welches demnächst bearbeitet wird.

ENDUCAGENT LIB(UC4) OPTION(*IMMED)
Agent, der aus der Bibliothek UC4 gestartet wurde, abbrechen. Entspricht dem ENDJOB-Kommando. Der angegebene Agent wird im System gesucht und sofort beendet.

Generieren der Meldungsbibliothek

Ausgelieferte Objekte:
Programm: MAKEMSL
Befehl: GENUCMSL

Das Kommando GENUCMSL dient dazu, eine MSL-Datei, die im IFS-Dateisystem abgelegt ist, in eine physische Meldungsbibliothek umzuwandeln. Die generierte Meldungsbibliothek kann danach vom Agenten verwendet werden. Diese Prozedur ist für die Installation des Agenten nicht erforderlich, jedoch hilfreich, um die Meldungsbibliothek zu aktualisieren oder zu reparieren (im Fehlerfall).

Parameter:
PATH(IFS-Pfadund Dateiname)
FILE(QSYS Ziel-Datei)

Beispiele:

GENUCMSL PATH('/tmp/uc.msl') FILE(UC4/MSL)

Wandelt die Datei uc.msl, welche sich im IFS-Pfad '/tmp/' befindet, in die Datei UC4/MSL um. Ausgegeben wird die Anzahl der importierten Meldungssätze:

Processing completed.
Lines processed '34579'.
Imported '11607' english messages.
Imported '11607' german messages.