Agenten für z/OS installieren
Diese Seite führt Sie durch die Installation eines z/OS-Agenten in einem Automation Engine-System, in dem die Authentifizierung nicht verwendet wird. Weitere Installationsschritte sind erforderlich, bevor der Agent gestartet und verwendet werden kann, wenn Sie eine der verfügbaren Authentifizierungsmethoden verwenden möchten. Weitere Informationen finden Sie unter Agenten-Authentifizierung.
Diese Seite beinhaltet Folgendes:
Übersicht
Der Agent wird in einem SYSPLEX gestartet und jede LPAR muss einen Ereignis-Monitor ausführen. Der Agent ist für die Kommunikation mit der Automation Engine verantwortlich, übernimmt den FileTransfer und verfügt über eine Verbindung zu allen Ereignis-Monitoren. Wenn es ein LPAR-Problem gibt, können Sie den Agent auf einer anderen LPAR starten (beispielsweise automatisch mit WLM-Regeln), und alle Ereignisüberwachungen verbinden sich erneut direkt mit dem Agent.
Der Ereignismonitor überwacht Job-, CONS- und FILE-Ereignisse und leitet sie über den Agenten an die Automation Engine weiter.
Voraussetzungen
Die folgenden Anforderungen müssen erfüllt sein:
- JES2 oder JES3
- TCP/IP V3R2M0 oder höher
- APF-Berechtigung für die Ladebibliothek
- C-Laufzeitbibliothek Version V1R5M0 oder höher
- Eine MSGCLASS im Status ANGEHALTEN, die kein Folgeprogramm (externer Writer) aufruft
- UPDATE-Zugriff für die Klasse JESSPOOL RACF (zur Verarbeitung von Job-Outputs)
- Ein Dateiqualifizierer für temporäre Dateien, Logs und Traces
SMP/E
In diesem Abschnitt wird eine normale z/OS-Agent-Installation beschrieben. Die SMP/E-Installation muss vom z/OS-Softwarewartungsteam durchgeführt werden.
Sie können das SMP/E von IBM verwenden, um den z/OS-Agenten, die CallAPI, den External Job Monitor und den Ereignis-Monitor zu installieren und zu warten. Der z/OS-Agent wird auch im Sysmod-Format bereitgestellt.
Weitere Informationen zu CallAPI-Dateien und deren Implementierung finden Sie unter CallAPI für z/OS.
Load-Module
- CADSDEL: Dienstprogramm, das verwendet werden kann, um einen vom Ereignis-Monitor zugewiesenen gemeinsamen Datenraum (CADS) freizugeben
- UC4END: End-Messenger für die SMF-Messenger-Technik (schreibt die StepList und Rückgabewerte in das JESMSGLG)
- UC4RESTR: Neustart-Messenger für die SMF-Messenger-Technik (Dummy-Programm wie IEFBR14)
- UC4START: Start-Messenger für die SMF-Messenger-Technik (Dummy-Programm wie IEFBR14)
Eine Verbindung zur Automation Engine herstellen
Wichtig! Die Automation Engine verwendet TLS/SSL, um nur mit den Windows-, UNIX- und Java-Agenten zu kommunizieren. Dieser Agent ist kein TLS-/SSL-Agent und stellt deshalb eine Verbindung zu einem Kommunikationsprozess (CP) her und verwendet eine andere als die TLS-/SSL-Verschlüsselung. Die Kommunikation zwischen einem TLS/SSL- und einem Nicht-TLS/SSL-Agenten kann unter Verwendung des TLS Gatewayhergestellt werden.
Mehr Informationen:
Andere als TLS/SSL-Agenten stellen bei Verwendung für die Automic Automation Kubernetes Edition eine Verbindung zu einem TCP-Load Balancer her, der für den Agenten erreichbar sein muss. Die Adresse des Load Balancers muss auf beiden Seiten definiert werden: Automation Engine und Agent.
Wichtig! Wenn Sie Agenten für ein Automic Automation Kubernetes Edition-System manuell installieren oder aktualisieren, müssen Sie sicherstellen, dass Sie Ihre Agenten und/oder das TLS Gateway konfigurieren, um den TCP- oder HTTPS-Load Balancer zu erreichen, und nicht direkt den CP oder JCP. Stellen Sie außerdem sicher, dass ihr HTTPS-Load Balancer die erforderlichen Zertifikate besitzt. Weitere Informationen finden Sie unter Eine Verbindung zum AAKE-Cluster herstellen.
Agenten für z/OS installieren
-
Übertragen Sie die Dateien auf den Host. Verwenden Sie auf dem Host einen FileTransfer, um die relevanten Dateien aus IMAGE:AGENTS\MVS\ zu verschieben.
Öffnen Sie den Host und verwenden Sie einen FTP-Benutzer mit den entsprechenden Rechten. Stellen Sie sicher, dass Sie die Dateien richtig übertragen.
-
Benutzername = UC4
-
Password: <wie definiert>
UNIX-Beispiel
bin quote site recfm=fb lrecl=80 blksize=6080 quote site pri=1 sec=1 CY put UCXJM25-???.bin 'UC4.UCXJX.WORK' ascii quote site lrecl=500 blksize=27500 put UCXJM25.ini 'UC4.UCXJM25.INI' put UCXEM25.ini 'UC4.UCXEM25.INI' quote site recfm=vb lrecl=500 blksize=27998 put ucx.msl 'UC4.UC.MSL' quit
Hinweis: Die Dateien ucx.msl und INI werden im LF EOL-Format (UNIX/Linux-Codierung) bereitgestellt. Einige FTP-Clients unter Windows erfordern jedoch das CRLF EOL-Format. Um sicherzustellen, dass Sie das richtige EOL-Format für Windows verwenden, können Sie z. B. einen Dateieditor verwenden, um LF in CRLF zu ändern oder die entsprechende Funktion Ihres FTP-Clients zu verwenden.
-
-
Erstellen Sie die Ladebibliothek mit dem Dienstprogramm TSO RECEIVE. Die fett ausgezeichneten Parameter sind systemspezifisch.
//UC4LOAD JOB (ACCT#),'UC4USER', //CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=UC4USER //************************************************* //STEP01 EXEC PGM=IKJEFT01,DYNAMNBR=30 //SYSPRINT DD SYSOUT=* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD * PROFILE NOPREFIXRECEIVE USERID(UC4USER)INDSN ('UC4.UCXJX.WORK') DSNAME ('UC4.UCXJM25.LOAD') - RECEIVE USERID (UC4USER) INDSN('MYDSN.UCXJ.WORK') DSNAME ('UC4.UCXJM25.LOAD') - UNIT(3390) VOLUME (??????) /*Optional können Sie die Ladebibliothek auf dem z/OS-Host auch wie folgt erstellen:
TSO RECEIVE indsn('UC4.UCXJX.WORK'), drücken Sie die Eingabetaste und geben Sie ein: dsname('UC4.UCXJM25.LOAD').
-
Sie müssen eine APF-Berechtigung für die Ladebibliothek haben. Sie muss zugewiesen werden oder kann dynamisch zur Systemkonsole hinzugefügt werden. Verwenden Sie dazu den folgenden Befehl auf dem Host:
SETPROG APF,ADD,DSN=UC4.UCXJM25.LOAD, [SMS] [VOLUME=xxx]
-
Erstellen Sie die gestartete Aufgabe für den Agenten.
-
Benutzer-, Gruppen- und Datensatzprofile
Der Benutzer, unter dem der Agent läuft, benötigt die relevanten Rechte für Datensätze über die Benutzer- oder Gruppendefinition. Sie können die Datensatzprofile verwenden, um die jeweiligen Rechte zu zuweisen. Der AE-Datensatz-Qualifizierer erfordert Änderungsrechte.
Hinweis: Für den Agenten sind Rechte für alle Datensätze erforderlich.
-
OMVS-Segment (TCP/IP-Berechtigung)
Stellen Sie sicher, dass die OMVS-Rechte in der Benutzer- und Standardgruppe angegeben sind.
-
Allgemeine Ressource
In der Regel gibt es eine allgemeine Ressource für gestartete Aufgaben (STC). Sie können hier allgemeine Rechte zuweisen, damit das Agent-Programm als STC ausgeführt werden kann. Sie können auch den Benutzer definieren, der für die Ausführung des Agenten verwendet werden soll (STDATA).
-
Erforderliche und empfohlene RACF-Einstellungen
Die folgenden RACF-Einstellungen sind erforderlich, wenn das USS-Dateisystem verwendet wird:
-
FACILITY-Klasse BPX.DAEMON Profil mit UACC(READ)
-
PROGRAM class * profile, MEMBER(loadlib//NOPADCHK)
Die folgenden RACF-Einstellungen werden empfohlen, um den Parameter ft_thread_level_security= der INI-Datei des z/OS-Agenten zu verwenden (siehe Agent z/OS).
Der Agentenbenutzer benötigt:
-
OMVS-Segment
-
FACILITY BPX.DAEMON FACILITY-Klassenressource mit Lesezugriff
-
FACILITY BPX.SERVER FACILITY-Klassenressource mit Lesezugriff
-
FACILITY BPX.WLMSERVER FACILITY-Klassenressource mit Lesezugriff
-
SUPERUSER.FILESYS.CHOWN UNXPRIV-Klassenressource mit Lesezugriff
-
BPX.SRV.loginUid SURROGAT-Klassenressource mit Lesezugriff für alle Logins
Der Login-Benutzer benötigt:
-
OMVS-Segment
-
OMVSAPPL APPL-Klassenressource mit Lesezugriff
-
BPX.SRV.loginUid SURROGAT-Klassenressource, wobei der Agenten-Benutzer Lesezugriff hat (wie oben angegeben)
Beispiel für eine gestartete Aufgabe
//UC4RUN PROC //UCEX EXEC PGM=UCXJM25,PARM='TRAP(OFF),HEAP(4M,4M,ANY,FREE)/UC4.UCXJM25.INI', //REGION=4M,TIME=1440 //STEPLIB DD DISP=SHR,DSN=UC4.UCXJM25.LOAD //SSTORE DD DISP=SHR,DSN=UC4.UCXJM25.SSTORE //SYSPRINT DD SYSOUT=* //STDOUT DD SYSOUT=* //SYSCPRT DD SYSOUT=* //JOBOUT DD SYSOUT=(A,INTRDR) //SYSUDUMP DD SYSOUT=* //*
-
-
Erteilen Sie gestarteten Aufgaben das Recht, JES-Listen zu lesen.
-
Nehmen Sie die folgenden Dateien in die Link-Kette auf:
-
CEE.V1R5M0.SCEERUN: Dynamische Laufzeitbibliothek der Sprachumgebung
-
CEE.V1R5M0.SCEELKED: Linkage-Editor-Bibliothek der Sprachumgebung
-
TCPIP.V3R1.SEZACMTX: TCP/IP-Laufzeitbibliothek
Wichtig! Wenn Sie Ihr System nicht wie beschrieben beeinträchtigen möchten, können Sie die LOAD-Bibliothek in der STEPLIB, aber auch in der DD-Karte EDCMTF der C-Umgebung angeben. Weitere Informationen finden Sie unter der STEPLIB DD-Anweisung in der IBM-Dokumentation.
-
-
Wenn das MVS oder der Language Environment Resolver nicht richtig funktionieren, stellen Sie sicher, dass die DD-Anweisungen in der gestarteten Aufgabe enthalten sind. Andernfalls kann der Agent keine TCP/IP-Verbindung aufbauen.
Beispiel
//SYSTCPD DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20OEDA),DISP=SHR //PROFILE DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20VIPA),DISP=SHR
Vollständige Anweisungen finden Sie im TCP/IP der gestarteten Aufgabe.
Wichtig! Die DD-Anweisungen für TCP/IP müssen auch in das Include-Objekt eingebunden werden. Andernfalls kann der Job Messenger keine TCP/IP-Verbindung öffnen und die Jobs erhalten den Status ENDED_VANISHED.
-
Kopieren Sie den Ablauf UC4RUN in eine Ablaufbibliothek wie SYS1.PROCLIB.
-
Die folgenden Berechtigungen sind für den STC-Benutzer in RACF erforderlich:
-
OMVS-Segment
-
ALTER-Berechtigung für eigene Datensätze (z. B. UC4.*)
-
Gestartete Aufgaben benötigen die entsprechende Berechtigung zum Lesen von JES-Listen.
-
-
Generieren Sie die Datensätze für den Status Store.
Beispiel
/CREATES EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE - CLUSTER ( - NAME(UC4.UCXJM25.SSTORE) - INDEXED - VOLUMES(volume) - CYLINDERS(10 5) - ) - DATA ( - NAME(UC4.UCXJM25.SSTORE.DATA) - KEYS(20 0) - RECORDSIZE(256 4096) - FREESPACE(10 10) - ) - INDEX ( - NAME(UC4.UCXJM25.SSTORE.INDEX) - ) //* Load a dummy record //DUMMYREC EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //OUT1 DD DISP=SHR,DSN=UC4.UCXJM25.SSTORE //SYSIN DD * REPRO INFILE(IN1) OFILE(OUT1) /* //IN1 DD * DUMMY /*
Übertragungsinformationen für jeden Datensatz und/oder jede Datei werden als Datensatz im VSAM-Datensatz gespeichert. Die Größe des Informationsdatensatzes variiert je nach Größe des Datensatzes und der Dateigröße. Eine durchschnittliche Größe sind 260 Byte. Die vorgeschlagenen Speicherwerte sind 10,5 Zylinder = (10 + 15 * 5) * 849.960 Bytes ~ 75,553 Kilobyte, was für ca. 282k Transfereinträge ausreichen sollte.
-
-
Der Agent läuft auf dem Host als gestartete Aufgabe. Die mitgelieferten Dateien enthalten ein JCL-Beispiel. Kopieren Sie diese JCL in eine Ablaufbibliothek und geben Sie den Namen für die INI-Datei und die Ladebibliothek an.
-
Einrichten der Systemumgebung im Host:
-
Passen Sie die INI-Datei entsprechend an. Sie darf das Dateiattribut NUMBER ON nicht verwenden, siehe Agent z/OS
-
Passen Sie HEADER.MVS, TRAILER.MVS und RESTART.MVS wie erforderlich an, siehe Jobs ausführen.
-
-
Starten Sie den Agenten:
-
Stellen Sie sicher, dass die Automation Engine auf dem Servercomputer läuft, siehe Multi-Server-Vorgänge.
-
Verwenden Sie auf dem Host start UC4RUN über die Systemkonsole. Ein Agentenobjekt wird automatisch im Systemmandanten 0 angelegt und im Ordner HOST gespeichert.
-
Stellen Sie auf dem Administrator- oder Servercomputer sicher, dass der Agent bei der Automation Engine angemeldet ist.
Neu eingeloggte Agenten werden einem Mandanten nicht automatisch zugewiesen und können nur in Mandant 0 angezeigt werden. Sobald Sie sich bei Mandant 0 eingeloggt haben, greifen Sie auf die Administration-Perspektive zu und wählen Sie Agenten und Gruppen aus.
Sie können den neuen Agenten nun über die Agentenobjektdefinition Mandanten mit den erforderlichen Rechten zuordnen. Weitere Informationen finden Sie auf der Seite Seite "Berechtigungen".
-
-
Beenden Sie auf dem Host die gestartete Aufgabe des Agenten über die Systemkonsole mit einem MODIFY-Befehl, wie beispielsweise modify UC4RUN,end. Alternativ können Sie auch den STOP-Befehl stop UC4RUN verwenden. Um den Agenten und alle verbundenen Ereignisüberwachungen anzuhalten, können Sie den MODIFY-Befehl UC4RUN,shutdown verwenden.
-
Erstellen Sie die von der gestarteten Aufgabe für den Ereignis-Monitor.
-
Passen Sie die INI-Datei der Ereignisüberwachung an, siehe z/OS Event Monitor.
-
Erstellen Sie einen separaten INI-Datensatz für jede LPAR UC4.UCXEM25.INI -> UC4.UCXEM25.INI.SYSID.
-
Erstellen Sie die von der Automation Engine gestarteten Aufgabe für den Ereignis-Monitor.
Beispiel
//UC4EMRUN PROC //EVENTM EXEC PGM=UCXEM25,REGION=0M, // PARM='TRAP(OFF),HEAP(4M,4M,ANY,FREE)/UC4.UCXEM25.INI.&SYSNAME' //STEPLIB DD DISP=SHR,DSN=UC4.UCXJM25.LOAD //SYSPRINT DD SYSOUT=* //UCEVENT DD DISP=SHR,DSN=UC4.UCEVENT.VSAM.&SYSNAME
-
Erstellen Sie den UCEVENT-Datensatz für jedes LPAR.
Beispiel
//CRTEMDS JOB ####,'XXX',NOTIFY=&SYSUID,MSGLEVEL=(1,1) //* Create Data sets for UC4 EventMonitor //*. ----------------------------------- //UCEVENT EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE - CLUSTER ( - NAME(UC4.UCEVENT.VSAM.SYSNAME) - INDEXED - VOLUMES(volume) - TRACKS(1 1) - ) - DATA ( - NAME(UC4.UCEVENT.VSAM.DATA.SYSNAME) - KEYS(20 0) - RECORDSIZE(1024 1024) - FREESPACE(10 5) - ) - INDEX ( - NAME(UC4.UCEVENT.VSAM.INDEX.SYSNAME) - ) /* //* ----------------------------------- //INITVSAM EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //OUT1 DD DISP=SHR,DSN=UC4.UCEVENT.VSAM.SYSNAME //SYSIN DD * REPRO INFILE(IN1) OFILE(OUT1) //IN1 DD * DUMMY /* -
Verwenden Sie den Befehl start UC4EMRUN, um den Ereignis-Monitor zu starten.
-
Verwenden Sie den MODIFY-Befehl UC4EMRUN,end,, um den Event-Monitor zu beenden. In diesem Fall wird STC angehalten, während der SMF-Exit aktiv bleibt. Wenn der Ereignis-Monitor erneut gestartet wird, werden alle verpassten SMF-Datensätze verarbeitet. Sie können auch die MODIFY-Befehle UC4EMRUN,shutdown oder UC4EMRUN,end verwenden. In diesem Fall werden STC und SMF angehalten.
Hinweise
- Wenn die MVS Extended Console geschützt ist, ist für die Ausführung des Ereignis-Monitors die RACF-Berechtigung READ erforderlich.
- Falls der Agent von einer früheren Version aktualisiert wurde, empfehlen wir die Neuinitialisierung der UCEVENT- und Filter-Datasets.
-
Siehe auch: