Previous Topic: Utility SyntaxNext Topic: Control File Format

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

Parameter Descriptions

The following provides a description of each parameter:

[ inputdd ]

Indicates the ddname of the file containing the records to be converted. Specify the ddname on a CMS FILEDEF command before running VMTCON. The input file specified by the FILEDEF command can be a tape or disk file with an LRECL between 80 and 1000 bytes. It must consist of data to be converted to TMC format. The default input ddname is INPUT.

[ outputdd ]

Indicates the ddname specified on a previous CMS FILEDEF command for the output file to be created by VMTCON. The output file specified on the command line has a record length (LRECL) of 340 and contains records in the CA VM:Tape TMC format. It can be a tape or disk file and will contain data in a format acceptable to the VMTBUILD utility. The output file specified on the command line must not exist before VMTCON is executed. The default output ddname is OUTPUT.

[ ctlfn ]

Specifies the filename of the control file containing the field specifications for VMTCON. The filetype of the control file must be CONTROL. If ctlfn is not specified, the control fileid is VMTCON CONTROL.

[ REJECTS ]

Specifies that all records read from the input file that cannot be applied to the output file cause an informational message to be typed or printed if the option is also specified.

[ TYPE | PRINT ]

Specifies that informational messages about the formatting of the new file are displayed on the terminal (TYPE) or are printed on the virtual machine printer (PRINT).

[ USEREXIT filename ]

Specifies the CMS filename of a TEXT file to be dynamically loaded and called before converting each input record. At the point of entry, CA VM:Tape passes two parameters, an input record read from the input file and an output record buffer, to this exit using Register 1. After receiving this information, the exit performs one of the following actions indicated by the return codes shown:

[ VMTAPEID userid ]

Indicates the user ID of the CA VM:Tape service virtual machine. The default user ID is VMTAPE. Specify this option if your site uses a user ID other than VMTAPE.