您好,我是小DAI,专注于数据库管理员相关的技术问答,请问有什么可以帮您?

sp_jreconfig

语法


sp_jreconfig {
	add <array_arg>, <new_string> |
	array_clear <array_arg> |
	array_enable <array_arg> |
	array_disable <array_arg> |
	delete <array_arg>, <string_value> |
	disable { <directive> | <argument> | <array_arg>, <string_value> } | 
	enable { <directive> | <argument> | <array_arg>, <string_value> } |
	list { <list_type>[, formatted ] | units | units, <units_type>[, formatted ] } |
	reload_config |
	report { <directive>[, formatted ] | <directive>, args[, formatted ]
		|<argument>[, formatted ] } |
	update { <argument>, <old_value>, <new_value> } }

> 注意

> 您可以安全地更改 pca_jvm_module_path、pca_jvm_work_dir、pca_jvm_dbg_agent_port、pca_jvm_java_dbg_agent_suspend、pca_jvm_java_options 和 pca_jvm_netio 参数。请勿使用 sp_jreconfig 更改其它参数或指令,除非 Sybase 技术支持部门指示这样做。

参数

add

在参数数组中添加一个新参数。add 仅用于 <units_type> 为数组的参数。

<array_arg>

<units_type> 为数组的参数的名称。

<new_string>

是新数组元素的字符串值。

array_clear

删除参数数组中的所有元素。

array_enable

启用参数数组中的所有元素。将每个数组元素设置为启用。

array_disable

禁用但不删除参数数组中的所有元素。将每个元素设置为禁用。

delete

从参数数组中删除现有元素。delete 仅用于 <units_type> 为数组的参数。

disable

禁用指定的指令或参数。

<string_value>

标识要删除、启用或禁用的指定参数数组中的数组元素。

directive

是活动数据库的名称。

argument

是有效参数的名称。

enable

启用指令或参数。

list

以诸如 sp_jreconfig list, directives 或 sp_jreconfig list, enabled 之类的形式列出相关参数的组。此外,还会以诸如 sp_jreconfig list, units, string 之类的形式列出特定类型的所有参数。若要查看当前的所有 <units_types> 值,请使用 sp_jreconfig list, units。

formatted

设置显示列表的格式以改善可读性;较长的值可能会被截断。

> 注意

> 在设置了格式的报告中,改善可读性的过程可能造成宽列被截断。此外,列标题可能会被覆盖,可能会与实际的表名称不匹配。如果将对输出进行分析或潜在的数据截断不可接受,请勿为报告设置格式。

<list_type>

指定列表的类型。其值包括:

  • directives – 指令列表

  • enabled – 已启用的参数的列表

  • disabled – 已禁用的参数的列表

  • argnames – 参数名列表、各参数的 <units_type> 以及各自所属指令

    units

    与 list 搭配使用时,生成当前使用的 <units_type> 的列表。

    <units_type>

    是参数的类型。每个参数都有一个标识其类型的 <units_type>。其值包括:

  • switch

  • string

  • number

  • array

    reload_config

    将配置从 sybpcidb 表重新装载到内存中。

    report

    根据提供的参数创建报告。通常用于生成某个参数的报告,以查看其当前值以及其是否启用。也可用于生成指令或其参数的报告。

    `<directive></p> <p>是任何有效的指令。</p> <p>args</p> <p>是与报告一起用于为指定指令生成参数名列表的关键字。例如:</p> <div class="code-block"><pre><code> sp_jreconfig report, "PCA_JVM", "args"

update</p> <p>修改 为 string、number 或 array 的参数的字符串或数值。当 为 switch 时,不能修改参数。</p> <p></p> <p>是标识要更新的现有参数或数组元素的字符串或数值。</p> <p></p> <p>是定义新参数或数组元素的字符串或数值。</p> <h3>示例</h3> <h4>生成格式化报告</h4> <p>为 PCA_JVM_OPT 指令生成已设置格式的报告:</p> <div class="code-block"><pre><code> sp_jreconfig "report", "PCA_JVM_OPT", "formatted"

生成参数报告

为 PCA_JVM_OPT 指令生成参数报告:


sp_jreconfig "report", "PCA_JVM_OPT", "args"

生成参数报告

为参数 pca_jvm_netio 生成报告:


sp_jreconfig "report", "pca_jvm_netio"

生成所有参数报告

为与“pca_jvm”匹配的所有参数生成报告。部分参数名为所有匹配的参数生成报告:


sp_jreconfig "report", "pca_jvm"

生成列表

显示所有指令及其状态的列表(启用或禁用):


sp_jreconfig "list", "directives"

生成列表

显示所有参数及其单元类型和指令的列表:


sp_jreconfig "list", "argnames", "formatted"

生成列表

显示当前启用的所有参数的列表:


sp_jreconfig "list", "enabled"

生成列表

显示所有数组参数的格式化列表:


sp_jreconfig "list", "units", "array", "formatted"

生成列表

显示参数单元类型的列表:


sp_jreconfig "list", "units"

缺省情况下,此命令的报告已设置格式。使用“-formatted”选项会生成错误。

启用指令和参数

启用 PCA_JVM_WORK_DIR 指令:


sp_jreconfig "enable", "PCA_JVM_WORK_DIR"
sp_jreconfig "enable", "WORK_DIR"

您可以使用部分指令名称,前提是它包含的信息足以唯一标识相应的指令。

启用指令和参数

启用 pca_jvm_netio 参数:


sp_jreconfig "enable", "pca_jvm_netio"

禁用指令和参数

禁用 WORK_DIR 指令。此示例使用部分指令名称,该名称包含的信息必须足以唯一标识相应的指令:


sp_jreconfig "disable", "WORK_DIR"

> 注意</br></p> <p>> 禁用指令会导致其参数表现出禁用时的行为,但不会更改为基本状态。</p> <h4>禁用指令和参数</h4> <p>禁用 pca_jvm_netio 参数:</p> <div class="code-block"><pre><code> sp_jreconfig "disable", "pca_jvm_netio"

禁用指令和参数

禁用 PCA_JVM_WORK_DIR 中的数组元素:


sp_jreconfig "disable", "pca_jvm_work_dir", "/some/path"

需要路径,但不需要权限屏蔽。请参见《Adaptive Server Enterprise 中的 Java》>“使用 Java 访问文件和网络”。

更新字符串、数字和数组参数

更新字符串参数:


sp_jreconfig "update", "pca_jvm_log_filename", "/old/path/filename.log",
	"/new/path/filename.log"

此示例更新 pca_jvm_log_filename 参数的文件位置。

> 注意</br></p> <p>> update 选项不能与指令或开关参数一起使用,因为这些项目无法修改。</p> <h4>更新字符串、数字和数组参数</h4> <p>更新数字参数:</p> <div class="code-block"><pre><code> sp_jreconfig "update", "pca_jvm_min_port", "1026", "2056"

对于存储过程,数字值必须用引号括起来(成为字符串形式)。SAP ASE 服务器将其存储为数字值。

更新字符串、数字和数组参数

对于 PCA_JVM_WORK_DIR 指令,work_dir 值由路径和可选的权限屏蔽组成。虽然权限屏蔽是可选的,但必须包括原始字符串路径才能标识 work_dir。权限屏蔽是可选的。如果不提供权限屏蔽,系统将使用缺省屏蔽(0666 的八进制等效项)。示例 a 没有设置权限屏蔽;它使用缺省屏蔽。示例 b 和 c 均将权限屏蔽设置为 0644:


[a] sp_jreconfig "update", "pca_jvm_work_dir",
"/old/path","/new/working/directory"

[b] sp_jreconfig "update", "pca_jvm_work_dir",
 "/old/path", "/new/working/directory(u=rw,go=r)"

[c] sp_jreconfig "update", "pca_jvm_work_dir",
 "/old/path", "/new/working/directory(u+w,ugo+r)"

添加数组元素

向 PCA_JVM_WORK_DIR 指令中的 pca_jvm_work_dir 参数数组中添加新元素。示例 a 使用缺省屏蔽。示例 b 和 c 均将权限屏蔽设置为 0644。(屏蔽按从左到右的方向求值。)


[a] sp_jreconfig "add", "pca_jvm_work_dir", "/new/working/directory"

[b] sp_jreconfig "add", "pca_jvm_work_dir", "/new/working/directory(u=rw,go=r)"

[c] sp_jreconfig "add", "pca_jvm_work_dir", "/new/working/directory(u+w,ugo+r)"

删除数组元素

删除 pca_jvm_work_dir 中的数组元素:


sp_jreconfig "delete", "pca_jvm_work_dir", "/new/working/directory"

> 注意</br></p> <p>> 若要在 PCA_JVM_WORK_DIR 指令中删除 pca_jvm_work_dir 中的元素,可以指定部分字符串,但提供的字符串必须能标识唯一的记录。不需要权限屏蔽;只需提供路径即可,即使 work_dir 元素最初是使用特定权限屏蔽定义的也不例外。</p> <h4>启用或禁用数组中的所有元素</h4> <p>禁用 pca_jvm_work_dir 数组中的所有元素:</p> <div class="code-block"><pre><code> sp_jreconfig "array_enable", "pca_jvm_work_dir"

启用或禁用数组中的所有元素

禁用 pca_jvm_work_dir 数组中的所有元素:


sp_jreconfig "array_disable", "pca_jvm_work_dir"

清除数组中的所有记录

删除 pca_jvm_work_dir 数组中的所有记录并创建一个空数组:


sp_jreconfig "array_clear", "pca_jvm_work_dir"

重新装载缺省配置值

将存储在 sybpcidb 中的配置值装载到内存中:


sp_jreconfig "reload_config"

用法

使用 sp_jreconfig 时,还存在一些其它注意事项。

启用和禁用像开关一样工作的指令。如果指令: