Guardian Procedure Calls Reference Manual

IPUAFFINITY_GET_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The IPUAFFINITY_GET_ procedure returns the current IPU number associated with a process, which
is the IPU number set via IPUAFFINITY_SET_, if that is in effect, or the current assignment by the
process scheduler otherwise. In the latter case, the IPU number may change in parallel with this
procedure call.
NOTE: This procedure can only be called only from native processes, beginning with the J06.12
RVU. It is present in H-series RVUs beginning with H06.23, but is meaningful only for J-series RVUs
when more than one IPU is present in the target CPU. (This procedure is present in the J06.11 and
H06.22 RVUs, but was not yet supported.)
Syntax for C Programmers
#include <ktdmtyp.h>
#include "$system.zguard.dipuaff.h"
int16 IPUAFFINITY_GET_ ( int16 *ProcessHandle
,uint16 *TargetIPU
,uint32 *Options );
• The header file dipuaff.h is distributed and optionally installed in the ZGUARD subvolume.
Syntax for TAL Programmers
?SOURCE $SYSTEM.ZGUARD.DIPUAFF(IPUAFFINITY_GET_)
error := IPUAFFINITY_GET_ ( ProcessHandle ! i
,TargetIPU ! o
,Options ); ! o
• The header file DIPUAFF is distributed and optionally installed in the ZGUARD subvolume.
• The IPUAFFINITY_GET_ procedure is only supported in pTAL; it is not supported in TAL.
Parameters
ProcessHandle
input
INT .EXT:ref:10
points to the process handle of the target process. Error 14 is returned if the specified process
has stopped, is in an invalid or down CPU, or is otherwise non-existent or invalid.
740 Guardian Procedure Calls (H-K)