Guardian Procedure Calls Reference Manual

IPUAFFINITY_SET_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Examples
Summary
The IPUAFFINITY_SET_ procedure associates a process with a given IPU within its CPU. The process
scheduler does not move this process after the association has been set (without another call to
this procedure).
IPUAFFINITY_SET_ can also be used to remove such an association.
Setting the IPU affinity of a DP2 process sets each of the members of its DP2 process group to be
associated with the specified IPU.
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_SET_ ( 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_SET_)
error := IPUAFFINITY_SET_ ( ProcessHandle ! i
,TargetIPU ! i
,Options ); ! i
• The header file DIPUAFF is distributed and optionally installed in the ZGUARD subvolume.
• The IPUAFFINITY_CONTROL_ procedure is only supported in pTAL; it is not supported in TAL.
IPUAFFINITY_SET_ Procedure 743