Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-23
GETREMOTECRTPID Procedure
(Superseded by PROCESS_GETINFOLIST_
process-id output
INT:ref:4
is the 4-word array where GETREMOTECRTPID returns the process ID of the
process specified by
cpu,pin. The process-id is returned as follows:
[0:2] Process name or creation timestamp
[3].<0:3> Reserved
.<4:7> processor number where the process is executing
.<8:15> PIN assigned by the operating system to identify the process
in the processor
If
sysnum specifies a remote system, the process ID is in network form; if sysnum
specifies the local system, it is in local form. The two forms differ only in the form
of the process name.
A local process name consists of six bytes with the first byte being a “$” and the
second containing an alphabetic character. The remaining four characters
(optional) can be alphanumeric. Note that a full six character local process name
cannot be converted to a remote form.
A remote process name consists of six bytes with the first byte containing a ”\” and
the second containing the network system number where the process resides.
The third must be an alphabetic character. The remaining three characters can be
alphanumeric.
sysnum input
INT:value
is a value specifying the system from which the process ID is to be returned.
Condition Code Settings
< (CCL) indicates the GETREMOTECRTPID failed for one of the following reasons:
•
No such process exists.
•
The process exists but it is terminating.
•
The remote system could not be accessed.
•
The process has an inaccessible name, consisting of more than four
characters.
= (CCE) indicates that GETREMOTECRTPID was successful.
> (CCG) does not return from GETREMOTECRTPID.