MPE/iX Intrinsics Reference Manual (32650-90905)

584 Chapter9
Command Definitions (MAIL-PUTJCW)
PROCINFO
10 CA Program name that the process specified by pin is currently executing.
The character array for the program name must be a minimum of 28
bytes long. The name is returned in the form file.group.account ,
where file is the local file name, group is the group name, and account
is the account name of the file containing the program that the specified
process is currently executing. The name is returned left-justified with
the unused locations filled with blanks.
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.
12 Returns a null-terminated HFS-syntax absolute pathname that the
process specified by pin is currently executing.
On input, the first four bytes of the buffer are interpreted as a signed
integer specifying the maximum bufffer size in bytes. The maximum
buffer size does not include the four bytes used to represent the size.
On output, the first four bytes of the buffer represent the pathname
length excluding the null-terminator as a signed integer. The pathname
is returned in the bytes following the pathname length. Bytes beyond the
null-terminator should be considered undefined.
If the maximum buffer length is not correct on input, variables allocated
near the buffer can be overwritten, or an error occurs. If the process
name is not expressed using HFS syntax, an error is returned in the first
four bytes of the buffer.
If the calling process is executing in privilege 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
itself.
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.
13 Threads exist ? T/F
Table 9-2. PROCINFO Itemnum/Item Values
Itemnum Mnemonic Item Description