DAT_CNO_MODIFY_AGENT(3DAT)DAT_CNO_MODIFY_AGENT(3DAT)NAMEdat_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 ALSOlibdat(3LIB), attributes(5)
Jul 16, 2004 DAT_CNO_MODIFY_AGENT(3DAT)