User's Guide

ULOUT

Function:

ulout is used to write files to unlabeled tapes. Files written to tape will contain fixed-length recsz-byte records organized into blksz-byte blocks. A short (the default), medium, or long listing similar to that created by ansidir will be printed to standard output listing the files written to tape. ulout prompts the user for tape drive number and tape length if not specified. ulout also prompts for this information for continuation volumes.

Syntax:

Syntax:

ulout -[Tbdrtalmns] [drive] [blksz] [density] [recsz] [length] file [file] ...

options:
    T       Tape drive name, specified by drive.
    b       Block size, specified by blksz.
    d       Density, specified by density.
    r       Record size, specified by recsz.
    t       Tape length, specified by length.
    a       Append the file(s) to the end of an existing unlabeled tape.
    l       Do a long listing.
    m       Do a medium listing.
    n       NDCDB flag.  ulout will stop when EOT is encountered on 
	    the first volume even if the s flag has been set.
    s       OK to split files across tape volumes.  If this option is
	    not specified and EOT is encountered while writing the
	    file(s), a fatal error will occur.

arguments:
    drive   The name of the tape drive being used.
    blksz   The block size at which the tape is to be written.
	    The block size must be a multiple of the record size.
	    The default block size is 8000 bytes.
    density The density at which the tape is to be written.
	    The default density is 1600 bpi.
    recsz   The length of fixed-length records to be written to tape.
	    The default record size is 100 bytes.
    length  The approximate length of the tape, in feet.
	    If appending to an existing tape, the approximate
	    length of tape remaining should be used.
    file    The name of a tape file to be copied to disk.
	    Multiple filenames may be specified; the UNIX
	    wild card characters '*' and '?' are also supported.

Examples:

  1. ulout -Tbdlrt msa0 8000 6250 80 2400 text.*

    Copy all files starting with 'text.' in the current directory to an unlabeled tape on drive msa0 at 6250 bpi. The tape is 2400 feet long, and will contain fixed-length 80-byte records in 8000-byte blocks. A long listing describing the tape will be produced.

  2. ulout -Tat msa0 1800 *.c

    Append all files ending with '.c' in the current directory to the unlabeled tape on drive msa0, an existing tape having about 1800 feet of tape remaining. The tape density, record format, record size, and block size will use default values. A short description of the tape will be produced.