VMXBKP01 utility documentation update

book

Article ID: 144473

calendar_today

Updated On:

Products

CA VM:Secure for z/VM

Issue/Introduction

VMXBKP01 utility doesn't work as documented with regard to R/W disk.
VMXBKP01 utility documentation update 

Cause

Doc updated needed.

Environment

Release : 3.2

Component : CA VM:Secure for z/VM

Resolution

The VMXBKP01 code has never supported what's in the documentation as far as using the first R/W minidisk for the output. It has always only put the output to the 'A' disk, though once upon a time you could go to tape.

VMXBKP03 says the same thing but what it actually does is find the first free filemode to use to access the vaddr you specify vs. the first R/W disk.

The documentation for both utilities has been updated.

Additional Information

We made some minor corrections to the documentation for the VMXBKP01 utility and the VMXBKP03 utility in the VM:Secure Reference guide.


For VMXBKP01, in the following:
Description
Each directory entry file on the DRCT minidisk is appended to a temporary file containing a DIRECT directory control statement. After all directory entries are appended, the temporary file is renamed to USER DIRECT. VMXBKP01 copies the USER DIRECT file to the A-disk or the first read/write disk accessed and erases the BKUP minidisk, because all recent changes are now backed up in the USER DIRECT file.An encrypted database is decrypted when the single source file, USER DIRECT, is created through a CA VM:Secure backup utility.The VMXBKP01 utility supports the INCLUDE directory statement.
**  Changed what's in bold italic above to:
VMXBKP01 copies the USER DIRECT file to the A-disk of the requesting user and erases the BKUP minidisk, because all recent changes are now backed up in the USER DIRECT file.  


For VMXBKP03, in the following:
filemode
Specifies the filemode of your backup minidisk. If this parameter is omitted, then the first available Read/Write filemode is used.  
Changed the bold italic text above to:
If this parameter is omitted, then the first free filemode between B and Z is used.