PJ40972: CORRECT OPR-009323 ERROR

APAR status

• Closed as program error.

Error description

• See Problem Summary.
  

Local fix

• na
  

Problem summary

• APAR NUMBER:  PJ40972
  PRODUCT:  z/TPF
  FUNCTIONAL AREA:  MQS SUPPORT
  SHIPPED IN PUT:  10
  
  ABSTRACT:
  With PJ30737, writing z/TPF WebSphere MQ sweeper trace log
  entries to a z/TPFCS BLOB may result in an OPR-9323 (system
  error 009323).
  
  PACKAGE CONTENTS:
  Source Segments:
  (C) base/rt/cmqmgc.cpp
  
  Object Only Binaries:
  None.
  
  Configuration Independent Binaries:
  (C) base/lib/libCMQS.so
  (C) base/load/CMQS.so
  (C) base/obj/cmqmgc.o
  
  Support Files:
  base/lst/CMQS.map
  base/lst/cmqmgc.lst
  
  OTHER BINARIES TO BUILD: NO
  None.
  
  COMMENTS:
  With the addition of PJ30737, z/TPF WebSphere MQ sweeper trace
  enhancements, queue trace entries are written to a z/TPF
  collection support (z/TPFCS) BLOB. This allows the trace
  entries to be saved over an IPL.
  If two processes attempt to write to the same Trace Log BLOB
  that might result in system error 009323 (MQSERIES UNEXPECTED
  TO2 ERROR) out of segment cmqmgc.cpp with the following
  diagnostics: "-write Trace Log BLOB error", the persistent
  identifier (PID) of the BLOB, and "-6 - UPDATE SEQUENCE COUNTER
  MISMATCH". This occurs because the z/TPFCS BLOB is not locked
  and updates are managed by the use of a sequence number. The
  routine that writes the trace data reads the BLOB then writes
  the update; if another process updates the BLOB after it is
  read and before it is written, a z/TPFCS sequence error
  mismatch will result.
  

Problem conclusion

• SOLUTION:
  The z/TPF WebSphere MQ sweeper trace has been updated to check
  for a sequence error. If a sequence error is detected, the BLOB
  is re-read and re-written until it completes without error.
  
  COREQS: NO
  None.
  
  MIGRATION CONSIDERATIONS: NO
  None.
  
  BUILD COMMANDS AND INSTRUCTIONS: YES
  #maketpf commands for linux
  maketpf -f CMQS cmqmgc.o
  maketpf CMQS link TPF_VERIFY_LINK_REFS=NO
  maketpf CMQS link
  
  UPDATED INFORMATION UNITS: NO
  None.
  
  See your IBM representative if you need additional information.
  
  DOWNLOAD INSTRUCTIONS:
  http://www.ibm.com/software/htp/tpf/maint/maintztpf.html
  
  APAR URL:
  http://www.ibm.com/software/htp/tpf/ztpfmaint/put10/PJ40972.htm
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  Z/TPF

• Fixed component ID

  5748T1501

Applicable component levels

• R110 PSY

     UP