SNMP Extension Agent (SXA)

  Der Extension Agent für TIS (SXA) hat für die Einbindung in den SNMP-Agenten unter Windows NT folgende Methoden unbedingt zur Verfügung zu stellen:

• SNMPExtensionInit()
  Diese Methode wird bei der Initialisierungsphase während des Hochfahrens des SNMP-Agenten verwendet, um die Elemente der zu verwaltenden MIB in eine Baumstruktur einzulesen. Dafür wird eine Klasse CAsnNode zur Verfügung gestellt. Diese Klasse kann sämtliche in der MIB verwendeten Strukturen verarbeiten und somit eine einheitliche Knotenstruktur ermöglichen. Der Aufbau wie auch das spätere Auffinden der MIB-Knoten erfolgt durch Bisektion über die OID der entsprechenden Knoten. Die Information über die zu managenden Knoten ist in einer Datei, welche mit tis_mib.mdf bezeichnet wird, enthalten. Ein Auszug aus solch einer MIB ist nachfolgend dargestellt:

  // Auszug aus einer tis_mib.mdf - Datei
  // Einstiegspunkt
  SEGMENT .1.3.6.1.4.1.2206.5.1.
  // Dispatcher-Festlegung
  DISPATCHER AdminTestDispatcher [127.0.0.1] 0x5005
  DISPATCHER GatewayDispatcher [127.0.0.1] 0x1003
  DISPATCHER GatekeeperDispatcher [127.0.0.1] 0x5006
  // Beginn Angabe der Knotenstruktur
  // Einfacher MIB-Knoten
  NODE RW .1.3.6.1.4.1.2206.5.1.1.1.1 AdminTestDispatcher computerName 2166784 SO
  ...
  // MIB-Tabelle
  NODE RW .1.3.6.1.4.1.2206.5.1.1.1.7.1.1 
      AdminTestDispatcher 
      dnsServerIndex 2166790 TI dnsServerTable 2166791 dnsServerIndex 2166790 II
  ...
  // Trap-Festlegung
  TRAP .1.3.6.1.4.1.2206.5.1.1.4.4 .1.3.6.1.4.1.2206.5.1.1.4.5

  Diese Datei wird nun während der Initialisierung zeilenweise eingelesen und entsprechend Zeilen mit der Kennzeichnung ``NODE'' in die lineare Knoten-Liste als CAsnNode-Objekt eingehängt. Zeileneinträge mit ``DISPATCHER''-Kennzeichnung werden an eine lineare Liste von Dispatchern angefügt. Der erste Eintrag mit ``SEGMENT''- Kennzeichnung kennzeichnet den offiziellen Einstiegspunkt der TIS-MIB.
• SNMPExtensionQuery()
  Wird über den SNMP-Agenten ein Request empfangen und dieser ist für den TIS-Extension Agent bestimmt, so wird SNMP diese Methode mit der Übergabe einer Varbind-Liste aufrufen. Innerhalb dieser Methode werden die Varbinds aus der Liste nacheinander mit einer Methode ResolveVarbind() verarbeitet.
  Diese Methode gliedert nach Request-Typen und bildet je nach Anfrage ein IPC-Message-Objekt. Dies wird durch Verwendung des BuildMsgBase()-Konstruktors erreicht, die wie in Kapitel 4 beschrieben, mit addParameter die entsprechenden Datenstrukturen der Nachricht hinzufügt. Mit dem Konstruktor BuildVarBind wird schließlich, nachdem ein intern verwalteter Cache geprüft wurde, der SNMP-Request als IPC-Message dem Empfänger zugesandt. Der Konstruktor wird erst beendet, wenn eine Response-IPC-Message vom Empfänger eintrifft.
• SNMPExtensionTrap()
  Als dritte Methode, welche von einem Extension Agent exportiert werden muß, um von dem SNMP-Agenten verwendet zu werden, ist für die Behandlung von Traps zuständig. Zum Zeitpunkt der Erstellung des Prototypen wurde noch keine offizielle Verwendung eines Trap-Mechanismus unterstützt. Gleichwohl sind bereits Programmteile dafür vorgesehen.