The DB.2.6 - Data Set Triggering panel lets you define or review data sets that trigger job scheduling when either their creating jobs complete successfully or when the created/updated data set is closed using long job names. This function is related to the POST AT CLOSE TIME field on the DB.6 – Data Set Definition Panel.
To display the panel, enter:
To exit the panel:
Use the DSN, the DSNBR, or both keywords to define the triggering data set.
Partitioned data sets (PDS) cannot be used as data set triggers.
------------------------- CA-7 DATA SET TRIGGERING ------------------------- FUNCTION: xxxxxxxx (FORMAT,LIST,UPD) PAGE 0001 DSN: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx DSNBR: xxxxxxxxx OPT SCHID --TRGD-JOBL-- /TRGID DOTM QTM LDTM SBTM *---- EXCEPTIONS ----* x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx x xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxx xxxx xxxx xxxx xxxx OPTIONS: A=ADD,D=DELETE,U=UPDATE,*=PROCESSED,?=ERROR PROGRAM: SM75 MSG-INDX: 00 -- DB.2.6L -- yy.ddd / hh:mm:ss MESSAGE: ENTER FUNCTION, TRANSFER OR ENTER A COMMAND ON THE TOP LINE
This panel contains the following fields:
Specifies the function to perform. The value must be the name of some other panel or one of the following values:
Clears the panel of user input data.
Lists the job names and schedule IDs for the triggering element. In batch, a formatted panel is not listed; only a found or not found message is returned. In batch, you must explicitly specify a SCHID and TJOB in the input command.
Performs updating the option that the following OPT parameter indicates. Do a LIST function before an online UPD.
Batch keyword: Positional parameter
Contains a constant value depending on the triggering element, either JTRGL, DTRGL, or NTRGL for job, data set, or network respectively.
Limits: Required for batch only.
Batch keyword: Positional parameter
Specifies the job name or long job name whose successful completion causes triggering.
Limits: 1 to 64 alphanumeric characters and required for job triggers.
Batch keyword: JOBL
Specifies the data set name whose creation or update causes triggering of a job.
Note: For VSAM files, specify the cluster name.
Limits: 1 to 44 alphanumeric characters and required for data set triggers unless DSNBR is entered.
Batch keyword: DSN
Specifies the input network name whose completion causes triggering.
Limits: 1 to 8 alphanumeric characters and required for network triggers.
Batch keyword: NWK
Specifies the existing data set number whose creation causes triggering. It is the value assigned to the data set by CA WA CA 7 Edition.
Limits: 1 to 8 numeric characters and required for data set triggers unless DSN is entered.
Batch keyword: DSNBR
(Optional) Used with the UPD function, denotes the operation to perform. The valid codes are A (add), D (delete), and U (update).
Batch keyword: OPTL
(Optional) Specifies for which schedule ID of the triggering element the TRGD-JOB is to be scheduled.
Default: 0 (all schedule IDs)
Limits: 1 to 3 numeric characters from 0 through 999. This field is not valid with OPT=U.
Batch keyword: SCHIDL
Note: For the data set trigger panel where the data set is one that is tracked with use of SASSXDSN (externally tracked data sets), the SCHID field must be 000 for the trigger to work.
Specifies the job name or long job name that is to be triggered by the completion/creation of the triggering element. If a short job name is used, it is replaced with the long job name at the completion of the function.
Limits: 1 to 64 alphanumeric characters. This field is not valid with OPT=U.
Batch keyword: TJOBL
(Optional) Denotes a replacement schedule ID to use when the TRGD-JOBL is placed into the request queue.
Default: 0 (no replacement)
Limits: 1 to 3 numeric characters from 0 through 999
Batch keyword: TRGIDL
Note: If TRGID is used, it replaces the SCHID value of the triggered element. Any jobs triggered (by TRGD-JOB or data sets it creates) use this TRGID for their schedule ID unless they also have a TRGID value.
Example:
This field is useful to avoid a loop in a situation where a job is both triggered by and triggers the same job. For example, assume that JOBX is a backup job that needs to be run after the online system comes down. It triggers JOBY, an update job that further updates the database. JOBY then triggers JOBX again to get another backup. When you define the second occurrence of JOBX as being triggered by JOBY, use TRGID 2 so that this occurrence of JOBX will not trigger JOBY again.
Specifies the due-out time of day of TRGD-JOBL rounded down to ten-minute increments. If this field is used, QTM must be omitted.
Note: If used and the triggering job's DOTM is after the triggered job's DOTM, CA WA CA 7 Edition assumes the following calendar day.
Limits: 4 numeric characters specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400. If specified, the lowest value is 10.
Required only if QTM omitted.
Batch keyword: DOTML
Specifies the elapsed queue time of TRGD-JOBL rounded down to ten minute increments. If this field is used, DOTM must be omitted because due-out time is then calculated as deadline time plus runtime, where deadline time is calculated as current date/time plus queue time.
Note: Either DOTM or QTM must be used.
Limits: 4 numeric characters specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400
Required only if DOTM omitted
Batch keyword: QTML
(Optional) Specifies the elapsed lead time for TRGD-JOBL rounded to ten minute increments. This field specifies the lead or processing time necessary to ensure that TRGD-JOB meets its due-out time.
Default: 0000
Limits: 4 numeric characters specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.
Batch keyword: LEADTML
(Optional) Imposes a submit time of day requirement on TRGD-JOBL. When used, the job is not submitted before this time. SBTM is always rounded down to 15 minute increments.
Note: If QTM is used, the date for the submit time requirement is the same as the deadline start date. If DOTM is used and the SBTM is less than the DOTM, the date for the SBTM is the same as the deadline start date. Otherwise, the SBTM date is the previous day.
Default: 0 (no specific submit time requirement)
Limits: 4 numeric characters specified as hhmm, where hh can be 00 through 24 and mm can be 00 through 59, the highest value being 2400.
Batch keyword: SBTML
Indicates an informational only field. Brief messages appear here when an exception occurs trying to process the entry on this line.
Batch keyword: Not applicable
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|