Dienstprogramm für Supportanfragen (dbsupport)

dbsupport [ options ] operation [ operation-specific-option ]

dbsupport configuration-options

Option	Beschreibung
@data	Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien. Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien verwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide).
-o filename	Sendet die Ausgabe an die angegebene Datei.
-q	Zeigt nur kritische Meldungen an.

Option

Beschreibung

@data

Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien.

Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien verwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide).

-o filename

Sendet die Ausgabe an die angegebene Datei.

-q

Zeigt nur kritische Meldungen an.

Vorgang Beschreibung

-e configuration-option

Zeigt die Einstellung für die angegebene Konfigurationsoption an. Beispiel: Angenommen, Sie haben folgenden Befehl ausgeführt, um dbsupport zur Eingabeaufforderung zu konfigurieren, wenn dies möglich ist:

dbsupport -cc promptdefy

Wenn Sie den Befehl dbsupport -ecc ausführen werden folgende Einstellungen zurückgegeben:

-cc "promptdefy"

Wenn der aktuelle Wert der Konfigurationsoption nie explizit gesetzt wurde, wird kein Echo zurückgegeben.

-is submission-ID [ -rr N ]

Prüft den Status eines Crash-Berichts, der an iAnywhere Solutions übermittelt wurde.

Der folgende Befehl gibt beispielsweise den Status der Einsende-ID 66 zurück:

dbsupport -is 66

-iu [ -r N ]

Sucht Updates für Ihren Build von SQL Anywhere. Updates enthalten:

EBF Ein EBF (Express Bug Fix) ist eine Teilmenge der Software mit einer oder mehreren Fehlerbehebungen (Bug Fixes). Die Fehlerbehebungen werden in den Versionshinweisen für das Update aufgelistet. Updates zu Fehlerbehebungen können nur in eine installierte Software mit derselben Versionsnummer übernommen werden. Wenngleich einige Tests der Software vorgenommen wurden, sollten Sie diese Dateien nicht mit Ihrer Anwendung verteilen, es sei denn Sie haben Ihre Anwendung gründlich mit der Software getestet.
Wartungsversionen Eine Wartungsversion ist die Software in ihrem vollen Umfang, die die installierte Software von einer älteren Version mit derselben Hauptversionsnummer auf die neue Version aktualisiert. (Das Versionsnummernformat lautet major.)minor.patch.build). Fehlerbehebungen und andere Änderungen werden in den Versionshinweisen für das Upgrade aufgelistet.

Sie können auch nach Updates mit Interactive SQL und Sybase Central suchen. Siehe Software-Updates.

-lc Generiert eine Liste aller Crash-Berichte, die nicht an iAnywhere Solutions übermittelt wurden. Die aufgelisteten Berichtsnamen können mit der Option -sc verwendet werden.

-ls

Generiert eine Liste aller Einsende-IDs für alle Berichte, die an iAnywhere Solutions übermittelt wurden. Zum Beispiel:

dbsupport -ls

Dies gibt Informationen ähnlich wie die folgenden zurück:

SQL Anywhere-Dienstprogramm für Supportanfragen 12.0.1.2040
Einsende-ID: 217756  gemeldet: Mi Jul 30 15:54:43 2011
Einsende-ID:: 217757  gemeldet: Mi Jul 30 15:57:07 2011
Einsende-ID:: 217759  gemeldet: Mi Jul 30 16:14:24 2011
Einsende-ID:: 217760  gemeldet: Mi Jul 30 16:14:30 2011
Einsende-ID:: 217761  gemeldet: Mi Jul 30 16:28:12 2011
Einsende-ID:: 221030  gemeldet: Mo Sep 08 12:34:59 2011
Einsende-ID:: 221031  gemeldet: Mo Sep 08 12:35:05 2011

-pc filename Zeigt Crash-Berichtsinformationen an. Sie können diese Option verwenden, um Informationen anzuzeigen, bevor sie an iAnywhere Solutions übertragen werden.

-pd Zeigt Diagnoseinformationen an, die gesammelt wurden. Sie können diese Option verwenden, um Informationen anzuzeigen, bevor sie an iAnywhere Solutions übertragen werden.

-ps submission-ID

Zeigt Informationen über einen bestimmten Bericht an, der an iAnywhere Solutions übermittelt wurde. Zum Beispiel:

dbsupport -ps 4

Dies gibt Informationen über Einsendung 4 zurück:

SQL Anywhere Support Utility Version 12.0.1.2040
Submission ID: 217756  reported: Wed Jul 30 15:54:43 2011

-sa [ -r number-of-submission-retries ] Übermittelt alle Crash-Bericht- und Diagnoseinformationen im Diagnoseverzeichnis an iAnywhere Solutions.

-sc reportname [ -r number-of-submission-retries ] [ -nr | -rr N ]

Übermittelt einen Crash-Bericht und Diagnoseinformationen an iAnywhere Solutions. Zum Beispiel:

dbsupport -sc SA12_20051220_133828_32116

Verwenden Sie die Option -lc, um eine Liste der Berichte zu generieren, die nicht eingesendet wurden.

-sd [ -r number-of-submission-retries ]

Übermittelt nur Diagnoseinformationen an iAnywhere Solutions.

Weitere Hinweise zum Diagnoseverzeichnis finden Sie unter SADIAGDIR-Umgebungsvariable.

Konfigurationsoption

Beschreibung

-cc [ autosubmit | no | promptDefY | promptDefN ]

Ändert das Bedieneraufforderungsverhalten von dbsupport. Sie können eine der folgenden Optionen festlegen:

autosubmit Berichte automatisch einsenden.
no Nicht zur Eingabe der Berechtigung, Berichte einzusenden, auffordern. Berichte und Funktionsstatistiken werden nicht übermittelt.
promptDefY Wenn möglich zur Eingabe der Berechtigung, den Bericht einzusenden, auffordern. Wenn keine Antwort gegeben wird, wird der Bericht eingesendet.
promptDefN Wenn möglich zur Eingabe der Berechtigung, den Bericht einzusenden, auffordern. Wenn keine Antwort gegeben wird, wird der Bericht nicht eingesendet. Dies ist die Standardeinstellung.
Wenn Sie z.B. Embedded SQL in einer Anwendung benutzen, kann es sinnvoll sein, das SQL Anywhere-Dienstprogramm für Supportanfragen so zu konfigurieren, dass keine Berichte an iAnywhere Solutions gesendet werden.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der Datei dbsupport.ini im Diagnoseverzeichnis gespeichert.

Der folgende Befehl konfiguriert das Dienstprogramm für Supportanfragen dergestalt, dass keine Berichte eingesendet werden und der Benutzer niemals aufgefordert wird, Berichte einzusenden:

dbsupport -cc no

-cd retry-delay

Gibt die Verzögerung bei Neuversuchen (in Sekunden) für die Einsendung eines Berichts an, wenn der vorherige Versuch fehlgeschlagen ist. Der Standardverzögerung ist 30 Sekunden.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der Datei dbsupport.ini im Diagnoseverzeichnis gespeichert.

Der folgende dbsupport-Befehl legt fest, dass fehlgeschlagene Übermittlungen alle 3 Sekunden bis zu einem Maximum von 4 Versuchen erneut versucht werden sollen, bis aufgegeben wird:

dbsupport -cr 4 -cd 3

-ce email-address;email-server[:port ][;user-id:password ]

Gibt die Adresse an, an die die E-Mail nach einem Crash geschickt werden soll. Die E-Mail wird über den SMTP-Server email-server verschickt. Optional können Sie den zu verwendenden Port sowie user-id und password für die Authentifizierung beim SMTP-Server angeben.

-cet

Testet die mit der -ce-Option angegebenen E-Mail-Einstellungen.

-ch crash-handler-program

Gibt das Programm an, das aufgerufen wird, wenn ein Crash auftritt.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der Datei dbsupport.ini im Diagnoseverzeichnis gespeichert.

Der Datenbankserver unterstützt drei Ersetzungsparameter, die an das crash-handler-programzu übergebende Informationen einrichten:

%F Dieser Parameter wird durch den vollständigen Pfad zum Speicherort der generierten Berichtsdatei ersetzt.
%P Dieser Parameter wird durch den Namen des Programms, das den Bericht generiert hat, ersetzt. Beispiel: Wenn ein Personal Datenbankserver der Version 12 den Bericht generiert, wird dbeng12 zurückgegeben.
%S Dieser Parameter wird durch den Namen des Datenbankservers ersetzt, der im Einsatz war, als der Crash oder der schwerwiegende Fehler aufgetreten ist. Beispiel: Wenn ein Datenbankserver namens "Sample" den Bericht generiert hat, wird "Sample" zurückgegeben.

Sie können "$F", "$P" und "$S" als Alternativen zu "%F", "%P" bzw. "%S" verwenden. Da verschiedene Befehlsebenen die Zeichen "%" und "$" interpretieren, werden beide zur Verfügung gestellt. Unter Windows NT 4 z.B. wird "%F" durch den Wert der Umgebungsvariable "F" ersetzt, daher kann "$F" verwendet werden, um diese Ersetzung zu umgehen.

Nehmen wir an, Sie haben ein Crash-Handler-Programm unter c:\test.bat, das die folgenden Befehle enthält:

copy %1 c:\archives
echo %2

Unter Windows teilt der folgende Befehl dbsupport mit, c:\test.bat mit zwei Parametern zu starten, wenn ein Crash eintritt. Wenn der Bericht eingesendet werden soll, wird dieses Programm aufgerufen, bevor der Bericht eingesendet wird.

dbsupport -ch "c:\test.bat \"%F\" parm2"

Dieser durch %F angegebene Pfad wird als erster Parameter an c:\test.bat gesendet. Der Parameter parm2 wird als zweiter Parameter an c:\test.bat gesendet. Anführungszeichen müssen verwendet werden, um einen Crash-Handler anzugeben, der Argumente annimmt.

Im Beispiel oben wurden zusätzliche Anführungszeichen um den vollständigen Pfad zur generierten Berichtsdatei verwendet. Um Probleme beim Zugriff auf die von dbsupport verwendete Berichtsdatei zu vermeiden, sollte der Crash-Handler seine eigene Kopie der Berichtsdatei erstellen.

-ch-

Entfernt die Crash-Handler-Einstellungen, die in der Datei dbsupport.ini gespeichert sind. Zum Beispiel:

dbsupport -ch-

-cid customer-id

Gibt eine Zeichenfolge an, durch die Sie im Einsendebericht identifiziert werden. Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Konfiguration wird in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Das folgende Beispiel legt eine Kunden-Identifizierungszeichenfolge für dbsupport fest:

dbsupport -cid myid@company.com

dbsupport -cid "MyClientApp 1.0"

-cid-

Entfernt die Zeichenfolge für die Kundenidentifizierung aus der Datei dbsupport.ini. Zum Beispiel:

dbsupport -cid-

-cp { email-server [ :port ] | autodetect }

Konfiguriert den HTTP-Proxy-Host und den Port, die für die Übermittlung der Crash-Berichte verwendet werden.

Unter Windows wird auch die Syntax -cp autodetect unterstützt. Wenn Sie diese Option angeben und ein Proxy-Server und Port zur Verwendung des Internet Explorers eingestellt und derzeit aktiviert sind, konfiguriert dbsupport seinen Proxy-Server und Port unter Verwendung der Systemeinstellungen. In Internet Explorer müssen Sie möglicherweise Proxy-Server und Port einstellen.

-cp-

Entfernt die HTTP-Proxy-Host- und Port-Einstellungen aus der Datei dbsupport.ini. Zum Beispiel:

dbsupport -cp-

-cr number-of-submission-retries

Gibt an, wie oft eine fehlgeschlagene Einsendung wiederholt werden soll.

Wenn Sie diese Option angeben, wird ihr Wert vom Dienstprogramm für Supportanfragen als Standardwert verwendet. Die Einstellung wird in der Datei dbsupport.ini im Diagnoseverzeichnis gespeichert.

Der folgende dbsupport-Befehl legt fest, dass fehlgeschlagene Vorgänge alle 3 Sekunden bis zu einem Maximum von 4 Versuchen erneut versucht werden sollen, bis aufgegeben wird:

dbsupport -cr 4 -cd 3

Vorgangsspezifische Option

Beschreibung

-ac

Fügt der Übertragung einen Kommentar hinzu.

-af

Fügt der Übertragung eine Datei hinzu. Sie können die Option -af mehr als einmal angeben, um der Übertragung mehrere Dateien hinzuzufügen.

-nr

Gibt an, dass dbsupport den Server nicht auf den Status der Einsendung prüfen soll. Der folgende Befehl z.B. sendet den Bericht ein, überprüft aber nicht den Status der neuen Einsendung:

dbsupport -nr -sc SA12_20051220_133828_32116

Standardmäßig überprüft dbsupport, ob es bereits eine Lösung für das eingesendete Problem gibt.

-r number-of-submission-retries

Gibt an, wie oft dbsupport maximal versuchen soll, die Übertragung zu wiederholen. Die Angabe 0 bedeutet unbegrenzte Neuversuche. Der Standardwert ist 10. Die Angabe der Option -r setzt den in der Datei dbsupport.ini gespeicherten Wert -cr außer Kraft, falls vorhanden.

-rd retry-delay

Gibt an, wie viele Sekunden dbsupport zwischen den Neuversuchen zur Übermittlung des Berichts wartet. Der Standardwert ist 30. Die Angabe der Option -rd setzt den in der Datei dbsupport.ini gespeicherten Wert -cd außer Kraft, falls vorhanden.

-rr number-of-submission-response-retries

Gibt an, wie oft dbsupport maximal versuchen soll, eine Antwort auf die Übermittlung zu erhalten. Die Angabe 0 bedeutet unbegrenzte Neuversuche. Der Standardwert ist 10.

Wenn in einem SQL Anywhere-Programm ein schwerwiegender Fehler oder ein Absturz auftritt, wird ein Fehlerbericht erstellt, der technische Informationen über das Programm zum Zeitpunkt des Fehlers enthält. Nach dem Erstellen eines Fehlerberichts werden Sie aufgefordert, diesen Bericht an das SQL Anywhere-Support-Team zu senden. Sie können diesen Bericht auch mithilfe des Dienstprogramms für Supportanfragen (dbsupport) senden. Das Einsenden von Fehlerberichten hilft bei der Diagnose der Ursache von schwerwiegenden Fehlern oder Assertions. Wenn ein Bericht eingesendet wurde, erhalten Sie eine Einsende-ID, die Sie beim technischen Kundendienst angeben können. Wenn Sie das Problem dem technischen Kundendienst melden, kann das Senden dieser Fehlerdatei dessen Bearbeitung beschleunigen. Es wird empfohlen, dass Sie Fehlerberichte einsenden, auch wenn Sie sich nicht an den technischen Kundendienst wenden, da dies zur Verbesserung des Produkts beiträgt.

Das Dienstprogramm für Supportanfragen (dbsupport) kann für die folgenden Aufgaben verwendet werden:

Diagnoseinformationen und Crash-Berichte an iAnywhere Solutions über das Internet einsenden
Funktionsstatistiken einsenden
Informationen über eingesendete und nicht-eingesendete Crash-Berichte auflisten
Informationen über eingesendete und nicht-eingesendete Crash-Berichte drucken
Den Status einer Einsendung abfragen
Abfragen, ob Software-Updates für Ihre Version von SQL Anywhere verfügbar sind
Das Verhalten von dbsupport für den Fall konfigurieren, dass ein schwerwiegender Fehler (Assertion/Absturz) erkannt wird. Es kann z.B. so konfiguriert werden, dass ein bestimmtes Handler-Programm immer dann ausgeführt wird, wenn der Datenbankserver einen Fehlerbericht übermittelt. Diese Funktion ist nützlich, um Ihre eigenen benutzerdefinierten Aktionen dem Fehlerbehandlungsprozess hinzuzufügen.
Konfigurieren, wie oft das Senden eines Berichts wiederholt werden soll. Bei einer Berichtseinsendung kann es z.B. konfiguriert werden, dass der Vorgang in 30 Sekunden erneut versucht wird, bis zu einem Maximum von 10 Versuchen. Diese Funktion ist nützlich, wenn der Dienst möglicherweise zeitweilig nicht verfügbar ist.

Einstellungen für das Dienstprogramm für Supportanfragen werden in der dbsupport.ini-Datei im Diagnoseverzeichnis gespeichert.

Die vorgangspezifischen Optionen sind nützlich, um das Standardverhalten außer Kraft zu setzen, einschließlich von jenen Optionen, die in der Datei dbsupport.ini gespeichert sind:

Die grafischen Administrationstools können so konfiguriert werden, dass die Option zum Einsenden von Fehlerberichten entfernt wird. Siehe Konfiguration der Administrationstools.

Wenn Sie einen Fehlerbericht nicht einsenden, verbleibt er im Diagnoseverzeichnis auf Ihrer Festplatte. Dieses Verzeichnis wird von SQL Anywhere-Programmen automatisch erstellt und wird nur dazu verwendet, Fehlerberichte sowie Einstellungen des Dienstprogramms für Supportanfragen (dbsupport) zu speichern.

Speicherort des Diagnoseverzeichnisses Der Speicherort des Diagnoseverzeichnisses hängt von der Plattform ab:
- Windows (außer Windows Mobile)
  1. Das durch die SADIAGDIR-Umgebungsvariable angegebene Verzeichnis, falls diese gesetzt wurde.
  2. Der Standardspeicherort des Diagnoseverzeichnisses:
    
    Unter Windows XP %ALLUSERSPROFILE%\Anwendungsdaten\SQL Anywhere 12\diagnostics
    
    Unter Vista und höher %ALLUSERSPROFILE%\SQL Anywhere 12\diagnostics
  3. Das aktuelle Verzeichnis.
  4. Das temporäre Verzeichnis. Siehe SATMP-Umgebungsvariable sowie Umgebungsvariablen TMP, TMPDIR und TEMP.
  Unter Windows befindet sich das Diagnoseverzeichnis an einem Speicherort, auf den alle Benutzer des Computers Schreibzugriff haben. Wenn ein Computer über eine Anzahl von Benutzerkonten verfügt und Sie die Fehlerberichte eines Benutzers von denen anderer Benutzer getrennt halten möchten, setzen Sie die SADIAGDIR-Umgebungsvariable für jeden Benutzer auf ein Verzeichnis, auf das nur dieser spezielle Benutzer Lese- und Schreibzugriff hat. Siehe SADIAGDIR-Umgebungsvariable.
- Windows Mobile
  1. Das Verzeichnis des Programms oder ob dieses Verzeichnis nicht beschreibbar ist
  2. Das aktuelle Verzeichnis oder ob dieses Verzeichnis nicht beschreibbar ist:
  3. Das temporäre Verzeichnis. Siehe die Registrierungseinstellungen unter Windows Mobile.
- Unix, Linux, OS X
  1. Das durch die SADIAGDIR-Umgebungsvariable angegebene Verzeichnis, falls diese gesetzt wurde.
  2. Das Standard-Diagnoseverzeichnis: $HOME/.sqlanywhere12/diagnostics.
  3. Das aktuelle Verzeichnis.
  4. Das temporäre Verzeichnis. Siehe SATMP-Umgebungsvariable sowie Umgebungsvariablen TMP, TMPDIR und TEMP.
  Hinweis
  
  Unter Unix ist das Schreiben von Crash-Berichten in das Stammverzeichnis des Benutzers nicht empfehlenswert, wenn die Datenbank oder der MobiLink-Server als Daemon ausgeführt wird oder wenn der Benutzer "root/nobody" ist.

Namen von Fehlerberichtsdateien Namen von Fehlerberichtsdateien setzen sich aus folgenden Komponenten zusammen:

Einem Präfix, das die Anwendung kennzeichnet:

Anwendungspräfix	Anwendung
DBCONSOLE	SQL Anywhere-Konsolendienstprogramm
ISQL	Interactive SQLDienstprogramm
LSN	Listener-Dienstprogramm
MLC	MobiLink-Client
MLS	MobiLink-Server
ML_MON	MobiLink-Monitor
QAA	QAnywhere Agent
SA	Personal oder Netzwerk-Datenbankserver
SCJ	Sybase Central
SR	SQL Remote

Einem Wert, der die Softwareversion angibt
Zwei mit Unterstrichen verbundenen Feldern, die den Zeitstempel für den Zeitpunkt darstellen, an dem der Bericht erstellt wurde
Dem Anwendungsbezeichner
Der Erweiterung .dmp

Beispiel: SA12_20110620_133828_32116.dmp ist ein Fehlerbericht eines SQL Anywhere-Datenbankservers der Version 12 vom 20.06.20011, um 13:38:28 Uhr, aus Prozess 32116.

SADIAGDIR-Umgebungsvariable

Sie können das Standardverhalten von "dbsupport" mit der Option -cc ändern:

Der folgende Befehl konfiguriert "dbsupport" dahingehend, dass Fehlerberichte ohne Eingabeaufforderung an den Benutzer eingesendet werden:
dbsupport -cc autosubmit
Der folgende Befehl deaktiviert die automatische Einsendung von Fehlerberichten:
dbsupport -cc no

Sie können mit der Option -lc eine Liste der Fehlerberichte anzeigen:

Der nachstehende Befehl generiert eine Liste aller Absturzberichte, die nicht an iAnywhere Solutions übermittelt wurden:
dbsupport -lc

Sie können die Fehlerberichte mit der Option -sa, -sc oder -sd manuell übermitteln:

Mit dem folgenden Befehl werden alle Crash-Bericht- und Diagnoseinformationen im Diagnoseverzeichnis an iAnywhere Solutions übermittelt:
dbsupport -sa

Sie können auch Kommentare und Dateien in den Fehlerbericht einbeziehen, indem Sie die Optionen -ac bzw. -af verwenden.

dbsupport -sc SA12_20080901_113308_3360 -ac "The message.txt file provides more 
information about this error report." -af c:\scenario.txt -af c:\message.txt

Dienstprogramm für Supportanfragen (dbsupport)

Syntax

Bemerkungen

Hinweis

Siehe auch

Beispiel