Display File (DSPF)

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

The Display File (DSPF) command allows you to display a stream file or a database file.

Top

Parameters

Keyword Description Choices Notes
STMF Stream file, or Path name Optional, Positional 1
FILE Data base file Qualified object name Optional, Positional 2
Qualifier 1: Data base file Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR File member Name, *FIRST Optional, Positional 3
Top

Stream file, or (STMF)

Specify the name of the file to be displayed.

stream-file-name
Specifies the path name of the object or a pattern to match the name of the object to be displayed.

The object path name can be either a simple name or a name that is qualified with the name of the directory in which the object is located. A pattern can be specified in the last part of the path name. An asterisk (*) matches any number of characters. A list of all files or subdirectories that match the specified characters will be displayed. If the path name is qualified or contains a pattern, it must be enclosed in apostrophes. If the file name specified is a directory, the a list of the files and subdirectories is displayed. From this list you can edit or display the files in the directory.

For more information on specifying path names, refer to "Object naming rules" in the CL concepts and reference topic in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Top

Data base file (FILE)

Specifies the name of the database file to be displayed.

The possible library values are:

*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 thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
name
Specify the name of the library to be searched.
Top

File member (MBR)

Specifies the name of the database file member to be displayed.

The possible values are:

*FIRST
The first member in the database file is displayed.
member-name
Specify the name of the member to be displayed.
Top

Examples

Example 1: Displaying a Stream File

DSPF  STMF('/mydir/myfile.txt')

This command will display file myfile.txt in directory mydir under the root directory.

Example 2: Displaying a Database File Member

DSPF  FILE(MYLIB/MYFILE) MBR(MYMBR1)

This command will display member MYMBR1 of file MYFILE in library MYLIB.

Top

Error messages

*ESCAPE Messages

CPFB601
Display file QDZRUEDT missing or damaged.
CPFB604
Error processing line commands.
CPFB605
Unexpected error opening file.
CPFB609
Cannot allocate work space.
CPFB610
Command not valid.
CPFB611
&1 occurrences of &3 changed. &2 not changed.
CPFB612
Find or replacement string not specified.
CPFB613
Error opening printer file.
CPFB614
File name not specified.
CPFB615
Target line not specified.
CPFB617
CCSID not valid.
CPFB618
Conversion between CCSID &1 and the job's CCSID is not supported.
CPFB619
File is empty.
CPFB620
&2
CPFB621
File cannot be displayed and/or edited.
Top