User's Guide

ANSIIN

Function:

ansiin is used to read ANSI labeled tapes, copying selected files from tape to disk. A short (the default), medium, or long listing similar to that created by ansidir will be printed to standard output listing the files read from tape. The files copied from tape are copied into the current working directory. The name found in the tape header record is converted to lower case and used as the name of the disk file.

ansiin will prompt the operator for the volume identifier and tape drive name if not specified. ansiin also prompts for this information for continuation volumes.

Syntax:

ansiin -[Tvlmt] [drive] [volid] [file] [file] ...

options:
    T       Tape drive name, specified by drive.
    v       Volume identifier, specified by volid.
    l       Do a long listing.
    m       Do a medium listing.
    t       Append a newline character to each record of file 
	    when writing the file to disk.   This is useful for 
	    displaying the file as a text file.

arguments:
    drive   The name of the tape drive being used.

    volid   The volume identifier of the tape (e.g., kk1234)

    file    The name of a tape file to be copied to disk.  If omitted,
	    all files will be copied.  Multiple filenames may be 
	    specified; UNIX wild card characters '*' and '?' are also 
	    supported.  If wild card characters are used, the input 
	    specification must be enclosed in quotation marks 
	    (' ' or " ") or the wild card must be preceded by a 
	    backslash (\); otherwise, UNIX will expand the wild cards 
	    and pass to ansiin a list of matching filenames found 
	    among existing files already on disk in the current 
	    directory.

Examples:

  1. ansiin -Tvm msa0 hh0694 ny.img

    This command will copy ny.img from tape hh0694 mounted on drive msa0 to the current working directory. A medium-length listing will be produced describing the tape and file.

  2. ansiin "*.c"

    This command will copy all files ending in ".c" from the tape to the current working directory. The operator will be prompted for the tape drive name and the volume identifier. A short list noting the names of files read will be produced.

User Note:

  1. ansiin converts the filename found in the tape header record to lower case before comparing to the filename(s) requested. Disk files are written with lower-case names.