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
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
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
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.
- z/VM V7.2 library
- z/VM V7.1 library
- z/VM V6.4 library
- z/VM V6.3 library
- z/VM V6.2 library
- z/VM V5.4 library
- Command Set Summary for DirMaint: ALL.
Program Directories for DirMaint:
Obtaining service Online Support for z/VM where you can:
Instructions for testing service.
Hints and Tips
- Cross System Extension (CSE) information.
- How to free a stalled DATAMOVE machine.
- Requirements and requisites when using DFSMS minidisk management functions.
- Correcting DIRM PW? command problems.
- No, encryption of the directory is not required.
- Performance tips.
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.