Guardian Procedure Calls Reference Manual

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
indicates the GETREMOTECRTPID failed for one of these reasons:< (CCL)
• 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.
indicates that GETREMOTECRTPID was successful.= (CCE)
does not return from GETREMOTECRTPID.> (CCG)
Considerations
You cannot use GETREMOTECRTPID for high-PIN processes because a high PIN cannot fit into
cpu,pin or process-id.
Example
CALL GETREMOTECRTPID ( PID , CRT^PID , SYS^NUM );
GETREMOTECRTPID Procedure (Superseded by PROCESS_GETPAIRINFO_ Procedure) 669