Waits for a message from the Simple Network Management Protocol (SNMP) agent.
#include <isode/snmp/smux.h>
int smux_wait (event, isecs) struct type_SMUX_PDUs **event; int isecs;
The smux_wait subroutine waits for a period of seconds, designated by the value of the isecs parameter, and returns the protocol data unit (PDU) received. The smux_wait subroutine waits on the socket descriptor that is initialized in a smux_init subroutine and maintained in the SMUX subroutines. The smux_wait subroutine waits up to isecs seconds. If the value of the isecs parameter is 0, the smux_wait subroutine returns only the first packet received. If the value of the isecs parameter is less than 0, the smux_wait subroutine waits indefinitely for the next message or returns a message already received. If no data is received, the smux_wait subroutine returns an error message of NOTOK and sets the smux_errno variable to the inProgress value. If the smux_wait subroutine is successful, it returns the first PDU waiting to be received. If a close PDU is received, the subroutine will automatically close the TCP connection and return OK.
event | Points to a pointer of type_SMUX_PDUs. This holds the PDUs received by the smux_wait subroutine. |
isecs | Specifies an integer value equal to the number of seconds to wait for a message. |
If the subroutine is successful, the value OK is returned. Otherwise, the return value is NOTOK.
If the subroutine is unsuccessful, the smux_errno global variable is set to one of the following values:
This subroutine is part of the SNMP Application Programming Interface in the TCP/IP facility.
The smux_close subroutine, smux_error subroutine, smux_init subroutine, smux_register subroutine, smux_response subroutine, smux_simple_open subroutine, smux_trap subroutine.
List of Network Manager Programming References.
RFC1227, SNMP MUX Protocol and MIB.
SNMP Overview for Programmers in AIX Version 4.3 Communications Programming Concepts.