PH13209: EXEC CICS START CAUSES AICA ABEND WHEN DSRTPGM=NONE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A request is made to START a transaction to a remote region,
  where that region exists but is not currently active.
  .
    Trace shows a loop between two requests from DFHEIIC:
      IS 0200 ISIS  ENTRY CONVERSE
  and
      AP 00DF ISP   ENTRY CONVERSE
  .
    The first is to see if an IPIC connection exists.
  It doesn't so the request gets NOT_FOUND.
    The second is for an MRO connection that does exist,
  but isn't currently connected.  The exit from the request is:
  AP FD0B ZISP ENTRY FACILITY_REQ ALLOCATE,FREESYNC,FREEREST
  AP FD8B ZISP EXIT  FACILITY_REQ
  AP 00DF ISP  EXIT  CONVERSE  0005,04000000...
  .
    Instead of returning SYSIDERR, the request loops back
  through both until abend AICA is issued.
  .
    The transaction is defined DYNAMIC(YES) REMOTESYSTEM(xxxx).
  This CICS is NOT using a routing exit for START commands
  (SIT parm DSRTPGM=NONE).
    In CICS TS 5.5, changes were made to DFHEIIC
  to bypass calls to the default dynamic routing program DFHDSRP
  when DSRTPGM=NONE.
    The design of dynamic routing of START commands
  supports multiple calls to the exit. If a route request fails,
  the exit is called again by an iterative call to Route_loop.
    The problem is that all calls to the routing exit
  are being bypassed, so the route selection is made
  using REMOTESystem(xxxx).  When this fails, code in DFHEIIC
  iterates.  But there is no call to the routing exit
  and we loop until we hit the runaway limit.
    If the first attempt to route fails
  AND the routing exit is inactive,
  we should drop out of Route_loop
  and return an appropriate error.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVDAM
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: EXEC CICS START causes abend AICA when  *
  *                      SIT parameter DSRTPGM=NONE. The failing *
  *                      command is a non-terminal START against *
  *                      a transaction defined with attributes   *
  *                      DYNAMIC(YES) REMOTESYSTEM(RRRR).        *
  ****************************************************************
  An application issues a non-terminal EXEC CICS START command to
  start a transaction on a remote system.
  SIT parameter DSRTPGM=NONE is set. This means that the dynamic
  routing program for START commands is disabled.
  DFHEIIC processes the START command. As the routing exit is not
  enabled, the REMOTESYSTEM attribute from the transaction
  definition is used to identify the remote CICS region.
  The attempt to ship the START command fails because the remote
  region is not connected.
  This should trigger a SYSIDERR error condition.
  DFHEIIC catches the error and iterates a loop in an attempt
  to re-drive the dynamic routing program to allow a different
  region to be selected.
  However, as the routing exit is disabled, the same region is
  selected and the route request fails again. This loop is
  repeated until the CICS runaway interval is exceeded.
  
  Additional keywords :- ABENDAICA
  

Problem conclusion

• DFHEIIC has been changed to terminate the route selection loop
  following an error shipping a START command if the dynamic
  routing exit is disabled.
  

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:

  UI65795

Modules/Macros

• DFHEIIC
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI65795

     UP19/10/11 P F910

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.