Display Tape Status (DSPTAPSTS)
The Display Tape Status (DSPTAPSTS) command does the following:
- Displays slot information associated with the media library device.
- Displays information about the resources attached to the media library device.
| Keyword |
Description |
Choices |
Notes |
| DEV |
Library device |
Name, *ALL |
Optional, Positional 1 |
| OUTPUT |
Output |
*, *PRINT, *OUTFILE |
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 |
| OUTFILFMT |
Outfile format |
*TYPE1, *TYPE2 |
Optional |
Library device (DEV)
Specifies the name of the media library device in which information is displayed.
- *ALL
- Specifies that all tape media library devices defined through Create Device Media Library (CRTDEVMLB) command are displayed.
- name
- Specify the device name. The device name must be a tape media library device name or a random access cartridge loader (RACL) device name. The device name must already be known to the system by Create Device Media Library (CRTDEVMLB) command.
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 requested output is shown on the display. If this value is specified for a batch job, the effect is the same as if *PRINT were entered.
- *PRINT
- The requested output is written to a spooled file, which is found in the job's output queue.
- *OUTFILE
- The output is directed to a database file specified on the OUTFILE parameter. The file must have the same format as database file QATAIOF or QATAIOF2.
File to receive output (OUTFILE)
Specifies the database file to which the information about the tape media libraries is directed. If the file does not exist, this command creates a database file in the specified library. If a new file is created with OUTFILFMT(*TYPE1), the system uses QATAIOF in QSYS as a model with the format name of QTAIOUTF. If a new file is created with OUTFILFMT(*TYPE2), the system uses QATAIOF2 in QSYS as a model with the format name of QTAIOF2. 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.
Output member options (OUTFILFMT)
Specifies the format of the output file when OUTPUT(*OUTFILE) is specified.
- *TYPE1
- The format is defined by model output file QATAIOF in library QSYS with record format name QTAIOUTF.
- *TYPE2
- The format is defined by model output file QATAIOF2 in library QSYS with record format name QTAIOF2.
DSPTAPSTS DEV(LIB01) OUTPUT(*)
This command displays the valid information about this library device to the workstation display.
*ESCAPE Messages
- CPF6718
- Cannot allocate device &1.
- CPF6745
- Device &1 not a media library device.
- CPF67E4
- Library device function not successful
- CPF67E7
- No library devices exist
- 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.
- CPF9860
- Error occurred during output file processing.
- CPF9871
- Error occurred while processing.