Retro1.org codex

EDIT                                                      CMS User Area command

Use the EDIT command to invoke the CMS editor to create, modify, and manipulate
CMS disk files.  Once the editor has been invoked, you can only execute EDIT
subcommands and edit macro requests, and input data lines into the disk file.
A limited number of CMS commands may be executed in the CMS subset mode.  Enter
CMS subset mode from the edit environment by issuing the EDIT subcommand, CMS.

You can return control to the CMS environment by issuing the EDIT subcommands
FILE or QUIT.  The format of the EDIT command is:
+----------+------------------------------------------------------------------+
| Edit     | fn fm [*|fm] [( [LRECL nn] [NODISP] [)]]                         |
+----------+------------------------------------------------------------------+
where:

fn  ft   is the filename and filetype of the file to be created or edited.  If
         a file with the specified filename and filetype does not exist, the
         CMS editor assumes that you want to create a new file, and after you
         issue the INPUT subcommand, all data lines you enter become input to
         the file.  If a file with the specified filename and filetype exists,
         you may issue EDIT subcommands to modify the specified file.

fm       is the filemode of the file to be edited, indicating the disk on which
         the file resides.  The editor determines the filemode of the edited
         file as follows:

         Editing existing files:  If the file does not reside on your A-disk or
         its extensions, you must specify fm.

         When you specify fm, the specified disk and its extensions are
         searched.  If a file is found on a read-only extension, the filemode
         of the parent disk is saved; when you issue a FILE or SAVE subcommand,
         the modified file is written to the parent disk.

         If you specify fm as an asterisk (*) all accessed disks are searched
         for the specified file.

         Creating new files:  If you do not specify fm, the new file is written
         on your A-disk when you issue the FILE or SAVE subcommands.

Options:

LRECL nn is the record length of the file to be created or edited.  Use this
         option to override the default values supplied by the editor, which
         are determined as follows:

         Editing Existing Files:  Existing record length is kept regardless of
         format.  If the file has variable-length records and the existing
         record length is less than the default record length, the default
         record length is used.

         Creating New Files:  All new files have a record length of 80, with
         the following exceptions:
            Filetype            LRECL
            LISTING             121
            SCRIPT,VSBDATA      132
            FREEFORT            81
         The maximum record length supported by the editor is 160 characters.

NODISP   forces a 3270 display terminal into line (typewriter) mode.  When the
         NODISP option is in effect, all subcommands that control the display
         as a 3270 terminal such as SCROLL, SCROLLUP, and FORMAT (and CHANGE
         with no operands) are made invalid for the edit session.

EDIT subcommands:

The following subcommands and macros are avaiable when you use the CMS editor:

ALTER     Change one character to another.
ALTERUP   Change one character to another.
AUTOSAVE  Set the automatic save function.
BACKWARD  move the current line pointer up.
BOTTOM    move the current line pointer to the last line.
CASE      set whether or not input is to be translated to uppercase.
CHANGE    change text in the file.
CHANGEUP  change text in the file.
CMS       enter CMS subset mode.
DELETE    delete lines from the file.
DELETEUP  delete lines from the file.
DOWN      move the current line pointer down.
DSTRING   delete lines containing a string.
$DUP      (macro) duplicate the current line.
EDIT      begin editing an additional file.
FILE      save the file and exit the editor.
FIND      find a line that begins with a string.
FINDUP    find a line that begins with a string.
FMODE     display or set the filemode.
FNAME     display or set the filename.
FORMAT*   change the display mode.
FORWARD*  move the current line pointer down.
GETFILE*  copy a file into the file being edited.
IMAGE*    control how backspace and tab characters are handled.
INPUT*    insert new lines into the file.
LINEMODE* set line-number editing.
LOCATE*   find a line containing a string.
LOCATEUP* find a line containing a string.
LONG*     set the error message display.
LVL*      move among multiple files being edited.
$MOVE*    (macro) move one or more lines within the file.
NEXT*     move the current line pointer down.
OVERLAY*  overlay data in the current line.
PRESERVE* save edit settings.
PROMPT*   set the prompting increment for line-number editing.
QUIT*     exit the editor without saving the file.
RECFM*    display or set the record format.
RENUM*    reunumber VSBASIC or FREEFORT source files.
REPEAT*   repeat an OVERLAY command.
REPLACE*  replace the current line.
RESTORE*  restore edit settings.
RETURN*   return from CMS subset mode.
REUSE*    stack the last edit command for reuse.
SAVE*     save the file on disk.
SCROLL*   scroll forward through the file.
SCROLLUP* scroll backward through the file.
SERIAL*   control serialization in columns 73 to 80.
SHORT*    set the error message display.
STACK*    stack lines or commands.
STACKUP*  stack lines or commands.
TABSET*   set tab stops.
TOP*      move the line pointer to the top of the file.
TRUNC*    set or display the truncation column.
TYPE*     type all or part of the file.
TYPEUP*   type all or part of the file.
UP*       move the current line pointer up.
VERIFY*   set or display the verification setting.
X*        assign an edit subcommand to X.
Y*        assign an edit subcommand to Y.
ZONE*     set column boundaries for text searches.
?*        display the last edit subcommand.
nnnnn*    enter and locate lines when using line-number editing.

For help on any subcommand or macro, enter HELP EDIT subcommand.

* after the subcommand or macro name means that help is not yet available for
that subcommand or macro.


Responses:

NEW FILE:
    The specified file does not exist.

EDIT:
    The edit environment is entered.  You may issue any valid EDIT subcommand
    or macro request.

INPUT:
    The input environment is entered by issuing the EDIT subcommands REPLACE or
    INPUT with no operands.  All subsequent input lines are accepted as input
    to the file.