VM66298: DirMaint Performance Enhancements

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The DirMaint Performance Enhancements will improve DirMaint
  performance for multi-member SSI and non-SSI configurations.
  
  The goal of the enhancements is to improve the throughput of
  DirMaint when a number of requests are submitted to the server
  at the same time during provision or deprovision of customer
  systems or when changes are being made to a large number of
  userids.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the Directory Maintenance       *
  *                 Facility.                                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION: APPLY PTF                                    *
  ****************************************************************
  The PTF for APAR VM66298 provides enhancements to DirMaint that
  are intended to improve the performance of the DirMaint servers
  and enhance the automated IVP (installation verification
  program) to further detect additional problems.
  

Problem conclusion

Temporary fix

Comments

• The performance enhancements improve the throughput of DirMaint
  requests in the environment where DirMaint is managing multiple
  z/VM systems using satellite servers by doing the following:
  
  - Reducing the types of requests that require DirMaint servers
    to obtain the intersystem locking disk for serialization of
    changes to the source directory. Commands that do not change
    source-directory-related files no longer obtain the lock.
    This reduces the possibility of delays in updating the object
    directories due to either DirMaint or the satellite servers
    requiring the lock while the another server requires it.
  
  - Improving throughput of requests that require the DirMaint
    server to interact with the satellite servers or DATAMOVE
    servers. Responses from satellite and DATAMOVE servers are
    given priority over new requests from non-DirMaint servers.
  
  Enhancements to the automated IVP are intended to prevent
  future problems, detect current problems, or reduce the
  complexity of interacting with DirMaint to perform debugging
  operations. The following new tests have been added and
  are documented in the z/VM 7.2.0 Directory Maintenance
  Facility Tailoring and Administration Guide (SC24-6283-04).
  
  o Test 0030 - DM0030
      This test verifies that the DirMaint and satellite servers
      are configured for UPDATE_IN_PLACE. (See page 246)
  o Test 0210 - DA0210 DM0210 and DS0210
      This test verifies that non-informational messages have not
      been generated by the server within the last 24 hours.
      (See page 249)
  o Test 0220 - DA0220 DM0220 and DS0220
      This test verifies that the server termination messages
      (DVHxxx2194T or DVHxxx3895T) have not been generated within
      the last 24 hours. (See page 250)
  o Test 0880 - DM0880
      This test verifies that the DATAMOVE machines do not own
      disks that are related to previously failed or canceled
      work units. (See page 264)
  

APAR Information

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

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

  UV99411

Modules/Macros

• DVHBATCH DVHBEGIN DVHBLDDP DVHCHGID DVHDSCTL DVHGET   DVHIVP
  DVHIV1   DVHIV3   DVHIV4   DVHMERO  DVHMON   DVHMSG   DVHPROF
  DVHPURGE DVHQUEUE DVHRDR   DVHRQST  DVHSSDMD DVHSSTMD DVHWAIT
  

Fix information

• Fixed component name

  IBM DIRMAINT-VM

• Fixed component ID

  5749DVH00

Applicable component levels

• R720 PSY UV99411

     UP22/03/17 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.