Agent für NSK installieren

Agenten installieren

Agent für PeopleSoft installieren

---

Agent für OS/400 installieren

In diesem Dokument finden Sie den Ablauf der Hotfix Installation für den OS/400 Agenten.

Für die unterstützte OS/400-Variante wurde ein dreistelliges Kürzel vergeben. Dieses kommt im Dateinamen des Agenten vor und ist in der Terminologie beschrieben (O41 für OS/400 ab Version V4R1M0).

Beenden Sie unbedingt den Agenten bevor Sie die Update-Installation beginnen!

Voraussetzungen

• TCP/IP

Ausgelieferte Dateien

Der OS/400-Agent wird als binäres SavFile ausgeliefert. Sie finden die Datei im Unterverzeichnis von IMAGE:AGENTS\AS400.

Die Dateien des CallAPI und dessen Implementierung werden gesondert beschrieben.

Ablauf

	1.	Übertragen der Datei zum Host

• Host
• Temporäre Bibliothek für Save-File anlegen:

  CRTLIB LIB(UC4TMP)

• Leeres Save-File anlegen.

  CRTSAVF FILE(UC4TMP/UC4)

• Bibliothek für das Wiederherstellen des Save-Files anlegen.

  CRTLIB LIB(UC4AUSL) TYPE(*PROD) TEXT('Automation Engine version 11.0.0')

• Admin-Rechner
• Über FTP an AS/400 anmelden und UCXJO41.bin zur Save File UC4, UC4TMP-Bibliothek, übertragen.
  Beispiel für FTP über die Eingabeaufforderung von Windows:

  ftp <MY.AS400>
  <USER>
  <PASSWORD>
  cd UC4TMP
  bin
  put UCXJO41.bin UC4
  Beenden

	2.	Erstellen der AE-Bibliothek

• Host
• Bibliothek erstellen.

  RSTOBJ OBJ(*ALL) SAVLIB(UC4AUSL) DEV(*SAVF) SAVF(UC4TMP/UC4)

• Temporäre Bibliothek löschen.

  DLTLIB LIB(UC4TMP)

• AE-Bibliothek umbenennen.

  RNMOBJ OBJ(QSYS/UC4AUSL) OBJTYPE(*LIB) NEWOBJ(UC4)

	3.	Einrichten des Systemumfeldes

• Host
  Automation Engine System muss laufen.
  
• Host
  INI-Datei UC4/INI(UCXJO41) anpassen.

• Admin-Rechner oder Benutzer-Rechner
  Eventuell HEADER.OS400, TRAILER.OS400 und RESTART.OS400 anpassen. Siehe:Job - Ausführen.

Anschließend gibt es 2 unterschiedliche Varianten, um den Agenten zu starten. Variante 1 erfordert die Erstellung einer CL-Routine pro zu startenden Agenten und ist daher aufwendiger. Bei Variante 2 wird der Agent über eigene ausgelieferte Programme gestartet / beendet.

Variante 1

	4.	Erstellen des Start- und Ende-Programms

• Host
• Im ausgelieferten File Member CLLE existieren die CL-Beispielprogramme zum Starten und Beenden des Agenten. Diese müssen an die Installation und das Betriebssystem angepasst werden bevor Sie diese kompilieren.

  UC4/CLLE(UCEX_RUN) - Starten des Agenten
  UC4/CLLE(UCEX_END) - Beenden des Agenten

	5.	Starten / Beenden des Agenten

• Host
• Durch das Programm UCEX_RUN kann der Agent gestartet werden.
  Es wird im Systemmandant 0000 ein Agenten-Objekt automatisch angelegt und im Ordner "HOST" gespeichert.
• Durch das Programm UCEX_END kann der Agent geordnet beendet werden
• Admin-Rechner oder Server-Rechner
• Prüfen, ob sich der Agent angemeldet hat.
  • UserInterface für Mandant 0000 starten. In der Systemübersicht die Informationen über Agenten abrufen. Da ein neu angemeldeter Agent noch keinem Mandanten zugewiesen ist, wird er nur im Mandant "0000" sichtbar. Der neu installierte Agent kann nun über das Agenten-Objekt den Mandanten mit den gewünschten Rechten zugewiesen werden.

Variante 2

	4.	Aufnehmen der Bibliothek in die Library-List

• Host
• Die Bibliothek (UC4), wo sich die Programme (Agent, CallAPI,...) befinden, muss in die Library-List aufgenommen werden. Dies ist mit einem der folgenden Befehlen möglich:

  ADDLIBLE UC4
  Bibliothek zur Library-List hinzufügen
  
  oder:
  CHGCURLIB UC4
  Aktuelle Bibliothek für den Job auf UC4 ändern

	5.	Starten / Beenden des Agenten

• Host

• Starten Sie den Agenten über den Befehl STRUCAGENT.
  Folgende Beispiele verdeutlichen den Start des Agenten:
  
  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 aus Bibliothek starten, wobei eine INI-Datei angegeben wird, die im IFS-Dateisystem liegt.
  
  

• Der Befehl ENDUCAGENT beendet den Agenten.
  
  ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)
  Agent, der aus der Bibliothek UC4 gestartet wurde, kontrolliert beenden.
  
  ENDUCAGENT LIB(UC4) OPTION(*IMMED)
  Agent, der aus der Bibliothek gestartet wurde, mit ENDJOB beenden.

• Weitere Informationen zu Kommandos finden Sie in der KnowledgeBase.