Display Optical File (DSPOFRDAR)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Display Optical File (DSPOFRDAR) Command displays the contents of an optical file. The file may be a physical or logical optical file. The data is displayed in the sequence specified by the access path for the file.

Top

Parameters

Keyword Description Choices Notes
FILE Optical file Qualified object name Required, Positional 1
Qualifier 1: Optical file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
NBRRCDS Number of records Decimal number, 100, *ALL Optional
FROMRCD From record Decimal number, 1, *END Optional
Top

Optical file (FILE)

Specifies the name of the optical file whose contents is to be displayed.

This is a required parameter.

Qualifier 1: Optical file

name
Specify the name of the optical file to be displayed.

Qualifier 2: Library

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is where the file is located. If no library is specified as the current library for the job, QGPL is used.
name
Specify the name of the library where the optical file is located.
Top

Number of records (NBRRCDS)

Specifies the maximum number of records you want to display. Because optical files may contain millions of records, you may want to limit the number of records to save time. All of the records are copied to a temporary database file before they are displayed.

100
The first 100 records in the optical file are copied to the temporary database file.
*ALL
All of the records in the optical file are copied to the temporary database file.
number-of-records
Specify the number of records to copy to the temporary database file. Valid values range from 1 through 99999999999.
Top

From record (FROMRCD)

Specifies which record in an optical file is shown on the top line of the initial display. This value must be between 1 and the value specified for the Number of records (NBRRCDS) parameter. You can display other records within the range of records specified by the NBRRCDS parameter using the page-up and page-down keys.

1
Record number one in the optical file is shown.
*END
The last record (as specified by the NBRRCDS parameter) is shown. The *END value shows the last complete page so that the last record in the optical file appears at the bottom of the display.
record-number
Specify the number of the record to show on the top line of the initial display.
Top

Examples

None
Top

Error messages

*ESCAPE Messages

RDR5402
Unable to display description for Optical File &1 in &2.
RDR5405
Unable to display contents of Optical File &1 in &2.
Top