Agent für GCOS8 installieren

In diesem Dokument finden Sie den Ablauf der Hotfix Installation für den GCOS8 Agenten.

Soll der Joboutput in die AE übertragen werden, ist RSM8 notwendig.

Die Dateien des GCOS8-Agenten liegen binär sowie in ASCII-Dateien vor. Sie finden jene im Verzeichnis IMAGE:AGENTS\GCOS8.

Dateiname	Dateityp	Beschreibung
read_me	ascii	Katalog für GCOS8 Agent installieren
ucxjgc8	binär	GCOS8-Agent
ucxjgc8m	binär	Meldeprogramm für den GCOS8-Agenten
UCMSL	ascii	Meldungsbibliothek
ucxjgc8i	ascii	Initialisierungsdatei
cancel.spn uc4 uc4ex uc4exec.dir uc4exec.spn uc4sim uc4term.dir uc4term.spn uc4tm	ascii	JCL für den Start und die Beendigung des Agenten

	1.	Anlegen der erforderlichen Kataloge

Host
Erstellen eines Katalogs für die Installation (UC4/Version).
In diesem werden die folgenden Sub-Kataloge benötigt: DATA, EXEC, INSTALL, JCL, OUT und TMP.

	2.	Übertragen der Dateien zum Host

Admin-Rechner
Übertragen Sie die Dateien mittels FTP oder Glink FTP zum GCOS8-Rechner in die vorgesehenen Sub-Kataloge.

Sub-Katalog	Datei
DATA	UCMSL, UCXJGC8I
EXEC	UCXJGC8, UCXJGC8M
INSTALL	READ_ME
JCL	CANCEL.SPN, UC4, UC4EX, UC4EXEC.DIR, UC4EXEC.SPN, UC4TERM.DIR, UC4TERM.SPN, UC4TM

	3.	Einrichten des Systemumfeldes

Host
Anpassen der INI-Datei an die Systemumgebung.
Wichtig sind hierbei vor allem die Definierung des Agentennamens (maximal 32 Zeichen; keine Sonderzeichen!) und die Vermerkung des Systemnamens. Tragen Sie des Weiteren in der Sektion [TCP/IP] die Adresse des primären Kommunikationsprozesses im Automation Engine System ein, zu dem sich der Agent verbinden soll (Format: cp=DNS-Name:Portnummer bzw. cp=TCP/IP-Adresse:Portnummer).
Entfernen Sie nicht die Traceflags!
Wir empfehlen, den Parameter TRCOPENCLOSE auf "0" zu stellen, um die Performance des Agenten nicht negativ zu beeinflussen.

	4.	Übertragung des Jobreports

Host
Damit der Jobreport in die Automation Engine übertragen werden kann, muss RSM8 installiert sein. Sollte es nicht installiert sein, müssen die folgenden Einstellungen konfiguriert sein, damit die Jobreport-Datei im TMP-Sub-Katalog gespeichert werden kann. Andernfalls kann der Job-Report nicht übertragen werden.

Host
Damit der Jobreport in die Automation Engine übertragen werden kann, wird RSM8 vorausgesetzt. Sollten Sie dieses Programm nicht installiert haben, sind folgende Einstellungen notwendig, da ansonsten die Jobs hängenbleiben.

Setzen Sie in der INI-Datei den Parameter RSM= entweder auf "N" oder "X".
Die INI-Datei muss in der Sektion [VARIABLES] den Parameter UC_EX_PATH_JCL aufweisen. Tragen Sie in diesem den Namen des JCL-Kataloges ein.
Passen Sie anschließend der Datei UC4SIM, die sich im JCL-Katalog befindet, so an, dass sie den Katalog enthält in dem Sie den Agenten installiert haben.

Beachten Sie, dass ohne RSM8 nur Dateien mit dem Jobreport-Namen angelegt werden, die einige Basisinformationen wie z.B. den Jobnamen oder die Sequenznummer enthalten! Mit letzterer können Sie in GCOS den Report einsehen.
Wichtiger Hinweis: Wenn Sie RSM8 einsetzen, darf der Parameter RSM= nicht gesetzt sein!

	5.	Starten des Agenten

$      ident   <site-ident>
$      select &system/profile.prod/uc4
$      select &uc4cat/jcl/uc4exec.spn
$      endjob

Es wird im Systemmandant 0000 ein Agenten-Objekt automatisch angelegt und im Ordner "HOST" gespeichert.

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.

	6.	Beenden des Agenten

$      ident   <site-ident>
$      select &system/profile.prod/uc4
$      select &uc4cat/jcl/uc4term.spn
$      endjob