TTIMER

TTIMER

Test or Cancel a Timer Interval

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTIONS
RELATED FUNCTIONS

SYNOPSIS

#include <spetask.h>

int TTIMER(cancel, unit, void *area);

DESCRIPTION

The TTIMER macro implements the functionality of the OS/390 Assembler TTIMER macro. This macro is supported only with the Systems Programming Environment (SPE).

The cancel argument indicates whether the timer interval is to be cancelled or merely tested and must be either CANCEL or NOCANCEL . The unit argument specifies the units in which remaining time should be stored and must be either TU or MIC . The addr argument addresses an area where the remaining time should be stored. The size of this area is determined by the unit specification, as described in the IBM publication Application Development Reference: Services for Assembler Language Programs.

RETURN VALUE

TTIMER returns the value that is returned in register 15 by the assembler TTIMER macro.

CAUTIONS

Use of the TTIMER macro in code that uses the full run-time library interferes with library timer handling.

Similar functionality to TTIMER can be obtained with the full library using the functions alarm , sleep , or clock .

RELATED FUNCTIONS

STIMER , STIMERM , alarm , clock , sleep

Chapter Contents
Previous
Next
Top of Page