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

A fix is available

Subscribe

You can track all active APARs for this component.

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 U3044.  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 U3048 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 V11 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  - 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.
    
              x'10'   CommitPrepare was unsuccessful. The external
                      subsystem was unable to complete the request
                      because of the unavailability of a resource.
                      IMS terminates the application ABENDU3048.
    

Temporary fix

Comments

  • POSTREQ PI05201
    REPINNED RP14/04/17 (ATXT) TO ADD POSTREQ PI05201 INFO.
     **** PE14/04/17 PTF IN ERROR. SEE APAR PI05201 FOR DESCRIPTION.
    

APAR Information

  • APAR number

    PM69915

  • Reported component name

    IMS V11

  • Reported component ID

    5635A0200

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-07-31

  • Closed date

    2013-02-28

  • Last modified date

    2014-04-17

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

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

    PM70167 UK92106

Modules/Macros

  •    DFSESP10 DFSFESP0
    

Publications Referenced
GC18971508        

Fix information

  • Fixed component name

    IMS V11

  • Fixed component ID

    5635A0200

Applicable component levels

  • R100 PSY UK92106

       UP13/03/05 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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IMS

Software version:

100

Reference #:

PM69915

Modified date:

2014-04-17

Translate my page

Machine Translation

Content navigation