IBM Directory Maintenance for z/VM (DirMaint™)

Updated: 2022-05-12
| 05-12-2022: updated to add information on new function APARS for DirMaint FL720
Subscribe to be notified whenever this page changes

DirMaint Overview
IBM Directory Maintenance (DirMaint) for z/VM is a CMS application that helps manage an installation's VM directory. Directory statements can be added, deleted, or altered using the DirMaint directory statement-like commands. DirMaint provides automated validation and extent allocation routines to reduce the chance of operator error. [ More ]

With z/VM V7, DirMaint is a priced, optional feature and is automatically shipped on the z/VM V7 base product media: See the announcement letter for further details, z/VM 7.2.

The priced, optional feature of the IBM Directory Maintenance Facility (DirMaint) has released a new function level (FL720) in z/VM V7.2. DirMaint FL720 includes all service applied since FL710 plus support is added for the z/VM upgrade installation procedure exit (UPGDVHXT EXEC). This exit provides the interface between the z/VM upgrade installation procedure and DirMaint so that DirMaint can be used for all of the directory updates associated with the upgrade installation. In order for this exit to work successfully, some DirMaint configuration is necessary. If you plan to use the z/VM upgrade installation procedure with DirMaint, please see Appendix C. Preparing for the z/VM Upgrade Installation Procedure here.

The Directory Maintenance Facility (DirMaint), function level 720, includes a change in the default value of the configuration option, NEEDPASS_RESPECT= NO|YES. When the value is NO, DirMaint will no longer prompt for passwords. This is now the default value. For compatibility, the NEEDPASS_RESPECT configuration option can be set to YES. Specifying YES indicates to DirMaint that password prompting should occur based on the user's DIRM NEEDPASS command setting.

In addition, the default values for DVHWAIT_BATCH_INTERVAL= and DVHWAIT_CLUSTER_INTERVAL= have been updated to improve DirMaint's overall processing time in response to directory change requests.

DVHWAIT_BATCH_INTERVAL= 00:00. The new value eliminates the default wait of one second wait between requests that are handled by the servers.

DVHWAIT_CLUSTER_INTERVAL= 00:01. The new value reduces the wait by the DirMaint server when it detects that the source directory is being used by the satellite servers from 15 seconds to 1 second. Waiting 15 seconds is too long for most environments.

z/VM Continuous Delivery New Function APARs for DirMaint FL720

APAR VM66175 - DirMaint Health Checker; INFO APAR II14866; APAR VM66273

While 'Health Checker' is a bit of a misnomer, the support added with these APARs creates an initial verification program (IVP) for DirMaint which is run automatically daily and on demand using the DIRM IVP command. The IVP runs a set of tests which look at the setup of the DirMaint servers as well as specific files, etc, in the running servers and warns the user via the IVP status file when errors are found.

For more information, please see the documentation for the DIRM IVP command in the DirMaint Commands Reference and the following in the DirMaint Tailoring and Administration Guilde:

Chapter 3. Tailoring the DIRMAINT Service Machine, Step 6. Select IVP Characteristics under 'CONFIG DATADVH'.

Chapter 11. "Installation Verification Procedure (IVP)"

Appendix G. Tests run by the Automated IVP. Please note this section includes a list of the tests that are run along with a description of error/warnings received and steps you can take to correct any errors/warnings found.

APAR VM66298 - DirMaint Performance Enhancements

The performance improvements to DirMaint include the processing of user and server requests. Also, additional tests related to performance and reliability are added to the automated IVP introduced in the VM66175 new function APAR listed above.

General Information


Obtaining service

Online Support for z/VM where you can:

DirMaint service can be ordered on-line at IBM Shopz "Ordering Service" with ordering information tips available here.

Instructions for testing service.

End of Service dates

Hints and Tips

Note: *
All statements regarding IBM's plans, directions, and intent are subject to change or withdrawal without notice. Any reliance on this Statement of Direction is at the relying party's sole risk and will not create any liability or obligation for IBM.