User's Guide

ANSI

Perform all ANSI tape functions.

Function:

Perform all of the available ANSI labeled tape manipulation functions. This includes initialization, directory listings, reading, and writing.

Parameters:

Subcommand -INIT:
Initialize an ANSI labeled tape.

DRIVE
Tape drive. Tape drive the tape is mounted on.

TAPEID
Tape identification. ANSI tape identification number for the tape mounted on DRIVE. See User Note 1.

RELOPT(YES)
Release option. Indicates if the tape drive should be released after the last tape has been initialized.

  = YES: Release tape drive
  = NO:  Do not release tape
         drive
Subcommand -DIR:
List the files contained on an ANSI labeled tape.

DRIVE
Tape drive. Tape drive the tape is mounted on.

TAPEID(--)
Tape identification. ANSI tape identification number for the tape mounted on DRIVE. If an ID is specified ANSI-DIR will ensure that is indeed the tape mounted on DRIVE. If NULL, ANSI-DIR will ignore the ID of the tape mounted on DRIVE.

LISTOPT(LONG)
List option. Specifies the type of file listings that should be produced.

  = SHORT: File names only.
  = MED:   Medium length listing of the files.
  = LONG:  Long listing of the files.
Subcommand -READ:
Copy files from an ANSI labeled tape into the current working directory.

DRIVE
Tape drive. Tape drive the tape is mounted on.

TAPEID
Tape identification. ANSI tape identification number for the tape mounted on DRIVE.

FILES(--)
Files. The files to be copied from the specified tape. NULL indicates that all files should be copied.

LISTOPT(LONG)
List option. Specifies the type of file listings that should be produced.

  = SHORT: File names only.
  = MED:   Medium length listing of the files.
  = LONG:  Long listing of the files.
Subcommand -WRITE:
Copy files to an ANSI labeled tape.

DRIVE
Tape drive. Tape drive the tape is mounted on.

TAPEID
Tape identification. ANSI tape identification number for the tape mounted on DRIVE.

RECSIZE
Record size. Number of bytes in each record for the specified files.

BLKSIZE
Block size. Number of bytes to be contained in a block.

FILES
Files. The files that are to be copied to the specified tape. See User Note 2.

RECTYPE(FIXED)
Record type. Indicates that the specified files should be written to the tape as fixed or variable length records.

   = FIXED: Fixed length records.
   = VAR:   Variable length records.

TAPEOPT(CREATE)
Tape option. Indicates that the specified files should over write any files currently on the tape or if they should be appended to the end of the tape.

  = CREATE: Over write any files on the tape.
  = APPEND: Append files to the end of the tape.

LISTOPT(LONG)
List option. Specifies the type of file listings that should be produced.

  = SHORT: File names only.
  = MED:   Medium length listing of the files.
  = LONG:  Long listing of the files.

Examples:

  1. LAS> ansi-init drive=4 tapeid=000001

    The tape mounted on drive four is initialized to be the ANSI labeled tape 000001. Upon completion the tape is dismounted.

  2. LAS> ansi-init drive=4 tapeid=000002 relopt=no

    The tape mounted on drive four is initialized to be the ANSI labeled tape 000002. Upon completion the tape is left in drive four.

  3. LAS> ansi-dir drive=0

    A long listing of the files contained on the tape mounted on drive zero is displayed.

  4. LAS> ansi-dir drive=0 listopt=short

    The names of the files contained on the tape mounted on drive zero are displayed.

  5. LAS> ansi-read drive=0 tapeid=000003

    All of the files contained on tape 000003 are copied into the current working directory. A long listing is provided for each file as it is copied.

  6. LAS> ansi-read drive=mua0 tapeid=000004 listopt=med files=(test1.prt test2.prt imp*.prt)

    The files test1.prt, test2.prt and all of the files matching imp*.prt are copied from tape 000004 to the current directory. A medium length listing is provided for each file as it is copied.

  7. LAS> ansi-write drive=2 tapeid=000005 recsize=13796 blksize=27592 files=ah11*

    All of the files matching ah11* are copied to the tape 000005 mounted on drive two. The files are written with a record size of 13,796 bytes and are blocked at 27,592 bytes. A long listing is provided for each file as it is copied to tape.

  8. LAS> ansi-write drive=1 tapeid=000006 recsize=14800 blksize=14800 files=(img1.arch img2.arch) tapeopt=append listopt=short

    The files img1.arch and img2.arch are appended to the end of tape 000006 mounted in drive two. Both files are copied to the tape with a record and block size of 14,800 bytes. The names of both files are displayed as they are copied to tape.

Description/Algorithm:

ANSI will make a call to the appropriate system command for each subcommand. The system commands ansinit, ansidir, ansiin, and ansiout are commands that are only available at the EROS Data Center.

Nonfatal Error Message:

  1. [ansi-abort] User aborted ANSI-<xxxx>

    The user aborted the specified command.

Fatal Error Message:

  1. [ansi-fatal] Fatal error encountered

    A fatal error was encountered. Processing terminates. The error message preceding this message is the specific error that was encountered.

User Notes:

  1. Multiple tapes should only be specified for the ANSI-INIT command when the specified tape drive is equipped with an automatic tape stacker.

  2. ANSI-WRITE should only be used to copy files from the current working directory. Because file names are truncated to 17 characters, if a path is specified all of the files copied to tape may end up with the same file name.

  3. All of the tapes used by the ANSI commands must be ANSI labeled tapes with the exception of ANSI-INIT. This command will create an ANSI labeled tape.

  4. All file names are host file names.

  5. For additional information see the system commands ansinit, ansidir, ansiin, and ansiout. These commands are only available at the EROS Data Center.