PH72091: IMS TOOLS COMMON PAUSER DOES NOT PAUSE CICS AND ODBA APPLICATIONPROCESSING WHEN A /DBR AREA COMMAND IS ISSUED VERSUS A /DBR DB

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In an environment where the CICS and ODBA applications pause
  feature of IMS Tools Common Pauser is used to pause CICS and
  ODBA application processing, the applications are not paused
  when the invoking product issues a /DBR AREA command instead of
  a /DBR DB command.
  
  Consequently, CICS and ODBA applications continue to run and may
  receive DL/I status codes, such as FH, for requests against the
  affected DEDB area. The FH status code indicates that a DEDB
  area was inaccessible to the requested service.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of IBM IMS Tools Base for z/OS                     *
  * Version 1 Release 8 (FMID HAHN180) who use                   *
  * the IMS Tools Common Pauser, either directly                 *
  * or through products that invoke IMS Tools                    *
  * Common Pauser, such as the Online Structure                  *
  * Change (OSC) utility in IBM IMS Fast Path                    *
  * Solution Pack for z/OS.                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The CICS and ODBA applications pause                         *
  * feature of IMS Tools Common Pauser does                      *
  * not suspend processing by CICS and ODBA                      *
  * applications when a /DBR AREA command                        *
  * is issued for a DEDB area instead of                         *
  * a /DBR DB command.                                           *
  *                                                              *
  * As a result, CICS and ODBA applications                      *
  * continue processing and might receive                        *
  * DL/I status codes, such as FH, for                           *
  * requests against the affected DEDB                           *
  * area. The FH status code indicates that                      *
  * the DEDB area is inaccessible to the                         *
  * requested service.                                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the maintenance provided by this APAR.                 *
  * If you use the CICS and ODBA applications                    *
  * pause feature, regenerate the DFSDBCTG module                *
  * that is customized for use with IMS Tools                    *
  * Common Pauser.                                               *
  *                                                              *
  * For detailed instructions, see                               *
  * "(Optional) Enabling the CICS and ODBA                       *
  * applications pause feature" in the IBM IMS                   *
  * Tools Base for z/OS 1.8 Configuration Guide.                 *
  ****************************************************************
  The CICS and ODBA applications pause feature of IMS Tools
  Common Pauser suspends PSB scheduling (allocation) requests
  while a pause condition is in effect.
  
  Before this APAR, the function detected a pause condition only
  when a /DBR DB command had been issued for the target database.
  When the target resource was a DEDB area, IMS Tools Common
  Pauser did not detect a /DBR AREA condition. Consequently, the
  pause function was not activated for DEDB areas that were
  stopped by using the /DBR AREA command.
  
  This APAR adds detection of /DBR AREA conditions for DEDB
  areas, enabling the CICS and ODBA applications pause feature
  to function correctly when a /DBR AREA command is used.
  

Problem conclusion

• The following modules have been modified:
  FOIUINST, FOIVINS0, FOIVINS2
  
  The following sample JCL member has been modified:
  FOIVCAP1
  

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:

  UO08625

Modules/Macros

• FOIUINST FOIVCAP1 FOIVINS0 FOIVINS2
  

Fix information

• Fixed component name

  IMS TOOLS BASE

• Fixed component ID

  5655V9300

Applicable component levels

• R180 PSY UO08625

     UP26/07/18 I 1000

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.