Skip to main content

IBM Systems  >   System z  >   z/VM  >  

IBM Directory Maintenance 1.5.0 for VM/ESA (DirMaint™)

Product Number: 5748-XE4 - Release: 5.0

Last updated: 2004-08-31     (Subscribe to updates)

Table of Contents

  1. Latest News
  2. Environments Supported
  3. Current Install Bucket
  4. Current Preventive Service
  5. Current Program Directory
  6. Online Publications
  7. Other Online Documentation

IBM Directory Maintenance for VM/ESA (DirMaint) is a CMS application that helps manage an installation's VM directory.

Refer to overview.html for a more complete overview.

Note: IBM, VM/ESA, z/VM, and DirMaint are trademarks or registered trademarks of the International Business Machines Corporation.

Latest News

Important: Before applying any DirMaint service via RSU or SDO in the year 2000 (or later), you must first apply the PTF for VMSES/E APAR VM62316. Refer to: http://www.vm.ibm.com/service/news/vm62316.html for more details.

2004-08-03:
The DirMaint Product release 5 will become unsupported as of 2005-12-31. Customers using DirMaint release 5 on z/VM 3.1.0 or earlier should migrate to z/VM Version 4 or z/VM Version 5 with the corresponding DirMaint Function Level as a pre-installed but optional priced feature.

2003-11-13:
DirMaint release 5 recommended service upgrade (RSU) number 0301 is now available as PTF UV99150. Several new function APARs are included, including support for z/VM 3.1.0.

Note: Before applying RSU 9703, or later, please issue a DIRM QUERY DVHLEVEL command and check the result. If the current service level is 9702, or earlier, please see the special considerations for applying PTF UV59982 for APAR VM60509 which is now included on the RSU.

Note: If you are migrating from CMS Level 12 (VM/ESA 2.1.0), or earlier, please refer to the CRC Migration instructions.

1997-11-14:
If your DIRMAINT server has a USER INPUT file in the search order, please RENAME it (or them) to USER INPUTOLD. Refer to APAR VM61398 for further information. (PTF UV60086 corrects this problem and is included on RSU 9704, and later.)

In addition, VM/ESA and z/VM Service News is available at: "http://www.vm.ibm.com/service/".

Environments Supported

DirMaint release 5 became generally available in October of 1995, and (until 2005-12-31) supports VM/ESA releases:

VM Version DirMaint
PTF####
DirMaint
APAR###
DirMaint
RSU
VM/ESA 1.1.5n/anonenone
VM/ESA 1.2.1n/anonenone
VM/ESA 1.2.2n/anonenone
VM/ESA 2.1.0n/anonenone
VM/ESA 2.2.0UV59818VM605389701
VM/ESA 2.3.0UV60087VM613719704
VM/ESA 2.4.0UV60428VM621479901
z/VM 3.1.0UV60621VM626090101

DirMaint R5 is believed to function on z/VM V4, provided that your directory entries only contain statements that are valid on z/VM V3 and earlier; however, this is not a supported environment. DirMaint R5 will not be "fixed" to run on z/VM V4 and is not being enhanced to support z/VM V4 directory statements.

Note: If you are migrating from CMS Level 12 (VM/ESA 2.1.0) or earlier, to CMS level 13 (VM/ESA 2.2.0) or later, please refer to the CRC Migration instructions.

Note: If you have DFSMS function level 221 installed, please refer to the setting up for DFSMS instructions; in addition to applying:

  • DFSMS PTF UM27392 for APAR VM59612,
  • DFSMS PTF UM29324 for APAR VM60140,
  • DFSMS PTF UM29738 for APAR VM62522,
  • and DirMaint PTF UV60579 for APAR VM62600 (on RSU 0101 via PTF UV99150).

Note: If you have RACF 1.9.2 installed, you must have RACF PTF UV59556 for APAR VM60078 applied.

Current Install Bucket

As of 2005-06-10, the most recent updates to the DIRM150 DIRM/150 Preventive Service Planning (PSP) "bucket" are:

  • 1997-05-28 - Section 1 - Installation Information
  • 1997-01-29 - Section 2 - Documentation Updates
  • 2001-01-18 - Section 4 - Service Recommendations
  • 1999-07-15 - Section 5 - Cross-Product Dependencies (DFSMS, RACF)

Current Preventive Service

Important: Before applying any DirMaint service via RSU or SDO in the year 2000 (or later), you must first apply the PTF for VMSES/E APAR VM62316. Refer to: http://www.vm.ibm.com/service/news/vm62316.html for more details.

As of 2003-11-13, the latest DirMaint release 5 recommended service upgrade (RSU 0301) is available as PTF UV99150. The RSU includes new function APARs as well as PTFs to prevent encountering problems that have already been reported and fixed. You can use a DIRM QUERY DVHLEVEL command to determine your current DirMaint service level.

Note: Before applying RSU 9703, or later, please issue a DIRM QUERY DVHLEVEL command and check the result. If the current service level is 9702, or earlier, please see the special considerations for applying PTF UV59982 for APAR VM60509 which is now included on the RSU.

Current Program Directory

As of 2000-02-09, the latest DirMaint release 5 Program Directory is available as PTF UV98150. A 38PP or 3820 family printer is required to print this, along with the fonts from BookMaster release 4. If you do not have a suitable printer (or the BookMaster fonts), you can download the Program Directory to a PostScript family printer, or to a Adobe Portable Document Format (PDF) printer, which may be viewed using a freely downloadable Adobe Acrobat Reader, or contact DirMaint support (see below) and we'll mail you a copy.

The test instructions in appendix A.1, A.2, and A.3 of the DirMaint 1.5.0 Program Directory are specifically designed to systematically test the functions of the DirMaint product in a sequence such that the point of failure, if any, isolates the cause and identifies the necessary corrective action. After a period of production, there is small likelihood that this procedure will encounter any problem, and is unnecessarily involved for routine regression testing. Our new fast test provides an easier and faster alternative. If the test is successful, testing is complete. If the test fails, there is no indication of the cause; return to and follow the more detailed steps to isolate the cause and identify the solution.

Online Publications

You may:

Other Online Documentation

You may:



If you'd like to contact DirMaint development and support, you can

Thank you for visiting this web page. Please visit again next month and check out the latest news. (Or, subscribe to future updates.)