![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
Input Save-Set QualifierDirects BACKUP to treat the input file as a BACKUP save set. You must specify /SAVE_SET when the input specifier refers to a BACKUP save set on disk.
input-save-set-spec/SAVE_SET output-specifier
The /SAVE_SET qualifier allows you to refer to a BACKUP save set on a local Files--11 disk, a remote Files--11 disk, or a sequential disk. If you do not specify /SAVE_SET, an input specifier that refers to a disk is treated as a Files--11 file. An input specifier that refers to tape is always treated as a BACKUP save set.
Examples
$ BACKUP DBA2:[BACKUP]1212MAR3.BCK/SAVE_SET DBA1:[*...]
$ BACKUP/LIST DBA2:[SAVE]23MAR96.BCK/SAVE_SET
$ BACKUP/LOG DBA2:[SAVE]23MAR96.BCK/SAVE_SET DBA3:[PLI.WORK]
Output Save-Set QualifierDirects BACKUP to treat the output file as a BACKUP save set. You must specify the /SAVE_SET qualifier when the output specifier refers to a BACKUP save set on disk.
input-specifier output-save-set-spec/SAVE_SET
The /SAVE_SET qualifier allows you to create a BACKUP save set on a local Files--11 disk, a remote Files--11 disk, or a sequential disk. If you do not specify /SAVE_SET, an output specifier that refers to disk is treated as a Files--11 file. An output specifier that refers to tape is always treated as a BACKUP save set.
Examples
$ BACKUP [HILL] DBA1:[BACKUP]SEP28.BCK/SAVE_SET
$ BACKUP DBA2:[PLI.WORK]*.*; [SAVE]23MAR96.BCK/SAVE_SET
$ BACKUP _From: [] _To: MILO"FRANKIE THISISMINE"::DUA0:[FRANKIE]MYDIR.BCK/SAVE_SET
$ MOUNT/FOREIGN DBA0: $ BACKUP [SIMS] DBA0:SIMS.BCK/SAVE_SET
Input Save-Set QualifierSelects the specified files for processing.
input-save-set-spec/SELECT=(file-spec[,...]) output-specifier
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 you define the files to be selected. You can use most standard wildcard characters, but you cannot use wildcard characters denoting latest version of files (;) and 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...]*.*;*.
$ BACKUP DBA1:JUL20.BCK/SAVE_SET/SELECT=[SNOW]BALL.PAS [WINTER.GAME]BALL.PAS
This command selects a file named [SNOW]BALL.PAS from a sequential-disk save set and restores it to the directory [WINTER.GAME] on the current default device.
Input File-Selection QualifierSelects files dated equal to or later than the specified date and time.
input-specifier/SINCE=time output-specifier
The /SINCE qualifier selects files by comparing the date and time in the specified field of each file header record with the date and time you specify in the command line. The following table shows the input file-selection qualifiers you can use with /SINCE and their functions. Use only one of these qualifiers at a time in your command line.
Qualifier Function /BACKUP Selects files last saved or copied by BACKUP/RECORD since the date specified. Also selects files with no BACKUP date. /CREATED Selects files created since the date specified. /EXPIRED Selects files that have expired since the date specified. /MODIFIED Selects files last modified since the date specified. If you specify /SINCE without another qualifier, /MODIFIED is used by default. Specify the date and time as a delta time or as an absolute time using the format [dd-mmm-yyyy[:]][hh:mm:ss.cc]. You can also use one of the following reserved words to specify the date and time:
BACKUP The BACKUP/RECORD operation (available only on Files--11 Structure Level 2 volumes) TODAY The current day, month, and year at 00:00:00.0 o'clock TOMORROW 24 hours after midnight last night YESTERDAY 24 hours before midnight last night Make sure to perform an image backup, using the BACKUP/IMAGE/RECORD command, before performing regular incremental backups. The image backup saves a copy of the entire disk and marks each file as having been saved. Regularly performed subsequent incremental backups assume an image backup was already performed and therefore will save new or modified files. If an image backup was not performed first, the incremental backups will save more files than may be necessary, in an attempt to ensure that an incremental restore will be successful.
$ BACKUP [PLI.WORK]/SINCE=YESTERDAY/MODIFIED [PLI.SAV]
This command copies selected files in the directory [PLI.WORK] to the directory [PLI.SAV]. Only those files that have been modified since 24 hours preceding midnight last night are processed. Even though it is used in this example, the /MODIFIED qualifier is not required because its action is the default when the /SINCE qualifier is specified.
Output Save-Set QualifierWrites a file expiration date other than the current date to the file header label of the save set.
input-specifier output-save-set-spec/TAPE_EXPIRATION[=date]
When you specify the output save-set qualifier /REWIND during a save operation to magnetic tape, BACKUP checks that the expiration date of the first file on the tape has expired before initializing the tape. Initializing the tape removes access to data previously stored on the tape.Digital recommends that you specify an expiration date whenever you create a BACKUP save set on magnetic tape using /REWIND. Daily BACKUP tapes should expire in seven days, weekly BACKUP tapes should expire in one month, and monthly BACKUP tapes should expire in one year.
Specify the date in the following format:
dd:mmm:yyyywhere:
dd is the date. mmm is a 3-letter abbreviation of the month. yyyy is the year. BACKUP writes the expiration date into the file's HDR1 ANSI label on the tape. If you do not use the /TAPE_EXPIRATION qualifier, BACKUP uses today's date as the expiration date.
$ BACKUP DBA1: _To: MTA0:13SEPBAK.BCK/REWIND/TAPE_EXPIRATION=20-SEP-1996/LABEL=SEPW02
In this example, the save set file 13SEPBAK.BCK receives an expiration date of September 20, 1996. Becauses this command includes the /REWIND qualifier, 13NOVBAK.BCK is the first file on the tape and its expiration date indicates that the tape expires after seven days.
Command QualifierControls whether a copy or restore operation truncates a sequential output file at the end-of-file (EOF) when creating it.
/[NO]TRUNCATE input-specifier output-specifier
By default, a copy or restore operation uses the allocation of the input file to determine the size of the output file. Specify /TRUNCATE if you want the output files to be truncated at the end-of-file (EOF).
$ DIRECTORY/SIZE [FRANKIE]ORIGINAL.DAT Directory DMA0:[FRANKIE] ORIGINAL.DAT 35 Total of 1 file, 35 blocks $ COPY ORIGINAL.DAT EXTENDED.DAT/ALLOCATION=500 $ BACKUP [FRANKIE]EXTENDED.DAT MFA0:20JUL.BCK/LABEL=WKLY03 $ BACKUP/TRUNCATE MFA0:20JUL.BCK/LABEL=WKLY03 DMA0:[FRANKIE]
This sequence of commands does the following:
- Determines that the file ORIGINAL.DAT is 35 blocks long.
- Copies ORIGINAL.DAT to EXTENDED.DAT, allocating 500 blocks for EXTENDED.DAT.
- Saves the file EXTENDED.DAT to a save set named 20JUL.BCK on MFA0. BACKUP writes the file allocation size in the file header record of the saved file but saves only 35 blocks in the save set.
- Restores the save set file on MFA0 to a volume mounted on DMA0 and truncates the output files at the EOF. The restored file is 35 blocks long.
Command QualifierControls whether the Backup utility designates files from a BACKUP save operation as unshelved or shelved.
/[NO]UNSHELVE input-specifier output-specifier
The /UNSHELVE qualifier specifies that the Backup utility designate files from a BACKUP save operation as unshelved, which means the data is available in an online state. A shelved file contains no actual file data. However, the file header remains intact and online. The default behavior is unshelved except during BACKUP save operations that require the /PHYSICAL or /IMAGE qualifier. For those operations, the files remain in their original file shelving state.For more information about file shelving, refer to the POLYCENTER File Shelving Facility (HSM) documentation.
$ BACKUP/UNSHELVE [INFO] DBA0:INFO.BCK/SAVE_SET
This command saves all files in the directory [INFO] to a sequential-disk save set named INFO.BCK. The files saved from [INFO] are unshelved (data is available online).
Command QualifierSpecifies that the contents of the output specifier be compared with the contents of the input specifier after a save, restore, or copy operation is completed.
/VERIFY input-specifier output-specifier
The /VERIFY qualifier is different from the command qualifier /COMPARE. Unlike the /VERIFY qualifier, the command qualifier /COMPARE cannot be used in a save, restore, copy, or list operation. The /VERIFY qualifier directs BACKUP to perform the copy, save, or restore operation first and then to perform the compare operation.On file-structured copy operations, each file is compared after it is copied. On physical copy operations, the volume is compared after it is copied. For a save or restore operation, the verification is performed in a separate pass and is preceded by the following informational message:
%BACKUP-I-STARTVERIFY, starting verification passIf a file does not compare successfully, BACKUP displays the following error message:
%BACKUP-E-VERIFYERR, verification error for block 'block-number' of 'disk:[directory]file_name.file_type;version_number'The /VERIFY qualifier does not work on a restore or copy operation when the /NEW_VERSION output file qualifier is also used. Because the /NEW_VERSION qualifier reassigns output file versions, it is not possible to correctly associate the created output files with the input files from which they were copied.
$ BACKUP/VERIFY/LOG *.LIS MFA0:LIST.BCK %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRE.LIS;1 %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]CRETIME.LIS;1 %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]EXC.LIS;1 %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]NOREB.LIS;1 %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]REB.LIS;1 %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]SETREB.LIS;1 %BACKUP-S-COPIED, copied DISK$DEFAULT:[WONDER]VERS.LIS;1 %BACKUP-I-STARTVERIFY, starting verification pass %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]CRE.LIS;1 %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]CRETIME.LIS;1 %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]EXC.LIS;1 %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]NOREB.LIS;1 %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]REB.LIS;1 %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]SETREB.LIS;1 %BACKUP-S-COMPARED, compared DISK$DEFAULT:[WONDER]VERS.LIS;1
This example creates a magnetic tape save set on MFA0 and starts the verification pass after the save operation is completed. The /LOG qualifier displays the file names as they are processed.
Command QualifierIndicates that a specific disk volume in a disk volume set is to be processed. The /VOLUME qualifier is valid only when used with the /IMAGE qualifier.
/IMAGE/VOLUME= n input-specifier output-specifier
The /VOLUME qualifier allows you to perform an image save, restore, or copy operation using one more disk drive than the number of disks in the input volume set. When you use /VOLUME, you must write-lock the entire input volume set.When you perform an image copy or save operation with the /VOLUME qualifier, all disks in the input volume set must be mounted. Mount the volumes of the target volume set one at a time. Enter a separate BACKUP command for each disk in the input volume set. A save set created with the /VOLUME qualifier must be restored using the /VOLUME qualifier.
You can restore any image save set with the /VOLUME qualifier. All disks in the output volume set must be mounted. Mount the disks in the input volume set one at a time. You cannot use the command qualifier /NOINITIALIZE in the restore operation with the command qualifier /VOLUME.
In a compare operation that uses the /VOLUME qualifier to compare two disk volume sets, all disks in both volume sets must be mounted. In a selected-volume compare operation between a save set on tape and a disk volume set, all disks in the disk volume set must be mounted.
$ BACKUP/IMAGE/VOLUME=3 DISK$PUBLIC DRA1:
This command creates a functionally equivalent copy of the third volume of a volume set named DISK$PUBLIC to DRA1. The disk mounted in DRA1 becomes the third volume of the image-copy volume set.
| Command Action | Command Format and Example |
|---|---|
| Saves a file to a save set on magnetic tape |
BACKUP file-spec save-set-specifier/LABEL=label
$ BACKUP STRATDAT1.DAT MTA0:STRATDAT1.BCK/LABEL=TAPE01 |
| Saves the most recent versions of files in a directory to magnetic tape |
BACKUP [directory]*.*; save-set-specifier/LABEL=label
$ BACKUP [LYKINS...]*.*; MTA0:1409MAR17.BCK/LABEL=WKY102 |
| Saves a disk volume to a save set on magnetic tape |
BACKUP/IMAGE ddcu: save-set-specifier/LABEL=label
$ BACKUP/IMAGE DBA1: MTA0:960FEB4.BCK/LABEL=MTH101 |
| Saves a disk volume to a multivolume save set on more than one magnetic tape drive |
BACKUP/IMAGE ddcu: save-set-specifier,ddcu:.../LABEL=(label1,...)
$ BACKUP/IMAGE DBA1: MTA0:17MAR.BCK,MTA1:/ - _$ LABEL=(WKY101,WKY102) |
| Saves a list of files to a save set on magnetic tape |
BACKUP file-spec,file-spec,... save-set-specifier/LABEL=label
$ BACKUP DBA1:[LYKINS...]*.PAS,DMA0:[DAKOTA...]*.PAS - _$ MTA0:PAS17MAR.BCK/LABEL=TAPE01 |
| Saves a disk volume for incremental backups for the first time |
BACKUP/RECORD/IMAGE/LOG ddcu: save-set-specifier/LABEL=label
$ BACKUP/RECORD/IMAGE/LOG DBA1: MTA0:925FEB4.BCK/ - _$ LABEL=DLY101 |
| Saves a disk volume for incremental backups (not the first time) |
BACKUP/RECORD/FAST/LOG ddcu:[*...]/SINCE=BACKUP
save-set-specifier/LABEL=label
$ BACKUP/RECORD/FAST/LOG DBA1:[*...]/SINCE=BACKUP - _$ MTA0:928FEB4.BCK/LABEL=DLY101 |
| Saves an unstructured disk volume |
BACKUP/PHYSICAL ddcu: save-set-specifier/LABEL=label
$ BACKUP/PHYSICAL DMA1: MTA0:965FEB4.BCK/LABEL=MTH101 |
| Saves a directory to a save set on a Files--11 disk |
BACKUP [directory] save-set-specifier/SAVE_SET
$ BACKUP [LYKINS] DBA2:[BACKUP]1609FEB3.BCK/SAVE_SET |
| Saves a directory tree to a save set on magnetic tape |
BACKUP [directory...] save-set-specifier/LABEL=label
$ BACKUP [LYKINS...] MTA0:1612FEB3.BCK/LABEL=TAPE01 |
| Saves a directory tree to a save set on magnetic tape and creates a listing file |
BACKUP/LIST=file-spec [directory...] save-set-specifier/LABEL=label
$ BACKUP/LIST=8SEP.LOG [LYKINS...] MTA0:8SEP.BCK/LABEL=WKL101 |
| Saves a directory tree to a save set on magnetic tape using data compaction to increase the amount of data stored on a tape cartridge |
BACKUP [directory...] save-set-specifier/MEDIA_FORMAT=COMPACTION
$ BACKUP [TESTFILES...]*.*;* MUA0:TEST.SAV/MEDIA_FORMAT=COMPACTION/REWIND |
Table 7-5 shows BACKUP command formats for restore operations and some of the qualifiers you can use with restore operations. In the examples in this table, it is assumed that save sets already exist on the magnetic tape and disk.
| Command Action | Command Format and Example |
|---|---|
| Restores from save set on disk to Files--11 disk with original UICs |
BACKUP save-set-specifier/SAVE_SET ddcu:[*...]/BY_OWNER=ORIGINAL
$ BACKUP DBA2:[BACKUP]FEB2.BCK/SAVE_SET DBA1:[*...]- _$/BY_OWNER=ORIGINAL |
| Restores from a save set on magnetic tape to a Files--11 disk with original UICs |
BACKUP save-set-specifier ddcu:[*...]/BY_OWNER=ORIGINAL
$ BACKUP MTA0:1618FEB2.BCK DBA1:[*...]/BY_OWNER=ORIGINAL |
| Restores a selected file in a save set on magnetic tape to a Files--11 disk |
BACKUP save-set-specifier/SELECT=file-spec file-spec
$ BACKUP MTA0:FEB2.BCK/SELECT=[POUDRE]UPLIFT.PAS - _$ DBA1:[GEO.PAS]UPLIFT.PAS |
| Restores files with a specific UIC to a Files--11 disk |
BACKUP save-set-specifier/BY_OWNER=[uic] file-spec
$ BACKUP MTA0:1641FEB2.BCK/BY_OWNER=[360,052] - _$ DBA1:[LYKINS...] |
| Restores files to a Files--11 disk with a new UIC |
BACKUP save-set-specifier file-spec/BY_OWNER=[uic]
$ BACKUP MTA0:1641FEB2.BCK - _$ DBA1:[TESTS...]/BY_OWNER=[100,150] |
| Restores files to a Files--11 disk; if file exists, creates new version |
BACKUP save-set-specifier file-spec/NEW_VERSION
$ BACKUP MTA0:1641FEB2.BCK DBA1:[LYKINS...]/NEW_VERSION |
| Restores files to a Files--11 disk; if file exists, replaces with new version |
BACKUP save-set-specifier file-spec/REPLACE
$ BACKUP MTA0:1641FEB2.BCK DBA1:[LYKINS...]/REPLACE |
| Restores files to a Files--11 disk selecting certain files |
BACKUP save-set-specifier/SELECT=file-spec file-spec
$ BACKUP MTA0:1641FEB2.BCK/SELECT=[LYKINS.PAS] - _$ DBA1:[LYKINS...] |
| Restores a directory tree, placing files in a different subtree |
BACKUP save-set-specifier/SELECT=[directory...] [directory2...]
$ BACKUP MTA0:1641FEB2.BCK/SELECT=[FIELD...] - _$ DBA1:[LYKINS.NEWDATA...] |
| Restores a Files--11 volume from a physical save set |
BACKUP/PHYSICAL save-set-specifier ddcu:
$ BACKUP/PHYSICAL MTA0:26MAR.BCK DMA3: |
| Restores a Files--11 volume from an image save set |
BACKUP/IMAGE save-set-specifier ddcu:
$ BACKUP/IMAGE MTA0:17AUG.BCK DRA3: |
| Restores a Files--11 volume, maintaining the initialization parameters specified in the DCL command INITIALIZE |
INITIALIZE ddcu: volume-name/new-parameters
MOUNT/FOREIGN ddcu: BACKUP/IMAGE save-set-specifier ddcu:/NOINITIALIZE $ INITIALIZE DBA1: UTTLPACK/CLUSTER=5 $ MOUNT/FOREIGN DBA1: $ BACKUP/IMAGE MTA0:17AUG.BCK DBA1:/NOINITIALIZE |
Table 7-6 shows BACKUP command formats for copy operations, including some of the qualifiers you can use with a copy operation.
| Command Action | Command Format and Example |
|---|---|
| Copies a directory tree to another directory tree |
BACKUP [directory...] [directory...]
$ BACKUP [DAKOTA...] [SUNDANCE...] |
| Copies a file to another file |
BACKUP file-spec file-spec
$ BACKUP LOGIN.COM [.SAVE]OLDLOGIN.COM |
| Copies a disk volume to another disk volume |
BACKUP/IMAGE ddcu: ddcu:
$ BACKUP/IMAGE DBA1: DBA2: |
| Copies a disk volume to another disk volume using the /PHYSICAL qualifier |
BACKUP/PHYSICAL ddcu: ddcu:
$ BACKUP/PHYSICAL DYA1: DYA2: |
| Copies two disk volume sets using the /IMAGE qualifier |
BACKUP/IMAGE volume-set-name ddcu:,ddcu:
$ BACKUP/IMAGE USER$: DBA1:,DBA2: |
Table 7-7 shows BACKUP command formats for compare operations, including some of the qualifiers you can use with a compare operation.
| Command Action | Command Format and Example |
|---|---|
| Compares two Files--11 files |
BACKUP/COMPARE file-spec file-spec
$ BACKUP/COMPARE UPLIFT.EXE;3 UPLIFT.EXE;2 |
| Compares a selected file from a save set and a Files--11 file |
BACKUP/COMPARE save-set-specifier/select=file-spec file-spec
$ BACKUP/COMPARE MTA0:FEB2.BCK/SELECT=[POUDRE]UPLIFT.PAS - _$ UPLIFT.PAS |
| Compares an image save set and Files--11 files |
BACKUP/COMPARE/IMAGE save-set-specifier ddcu:
$ BACKUP/COMPARE/IMAGE MTA0:12OCT.BCK DRA3: |
Table 7-8 shows BACKUP command formats for a list operation, including some of the qualifiers you can use with a list operation.
| Command Action | Command Format and Example |
|---|---|
| Lists the files in a save set at the terminal |
BACKUP/LIST save-set-specifier
$ BACKUP/LIST MTA0:1618FEB2.BCK |
| Lists the files in a save set, writes to a file |
BACKUP/LIST=file-spec save-set-specifier
$ BACKUP/LIST=NEWLIST.LIS MTA0:1618FEB2.BCK |
| Lists the files in a save set in full format |
BACKUP/LIST/FULL save-set-specifier
$ BACKUP/LIST/FULL MTA0:1618FEB2.BCK |
| Lists selected files in a journal file |
BACKUP/LIST/JOURNAL=journal-name/selection-qualifiers
$ BACKUP/LIST/JOURNAL=SYS$MANAGER:INCBACKUP - _$ /SELECT=[LYKINS.WORK...]/SINCE=1-JAN-1996 |
6048P017.HTM OSSG Documentation 26-NOV-1996 12:42:42.52
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.