Display Tape (DSPTAP)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Display Tape (DSPTAP) command shows the volume label and data file label information that is contained on a standard labeled magnetic tape or the volume type and density. The information can be printed or shown on a display device. Additional information, including a description of each object saved to the tape file and summary information about the saved objects, can be displayed by specifying *SAVRST on the Data type prompt (DATA parameter).

Top

Parameters

Keyword	Description	Choices	Notes
DEV	Device	Name	Required, Positional 1
VOL	Volume identifier	Character value, *MOUNTED	Optional
LABEL	File label	Character value, *ALL	Optional
SEQNBR	Sequence number	Single values: *ALL Other values: Element list	Optional
	Element 1: Starting file sequence number	1-16777215, *FIRST
	Element 2: Ending file sequence number	1-16777215, ONLY, LAST
DATA	Data type	LABELS, SAVRST	Optional
OUTPUT	Output	, PRINT, *OUTFILE	Optional
ENDOPT	End of tape option	REWIND, UNLOAD	Optional
OUTFILE	File to receive output	Qualified object name	Optional
	Qualifier 1: File to receive output	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OUTMBR	Output member options	Element list	Optional
	Element 1: Member to receive output	Name, *FIRST
	Element 2: Replace or add records	REPLACE, ADD

Top

Device (DEV)

Specifies the name of the tape or media library device in which the volume being shown is placed.

This is a required parameter.

Top

Volume identifier (VOL)

Specifies the tape volume to be displayed.

Note: If the device specified is a media library device, or a virtual tape device, then the volume specified should be the cartridge identifier or virtual volume name to be mounted and used.

*MOUNTED: The volume currently placed in the device is used. For a media library device, the volume to be used is the next cartridge in the category mounted by the Set Tape Category (SETTAPCGY) command. For a virtual tape device, the volume to be used is the currently mounted one, or if there is not a currently mounted volume, the next volume in loaded status in the image catalog will be used.
character-value: Specify the volume identifier of the labeled volume. The volume identifier read from the tape is compared to this value. If the volume identifier specified is not found on the tape, an escape message is sent.

Top

File label (LABEL)

Specifies the data file identifiers of the data files on the tape whose labels are shown. The data file identifier is stored in the label ahead of the data in the file.

*ALL: All data file identifiers on the tape specified on the Tape device prompt (DEV parameter) are shown.
character-value: Specify the data file identifier (17 alphanumeric characters maximum) of the data file for which label information is shown.

Top

Sequence number (SEQNBR)

Specifies, for volumes with multiple files, the range of sequence numbers of the data files on tape whose label information is displayed. If *ALL is specified on the File label prompt (LABEL parameter), all labels for the files within the specified sequence number range are displayed after the specified starting file sequence number.

If a specific LABEL identifier is specified, it is compared with the label identifier of the data file specified by the starting sequence number. If the identifiers do not match, an error message is sent.

Single values

*ALL: All data file labels on the tape are displayed.

Element 1: Starting file sequence number

*FIRST: The data file labels being displayed begin with the first file (or the only file) on the tape.
1-16777215: Specify the starting file sequence number. If the specified starting file sequence number is not found on the tape, an error message is sent.

Element 2: Ending file sequence number

*LAST

The range of data file labels being displayed begins with the specified starting file sequence number and ends with the last data file label on tape.

*ONLY

Only the file specified in the starting sequence is displayed.

1-16777215

Specify the ending file sequence number. The specified ending file sequence number must be greater than or equal to the starting file sequence number.

Note: The ending file sequence number is ignored for OUTPUT(*) for an interactive job. The user has control and can continue to display information or end whenever they desire.

Note: The ending file sequence number is ignored if a specific LABEL identifier is specified.

Top

Data type (DATA)

Specifies the type of information that is shown.

*LABELS: The volume label and data file labels are shown.
*SAVRST: Shows the summary information about the command and each saved object.

Top

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.

*: The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).

*PRINT: The output is printed with the job's spooled output.

*OUTFILE: The output is directed to the database file specified on the OUTFILE parameter.

Top

End of tape option (ENDOPT)

Specifies the operation that is automatically performed on the tape volume after the operation ends. If more than one volume is included, this parameter applies only to the last tape volume used; all other tape volumes are rewound and unloaded when the end of the tape is reached.

*REWIND: The tape is automatically rewound, but not unloaded, after the operation has ended.
*UNLOAD: The tape is automatically rewound and unloaded after the operation ends.

Top

File to receive output (OUTFILE)

Specifies the qualified name of the database file to which the information about the tape files is directed. If the file does not exist, this command creates a database file in the specified library. If a new file is created, the system uses QATADOF in QSYS as a model with the format name of QTADOUTF.

Note: This parameter is valid only when OUTPUT(*OUTFILE) and DATA(*LABELS) is specified.

Qualifier 1: File to receive output

name: Specify the name of the database file to be used.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name: Specify the name of the library to be searched.

Top

Output member options (OUTMBR)

Specifies the name of the database file member to which the output is directed when OUTPUT(*OUTFILE) is specified.

Element 1: Member to receive output

*FIRST: The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the OUTFILE parameter.
name: Specify the name of the file member that is to receive the output. If a member name is specified and the member does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE: The existing records in the specified database file member are replaced by the new records.
*ADD: The system adds the new records at the end of the existing member.

Top

Examples

DSPTAP   DEV(QTAPE2)  LABEL(*ALL)

This command displays the volume label and file labels on the tape volume that is on the tape device named QTAPE2.

Top

Error messages

*ESCAPE Messages

CPD375A: Media error on save media.
CPF3704: Request ended; data management error occurred.
CPF3743: File cannot be restored, displayed, or listed.
CPF3792: Information not displayed. Error occurred.
CPF3793: Machine or ASP storage limit reached.
CPF6708: Command ended due to error.
CPF6718: Cannot allocate device &1.
CPF6721: Device &1 not a tape device.
CPF6723: File not found on volume &2 on device &1.
CPF6724: File label &5 not found on volume &2.
CPF6745: Device &1 not a media library device.
CPF6751: Load failure occurred on device &4.
CPF6760: Device &1 not ready.
CPF6772: Volume on device &1 cannot be processed.
CPF9814: Device &1 not found.
CPF9825: Not authorized to device &1.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.
CPF9850: Override of printer file &1 not allowed.
CPF9851: Overflow value for file &1 in &2 too small.

Top