HELP DCL_COMPILE                                R.Evans August 1983
                                       Updated A.Sloman August 1986

This help file describes a collection of procedures which allow easy
access to DCL from inside a VED window. DCL commands may be typed into
the window, and the command on the current line will be obeyed whenever
<RETURN> is pressed. Any output will be spliced into the current file,
and may therefore be saved on disk, edited, copied to another file,
etc. Previous commands may be repeated by simply placing the cursor
on the appropriate line and pressing <RETURN>.

Interactive programs that attempt to deal directly with the terminal
may not work satisfactorily.

The facility is invoked from VED simply by giving the command
    <ENTER> imdcl
('IMmediate Mode DCL')

The various sub-routines used are available to users, and are defined
below. The source files may be examined using * SHOWLIB.

dcl_compile   dcl_compile is a 'compiler' for dcl commands, compatible with
              the other compilers in the system (COMPILE,PROLOG_COMPILE etc).
              Given a character repeater, it passes commands, delimited by
              LF and optionally starting with a $, to a subprocess running
              DCL top-level (note: in BATCH mode). All output is collected up
              and printed. The subprocess is created if necessary, but it is
              NOT killed when dcl_compile exits.

dcl_send      Utility used by dcl_compile, but may be useful. dcl_send takes
              a string and passes it to the dcl subprocess (creating it if
              necessary). Any output is printed. Thus its function is similar
              to SYSOBEY, except that the process is NOT killed - so
              subsequent calls access the same process. If the argument to
              dcl_send is FALSE, the subprocess is killed.

ved_dclfile   create a file TEMP.DCL with POPCOMPILER set to DCL_COMPILE - so
              CTRL D, LMR etc send the marked range to the dcl subprocess.
              (Note TEMP.DCL is not writeable)

ved_imdcl     like ved_dclfile, but also go into IM (Input Mode) in TEMP.DCL
              to give a 'dcl top level' inside VED

ved_killdcl   Kill the current dcl subprocess.
