System Programmer Reference › Commands › IMPORT Command

IMPORT Command

Authorization: SYSADMIN

Use the IMPORT command to convert job template, exception, and exclusion files from TPI format to the CA VM:Backup internal format. IMPORT also copies the converted files from the requesting user ID A-disk to the CA VM:Backup A-disk.

On a single IMPORT command, you can specify one file, two files of two different types, or three files (one of each type). For example, you can specify a job template file and an exception file. You cannot specify two or more files of the same type on a single command. For example, you cannot specify two job template files. You can specify the files in any order.

Note: The IMPORT command does not verify that the files are associated with each other. It imports them as independent files.

If you specify more than one file on the command line, all of the files must import successfully or none of them will import. Messages indicate whether the import of each file was successful. Another message indicates whether the IMPORT command completed successfully.

If any of the specified files already exist on the CA VM:Backup A-disk, you must use the REPLACE option, or the command fails.

If you enter the IMPORT command from the console, the specified files must be on the CA VM:Backup A-disk. You cannot issue the IMPORT command using CP SMSG.

This command has the following format:

IMPORT fileids... [("Options"...[)]]

Options:

DISK
NOTERM
REPlace
TEST

Definitions

fileids...

Specifies the filenames and filetypes of a job template file, an exception file, an exclusion file, or a combination of these files, all in TPI format. The filenames must be valid CMS filenames. The filetypes are as follows:

$TEMPLAT

Job template

$XCEPT

Exception

$XCLUDE

Exclusion

When CA VM:Backup converts the files to the CA VM:Backup internal format, it changes the filetypes to TEMPLATE, XCEPT, or XCLUDE.

DISK

CA VM:Backup writes diagnostic messages describing syntax errors in the input file. By default, CA VM:Backup writes diagnostic messages to the terminal only. DISK specifies that these messages are written to a file with the same filename as the file listed on the command. The filetype of the file is VMBMEMOn, where n is the position (1, 2, or 3) in which the TPI file appeared on the command line. CA VM:Backup creates one memo file for each specified file on the A-disk of the requesting user ID.

NOTERM

Specifies that CA VM:Backup does not write to the terminal diagnostic messages describing syntax errors in the input files.

REPlace

If this import creates a file with the same filename and filetype as one that already exists on the CA VM:Backup A-disk, REPlace overwrites the existing file with the new file. If such a file exists and you did not specify this option, the import fails.

TEST

Specifies that CA VM:Backup tests all input files for correctness, but does not create any output files on the CA VM:Backup A-disk.

Examples

• The job template file WEEKLY TEMPLATE exists on the CA VM:Backup A-disk. You want to convert the TPI job template file WEEKLY $TEMPLAT to the CA VM:Backup internal format and replace the existing file on the A-disk. Enter the following command:

  vmbackup import weekly $templat (replace
  

• You want to convert the TPI job template file FULLA $TEMPLAT and the TPI exception file FULLA $XCEPT to the CA VM:Backup internal format and write diagnostic messages to your A-disk. Enter the following command:

  vmbackup import fulla $templat fulla $xcept (disk