A

adding elements,  8-13

agent

directly access managed object,  10-3

indirectly access managed object,  10-3

manager-agent model,  1-1 , 10-1

process that accesses the managed object,  1-1 , 10-1

process that collects data,  1-1 , 10-1

agent error messages

writing an agent,  12-16

agent identification,  9-2

agent initialization

writing an agent,  12-3

agent reporting

permanent RPC number,  12-4

retries,  12-4

transient RPC number,  12-4

agent schema,  9-1

agent description syntax,  11-4

defining a group,  11-8

defining a table,  11-8

defining an agent,  11-5

defining an agent error,  11-11

defining an enumeration,  11-7

mapping feature,  11-15

parsing,  9-2

agent shutdown

signals,  12-4

undeliverable report,  12-4

writing an agent,  12-3

agent startup

writing an agent,  12-3

agentErrors schema record,  6-1

API_examples

location of,  1-4

architecture overview,  10-1

asynchronous reports,  12-17

attribute values

setting,  12-11

attributes returned by SNMP proxy,  3-4

B

blocking RPCs,  9-4

C

cluster record,  8-2

cluster record buffer,  8-1

code sample location (manager),  1-4

community string specification,  4-2 , 5-2

D

data reports

getting,  3-2

registering,  2-2

data structures,  8-1

database

adding elements,  8-13

deleting an element,  8-15

directory,  8-5

file,  8-5

keyword,  8-5

modifying an element,  8-16

retrieving information,  8-6

deleting an element,  8-15

dispatching RPC calls,  9-3

dot notation,  3-4

E

errors,  8-2

error number,  8-4

handling,  8-4

snm_error variable,  8-4

event dispatcher,  2-3

event reports

getting,  3-3

registering,  2-3

example manager code

location of,  1-4

G

getting data reports,  3-2

getting event reports,  3-3

getting events

event priority,  3-3

relational operator,  3-3

threshold,  3-3

getting reports

sample code,  3-5

summary,  3-5

getting trap reports,  3-4

H

handling errors,  6-1

agent-specific errors,  6-1

generic errors,  6-2

internationalization,  6-1

sample code,  6-2

header file,  8-1

I

Introduction

example application,  1-3

functional areas,  1-3

manager-agent communication,  1-3

L

libraries,  8-2 , 8-3 , 13-2 , 13-3

manager/agent services API,  1-1 , 10-2

linking program,  8-2 , 8-3 , 13-2 , 13-3

locking database,  8-5

M

manager-agent model

agent,  1-1 , 10-1

message information,  3-2

modifying an element,  8-16

N

na.logger

logfile pathname,  13-7

reports logfile,  13-7

starting the logger,  13-7

SunNet Manager logger,  13-7

netmgr_start_trap,  12-17

NETMGT_DO_DEFERRED,  4-6

NETMGT_ENDOFARGS,  3-3

NETMGT_ENDOFROW,  3-3

NETMGT_FATAL,  6-1

netmgt_fetch_data(3n),  3-2

netmgt_fetch_error(3n),  6-1

netmgt_fetch_event(3n),  3-3

netmgt_kill_request(3n),  4-8

NETMGT_LAST,  3-3

NETMGT_NO_EVENTS,  3-3 , 4-5

NETMGT_OBJECT_IDENTIFIER,  3-4

netmgt_oid2string(3n),  3-4

NETMGT_OPTSTRING,  4-3

netmgt_register_callback()

description of protocol parameter,  2-2

netmgt_register_callback(3n),  2-1

netmgt_register_rendez(3n),  2-3

netmgt_request_agent_ID(3n),  9-2

netmgt_request_data(3n),  4-7

netmgt_request_events(3n),  4-7

NETMGT_RESTART,  4-6

NETMGT_RPCFAILED,  6-2

NETMGT_SEND_ONCE,  4-6

netmgt_set_argument(3n),  4-3

netmgt_set_instance(3n),  4-1

NETMGT_SET_REQUEST,  12-12

netmgt_set_threshold(3n),  4-7

netmgt_sperror(3n),  6-2

NETMGT_SUCCESS,  6-1

NETMGT_TIMEDOUT,  6-2

NETMGT_WARNING,  6-1

O

opening database,  8-5

OSI,  3-4

P

parsing agent schema,  9-2

portmapper,  2-1

protocol parameter, for netmgt_register_callback(),  2-2

proxy agent

manage objects not directly accessible,  10-3

protocol translation,  10-3

R

registering

sample code,  2-6

summary,  2-6

registering data reports,  2-2

registering event reports,  2-3

registering trap reports,  2-4

registration for data, event, trap reports,  2-1

report request handling

build report argument list,  12-10

call sleep(3V) if sampling interval is nonzero,  12-11

get optional request argument,  12-10

obtain data,  12-10

return if sampling interval is zero,  12-11

send response message to rendezvous,  12-11

request dispatching

descriptive summary,  12-6

request flags

NETMGT_DO_DEFERRED,  4-6

NETMGT_RESTART,  4-6

NETMGT_SEND_ONCE,  4-7

request handling

descriptive summary,  12-10

request identification,  4-7

request timestamp,  4-7

request verification function

count argument,  12-7

descriptive summary,  12-4

flags argument,  12-10

group argument,  12-7

key argument,  12-7

target argument,  12-7

type argument,  12-7

requesting reports

convention,  4-3

count and interval,  4-5

formulating a request,  4-1

group,  4-1

key,  4-1

optional arguments,  4-2 , 5-2

rendezvous,  4-1

request flags,  4-6

sample code,  4-9

sending the request,  4-7

setting thresholds,  4-7

stopping the request,  4-8

summary,  4-9

target,  4-1

requests

setting attribute values,  12-11

retrieving database information,  8-6

retrieving element names,  8-11

RPC calls,  9-3

S

sample manager code location,  1-4

schema serial number,  9-2

security,  9-2

sending reports

writing an agent,  12-10

set request

example,  5-4 , 12-13

results,  5-4

sending,  5-3

verification,  5-3 , 12-12

set requests,  12-11

single element information retrieval,  8-7

snm.conf

location of,  13-8

snm_cmd

passing arguments to,  11-4

snm_error,  8-4

snm_error variable,  8-4

SNM_NAME environment variable,  8-5

snmdb_add,  8-13

snmdb_delete,  8-15

snmdb_enumerate_elements,  8-11

snmdb_free_enumeration_handle,  8-11

snmdb_free_list,  8-7

snmdb_get_next_element,  8-11

snmdb_init_buffer,  8-13

snmdb_lock,  8-6

snmdb_open example,  8-5

snmdb_open function,  8-5

snmdb_read,  8-7 , 8-16

snmdb_unlock,  8-6

snmdb_update,  8-16

SNMP,  3-4

SNMP traps

registering,  2-4

svc_run(3n),  2-5

T

tables,  3-2

transient RPC,  2-1

transport mechanism

choosing for data, event, trap reports,  2-2

trap generation,  9-4

trap reports

getting,  3-4

registering,  2-4

traps,  9-4 , 12-17

type of request,  3-2

U

unlocking database,  8-5

unregistering the application

netmgt_unregister_callback(3n),  7-1

netmgt_unregister_rendez(3n),  7-1

sample code,  7-2

V

verifying set requests,  12-12

W

waiting for reports,  2-5

writing an agent

agent error messages,  12-16

agent initialization,  12-3

agent shutdown,  12-3

agent startup,  12-3

request dispatching,  12-6

request handling,  12-10

request verification,  12-4

sending reports,  12-10

Copyright 1996 Sun Microsystems, Inc., 2550 Garcia Ave., Mtn. View, CA 94043-1100 USA. All Rights Reserved