/sys$common/syshlp/SDA.HLB  —  SPAWN
    Creates a subprocess of the process currently running SDA,
    copying the context of the current process to the subprocess and,
    optionally, executing a specified command within the subprocess.

    Format

      SPAWN  [/qualifier[,...]] [command]

1  –  Parameter

 command

    Name of the command that you want the subprocess to execute.

2  –  Qualifiers

2.1    /INPUT

       /INPUT=filespec

    Specifies an input file containing one or more command strings to
    be executed by the spawned subprocess. If you specify a command
    string with an input file, the command string is processed before
    the commands in the input file. When processing is complete, the
    subprocess is terminated.

2.2    /NOLOGICAL_NAMES

    Specifies that the logical names of the parent process are not
    to be copied to the subprocess. The default behavior is that the
    logical names of the parent process are copied to the subprocess.

2.3    /NOSYMBOLS

    Specifies that the DCL global and local symbols of the parent
    process are not to be passed to the subprocess. The default
    behavior is that these symbols are passed to the subprocess.

2.4    /NOTIFY

    Specifies that a message is to be broadcast to SYS$OUTPUT when
    the subprocess either completes processing or aborts. The default
    behavior is that such a message is not sent to SYS$OUTPUT.

2.5    /NOWAIT

    Specifies that the system is not to wait until the subprocess
    is completed before allowing more commands to be entered. This
    qualifier allows you to input new SDA commands while the spawned
    subprocess is running. If you specify /NOWAIT, use /OUTPUT to
    direct the output of the subprocess to a file to prevent more
    than one process from simultaneously using your terminal.

    The default behavior is that the system waits until the
    subprocess is completed before allowing more SDA commands to
    be entered.

2.6    /OUTPUT

       /OUTPUT=filespec

    Specifies an output file to which the results of the SPAWN
    operation are written. To prevent output from the spawned
    subprocess from being displayed while you are specifying new
    commands, specify an output other than SYS$OUTPUT whenever you
    specify /NOWAIT. If you omit the /OUTPUT qualifier, output is
    written to the current SYS$OUTPUT device.

2.7    /PROCESS

       /PROCESS=process-name

    Specifies the name of the subprocess to be created. The default
    name of the subprocess is USERNAME_n, where USERNAME is the
    user name of the parent process. The variable n represents the
    subprocess number.
Close Help