gtpi1m4v | System Installation Support Reference |
The Simple Network Management Protocol (SNMP) enterprise-specific MIB
retrieval user exit, UMIB, provides the TPF system with an interface to
retrieve enterprise-specific Management Information Base (MIB)
variables. This user exit is called when an SNMP request is received
for a MIB variable that is in a group that is not managed by the TPF
system.
Input
The UMIB user exit receives a pointer to structure snmp_struct
with the following fields:
- snmp_input_length
- An integer indicating the length of snmp_input_value.
- snmp_input_type
- An unsigned character indicating the type of protocol data unit
(PDU). The type may be one of the following:
- ISNMP_GETREQUEST
- Gets the value of the object identifier passed.
- ISNMP_GETNEXTREQUEST
- Gets the next enterprise-specific MIB variable.
- snmp_input_value
- A pointer to the object identifier of the variable requested.
Programming Considerations
- The UMIB user exit is responsible for allocating storage for
snmp_output_value.
- See the c$snmp.h header file for the format of
snmp_struct.
- The snmp_output_value can be a maximum length of
255.
Return Values
The UMIB user exit returns one of the following values:
- 0
- The enterprise-specific MIB variable is retrieved successfully and the
following fields in snmp_struct are updated:
- snmp_output_length
- An integer indicating the length of the variable and the value that is
pointed to by snmp_output_value.
- snmp_output_value
- A pointer to the encoded object identifier followed by the encoded value
of that object identifier.
- -1
- The enterprise-specific MIB variable does not exist. The SNMP
request is rejected with a NOSUCHNAME error return. This is the default
return value.
References
See TPF Transmission Control Protocol/Internet
Protocol for more information about SNMP agent support.