PM14501: IOERR RETURNED ON EXEC CICS START DUE TO DUPLICATED REQID PARM

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IOERR can be returned for exec cics start issued by ezacic02
  when the REQID parm is duplicate on two different transactions.
  This error can occur when multiple CICS regions each have a
  CSKL (EZACIC02) Listener transaction is assigned the same CICS
  transaction number running and each has the same count value in
  the REQID.
  

Local fix

• insure that the CSKL (EZACIC02) transactions are using different
  transaction numbers in each CICS region
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Releases 9, 10, 11, and   *
  *                 12 IP: CICS Sockets                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message EZY1362E issued because the     *
  *                      CICS Listener's EXEC CICS START of      *
  *                      child server task fails with IOERR      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When the CICS Listener program, EZACIC02, issues an
  EXEC CICS START in order to start a child server task, it
  specifies an 8-byte REQID parameter whose format is "Ltttcccc"
  where ttt is the listener task ID and cccc is a rotating
  count field.  If two different CICS regions have the CICS
  Listener running under the same task ID, then they can end up
  generating the same REQID.  And if they specify the same
  REQID on an EXEC CICS START that is function shipped to the
  same remote CICS region, then one of the EXEC CICS START
  requests will fail with IOERR and message EZY1362E.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• CICS Listener program EZACIC02 has been amended to generate a
  REQID in the format "Lsssssss" where sssssss is the bottom 7
  bytes of an STCK value.
  
  * Cross Reference between External and Internal Names
  

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:

  UK57929 UK57930 UK57931 UK57932

Modules/Macros

•    EZACIC02
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1A0 PSY UK57929

     UP10/07/14 P F007

• R1B0 PSY UK57930

     UP10/07/14 P F007

• R1C0 PSY UK57931

     UP10/07/14 P F007

• R190 PSY UK57932

     UP10/07/14 P F007

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.