VM:Tape's VMTDLMUT utility

Document ID : KB000073210
Last Modified Date : 14/03/2018
Show Technical Document Details
Introduction:
VM:Tape's VMTDLMUT utility. 
Background:
VM:Tape r2.0 PTF RO94878 introduced a new VM:Tape utility that can be used to change the status of a tape volume in the EMC Disk Library for Mainframe (DLM) database. 
The utility is a stand alone module called VMTDLMUT.
 
 
 
Environment:
Driving tape mounts to a EMC Disk Library for Mainframe (DLM) database.
Instructions:
Use the VMTDLMUT utility to change the status of a volume in the EMC Disk Library for Mainframe (DLM) database.
The VMTDLMUT utility changes the status of a single volume per execution; for example, to change the DLM database status of the specified volume to a status of SCRATCH.
The VMTDLMUT utility requires that the CA VM:Tape server is running, and verifies the following conditions:
  • The user executing the VMTDLMUT utility has VMTLIBR authorization; VMTLIBR authorization is required.
  • The volume that is specified for the VMTDLMUT utility is in the CA VM:Tape TMC. If the volume is not in the CA VM:Tape TMC, the VMTDLMUT utility execution aborts and the change is not made.
  • The current status (SAVED, SCRATCH, or DELETED) of the volume specified for the VMTDLMUT utility in the CA VM:Tape TMC. If the VMTDLMUT utility function specified is inconsistent with the current status of the volume in the CA VM:Tape TMC, the VMTDLMUT utility execution aborts. For example, if you request the VMTDLMUT utility to change the status of the volume in the DLM database to SCRATCH, and the status of the volume in the CA VM:Tape TMC is SAVED, the VMTDLMUT utility execution aborts and the change is not made. 
The VMTDLMUT utility logs all transactions that are executed (not aborted due to one of the previously listed conditions) to the file named DLMLOG LISTING on the CMS minidisk or SFS directory accessed
at filemode A.   If the file does not exist, it is created. If the file already exists, then it is appended to.

 
 
 
 
Additional Information:
For complete VMTDLMUT utility information and usage, see the CA VM:Tape for z/VM - 2.0 Utility Reference page for the VMTDLMUT Utility which can be accessed at:
    https://docops.ca.com/ca-vm-tape-for-zvm/2-0/en/administrators/utility-reference/vmtdlmut-utility-cms-and-os-tmcs