HELPLIB.HLB  —  DTM  SPAWN
   Creates a subprocess from the current Digital Test Manager session-the
   parent process.

   Format

     SPAWN  [command] [/qualifier...]

1  –  Command Qualifiers

1.1    /CARRIAGE_CONTROL

   /CARRIAGE_CONTROL
   /NOCARRIAGE_CONTROL

   Determines whether carriage control characters or line feed
   characters, or both are prefixed to the DCL-prompt string of
   the subprocess. The default is the current setting of the parent
   process.

1.2    /CLI

   /CLI[=cli]
   /NOCLI

   Specifies an alternate command language interpreter (CLI) for the
   subprocess to use. The default is the CLI the parent process uses.

   The CLI you specify must be located in SYS$SYSTEM and have the
   file type .EXE.

1.3    /INPUT

   /INPUT=file-specification

   Specifies an input file containing one or more commands for the
   spawned subprocess to execute. If you specify a command with an
   input file, the command is processed before the commands in the
   input file. The subprocess terminates when processing is complete.
   You cannot use wildcards in the file specification.

1.4    /KEYPAD

   /KEYPAD (D)
   /NOKEYPAD

   Determines whether DCL keypad symbols and the current DCL keypad
   state are copied from the parent process to the subprocess. Use
   the /NOKEYPAD qualifier if you do not want the key settings to be
   copied.

1.5    /LOGICAL_NAMES

   /LOGICAL_NAMES (D)
   /NOLOGICAL_NAMES

   Determines whether the system passes process logical names and
   logical name tables to the subprocess, except those marked CONFINE
   or those created in executive or kernel mode.

1.6    /NOTIFY

   /NOTIFY
   /NONOTIFY (D)

   Determines whether a message is sent to your terminal to notify
   you that your subprocess has been completed or aborted. You must
   specify the /NOWAIT qualifier with the /NOTIFY qualifier.

1.7    /OUTPUT

   /OUTPUT=file-specification

   Specifies the output file to which the output of the SPAWN
   operation is to be written. If you specify the /NOWAIT qualifier,
   use the /OUTPUT qualifier to specify an output other than
   SYS$OUTPUT to prevent your terminal from being used by both
   processes simultaneously. The default is to direct output to the
   current SYS$OUTPUT device.

1.8    /PROCESS

   /PROCESS=subprocess-name

   Specifies the name of the subprocess to be created. The default
   name for the subprocess is USERNAME_n (where n denotes a unique
   number).

1.9    /PROMPT

   /PROMPT[=string]

   Specifies the prompt string for the subprocess. If you specify the
   /PROMPT qualifier but do not specify a string, the default prompt
   is displayed. The default is to copy the current prompt string
   from the parent process.

1.10    /SYMBOLS

   /SYMBOLS (D)
   /NOSYMBOLS

   Determines whether the system passes DCL global and local symbols
   to the subprocess.

1.11    /WAIT

   /WAIT (D)
   /NOWAIT

   Controls whether the system waits until the subprocess is
   completed before allowing more commands to be issued by the parent
   process. The /NOWAIT qualifier enables you to enter more commands
   while the specified subprocess is running. If you specify the
   /NOWAIT qualifier, you should also specify /OUTPUT to direct
   output to a file (rather than to the screen). This prevents your
   terminal from being used by both processes simultaneously.

2  –  Example

   DTM> SPAWN MAIL

   You have 1 new message.

   MAIL>

   This example spawns the OpenVMS MAIL Utility from the Digital Test
   Manager subsystem. Enter the ATTACH command to terminate the
   MAIL session and return to the Digital Test Manager system level.
Close Help