OS/400 Agent - Befehle

Als Administrator hilft Ihnen dieses Dokument, die Befehle des OS/400-Agenten besser zu verstehen und zu verwenden.

Mit dem Agenten werden zusätzliche Programme und Befehle ausgeliefert. Diese dienen zum einen dazu, den Agenten einfach starten bzw. beenden zu können, ohne vorher eine CL-Routine erstellen zu müssen. Ein Programm zum Generieren der Meldungsbibliothek wird ebenfalls bereitgestellt. Dies ist hilfreich, wenn ein Fehler auftritt.

Wichtig! Sie müssen den neuesten Agent von v9.00A verwenden. Die Bibliothek, die die Programmdateien enthält, muss zur Bibliotheksliste des Systems hinzugefügt worden sein.

Weitere Informationen finden Sie unter Agenten für OS/400 installieren.

Diese Seite beinhaltet Folgendes:

Agent starten

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 die Bibliothek anzugeben, in der sich der Agent befindet. Darüber hinaus muss die INI-Datei des Agenten entweder für das IFS- oder das QSYS-Dateisystem spezifiziert werden. Sie ersetzt die UCEX_RUN-Routine.

Parameter

  • LIB(Bibliothek)
  • MBR(QSYS INI-Datei) oder PATH(IFS-Pfad und INI-Dateiname)

Beispiele

STRUCAGENT LIB(UC4) FILE(UC4/INI) MBR(UCXJO41)

Startet den Agenten aus der UC4-Bibliothek unter Verwendung der INI-Datei UC4/INI(UCXJO41).

STRUCAGENT LIB(UC4) PATH('/user/uc4/ucxjo41.ini')

Startet den Agenten aus der UC4-Bibliothek unter Verwendung der INI-Datei ucxjo41.ini im IFS-Dateipfad /user/uc4/.

Stoppen des Agenten

Ausgelieferte Objekte:

  • Programm: ENDUCAGENT
  • Befehl: ENDUCAGENT

Stoppt den Agenten, der aus einer bestimmten Bibliothek gestartet wurde, entweder kontrolliert oder sofort. Kann anstelle der UCEX_END-Routine verwendet werden.

Parameter

  • LIB(Bibliothek)
  • OPTION(Beendigung)

Beispiele

ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)

Beendet den Agenten, der aus der UC4 Bibliothek gestartet wurde, auf kontrollierte Weise. Durch den Befehl 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 Befehl ENDJOB. Der angegebene Agent wird im System gesucht und sofort beendet.

Generieren der Meldungsbibliothek

Ausgelieferte Objekte:

  • Programm: MAKEMSL
  • Befehl: GENUCMSL

Der Befehl 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. Dieses Verfahren ist für die Installation des Agenten nicht erforderlich, jedoch hilfreich, um die Meldungsbibliothek zu aktualisieren oder zu reparieren (im Fehlerfall).

Parameter

  • PATH(IFS-Pfad und Dateiname)
  • FILE(QSYS Ziel-Datei)

Beispiel

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:

Verarbeitung abgeschlossen.
'34579 ' verarbeitete Zeilen.
'11607' englische Meldungen importiert.
'11607' deutsche Meldungen importiert.