PTF Cover Letter
PTF ( Program Temporary Fixes ) Cover letter
OSP Fix multiple items with program QMHLOGER and QHST loggin
Pre/Co-Requisite PTF / Fix List
REQ LICENSED PTF/FIX LEVEL
TYPE PROGRAM REL NUMBER MIN/MAX OPTION
---- -------- --- ------- ------- ------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels. This PTF may be a prerequisite
for future PTFs. By applying this PTF you authorize and agree to the
This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF. You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.
SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.
The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
APAR Error Description / Circumvention
Program QMHLOGER handles QHST logging, which involves moving
messages from the QHST message queue to a QHST database file.
The logging occurs in the SCPF job. These are some problems
with the logging support:
1) Fix message queue logical damage recovery invocation. When
logical damage or corruption on QHST or QSYSOPR is detected by
system code, it forces an MSGMCH0601 to cause message queue
cleanup to be invoked. The cleanup attempts to recover all
messages that it can and allow the message queue to be used
again. Due to a low-level change in the system in an earlier
release of the operating system, the MCH0601 is not being
generated as expected. This causes message operations to
continue running after logical damage or corruption is detected.
This may cause a loop or unpredictable results in the message
operation. A change will be made to use a different method to
force the MSGMCH0601, which will allow message queue damage
recovery to be invoked as it was in the past.
2) Keep logical damage message in the job log. When QHST
message queue is found to be logically damaged (corrupted due to
the system ending immediately) an MSGMCH0601 is forced to cause
message queue recovery/fix-up to be invoked. Currently the MCH
message does not remain in the SCPF job log. The MCH should
remain in the SCPF job log to indicate the detection.
3) QHST message queue becomes full. When QHST becomes full,
new jobs cannot be started because job initiation sends a
message to QHST and the send results in MSGCPF2460 (message
queue could not be extended). One cause of QHST becoming full
involves program QMHLOGER when it is moving messages off of the
QHST message queue. While moving off a message, the current
QHST database file is full so QMHLOGER issues MSGCPF2456 (Log
version closed and should be saved) to QSYSOPR. If the message
cannot be sent due to a problem with the QSYSOPR message queue,
then program QMHLOGER ends and no more messages are moved off
QHST. This results in QHST becoming full. Program QMHLOGER
should ignore errors when sending the CPF2456 and continue
processing so it does not allow QHST to become full.
4) Send message to SCPF job log. When program QMHLOGER sends a
message to QSYSOPR and an error occurs, currently the user is
not informed of the message that was attempting to be issued.
An example of some messages that are sent by program QMHLOGER to
QSYSOPR are MSGCPI2414 (Original run priority for SCPF has been
reinstated), MSGCPF2456 (Log version closed and should be
saved), and MSGCPF2503 (Message queue for system log damaged).
When the message cannot be sent to QSYSOPR, it should be sent to
the SCPF job log so there is a record of the activity or
5) Indicate message file not found. When moving a message to
the QHST database file and its sending message file could not be
found, there is no record of this problem in the SCPF job log.
The message is put into the QHST database file and the text of
MSGCPF2529 (Message file not found for message) is shown when
DSPLOG is used. Once the message file exists again, DSPLOG no
longer shows CPF2529. When program QMHLOGER cannot find a
message file, send a CPF2529 to the SCPF job log to have a
record of the failure.
CORRECTION FOR APAR SE52583 :
Program QMHLOGER will be changed to fix the problems identified
CIRCUMVENTION FOR APAR SE52583 :
THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.
PTF/FIX NO(S). APAR TITLE LINE
|APAR Fixed..........................||View details for APAR SE52583|
|MRI Feature ........................||NONE|
15 July 2012