Guardian Procedure Calls Reference Manual

CONVERTPROCESSTIME Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Related Programming Manual
Summary
The CONVERTPROCESSTIME procedure is used to convert the quad microsecond process time
returned by the PROCESSTIME, MYPROCESSTIME, or PROCESSINFO procedure into hours,
minutes, seconds, milliseconds, and microseconds. The maximum time that this procedure can
convert is 3.7 years (the amount of time that can be represented using the output parameters).
Syntax for C Programmers
#include <cextdecs(CONVERTPROCESSTIME)>
_cc_status CONVERTPROCESSTIME ( long long process-time
,[ short _near *hours ]
,[ short _near *minutes ]
,[ short _near *seconds ]
,[ short _near *milliseconds ]
,[ short _near *microseconds ] );
• The function value returned by CONVERTPROCESSTIME, which indicates the condition code,
can be interpreted by _status_lt(), _status_eq(), or _status_gt() (defined in the
file tal.h).
Syntax for TAL Programmers
CALL CONVERTPROCESSTIME ( process-time ! i
,[ hours ] ! o
,[ minutes ] ! o
,[ seconds ] ! o
,[ milliseconds ] ! o
,[ microseconds ] ); ! o
Parameters
process-time
input
FIXED:value
specifies the time to be converted.
hours
output
INT:ref:1
is the hours portion of the value of process-time specified.
CONVERTPROCESSTIME Procedure 219