PI44099: THE OUCBNDS COUNT FOR SYSTEM AUTOMATION NETVIEW INCREMENT INCORRECTLY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer issue multiple IMS commands via a REXX program under
  the System Automation NetView (SYSVIEW). As result of the
  command processing, the OUCBNDS count in the SRM control block
  gets incremented twice for each registration, but decremented
  only once during deregistration.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IMS V14 SCI users.                                       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * TRANSWAP return code is                                      *
  * not handled correctly.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * INSTALL CORRECTIVE SERVICE FOR APAR/PTF                      *
  ****************************************************************
  When a member registers with SCI, SCI must ensure that
  the address space is non-swappable.  It does this with
  the SYSEVENT TRANSWAP service.  z/OS keeps a count that is
  incremented by a TRANSWAP (or a DONTSWAP) and decremented
  by a OKSWAP.
  
  When a TRANSWAP is issued, it returns with a return code
  of 0 or 4.  If the return code is 0 and an ECB was passed,
  the request was accepted and SCI waits on the ECB.  A return
  code of 4 indicates that the address space was already non-
  swappable and no further action is required.  The count is
  incremented with a return code of 4.
  
  When the ECB is POSTed, a post code is returned in the
  right most 3 bytes.  If the post code is 0, the address space
  space is non-swappable and the count was incremented.  If
  the post code is 4, the address space is non-swappable, but
  the count was not incremented.  SCI must issue a DONTSWAP
  which will increment the counter.
  
  SCI issues the DONTSWAP for both a non-zero return code
  from the TRANSWAP and for a non-zero POST code from the
  WAIT.  For address spaces that are already non-swappable,
  the counter is incremented twice but only decremented once
  during SCI deregistration.
  
  In the reported problem, an IMSplex member was in a loop
  where it registers with SCI, issues a command through OM,
  and deregisters from SCI.  The z/OS counter eventually
  wrapped.
  
  Also, while researching this problem, it was noticed that
  the resource manager that monitors the IMSplex member for
  SCI does not issue the OKSWAP for the abnormal termination
  path.
  
  While unit testing this APAR, it was noticed that the Member
  History Table does not reflect the correct deregistration type
  if a local member does an abnormal deregistration.
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
      The logic is changed in CSLSRG20 to only issue the DONTSWAP
    if the POST code is non-zero.  An OKSWAP is added to CSLSRM20.
  
  
      Modules Changed
      ===============
  
      CSLSRGS0
        When building the MHTE entry, if the member
        has a CMBR block and the deregistration was
        abnormal, set SCOD_SCDRGA in the MHTE.
        Otherwise, use the AWE function.
  
      CSLSRG20
        Only issue the DONTSWAP if a non-zero POST code
        is received.
  
      CSLSRM20
        A OKSWAP is added for the IMSplex member abnormal
        termination.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PI32934

• APAR is sysrouted TO one or more of the following:

  UI30117

Modules/Macros

• CSLSRM20 CSLSRGS0 CSLSRG20
  

Fix information

• Fixed component name

  IMS V14

• Fixed component ID

  5635A0500

Applicable component levels

• R400 PSY UI30117

     UP15/08/18 P F508

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.