IF YOU ARE GOING TO USE THIS VERSION OF UCL+ UNDER THE
RT-11 V5.1 MONITOR (OR EQUIVALENT RTEM-11 MONITOR), YOU
MUST APPLY THE PATCH IN THE SECTION OF THE DOCUMENTA-
TION TITLED "PATCHING UCL+ FOR RT-11 V5.1" FOR UCL+ TO
WORK PROPERLY (IT'S NOT MY FAULT -- IT'S DEC'S FAULT).
V07.54 OR EARLIER UCL+ USERS
THE "CD" AND "RNO" COMMANDS ARE NO LONGER INCLUDED IN
THE DISTRIBUTED UCL+ PROGRAM. "CD" CAN NOW BE DEFINED
AS A SYMBOL, AS CAN A BASE-LINE "RNO" COMMAND. SEE THE
APPLICATION NOTES FOR DETAILS. THE STANDARD,
HARD-WIRED "RNO" COMMAND IS ALSO AVAILABLE AS A CONDI-
TIONAL ASSEMBLY.
RT-11 V5.4C/TSX-PLUS V6.3 OR LATER USERS
SOME VERSIONS OF THE SINGLE-LINE EDITOR IMPLEMENT A
"RECALL" COMMAND AS A SET OPTION. IF THIS FUNC-
TIONALITY IS ENABLED, IT PREEMPTS THE UCL+ RECALL COM-
MAND. SEE THE APPLICATION NOTES FOR A DISCUSSION OF
HOW TO WORK AROUND THIS PROBLEM.
V07.57 OR EARLIER UCL+ USERS
THE "NOSL" AND "SLON" COMMANDS HAVE BEEN ELIMINATED.
IF NEEDED, YOU CAN ENTER AN ESCAPE CHARACTER BY
SPECIFYING ITS OCTAL OR DECIMAL CODE ("<33>" OR
"<27.>")
Your first step should be to print the documentation. It is con-
tained in the file UCL.DOC and runs about 100 pages.
The major components of this kit are:
o UCL.SAV - the "vanilla" UCL+ program
o UCLXD.SAV - an "external data" (XD) variant of UCL.SAV
UCL+ "Read Me First" Page 2
o UCLXM.SAV - a special extended memory version of UCL+
(RT-11 V5.2 or later only)
o UCLHLP.TXT - the help text necessary to build a UCL+
help program
o CI.SYS - the Command Line Interpreter handler (RT-11
V5.2 or later only)
Installation instructions for the various UCL+ components are in-
cluded in the documentation.
UCL+ supports RT-11 monitors starting with V5.0 and TSX-Plus
starting with V4.1. It also runs under the RT-11 emulator (RTEM)
on RSX-11 and VMS systems. It will support, without modifica-
tion, the following command interpretation facilities:
o UCL (User Command Linkage) for RT-11 and TSX-Plus
o UCF (User Commands First) for RT-11
o UCI (User Command Interpreter) for TSX-Plus
NEW FEATURES
UCL+ V08.xx introduces several enhancements over earlier releases
of UCL+. These include:
o An "external data" (XD) version of UCL+. This variant,
which can be produced by patching a single location in
the standard UCL+ program, keeps its context area in a
separate data file. It is provided primarily for RTEM
and TSX-Plus environments requiring a single, central
program image that maintains separate symbol definition
sets for each individual user.
o Elimination of "UCX" files. The standard and XM vari-
ants of UCL+ will now RECALL each other's context files.
Both XM and non-XM context files are now produced with
the default extension "UCL." V08.xx versions of UCL+ can
RECALL V07.xx UCL and UCX files also. The external con-
text file maintained by the XD version of UCL+
(UCLPLS.DAT) can be RECALLed as well.
o The XM version of UCL+ works properly with V6.3 and
later releases of TSX-Plus.
o You may "nest" sub-string defaults. One argument
sub-string may serve as the default for another.
UCL+ "Read Me First" Page 3
UCL+ V07.57 contained only minor differences from V07.56. The
principal changes involve the addition of some messages that add
more explicit operator feedback to the [NO]CHAIN and [NO]PATH
commands. The output format for LIST CHAIN and LIST PATH was
also modified slightly.
UCL+ V7.56 differed from the previous release (V7.55b) in two
respects: A /INDIVIDUAL switch and a SUMMARY argument were added
to the LIST command.
LIST/INDIVIDUAL allows you to display a subset of the symbol de-
finitions in much the same way as the RT-11 DIRECTORY command.
For example, "LIST/I B*" lists all symbols whose name begins with
"B" and "LIST/I T%%%%" lists all five-character symbols beginning
with "T."
LIST/INDIVIDUAL does not display the "Current symbols:" header or
the summary text issued by LIST SYMBOLS. This is not a bug; it
is a deliberate feature. The intent is to allow you to employ
the /OUT switch to create subset journal files. For example,
LIST/I/OUT:MYSYMS.UCJ *
would create a legitimate UCL+ journal file containing only the
current symbol definitions.
LIST SUMMARY displays information on the number of symbols cur-
rently defined and the number of entries remaining for the de-
finition of new symbols.
William K. Walker
RDB/Alpha Systems
P. O. Box 149
Alpha, OH 45301-0149
(513) 426-0344/7094
rdbalpha@mcimail.com