SNMP Subagent Programmer's Guide

Creating Executable Subagents
SNMP Subagent Programmer’s Guide—119728 5-3
Binding
The SET command specifies attribute values for Binder to associate with the file it
creates. In this example, three SET options are specified:
The MODE NOUPSHIFT command directs Binder to differentiate between uppercase
and lowercase characters in names. The run-time library is case-sensitive to names of
management and callback functions.
The ADD commands instruct Binder to resolve all external references among the entities
to be bound together:
The SELECT commands set parameters that control Binder during execution of the
subsequent BUILD command:
The SET HEAP command allocates 4000 bytes of run-time memory for the executable
subagent.
The BUILD command creates the executable subagent and places it in a file named
FIXEDLS.
The Binder Manual provides complete information about using the Binder utility.
When you bind the subagent with the run-time library that provides tracing support
(PEERLBTO), trace records are returned to the home terminal from which the subagent
was invoked. Example 5-1 illustrates some of the trace records generated when Hello
World is executed with tracing. The numbers that accompany the following
observations correspond to numbers in the example:
1. The subagent establishes communication with the NonStop agent.
2. MIB registration occurs. The priority is always -1. The operation value of 2 means
read-write access. Other possible values are 1 (read-only access) and 0
(deregistration).
3. When mgmt_poll() is executed for the first time, the NonStop agent acknowledges
that the registration was accepted. A rejected registration is accompanied by a
priority code of -1; an accepted registration has a priority code of 0.
4. The subagent prints its message.
SYMBOLS This option is set to ON so that Inspect symbol tables are retained in
the output file.
INSPECT This option is set to ON to identify Inspect as the debugger of
choice.
SAVEABEND This option is set to OFF so that the subagent output file is not saved
if Binder terminates abnormally.
FIXEDLSO The main subagent object code file
DIRO The auxiliary subagent object code file
PEERLIBO The run-time library without tracing
SEARCH Names the memory-model file to use.
LIST Suppresses all load map and cross-reference list printing.