Previous Topic: FRQJOB ExamplesNext Topic: FSTN Command


FRQJOB Usage Notes

The FRQJOB command is useful when you are trying to determine how a job is going to get into the scheduling system in the near future. You would first use the FRQJOB command to see if there is anything currently in the queues that eventually results in triggering of the target job.

For example, a vice president of your company calls and asks if job XYZ is going to run before the end of the day. You issue an FRQJOB command for XYZ and learn that job X is currently in the request queue, and it triggers job Y that in turn triggers job XYZ. You can then issue an FQJOB command for job X that gives you an estimate of the time that job XYZ executes. Without the FRQJOB command, you would have had to manually analyze the situation with a series of LJOB,LIST=TRIG and LQ commands.

The FRQJOB 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.

FRQJOB,JOB=FLOW4H FRQJOB DATE 03-20-yy PAGE 0001 REVERSE STRUCTURE FOR CA-7 JOBS (INCLUDING QUEUES) JOB(S) : FLOW4H SYSTEM(S) : ALL JOBNET(S) : ALL OPTIONS : BOTH JOB- AND DSN-TRIGGERED JOBS INCLUDED CONNECTED OUTPUT NETWORKS NOT INCLUDED HEADER JOB/NETWORK NAME : FLOW1A (0842)

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

FLOW1A… (in the sample)

This field shows the name of the first (or only) origination point (header) for the control flow that eventually results in the target job. If the job is currently in one of the status queues the CA 7 job number is displayed also (0842).

(blank space right of (0842))

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

FRQJOB,JOB=FLOW4H FRQJOB DATE 03-20-yy PAGE 0001 REVERSE STRUCTURE FOR CA-7 JOBS (INCLUDING QUEUES) HDR LEV# JOB NAME SYSTEM SID TYPE TRIGGERS /DSNBR /SCHEDULED --- FLOW4H ............ FLOWSYS 000 -001 FLOW3D .......... FLOWSYS 001 JOB FLOW4H -002 FLOW2C ........ FLOWSYS 000 DSET FLOW3D :DS00000040 0842 -003 FLOW1A ...... FLOWSYS 001 JOB FLOW2C SFC1-00 REQUEST COMPLETED AT 17:35:19 on yy.080

This panel contains the following fields:

HDR

Header Indicator. Displays nonblanks if the element on that line is considered a header (origination point). If the header job currently resides in the request, ready, or active queue, the field contains the four-digit CA 7 job number. If the header job does not currently reside in queues, the field contains asterisks.

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

System Name. 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 FLOW1A (level -003) triggers job FLOW2C on the next higher level (level -002).

DSNBR

Data Set Number. Identifies the CA WA CA 7 Edition data set number of the data set created or updated by the job shown in the Job Name, which 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 WA CA 7 Edition. Otherwise it is blank.