Administration Guide > Installation > Service Pack and Hotfix Installation > Installing the Agent for z/OS

Installing the Agent for z/OS

This document describes the hotfix installation procedure for the z/OS agent.

It is important to ensure that the agent is closed before you start the update installation.

Requirements

JES2 or JES3
TCP/IP V3R2M0 or later
C runtime library version V1R5M0 or later
An MSGCLASS in HOLD status that does not call a subsequent program (external writer)
UPDATE access for JESSPOOL RACF Class (in order to process Job outputs)

Supplied Files

The files are stored in the directory IMAGE:AGENTS\MVS.

The CallAPI files and their implementation are described in a separate document.

Load Module:

CADSDEL - A utility that can be used to release a Common Dataspace (CADS) allocated by the Event Monitor.
UC4END - End messenger for the SMF messenger technique (it writes the StepList and return codes to the JESMSGLG)
UC4RESTR - Restart messenger for the SMF messenger technique (dummy program such as IEFBR14)
UC4START - Start messenger for the SMF messenger technique (dummy program such as IEFBR14)

Procedure

	1.	Transferring the files to the host

Host
Transfer the appropriate files from IMAGE:AGENTS\MVS\ by file transfer.

openHost
Use an FTP user with the appropriate rights
User name = UC4
Password = <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.	Creating the Load Library

Host
Create the LOAD library using the utility TSO RECEIVE. Parameters shown in bold are system-specific specifications.
//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(??????)
/*

Alternately, it can be created as follows:

On the z/OS host:
TSO RECEIVE indsn('UC4.UCXJM25.BIN')
Press Enter and tpye the following line:
dsname('UC4.UCXJM25.LOAD')

	3.	Creating the AE Started Task

Host
STEPLIB libraries require APF authorization.
Example for a started task:
//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=*
//*
The following files must also be in included in the link chain:

CEE.V1R5M0.SCEERUN
CEE.V1R5M0.SCEELKED
TCPIP.V3R1.SEZACMTX

There is an alternative solution if you do not want to configure your system as described above. You can specify the AE LOAD library in the STEPLIB, but also in the C-environment's DD card EDCMTF. Further information is available in the IBM documentation - STEPLIB DD statement.
Apply the following step if either the MVS or Language Environment Resolver does not work correctly:

The DD statements for TCP/IP must be included in the started t so that the agent can establish a TCP/IP connection.

Example:
//SYSTCPD DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20OEDA),DISP=SHR
//PROFILE DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20VIPA),DISP=SHR

The exact statements are found in the TCP/IP's started task.
The DD statements for TCP/IP must also be included in the Include object MVS.JOBMD_DEFINITIONS . Otherwise, the Job Messenger cannot open a TCP/IP connection and the jobs change to status ENDED_VANISHED.
Copy the procedure 'UC4RUN' into a procedure library such as 'SYS1.PROCLIB'.
Required authorizations for the STC user in RACF:

OMVS segment
ALTER authorization for own datasets (e.g.: UC4.*)
The started task requires the appropriate authorization to read JES lists

Generate the datasets for the StatusStore

Example:

//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) -
  )
//* 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
/*

	4.	Setting up the system environment

Host
If recommended by the current Release Notes, adjust the INI file. Also refer to the INI file UCXJ???.ORI.INI which is supplied with the update installation. The INI file must not use the file attribute NUMBER ON.

Admin computer or user computer
Adjust HEADER.MVS, TRAILER.MVS and RESTART.MVS where necessary. See: Job - Execution.