Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS System Management Utilities Reference Manual
Previous Contents Index

/CONFIRM

Input File-Selection Qualifier

Displays prompts on your terminal for confirmation before processing each file. If you want the file to be processed, enter Y or YES and press Return.

Format

input-specifier/CONFIRM output-specifier

Example


$ BACKUP *.LIS/CONFIRM/LOG  DLA2:LIST.BCK/SAVE_SET
DISK$DEFAULT:[WONDER]CRE.LIS;1, copy? (Y or N): Y
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRE.LIS;1
DISK$DEFAULT:[WONDER]CRETIME.LIS;1, copy? (Y or N): Y
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRETIME.LIS;1
DISK$DEFAULT:[WONDER]EXC.LIS;1, copy? (Y or N): Y
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]EXC.LIS;1
DISK$DEFAULT:[WONDER]REB.LIS;1, copy? (Y or N): N
DISK$DEFAULT:[WONDER]SETREB.LIS;1, copy? (Y or N): Y
%BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]SETREB.LIS;1
DISK$DEFAULT:[WONDER]VERS.LIS;1, copy? (Y or N): N
. 
. 
. 
$

This command locates all files with a file type of .LIS and prompts for confirmation before saving each file to LIST.BCK on DLA2. The command qualifier /LOG displays information about each file as it is processed. Note that you must use the output save-set qualifier /SAVE_SET when creating a save set on disk.

/CONVERT

Input File-Selection Qualifier

Converts ODS-5 file names to ODS-2 file names. To preserve the output volume as ODS-2, you must also use the /NOINIT qualifier.

Be aware that all ODS-5 file attributes are lost if you convert from ODS-5 files to an ODS-2 volume.

Format

input-specifier/CONVERT output-specifier

Example


$ BACKUP/LOG/CONVERT/IMAGE DKA500: DKA200:[000000]IMAGE.BCK/SAVE

The command in this example creates an ODS-2 image save set from an ODS-5 disk. The save set can be read by a system running a version of OpenVMS prior to Version 7.2.

/CRC

Input Save-Set Qualifier

Specifies that the software cyclic redundancy check (CRC) is to be performed.

Format

input-save-set-spec/[NO]CRC output-specifier

Description

The default is /CRC. To disable CRC checking, specify /NOCRC; note that use of /NOCRC reduces processing time but increases the risk of data loss.

Example


$ BACKUP MTA2:988SAVE.BCK/NOCRC []

This command restores the save set 988SAVE.BCK to the current default directory, indicated by ([]); the input save-set qualifier /NOCRC disables CRC.

/CRC

Output Save-Set Qualifier

Specifies whether the software cyclic redundancy check (CRC) is to be computed and stored in the data blocks of the output save set.

Format

input-specifier output-save-set-spec/[NO]CRC

Description

The default is /CRC. To disable checking, use /NOCRC; note that use of /NOCRC reduces processing time but increases the risk of data loss.

Example


$ BACKUP/RECORD []/SINCE=BACKUP MTA2:988SAVE.BCK/NOCRC

This command saves all files in the current default directory that have been created or modified since the last BACKUP/RECORD operation to the save set 988SAVE.BCK; the output save-set qualifier /NOCRC disables cyclic redundancy checking.

/CREATED

Input File-Selection Qualifier

Selects files according to the value of the creation date field in each file header record.

Format

input-specifier/BEFORE=time/CREATED output-specifier

input-specifier/SINCE=time/CREATED output-specifier

Description

You must use either the /BEFORE qualifier or the /SINCE qualifier with /CREATED. The date and time you specify with /BEFORE or /SINCE determine which files should be processed.

You cannot use /CREATED with the /BACKUP, /MODIFIED, or /EXPIRED qualifiers.

Example


$ BACKUP *.SDML/SINCE=YESTERDAY/CREATED DLA2:[SAVEDIR]/SAVE_SET

The command in this example saves all files with a file type of .SDML created since yesterday (24 hours before midnight last night).

/DELETE

Command Qualifier

Specifies that a BACKUP save or copy operation is to delete the selected input files from the input volume after all files have been successfully processed.

Format

/DELETE file-spec save-set-spec

Description

The /DELETE qualifier is valid only when used in a BACKUP save or copy operation. You must have sufficient privilege to delete files; if you do not, files protected against deletion are not deleted. If you use the command qualifier /VERIFY with /DELETE, files that fail verification are not deleted.

You cannot use /DELETE with the /RECORD or /COMPARE command qualifiers.

Examples

#1 

$ BACKUP/DELETE BOP.DAT MTA0:BOP.BCK/LABEL=DANCE

In this example, the file BOP.DAT will be deleted after the save set BOP.BCK is successfully created on MTA0.

#2 

$ BACKUP/VERIFY/DELETE RAY.DAT,JOE.DAT,ELLA.DAT MTA0:OSCAR.BCK/LABEL=FRIEND

The BACKUP command deletes the selected list of files in this example after saving them to OSCAR.BCK on MTA0 and comparing the output save set with the input files. If BACKUP detects a difference between the contents of the output save set and the input file, the input file is not deleted.

/DENSITY

Output Save-Set Qualifier

Specifies the recording density of the output magnetic tape in bits per inch (bits/in). Use a value that is supported by the magnetic tape drive.

If you do not specify the /DENSITY qualifier, the default density is the current density of the magnetic tape drive. You must specify the output save-set qualifier /REWIND with /DENSITY.

Format

input-specifier output-save-set-spec/DENSITY=keyword

The densities supported for tapes and disks are shown in the following table.

Table 7-3 Keywords for Tapes
Keyword Meaning
DEFAULT Default density
800 NRZI 800 bits per inch (BPI)
1600 PE 1600 BPI
6250 GRC 6250 BPI
3480 IBM 3480 HPC 39872 BPI
3490E IBM 3480 compressed
833 DLT TK50: 833 BPI
TK50 DLT TK50: 833 BPI
TK70 DLT TK70: 1250 BPI
6250 RV80 6250 BPI EQUIVALENT
NOTE: Only the symbols listed above are understood by TMSCP/TUDRIVER code prior to OpenVMS Version 7.2. The remaining values in this table are supported only on Alpha systems.
TK85 DLT Tx85: 10625 BPI---Cmpt III
TK86 DLT Tx86: 10626 BPI---Cmpt III
TK87 DLT Tx87: 62500 BPI---Cmpt III
TK88 DLT Tx88: (Quantum 4000)---Cmpt IV
TK89 DLT Tx89: (Quantum 7000)---Cmpt IV
QIC All QIC drives are drive-settable only
8200 Exa-Byte 8200
8500 Exa-Byte 8500
DDS1 Digital Data Storage 1---2G
DDS2 Digital Data Storage 2---4G
DDS3 Digital Data Storage 3---8-10G
DDS4 Digital Data Storage 4
AIT1 Sony Advanced Intelligent Tapes

Description

The value that you specify must be supported by your magnetic tape hardware. If you omit this qualifier, the default density is the current density on the output tape drive.

The /DENSITY qualifier is incompatible with the output save-set qualifier /NOREWIND. You must specify the output save-set qualifier /REWIND to initialize the magnetic tape when using the /DENSITY qualifier. When you specify /DENSITY/REWIND, BACKUP rewinds the tape to the beginning-of-tape. Then BACKUP initializes the tape with the new density, removing access to all data that previously resided on the tape.

Example


$ BACKUP *.PAS MTA2:SAVEPAS.BCK/DENSITY=1600/REWIND/LABEL=PASCAL

The magnetic tape on drive MTA2: is initialized. All files with a file type of .PAS in the current default directory are saved to the save set SAVEPAS.BCK. The /DENSITY qualifier sets the recording density to 1600 bits/in.

/EXACT_ORDER

Output Save-Set Qualifier

Depending on the other qualifiers you specify on the command line, the /EXACT_ORDER qualifier allows you to perform the following actions:

Format

input-specifier output-save-set-spec/EXACT_ORDER

Description

The /EXACT_ORDER qualifier allows you to perform the following actions:

Note the following restrictions when you use the /EXACT_ORDER output qualifier:

The default is /NOEXACT_ORDER.

Examples

#1 

$ BACKUP/IMAGE/RECORD/VERIFY/NOASSIST
_From: DKA100:
_To: MKB100:MAR11.SAV/LABEL=(TAPE1,TAPE2,TAPE3)/EXACT_ORDER

This example uses the /EXACT_ORDER qualifier to specify the exact order of labels for the BACKUP operation. Note that if you specify the /ASSIST qualifier, BACKUP would display messages on the operator terminal. BACKUP performs the following actions:

  1. Compares the volume label of the tape in MKB100: with the first label that you specified on the command line (TAPE1). If the labels match exactly, BACKUP begins the save operation. If the labels do not match or if the tape does not have an ANSI label, BACKUP displays the following message: 


    %BACKUP-W-MOUNTERR, volume 1 on MKB100: was not mounted because 
 its label does not match the one requested 
%BACKUP-W-EXLABEER, volume label processing failed because 
 volume TAPE4 is out of order, Volume label TAPE1 was expected 
 specify option (QUIT, NEW tape, OVERWRITE tape, USE loaded tape) 
BACKUP> OVERWRITE

    Depending on the option you specify, you can quit the backup operation (QUIT), dismount the old tape and mount a new one (NEW), overwrite the label and the data on the tape (OVERWRITE), or write the data to the tape using the loaded tape's label (USE).

  2. When the operation fills the first tape, it displays the following message: 


    %BACKUP-I-RESUME, resuming operation on volume 2 
%BACKUP-I-READYWRITE, mount volume TAPE2 on MKB100: for writing 
Respond with YES when ready:

  3. When you load the second tape and enter YES, BACKUP compares the label of the second tape with the second label you specified on the command line (TAPE2) just as it did in step 1a.
  4. Assuming the volume labels match, BACKUP continues processing until it completes the operation or runs out of volume labels. If you do not specify enough labels on the command line to complete the operation, BACKUP prompts you to enter a label for the tape in the drive as follows: 


    %BACKUP-W-MOUNTERR, volume 4 on MKB100: was not mounted because 
 the label was not specified 
 specify EXACT_ORDER label (up to 6 characters) 
BACKUP>

    BACKUP then compares the label on the tape with label you specify as described previously.

#2 

$ BACKUP/IMAGE/RECORD/VERIFY/NOASSIST
_From: DKA100:[TEST]
_To: MKB100:MAR11.SAV/EXACT_ORDER

Because this example does not use the /LABEL qualifier, BACKUP uses the existing label on the tape. If the tape does not have an ANSI label, and it is the first tape in the operation, BACKUP displays the following error message: 


%BACKUP-F-NOTANSI, tape is not valid ANSI format

If the tape does not have an ANSI label, and is not the first tape in the operation, BACKUP displays the following error message prompting you to specify a label: 


%BACKUP-W-MOUNTERR, volume 2 on MKB100: was not mounted because 
 the label was not specified 
 specify EXACT_ORDER label (up to 6 characters) 
BACKUP>

Note
BACKUP checks to make sure you specify a valid label. If the label is not valid (for example, longer than six characters), BACKUP displays an error message. In previous versions of the OpenVMS operating system, BACKUP truncated long volume labels.

/EXCLUDE

Input File-Selection Qualifier

Excludes files that otherwise meet the selection criteria for a save or copy operation. The excluded files are not processed.

Format

input-specifier/EXCLUDE=(file-spec[,...]) output-specifier

Description

If you specify more than one file, separate the file specifications with commas and enclose the list in parentheses. Do not use a device specification when defining the files to be excluded. You can use most standard wildcard characters, but you cannot use wildcard characters denoting latest versions of files (;) or relative versions of files (;-n).

Note that BACKUP does not apply temporary file specification defaults within the list. Each file specification independently takes its defaults from the file specification [000000...]*.*;*.

If you specify directory files (files with the file type .DIR), your command is processed but the directory files are not excluded (they are processed). BACKUP uses directory files to facilitate incremental restore operations.

You cannot use the /EXCLUDE qualifier in image restore operations.

Example


$ BACKUP
_From: DRA2:[CONTRACTS]/BEFORE=TODAY/EXCLUDE=(*.OBJ,*.MAI)
_To: MFA0:CONTRACT.BCK/LABEL=DLY102

All files in the directory [CONTRACTS] that have a modification date prior to today (the current day, month, and year at 00:00:00.0 o'clock) are saved to the save set CONTRACT.BCK on drive MFA0, except for those with a file type of .OBJ or .MAI.

/EXPIRED

Input File-Selection Qualifier

Selects files according to the value of the expiration date field in each file header record.

Format

input-specifier/BEFORE=time /EXPIRED output-specifier

input-specifier/SINCE=time /EXPIRED output-specifier

Description

You must use the input file-selection qualifier /BEFORE or /SINCE with /EXPIRED. The date and time you specify to /BEFORE or /SINCE determines which files are processed.

You cannot use /EXPIRED with the input file-selection qualifiers /BACKUP, /MODIFIED, or /CREATED.

Example


$ BACKUP [CONTRACTS]/BEFORE=TOMORROW/EXPIRED MTA1:30DEC.BCK/LABEL=WK04

This command saves all files in the directory [CONTRACTS] that have an expiration date prior to tomorrow (24 hours after midnight last night) to a save set named 30DEC.BCK.

/FAST

Command Qualifier

Processes the input specifier using a fast file scan to reduce processing time. The input specifier must be a Files--11 disk.

Format

/FAST input-specifier output-specifier

Description

The fast file scan reads the index file on the Files--11 disk specified by the input specifier and creates a table of files that match the qualifiers you specified.

When you use the /FAST qualifier to save a disk, ALIAS directory trees are not processed. Only the primary files that the ALIAS points to are saved. Depending on the number of ALIAS directory specifications there are on the disk, this may increase performance by reducing the number of files BACKUP checks for processing. A message is displayed for each ALIAS directory or file that is not processed.

To perform a fast file scan, you need write access to the INDEXF.SYS file on the input medium, or the input medium must be write-locked. This requirement is necessary because BACKUP opens the index file to synchronize with the file system, whether or not any update is made.

A fast file scan is most useful when the input specifier includes most of the files on the volume, and file-selection qualifiers (such as those that pertain to date or owner) specify a relatively small set of the files named. Because image operations implicitly use the fast file scan, the /FAST qualifier is ignored if used with the command qualifier /IMAGE.

You cannot use /FAST in restore operations.

Example


$ BACKUP/FAST
_From: DBA1:[*...]/MODIFIED/SINCE=TODAY
_To: MTA0:13NOVBAK.BCK,MTA1:/LABEL=WK201

In this example, all files on the disk DBA1 that have been modified today are saved to a multireel tape save set named 13NOVBAK.BCK. The /FAST qualifier is used to reduce processing time.

Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6048PRO_017.HTML