Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-66
PROCESS_GETINFO_ Procedure
General Considerations
•
Process access ID (PAID) and creator access ID (CAID)
An access ID is a word associated with a given process that contains a group ID
number in the left byte and a user ID number in the right byte. Two types of
access IDs are used in the operating system.
The process access ID (PAID) is returned by PROCESS_GETINFO_ and is
normally used for security checks when a process attempts to access a disk file.
The creator access ID (CAID) is returned by PROCESS_GETINFO_ and identifies
the user who created the process. It is normally used, often with the PAID, for
security checks on interprocess operations such as stopping a process or creating
a backup for a process.
The PAID and the CAID usually differ only when a process is run from a program
file that has the PROGID attribute set. This attribute is usually set with the File
Utility Program (FUP) SECURE command and PROGID option. In such a case,
the process access ID returned by PROCESS_GETINFO_ is the same as the
program file’s owner ID.
Refer to the
Guardian User’s Guide for more information about access IDs.
•
Obtaining information about a process that is terminating
If the process specified in a call to PROCESS_GETINFO_ is in the terminating
state, the procedure still returns information about that process. This differs from
the behavior of some 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
largeenough to hold the returned filename. The current maximum size for a NSK
Error-Detail for return error 2 or 3 may not be the same as the comma
separatedargument list and are as follows:
1. processhandle
2. proc-fname or maxlen
3. proc-fname-len
4. priority
5. mom’s-processhandle