'\" te
.\" This manual page is derived from the DAT/uDAPL 1.2 specification.
.\" Portions Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved.
.TH dat_cno_modify_agent 3DAT "16 Jul 2004" "SunOS 5.11" "Direct Access Transport Library Functions"
.SH NAME
dat_cno_modify_agent \- modify the OS Wait Proxy Agent
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-ldat\fR [ \fIlibrary\fR\&.\|.\|. ] 
#include <\fBdat/udat.h\fR>

DAT_RETURN
    dat_cno_modify_agent (
    IN    DAT_CNO_HANDLE            \fIcno_handle\fR,
    IN    DAT_OS_WAIT_PROXY_AGENT   \fIagent\fR
    )
.fi

.SH PARAMETERS
.sp
.ne 2
.mk
.na
\fB\fIcno_handle\fR\fR
.ad
.RS 14n
.rt  
Handle for an instance of CNO
.RE

.sp
.ne 2
.mk
.na
\fB\fIagent\fR\fR
.ad
.RS 14n
.rt  
Pointer to an optional OS Wait Proxy Agent to invoke whenever CNO is invoked. \fBDAT_OS_WAIT_PROXY_AGENT_NULL\fR indicates that there is no proxy agent.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBdat_cno_modify_agent()\fR 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 \fBDAT_OS_WAIT_PROXY_AGENT_NULL\fR to disassociate the current Proxy agent from the CNO
.SH RETURN VALUES
.sp
.ne 2
.mk
.na
\fB\fBDAT_SUCCESS\fR\fR
.ad
.RS 25n
.rt  
The operation was successful.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDAT_INVALID_HANDLE\fR\fR
.ad
.RS 25n
.rt  
The \fIcno_handle\fR parameter is invalid.
.RE

.sp
.ne 2
.mk
.na
\fB\fBDAT_INVALID_PARAMETER\fR\fR
.ad
.RS 25n
.rt  
One of the parameters was invalid, out of range, or a combination of parameters was invalid, or the \fIagent\fR parameter is invalid.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelUnsafe
_
StandarduDAPL, 1.1, 1.2
.TE

.SH SEE ALSO
.sp
.LP
\fBlibdat\fR(3LIB), \fBattributes\fR(5)