! UCL+ is a user command linkage program for use with RT-11 V5 ! and later monitors. It is upward compatible with the UCL ! program distributed with V5.1 with the following exceptions: ! ! 1. Symbol definitions are listed with the LIST (or ! LIST SYMBOLS) command; this is accomplished by ! typing "UCL" with the distributed UCL. ! ! 2. UCL+ accepts the "VMS-like" symbol definition syn- ! tax used by DEC's UCL, but it ignores it. Instead, ! the number of characters that must be typed to ! specify a command or symbol unambiguously is a ! function of context. E.g., if you have defined two ! symbols starting with "S", "SUPPER" and "SUPER", ! you must type four characters to distinguish ! between them. However, if they are "SIPPER" and ! "SUPER", only two characters are necessary. ! ! 3. UCL+ currently allows symbol names of no more than ! six characters. If you use a longer name in a ! definition, UCL+ will truncate it to six characters ! and issue a warning message to that effect. ! ! 4. Like DEC's UCL, UCL+ allows you to erase a symbol ! by giving it a null definition, but UCL+ assumes ! that you know what you are doing. I.e., UCL+ mere- ! ly issues a message notifying you that the symbol ! has been erased, whereas, UCL issues an "Are you ! sure?" prompt. ! ! ! UCL+ contains a number of extensions to the distributed UCL ! program: ! ! 1. UCL+ is optimized to minimize disk access. The ! symbol definitions are contained in internal tables ! rather than a separate data file and an ! "execute-immediate" mode is available for commands ! that are defined in terms of other UCL commands. ! ! 2. More than one symbol definition can be deleted in a ! single command line via the ERASE command. All ! current symbol definitions can be removed with ! ERASE *. ! ! 3. Provision has been made to chain to additional ! "UCL's". ! ! 4. A "run-by-name path" can be defined which extends ! the RT-11 "run-from-SY:" default. ! ! 5. You can STORE/RECALL the program settings to/from a ! separate ".UCL" file. ! ! 6. A PASS_ON command is included that allows you to ! force UCL+ to "pass-on" a given command string to ! the next program in the chain (the default mode) or ! to a program that you specify. ! ! 7. Symbol expansions can be DISPLAYed with or without ! execution. The DISPLAY command can also be used to ! output ASCII strings to the console or printer ! (handy for sneaky escape sequences). ! ! 8. Provision has been made to make the addition of ! "hard-wired" commands fairly easy. These are, typ- ! ically, commands that are too complex to define as ! symbols. Two commands of this type are included as ! examples (and because the author finds them very ! handy!): a CD command which changes the default ! device (works a lot like the CP/M CD command) and ! an RNO command which is a DCL-style command for use ! with DECUS RUNOFF version M02.4. ! ! 9. If you run it directly, UCL+ will accept lower-case ! input as well as most control characters. ! ! 10. You may, in addition to the symbol definitions, ! list other program parameters, and list output may ! be directed to devices/files other than the con- ! sole. ! ! 11. UCL+ can be employed, via the UCI_MODE command, as ! a "User Command Interpreter" (UCI). This func- ! tionality was added with UCL+ V7 to take advantage ! of the UCI linkage available in TSX+ and Share-11. ! ! 12. You may dynamically redefine the prompt string ! issued by UCL+. ! ! 13. Starting with UCL+ V07.04, a UC "pseudo-device" ! handler is provided as an option which allows UCL+ ! to "remember" the "input-spec" part of the last ! UCL+ command. This text can be retrieved, at the ! command level, by using the "^" character in place ! of the argument in a subsequent command. A UC com- ! mand is included to display handler status. ! ! ! To build the UCL+ program (assuming DK: is assigned to the UCL+ ! distribution device) type ! ! @README.1ST ! or ! type the following commands: ! LIB/MAC UCLMAC UCLMAC R MACRO UCL=UCLMAC/M,UCL.CND ^C LINK UCL DEL UCLMAC.MLB,UCL.OBJ ! ! See the UCL+ user documentation if you need to build a special ! version of the UC handler. The distribution contains "standard" ! pre-built handlers for RT-11 and TSX-Plus.