Retro1.org codex

FILE: EE       HELPCMD  U                    CONVERSATIONAL MONITOR SYSTEM                         PAGE 001
EE                                               (MECAFF) CMS User Area command

EE is a MECAFF-based fullscreen editor allowing to edit files with a LRECL up
to 255.

The editor EE is invoked from CMS with

+----------+------------------------------------------------------------------+
| EE       | fn  ft [ fm ]                                                    |
|          | fn.ft[.fm]                                                       |
+----------+------------------------------------------------------------------+

If the CMS file fn ft [fm] does not exists, the characteristics (RECFM, LRECL,
case handling) for the new file are taken from the FTDEFAULTS command for the
file type, as specified in one if EEs profiles (see: EE-CONFG and EE-CUST).

Subcommands to EE can be entered at the command prompt arrow with a total
command length of 120 characters.
The command and parameter keywords may be abbreviated, the minimal part of the
keywords is given in the command descriptions in uppercase.

If the text given on the input prompt is not recognized as valid command, the
input will be treated as a location target (see command Locate in: EE-EDIT) if
the first token starts with a digit or one of the characters + - . : or /


LRECL handling
--------------

Unlike other editors, when editing files with the LRECL larger as the screen
is wide (less the prefix zone), EE does not provide shift left or shift
right functionality. Instead, the lines of the file are wrapped at the screen
boundaries, each line having a single input field with full LRECL length
spanning 2 or more lines on the screen. For an easier orientation, the gap
from the end of a line input field to the next border (screen border or the
prefix zone if placed at the right) can be marked with fill chars.

As MECAFF and EE both support non-standard terminal screen sizes, it is
possible to choose the terminal according to the most used LRECL.
For example for LRECL 80 files, a terminal with 87 columns is suitable to edit
these files in a "natural" way.


Handling binary files
---------------------

If a file loaded into EE contains binary characters (codes 0x00 to 0x3F or
0xFF), these characters are replaced with a dot ('.') in the file buffer, the
file is marked as binary and EE will prevent all write operations to the
original disk file.  If necessary, this protection can be removed (see the
subcommand UNBINARY in: EE-FILES).


Editing multiple files
----------------------
FILE: EE       HELPCMD  U                    CONVERSATIONAL MONITOR SYSTEM                         PAGE 002

EE allows editing more than one file at a time. After starting EE with the
first file, more files can be opened for editing or created with the EE
subcommand or by selecting a file for editing from the FSLIST or the            
FSVIEW modes.

All files opened for editing are held in a ring, from which one file is the
currently edited. The commands RINGNext or RINGPrev (see: EE-FILES) switch
the currently edited file by stepping through the ring of files loaded.


Default PF settings
-------------------

For the fullscreen editing mode, the meaning of the PF keys can be freely
defined by assigning a command to a PF key with the command PF (see: EE-CONFG),
either in the profiles for EE (see EE-CUST) or on the EE command prompt.

EE uses the following default PF key assignments:

PF01    :   TABFORWARD
PF02    :   RINGNEXT
PF03    :   QUIT
PF04    :   SEARCHNEXT
PF06    :   SPLTJOIN
PF07    :   PGUP
PF08    :   PGDOWN
PF09    :   MOVEHERE
PF10    :   PINPUT
PF11    :   CLRCMD
PF12    :   RECALL

PF13    :   TABBACKWARD
PF16    :   REVSEARCHNEXT                                                                                               
PF19    :   PGUP 66
PF20    :   PGDOWN 66

For the input-mode and the programmers-input-mode (see: EE-EDIT), the PF key
command assignments are fixed.


Additional help for EE
----------------------

See the following help topics for further information about the EE
subcommands, grouped by their functionality focus:

EE$PREFX   prefix commands

EE$EDIT    editing and scrolling commands

EE$FILES   file control commands

EE$CONFG   configuration commands

FILE: EE       HELPCMD  U                    CONVERSATIONAL MONITOR SYSTEM                         PAGE 003
EE$CUST    customizing with the files SYSPROF EE and PROFILE EE

FSLIST     file selection mode in EE and usage of EE as fullscreen file lister

FSVIEW     usage of EE as file browser