This document guides you through the new installation of a z/OS agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host.
The following guide describes how to install an agent in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. More detailed information is provided in the document Advanced Security.
The following files are available in the directory IMAGE:AGENTS\MVS.
File name AE CD | Description | File name z/OS |
---|---|---|
UCXJM25-IBM.BIN | z/OS agent Created using the TSO TRANSFER utility. |
UC4.UCXJM25.LOAD |
UCXJM25.INI | INI file of the z/OS agent. | UC4.UCXJM25.INI |
UCXEM25.INI |
INI file of the Event Monitor. |
UC4.UCXEM25.INI |
UCX.MSL |
Message Library. |
UC4.UC.MSL |
STC25.TXT |
JCL for the started taskAn executable object that is running. Tasks are also referred to as activities.. |
|
UC4JCLE.ASM |
Sample module for the JCL Exit. |
|
UC4EJM.INI | INI file of the external Job Monitor. |
The CallAPI files and their implementation are described in a separate document.
![]() |
1. | Transferring files to the hostComputer, target system. |
---|
![]() |
2. | Creating the Load Library |
---|
//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('MYDSN.UCXJ.WORK')
DSNAME('UC4.UCXJM25.LOAD')
-
UNIT(3390) VOLUME(??????)
/*
Alternately, you can create it as follows:
On the z/OS host:
TSO RECEIVE indsn('MYDSN.UCXJ.WORK')
Press Enter and type the following line:
dsname('UC4.UCXJM25.LOAD')
![]() |
3. | APF authorization for the Load Library |
---|
SETPROG APF,ADD,DSN=UC4.UCXJM25.LOAD, [SMS] [VOLUME=xxx]
![]() |
4. | Creating the Started Task for the Agent |
---|
Use the STC user or any other user to start the AE jobs and/or file transfers.
Using the STC user for the complete execution:
The STC user requires access to all z/OS resources that are used in jobs and file transfers. This user must also be specified in the appropriate Login objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task. Users without a passwordA secret combination of characters for a Automation Engine user. (batch users) must be specified in the Login object with no password being indicated. The parameter askRACF in the agent's INI file must be set to "0" or "4" in order to deactivate the password verification.
Using different users:
An appropriate OMVS segment must be defined for all users in addition to the required resources in order to establish a TCP/IP connection to the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes.. Specify the relevant Login object in the jobAn Automation Engine object type for a process that runs on a target system. attributes. If a batch user (user without a password) is used for the execution, the STC user requires a surrogate authorization for this particular user. In this case, specify the required user in the Login object without defining a password and deactivate the password verification (set the parameter ask RACF in the agent's INI file to "0" or "4" ).
//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=*
//*
![]() |
5. | Setting up the system environment |
---|
![]() |
6. | Starting the Agent |
---|
![]() |
7. | Quitting the Agent |
---|
![]() |
8. | The Event Monitor as independent Started Task |
---|
Example:
//CRTEMDS
JOB ####,'XXX',NOTIFY=&SYSUID,MSGLEVEL=(1,1)
//* Create Datasets for UC4 EventMonitor
//UCFILTER EXEC PGM=IEFBR14
//UCFILTER DD
DISP=(NEW,CATLG,CATLG),DSN=UC4.UCFILTER,
// RECFM=VB,LRECL=1024,BLKSIZE=8192,SPACE=(CYL,(1,1))
//UCEVENT EXEC
PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD
*
DEFINE -
CLUSTER ( -
NAME(UC4.UCEVENT.VSAM) -
INDEXED -
VOLUMES(DSK30D) -
TRACKS(1 1) -
) -
DATA ( -
NAME(UC4.UCEVENT.VSAM.DATA) -
KEYS(20 0) -
RECORDSIZE(1024 1024) -
FREESPACE(10 5) -
) -
INDEX ( -
NAME(UC4.UCEVENT.VSAM.INDEX) -
)
/*
Example:
//INITEMDS JOB
####,'XXX',NOTIFY=&SYSUID,MSGLEVEL=(1,1)
//INITVSAM EXEC
PGM=IDCAMS
//SYSPRINT DD
SYSOUT=*
//OUT1 DD
DISP=SHR,DSN=UC4.UCEVENT.VSAM
//SYSIN DD
*
REPRO INFILE(IN1) OFILE(OUT1)
//IN1 DD
*
DUMMY
/*
![]() |
9. | The External Job Monitor as independent Started Task |
---|
See also:
Agent - Interaction Between the Automation Engine and
z/OS
SMF Exit
Event Monitor
Automatic File-System Events
External Job Monitor
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |