JOB Trigger Screen DB.2.4

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

-------------------------- CA-7 CPU JOB TRIGGER -----------------------
FUNCTION: add       (FORMAT,LIST,UPD)
JOB: jobname

OPT SCHID TRGD-JOB TRGID DOTM QTM   LDTM  SBTM  X---- EXCEPTION ----X

 *   000  JOBB      021  2350       0010   2315
 *   010  JOBC                0130  0010        









PROGRAM SM20   MSG-INDX: 00       -- DB.2.4  --      99.365 / 23:59:59
MESSAGE: LIST SUCCESSFUL

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The FUNCTION field.

You must type in LIST FORMAT or UPD here when working online. Don't forget if you want to re-execute a function you must over-type at least one character. See below for details on the different functions.

When defining triggers via batch terminals, the function is the first positional parameter.

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The FORMAT Function.

This function is used to clear the screen of all input, that's all!
It's always a good idea to clear the screen by listing a new job, even if you know it hasn't got any triggers! You can't use this function when using the batch terminals.

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The LIST Function.

This function is used to display the triggers of one job, it can only be used 'online' and not in a batch terminal. If there is more than one page of triggers, use /PAGE+1 to page forward.

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The UPD Function.

This function is used to alter the triggers of a job. It doesn't matter if you are adding, updating or deleting triggers, you always use this function. The type of change is defined in the OPT column.

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The JOB field.

Here job type in the name of the job performing the triggers.

Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBC,OPT=,QTM=0130

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The TRGD-JOB Field.

The name of the job to be requested. Here JOBA is re-questing JOBB & JOBC to be run. Note that you can not update this field to contain a different job name, to do this you must delete and re-define the trigger. Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBC,OPT=,QTM=0130

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The OPT Field.

You can code values of "A" to add a new trigger, "U" to update an existing trigger (note the SCHID and TRGD-JOB fields cannot be updated), or "D" to delete an existing trigger. When you enter any form of change the OPT value changes to an asterisks ( * ) if the option has been performed correctly, or a question mark (? ) if a problem has occurred. See the EXCEPTIONS column for the type of error.

Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBB,OPT=A,QTM=0130

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The SCHID Field.

A value of zero here means that the triggered job will always be requested on the successful completion of the triggering job. If the value is between 1 and 255 (inclusive) then the triggering job must be running for that SCHID for the triggered job to be requested. Note this field can not be altered with an OPT value of U , if you need to change the SCHID value of an existing trigger then you must delete the trigger and build a new one. Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBB,OPT=A,SCHID=10,,QTM=0130

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The TRGID Field.

If used, it will be the schedule ID of the triggered job. So here JOBC will always run for schedule ID 21. If this field is left blank or coded with zero, the schedule ID will be the same as the triggering job (in this example JOBA). Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBB,OPT=A,TRGID=21,DOTM=2350

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The DOTM Field.

The DOTM (due-out time) is when JOBB should complete. Ensure this time will be after the DOTM of JOBA. If it is not to risk rolling over to the next day! If a job is still active at this time it will be flagged as late. The jobs DEADLINE time is calculated by subtracting the job's CLOCK time (+ 5 minutes) from this DUE-OUT time. You must code either a DOTM or a QTM and not both. Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBB,OPT=A,DOTM=2350

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The QTM Field.

How long the triggered job will be on the queue before it is considered late i.e. the difference between the ending of JOBA and the DEADLINE time of JOBC. If coded in minutes it is converted into hhmm. You must code either a QTM or a DOTM. The DUE-OUT time is calculated by adding the job's CLOCK time (+ 5 minutes) to the DEADLINE time. Rounded to a 10 minute increment. Batch terminal example:

SCHD
UPD,JTRG,OPT=A,JOB=JOBA,TJOB=JOBC,QTM=130

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The LDTM Field.

This LEAD time (hhmm) is only used if the CLOCK field on the JOB screen of the triggered job (JOBC) is set to 2359. Then this LEAD time should be the execution time of the triggered job(JOBC). Batch terminal example:

UPD,JTRG,JOB=JOBA,TJOB=JOBC,OPT=A,QTM=0130,LDTM=0100

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The SBTM Field.

Only used if the triggered job (JOBB) must not be released until the specified time. This submit time is always a time/date before the job's due-out time which is calculated first. Problems can occur if incorrect DOTM or QTMs are specified - it will select the wrong day - See the document 'Running Late' from Kyla Computing. This time is rounded down to the nearest 15 minutes. Batch terminal example:

SCHD
UPD,JTRG,JOB=JOBA,TJOB=JOBB,OPT=A,DOTM=2350,SBTM=2315

THIS LINE TO TOP OF SCREEN . PREVIOUS SECTION . NEXT SECTION . JOB TRIGGER SCREEN . BACK

The EXCEPTIONS Column.

When working online this column will display the error message when a UPD can not be performed. The OPT column will display a question mark and the type of error is under EXCEPTIONS.