DAT_CNO_MODIFY_AGENT(3DAT) Direct Access Transport Library Functions


NAME


dat_cno_modify_agent - modify the OS Wait Proxy Agent

SYNOPSIS


cc [ flag... ] file... -ldat [ library... ]
#include <dat/udat.h>

DAT_RETURN
dat_cno_modify_agent (
IN DAT_CNO_HANDLE cno_handle,
IN DAT_OS_WAIT_PROXY_AGENT agent
)


PARAMETERS


cno_handle
Handle for an instance of CNO


agent
Pointer to an optional OS Wait Proxy Agent to invoke
whenever CNO is invoked. DAT_OS_WAIT_PROXY_AGENT_NULL
indicates that there is no proxy agent.


DESCRIPTION


The dat_cno_modify_agent() function modifies the OS Wait Proxy Agent
associated with a CNO. If non-null, any trigger received by the CNO is
also passed to the OS Wait Proxy Agent. This is in addition to any local
delivery through the CNO. The Consumer can pass the value of
DAT_OS_WAIT_PROXY_AGENT_NULL to disassociate the current Proxy agent from
the CNO

RETURN VALUES


DAT_SUCCESS
The operation was successful.


DAT_INVALID_HANDLE
The cno_handle parameter is invalid.


DAT_INVALID_PARAMETER
One of the parameters was invalid, out of range,
or a combination of parameters was invalid, or
the agent parameter is invalid.


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+---------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+---------------------------+
|Interface Stability | Standard: uDAPL, 1.1, 1.2 |
+--------------------+---------------------------+
|MT-Level | Unsafe |
+--------------------+---------------------------+

SEE ALSO


libdat(3LIB), attributes(5)


July 16, 2004 DAT_CNO_MODIFY_AGENT(3DAT)