Starts the editor established with the SET EDITOR command. If you
did not enter a SET EDITOR command, starts the Language-Sensitive
Editor (LSE), if that editor is installed on your system.
Format
EDIT [[module-name\] line-number]
1 – Parameters
module-name
Specifies the name of the module whose source file is to be
edited. If you specify a module name, you must also specify a
line number. If you omit the module name parameter, the source
file whose code appears in the current source display is chosen
for editing.
line-number
A positive integer that specifies the source line on which the
editor's cursor is initially placed. If you omit this parameter,
the cursor is initially positioned at the beginning of the source
line that is centered in the debugger's current source display,
or at the beginning of line 1 if the editor was set to /NOSTART_
POSITION (see the SET EDITOR command.)
2 – Qualifiers
2.1 /EXIT
/EXIT
/NOEXIT (default)
Controls whether you end the debugging session prior to starting
the editor. If you specify /EXIT, the debugging session is
terminated and the editor is then started. If you specify
/NOEXIT, the editing session is started and you return to your
debugging session after terminating the editing session.
3 – Description
If you have not specified an editor with the SET EDITOR command,
the EDIT command starts the Language-Sensitive Editor (LSE) in
a spawned subprocess (if LSE is installed on your system). The
typical (default) way to use the EDIT command is not to specify
any parameters. In this case, the editing cursor is initially
positioned at the beginning of the line that is centered in the
currently selected debugger source display (the current source
display).
The SET EDITOR command provides options for starting different
editors, either in a subprocess or through a callable interface.
Related commands:
(SET,SHOW) EDITOR
(SET,SHOW,CANCEL) SOURCE
4 – Examples
1.DBG> EDIT
This command spawns the Language-Sensitive Editor (LSE) in a
subprocess to edit the source file whose code appears in the
current source display. The editing cursor is positioned at the
beginning of the line that was centered in the source display.
2.DBG> EDIT SWAP\12
This command spawns the Language-Sensitive Editor (LSE) in a
subprocess to edit the source file containing the module SWAP.
The editing cursor is positioned at the beginning of source
line 12.
3.DBG> SET EDITOR/CALLABLE_EDT
DBG> EDIT
In this example, the SET EDITOR/CALLABLE_EDT command
establishes that EDT is the default editor and is started
through its callable interface (rather than spawned in a
subprocess). The EDIT command starts EDT to edit the source
file whose code appears in the current source display. The
editing cursor is positioned at the beginning of source line 1,
because the default qualifier /NOSTART_POSITION applies to EDT.