DCE for the HP e3000 (B3821-90002)
Programming with Kernel Threads
Process Management Intrinsics
Chapter 5
62
Process Management Intrinsics
Process management (threads related) features of intrinsics are listed here. For detailed
information about the intrinsics, refer to the MPE/iX Intrinsics Reference Manual
(32650-90013).
PROCINFO The PROCINFO intrinsic returns threads related information to the caller. Four item
numbers do this:
• Item#=13 (threaded task option (I32)) — returns an integer that can have one of the
following values:
0 This task was never multi-threaded during its life-span.
1 This PIN was multi-threaded at some point during its existence (for
example, it was created by the RUN command or CREATEPROCESS
intrinsic and has executed at least one PTHREAD intrinsic.
2 The task is currently multi-threaded.
The user must have PM capability.
• Item#=14 (thread type option (I32)) — returns an integer that can have the following
values:
0 This PIN was never multi-threaded.
1 The PIN passed is that of the initial thread (for example, a process
created by the RUN command or CREATEPROCESS intrinsic that
has executed at least one PTHREAD intrinsic).
2 The PIN passed is that of a secondary thread of the task.
The user must have PM capability.
• Item#=15 (number of threads option (I32)) — returns an integer that can have the
following values:
0 This PIN was never multi-threaded during its life-span.
1 This PIN was multi-threaded at some point during its existence (for
example, it was created by the RUN command or CREATEPROCESS
intrinsic and has executed at least one PTHREAD intrinsic.
n This PIN is part of a threaded task and n is the number of threads
currently associated with the task.
The user must have PM capability.
• Item#=16 (list of thread PINs option (16-bit signed integer array)) - the user must pass
in an array large enough to hold the PINs of all threads associated with the task. The
first element of the array must contain the array size; PROCINFO fills the array
starting from the second element. If the array size is not large enough, PROCINFO
fills the available space and returns an error indicating that the array size was
insufficient. The last element of the array will be a zero. The user must have PM
capability.