9.0;set, revision 9.0, 85/03/25
SET -- Set current Shell conditions.
usage: SET [ [-B[ON] | -BOFF | -NB[ON]]
[-E[ON] | -EOFF | -NE[ON]]
[-V[ON] | -VOFF | -NV[ON]]
[-X[ON] | -XOFF | -NX[ON]]
[-C[OMMAND] arg1...]
[-I[NTER] | -S[CRIPT] | -NI[NTER]]
[-N[EXECUTE | -EX[ECUTE]]
[-P[ROMPT]1 prompt_string]
[-P[ROMPT]2 prompt_string]
[-START [file] | -NSTART] ]
FORMAT
SET [options]
SET allows you to change the state of the current Shell. It accepts the same
options as the SH (SHELL) command, thus permitting you to alter current Shell
conditions without having to generate an entirely new Shell. See HELP SH for
general information about Shells.
Separate Shell commands already exist for altering a few of the current Shell
conditions (EON | EOFF; VON | VOFF; etc.). SET combines all of those
functions into a single facility.
OPTIONS
Default options are indicated by "(D)."
-B[ON] Send the output of a background process (created with the &
parsing operator) to the display. The output of the
background process is displayed in the transcript pad of
the Shell where it was invoked. If you do not specify -B,
the output of the background process is sent to /DEV/NULL.
-BOFF (D) Do not display output from a background process.
-NB[ON] (D) Same as -BOFF.
-C[OMMAND] arg1 ...
Execute the following argument(s) as a Shell command,
exactly as if it had been read as an input line. If any
argument contains explicit blanks, enclose it in quotes.
The Shell passes all text following -C to 'arg1' as
arguments, so if you want to specify other options to the
SH command itself, they must precede -C.
-E[ON] Enable evaluation of variables outside of expressions. If
-E is specified, the Shell always evaluates variables,
regardless of the context in which they appear. If -E is
not specified, variables are evaluated only inside variable
expression delimeters, ((expression)); otherwise, the Shell
treats the ^var_name expressions as strings and they are
not evaluated.
-EOFF (D) Evaluate variables only inside expressions.
-NE[ON] (D) Same as -EOFF.
-I[NTER] Behave as though input is being entered interactively:
prompt for each input line, and do not exit on errors or
quit faults (DQ or CTRL/Q from keyboard). Normally, the
Shell only executes interactively if its input comes from a
pad or sio-line. Use of this option forces prompting.
-S[CRIPT] (D) Behave as though executing a Shell script: do not prompt
and abort on error. A Shell normally will not quit; any
error or quit command is assumed to apply only to the last
command given to the Shell.
-NI[NTER] (D) Same as -S.
-N[EXECUTE] Interpret each command line only; suppress execution.
-EX[ECUTE] (D) Interpret each command line and execute it.
-P[ROMPT]1 prompt_string
Define the prompt string for the Shell created with SH.
-P[ROMPT]2 subprompt_string
Define the subpromt string for the Shell created with SH.
(The subprompt appears when you continue a Shell command
over more than one line).
-START [file] (D)
Execute the specified script after the Shell is created.
If 'pathname' is not specified, the Shell searches for a
file called ~USER_DATA/STARTUP_SH.INIT and executes it if
it exists. No error occurs if that file does not exist.
-NSTART Disable startup file execution.
-V[ON] Display each line of text in the transcript pad as it is
read by the Shell program.
-VOFF (D) Disable input verification.
-NV[ON] (D) Same as -VOFF.
-X[ON] Display each command in the transcript pad immediately
before execution. Each command is given in full, with its
complete pathname and with the values of arguments
inserted.
-XOFF (D) Disable input examination.
-NX[ON] (D) Same as -XOFF.
EXAMPLES
1. $ set -p1 'Input> ' Change the current Shell's primary
prompt to "Input> ". Note the use
of quotes to preserve the trailing
blank.
2. $ set -eon -xon -von Enable variable evaluation, command
examination, and verification.
RELATED TOPICS
More information is available. Type:
- HELP SH
for details about the Shell.