.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 command string is passed to the specified program in
	the same form and fashion that the string was originally given
	to UCL+.  NOCHAIN disables chaining; a subsequent CHAIN command
	with no argument restores 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 SLON
	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 symbols.

  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+)

  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
	If UCL+ is run directly, lower-case letters and control-
	characters can be included in the symbol definition.  (See the
	UCL+ documentation and the 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
   NOSL
	Turns the single-line editor off
   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
   SLON
	Turns the single-line editor on
   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:
	UCI_MODE "MYKMON> "
	UCL
	UCL> bill==$@wrk:bill
	UCL> nosl
	UCL> bell==_display "^G
	UCL> ^C
.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"
	commands, 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 definition
	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	NOSL
NOSL		Turns the single-line editor off (UCL+ command)

  SYNTAX
	NOSL

  SEMANTICS
	The NOSL command can have either a "global" or "local" effect.
	If you run UCL+ directly (i.e., you have a "UCL>" prompt), the
	single-line editor is only turned off within the UCL+ program.
	This is particularly handy if you need to include characters in
	a symbol definition that would be intercepted by the single-line
	editor.  If you type the NOSL command at the monitor level, it
	is equivalent to a "SET SL OFF" command.  (See also the SLON
	command.)

  OPTIONS
	None

  EXAMPLES
	NOSL
.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
	include 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
	issued 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 (.UCX if using the special XM version of 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	SLON
SLON		Turns the single-line editor on (UCL+ command)

  SYNTAX
	SLON

  SEMANTICS
	The UCL+ SLON command is equivalent to typing "SET SL ON". (See
	also the NOSL command.)

  OPTIONS
	None

  EXAMPLES
	SLON
.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 (.UCX if using the special XM
	version of 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+)

  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
	If UCL+ is run directly, lower-case letters and control-
	characters can be included in the symbol definition.  (See the
	UCL+ documentation and the 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
   NOSL
	Turns the single-line editor off
   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
   SLON
	Turns the single-line editor on
   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:
	UCI_MODE "MYKMON> "
	UCL
	UCL> bill==$@wrk:bill
	UCL> nosl
	UCL> bell==_display "^G
	UCL> ^C
.ENDM
.MACRO	.99999
.ENDM