Display Tape Category (DSPTAPCGY)

The Display Tape Category (DSPTAPCGY) command allows the user to display the categories defined through the Create Tape Category (CRTTAPCGY) command.

Parameters

Keyword	Description	Choices	Notes
OUTPUT	Output	, PRINT, *OUTFILE	Optional, Positional 1
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

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting workstation, printed to an output file, 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 a database file specified on the OUTFILE parameter. The file must have the same format as database file QATACOF.

File to receive output (OUTFILE)

Specifies the qualified name of the database file to which the information about the tape volumes 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 QATACOF in QSYS as a model with the format name of QTACOUTF. This parameter is valid only when OUTPUT(*OUTFILE) 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.

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.

Examples

DSPTAPCGY   OUTPUT(*)

This command displays the user defined categories on this system to the workstation display.