ansiout is used to write ANSI labeled tapes. The tape must first be initialized using ansinit before files can be written to it. 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. ansiout will prompt the operator for the volume identifier, tape drive number, and tape length if they are not specified. ansiout also prompts for this information for continuation volumes.
ansiout -[TvbfdrtDFaAlmnsR] [drive] [volid] [blksz] [filenum] [density] [recsz] [length] file [file]... options: T Tape drive name, specified by drive. v Volume identifier, specified by volid. b Block size, specified by blksz. f File sequence number to be entered into header label, specified by filenum. d Density, specified by density. r Record size, specified by recsz. t Tape length, specified by length. D Variable-length (default) record type flag. F Fixed-length record type flag. a Append the file(s) to the end of an existing ANSI labeled tape. The number of files already on tape (n) is checked, and the file sequence number is reset to n+1. A Append the file(s) to an existing ANSI labeled tape from the current tape position. No directory checking is done. l Do a long listing. m Do a medium listing. n NDCDB flag. ansiout will stop after EOT is encountered on the first volume even if the s flag has been set. s OK to split files over tape volumes. If this option is not specified and EOT is encountered while writing the file(s), a fatal error will occur. R Do not rewind the tape at completion. arguments: drive The name of the tape drive being used. volid The volume identifier of the tape. blksz The block size at which the tape is to be written. The default block size is 8000 bytes. For fixed-length record files, the block size must be a multiple of the record size. The maximum block size is currently defined to be 64000. filenum The file sequence number to be entered into the header label. density The density at which the tape is to be written. The default density is 1600 bpi. recsz The length of fixed-length records, or the maximum length of variable-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 ANSI labeled tape, the approximate length of tape remaining should be used. file The name of a disk file to be copied to tape. Multiple filenames may be specified. The UNIX wild card characters '*' and '?' are also supported. It is always safest to put this parameter in double quotes.
Copy all files starting with 'text.' in the current directory to tape jj0839 on drive 0 at 6250 bpi. The tape is 2400 feet long, and will contain 100 fixed-length 80-byte records per 8000-byte block. A long listing describing the tape will be produced.
Append all files ending with '.c' in the current directory to tape kk1234 on drive 1, an existing ANSI labeled 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.
ansiout -ATvDFbdrtRf 5 sta602 10240 0 10240 2400 2 x.img
ansiout -ATvDFbdrtf 5 sta602 10240 0 10240 2400 3 y.img
A sequence of three commands will write three files to tape sta602 mounted on drive 5. All three files are written with block size and record size of 10240 bytes, default drive density, and assuming 2400 feet of tape left. The files are written with fixed-length records, since F was specified after D.
The first file is written with file sequence number 1 in the header, and the tape is not rewound after it is written. The R option is specified so that the tape is NOT rewound at completion.
The second file will have sequence number 2 written in its header. The A option indicates the tape is already correctly positioned to write the next file (the tape label is NOT verified). The R option indicates not to rewind the tape at completion.
The third file is written with the A option. The A option indicates the tape is already correctly positioned to write the next file (the tape label is NOT verified). Since the R option is not specified, the tape is rewound at completion.