Guardian Procedure Calls Reference Manual

options
input
INT:value
specifies one or more options for the call as follows:
Reserved (specify 0).<0:12>
Return information only for running processes.0<13>
Also return information for named processes that are not started, but the process names are
reserved.
1
Resolve a partially qualified process name in pair using the caller’s =_DEFAULTS DEFINE.0<14>
Resolve a partially qualified process name in pair using the caller’s node.1
Return information only for named processes.0<15>
Also return information for I/O processes (that is, processes controlling devices or volumes). To
return information on I/O processes that are not started, also set options .<13> to 1.
1
If this parameter is omitted, 0 is used.
ancst:maxlen
input, output:input
STRING .EXT:ref:*, INT:value
if present and if maxlen is not 0, returns the process file name of the ancestor of the specified
process or process pair. The maxlen parameter specifies the length in bytes of the string
variable ancst.
ancst-length
output
INT .EXT:ref:1
if ancst is returned, contains its actual length in bytes.
error-detail
output
INT .EXT:ref:1
returns additional information about some classes of errors. See Returned Value.
Returned Value
INT
Outcome of the call:
Information is returned for a process pair (not the calling process).0
Parameter error; error-detail contains the number of the first parameter found to be in error, where 1
designates the leftmost parameter.
2
Bounds error; error-detail contains the number of the first parameter found to be in error, where 1
designates the leftmost parameter.
3
Information is returned for a single named process (can be the calling process).4
Information is returned for a process pair where the caller is the current primary.5
Information is returned for a process pair where the caller is the current backup.6
No information is returned; process is unnamed (can be the calling process).7
No information is returned; search is complete.8
Specified process does not exist.9
1048 Guardian Procedure Calls (P)