PM70167: A CHANGE IN BEHAVIOR IS DESIRED AFTER RETURN CODE 8 FROM AN EXTERNAL SUBSYSTEM DURING PHASE 1 SYNCPOINT PROCESSING.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After RC8 from an External Subsystem, such as DB2, during Phase
  1 syncpoint processing IMS currently ABENDs U0344.  IMS requeues
  the transaction in the front of the queue and PSTOPs the
  transaction.  Other messages queued to this transaction which
  might have processed successfully can not execute.  If
  automation starts the transaction before the problem causing the
  RC8 has been resolved the same message is processed again and
  fails again. Other messages for this transaction cannot process.
  
  IMS will introduce RC10 for Phase 1 External Subsystem
  processing.  If this return code is received the transacion
  will abend U0348 instead of U3044.  The message will be placed
  on the Suspend Queue instead of being requeued at the head of
  the transaction queue.  The Program and Transaction are not
  stopped.  Other messages for this transaction can continue to
  process.  When the problem causing the RC10 has been resolved
  a /DEQ SUSPEND or /START TRAN command will release the messages
  on the Suspend Queue.  As long as there are more good messages
  processing than bad ones the transaction will continue to
  process.  If there are 10 bad messages in a row the
  transaction will be USTOPPED and all messages for this
  transaction will be queued.
  

Local fix

• There is no local fix for this problem
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS V12 customers using the ESAF interface.  *
  ****************************************************************
  * PROBLEM DESCRIPTION: Looping programs after ESS Phase 1      *
  *                      Commit failures for invalid or revoked  *
  *                      userids.                                *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  Applications using the IMS ESAF interface to communicate with
  External Subsystems may experience looping programs when a
  userid associated with a transaction's input message has been
  revoked or is invalid.
  
  In such instances, Phase1 Commit (Commit Prepare) failures
  are indicated by a return code sent to the IMS ESAF from
  the failing External Subsystem. Failing return codes (4 and 8)
  are handled in the following manner:
  
  RC04  - If the application is not terminating, an internal ROLB
          is performed which returns the message to the
          application.
  
          If the application is terminating, IMS activates the
          Terminate Thread exit routine with the abort option.
          The application is terminated with abend U3055, updates
          are discarded and the input message is requeued.
  
  RC08  - IMS activates the Terminate Thread exit routine with the
          abort option.  The application is terminated with abend
          U3044, updates are discarded, and the input message is
          requeued after stopping the transaction.
  
  For RC04, the message associated with the revoked USERID is
  requeued and available for processing by the same, or any other
  program running in IMS.  The scenario repeats itself
  indefinitely.
  
  For RC08, the message is requeued to the transaction and
  the transaction is also stopped.  This is often undesirable
  since it prevents valid messages queued to the same transaction
  from being available to applications until the USERID is
  restored and the transaction is restarted.
  
  A second ill effect of RC08 results when accounts use automation
  to start the transaction prior to the resolution of the revoked
  USERID.  Since the offending message has been requeued to the
  transaction, it will now be available to applications which will
  continue to encounter PHASE1 errors until the USERID problem has
  been addressed.
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  A new Return Code is being made available to the Phase1 Commit
  process, RC=x'10'.
  
  Subsystems detecting invalid Userids during Phase 1 Commit may
  now return with RC=x'10' which will ABENDU3048 the application.
  
  ABENDU3048 will still terminate the application program, but
  will not stop the transaction. The offending message will be
  placed on the IMS suspend queue, keeping it away from
  applications but allowing those applications to keep processing
  any other valid messages for the transaction.
  
  When the Phase1 Commit problem is resolved, messages on the
  SUSPEND QUEUE may be requeued to the normal queue for procesing
  using the /STA TRAN command. The /DEQ SUSPEND command may also
  be used to requeue all suspended messages for all transactions.
  
  In the IMS MESSAGES AND CODES MANUAL, under the section:
  Category B - conditions detected by external subsystem exits,
  in the table for function code x'0294', ADD Return Code x'10'
  
  X'0294'     EXTERNAL SUBSYSTEM COMMIT PREPARE. DETECTING MODULE:
              EXTERNAL SUBSYSTEM COMMIT PREPARE EXIT.
  

Temporary fix

Comments

• POSTREQ PI05199
  REPINNED RP14/04/17 (ATXT) TO ADD POSTREQ PI05199 INFO.
   **** PE14/04/17 PTF IN ERROR. SEE APAR PI05199 FOR DESCRIPTION.
  ×**** PE13/10/30 FIX IN ERROR. SEE APAR PI05199  FOR DESCRIPTION
  

APAR Information

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

  PM69915

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

  PM79247 UK92105

Modules/Macros

•    DFSESP10 DFSFESP0
  

Fix information

• Fixed component name

  IMS V12

• Fixed component ID

  5635A0300

Applicable component levels

• R200 PSY UK92105

     UP13/03/04 P F303

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.