at_createproc - Creates a subprocess

SYNOPSIS

at_createproc image proc

ARGUMENTS

image
Any VMS executable with full path specification
proc
Tk procedure to be executed on received output from the created subprocess.

DESCRIPTION

This command creates a new subprocess and executes the specified image. When created, ATwish associates with it an identifier which triggers an event flag whenever the subprocess writes a record to standard output. When this event flag is set, ATwish will execute the procedure proc.

image should be a VMS executable, sepcified with the full file path. It is possible to run a DCL shell, by specifying SYS$SYSTEM:LOGINOUT.EXE.

proc expects three (3) arguments, namely the proc_id (process idenitifer), the "alive" flag and a string containing the returned output from the subprocess. The alive flag is 1 if the process is alive and 0 if it does not exist. Output is passed line at a time, so proc should be written with this in mind.

at_createproc returns the identifier of the subprocess created. This identifier may be used by other ATwish commands when referencing the subprocess (e.g. at_send).

Multiple subprocesses may be invoked, with each one reqiring a separate at_createproc command. Each subprocess may have its own parsing proc or may share a common one. Each subprocess used up a single event flag on the 0-31 local event flag pool. Other events will tap into this event flag pool as well (e.g. VMS, PGplot drivers, timer events etc.).

KEYWORDS

ATwish, image, proc, subprocess


Derek McKay (dmckay)