User's Guide

ANSICP

Function:

Copies all the files from one ANSI labeled tape to another. ansicp will prompt the user for the tape drive number, volume identifier, and tape length if not specified. The output volume must be ANSI initialized using ansinit before it is written to.

ansicp will optionally create tape mappers and directories for the input and output tapes and a log file in the directory specified by dir.

Syntax:

ansicp -[TtVvbdDalms] [indrive] [outdrive] [involid] [outvolid] 
	[blksz] [dir]

options:
    T        Input tape drive name, specified by indrive.
    t        Output tape drive name, specified by outdrive.
    V        Input volume identifier, specified by involid.
    v        Output volume identifier, specified by outvolid.
    b        Block size, specified by blksz.
    d        Logfile directory, specified by dir.
    D        Flag to create tape directory listings in the logfile 
	     directory.  The directory files will be named 
	     <involid>.ansidir and <outvolid>.ansidir.
    a        Flag to automatically determine the ANSI volume ID from 
             input and output tape labels.  If this option is used, 
	     the V and v options need not be used, and the user will 
	     not be prompted for volume IDs.
    l        Flag to write a logfile in the logfile directory.  
	     The logfile will be named <involid>.log.
    m        Flag to create mappers of the input and output volumes in
             the logfile directory.   The files will be named 
	     <involid>.map and <outvolid>.map, respectively.
    s        Flag to print the exit status of the tape copy on 
	     standard error, even if the copy was successful.

arguments:
    indrive  The name of the input tape drive being used.  
	     If the T option is not used, the user will be prompted 
	     for the input drive.
    outdrive The name of the output tape drive being used.  
	     If the t option is not used, the user will be prompted 
	     for the output drive.
    involid  The volume identifier of the input tape.  
	     If the V option is not used, the user will be prompted 
	     for the input volume ID.
    outvolid The volume identifier of the output tape.  
	     If the v option is not used, the user will be prompted 
	     for the output volume ID.
    blksz    The block size at which the output tape is to be written.  
             The default block size is that of the input tape.  
	     The maximum block size is defined to be 64000.
    dir      The directory where log files will be placed.  
	     The default is the current directory.

Examples:

  1. ansicp -TtVv 0 1 jj0839 023418

    Copies all the files on input volume jj0839 to volume 023418. The input tape is on drive 0 and the output tape is on drive 1.

  2. ansicp -Ttba 0 1 32000

    Copies all the files from the ANSI labeled tape on drive 0 to the ANSI labeled tape on drive 1. ansicp will automatically determine the volume identifiers from the tapes themselves. The files are reformatted to a block size of 32000 bytes.

  3. ansicp -TtVvdDm 0 1 jj0839 023418 logfiles/ansi

    Copies all the files on input volume jj0839 to volume 023418. The input tape is on drive 0 and the output tape is on drive 1. Mappers of the input and output tapes are created and are placed in files named jj0839.map and 023418.map, respectively. A directory listing of each tape is also performed. These listings are similar to those produced by ansidir. The files are named jj0839.ansidir and 023418.ansidir. All the mapper and directory listing files are placed in the directory logfiles/ansi.

User Notes:

  1. ansicp does not span tapes. It is assumed that the contents of the input tape will fit on the output tape.

  2. EOT logic has been removed from the routine. If an EOT mark is encountered, a fatal error occurs and execution terminates. This change is motivated by the varied behavior of tape devices when an EOT is detected.