MPE/iX Intrinsics Reference Manual (32650-90875)

Chapter 9 579
Command Definitions (MAIL-PUTJCW)
PROCINFO
NOTE
The process aborts if the
error1
parameter address is illegal.
If an error condition is detected while processing an information request, the
index of the
itemnum
, where the offending option was located, is stored in
error2
.
3 Required parameter address (other than
error1
) out of bounds
Not used
4 Illegal array size Array size passed to PROCINFO
5 Invalid
itemnum
Index of offending
itemnum
6 Invalid PIN; no information returned -1
7 Unassigned PIN -1
8 Unpaired
itemnum,item
parameters Index of offending
itemnum,item
parameters
9 Invalid access to information -1
10 Invalid address entered for item Index of offending
itemnum,item
parameters
11 The process name cannot be represented
using the desired syntax
Index of offending
itemnum,item
parameters
Table 9-2. PROCINFO Itemnum/Item Values
Itemnum Mnemonic Item Description
1 I16 Process identification number (PIN) of calling process
2 I16 Process identification number (PIN) of the parent of the process specified
by
pin
.
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.
Table 9-1. PROCINFO Error1, Error2 Values
Error1 Description Error2