IBM Support

VM66298: DirMaint Performance Enhancements

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    VM66298

  • Reported component name

    IBM DIRMAINT-VM

  • Reported component ID

    5749DVH00

  • Reported release

    720

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2021-08-31

  • Closed date

    2022-03-16

  • Last modified date

    2023-01-23

  • 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
    

Publications Referenced
SC24628304    

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SG27M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"720","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]

Document Information

Modified date:
24 January 2023