TAPELABEL

TAPELABEL

Lists the label information of an IBM standard labeled tape volume

CMS specifics: all

Syntax
Details
PROC TAPELABEL Statement
	Printed Output
Examples

Syntax

PROC TAPELABEL <options>;

Details

The TAPELABEL procedure lists the label information of an IBM standard labeled tape volume. The TAPELABEL procedure can process one or more standard labeled tape volumes. The procedure prints information from the tape label, including the data set name, DCB information, and data set history. Alternately, you can use the MAP option to print information about standard labeled and nonstandard labeled tapes, including block sizes, block counts, and length of tape in feet for each file.

PROC TAPELABEL Statement

Syntax

PROC TAPELABEL <options>;

The following options can appear in the PROC TAPELABEL statement:

DDNAME=(fileref-1... fileref-n)

specifies the fileref assigned to the tape volume to be processed. More than one fileref can be specified. If you specify only one fileref, you can omit the parentheses.

DUMP

provides, in addition to normal output a dump of the first 80 bytes of the first 10 blocks of each file.

MAP

treats the type as nonlabeled and provides the following information for every file on the tape. This information replaces the output listed in Printed Output:

the number of blocks
the length in bytes of the largest and the smallest block in the file
the density with which the tape was written
the length in feet.

PAGE

begins the output for each tape volume on a new page.

TAPn

specifies a CMS tape symbolic name, where n can be a value of 0, 1-9, or A-F. See Symbolic Names for CMS Tape Output Devices for a listing of the virtual address that corresponds to each symbolic name.

This option can be used instead of (or in addition to) the DDNAME= option to specify a tape volume to be processed. A corresponding FILENAME statement or CMS FILEDEF command is unnecessary if the TAPn option is used.

Note: If you omit the DDname= and TAPn options, the default fileref is TAP1. [cautionend]

Printed Output

For each file on a tape volume, the TAPELABEL procedure prints the following information:

FILE NUMBER, the file sequence number (from header label)
DSNAME, the data set name
RECFM, the record format
LRECL, the logical record length
BLKSIZE, the block size
BLOCK COUNT, the number of blocks in the file (from the trailer label)
EST FEET, the estimated length of the file in feet
CREATED, the file creation date
EXPIRES, the file expiration date
CREATED BY JOB NAME STEPNAME, the job and step names of the job that created the file
TRTCH, the track recording technique
DEN, the file recording density code
PSWD, the file protection indicator
UHL, the number of user header labels
UTL, the number of user trailer labels.

In addition, the TAPELABEL procedure prints the sum of the estimated file lengths.

Examples

Use the TAPELABEL procedure to list label information. For example, the following statements list the label information for all files on the tape volume currently mounted on virtual address 182:

proc tapelabel tap2;
   title 'Label Information for VA182 Tape Volume Files';
run;

If you have tape volumes mounted at multiple virtual addresses, use statements similar to the following:

filename labtape tape 'tap3';

proc tapelabel ddname=labtape tap7 tapf page;
run;

These statements list the label information for all files on the tape volumes currently mounted on virtual addresses 183, 187, and 28F. The output for each volume is printed on a separate page.

Chapter Contents
Previous
Next
Top of Page