bstr_data_point_link(3) — Subroutines

Name

bstr_data_point_link − Links two Data_Points.

Syntax

bstr_t_status   bstr_data_point_link (
                                  bstr_t_reference    ∗data_point,
                                  bstr_t_reference    ∗producer,
                                  bstr_t_link_policy ∗link_policy,
                                  bstr_t_rcb          ∗control);

Description

The bstr_data_point_link procedure links two Data_Points, where data_point is the consumer Data_Point and producer is the producer Data_Point.

Data Services update the value of the consumer Data_Point with the value of the producer Data_Point, according to the conditions set in the bstr_t_link_policy data structure.

Arguments

data_point
access: read
The reference to the consumer Data_Point.

producer
access: read
The reference to the producer Data_Point.

link_policy
access: read
The address of a bstr_t_link_policy data structure that specifies the update and access policy for the link. The values specified in the structure are set in the corresponding producer Data_Point attributes.

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_COM_PC_SIZE_MISMATCH	Number of bytes requested does not match the number of bytes returned
BSTR_S_DEVICE_SERVICES_NOT_AVAILABLE	Device Services are not available
BSTR_S_FINISH	Request aborted by bstr_finish
BSTR_S_INTERNAL_ERROR	Internal error
BSTR_S_INTR	Operation interrupted
BSTR_S_INVALID_OBJECT	Invalid link
BSTR_S_INVALID_OPERATION	Invalid operation
BSTR_S_INVALID_RCB	Invalid Request Control Block
BSTR_S_INVALID_USAGE	Invalid reference usage
BSTR_S_NORMAL	Normal successful completion
BSTR_S_NO_MEMORY	Insufficient virtual memory
BSTR_S_SERVER_NOT_REACHABLE	Server not reachable
BSTR_S_TIMEOUT	Timeout expired
BSTR_S_TOO_MANY_REQUESTS	Too many pending requests