bstr_actor_suspend(3) — Subroutines

Name

bstr_actor_suspend − Posts a breakpoint for an Actor (VODB only).

Syntax

bstr_t_status   bstr_actor_suspend (
                                 bstr_t_reference ∗actor,
                                 bstr_t_string    break_point,
                                 bstr_t_rcb       ∗control);

Description

The bstr_actor_suspend procedure is only significant for USER Activities.

The bstr_actor_suspend procedure simply inserts the specified breakpoint into the list, pointed to by the set_break_point attribute, and immediately returns control to the application.

Arguments

actor
access: read
The reference to the Actor to be suspended at break_point.

break_point
access: read
The name of the breakpoint at which the actor is to be suspended.

control
access: read
The address of an optional request control block.

Return Values

BSTR_S_ABORTED	Operation aborted
BSTR_S_BAD_PARAMETER	Bad parameter value
BSTR_S_BAD_REFERENCE	Bad reference
BSTR_S_COMMUNICATION_ERROR	Communication error
BSTR_S_INTERNAL_ERROR	Internal error
BSTR_S_INTR	Operation interrupted
BSTR_S_INVALID_NAME	Invalid name
BSTR_S_INVALID_RCB	Invalid Request Control Block
BSTR_S_INVALID_USAGE	Invalid reference usage
BSTR_S_NORMAL	Normal successful completion
BSTR_S_NOT_INITIALIZED	BASEstar Open not initialized
BSTR_S_NO_MEMORY	Insufficient virtual memory
BSTR_S_REFERENCE_IN_USE	Reference already in use
BSTR_S_SERVER_NOT_REACHABLE	Server not reachable
BSTR_S_TIMEOUT	Timeout expired
BSTR_S_TOO_MANY_REQUESTS	Too many pending requests