man3mngr/ValueWait

Table of Contents

Name

ValueWait - wait for a test value to equal or exceed the database value

Description

ValueWait monitors a datapoint by polling dbman for its value once per second. The datapoint is polled for a maximum number of tries or until the datapoint has met or exceeded the test value.

This function should only be used on a database connection where no subscriptions have been posted. If a parameter has been subscribed to and a change occurs while this function is in use the resulting message from dbman will confuse operation.

rmtReqParAns(3rmt) is used to communicate with dbman.

This function is part of libmngr.

Syntax

int ValueWait(
   int DBchanAux,

   CONFLIST *CFpTST,

   double TestValue,

   int Tries

   );

Arguments

DBchanAux

The file descriptor of the dbman connection.

CFpTST

pointer to the CONFLIST entry to use to obtain the tagname of the parameter to monitor

TestValue

The value to compare the database to.

Tries

The number of times to test the state of the datapoint.

Return Value

0 is returned on success.
1 is returned on failure.

Notes

errors from rmtReqParAns(3rmt) are note checked.

See Also

libmngr(3mngr)

Manual page revision

$Id: ValueWait.3,v 1.1 2002/04/07 18:35:52 kitchen Exp $

Table of Contents