HELP SPAWN — MicroVMS 4.6
Creates a subprocess. Format SPAWN [command-string] Requires TMPMBX or PRMMBX user privilege. The SPAWN and ATTACH commands cannot be used if your terminal has an associated mailbox.
Additional information available:
Parameters
command-string A command string of less than 132 characters that is to be executed in the context of the created subprocess. When the command completes execution, the subprocess terminates and control returns to the parent process. If both a command string and the /INPUT qualifier are specified, the specified command string executes before additional commands are obtained from the /INPUT qualifier.
Qualifiers
Additional information available:
/CARRIAGE_CONTROL/CLI/INPUT/KEYPAD/LOG/LOGICAL_NAMES
/NOTIFY/OUTPUT/PROCESS/PROMPT/SYMBOLS/TABLE/WAIT
/CARRIAGE_CONTROL
/NOCARRIAGE_CONTROL Prefixes carriage return/line feed characters to the subprocess's prompt string. The default is the parent process's setting.
/CLI=cli-file-spec
/NOCLI Specifies the command language interpreter (CLI) that will be used by the subprocess. The default CLI is that defined in SYSUAF. If you specify /CLI, context is copied to the subprocess.
/INPUT=file-spec
Specifies an input file containing one or more DCL commands to be executed by the subprocess. File type defaults to COM. Once processing of the input file is complete, the subprocess is terminated. If both a command string and the /INPUT qualifier are specified, the specified command string executes before additional commands are obtained from the /INPUT qualifier. If none is specified, SYS$INPUT is assumed (in which case a SPAWN/NOWAIT is aborted if CTRL/Y is typed to abort something running in your parent process).
/KEYPAD (default)
/NOKEYPAD Copies keypad key definitions and the current keypad state from the parent process.
/LOG (default)
/NOLOG Displays the assigned subprocess name and any messages indicating transfer of control between processes.
/LOGICAL_NAMES (default)
/NOLOGICAL_NAMES Copies process logical names and logical name tables (except those explicitly marked CONFINE or created in executive or kernel mode) to the subprocess.
/NOTIFY
/NONOTIFY (default) Broadcasts a message to your terminal notifying you that your subprocess has completed or aborted. Incompatible with the /NOWAIT qualifier or the execution of SPAWN from within a non-interactive process.
/OUTPUT=file-spec
Specifies the output file to which the results of the SPAWN operation are written. (Do not specify SYS$COMMAND as a file specification with the /NOWAIT qualifier; both parent and subprocess output will be displayed simultaneously on your terminal.)
/PROCESS=subprocess-name
Specifies the name of the subprocess to be created. The default subprocess name format is: username_n.
/PROMPT[=string]
Specifies the prompt string for DCL to use in the subprocess. The default is the prompt of the parent process. The string must be enclosed in quotation marks if it contains spaces, special characters, or lowercase characters.
/SYMBOLS (default)
/NOSYMBOLS Passes global and local symbols (except $RESTART, $SEVERITY, and $STATUS) to the subprocess.
/TABLE=command=table
Specifies the name of an alternate command table to be used by the subprocess.
/WAIT (default)
/NOWAIT Requires that you wait for the subprocess to terminate before you issue another DCL command. The /NOWAIT qualifier allows you to issue new commands while the subprocess is running. (Use the /OUTPUT qualifier with the /NOWAIT qualifier to avoid displaying both parent and subprocess output on the terminal simultaneously.)