DSPDKT (Display Diskette) Command Description

DSPDKT Command syntax diagram

Purpose

The Display Diskette (DSPDKT) command shows the volume label and data file identifier information that is on the diskette. Information about the objects saved to the diskette can also be shown. The information can be printed or shown on a display device.

If a user specifies DATA(*SAVRST), information is retrieved which includes a description of each object saved to the diskette and summary information about all saved objects.

Note: When showing diskettes with labels that are not IBM standard labels, unpredictable results may occur. To initialize the diskette, run the Initialize Diskette (INZDKT) command with CHECK(*NO) specified.

Required Parameter

DEV
Specifies the name of the device on which the volume being displayed is located.

Optional Parameters

LABEL
Specifies the data file identifier, or all the identifiers, of the data files on the diskette being shown. The data file identifier is stored in a label in the volume label area of the diskette, and it specifies the identifier of the file that exists on the diskette.

*ALL: All data file identifiers on the diskette specified by the DEV parameter are shown.

data-file-identifier: Specify the data file identifier (17 alphanumeric characters maximum) of the data file that is shown. (For data files in the basic, H-, or I-format, the identifier can contain up to 8 characters.)

DATA
Specifies the type of information that is shown.

*LABELS: Volume and data file identifiers are shown.

*SAVRST: Shows the save or restore summary information about the command and each saved object.

OUTPUT
Specifies whether the output from the command is shown at the requesting work station or printed with the job's spooled output on a printer. More information on this parameter is in commonly used parameters.

*: Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.

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

Note: Each file on the diskette that was created by the Save (SAV) command is printed as a separate listing.

Example for DSPDKT

DSPDKT   DEV(DKT01)

This command shows the volume label and all the data file identifiers for the diskette in device DKT01.

Error messages for DSPDKT

*ESCAPE Messages

CPD375A
Media error on save media.
CPF3704
Request ended; data management error occurred.
CPF3738
Device &1 used for save or restore is damaged.
CPF3743
File cannot be restored, displayed, or listed.
CPF3791
While processing &2 &1 in &3, encountered end of file &4.
CPF3792
Information not displayed. Error occurred.
CPF3793
Machine storage limit reached.
CPF3796
Storage limit exceeded for user profile &4.
CPF6017
Display diskette ended; previous error occurred.
CPF6716
Device &1 not a diskette device.
CPF6718
Cannot allocate device &1.
CPF9814
Device &1 not found.
CPF9825
Not authorized to device &1.
CPF9851
Overflow value for file &1 in &2 too small.