Display Tape Category (DSPTAPCGY)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Tape Category (DSPTAPCGY) command allows the user to display the categories defined through the Create Tape Category (CRTTAPCGY) command.
| Top |
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.
- 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.
| Top |
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.
| 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
DSPTAPCGY OUTPUT(*)
This command displays the user defined categories on this system to the workstation display.
| Top |
| Top |