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