man3rmt/rmtSetDTqueID

Table of Contents

Name

rmtSetDTqueID - remote - set DATA.Qown

Description

rmtSetDTqueID requests dbman to set DATA.Qown to the file descriptor number of the client. This makes the client the owner of the DATA record. Usually this call is made by an I/O manager task which needs to be made aware of polling status changes.

After rmtSetDTqueID() is called the I/O client receives a messages whenever another client performs an rmtAddFast() or rmtRemFast(). The request is expected to be used by the client to add or remove the datapoint from a fast polling list if the client is capable of such actions.

When the I/O client connection is closed all registrations performed by using rmtSetDTqueID() are removed.

The request is passed in remote mode.

This function is part of librmt.

Syntax

int rmtSetDTqueID(
int fo,
int RecId,
int verbosity
);

Arguments

fo

The file descriptor for the connection to dbman.

RecId

The RecId of the DATA record.

verbosity

Defines the amount of messages to print. This value is passed on to SendRec. A value of 0 produces no messages. See the SendRec manpage for full details on available values.

Return Values

ERRok is returned if the transaction is successful.
The error code from the transaction is returned if there is a communications error.

See Also

librmt(3rmt)

Manual page revision

$Id: rmtSetDTqueID.3,v 1.2 2008/08/22 16:23:09 mcnamer Exp $

Table of Contents