vmsbackup(1) CLIX vmsbackup(1)
NAME
vmsbackup - Reads a VMS backup tape
SYNOPSIS
vmsbackup [-tx] [-cdevw] [-s setnum] [-n setname] [-f tapefile] [name ...
]
FLAGS
-c Uses complete filenames including the version number. A
colon and the octal version number are appended to all
filenames. This flag is useful only when multiple versions
of the same file are on a single tape or when a file with
the same name exists in the destination directory. By
default, version numbers are ignored.
-d Uses the directory structure from VMS.
-e Processes all filename extensions. Since this command is
mainly intended to move source code and possibly data from
a VMS system to a CLIX system, the default is to ignore all
files whose filename extensions specify system-dependent
data. The file types that are ignored, unless the -e flag
is specified, are as follows:
exe VMS executable file.
lib VMS object library file.
obj RSX object file.
odl RSX overlay description file.
olb RSX object library file.
pmd RSX post-mortem dump file.
stb RSX task symbol table file.
sys RSX bootable system file.
tsk RSX executable task file.
-f Uses the next argument in the command line as the tape
device to be used instead of the default /dev/rmt/0m.
-s setnumber Processes only the given saveset number.
-n setname Processes only savesets on the tape whose names match the
2/94 - Intergraph Corporation 1
vmsbackup(1) CLIX vmsbackup(1)
setname argument. Pattern matching in the manner of sh is
attempted, using the following metacharacters: asterisk
(*), question mark (?), exclamation point (!), open bracket
([), and close bracket (]).
-t tapefile Produces a table of contents (a directory listing) on
stdout of the files on tape.
-v Sets verbose mode. The verbose flag causes the names of
the files being read from tape to be written to stdout.
-w Queries the user for file disposition. The command
displays the following message and waits for user
confirmation that the file is to be extracted:
extract filename [ny]
If a word beginning with y is given, the file is copied to
the file system. Any other input is interpreted as no.
-x Extracts the named files from the tape. The optional name
argument specifies one or more filenames to be searched for
on the tape. Pattern matching in the manner of sh is
attempted, using the following metacharacters: asterisk
(*), question mark (?), exclamation point (!), open bracket
([), and close bracket (]). Only files with matching names
are processed.
DESCRIPTION
The vmsbackup command reads a VMS-generated backup tape and writes the
files to a CLIX disk. The default operation of the command is to extract
every file from the tape and write it to disk.
EXAMPLES
1. To list the directories on the tape on SCSI tape device 6, key in:
vmsbackup -tvf /dev/rmt/mt6
2. The following verbosely extracts all files, regardless of extension,
from the same tape:
vmsbackup -xvef /dev/rmt/mt6
3. The following verbosely extracts a single file named FILE.DGN from the
same tape:
vmsbackup -xvf /dev/rmt/mt6 "*FILE.DGN*"
2 Intergraph Corporation - 2/94
vmsbackup(1) CLIX vmsbackup(1)
4. The following verbosely extracts the file FILE.DGN from directory
010003 on the same tape:
vmsbackup -xvf /dev/rmt/mt6 "*010003*FILE.DGN*"
FILES
/dev/rmt/0m
Default tape device.
NOTES
The filename match uses the complete VMS filenames.
CAUTIONS
If you extract files bearing the same filename from different directories
on a tape, vmsbackup overwrites the last file extracted with the most
current file extracted.
EXIT VALUES
The vmsbackup command exits with a value of 0 if successful, 1 if it fails
in any way to read the backup, and -1 if vmsbackup fails to write a file.
2/94 - Intergraph Corporation 3