sta_alm

ista_alm

Outline

Start alarm handler operation.

C format

 ER      sta_alm (ID almid, RELTIM almtim);

 ER      ista_alm (ID almid, RELTIM almtim);

Parameter(s)

I/O	Parameter	Description
I	ID almid;	ID number of the alarm handler.
I	RELTIM almtim;	Activation time (unit: msec)

Explanation

This service call sets to start the alarm handler specified by parameter almid in almtim msec and moves the target alarm handler from the non-operational state (STP state) to operational state (STA state).

As a result, the target alarm handler is handled as an activation target of the RI600PX.

Note 1 When 0 is specified for almtim, the alarm handler will start at next base clock interrupt.

Note 2 This service call sets the activation time even if the target alarm handler has already been in the operational state. The previous activation time becomes invalid.

Return value

Macro	Value	Description
E_OK	0	Normal completion.
E_PAR	-17	Parameter error. - almtim > (0x7FFFFFFF - TIC_NUME) / TIC_DENO
E_ID	-18	Invalid ID number. - almid < 0 - almid > VTMAX_ALH
E_CTX	-25	Context error. - This service call was issued in the CPU locked state. - This service call was issued in the status "PSW.IPL > kernel interrupt mask level". Note When the ista_alm is issued from task or the sta_alm is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
E_NOEXS	-42	Non-existent object. - The alarm handler specified by almid does not exist.