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(7) 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(7)

July 16, 2004 DAT_CNO_MODIFY_AGENT(3DAT)