tk_cln_ssy

Call Startup Function of Sub-System

Call Cleanup Function of Sub-System

[C Language Interface]

ER ercd = tk_sta_ssy ( ID ssid, ID resid, INT info ) ;

ER ercd = tk_cln_ssy ( ID ssid, ID resid, INT info ) ;

[Parameters]

ID ssid Subsystem ID

ID resid Resource ID

INT info Any parameter

[Return Parameters]

ER ercd Error code

[Error Codes]

E_OK Normal completion

E_ID Invalid ID number (ssid or resid is invalid or cannot be used)

E_NOEXS Object does not exist (the subsystem specified in ssid is not defined)

E_CTX Context error (issued from task-independent portion or in dispatch disabled state)

[Description]

Calls the startup function/cleanup function of the subsystem specified in ssid.

Specifying ssid = 0 makes the system call applicable to all currently defined subsystems. In this case

the startup/cleanup functions of each subsystem are called in sequence.

tk_sta_ssy: Calls in order starting from the highest subsystem priority.

tk_cln_ssy: Calls in order starting from the lowest subsystem priority.

The order among subsystems having the same priority is not defined.

If there are dependency relationships among di.erent subsystems, the subsystem priority must therefore be set with those relationships in mind. If, for example, subsystem B uses functions in subsystem A, then the priority of subsystem A must be set higher than that of subsystem B.

Even if these system calls are issued for a subsystem with no startup function or cleanup function defined, those functions are simply not called; no error results.

If during startup/cleanup function execution a task exception is raised for the task that called tk_sta_ssy or tk_cln_ssy, the task exception is held until the startup/cleanup function completes its processing.

Comments