Using CA Scheduler Job Management Cross Platform External Tracking with Unicenter Universal Job Management Agent.

Document ID : KB000052784
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

CA Scheduler JM can receive notification for job starts, job completions and file updates where UUJMA is installed. When the notification is received, commands can be passed to execute in CA Scheduler JM. This Knowledge Document will describe the setup requirements and show examples.

Solution:

UUJMA must be installed in a non-z/OS platform where you want CA Scheduler JM to receive notification, and CA Scheduler JM must be setup to do cross-platform scheduling.

The CA Scheduler JM started task job must have a DD name EVENTS pointing to the event definition file. This file should be fixed block with the record length of 80 bytes.

//EVENTS  DD  DISP=SHR,DSN=CAI.SCHED.PPOPTION(EVENTS)

The event definition file contains the EVENT statements and keywords. Depending on the TYPE of event, not all keywords are used. The keywords do not have to be in any order but must be between columns 1 through 72. Lines can be continued with a ' - ' (blank and a dash). Below is the EVENT statement and keywords.

EVENT(NODE(cciname) -
TYPE(JOBINIT|JOBTERM|DSCLOSE|CONNECT) -
NAME(job name or file name) -
JNO(nnnn) -
JOBSET(jobset name) -
LOWFAIL(nnnnn) -
HIGHFAIL(nnnnn) -
STAT(N|Y) -
COMMAND(CA-Scheduler command))

Here are some examples of the use of external tracking and setup.

Example 1: When a Windows file CAI.TEST is updated, submit the job PAYTEST from CA Scheduler. UUJMA is installed in Windows with CCINAME NODEPAY.

The CAI.SCHED.PPOPTION(EVENTS) file will contain:

EVENT(NODE(NODEPAY) TYPE(DSCLOSE) -
 NAME(c:\dir\CAI.TEST) -
 COMMAND(SC RUN J NAME=PAYTEST))

Example 2: When a Windows file CAI.TEST.TRIGGER is updated, post the dataset CAI.TEST.RECEIVE.FILE in CA Scheduler. UUJMA is installed in Windows with CCINAME NODEPAY.

The CAI.SCHED.PPOPTION(EVENTS) file will contain:

EVENT(NODE(NODEPAY) TYPE(DSCLOSE) -
 NAME(CAI.TEST.TRIGGER) -
 COMMAND(SC POST DSN N=CAI.TEST.RECEIVE.FILE))

A rebuild of the EVENTS file is necessary when additions or deletions are made. Use the XPLAT EVENTS command to rebuild this file.

To display active EVENTS, use the DISPLAY EVENTS command.

Recommended reading; CA Scheduler JM Interface Reference Guide, Chapter 2.1.3 Cross-Platform External Tracking.