sta_cyc

ista_cyc

Outline

Start cyclic handler operation.

C format

 ER      sta_cyc (ID cycid);
 ER      ista_cyc (ID cycid);
Parameter(s)

I/O

Parameter

Description

I

 ID      cycid;
ID number of the cyclic handler.



Explanation

This service call moves the cyclic handler specified by parameter cycid from the non-operational state (STP state) to operational state (STA state).

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

The relative interval from when either of this service call is issued until the first activation request is issued varies depending on whether the TA_PHS attribute is specified for the target cyclic handler at creation. For details, refer to "10.6.5 Start cyclic handler operation".

- When the TA_PHS attribute is specified
The target cyclic handler activation timing is set up based on the activation phases and activation cycle.
If the target cyclic handler has already been in operational state, however, no processing is performed even if this service call is issued, but it is not handled as an error.



- When the TA_PHS attribute is not specified
The target cyclic handler activation timing is set up according to the activation cycle on the basis of the call time of this service call.
This setting is performed regardless of the operating status of the target cyclic handler.



Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_ID

-18

Invalid ID number.

- cycid < 0

- cycid > VTMAX_CYH

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_cyc is issued from task or the sta_cyc 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 cyclic handler specified by cycid does not exist.