1 ICE
ICE is a command line editor for the VAX family of  computers  running  the
VMS  operating  system.   It  aids  the  interactive  user  in entering DCL
commands to the operating system.  With ICE you can:


      o  Recall up to 22 previously issued DCL command lines
      o  Edit any recalled DCL command line
      o  Edit command text prior to submission to VMS
      o  Submit edited DCL commands back to VMS


ICE will work on any VT100 or compatible terminal.
2 Commands
The following commands are used in ICE for either:


      o  DCL Command Retrieval
      o  Command Editing (of retrieved DCL commands)
      o  On-Line Help
      o  STOPing or EXITing from ICE

(Commands enclosed in <> refer to KEYPAD keys, except for  <DEL>  and  <LF>
which are on the main keyboard.)


        Command         Function
        -------         --------
                        [COMMAND RETRIEVAL]
        <PF1>   -       retrieve last DCL command or return to prompt
        <UP>    -       retrieve next DCL command (forward)
        <DOWN>  -       retrieve next DCL command (backward)
        <PF3>   -       display all saved DCL commands
                        [COMMAND EDITING]
        <LEFT>  -       move cursor one character to the left
        <RIGHT> -       move cursor one character to the right
        <1>     -       move cursor one word to the right
        <DEL>   -       delete character to left of cursor
        <,>     -       delete character over cursor
        <LF>    -       delete word to left of cursor
        <->     -       delete word to right of cursor
        <2>     -       delete from cursor to end of line
        CTRL/U  -       delete entire command line
        CTRL/R  -       re-write current command line
                        [MISCELLANEOUS]>
        <PF4>   -       enter EDIT mode with current command text
        <PF2>   -       display this HELP text
        STOP    -       Stop ICE and return to DCL
        EXIT    -       Same as STOP (but preserve commands)
2 Example
The example session below illustrates the type of thing you  can  do  using
ICE:


        Command Line            Comment                 User Action
        ------------            -------                 -----------
$ Type DRA1:[JONES]login.cm     (User wants to type     Press RETURN
                                a file)
%TYPE-W-OPENIN, file not found  (User gets an error)    Press <PF1>
                                                        to retrieve
                                                        the command.
$ Type DRA1:[JONES]login.cm     (Command is recalled)   Command can
                                                        now be edited..
                                                        Press <DEL> to
$ Type DRA1:[JONES]login.c      (The "m" was deleted)   delete the bad
                                                        character.
$ Type DRA1:[JONES]login.com    (Correct characters     Now add the "om"
                                are now added)          characters and
                                                        press <RETURN>
$ (The contents of login.com                            to re-submit the
  are now typed....)                                    command to DCL.
$                               (User wants to see      Press <PF3>
                                the saved commands)
(screen cleared)
Saved DCL Commands                                              |I|c|e|
  Type DRA1:[JONES]login.com    (Saved commands are displayed.  The CURRENT
  directory/full                command position on the "STACK" is shown in
  systat                        REVERSE VIDEO, i.e. that command that will
                                be recalled with the <PF1> key.)
                                The user can move up and down the stack
                                with <UP> or <DOWN> to select other
                                previously issued DCL commands for editing
                                or re-submittal. 


The above was a SIMPLE example of an ICE recall and edit session.

Note that there are SEVERAL powerful editing commands that allow you to:

      o  MOVE the CURSOR to any position on the recalled command line
         (in either direction)
      o  DELETE CHARACTERS and WORDS in either the FORWARD or BACKWARD
         direction
      o  DELETE from the cursor to the END of the command LINE
      o  DELETE the ENTIRE command LINE
      o  RE-TYPE a command line if it becomes garbled (due to line noise,
         etc.)


The KEYPAD <PF2> key can be used to display the VT100 keypad as used
by ICE.

[ An ICE users guide can be found in USR:ICEUSER.GDE  ]
[ ICE release notes can be found in USR:ICEBEWARE.BWR ]
2 Utilities
DeICE is an ICE utility that will disassemble an ICE command file from
its internal format and create a DCL command procedure containing all
the commands saved by ICE.

Format:

        DEICE input_file output_file

"input_file" is the name of the ICE commands file ('PID'.ICE).

"output_file" is the name of the DCL command procedure file (file.COM).

DEICE will prompt for either or both arguments, if missing from the command
line.

Note that the logical name for the CURRENT ICE commands file (ICE_BOX)  can
be  used as the "input_file" specifier to conveniently create a DCL command
file containing the current DCL commands saved by ICE.  This is the DEFAULT
used if the response to the "Input File:  " prompt is <RETURN>.
