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 RI600V4.

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.