Der SAAgent-Abschnitt der sasnmp.ini-Datei enthält Informationen über den SQL Anywhere-Erweiterungsagenten. Wenn das Feld TrapPollTime nicht benötigt wird, können Sie den gesamten Abschnitt auslassen.

TrapPollTime   Dieser Wert legt die Abrufhäufigkeit für dynamische Traps fest, sofern welche angegeben sind. Der SQL Anywhere SNMP-Erweiterungsagent fragt die Werte standardmäßig alle 5 Sekunden ab. Wenn dieser Wert 0 ist, sind dynamische Traps deaktiviert. Dieses Feld ist optional.

Jeder DBn-Abschnitt der Datei sasnmp.ini beschreibt eine Datenbank, die Herstellung einer Verbindung zu ihr und die für die Datenbank vorhandenen dynamischen Traps. Die Felder in diesem Abschnitt unterscheiden zwischen Groß- und Kleinschreibung.

Der Wert für n ist eine Zahl, die die Datenbank kennzeichnet. Die Nummerierung muss mit 1 beginnen und es dürfen keine Zahlen ausgelassen werden. Wenn die Datei sasnmp.ini z.B. die Einträge für [DB1], [DB2] und [DB4] enthält, wird der Eintrag [DB4] ignoriert, da der Eintrag [DB3] in der Datei fehlt.

ConnStr   Die Verbindungszeichenfolge für die Verbindung zur Datenbank. Sie müssen genügend Informationen bereitstellen, damit eine Verbindung mit der Datenbank hergestellt werden kann. Dieses Feld ist erforderlich.

UtilDbPwd   Wenn sa.agent.saStarted verwendet wird, um eine Datenbank zu starten, versucht der SQL Anywhere SNMP-Erweiterungsagent eine Verbindung zu der Datenbank mit dem Parameter DBF herzustellen, der den Datenbankserver anweist, wo die Datenbankdatei zu finden ist. Wenn die erforderliche Berechtigung für den Start der Datenbank jedoch DBA ist (der Standardwert für den Netzwerkserver, der mit der Option -gd dba sowohl für den Personal Server als auch für den Netzwerkserver angegeben werden kann), lässt der Server die Verbindung nicht zu.

Zum Starten einer Datenbank auf einem solchen Server muss der SQL Anywhere SNMP-Erweiterungsagent sich als Benutzer mit dem Benutzernamen DBA mit einer Datenbank verbinden, die bereits auf diesem Server läuft. Hierzu kann eine Verbindung zur Dienstprogrammdatenbank hergestellt werden. Wenn Sie das Kennwort der Dienstprogrammdatenbank (festgelegt durch die Serveroption -su) in der Datei sasnmp.ini angeben, stellt der SQL Anywhere-Erweiterungsagent für den Start einer Datenbank eine Verbindung zu dem betreffenden Server her, führt die Anweisung START DATABASE aus und trennt die Verbindung dann. Dieses Feld ist optional.

CacheTime   Wenn Daten von der Datenbank abgerufen werden, können sie innerhalb des SQL Anywhere SNMP-Erweiterungsagenten im Cachespeicher zwischengespeichert werden, sodass für nachfolgende Abfragen des betreffenden Datentyps (z.B. Servereigenschaften oder Datenbankstatistiken) keine Kommunikation mit der Datenbank erforderlich ist. Durch das Zwischenspeichern der Daten werden Datenabfragen einerseits schneller ausgeführt, andererseits ist es jedoch möglich, dass die Daten nicht aktuell sind. Mit dem Feld CacheTime können Sie die Verweildauer im Cachespeicher ändern oder den Cachespeicher deaktivieren, indem Sie den Wert auf "0" setzen. Standardmäßig beträgt die Cachezeit 0 Sekunden. Wenn der Parameter CacheTime auf 0 gesetzt wird, sind die abgerufenen Daten immer aktuell, da die Daten für jede Abfrage aus der Datenbank abgerufen werden. Dieses Feld ist optional.

DBSpaceCacheTime   Die Tabelle rdbmsDbLimitedResourceTable in der RDBMS MIB-Datenbank enthält Informationen über DBSpaces. Wenn diese Informationen aus der Datenbank abgerufen werden, können sie auch innerhalb des SQL Anywhere-Erweiterungsagenten im Cachespeicher zwischengespeichert werden. Der Standardwert für die Zwischenspeicherung von DBSpace-Informationen beträgt 600 Sekunden (10 Minuten). Mit diesem Feld können Sie die Verweildauer im Cachespeicher ändern (oder den Cachespeicher deaktivieren, indem Sie den Wert auf "0" setzen). Dieses Feld ist optional. Siehe rdbmsDbLimitedResourceTable.

Trap t    Erstellt eine dynamische Trap. Der Wert t muss eine positive Ganzzahl beginnend bei 1 sein. Es dürfen keine Nummern übersprungen werden. Dieses Feld ist optional. Siehe Dynamische Traps erstellen.

Disabled   Wenn der Wert auf "1" gesetzt ist, wird dieser Datenbankeintrag vom SQL Anywhere SNMP-Erweiterungsagenten übersprungen. Dies ist sinnvoll, wenn eine Datenbank aus der Liste der Datenbanken, die vom SQL Anywhere SNMP-Erweiterungsagenten verwaltet werden, vorübergehend entfernt werden soll, ohne die übrigen Datenbanken neu zu nummerieren. Dieses Feld ist optional.

Wenn Sie diese Datei bearbeiten, müssen Sie den SNMP-Dienst oder den SQL Anywhere SNMP-Erweiterungsagenten neu starten, damit der Agent die neuen Einstellungen verwendet.

 ♦  So starten Sie den SNMP-Dienst neu (Befehlszeile)

 ♦  So starten Sie den SQL Anywhere SNMP-Erweiterungsagenten erneut

Sie können den Inhalt der Datei sasnmp.ini mit einer einfachen Verschlüsselung mithilfe des Dienstprogramms dbfhide zum Verschleiern von Dateien verschleiern. Siehe Inhalt von .ini-Dateien verbergen.

Es folgt die Beispieldatei sasnmp.ini für den SQL Anywhere SNMP-Erweiterungsagenten.

[SAAgent]
[DB1]
ConnStr=UID=DBA;PWD=sql;DBN=sales;DBF=sales.db
Trap1=1.1.5 > 50000
UtilDbPwd=test
[DB2]
ConnStr=UID=DBA;PWD=sql;DBN=field;DBF=field.db
UtilDbPwd=test
Disabled=1
[DB3]
ConnStr=UID=DBA;PWD=sql;Host=host2;DBN=hq;DBF=hq.db
UtilDbPwd=test

Da im Abschnitt SAAgent keine Parameter angegeben sind, fragt der SQL Anywhere SNMP-Erweiterungsagent die Werte alle 5 Sekunden ab.

Der SQL Anywhere SNMP-Erweiterungsagent überwacht 3 verschiedene Datenbanken, die auf zwei unterschiedlichen Servern laufen. Datenbank 3 läuft auf einem anderen Computer, sodass der Host-Verbindungsparameter erforderlich ist. Für DB1 wird eine Trap festgelegt, die ausgelöst wird, wenn die Anzahl der vom Datenbankserver gesendeten Byte größer als 50000 ist.