GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-54
PROCESS_HANDLE_IS_NULL_
•
If a USCODE task calls ^PROCESS_CREATE_ to create a new process when the
number of existing processes is equal to the number defined by the
MAXPROCESSES configuration parameter, a new process is not created. File-
system error 34 is returned from ^PROCESS_CREATE_.
•
If a USCODE task calls ^PROCESS_CREATE_, and the created process stops,
abends, or is lost due to a CPU failure, TSCODE receives a process deletion
system message (type -101). If sysmsgs^flag of the CONTROLFLAGS
configuration parameter is set to 1, TSCODE forwards the system message to the
USCODE task that created the process. See the Guardian Procedure Errors and
Messages Manual for the format of the D-series process deletion system message.
Maximum length of the passed message is 97 words.
PROCESS_HANDLE_IS_NULL_
This procedure determines whether the passed-in process handle is a null process
handle.
result returned value
INT:value
is the result of the operation. The value of result is one of the following:
processhandle input
INT .EXT:ref:10
is a pointer to the process handle to be tested.
PROCESS_STOP_
This procedure allows USCODE to stop a process it has created and send a process
deletion system message to the mom of the process and to any other process that is
entitled to receive the message. This procedure allows TSCODE to clean up the
GDSX internal process control block (PCB) before stopping the process. This
procedure is a waited operation.
If USCODE is unconverted, the USCODE tasks cannot call this procedure. If a task
within an unconverted application calls this procedure, file-system error 29 or 560 is
returned. Unconverted USCODE calls the Guardian STOP procedure (not a pseudo
Guardian procedure) to stop a low PIN process by passing the process ID of that
process.
result := PROCESS_HANDLE_IS_NULL_ ( processhandle ); !
i
-1 The process handle is null (each word of the ten-word buffer is equal to -1)
0 The process handle is not null