UNREGISTER Request

A subagent may unregister a previously registered sub-tree. The subagent must specify a few parameters in the UNREGISTER request:

• The sub-tree to be unregistered. This is a null terminated string in the selected character set. The sub-tree must have a trailing dot.

  For example: "1.3.6.1.2.3.4.5."

• The reason for the unregister. See DPI UNREGISTER Reason Codes for a list of valid reason codes.

Once a subagent has sent a DPI UNREGISTER packet to the agent, it should expect a DPI RESPONSE packet that informs the subagent about the result of the request. The packet ID of the RESPONSE packet should be the same as that of the REGISTER packet to which the RESPONSE packet is the response. See DPI RESPONSE Error Codes for a list of valid codes that may be expected.

A subagent should also be prepared to handle incoming DPI UNREGISTER packets from the agent. In this situation, the DPI packet will contain a reason code for the UNREGISTER. A subagent does not have to send a response to an UNREGISTER request. The agent just assumes that the subagent will handle it appropriately. The registration is removed regardless of what the subagent returns.

Related Information

Processing an UNREGISTER Request