gtpi1m4wSystem Installation Support Reference

SNMP Manager Validation

The Simple Network Management Protocol (SNMP) request validation user exit, UCOM, validates the identity of the SNMP manager that has sent a request to the SNMP agent in the TPF system.

Input

The UCOM user exit is passed the following values:

ucom_name
A character pointer containing the community name received in the SNMP message in EBCDIC format.

ucom_len
An integer that contains the length of the community name.

ucom_sockaddr
A pointer to a sockaddr structure that contains the remote SNMP manager Internet Protocol (IP) address.

Programming Considerations

See the socket.h header file for the format of the sockaddr structure.

Return Values

The UCOM user exit returns one of the following values:

0
SNMP manager is valid. Processing continues.

4
SNMP manager is not valid. AUTHENTICATION_FAILURE trap is sent to all the managers defined in the /etc/snmp.cfg SNMP configuration file and the request is discarded.

8
SNMP manager is not valid. AUTHENTICATION_FAILURE trap is not sent and the request is discarded. This is the default.

References

See TPF Transmission Control Protocol/Internet Protocol for more information about SNMP agent support.