管理工具配置

可使用名为 OEM.ini 的初始化文件来指定管理工具显示或启用的功能。此文件必须与管理工具使用的 JAR 文件位于同一目录中（例如，C:\Program Files\SQL Anywhere 16\Java）。如果未找到此文件，则使用缺省值。此外，缺省值将用作 OEM.ini 中缺少的值。

注意

重新部署管理工具时，这些工具无法检查 SQL Anywhere 软件的更新。[检查更新] 菜单项和选项不会出现在重新部署后的版本中。

以下是示例 OEM.ini 文件：

[errors]
# reportErrors type is boolean, default = true
reportErrors=true

[updates]
# checkForUpdates type is boolean, default = true
checkForUpdates=true

[preferences]
directory=preferences_files_directory

[dbisql]
allowPasswordsInFavorites=true
defaultShowResultsForAllStatements=false 
defaultShowMultipleResultSets=false
disableExecuteAll=false
fastLauncherEnabled=true
# lockedPreferences is assigned a comma-separated 
# list of one or more of the following option names:
#    autoCommit
#    autoRefetch
#    commitOnExit
#    disableResultsEditing
#    executeToolbarButtonSemantics
#    fastLauncherEnabled
#    maximumDisplayedRows
#    showMultipleResultSets
#    showResultsForAllStatements
lockedPreferences=showMultipleResultSets,commitOnExit

所有以 # 字符开始的行都是注释行，将被忽略。指定的选项名称和值区分大小写。

OEM.ini 文件分为以下部分：

[errors]

[updates]

[preferences]

本部分设置的选项适用于所有管理工具。

设置 directory 选项，以指定管理工具用于保存用户特定配置文件的目录。这些文件包含与管理工具设置及历史相关的信息。例如，它们可能会包含 Interactive SQL 语句历史、近期打开的文件或保存的窗口位置。

必须指定一个不以路径分隔符（Windows 上的反斜线；Linux、Unix 和 Mac OS X 上的正斜线）结尾的完全限定目录（如 c:\work\prefs）。

在 Windows 上，用户首选项目录的缺省设置为 %appdata%\sybase。此设置允许多用户在单个系统上分别拥有自己的目录记录首选项。在 OEM.ini 文件中覆盖此设置禁用此功能。

[performancedata]

本部分设置的该选项仅适用于 Interactive SQL 和 Sybase Central。

showPerformanceDataUI 如果 showPerformanceDataUI 为 false，则管理工具不允许用户启用或禁用自动向软件开发团队提交性能数据。请参见定期提交性能数据。

[dbisql]

本部分设置的选项只适用于 Interactive SQL。

allowPasswordsInFavorites 如果 allowPasswordsInFavorites 为 false，Interactive SQL 将从 [添加到收藏夹] 窗口中移除 [保存连接口令] 复选框。缺省设置为 true，意味着存在该复选框。请参见将 SQL 脚本文件、SQL 语句和连接添加到收藏夹。

defaultShowResultsForAllStatements 此选项可更改结果在 Interactive SQL 中的显示方式的缺省设置。如果将 defaultShowResultsForAllStatements 设置为 true，则所有数据库类型的缺省设置便是显示所有语句的结果。如果将此选项设置为 false，则所有数据库类型的缺省设置便是仅显示上一语句的结果。

可使用可选前缀，将这种设置作用局限于特定数据库类型。如果无前缀，指令将适用于所有数据库类型。前缀包括：

SQLAnywhere.
UltraLite.
SybaseIQ.
HANA.

例如，以下选项设置仅影响 SQL Anywhere 数据库的缺省设置。

SQLAnywhere.defaultShowResultsForAllStatements=true

defaultShowMultipleResultSets 此选项可更改结果在 Interactive SQL 中的显示方式的缺省设置。如果将 defaultShowMultipleResultSets 设置为 true，则所有数据库类型的缺省设置便是显示多个结果集。如果将此选项设置为 false，则所有数据库类型的缺省设置便是仅显示第一个结果集。
可使用可选前缀，将这种设置作用局限于特定数据库类型。如果无前缀，指令将适用于所有数据库类型。前缀包括：
- SQLAnywhere.
- SybaseIQ.
disableExecuteAll 如果 disableExecuteAll 为 true，则 Interactive SQL 中的 [SQL] » [执行] 菜单项和 F5 加速键将被禁用。如果已将 [执行] 工具栏按钮配置为 [执行]，则该按钮也将被禁用。因此，最好在 Interactive SQL 中将 [执行] 工具栏按钮设置为 [执行选择]，然后在 OEM.ini 文件中设置 executeToolbarButtonSemantics 选项，以防止用户更改 [执行] 工具栏按钮。请参见执行 SQL 语句 (Interactive SQL)。
fastLauncherEnabled 如果将 fastLauncherEnabled 设置为 true，将启用快速启动程序功能。要禁用快速启动程序功能，请将此选项设置为 false。请参见快速启动程序选项。

lockedPreferences 可以锁定 Interactive SQL 选项设置以使用户无法对其进行更改。选项名称区分大小写。以下是一个示例：

[dbisql] lockedPreferences=autoCommit

可以阻止用户更改以下 Interactive SQL 选项设置：

autoCommit 阻止用户自定义 [每条语句后提交] 选项。请参见auto_commit 选项 [Interactive SQL]。
autoRefetch 阻止用户自定义 [自动重新读取结果] 选项。请参见auto_refetch 选项 [Interactive SQL]。
commitOnExit 阻止用户自定义 [退出或断开连接时提交] 选项。请参见commit_on_exit 选项 [Interactive SQL]。
disableResultsEditing 阻止用户自定义 [禁用编辑] 选项。
executeToolbarButtonSemantics 阻止用户自定义 [执行] 工具栏按钮的行为。请参见执行 SQL 语句 (Interactive SQL)。
fastLauncherEnabled 阻止用户自定义快速启动程序选项。请参见快速启动程序选项。
maximumDisplayedRows 阻止用户自定义 [要显示的最大行数] 选项。请参见isql_maximum_displayed_rows 选项 [Interactive SQL]。
showMultipleResultSets 阻止用户自定义 [仅显示第一个结果集] 或 [显示所有结果集] 选项。此设置还会阻止用户设置 isql_show_multiple_result_sets 选项。请参见isql_show_multiple_result_sets 选项 [Interactive SQL]。
showResultsForAllStatements 阻止用户自定义 [显示最后一条语句的结果] 或 [显示每条语句的结果] 选项。请参见返回多个结果集。

使用DocCommentXchange讨论此页。