Rebuilding JES2 job queues

Errors that are not detected and corrected by other portions of JES2 can damage the JES2 job or output queues. These errors can occur in both software and hardware. You can correct these errors through any type of warm start. Because the original in-storage order of jobs might change as a result of the job queue rebuild, JES2 performs the queue rebuild only with operator permission. To indicate a job queue error and request operator instruction, JES2 issues $HASP483 JES2 JOB QUEUE ERROR -- REPLY ‘Y’ TO REBUILD OR ‘N’ to TERMINATE JES2.

When job queues are rebuilt, JES2 invokes the REQ initialization option, allowing jobs to be requeued or canceled at your discretion.

The success of the queue rebuild procedure depends upon how badly the queues are damaged. If there is insufficient information to permit rebuilding the queues for a job, that job is purged and must be resubmitted for processing.

When you warm start JES2, JES2 verifies data that includes the following:

For JQEs:
- Job number is non-zero and not used by any other job
- Valid offset to next JQE
For all JOEs:
- The JOE type compared to the queue type
For work JOEs:
- The class type
- The offset of the job queue element
- The offset of the characteristics JOE.

If JES2 detects that the JQE or JOE has been corrupted and JES2 cannot correct the problem, JES2 places that JQE or JOE on the rebuild queue until it can be moved to the free queue. (To be moved to the free queue, a JQE must not be locked, busy, or retain JOEs.) JES2 moves the JQE or JOE when the member is again restarted, at the next all-member warm start, or when that JQE or JOE is no longer busy (that is, when this phase of job processing ends).

If in response to a $D JOBDEF or $D OUTDEF command, JES2 indicates that there are jobs or JOEs, respectively, on the rebuild queues, use the $D REBLD command to display all jobs and output elements on that rebuild queue. This might prove useful when trying to locate jobs that appear lost; a situation that might occur if in response to a $D J, $L J, or a $D OJ command JES2 does not find all the jobs you expected.

Typically, the rebuild queue is empty, but if JES2 places a job or JOE on the rebuild queue, it provides diagnostic information through messages $HASP440 and $HASP517 when it completes rebuilding the JOE queue and JQE queue, respectively. These messages also include the number of elements placed on the rebuild queue.