tk_del_res

Delete Resource Group

[C Language Interface]

ER ercd = tk_del_res ( ID resid ) ;

[Parameters]

ID resid Resource ID

[Return Parameters]

ER ercd Error code

[Error Codes]

E_OK Normal completion

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

E_NOEXS Object does not exist (the resource specified in resid does not exist)

[Description]

Deletes the resource control blocks of the resource group specified in resid, and releases the resource

ID.

The resource control blocks of all subsystems are deleted.

[Additional Notes]

Resources are deleted even if there are still tasks belonging to a resource to be deleted. In principle, resource deletion must be performed after exit and deletion of all tasks belonging to the resources. The behavior is not guaranteed if a resource is deleted while a task belonging to that resource remains and is calling a subsystem (extended SVC). Likewise, the behavior is not guaranteed if a task belonging to a deleted resource calls a subsystem (extended SVC).

The timing for actual resource control block deletion is implementation-dependent. (See tk_cre_res.)

The system resource group cannot be deleted (error code E_ID is returned).

Comments