PH14138: A MESSAGE ATY3702E ISSUES WHEN IXGWRITE TEMPORARY ERROR (RC=X'08/RSN=X'0868') OCCURS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IMS Administration Tool issues a message ATY3702E and ends with
  an error return code when IXGWRITE macro returns RC=X'08 and
  RSN=X'0868'.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Administration Tool for     *
  *                 z/OS (FMID=HALC110)                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Administration Tool erroneously issues  *
  *                      a message ATY3702E and ends with an     *
  *                      error return code when IXGWRITE macro   *
  *                      returns RC=X'08 and RSN=X'0868'.        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Administration Tool writes audit or command log records into
  z/OS log stream using IXGWRITE macro. When a staging data set
  of the log stream is being formatted, IXGWRITE macro returns
  a return code X'08' and a reason code X'0868'.
  This error is a temporary error, but Administration Tool
  back-end erroneously issues a message ATY3702E and aborts a
  process.
  In addition, the following IMS user exit load modules supplied
  by IMS Administration Tool erroneously issue a message
  ATY8107E.
  - IMS Automated Operator user exit routine : ATYAOE00
  - IMS BPE exit routine : ATYOPST0
  

Problem conclusion

• By this APAR, Administration Tool back-end suppresses a message
  ATY3702E and continues a process even if IXGWRITE macro returns
  a return code X'08' and a reason code X'0868'.
  When IMS Administration Tool back-end detects the return and
  reason code, it does not write the log record and issue a
  message ATY3704I.
  
  In addtion, ATYAOE00 and ATYOPST0 load modules have been
  modified to suppress a message ATY8107E even if IXGWRITE
  macro returns a return code X'08' and a reason code X'0868'.
  When IMS Administration Tool detects the return and reason code,
  it retries writing a log record until the end of formatting.
  The retries continues up to 4 minutes. If the formatting does
  not ended after 4 minutes, IMS Administration Tool stops
  writing the log record and issues the message ATY8409I.
  The load modules should be copied to the STEPLIB of IMS control
  region and OM region.
  

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:

  UI64406

Modules/Macros

• ATY#AUD  ATY#MENU ATY#MSG0 ATYAOE00 ATYAOUEC ATYAOUED ATYAOUEE
  ATYAOUEF ATYOPST0
  

Fix information

• Fixed component name

  IMS ADMIN TOOL

• Fixed component ID

  5655CAT00

Applicable component levels

• R110 PSY UI64406

     UP19/07/27 P F907

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.