man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: July 2014
 
 

dat_cno_modify_agent(3DAT)

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
Committed
MT-Level
Unsafe
Standard
uDAPL, 1.1, 1.2

See Also

libdat(3LIB), attributes(5)