EDIT
.-NONAME--------------------------. >>-EDIT--+---------------------------------+--------------------> +-fileid--------------------------+ '-lib.sublib--(--mem.type--)--LIB-' >--+---------------------+------------------------------------->< '-(--MACRO--macroname-'
EDIT opens a new edit session.
Operands
- fileid
- specifies the file ID of the file to be created or edited.
- lib.sublib(mem.type)
- specifies a VSE Librarian sublibrary and member to be edited.
- LIB
- is a keyword that follows a VSE Librarian sublibrary member name when a sublibrary member is being edited.
- MACRO
- is a keyword specifying a group of instructions applied to the file being edited.
- macroname
- specifies the file name portion of the profile macro file ID (REXX exec name).
Return codes
- 0
- Normal return
- 203
- File not found
- 204
- Not authorized
- 211
- Invalid file ID
- 226
- File is currently being edited
- 299
- Internal error
Example
'EDIT TEST.EXEC'
This example opens an edit session for the file TEST.EXEC.
Notes
- The directory used when editing a file, is determined as follows:
- If a fully qualified directory ID is explicitly given, then it is always used.
- If a partially qualified file ID is specified, then the current
directory and path are searched in an attempt to find an existing
file that would match the file ID (if it were fully resolved using
that directory name).
- If such a match is successful, then the edit session is for an existing file and the file ID is fully resolved using the directory the file was found in.
- If the file is not located in the search order, then an edit session for a new file is created, with the fully resolved file ID specifying the current working directory (as specified by the CD command).
- A VSE Librarian sublibrary member is distinguished by using the keyword LIB after the member name. Members must be enclosed in parentheses, quotes are not allowed.
- The default user profile macro that the editor tries to call is CICEPROF. The CICEPROF macro creates an ISPF/PDF like environment. A second profile macro, named CICXPROF, is provided. CICXPROF creates a VM/CMS XEDIT like environment.
- If a file ID or VSE Librarian sublibrary member name is not specified, an RFS file with the special name, NONAME, is created.
