System Programmer Reference › Utilities › VMBCPY Utility

VMBCPY Utility

Use the VMBCPY utility to correct invalid CMS files that may cause CA VM:Backup to perform a physical rather than a logical backup of a CMS minidisk.

VMBCPY can correct errors caused by assembler programs that use the full-block write facility of CMS EDF (extended disk format) and errors in CMS RDBUF and WRBUF macro routines, but it usually cannot correct multiple write errors, such as those resulting from multiple write access to the same CMS minidisk.

VMBCPY always copies the input file to an output utility work file named VMBCPY CMSUT1. If VMBCPY CMSUT1 exists when VMBCPY is invoked, this file is erased. When the utility successfully completes, the original output file is erased and VMBCPY CMSUT1 is renamed to the name of the original output file.

You can use the CMS COPYFILE command to achieve the same purpose as VMBCPY, but COPYFILE may not preserve CMS sparse files correctly.

Note: Do not use VMBCPY to copy Extended Control Program Support (ECPS) files or other nonstandard CMS files created by other software products.

This utility has the following format:

VMBCPY "Parms" [("Options"]

Parms:

filename1 filetype1 filemode1 [filename2 filetype2 filemode2]

Options:
[Balr | Svc]
[NEWFile | Replace]
[Olddate | NEWDate]
[Type | NOType]

Definitions

filename1 filetype1 filemode1

Specifies the input file. An asterisk cannot be specified in the filename (filename1) or filetype (filetype1) fields but can be specified as the filemode (filemode1). If filemode1 is specified as *, the first file found on an accessed minidisk in the CMS minidisk search order with the matching filename and filetype is used.

filename2 filetype2 filemode2

Specifies the output file to create. An equal sign can be specified in one or more of the file identifier fields to indicate that it is the same as the corresponding identifier in filename1 filetype1 filemode1. If filename2 filetype2 filemode2 is omitted, it defaults to = = =, indicating that filename1 filetype1 filemode1 is to be copied to itself.

Balr | Svc

Indicates the instruction VMBCPY is to use to call the CMS DASD I/O routines.

BALR causes VMBCPY to call the routines with the Branch and Link Register (BALR) instruction instead of the Supervisor Call (SVC) instruction, thus greatly improving VMBCPY performance. If you have modified CMS, BALR may not work because VMBCPY obtains the address of the I/O routines from CMS NUCON.

SVC causes VMBCPY to call the CMS DASD I/O routines with the SVC instruction instead of the BALR instruction. The SVC option reduces the performance gains of VMBCPY over COPYFILE, but may be necessary if you have a modified CMS system.

NEWFile | Replace

Indicates how to proceed when a file with the same fileid as the output file already exists.

NEWFILE specifies that an error message is to be displayed and the VMBCPY command is to end. To prevent existing files from being inadvertently destroyed, NEWFILE is the default when two fileids are specified.

REPLACE specifies that the output file is to replace the existing file. REPLACE is the default option when only one fileid is entered or when the output fileid is specified as = = =.

Olddate | NEWDate

Indicates the date and time to use as the creation date and time of the output file. OLDDATE uses the date and time of the input file. NEWDATE uses the current system date and time.

Type | NOType

Indicates whether to display (TYPE) or suppress display (NOTYPE) of the names of the input and output files at the terminal.