CTMTLB Example 2

Upload the following job definition as a distributed job to Control-M/EM on a UNIX work center, CTM-DS-Local. The job defines a distributed file triggering (File Watcher in Control-M/EM terms) task. The job definition is located in the SMART table FILWATCH in the CTM.SCHEDULE library. (Only a partial definition is shown.)

MEMNAME BAISM#05 MEMLIB XXX

OWNER BAISM#05 TASKTYPE JOB

APPL BAISM#05 TABLE AAIUPDN

DESC BAISM#05 Fil

SET VAR %%A=HAWK

SET VAR %%F=/UNX2/LARS/SCRIPTS/OLARD#F1_stop_aai.txt

SET VAR %%J=BAISM#05

SET VAR %%ENV1=environmental-parm-1

SET VAR %%ENV2=env-parm-2

SET VAR %%PARM1=argument-1

SET VAR %%PARM2=arg-2

SCHEDULE RBC BAISM#05_123

DUE OUT TIME + DAYS PRIORITY *9 SAC CONFIRM

OUT BAISM#05-OK ODAT +

ON PGMST ANYSTEP PROCST CODES OK

DO SYSOUT OPT R PRM

ON PGMST ANYSTEP PROCST CODES ****

DO SHOUT TO OPER URGENCY R

= %%JOBNAME J%%JOBID ENDED (NOT)OK!

SHOUT WHEN EXECTIME TIME >000 + DAYS TO OPER URGN R

MS JOB %%$MEMNAME HAS STARTED

When activating the utility, specify the following control parameters:

//DAINPRM DD *

DEFTYPE=NONMF

SETVAR=J=JOBNAME

SETVAR=F=FILETRG

SETVAR=C=CMDLINE

SETVAR=A=NODEID

DTD=deftable.dtd

DATACENTER=CTM-DS-Local

SCHEDULE-LIB=CTM.SCHEDULE

TABLE=FILWATCH

/*

Following is the XML generated by the utility (only relevant statements are shown):

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE DEFTABLE SYSTEM "deftable.dtd">

<DEFTABLE >

<SCHED_TABLE TABLE_NAME="FILWATCH" DATACENTER="CTM-DS-Local"

TABLE="AAIUPDN"

…

<JOB

NODEID="HAWK"

CMDLINE="ctmfw /UNX2/LARS/SCRIPTS/OLARD#F1_stop_aai.txt"

JOBNAME="BAISM#05"

OWNER="BAISM#05"

TASKTYPE="Command"

PRIORITY="9"

CRITICAL="1"

DESCRIPTION="BAISM#05 Fil"

APPLICATION="BAISM#05"

> <AUTOEDIT

EXP="%%ENV1=environmental-parm-1" />

<AUTOEDIT

EXP="%%ENV2=env-parm-2" />

<AUTOEDIT

EXP="%%PARM1=arguement-1" />

EXP="%%PARM2=arg-2" />

<RBC_NAMES RBC_NAME="BAISM#05_123" />

<OUTCOND NAME="BAISM#05-OK"

SIGN="ADD"

ODATE="ODAT" />

<ON

CODE="OK"

STMT="*"

>

<DOSYSOUT

OPTION="Release"

/>

</ON>

<ON

CODE="COMPSTAT<4096"

STMT="*"

>

<DOSHOUT

DEST="ECS"

URGENCY="R"

MESSAGE="%%JOBNAME J%%JOBID ENDED (NOT)OK!" />

</ON>

<SHOUT WHEN="EXECTIME"

TIME=">001"

DEST="ECS"

URGENCY="R"

MESSAGE="JOB %%$MEMNAME HAS STARTED" />

</JOB>

Note:

The AutoEdit variable SETVAR %%A has been transformed into the distributed NODEID parameter.
The AutoEdit variable SETVAR %%J has been transformed into the distributed JOBNAME parameter.
The AutoEdit variable SETVAR %%F has been transformed into the distributed CMDLINE parameter. Since F has been equated to FILETRG, the ctmfw File Watcher program is used in the CMDLINE parameter with the distributed file name following as an argument.
Arguments to the command are coded as SETVAR statements whose variable names are PARMn (n=1-32).
Ordinary SETVAR parameters are recognized as environmental parameters.
SHOUT destinations are all changed to ECS.
SHOUT WHEN EXECTIME >000 is transformed into >001.
In ON statements, PGMST and PROCST are ignored and CODES **** is transformed into COMPSTAT<4096.
The MEMNAME and MEMLIB parameters in the original job definition are ignored.
The TASKTYPE JOB is transformed to 'Command'.
Priorities specifying critical path (*x) are transformed using the CRITICAL="1" parameter.

Execute the Control-M/EM deftable utility with switch /a to complete the process of uploading the job definition.

Parent Topic

Examples for CTMTLB