Guardian Procedure Calls Reference Manual

PROCESS_GETINFOLIST_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Auxiliary Data
Iterative Attributes
Loadfile Types
Using the Loadfile Type Code Values
Attribute Codes and Value Representations
Considerations
OSS Considerations
Examples
Related Programming Manual
Summary
The PROCESS_GETINFOLIST_ procedure obtains detailed information about a specified process
or about a set of processes that meet specified criteria. You can specify processes for which
information is to be returned in one of several ways:
• You can omit the first four parameters and the oss-pid parameter to have information returned
for the calling process.
• You can specify the process handle of a particular process.
• You can specify the node name, processor, and PIN of a particular process.
• You can specify the node name and OSS process ID of a particular OSS process.
• You can specify a node name, processor, and PIN, along with a set of search criteria; the
procedure searches processes in the specified processor starting at the specified PIN. You
can specify that PROCESS_GETINFOLIST_ return information for only the first process that
meets the search criteria or for multiple processes that meet the search criteria.
The information about a process is organized as a set of attributes. The caller provides a list
specifying a code for each attribute to be reported; these are called the query attributes. The
attribute values are reported in an output list parameter. To perform a search, the caller provides
the search criteria as a list of attribute codes and a parallel list of values for those attributes. Only
a subset of the defined attributes can be used in search criteria.
The input and output parameters described as lists are implemented as arrays of 16-bit words (type
short in C/C++, type INT in TAL/pTAL). Attribute codes occupy one word. Some query attribute
codes have associated auxiliary data, which occupy (typically four) adjacent words. Each attribute
value occupies some number of words, always word (two-byte) aligned and padded if necessary
to the next word boundary. Most attributes have fixed lengths, specified for the attribute; some
have variable length
A related procedure, PROCESS_GETINFO_, provides a simple way to obtain a subset of the
available information about a specified process.
1012 Guardian Procedure Calls (P)