Guardian Procedure Calls Reference Manual

MYGMOM Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Considerations
Related Programming Manual
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The MYGMOM procedure provides a process that is a member of a batch job with the process
ID of its job ancestor (GMOM). See the NetBatch User's Guide for information on batch processing.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL MYGMOM ( process-id ); ! o
Parameter
process-id
output
INT:ref:4
is a four-word array where MYGMOM returns the process ID of the job ancestor in network
form.
Considerations
• A process may not always have a job ancestor. In that case, zeros are returned.
• The process ID returned from MYGMOM is suitable for passing directly to any file-system
procedure. (If you pad the process ID with blanks before or after the call to MYGMOM, you
can pass the process ID as a file name to any Guardian procedure.)
• If the job ancestor of the calling process is a high-PIN process, MYGMOM 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.
• If the job ancestor 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 MYGMOM fails: a Guardian
TNS process terminates with a limits exceeded trap (trap 5); an OSS or native process receives
a SIGLIMIT signal.
Related Programming Manual
For programming information about batch processing and the MYGMOM procedure, see the
NetBatch User's Guide.
MYGMOM Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure) 841