User's Guide

TAPELABEL

Create a label for a tape

Function:

Creates a library storage label for a tape. A standard library archive tape label or a free-formatted label may be generated.

Parameters:

Subcommand -LIB:
Standard library tape label. The standard tape label used for archive tapes at the EROS Data Center will be generated.

NAME
Requestor's initials. The three letter initials assigned to the user for the tape archive.

CODE
Code for the requestor's group. The code assigned to the user's group for the EROS tape archive. Refer to the tape library for a specific code.

PROJECT
Project name. The name of the project associated with the tape.

DESCRPT
Description of the tape. Short description of the contents of the tape.

PRINTFLG
Print flag. Flag to determine whether to print the label.

   = YES: Print the label
   = NO:  Generate a label file only

TAPEID
Tape identification. Used for cataloging tapes in the tape library.

TAPEDRIV
Tape drive. Drive the tape was created on.

SEQNUM
Sequence number. The sequence number of the tape within the set.

NTAPES
Number of tapes. Total number of tapes in this set.

OUTFILE
Output file name. The file name containing the tape label information is returned to the user. The specified variable must have been previously defined in TAE as a local string variable.

NMONTHS(1)
Number of months to retain tape. Number of months from the current date before the tape should be purged from the tape library. If zero is specified the tape will become a permanent archive and will not be purged.

TAPEDENS(&$TPDENS)
Tape density. The density of the tape in bytes per inch. The default is defined by the TAE global $TPDENS and the list of valid densities are defined by the TAE global $TPVAL.
Subcommand -FREE:
Free-format tape label. The tape label will appear exactly as the user enters the text.

PRINTFLG
Print flag. Flag to determine whether to print the label.

   = YES: Print the label
   = NO:  Generate a label file only

OUTFILE
Output file name. The file name containing the tape label information is returned to the user. The specified variable must have been previously defined in TAE as a local string variable.

TEXT
Text to print on the tape label. This text will appear on the tape label exactly as the user enters it.

Examples:

  1. LAS> tapelabel-lib name=abc code=091 project=las descrpt="landsat image of seattle" printflg=no tapeid=001731 tapedriv=1 seqnum=1 ntapes=3 outfile=outx nmonths=0 tapedens=6250

    A standard library archive tape label will be generated with a purge date of 99999999 (permanent tape archive). The label will not be printed; a message informing the user of the location of the label file is printed. The SEQUENCE field of the label will contain "1/3" from the SEQNUM and NTAPES input parameters. The name of the label file will be returned in OUTX, where OUTX is a previously declared local TAE string variable.

  2. LAS> tapelabel-free printflg=yes outfile=outx text="line 1 information here", "line 2 information here", "line 3 information here", "line 4 information here", "line 5 information here", "line 6 information here"

    A free-formatted tape label will be generated and printed. The label will be printed exactly as the data is entered into TEXT. The name of the label file will be returned in OUTX even though the file is deleted after it has been successfully printed.

Description/Algorithm:

TAPELABEL retrieves the input parameters specified by the user. The sub-command -LIB will generate a standard library archive tape label. The sub-command -FREE will generate a freeformatted tape label. The label file may or may not be printed, depending on the value of PRINTFLG. If the label file is printed, it will be deleted. The location of the label file is always returned in OUTFILE, even if the file has been printed and deleted.

Nonfatal Error Messages:

  1. [tapelabel-warn] Nonfatal error encountered

    A nonfatal error was encountered during processing; processing will continue.

  2. [tapelabel-seq] Sequence number greater than total number

    The sequence number specified by SEQNUM is greater than the total number of tapes in the set (NTAPES). These parameters are used only to specify the 'seq' field in the standard library label.

Fatal Error Messages:

  1. [tapelabel-fatal] Fatal error encountered

    A fatal error was encountered; processing is terminated. The message that is displayed immediately preceding this error message is the specific error that was encountered.

  2. [tapelabel-rparm] Error returning parameter to TAE

    An error was encountered while trying to return a value to TAE.

User Notes:

  1. Printing of the label file should only be attempted at the EROS Data Center.

  2. The only difference between this routine and TAPE_LABEL is that this routine requires the parameter OUTFILE.