Previous Topic: FRJOB ExamplesNext Topic: FRQJOB Command


FRJOB Usage Notes

The FRJOB command is useful when you are creating or modifying the schedules and triggers for a workload flow. If you need to determine all of the paths that schedules, triggers, or both can take to result in a given job being run, FRJOB can be most helpful.

For example, your operations staff informs you that a second copy of job PAY0090 is being brought into the system whenever the PAYROLL application is run, even though it had already run earlier in the cycle. You can use FRJOB to determine not only the possible triggers for PAY0090, but also the path of control that leads up to each of those triggers. With this information you can more easily diagnose the problem, and also check the results after you have made changes to the structure.

The FRJOB display does not include any dates or times for elements in the structure. This is because the flow is being generated backwards through logical control paths. Also, the display can include jobs with a schedule ID of zero (000) that indicates it represents any occurrence of the job rather than a specific occurrence of the job. Once you have determined the origin points for the target job you can use one of the other forecasting commands to retrace a particular control path from the origin point to the target job with dates and times provided.

FRJOB,JOB=BBD07 FRJOB DATE 04-01-yy PAGE 0001 REVERSE STRUCTURE FOR CA-7 JOBS JOB(S) : BBD07 SYSTEM(S) : ALL JOBNET(S) : ALL OPTIONS : BOTH JOB- AND DSN-TRIGGERED JOBS INCLUDED CONNECTED OUTPUT NETWORKS NOT INCLUDED HEADER JOB/NETWORK NAME : BBD06I AND OTHERS

The forecasting summary page for FRJOB follows the general format of all forecasting commands with the following exceptions:

HEADER JOB/NETWORK NAME

This field shows the name of the first (or only) origination point (header) for the control flow that eventually results in the target job.

AND OTHERS

If there are multiple possible origin points in the reverse job flow, this area contains the text AND OTHERS. If there is only one origination point (header) for the flow, this area is blank.

FRJOB,JOB=BBD07 FRJOB DATE 04-01-yy PAGE 0001 REVERSE STRUCTURE FOR CA-7 JOBS HDR LEV# JOB NAME SYSTEM SID TYPE TRIGGERS /DSNBR /SCHEDULED --- BBD07 ............ 000 **** -001 BBD06I .......... 001 INWK BBD07 :**SCHD** -001 BBD06 .......... 006 JOB BBD07 -002 BBD05 ........ 005 JOB BBD06 **** -003 BBD04B ...... 005 DSET BBD05 :DS00000058 -003 BBD04 ...... 004 JOB BBD05 -004 BBD03 .... 003 JOB BBD04 -005 BBD02 .. 002 JOB BBD03 **** -006 BBD01 BBDSYS 001 JOB BBD02 :**SCHD** SFC1-00 REQUEST COMPLETED AT 12:55:18 on yy.092

This panel contains the following fields:

HDR

Header Indicator. Displays asterisks (*) if the element on that line is considered a header (origination point). Otherwise, it is blank.

LEV#

Level. Identifies the logical level of the element on that line. The starting point (target job) is at level zero, which is represented by three hyphens (---). The elements that can trigger the target job have a level of negative one (-001). The elements that can trigger the negative one level have a level of negative two (-002), and so forth.

JOB NAME

Identifies the name of the job or network that triggers an element on the next higher level. The name is offset to the right for each level up to the sixth level (-006). This makes it easier to see what level a given element is on. Elements that are six or more levels deep all appear starting at the same column as the sixth level.

SYSTEM

Identifies the application system name of the job on this line.

SID

Schedule ID. Identifies the schedule ID of the job or network on this line. A generic schedule ID of zero (000) can appear in the flow. Such an entry represents ANY occurrence of the job or network.

TYPE

Type of element. Identifies a literal that describes the type of element and trigger the line represents.

The following are the possible values:

JOB

Indicates the element in the Job Name field is a job that triggers the job in the Triggers field through a job trigger.

DSET

Indicates the element in the Job Name field is a job that updates or creates a data set (DSNBR field) that triggers the job in the Triggers field through a data set trigger.

INWK

Indicates the element in the Job Name field is an input network that triggers the job in the Triggers field through a network trigger.

TRIGGERS

Identifies the name of the job on the next higher level that this element triggers. For example, the last line of the preceding example means that job BBD01 (level -006) triggers job BBD02 on the next higher level (level -005).

DSNBR

Data Set Number. Identifies the CA Workload Automation SE data set number of the data set created or updated by the job shown in the Job Name that causes a data set trigger to bring in the job shown in Triggers. The DSNBR is only displayed if a data set trigger is involved, otherwise it is blank.

SCHEDULED

Schedule Indicator. Identifies the literal **SCHD** if the element on this line has one or more date/time schedules defined to CA Workload Automation SE. Otherwise it is blank.