Agent für Windows installieren

Agenten installieren

ServiceManager installieren

---

Agent für z/OS installieren

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

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

Voraussetzungen

• JES2 oder JES3
• TCP/IP V3R2M0 oder höher werden vorausgesetzt
• Die C-Runtimebibliothek ab V1R5M0 wird verwendet
• Eine MSGCLASS ohne nachfolgendes Programm (External-Writer) im HOLD-Status und ein File-Qualifier für temporäre Dateien, Logs und Traces wird benötigt.
• UPDATE-Rechte für JESSPOOL RACF Class (um Job Outputs verarbeiten zu können)

Ausgelieferte Dateien

Die folgenden Dateien sind im Verzeichns IMAGE:AGENTS\MVS\ZSERIES gespeichert:

Die folgenden Dateien sind im Verzeichns IMAGE:AGENTS\MVS\ZSERIES\EXAMPLE gespeichert:

Die Dateien des CallAPI und deren Implementierung werden gesondert beschrieben. 

Load-Module:

• CADSDEL - Ein Dienstprogramm mit dem Sie einen Common Dataspace (CADS), der vom Ereignis-Monitor allokiert wurde, freigeben können.
• UC4END - Endmelder für die SMF-Meldetechnik (schreibt die StepList und gibt Codes an JESMSGLG zurück)
• UC4RESTR - Neustartmelder für die SMF-Meldetechnik (Dummy-Programm, wie z.B. IEFBR14)
• UC4START - Startmelder für die SMF-Meldetechnik (Dummy-Programm, wie z.B. IEFBR14)

Ablauf

	1.	Übertragen der Dateien zum Host

• Host
• Übertragen der entsprechenden Dateien von IMAGE:AGENTS\MVS\ mittels eines Dateitransfers.
  
  openHost
  Verwenden Sie einen FTP-Benutzer mit entsprechenden Rechten
  Benutzername = UC4
  Passwort = <as set>
  bin
  quote site recfm=fb lrecl=80 blksize=6080
  quote site pri=1 sec=1 CY
  put UCXJM25-???.bin 'UC4.UCXJM25.BIN'
  asci
  put UCXJM25.ini 'UC4.UCXJM25.INI'
  quote site recfm=vb lrecl=500 blksize=27998
  put ucx.msl 'UC4.UC.MSL'

	2.	Erstellen der AE Ladebibliothek

• Host
• Die LOAD-Bibliothek mit Hilfe des TSO RECEIVE Utilitys erstellen. Die fettgedruckten Parameter sind systemspezifische Angaben.

  //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 NOPREFIX
    RECEIVE USERID(UC4USER) INDSN('UC4.UCXJM25.BIN')
    DSNAME('UC4.UCXJM25.LOAD') -
    UNIT(3390) VOLUME(??????)
  /*
  
  
  Alternativ ist die Erstellung wie folgt möglich:
  
  Am z/OS Host:
  TSO RECEIVE indsn('UC4.UCXJM25.BIN')
  Enter drücken und die folgende Zeile eingeben:
  dsname('UC4.UCXJM25.LOAD')

	3.	Erstellen des AE Started Task

• Host
• Die STEPLIB-Bibliotheken benötigen APF-Authorisierung.
• 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
  //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=*
  //*

   

• Zusätzlich müssen folgende Dateien in der Linkkette enthalten sein:
  
  CEE.V1R5M0.SCEERUN
  CEE.V1R5M0.SCEELKED
  TCPIP.V3R1.SEZACMTX
  
  Wollen Sie dies nicht in Ihrem System vornehmen, gibt es noch eine andere Möglichkeit. Sie können die AE LOAD-Bibliothek nicht nur in der STEPLIB eintragen, sondern auch in der C-Umgebungs DD-Karte EDCMTF. Nähere Informationen finden Sie in der IBM-Dokumentation unter dem STEPLIB DD Statement.
   
• Nehmen Sie unbedingt den folgenden Schritt vor, wenn der MVS oder der Language Environment Resolver nicht korrekt funktionieren:
  
  Die DD-Statements für TCP/IP müssen in die Started Task mit aufgenommen werden. Ansonsten kann der Agent keine TCP/IP-Verbindung herstellen.
  
  Beispiel:
  //SYSTCPD DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20OEDA),DISP=SHR
  //PROFILE DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20VIPA),DISP=SHR
  
  Die exakten Statements finden Sie in dem Started-Task des TCP/IP's selbst.
  Die DD-Statements für TCP/IP müssen auch in das Include-Objekt MVS.JOBMD_DEFINITIONS aufgenommen werden, da sonst der Jobmelder keine TCP/IP-Verbindung öffnen kann und die Jobs in den Status ENDED_VANISHED gehen.
   
• Kopieren dieser Prozedur 'UC4RUN' in eine Prozedur-Bibliothek, zum Beispiel 'SYS1.PROCLIB'.
   
• Notwendige Berechtigungen für den STC-User im RACF:
   
• OMVS-Segment
• ALTER-Berechtigung auf eigene Datasets (z.B.: UC4.*)
• Der Started-Task benötigt die Berechtigung JES-Listen auszulesen

 

• Erzeugen der Datasets für den StatusStore
  
  Beispiel:
  
  //CREATESS 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(16 0) -
     RECORDSIZE(256 4096) -
     FREESPACE(10 10) -
     ) -
    INDEX ( -
    NAME(UC4.UCXJM25.SSTORE.INDEX) -
    )
  //* Dummy Record laden
  //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
  /*

 

	4.	Einrichten des Systemumfeldes

• Host
• Falls in den aktuellen Release Notes darauf hingewiesen wurde, passen Sie die INI-Datei an. Vergleichen Sie bitte mit der INI-Datei UCXJ???.ORI.INI, die mit der Update-Installation ausgeliefert wird.Die INI-Datei darf nicht das Dateiattribut NUMBER ON verwenden.

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