PI15217: NEW MESSAGE NEEDED TO INDICATE TIMEOUT BECAUSE OF SYSTEM SLOW-DOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• New message is needed to indicate a timeout because of system
  slow-down.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Index Builder for z/OS,     *
  *                 Version 3 Release 1 (FMID=H22O310)           *
  ****************************************************************
  * PROBLEM DESCRIPTION: It's difficult for uses to distinguish  *
  *                      a timeout termination because of        *
  *                      sytem slow-down from termination due    *
  *                      to other errors. A new WTO error        *
  *                      message is needed.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR fixes the problems listed in the Problem Description
  field.
  

Problem conclusion

• This APAR fixes the problems listed in the Problem Description
  field.
  
  After apply this APAR, when the progress of the index build
  process, which is shown by the IIUTMRXT 618 log, is suspended
  longer than the time specified by the TMRWAIT control statement
  (5 minutes is default), a new WTO message MSGIIUB102E is issued
  as follows, and all of the active subordinate address spaces and
  the main address space are terminated forcedly.
  
   IIUB102E INDEX PROCESS TERMINATED FORCEDLY DUE TO A TIMEOUT
   DFS627I IMS RTM CLEANUP ( EOT ) COMPLETE
   IIUB798E SUBORDINATE ADDRESS SPACE IS BEING ABENDED:...
  
  The cause of the suspension might be a system slow-down.
  
  ========================
  = Documentation Change =
  ========================
  IBM IMS Index Builder for z/OS, V3R1, User's Guide
  (SC18-9101-04) should be changed as follows:
  
  ================================================================
   3.4 IMS Index Builder messages
  
  | IIUB102E INDEX PROCESS TERMINATED FORCEDLY DUE TO A TIMEOUT
  |
  | Explanation: The index process was terminated forcedly due to
  | a timeout. The timeout value can be changed by the TMRWAIT
  | control statement. For the details, see 'TMRWAIT control
  | statement'.
  | System action: Processing stops.
  | User Response: The cause might be a system slow-down.
  | Increase the TMRWAIT value and rerun the job.
  ----------------------------------------------------------------
   IIUB798E SUBORDINATE ADDRESS SPACE IS BEING ABENDED:
  |         JOBID=xxxxxxxx
  
   Explanation: The master address space determined that the
   subordinate address space did not end as expected.
  |The subordinate address space to be terminated is identified by
  |jobid. Its jobname is shown in the address spaces report.
   System Action: An abend U0798 request is made in the subordinat
   address space.
   User Response: Locate preceding messages from the subordinate
   on the console log and the job output from the master
   address space and contact IBM Support.
  ----------------------------------------------------------------
    IIUB799E SUBORDINATE ADDRESS SPACE IS BEING TERMINATED:
  |         JOBID=xxxxxxxx
  
   Explanation: The master address space determined that the
   subordinate address did not end as expected. Either an abend
   could not be requested or the abend was not successful.
  |The subordinate address space to be terminated is identified by
  |jobid. Its jobname is shown in the address spaces report.
   System Action: The address space is ended.
   User Response: Locate preceding messages from the subordinate
   on the console log and the job output from the master address
   space and contact IBM Support.
  ----------------------------------------------------------------
  
  ================= End of Documentation Change ==================
  

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:

  UI16973

Modules/Macros

• IIUBMSGS IIUSTART IIUTMRXT
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels

• R310 PSY UI16973

     UP14/04/13 P F404

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.