Utility Reference › OS TMC Utility › VMTBUILD Utility (CMS TMCs Only) › Parameter Descriptions

Parameter Descriptions

The following provides a description of each parameter:

TMC

Specifies that a TMC file is to be created. Use this parameter to create the initial TMC. You can also use this parameter to add SERIES records to an existing TMC, remove SERIES records from a TMC, split a TMC, or recreate a TMC from a backup TMC and Audit file if the TMC is lost. CA VM:Tape obtains the TMC fileid from the CMSTMC record in the VMTAPE CONFIG file; the TMC fileid must not already exist. Also, CA VM:Tape obtains SERIES records from the VMTAPE CONFIG file to determine the tape volsers to be included in the new TMC.

ddname₁ [...[ddname_10]]

Specifies up to 10 input file ddnames that contain TMC or Audit file record images. CA VM:Tape applies the records to the new TMC in the order specified.

Before issuing the VMTBUILD command, you must issue a CMS FILEDEF command for each ddname specified on the command line. The input files you specify on the FILEDEF commands can be on tape or disk.

AUDIT

Specifies that an Audit file is to be created. CA VM:Tape obtains the Audit fileid from the CMSAUDIT record in the VMTAPE CONFIG file; the Audit fileid must not already exist.

[ CONFIG filename ]

Specifies the name of the configuration file containing the SERIES, CMSTMC, and CMSAUDIT records that define the output files. The filetype is CONFIG. The file can reside on any accessed disk. If not specified, filename defaults to VMTAPE.

[ DELETE ]

Specifies that all TMC records are to be marked as deleted volumes instead of scratched volumes when there is no input volume record that matches a new TMC record. (SCRATCH is the default status.) Volume records marked as being deleted in the TMC are placeholders for future expansion; that is, there is no corresponding real tape in the library, although there is expected to be one in the future.

Tapes with a deleted status can be made available for scratch use with the TAPEINIT command.

Note: For more information about the TAPEINIT command, see Command Reference Guide.

If you have specified one or more ddnames on the command line, the input file that has a matching record in the TMC will be applied, thereby overlaying the deleted record. The only records that remain deleted when a new TMC is built are those not overlaid by any of the records in the input files.

[ PRINT ]

Specifies that informational messages about the formatting of the new files should be printed on the virtual machine printer and on the console.