Display File (DSPF)
Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
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 topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/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 |