Guardian Procedure Calls Reference Manual

CPUTIMES Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Summary
The CPUTIMES procedure returns the length of time (in microseconds) that a given processor has
spent in these states since it was loaded or reloaded:
• Process busy
• Interrupt busy
• Idle
These times reflect the amount of time spent by the processor (from the last system load or reload)
in a process environment, an interrupt environment, and the idle state.
Syntax for C Programmers
#include <cextdecs(CPUTIMES)>
_cc_status CPUTIMES( [ short cpu ]
,[ short sysid ]
,[ long long *total-time ]
,[ long long *cpu-process-busy ]
,[ long long *cpu-interrupt ]
,[ long long *cpu-idle ] );
Syntax for TAL Programmers
CALL CPUTIMES ( [ cpu ] ! i
,[ sysid ] ! i
,[ total-time ] ! o
,[ cpu-process-busy ] ! o
,[ cpu-interrupt ] ! o
,[ cpu-idle ] ); ! o
• The function value returned by CPUTIMES, which indicates the condition code, can be
interpreted by the _status_lt(), _status_eq(), or _status_gt() function (defined
in the file tal.h).
Parameters
cpu
input
INT:value
specifies the processor number of a processor in the system. The default is the local processor.
sysid
input
INT:value
specifies the system number. The default is the local system.
226 Guardian Procedure Calls (C)