Edit File (EDTF)

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

The Edit File (EDTF) command allows you to edit a stream file or a database file. This command can also be used to browse a file or directory.

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
Top

Stream file, or (STMF)

Specify the name of the file to be edited.

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

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, 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 edited.

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 edited.

The possible values are:

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

Examples

Example 1: Editing a Stream File

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

This command will start an edit session for file myfile.txt in directory mydir under the root directory.

Example 2: Editing a Database File Member

EDTF   FILE(MYLIB/MYFILE) MBR(MYMBR1)

This command will start an edit session for 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
Invalid line command.
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