CREATE_PROCESS

CREATE_PROCESS creates a subprocess and defines a buffer for the output of the created subprocess. The buffer to contain the output of the created subprocess is passed as the first parameter. The optional second parameter contains the first command to be issued in the subprocess. Subsequent input to the process can be sent using the SEND or SEND_EOF functions.

Syntax:

process := CREATE_PROCESS (buffer [, string])

Example:

The following command tells nu/TPU to create a process. Output from the subprocess is appended to the current buffer. The command "ls" is sent to the subprocess. The process is assigned to the variable SHELL$PROCESS.

SHELL$PROCESS := CREATE_PROCESS (CURRENT_BUFFER, "ls");

Errors:

TPU$_CAPTIVE Can't create subprocess in a captive account.

TPU$_CREATEFAIL Can't create subprocess.

TPU$_DELETEFAIL Can't end subprocess.

TPU$_DUPBUFNAME Buffer name already exists.

TPU$_NOPROCESS Subprocess unavailable.

TPU$_NOTMODIFIABLE Buffer is READ_ONLY.

TPU$_SENDFAIL Data not sent to subprocess.

Related Built-ins: