Administration Guide > Installation > New Installation > Installing the Agent for z/OS

Installing the Agent for z/OS

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.

Requirements

Supplied Files

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. 

Load Module: 


Procedure

1. Transferring files to the hostComputer, target system.
2. Creating the Load Library
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" ).

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:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH