Guardian Procedure Calls Reference Manual

of the procedures superseded by PROCESS_GETINFO_, such as GETCRTPID and
GETREMOTECRTPID, which treat a terminating process as if it did not exist.
• Return value of PROCESS_GETINFO_
If the process specified in the call to PROCESS_GETINFO_ is in the starting or terminating
stage, or if its program file or libraries are being loaded by RLD, then the procedure returns
$< coldload-vol>.< coldload-subvol>.NOPROGRM as the program file name.
• Error 3 will be returned if any of the ‘buffers' to accept file names are not large enough to
hold the returned filename. The current maximum size for an NSK error-detail for return
error 2 or 3 may not be the same as the comma separated argument list and are as follows:
processhandle1
proc-fname or maxlen2
proc-fname-len3
priority4
mom's-processhandle5
hometerm or maxlen6
hometerm-len7
process-time8
creator-access-id9
process-access-id10
gmom's-processhandle11
jobid12
program-file or maxlen13
program-len14
swap-file or maxlen15
swap-len16
error-detail17
proc-type18
oss-pid19
timeout20
Mom Considerations
• Obtaining the mom (mom's-processhandle) of a named process or process pair
If the specified process is a single named process (that is, the specified process is the primary
process of a named process pair with no backup process), a null process handle (-1 in each
word ) is returned in mom's-processhandle.
If the specified process is the primary process of a named process pair and there is a backup
process, the process handle of the backup is returned in mom's-processhandle.
If the specified process is the backup process of a named process pair, the process handle of
the primary is returned in mom's-processhandle.
• The caller can always retrieve its own mom, if it has one.
1010 Guardian Procedure Calls (P)