Define Process Manual

Define Process Command
2-6 131360— Define Process Manual
Process Definition Commands
QUIET
forces future PSTART commands not to print a message when starting the
defined process. If this option is omitted, PSTART prints a starting verification
message when it is starting the process. (The message can be useful to see when
a process is being recreated after being stopped for any reason—such as an
unintentional command error.)
SHOWPROMPT
echoes that the prompt of the defined process to the terminal when a command
is issued to the process out of passthrough mode. Normally, the prompt is not
seen in this case, but there are certain programs (such as continuation prompts in
PS MAIL-TTY) in which it might be important to see the text of the prompt.
SWAP [ file-name ]
specifies the name of the file that holds the virtual data of the process. When a
process is executing, the system allocates a temporary file on the same volume
as the program file for swapping the data stack. When the process terminates,
the temporary swap file is automatically purged. However, if the swap file has a
permanent name, the swap file is not purged.
With the SWAP option, you can:
•
Specify a permanent file name—the file contains an image of the data stack
when the process terminates.
•
Specify a different volume for the swap file (by specifying only a volume
name)—useful when the program file’s volume is full or busy.
The SWAP option also specifies the default volume for extended data segments.
See the Guardian Programmer’s Guide for more details.
TERM [ \system.]$terminal-name
specifies the home terminal for the defined process. If you omit this option, the
defined process uses your TACL home terminal. For $terminal-name, specify a
valid name for a terminal or process. That is, follow the dollar sign with an
alphanumeric string of one to six characters, the first of which must be
alphabetic. For remote access, you must use five or fewer characters after the
dollar sign.
param-string
is a program parameter or a string of parameters sent to the defined process in the
startup message. Leading blanks and trailing spaces are deleted. Square brackets
and vertical bars cannot be included.
Considerations
•
To resolve the program name for the file you specify, DP uses the current setting of
your TACL #PMSEARCHLIST. This is unlike the TACL command, RUN, which
uses your current #DEFAULTS to resolve the program name for your specified file.