Technote (troubleshooting)
Problem
When applying or removing a Lotus Quickr for Domino fix pack QLQ0XXXX on IBM i, the job ends abnormally and the system quits unexpectedly. The APYPTF failed.
Symptom
Spooling File Message example:
Job message queue for <job name> can not be extended. Job ended.
Cause . . . . . : The size of the job message queue for <job name> reached the maximum size. The maximum size is defined in the JOBMSGQMX value of the job description used by the job. When the job message queue becomes full, the job attribute, JOBMSGQFL, identifies the action to take.
Recovery . . . :
Do the following: - Look at the messages in the job message queue to determine why the job message queue has become full. You can do this by using the Display Job Log (DSPJOBLOG) command and specifying <job name> for the JOB parameter. If an IPL has been done after this problem occurred the job message queue may not be found. - If JOBMSGQFL job attribute is *NOWRAP, increase the maximum size of a job message queue or allow a job message queue to wrap. This can be done by specifying the JOBMSGQMX or JOBMSGQFL parameters on the following commands: Create job description (CRTJOBD) command, change job description (CHGJOBD) command, submit job (SBMJOB) command, or batch job (//BCHJOB) command. If the
JOBMSGQMX and JOBMSGQFL parameters are not specified on those commands, the value to use for the job is taken from the QJOBMSGQMX and QJOBMSGQFL system values. - Start the job again to get a new job message queue.
Cause
Because this fix pack contains thousands of IFS files to copy or remove when APYPTF or RMVPTF, it produces a large amount of messages into the message queue.
If you examine the job log with command WRKSPLF, a result like the example above would be found at the end of the spooling file. That output means that the current job message queue is full, and the job message queue full action is *NOWRAP -- the default system action is to end the job.
For more information, refer to IBM i Information Center topic Jobs system values: When maximum size is reached.
Resolving the problem
To avoid the problem, set your default job message queue full action to *WRAP or increase your maximum message queue size. Otherwise, when applying this PTF, your job could end abnormally and quit the system unexpectedly.
Generally you can use the following command to change your current job message queue full action to *WRAP:
CHGJOB JOBMSGQFL(*WRAP)
Or, you can find your job description, increase the maximum job message queue size, or change the job message full action.
Take your current job description as DFTJOBD as example.
CHGJOBD JOBD(QDFTJOBD) JOBMSGQMX(64)
CHGJOBD JOBD(QDFTJOBD) JOBMSGQFL(*WRAP)
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.