A fix is available
APAR status
Closed as new function.
Error description
DirMaint health checker support.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of DirMaint for z/VM 7.2.0. * **************************************************************** * PROBLEM DESCRIPTION: * **************************************************************** * RECOMMENDATION: APPLY PTF * **************************************************************** This support provides enhancements to improve the reliability, availability and serviceability of DirMaint. The changes include: * Automated IVP (Install Verification Procedures) - Automated tests to validate the various DirMaint servers and their interaction with each other and the rest of z/VM. * File Protection - Improvements to the DIRM FILE command so that well-known files are not accidentally placed on an incorrect disk. * Backup Correction - Changes to the DIRM BACKUP function to backup files that are not on the PDF (Primary Directory Files) disk, e.g. CONFIG* DATADVH.
Problem conclusion
Temporary fix
Comments
The following changes have been made to DirMaint: * Automated IVP (Install Verification Procedures) - DIRM IVP commmand allows an authorized user to start a combined IVP run on dirmaint, datamove and satellite servers or obtain the combined results from the dirmaint server. - DIRM DATAMOVE IVP command allows an authorized user to start an IVP run on a datamove machine or obtain the the results from the machine. - DIRM SATELLITE IVP command allows an authorized user to start an IVP run on a satellite machine or obtain the the results from the machine. - An automated IVP is begun as part of DirMaint new day processing. - The results of the automated IVP are sent as a file to the initiator or can be obtained using the IVP STATUS command. Each test is documented in Appendix G of the DirMaint Tailoring and Administration Guide. The documentation includes a description of the test, test override property descriptions, possible warnings that are generated for a test and recommended guidance to resolve the issue that caused the warning. - New configuration properties have been added to CONFIG SAMPDVH and CONFIG DATADVH files. These properties include: > IVP_DISABLE_TEST specifies specific tests that should not run. > IVP_MAX_DURATION specifies the maximum time that the IVP may run before it is considered to have failed. > IVP_NEW_DAY_START value controls whether the IVP is started by new day processing (DVHNDAY) which runs by default once a day at approximately 5 minutes after midnight. > IVP_NOTIFY_FOR specifies when notifications from a scheduled IVP run should be sent to the system progammer or other personnel responsible for maintaining the DirMaint product. > IVP_NOTIFY_TO specifies the user to receive notification of a scheduled IVP completion. > IVP_PARM specifies a configuration parameter to override a test default. > IVP_RUNMODE determines whether the IVP will execute when DirMaint is in the RUNMODE= state specified in the CONFIG* DATADVH file. - Enhanced the DIRM DASD, DIRM FREEXT and DIRM USEDEXT commands to not list overlaps between a special user ID ($DIRECT$, $PAGE$, $SPOOL$ and $TDISK$) and the related allocation extents (.DRCT., .PAGE., .SPOOL. and .TDISK.) when the extents exactly match or include cylinder 0. This avoids warnings on those extents which are expected when special user IDs are defined as recommended in "Special user IDs in the default user directory (USER DIRECT)" section in Chapter 7 of the z/VM: Installation Guide. - The DIRM DATAMOVE and DIRM SATELLITE commands support the RLDCODE and RLDDATA commands. * File Protection - The DIRM FILE command defaults to placing new files (ones that do not already exist in the dirmaint machine) on the dirmaint machine's A-disk. It is enhanced to not default well-known files to the A-disk but instead place them on the recommended disk. > Filetype PROTODIR files are placed on the E-disk by default. > CONFIG* DATADVH files are placed on the D-disk by default. * Backup Correction - The following files have been added to the set of files that are backed up: > CONFIG* DATADVH files on the B, C or D-disk, > * PROTODIR files from the E-disk, > DIRMAINT DATADVH file from the A-disk, > LOCAL DATADVH file from the E-disk, > POSIXUID CONTROL file from the E-disk, > RPWLIST DATA file from the E-disk. The following messages are added by this support: DVH2183W, DVH2184W, DVH3900I, DVH3901I, DVH3902W, DVH3903W, DVH3904W, DVH3905E, DVH3906I, and DVH3907I. Help files are provided for the new IVP command, new messages and updated commands enhanced by this support. The following z/VM 7.2 publications are updated to reflect this support: GC24-6282-02: Directory Maintenance Facility Messages SC24-6281-04: Directory Maintenance Facility Commands Reference SC24-6283-03: Directory Maintenance Facility Tailoring and and Administration Guide SC24-6287-04: Getting Started with Linux on IBM Z ×**** AE21/04/06 FIX IN ERROR. SEE APAR VM66273 FOR DESCRIPTION ×**** AE21/04/07 FIX IN ERROR. SEE APAR VM66274 FOR DESCRIPTION
APAR Information
APAR number
VM66175
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
2020-07-27
Closed date
2020-12-07
Last modified date
2022-03-28
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UV99389
Modules/Macros
ADVH AMDISK CONFIG DASD DATAMOVE DVHABLE DVHAEZ DVHBACK DVHBEGIN DVHBLDDP DVHBLDIP DVHCEXIT DVHCMD DVHDASDM DVHDMCTL DVHDSCTL DVHEXLD DVHFILE DVHFNDCS DVHILZBM DVHINITI DVHINITL DVHIVP DVHIV1 DVHIV2 DVHIV3 DVHMENUS DVHMON DVHMSG DVHNDAY DVHPROF DVHPXR DVHRDR DVHRECV DVHRELAY DVHRLDC DVHRLDD DVHRQST DVHSERVL DVHSSASG DVHSSCWU DVHSSMAI DVHSTUPD DVHUTUPD DVHWAIT DVHXMIT DVHXPP DVH2183 DVH2184 DVH3900 DVH3901 DVH3902 DVH3903 DVH3904 DVH3905 DVH3906 DVH3907 FILE FREEXT IVP SATELLIT UDVH USEDEXT 150ASERV 150AUSER 150CMDS
GC24628202 | SC24628104 | SC24628303 | SC24628704 |
Fix information
Fixed component name
IBM DIRMAINT-VM
Fixed component ID
5749DVH00
Applicable component levels
R720 PSY UV99389
UP20/12/11 P 2201
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"720","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]
Document Information
Modified date:
29 March 2022