Dienstprogramm für Supportanfragen (dbsupport)

dbsupport [ Optionen ] Vorgang [ vorgangsspezifische_Option ]

dbsupport Konfigurationsoptionen

Option	Beschreibung
@data	Liest Optionen aus der angegebenen Umgebungsvariablen oder Konfigurationsdatei ein. Siehe Konfigurationsdateien verwenden. Wenn Sie Kennwörter oder andere Informationen in einer Konfigurationsdatei schützen möchten, können Sie das Dienstprogramm zum Verschleiern von Dateien (dbfhide) verwenden. Siehe Dienstprogramm zum Verschleiern von Dateien (dbfhide).
-o Dateiname	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 verwenden.

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

-o Dateiname

Sendet die Ausgabe an die angegebene Datei.

-q

Zeigt nur kritische Meldungen an.

Vorgang Beschreibung

-e Konfigurationsoption

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"

-is Einsende-ID [ -rr N ]

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

Der folgende Befehl fragt den Status der Einsende-ID 66 ab:

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 oder Maintenance Release ist die Software in ihrem vollständigen Umfang, die die installierte Software aus einer älteren Version mit derselben Hauptversionsnummer auf die neue Version umstellt (das Versionsnummernformat lautet Hauptnummber.Unternummer.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 Nach Software-Updates suchen.

-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 Support Utility Version 12.0.0.2040
Submission ID: 217756  reported: Wed Jul 30 15:54:43 2008
Submission ID: 217757  reported: Wed Jul 30 15:57:07 2008
Submission ID: 217759  reported: Wed Jul 30 16:14:24 2008
Submission ID: 217760  reported: Wed Jul 30 16:14:30 2008
Submission ID: 217761  reported: Wed Jul 30 16:28:12 2008
Submission ID: 221030  reported: Mon Sep 08 12:34:59 2008
Submission ID: 221031  reported: Mon Sep 08 12:35:05 2008

-pcDateiname 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 Einsende-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.0.2040
Submission ID: 217756  reported: Wed Jul 30 15:54:43 2008

-sa [ -r Anzahl_der_Einsendungsneuversuche ] Übermittelt alle Crash-Bericht- und Diagnoseinformationen im Diagnoseverzeichnis an iAnywhere Solutions.

-sc Berichtname [ -r Anzahl_der_Einsendungsneuversuche ] [ -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 Anzahl_der_Einsendungsneuversuche ]

Ü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 Neuversuch-Verzögerung

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 E-Mail-Adresse;E-Mail-Server[:Port ][;Benutzer-ID:Kennwort ]

Gibt die Adresse an, an die die E-Mail nach einem Crash geschickt werden soll. Die E-Mail wird über den SMTP-Server E-Mail-Server verschickt. Optional können Sie den zu benutzenden Port, die Benutzer-ID sowie das Kennwort für die Authentifizierung auf dem SMTP-Server angeben.

-cet

Testen Sie die mit der -ce-Option angegebenen E-Mail-Einstellungen.

-ch Crash-Handler_Programm

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 Informationen einrichten, die dem Crash-Handler-Programm übergeben werden:

%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 Befehlsumgebungen 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.

Angenommen, 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 an c:\test.bat als der erste Parameter gesendet. Der Parameter Param2 wird an c:\test.bat als der zweite Parameter gesendet. Beachten Sie, dass Anführungszeichen verwendet werden müssen, um einen Crash-Handler anzugeben, der Argumente nimmt.

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 Kunden-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 { E-Mail_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. Sie können den Proxy-Server und Port im Windows Internet Explorer einstellen, indem Sie Extras » Optionen » LAN-Einstellungen wählen.

-cp-

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

dbsupport -cp-

-cr Anzahl_der_Einsendungsneuversuche

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 Anzahl_der_Einsendungsneuversuche

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 Neuversuch-Verzögerung

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 Anzahl_der_Einsendungsantwort-Neuversuche

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.

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.
Funktionsstatistik 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.
Aktionen konfigurieren, wenn ein schwerwiegender Fehler (Assertierung/Crash) von einem Datenbank- oder MobiLink-Server erkannt wird.

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

Informationen der folgenden Anwendungen können im Fall eines schwerwiegenden Fehlers ebenfalls als Fehlerbericht eingesendet werden:

Interactive SQL (dbisql)
MobiLink Listener (dblsn)
MobiLink Replay API Generator (mlgenreplayapi)
MobiLink Replay-Dienstprogramm (mlreplay)
MobiLink-Server (mlsrv)
Netzwerkserver (dbsrv12)
Personal Server (dbeng12)
QAnywhere Agent (qaagent)
SQL Anywhere-Client für MobiLink (dbmlsync)
SQL Anywhere-Konsolendienstprogramm (dbconsole)
SQL Remote (dbremote)
Sybase Central

Wenn ein Bericht erfolgreich eingesendet wurde, wird ihm eine eindeutige Einsende-ID zugeordnet. Berichte werden in das Diagnoseverzeichnis geschrieben.

Plattform	Standard-Standort des Diagnoseverzeichnisses
Windows (außer Windows Mobile)	%ALLUSERSPROFILE%\Anwendungsdaten\SQL Anywhere 12\diagnostics
Windows Mobile	Verzeichnis, in dem die Programmdatei ausgeführt wird
Unix	$HOME/.sqlanywhere12/diagnostics

Hinweise zum Diagnoseverzeichnis finden Sie unter SADIAGDIR-Umgebungsvariable.

Hinweise zu Fehlerberichten und wie sie eingesendet werden, finden Sie unter Fehlerberichte in SQL Anywhere.

Das Dienstprogramm für Supportanfragen kann so konfiguriert werden, dass bestimmte Aktionen durchgeführt werden, wenn ein Problem entdeckt wird. Es kann z.B. konfiguriert werden, dass ein bestimmtes Handler-Programm immer dann ausgeführt wird, wenn der Datenbankserver einen Fehlerbericht einsendet. Diese Funktion ist nützlich, um Ihre eigenen benutzerdefinierten Aktionen dem Fehlerbehandlungsprozess hinzuzufügen.

Das Dienstprogramm für Supportanfragen kann auch so konfiguriert werden, dass bei bestimmten Vorgängen Neuversuche durchgeführt werden. 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 jener Optionen, die in dbsupport.ini file gespeichert sind:

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.
Wartungsversion Eine Wartungsversion oder Maintenance Release ist die Software in ihrem vollständigen Umfang, die die installierte Software aus einer älteren Version mit derselben Hauptversionsnummer auf die neue Version umstellt (das Versionsnummernformat lautet Hauptnummer.Unternummer.Patch.Build). Fehlerbehebungen und andere Änderungen werden in den Versionshinweisen für das Upgrade aufgelistet.

Dienstprogramm für Supportanfragen (dbsupport)

Syntax

Bemerkungen

Siehe auch