VMSBACKUP(1)	    UNIX Programmer's Manual	     VMSBACKUP(1)



NAME
     vmsbackup - read a VMS backup tape

SYNOPSIS
     vmsbackup -{tx}[cdenvw][s setnumber][f tapefile] [ name ...
     ]

DESCRIPTION
     _v_m_s_b_a_c_k_u_p reads a VMS generated backup tape, converting the
     files to Unix format and writing the files to disc.  The
     default operation of the program is to go through an entire
     tape, extracting every file and writing it to disc.  This
     may be modified by the following options.

     c	     Use complete filenames, including the version
	     number.  A colon and the octal version number will
	     be appended to all filenames.  A colon, rather than
	     a semicolon, is used since the Unix Shell uses the
	     semicolon as the line separator.  Using a colon
	     prevents the user from having to escape the semi-
	     colon when referencing the filename.  This option is
	     useful only when multiple versions of the same file
	     are on a single tape or when a file of the same name
	     already exists in the destination directory.  The
	     default is to ignore version numbers.

     d	     use the directory structure from VMS, the default
	     value is off.

     e	     Process all filename extensions.  Since this program
	     is mainly intended to move source code and possibly
	     data from a DEC system to a Unix system, the default
	     is to ignore all files whose filename extension
	     specifies system dependent data.  The file types
	     which will be ignored, unless the e option is speci-
	     fied, are

	       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	     Use the next argument in the command line as the
	     tape device to be used, rather than the default.

	     If vmsbackup is compiled with the remote tape option
	     and the file name has the form



Printed 11/26/99						1






VMSBACKUP(1)	    UNIX Programmer's Manual	     VMSBACKUP(1)



	     _s_y_s_t_e_m[._u_s_e_r]:/dev/???  _v_m_s_b_a_c_k_u_p will use the tape
	     drive /dev/??? on the remote system _s_y_s_t_e_m, via
	     _r_s_h(1), and _r_m_t(8).  The optional _u_s_e_r portion of
	     the pathname specifies the login name to use on the
	     remote system.  If it is not supplied, the current
	     user's login name will be used.  In all the cases,
	     the user must have the appropriate permissions on
	     the remote machine, in order to use this facility.
	     The default is /_d_e_v/_r_m_t_8 (drive 0, raw mode, 1600
	     bpi).  This must be a raw mode tape device.

     n	     If the tape has a variable-length record format,
	     then do not append a newline onto the end of the
	     records.  This option does not affect stream or FOR-
	     TRAN files.

     s saveset
	     Process only the given saveset number.

     t	     Produce a table of contents (a directory listing) on
	     the standard output of the files on tape.

     v	     Verbose output.  Normally _v_m_s_b_a_c_k_u_p does its work
	     silently.	The verbose option will cause the
	     filenames of the files being read from tape to disk
	     to be output on the standard output.

     w	     _v_m_s_b_a_c_k_u_p prints the action to be taken followed by
	     file name, then wait for user confirmation. If a
	     word beginning with `y' is given, the action is
	     done. Any other input means don't do it.

     x	     extract the named files from the tape.

     The optional
	     _n_a_m_e argument specifies one or more filenames to be
	     searched for specifically on the tape and only those
	     files are to be processed.  The name may contain the
	     usal sh(1) meta-characters *?![] 0n.

FILES
     /dev/rmt_x

SEE ALSO
     rmtops(3)

BUGS
     The filename match uses the complete VMS file names.


AUTHOR
     John Douglas Carey



Printed 11/26/99						2






VMSBACKUP(1)	    UNIX Programmer's Manual	     VMSBACKUP(1)



     Sven-Ove Westberg






















































Printed 11/26/99						3