MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 9 581
Command Definitions (MAIL-PUTJCW)
PROCINFO
6 I16A Process identification numbers (PINs) of all children of the process
specified by pin .
A variable number of PINs are returned; item must be a 16-bit signed
integer array. The first element of the array must be set by the calling
process to indicate the array size. The array size should include the array
size element (for example, for four PINs, the first entry that contains the
array size should be 5). PINs are stored into the array, one PIN per
element, starting with the second element and continuing until the array
is filled or all PINs are returned. If the array is not filled, the remaining
unused elements are padded with zeros.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are
honored as follows:
1. Complete information is returned for children of the calling process.
2. Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnum s 2 through 7, 10, and 12 only.
Process handling capability is required for any user mode call unless
the calling process is requesting information about itself.
7 I16A Process identification numbers (PINs) of all descendants below children,
grandchildren, and so on) of the process specified by pin .
A variable number of PINs are returned; item must be a 16-bit signed
integer array. The first element of the array must be set by the calling
process to indicate the array size. The array size should include the array
size element (for example, for four PINs, the first entry that contains the
array size should be 5). PINs are stored into the array, one PIN per
element, starting with the second element and continuing until the array
is filled or all PINs are returned. If the array is not filled, the remaining
unused elements are padded with zeros.
If the calling process is executing in privileged mode, requests for
information are honored for any process. Otherwise, requests are
honored as follows:
1. Complete information is returned for children of the calling process.
2. Information returned for descendants below children (grandchildren,
great-grandchildren, and so on) and processes directly above the
calling process is limited to itemnum s 2 through 7, 10, and 12 only.
Process handling capability is required for any user mode call unless
the calling process is requesting information about itself.
8 I16 Priority number in the master queue of the process specified by pin
(same as Bits (0:16) returned by GETPROCINFO intrinsic).
9 I16 State and activation information of the process specified by pin (same as
Bits (16:16) returned by GETPROCINFO intrinsic).
Table 9-2. PROCINFO Itemnum/Item Values
Itemnum Mnemonic Item Description