Using Scheduler Job Management Cross Platform External Tracking with Unicenter Job Management Option (UUJMA)

Products

• Scheduler Job Management
• Unicenter Job Management Option

Issue/Introduction

Scheduler can receive notification for job starts, job completions and file updates where UUJMA (Unicenter Job Management Option) is installed. When the notification is received, commands can be passed to execute in Scheduler.

This Knowledge Document will describe the setup requirements and show examples.

 

 

Environment

 Unicenter Job Management Option (formerly known as Universal Job Management Agent)

Resolution

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

The Scheduler 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(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 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 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.

 

 

Additional Information

Scheduler Bookshelf

CA Scheduler Job Management  Interface Reference Guide, Chapter 2  Cross-Platform External Tracking.