Guardian Procedure Calls Reference Manual

timeout
input
INT(32):value
if present and not greater than zero, specifies how many hundredths of a second the process
waits to get the process information; otherwise timeout defaults as follows:
• for information about a process on the local node: none (wait forever)
• for information about a process on a remote node: 60 second (see note)
The maximum value is 2147483647. This parameter is supported on systems running H06.26
and later H-series RVUs and J06.15 and later J-series RVUs and; on earlier RVUs, the default
timeout is used.
NOTE: The default behavior changed in the H06.22 and J06.11 RVUs. Previously, the
procedure waited forever on remote nodes as well as the local node. The change is also
included in the following T9050 SPRs and those that supersede them: AUR, AUS, AUT, AUU;
one of these is applicable to each of RVUs H06.15-21 and J06.04-10.
Returned Value
INT
Outcome of the call:
Information is returned for the specified process.0
File-system error; error-detail contains the error number.1
Parameter error; error-detail contains the number of the first parameter found to be in error, where 1
designates the first parameter on the left.
2
Bounds error; error-detail contains the number of the first parameter found to be in error, where 1
designates the first parameter on the left.
3
Specified process does not exist4
Unable to communicate with processor5
Unable to communicate with system6
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.
For more information about access IDs, see the Guardian User's Guide .
• 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
PROCESS_GETINFO_ Procedure 1009