.MACRO CHAIN CHAIN Sets up UCL+ exit chaining SYNTAX [NO]CHAIN [program-name] SEMANTICS The CHAIN command allows you to specify a program for UCL+ to chain to if it is unable to interpret a given command. The original com- mand string is passed to the specified program in the same form and fashion that the string was originally given to UCL+. NOCHAIN dis- ables chaining; a subsequent CHAIN command with no argument re- stores it. OPTIONS None EXAMPLES CHAIN SY:BADWRD.SAV NOCHAIN CHAIN INSULT CHAIN UCL.DEC .ENDM .MACRO DISPLAY DISPLAY Displays a string or UCL+ command/symbol expansion SYNTAX DISPLAY[/options] command-string or DISPLAY[/options] "string["] SEMANTICS The DISPLAY command outputs the expansion of the specified UCL+ command or symbol or, if you enclose the argument with quotation marks, the indicated string is simply output "as-is", followed by a carriage-return/line-feed. If the trailing quote is omitted, no carriage control is appended (this is the preferred method for sending escape sequences to a device). OPTIONS EXECUTE Prints the expanded command and then executes it (not valid if DISPLAYing a string) FORM0 Enables formfeed before first output page to printer (default; has no effect if "SET LP FORM0" command not in effect) NOEXECUTE Suppresses command execution (default) NOFORM0 Suppresses first page formfeed action to printer PRINTER Causes output to be sent to the printer (device LP:) OUTPUT:file-spec Directs output to the specified device/file TERMINAL Directs output to the console (default) EXAMPLES DISPLAY WORD4 BELL==_display/printer/noform0 "^G DISPLAY "HI THERE..." .ENDM .MACRO ERASE ERASE Deletes one or more UCL+ symbols SYNTAX ERASE[/options] symbol[,...,symbol] SEMANTICS The ERASE command allows you to delete a symbol or symbols that have been previously defined via UCL+. If you specify the entire symbol name, it is deleted with no verification prompt. If you only type enough of the name to be unambiguous, you will get an "Are you sure?" prompt. Typing "ERASE *" erases all of the sym- bols. OPTIONS NOQUERY Causes the verification prompt to be omitted QUERY Forces verification for every deletion (default if /ALL used) EXAMPLES ERASE TEST ERASE * ERASE/NOQUERY REB,NASTY,IBM .ENDM .MACRO HELP HELP User Command Linkage-plus program (UCL+ V08.02a) SYNTAX command or symbol-definition or UCL command or symbol-definition or UCL UCL> command or symbol-definition SEMANTICS The UCL+ program allows on-line creation of user-defined commands (or "symbols"). It also implements a number of useful "hard-wired" commands. Symbols are defined using the format: symbol==definition (See the UCL+ documentation and the RT-11 Software Support Manual for usage and operational details.) COMMANDS (hard-wired; type "HELP command" for more details) CHAIN/NOCHAIN Sets up CHAINing to an additional "UCL" DISPLAY Displays a string or command expansion ERASE Deletes a symbol or symbols LIST Lists symbol definitions and various UCL+ parameters PASS_ON Targets a command to a specific "UCL" PATH/NOPATH Sets up the "run-by-name" path PROMPT Sets the UCL+ command-line prompt string RECALL Loads a previously STOREd set of symbol definitions and parameters RELOAD (XM version only) Reloads a UCL+ global region STORE Saves the current UCL+ symbol definitions and program parameters UCI_MODE/NOUCI_MODE (TSX-Plus only) Causes UCL+ to pass unrecognized lines to the keyboard monitor EXAMPLES LIST COMMANDS REBOOT==BOOT SY: STORE MYDEFS .ENDM .MACRO LIST LIST Lists the current UCL+ commands/symbols/status SYNTAX LIST[/options] [arguments] or LIST/INDIVIDUAL [symbol-specs] SEMANTICS The UCL+ LIST command lists the program version, "hard-wired" com- mands, currently defined symbols, CHAIN assignment/status, UC handler status, and run-by-name path to a specified device or file. If you type a LIST command with no arguments, the symbols are listed. If you omit the output specification, output is directed to the console. The /INDIVIDUAL switch allows you to list a single symbol defini- tion or a specific subset of the symbol definitions. Wildcard characters ("*" and "%") can be used to specify the symbols to be listed. Wildcards work in much the same way that they do in the RT-11 DIRECTORY command. E.g., the argument "A*" specifies all symbols whose name begins with "A"; "A%" asks for all two-character names beginning with "A". OPTIONS FORM0 Enables formfeed before first output page to printer (default; has no effect if "SET LP FORM0" command not in effect) INDIVIDUAL Allows the listing of a single symbol or a subset of the symbol definitions; wildcards can be used in the symbol specification NOFORM0 Suppresses first page formfeed action to printer OUTPUT:filespec Sends output to the specified device/file PRINTER Sends output to the printer (device LP:) TERMINAL Sends output to the console (default) ARGUMENTS ALL Lists commands, symbols, chain data, and path list (same as LIST *) CHAIN Lists the chain data COMMANDS Lists the "hard-wired" commands PATH Lists the current "run-by-name" path SUMMARY Lists the number of symbols defined and the number of entries left SYMBOLS Lists the current symbol definitions (default) VERSION Lists the program name and version EXAMPLES LIST/PRINTER ALL LIST LIST COMMANDS,SYMBOLS LIST/INDIVIDUAL B* .ENDM .MACRO PASS_ON PASS_ON Passes a command string to a program "UCL-style" SYNTAX PASS_ON[/TO:program-name] command-string SEMANTICS This command tells UCL+ to pass the specified command-string on to the program that you specified via the CHAIN command. If you in- clude a "program-name", then the command is passed to this program instead. Note that the command is passed "UCL-style". OPTIONS TO:program-name Causes the command-string to be passed to the specified program EXAMPLES PASS_ON XYZZY PASS_ON REMARK==DISPLAY "HELLO SAILOR" PASS_ON/TO:BADWRD LIST SYMBOLS .ENDM .MACRO PATH PATH Sets up the UCL+ "run-by-name" path SYNTAX [NO]PATH [device[,...,device]] SEMANTICS If UCL+ does not know a given command, it follows the device list set up with the PATH command in attempting a "run-by- name". You can establish a list of up to about 20 device mnemonics. NOPATH disables "run-by-name"; a subsequent PATH command with no argument restores it. OPTIONS None EXAMPLES PATH DK:,DY1: PATH DZ0,LD1 NOPATH .ENDM .MACRO PROMPT PROMPT Sets the UCL+ command-line prompt string SYNTAX PROMPT [["]prompt-text["]] SEMANTICS Changes the prompt string issued by UCL+ when it is run directly. The maximum length of the prompt is eight characters. The prompt- text may optionally be enclosed with quotes. A PROMPT command is- sued with no prompt-text argument restores the default prompt ("UCL> "). OPTIONS None EXAMPLES PROMPT "MYSTUF> " PROMPT PROMPT $ .ENDM .MACRO RECALL RECALL Loads symbol definition and status tables into UCL+ SYNTAX RECALL[/options] filespec SEMANTICS Recalls (loads) the UCL+ symbol definition and status area from a file that has previously been created with the STORE command. The default device for this file is DK: and the default extension is UCL. If the /JOURNAL option is used, the default extension is UCJ. OPTIONS BINARY Recall a binary format file (default) JOURNAL Recall a file created in "journal" mode NOQUIET Used with /JOURNAL to allow input lines to be echoed to the console QUIET Used with /JOURNAL to suppress output to the console (default) EXAMPLES RECALL SY:UCL RECALL/JOURNAL BADWRD .ENDM .MACRO RELOAD RELOAD Reloads a UCL+ global region (XM version only) SYNTAX RELOAD SEMANTICS The RELOAD command is valid only for the XM version of UCL+. It forces a reload of the UCL+ executable image into the applicable global region in extended memory. OPTIONS None EXAMPLES RELOAD .ENDM .MACRO STORE STORE Saves the UCL+ symbol definition and status tables SYNTAX STORE[/option] filespec SEMANTICS Causes the UCL+ program's symbol/status blocks to be written to the specified file. The default device for this file is DK: and the default extension is UCL. If the /JOURNAL option is used, the default extension is UCJ. OPTIONS BINARY Store the symbol/status data in binary form (default) JOURNAL Store the symbol/status data in "journal" format EXAMPLES STORE SY:UCL STORE/JOURNAL BADWRD .ENDM .MACRO UCI_MODE UCI_MODE Set UCL+ "pass-line-to-KMON" mode (TSX-Plus only) SYNTAX [NO]UCI_MODE [["]prompt-text["]] SEMANTICS Causes UCL+ to pass unrecognized lines to the keyboard monitor. I.e., UCL+ acts as a "User Command Interpreter" (UCI). Replacement text for the UCL+ command line prompt may be included. The default is to use/restore the normal prompt (see also the PROMPT command). NOUCI_MODE restores the previously set CHAINing mode. When UCI_MODE is in effect, hard-wired commands must be preceded by a "prefix character" (the default is a ".") to be recognized by UCL+. OPTIONS None EXAMPLES UCI_MODE "MYUCI> " UCI_MODE .NOUCI_MODE .NOUCI_MODE $ .ENDM .MACRO UCL UCL User Command Linkage-plus program (UCL+ V08.02a) SYNTAX command or symbol-definition or UCL command or symbol-definition or UCL UCL> command or symbol-definition SEMANTICS The UCL+ program allows on-line creation of user-defined commands (or "symbols"). It also implements a number of useful "hard-wired" commands. Symbols are defined using the format: symbol==definition (See the UCL+ documentation and the RT-11 Software Support Manual for usage and operational details.) COMMANDS (hard-wired; type "HELP command" for more details) CHAIN/NOCHAIN Sets up CHAINing to an additional "UCL" DISPLAY Displays a string or command expansion ERASE Deletes a symbol or symbols LIST Lists symbol definitions and various UCL+ parameters PASS_ON Targets a command to a specific "UCL" PATH/NOPATH Sets up the "run-by-name" path PROMPT Sets the UCL+ command-line prompt string RECALL Loads a previously STOREd set of symbol definitions and parameters RELOAD Reloads a UCL+ global region STORE Saves the current UCL+ symbol definitions and program parameters UCI_MODE/NOUCI_MODE Causes UCL+ to pass unrecognized lines to the keyboard monitor (TSX-Plus only) EXAMPLES LIST COMMANDS REBOOT==BOOT SY: STORE MYDEFS .ENDM .MACRO .99999 .ENDM