TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-395
#STOP Built-In Function
text
is text, 1 to 80 characters, for the process deletion message. Leading and trailing
spaces are suppressed.
Result
If you do not specify the ERROR option, the #STOP built-in function returns 0 if the
STOP system procedure cannot make a successful request to stop the process. If the
request is submitted successfully, #STOP returns -1. The designated process might or
might not be stopped, depending on the stop mode of the process and the authority of
the caller.
If you include the ERROR option, the #STOP built-in function returns the file-system
error code passed to it by the STOP system procedure. In this case, zero indicates no
error. The #STOP built-in function returns 638 or 639 if the process is queued for
stopping but has not actually stopped.
If #STOP stops the TACL process from which you issued it, #STOP returns its result
but the TACL process cannot receive it.
Considerations
•
A successful #STOP result does not indicate that the process has stopped. A
successful result indicates that the stop request was submitted successfully.
•
If the process cannot be terminated immediately, the STOP system procedure
queues the request.
•
If you omit the process designation (process name or CPU,PIN) #STOP stops the
current default process (the process last started by TACL or for which TACL most
recently paused), if it is still running. If there is no current default process, you must
include the process designation. You can examine the default process with the
#PROCESS built-in function.
•
You must supply the process designation if you wish to include the text argument.
•
COMPLETIONCODE, SUBSYS, TERMINATIONINFO, and text are ignored,
except when terminating your current TACL process (or, if it is a process pair,
either its primary or backup process). If you are stopping your TACL, those items
you specify are included in the “stop” system message.