Description

The SSAAgentIsAlive() function returns TRUE if the master agent is alive, otherwise
returns FALSE. The agent_addr parameter is the address of the agent. Specify
the security token in the community parameter. You can specify the maximum amount
of time to wait for a response with the timeout parameter.

The SSAGetTrapPort() function returns the port number used by the Master Agent
to communicate with the subagent.

The SSARegSubagent() function enables a subagent to register and unregister with
a Master Agent. The agent parameter is a pointer to an Agent
structure containing the following members:

The agent_id member is an integer value returned by the SSASubagentOpen()
function. After calling SSASubagentOpen(), you pass the agent_id in the SSARegSubagent() call
to register the subagent with the Master Agent.

The SSARegSubtable() function registers a MIB table with the Master Agent. If
this function is successful, an index number is returned, otherwise 0 is
returned. The table parameter is a pointer to a SSA_Table structure containing the
following members:

The SSARegSubtree() function registers a MIB subtree with the master agent. If
successful this function returns an index number, otherwise 0 is returned. The
subtree parameter is a pointer to a SSA_Subtree structure containing the following members:

The SSASendTrap() function instructs the Master Agent to send a trap notification,
based on the keyword passed with name. When your subagent MIB is
compiled by mibcodegen, it creates a lookup table of the trap notifications defined
in the MIB. By passing the name of the trap notification type
as name, the subagent instructs the Master Agent to construct the type
of trap defined in the MIB.

The SSASubagentOpen() function initializes communication between the subagent and the Master Agent.
You must call this function before calling SSARegSubagent() to register the
subagent with the Master Agent. The SSASubagentOpen() function returns a unique agent ID
that is passed in the SSARegSubagent() call to register the subagent. If
0 is returned as the agent ID, the attempt to initialize communication
with the Master Agent was unsuccessful. Since UDP is used to initialize
communication with the Master Agent, you may want to set the value of
num_of_retry to make multiple attempts.

The value for agent_name must be unique within the domain for which
the Master Agent is responsible.