Maintain Request Job Run - JBSF5300

Purpose	To monitor the running of job requests and review outcomes, and To cancel requested jobs waiting to run
Subsystem	Job Control and Scheduling
Structure	One Block	Job Run
	Navigation Buttons invoke:	Job Output overlay Job Parameters form Process to cancel a job Re-querying of job run information Order By pop-up window Inquire On Run Log form
Image

Job Run
This form is used to inquire on the progress of a job or jobs once a request has been submitted to run. If accessed from the Maintain Request Details form (JBSF5210) or from a report or job parameter form, context information is carried forward. The form also allows review of the outcome of recent job runs, using query mode. Query criteria can be entered in any field to refine the inquiry, and the list of jobs can be re-ordered using the Order By pop-up window. A spread table allows access to the fields at the far right. It is also possible to use this form to cancel individual jobs that have not yet started running. Information about the meaning of the request and job run statuses is given in Checking on the Progress of a Request in the subsystem introduction.
Example
A job in request 35 has been carried forward as the context record displayed in this form:
Field Name	Data in field	Interpretation
REQUEST NUMBER	35	This job is included in request 35
JOB NAME	CALR0620
JOB NUM	2	This is the number assigned to the job within request 35. If the Sequence indicator was set, the job will have run second in sequence within the request.
JOB RUN STATUS	COMPLETE	The job completed successfully
QUEUE ID	3	It ran in batch queue 3
SCHEDULED DATE & TIME	23/09/1998 18:15	It was scheduled to run on 23^rd September 1998 at 6.15 p.m.
START DATE & TIME	23/09/1998 18:18:35	It actually started to execute 3 minutes and 35 seconds later
FINISH DATE & TIME	23/09/1998 18:20:46	It completed 2 minutes and 11 seconds after starting
CPU TIME	00:00:01	To run this job, the computer allocated approximately 1 second of its time in total

To inquire on the progress of job requests, and view outcomes, using the Maintain Request Job Run form:
In Query mode: Enter query details in the appropriate fields. Execute the query.	Rules: The list of values can be used to select a query criterion in the Job Run Status field. Job run statuses are: WAIT, SCHEDULED, RUNNING, COMPLETE, FAILED, ABORTED, CANCELLED. Jobs will revert to WAIT status after executing if they are scheduled to run again within the request.

Job Output

The Job Output button displays an overlay (Job Output Destination) that provides details of the destination to which any output from the selected report or job is sent. The button is only active where a job or report produces physical output. The Re-send Output button within the overlay allows for previously sent outputs to be resent to the original destination or redirected to a new destination.

Job Parameters

The Job Parameter button invokes the parameter form for the selected job or report and displays the parameters that were used for that particular job/report run. Parameters cannot be changed at this stage.

To cancel a job waiting to run using the Maintain Request Job Run form:
In Insert mode: Place the cursor in the Job Run Status field of the record to be cancelled (or access the list of values for this field in the correct record). Select CANCELLED from the list displayed. Save. OR Select the job to be cancelled. Select the Cancel Job button. Save.	Rules: Jobs can only be cancelled if they have a status of WAIT or SCHEDULED. If all jobs in a request have been cancelled, and there are no more scheduled times to run, the request itself needs to be cancelled in the central form Maintain Request Details (JBSF5210).

Refresh

The Refresh button performs a re-query within this form using the previously used query criteria. This updates the displayed data, particularly the Job Run Status, and is used to monitor the progress of jobs and reports.

Order By
The Order By button invokes a pop-up window which is used to change the order in which job records are listed on this form. Changing the order has no effect on when the jobs will run. The records can be ordered by the following fields: Scheduled Date & Time (in order from most recent to oldest) Request Number Queue ID Start Date & Time (in order from most recent to oldest) Finish Date & Time (in order from most recent to oldest) When the order is changed, the new sequence takes effect on re-query. The ordering facility can be used in conjunction with query criteria to refine the way in which information about jobs is presented.
Example
The list is ordered by request number within scheduled date and time. Assume that five requests (Request Numbers 34, 35, 36, 38, 42) were all scheduled to run on 22 October at 1 a.m. Request 36 has three request jobs - FINJ3500 was run three times, with different parameters each time.
Request Number	Job Name	Queue ID	Scheduled Date & Time
34 35 36 36 36 38 42 30	SECR0044 CALR0630 FINJ3500 FINJ3500 FINJ3500 CRSR0610 ORGR0220 XXXX1111	2 3 1 2 2 4 2 1	22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 21/10/97 23:00
The order is changed to scheduled date and time within Queue ID. When next re-queried, this is the sequence:
36 30 34 36 36 42 35 38	FINJ3500 XXXX1111 SECR0044 FINJ3500 FINJ3500 ORGR0220 CALR0630 CRSR0610	1 1 2 2 2 2 3 4	22/10/97 01:00 21/10/97 23:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00 22/10/97 01:00

To re-order the sequence in which jobs are listed on the Maintain Request Job Run form:
Select the Order By button. Optionally, to remove field names from all the Order By fields, use the Clear button. For each position required in the ordering hierarchy, click on an 'Order By' field or corresponding arrow and select a field name from the drop-down list. Return to the main form by using the Back button. The new order takes effect next time a query is executed.	Rules: · Re-ordering works as in this example: Selecting 'Queue ID' in the top Order By field, 'Request Number' in the next field down results in job records being presented o first grouped by batch queue and then o in ascending request number order within batch queue. · Selecting the 'space' at the bottom of the drop-down list clears an Order By field.

Last Modified on 11 March 2002