z/OS JES2 Messages
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$HASP9203

z/OS JES2 Messages
SA32-0989-01

$HASP9203

Explanation

Read syntax diagramSkip visual syntax diagram
>>-LONG PCE DISPATCH--DURATION---hh:mm:ss.xx--PCE---pcename----->

>--EXIT---exit--JOB ID---jobid--COMMAND---jes2_command---------><

JES2 issues this alert message in response to a $JDJES or a $JDSTATUS monitor command or as a highlighted message. Based on context, this message can indicate an alert or an incident JES2 is tracking. This message indicates that a particular PCE has been dispatched, from a JES2 dispatcher point of view, for the duration indicated. A long PCE dispatch might indicate a problem or complex processing that is taking a long time to complete. It could also be caused by a loop that spans a large area of memory or involves calling a service in a separate module. One way to determine if the long dispatch is making progress is by studying the job information in the message. If it is changing over time then the process might eventually complete. If it is not changing, it might indicate a problem with the processing or the current job. In general, most functions in JES2 process jobs in job number order, and warm start processes jobs in job—index order.

In the message text:
hh:mm:ss.xx
The length of time the PCE has been dispatched.
pcename
The name of the PCE in control.
exit
The exit number in control (or NONE).
jobid
The job id or job index associated with current PCE (or NONE).
jes2_command
If the current PCE is the command processor, the current command is being processed. If the current PCE is not the command processor, this line is not displayed.
Note: Because data used to build this message is sampled without serialization, it is possible, in rare situations, for the PCE, exit, or job information to not correspond to the address being displayed.

System action

If the condition persists, JES2 reissues this message every 30 seconds with updated information.

Operator response

Monitor alerts indicate potential reasons why JES2 is not functioning properly. If this condition persists and is impacting normal JES2 operations, notify your system programmer.

System programmer response

Long PCE dispatches can be an indication of a tuning problem, a complex process that takes a long time to complete or an error situation. If the JES2 main task is not getting enough CPU resource, it could appear to the monitor as a loop. Use the D A,JES2 command or a performance monitor to ensure that JES2 is indeed consuming CPU. When you have eliminated CPU performance problems, check if the PCE displayed is the command processor and examine the command that was entered. Some commands can take a long time to complete, such as a command to alter all 200,000 jobs or 500,000 JOEs in the system. If progress is being made (job number displayed is being updated) for a complex command, then this might be normal processing.

First, deal with the current situations by either waiting for the command to complete or ABEND JES2 and then restarting it. When this situation has been addressed, consider entering multiple commands with job ranges, for example $PJQ(1–20000), $PJQ(20001–40000), and so forth). As each command completes, JES2 can perform other processes preventing JES2 from being able to process other requests.

If the problem is not a complex command, determine if progress is being made by examining the job ID in the message. If no progress is being made, there might be a problem. First, issuing the z/OS® MVS™ DUMP command to capture a dump of the JES2 address space. Then issue a $PJES2,ABEND command followed by a $PJES2,ABEND,FORCE command to terminate JES2. When JES2 terminates, you can then restart it. Analyze the dump to determine what code is running and the cause of the long dispatch. If the problem is in exit code, or exit–invoked code, correct the exit logic. Some logic, for example, that performs adequately when there were only 20,000 jobs in the job queue might have problems with 200,000 jobs. If the problem is caused by IBM®–distributed code, contact the IBM support center.

Module

HASJSPLR

Routing Code: 1,2,10,42 or as a command response

Descriptor Code: 2,7 or 5 when a command response

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014