A fix is available
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
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