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.