支持实用程序 (dbsupport)

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

dbsupport configuration-options

选项	说明
@data	读取来自指定的环境变量或配置文件的选项。请参见使用配置文件。如果要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。
-o filename	将输出发送到指定文件中。
-q	只显示重要消息。

选项

说明

@data

读取来自指定的环境变量或配置文件的选项。请参见使用配置文件。

如果要保护口令或配置文件中的其它信息，可以使用文件隐藏实用程序对配置文件的内容进行模糊处理。请参见文件隐藏实用程序 (dbfhide)。

-o filename

将输出发送到指定文件中。

-q

只显示重要消息。

操作说明

-e configuration-option

显示指定配置选项的设置。例如，假设您运行以下命令来配置 dbsupport 在可能的情况下显示提示：

dbsupport -cc promptdefy

运行命令 dbsupport -ecc 时，会返回以下设置：

-cc "promptdefy"

-is submission-ID [ -rr N ]

检查已提交给 iAnywhere Solutions 的崩溃报告的状态。

例如，以下命令将查询 ID 66 的提交状态：

dbsupport -is 66

-iu [ -r N ]

检查您所用的 SQL Anywhere 版本是否有更新。更新包括：

EBF 快速错误修正软件是含有一个或多个错误修正软件的软件子集。错误修正软件列在更新程序的发行说明中。错误修正软件更新可能只适用于具有相同版本号的已安装软件。虽然已在该软件上进行了一些测试，但是除非您使用该软件对您的应用程序进行了全面测试，否则不应随应用程序分发这些文件。
维护版本 维护版本是一套完整的软件，它升级已安装的具有相同主版本号的较早版本的软件（版本号格式是 major.minor.patch.build）。升级程序的发行说明中列出了错误修正软件和其它更改。

也可以使用 Interactive SQL 和 Sybase Central 来检查更新。请参见检查软件更新。

-lc 生成一份所有尚未提交给 iAnywhere Solutions 的崩溃报告的列表。所列出的报告名称可以与 -sc 选项一起使用。

-ls

生成所有已提交给 iAnywhere Solutions 的报告的提交 ID 列表。例如：

dbsupport -ls

其返回的信息如下：

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

-pc filename 显示崩溃报告信息。通过此选项，可以在将信息提交给 iAnywhere Solutions 之前进行查看。

-pd 显示已收集的诊断信息。通过此选项，可以在将信息提交给 iAnywhere Solutions 之前进行查看。

-ps submission-ID

显示已提交给 iAnywhere Solutions 的特定报告的信息。例如：

dbsupport -ps 4

有关提交 4 的信息将被返回：

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

-sa [ -r number-of-submission-retries ] 将所有存储于诊断目录中的崩溃报告和诊断信息提交给 iAnywhere Solutions。

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

将一份崩溃报告和诊断信息提交给 iAnywhere Solutions。例如：

dbsupport -sc SA12_20051220_133828_32116

使用 -lc 选项可以查看未提交报告的列表。

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

仅将诊断信息提交给 iAnywhere Solutions。

有关诊断目录的详细信息，请参见SADIAGDIR 环境变量。

配置选项

说明

-cc [ autosubmit | no | promptDefY | promptDefN ]

更改 dbsupport 的提示行为。您可以指定以下各选项之一：

autosubmit 自动提交报告。
no 不提示用户授权来提交报告。报告和功能统计信息将不会提交。
promptDefY 在可能的情况下提示用户授权来提交报告。如果用户没有给予回答，则提交报告。
promptDefN 在可能的情况下提示用户授权来提交报告。如果用户没有给予回答，则不提交报告。这是缺省行为。
例如，如果正在应用程序中使用嵌入式 SQL Anywhere，则您可能希望将支持实用程序配置为不向 iAnywhere Solutions 提交报告。

如果指定此选项，其值将成为支持实用程序所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

以下命令将支持实用程序配置为不提交报告并且不提示用户提交报告：

dbsupport -cc no

-cd retry-delay

指定自上次尝试失败后报告提交操作的重试延迟（以秒为单位）。缺省延迟为 30 秒。

如果指定此选项，其值将成为支持实用程序所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

以下 dbsupport 命令指定每 3 秒将失败的提交重试一次，在放弃重试前重试次数可达 4 次：

dbsupport -cr 4 -cd 3

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

指定在出现崩溃后发出电子邮件的地址。将使用 email-server SMTP 服务器发送电子邮件。或者，可以指定要使用的端口以及用于 SMTP 服务器验证的 user-id 和 password。

-cet

测试由 -ce 选项指定的电子邮件设置。

-ch crash-handler-program

指定在出现崩溃时所调用的程序。

如果指定此选项，其值将成为支持实用程序所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

数据库服务器支持以下三种替代参数，用以设置传递给 crash-handler-program 的信息：

%F 此参数将被所生成报告文件的位置的完整路径代替。
%P 此参数将被生成报告的程序的名称所代替。例如，如果报告由版本 12 个人数据库服务器生成，则将返回 dbeng12。
%S 此参数将被出现崩溃或致命错误时正在使用的数据库服务器的名称所代替。例如，如果报告由名为 Sample 的数据库服务器生成，则将返回 Sample。

可以使用 $F、$P 和 $S 来代替 %F、%P 和 %S。由于不同的命令解释程序会对字符 % 和 $ 进行不同解释，因此提供了这两种形式。例如，%F 在 4NT 上会被替换为环境变量 F 的值；可以使用 $F 来避免这种替换。

假设在文件 c:\test.bat 中有一个崩溃处理程序，其包含以下命令：

copy %1 c:\archives
echo %2

在 Windows 中，以下命令告诉 dbsupport 在出现崩溃时使用两个参数来启动 c:\test.bat。如果此报告正在提交中，会在提交报告前调用此程序。

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

由 %F 所指定的替代路径作为第一个参数发送给 c:\test.bat。参数 parm2 作为第二个参数发送给 c:\test.bat。注意，必须使用引号来指定将接受参数的崩溃处理程序。

在上例中，在所生成报告文件的完整路径两侧使用了附加的引号。为避免在访问 dbsupport 正使用的报告文件时出现问题，崩溃处理程序会创建其自身的报告文件副本。

-ch-

删除存储于 dbsupport.ini 文件中的崩溃处理程序设置。例如：

dbsupport -ch-

-cid customer-id

指定一个用于在提交报告中标识您身份的字符串。如果指定此选项，其值将成为支持实用程序所用的缺省值。该配置存储于诊断目录的 dbsupport.ini 文件中。

以下示例为 dbsupport 指定一个客户标识字符串：

dbsupport -cid myid@company.com

dbsupport -cid "MyClientApp 1.0"

-cid-

从 dbsupport.ini 文件中删除客户标识字符串。例如：

dbsupport -cid-

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

配置在提交错误报告时所用的 HTTP 代理主机和端口。

在 Windows 上，还支持语法 -cp autodetect。指定此选项后，如果已经使用 Internet Explorer 设置了代理服务器和端口而且它们当前已经启用，dbsupport 会使用该系统设置来配置其代理服务器和端口。可以在 Windows 的 Internet Explorer 中设置代理服务器和端口，方法是：选择 [工具] » [选项] » [局域网设置]。

-cp-

从 dbsupport.ini 文件中删除 HTTP 代理主机和端口设置。例如：

dbsupport -cp-

-cr number-of-submission-retries

指定对于失败的提交操作的重试次数。

如果指定此选项，其值将成为支持实用程序所用的缺省值。该设置存储于诊断目录的 dbsupport.ini 文件中。

以下 dbsupport 命令指定每 3 秒将失败的操作重试一次，在放弃重试前重试次数可达 4 次：

dbsupport -cr 4 -cd 3

特定于操作的选项

说明

-ac

为提交添加注释。

-af

为提交附加文件。可多次指定 -af 选项，为提交附加多个文件。

-nr

指定 dbsupport 不在服务器中检查提交状态。例如，以下命令将提交报告，但不检查这一新提交的状态：

dbsupport -nr -sc SA12_20051220_133828_32116

缺省情况下，dbsupport 会检查针对所提交的问题是否已经有解决方案。

-r number-of-submission-retries

指定 dbsupport 将尝试发送提交的最大次数。指定 0 表示重试次数无限制。缺省值为 10。指定 -r 时，将替换存储于 dbsupport.ini 中的 -cr 值（如果存在）。

-rd retry-delay

指定 dbsupport 在两次报告重发尝试之间等待的秒数。缺省值为 30。指定 -rd 时，将替换存储于 dbsupport.ini 文件中的 -cd 值（如果存在）。

-rr number-of-submission-response-retries

指定 dbsupport 将尝试获取提交响应的最大次数。指定 0 表示重试次数无限制。缺省值是 10。

支持实用程序 (dbsupport) 可用于以下任何任务：

通过 Internet 将诊断信息和崩溃报告提交给 iAnywhere Solutions
提交功能统计信息
列出有关已提交和未提交崩溃报告的信息
打印有关已提交和未提交崩溃报告的信息
查询提交状态
查询针对您所用版本的 SQL Anywhere 是否有可用的软件更新
配置当数据库或 MobiLink 服务器检测到致命错误（声明/崩溃）时所要执行的操作

缺省情况下，dbsupport 会检查针对所提交的问题是否已经有解决方案。

可以在发生致命错误时，将来自以下任何应用程序的信息以错误报告的形式发送出去：

Interactive SQL (dbisql)
MobiLink 监听器 (dblsn)
MobiLink 重放 API 生成器 (mlgenreplayapi)
MobiLink 重放实用程序 (mlreplay)
MobiLink 服务器 (mlsrv)
网络服务器 (dbsrv12)
个人服务器 (dbeng12)
QAnywhere 代理 (qaagent)
用于 MobiLink 的 SQL Anywhere 客户端 (dbmlsync)
SQL Anywhere 控制台实用程序 (dbconsole)
SQL Remote (dbremote)
Sybase Central

报告成功提交后，会获得一个唯一的提交 ID。各项报告均写入诊断目录中。

平台	缺省诊断目录位置
Windows（Windows Mobile 除外）	%ALLUSERSPROFILE%\Application Data\SQL Anywhere 12\diagnostics
Windows Mobile	运行可执行文件的目录。
Unix	$HOME/.sqlanywhere12/diagnostics

有关诊断目录的信息，请参见SADIAGDIR 环境变量。

有关错误报告及其提交方式的详细信息，请参见SQL Anywhere 中的错误报告。

支持实用程序也可配置成在检测到问题时执行某些操作。例如，可将它配置为在每次数据库服务器提交错误报告时执行指定的处理程序。要向错误处理程序添加自定义的操作时，此功能非常有用。

支持实用程序经配置也可以重试某些操作。例如，经过配置，它可以在提交报告时在 30 秒后再次重试这一操作，重试次数可达 10 次。在处理服务有可能会暂时无法使用的情况时，此功能非常有用。

支持实用程序的设置存储在诊断目录的 dbsupport.ini 文件中。

在替换缺省行为（包括存储于 dbsupport.ini 文件中的行为）时，特定于操作的选项非常有用。

EBF 快速错误修正软件是含有一个或多个错误修正软件的软件子集。错误修正软件列在更新程序的发行说明中。错误修正软件更新可能只适用于具有相同版本号的已安装软件。虽然已在该软件上进行了一些测试，但是除非您使用该软件对您的应用程序进行了全面测试，否则不应随应用程序分发这些文件。
维护版本 维护版本是一套完整的软件，它升级已安装的具有相同主版本号的较早版本的软件（版本号格式是 major.minor.patch.build）。升级程序的发行说明中列出了错误修正软件和其它更改。

支持实用程序 (dbsupport)

语法

注释

另请参见