Agent für NSK installieren

Agenten installieren

Agent für PeopleSoft installieren

---

Agent für OS/400 installieren

Hier finden Sie eine Anleitung für die Neuinstallation eines OS/400 Agenten.

Die folgende Anleitung beschreibt die Installation des Agenten in einem Automation Engine System, das keine Authentifizierung einsetzt.

Wenn Sie eine der Authentifizierungsmethoden nutzen möchten, sind noch zusätzliche Schritte nötig, bevor Sie den Agenten starten und einsetzen können. Lesen Sie näheres im Dokument zur Advanced Security.

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.

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('UC4')

• Admin-Rechner
• Über FTP an die AS/400 anmelden und UCXJO41.bin in das Save-File "UC4" Bibliothek "UC4TMP" ü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

• Server-Rechner
• 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.