Guardian Procedure Calls Reference Manual

For a named remote process, process-id is:
“\” (ASCII backslash).<0:7>[0]
System number.<8:15>
$process-name[1:2]
Reserved.<0:3>[3]
Processor number where the process is executing.<4:7>
PIN assigned by the operating system to identify the process in the processor.<8:15>
Considerations
• Calling MOM from a named process or process pair
If the caller is a single named process (that is, the caller is the primary process of a named
process pair with no backup process), zeros are returned in process-id.
If the caller of MOM is the primary process of a named process pair and there is a backup
process, the process ID of the backup is returned.
If the caller of MOM is the backup process of a named process pair, the process ID of the
primary is returned.
• Passing the process ID to the system procedures
The process ID returned from MOM is suitable for passing directly to any file-system procedure.
(If you expand the process ID into a 12-word array and fill it with blanks on the right before
or after the call to MOM, you can pass the process ID as a file name to any Guardian
procedure.)
• Calling MOM from an adopted process
If another process has made itself the creator of the caller of MOM (through a call to STEPMOM
or PROCESS_SETINFO_), then the process ID of the adopting process is returned.
• Network consideration
If a process' creator is on a remote system, its process ID is returned by MOM in network
form. A process can use this fact to determine whether it is created locally.
• Calling MOM from a high-PIN process
If the mom of the calling process is a high-PIN process, MOM returns a synthetic process ID.
A synthetic process ID contains a PIN value of 255 in place of a high-PIN value, which cannot
be represented by eight bits.
• Calling MOM from a remote process with a long process name
If the mom of the calling process is a named process on a remote node and has a process
name consisting of more than five characters, the call to MOM fails: a TNS Guardian process
terminates with a limits exceeded trap (trap 5); an OSS or native process receives a SIGLIMIT
signal.
OSS Considerations
By default, an OSS process does not have a mom process; therefore, zeros are returned in
process-id. An OSS process can have a mom process if it was created by one of the OSS
tdm_spawn set of functions, the tdm_fork() function, or one of the tdm_exec set of functions;
see the reference pages either online or in the Open System Services System Calls Reference
Manual for details. An OSS process does have a mom process if a mom process has been explicitly
assigned by either the PROCESS_SETINFO_ or STEPMOM procedure.
MOM Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure) 833