Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-6
ABEND Procedure
(Superseded by PROCESS_STOP_ Procedure )
•
A network super ID
•
The process’s network process access ID
•
The process’s network process access ID group manager
•
The process’s network creator access ID
•
The process’s network creator access ID group manager
where network ID implies that the user IDs or associated process creators have
matching remote passwords.
Being local on a system means that the process has logged on by successfully
calling USER_AUTHENTICATE_ or VERIFYUSER on the system or that the
process was created by a process that had done so. A process is also considered
local if it is run from a program file that has the PROGID attribute set.
•
Rules for stopping an OSS process
The same rules apply when stopping an OSS process with the ABEND procedure
as apply for the OSS
kill() function. See the kill(2) function reference page
either online or in the
Open System Services System Calls Reference Manual.
•
Rules for stopping any process: stopmode
When one process attempts to stop another process, another item checked is the
“stopmode” of the process. Stopmode is a value associated with every process that
determines which other processes can stop the process. The stopmode, set by the
SETSTOP procedure, is defined as follows:
0 ANY other process can stop the process;
1 ONLY the process qualified by the above rules can stop the process;
2 NO other process can stop the process.
•
Returning control to the caller before the process is stopped
When
error is 0, ABEND returns control to the caller before the specified process
is actually stopped. Although the process does not execute any more user code,
you should make sure that it has terminated before you attempt to access a file
that it had open with exclusive access or before you try to create a new process
with the same name. The best way to be sure that a process has terminated is to
wait for the process deletion message.
•
Stopping a process that has the Inspect or saveabend attribute set
If the process being stopped has either the Inspect attribute or the saveabend
attribute set, and if DMON exists, ABEND returns error 0 but deletion of the
process is delayed until DMON approves it. If the saveabend attribute is set,
DMON creates a saveabend file.
•
In response to the ABEND procedure, the operating system supplies a completion
code in the system message and, for OSS processes, in the OSS process
termination status as follows: