z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


snmpSendRequest result

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

  • SNMP_MGR_RC_OK if successful
  • SNMP_MGR_RC_NULL_PTR if this function's snmpSession, pdu, or decodedResponse parameter value is NULL
  • SNMP_MGR_RC_TIMEOUT if there is a timeout while waiting for a response from the target agent
  • SNMP_MGR_RC_IO_ERROR if there is an error while waiting for a response from the target agent that is not the result of a timeout
  • SNMP_MGR_RC_INVALID_PARAMETERS if the waitInterval parameter value is less than 0 or if the receiveOnly parameter value is not 0 or 1
  • SNMP_MGR_RC_ENCODE_ERROR if an error was encountered while encoding a PDU. If your SNMP manager sends an SNMPv3 request to a target agent without the agent's engineID value, this function handles the receipt of the agent's report PDU. In doing so, a new request PDU is built and is sent to the target agent, using the agent's engineID value.
  • SNMP_MGR_RC_INTERNAL_ERROR if an error occurred in an internal function. See your SNMP manager API log file for more information about the error, including the internal return code value. Your IBM® service representative uses this internal return code to help solve your error.
  • SNMP_MGR_RC_USM_UNKNOWN_USERNAME if the target agent responded with a report PDU, indicating that a user name that was not valid was sent in your request
  • SNMP_MGR_RC_USM_UNSUPPORTED_SECLEVEL if the target agent responded with a report PDU, indicating that a security level that was not valid was sent in your request
  • SNMP_MGR_RC_USM_WRONG_DIGEST if the target agent responded with a report PDU, indicating that the message digest (created with the authentication key you defined) is not valid
  • SNMP_MGR_RC_USM_NOT_IN_WINDOW if the target agent responded with a report PDU, indicating that your request did not fall within the target agent's accepted time range
  • SNMP_MGR_RC_USM_DECRYPTION_ERROR if the target agent responded with a report PDU, indicating that the target agent could not successfully decrypt your encrypted request
Rule: Because this function requires an SNMP session and an SNMP PDU as input parameters, your SNMP manager must call the snmpBuildSession() and snmpBuildPDU() functions before calling this function. Your SNMP manager is responsible for allocating storage for the response PDU. After you are finished using this PDU, ensure that you free its storage.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014