Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-232
PROCESSINFO Procedure
(Superseded by PROCESS_GETINFOLIST_
licenses output
INT:ref:1
licenses.<15> returns 0 if the program file of the process was not licensed at
process-creation time, and returns 1 if the program file of the process was licensed
at process-creation time.
jobid input, output
INT:ref:5
consists of the GMOM’s process ID plus the
jobid. If this field is zero, the
process does not belong to a job. If this field is nonzero, the GMOM’s process ID
identifies the ancestor of the job.
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.