IBM Support

PH10266: EXEC CICS START TRANSID(XXXX) TERMID(XXXX) RESULTS IN DFHAC2016 and DFHPG0209 because program ######## is unavailable

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Transaction AAAA on a TOR TOR1 routes to AOR AOR1.  The
    transaction issues an EXEC CICS START command to run a new task
    at the current terminal
    
    EXEC CICS START TRANSID(ABCD) TERMID(DDDD)
    
    The new transaction is defined as ROUTABLE(YES) in the AOR and
    has REMOTESYSTEM(AOR2) in the TOR to statically route to a
    different AOR.
    
    This results in message DFHAC2016 being sent to the terminal and
    DFHPG0209 being issued to MSGUSR in the TOR because program
    ######## is unavailable for transaction CRTX.
    
    The problem is the AID in the TOR not being built correctly as
    the value in ICETRNID has been corrupted.  This causes CRTX to
    run instead of the requested transaction.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users                                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Users of enhanced EXEC CICS START       *
    *                      commands will encounter errors when     *
    *                      the command is routed to a TOR for      *
    *                      execution.                              *
    ****************************************************************
    An EXEC CICS START TERMID command is routed from an AOR to the
    TOR.  In the TOR the START is re-issued and an ICE is created.
    The ICE ends up with ICETRNID containing a value from low core
    instead of the required transaction id.  When the ICE expires
    DFHALP creates an AID and the bad ICETRNID value gets copied
    into AIDTRNID.  When the terminal is available DFHALP issues an
    attach for the AIDTRNID transaction.  This fails and CRTX is
    attached instead.  DFHAPRT then tries to run CRTX locally and
    that fails because program ######## is unavailable.
    
    Message DFHAC2016 is sent to the terminal and message DFHPG0209
    is written to MSGUSR in the TOR.
    
    Additional keywords:
    msgDFHAC2016  msgDFHPG0209  AC2016  PG0209
    

Problem conclusion

  • DFHEIIC has been changed to correctly process the routed START
    command in the TOR.  DFHICP then populates ICETRNID with the
    correct transaction id.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH10266

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    200

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-03-27

  • Closed date

    2019-04-17

  • Last modified date

    2019-05-02

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

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

    UI62551

Modules/Macros

  • DFHEIIC
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R200 PSY UI62551

       UP19/04/24 P F904

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 May 2019