Guardian Procedure Calls Reference Manual

Returned Value
INT
Outcome of the call:
Status for process cpu,pin is returned.0
Process cpu,pin does not exist or does not match specified criteria (see search-mode). Status for next
higher cpu,pin in the specified processor is returned. The four-word process ID of the process for which
status is being returned is returned, in the process-id parameter (if present).
1
Process cpu,pin does not exist, and no higher cpu,pin in the specified processor that matches the specified
criteria exists (see search-mode).
2
Unable to communicate with cpu.3
The system specified by sysnum could not be accessed.5
Internal error.6
Unable to process the D-series file name.7
Parameter error.99
Considerations
• Remote or local form of process-id
If sysnum specifies a remote system, process-id returns in network form; otherwise,
process-id returns 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 dollar sign ($) and the
second being an alphabetic character. The remaining four characters 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 backslash character
(\). The second byte contains the number of the node where the process resides. The third
must be an alphabetic character. The remaining three characters can be alphanumeric.
• Remote system sysnum
If sysnum specifies a remote system, file names (such as home terminal) are passed in and
returned in a form relative to the remote system. Local names (starting with $) are local to the
remote system.
• Process DEFINE context changes
Each process has an associated count of the changes to its context. This count is incremented
each time the procedures DEFINEADD, DEFINEDELETE, and DEFINEDELETEALL are invoked
and a consequent change to the process context occurs. In the case of DEFINEDELETE and
DEFINEDELETEALL, the count is incremented by one even if more than one DEFINE is deleted.
The count is also incremented if the DEFINE mode of the process is changed. If a call to
CHECKDEFINE causes a DEFINE in the backup process to be altered, deleted, or added, then
the count for the backup process is incremented. This count is 0 for newly created processes,
and new processes do not inherit the count of their creators.
• High-PIN processes
You cannot use PROCESSINFO on high-PIN processes, because a high PIN cannot fit into
cpu,pin or process-id.
Example
CALL PROCESSINFO ( PID , PROCESSID , CAID , PAID , PRI , PROG , HOMETERM , , MODE );
1152 Guardian Procedure Calls (P)