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>
指定列表的类型。其值包括:
<units_type> 以及各自所属指令
units
与 list 搭配使用时,生成当前使用的 <units_type> 的列表。
<units_type>
是参数的类型。每个参数都有一个标识其类型的 <units_type>。其值包括:
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 时,还存在一些其它注意事项。
启用和禁用像开关一样工作的指令。如果指令:
参数可以分别启用或禁用。参数类型为:
可按需启用或禁用数组参数;无需先删除值随后再重新输入。
pca_jvm_module_path 配置 JVM 共享对象库的路径。如果使用的 JRE 不是 SAP 提供的,则必须将此参数配置为指向可由 PCA/JVM 访问的位置。这可以是绝对路径,也可以是扩展 $SYBASE 的相对路径。如果是绝对路径,则路径应以“/”(在 UNIX 上)或“\”(在 Windows 上)开头。否则,SAP ASE 服务器将采用相对路径并在 $SYBASE 下进行查找。</p>
<table>
<p><tr></p>
<p><th>参数</th></p>
<p><th>单元类型</th></p>
<p><th>缺省值</th></p>
<p><th>缺省状态</th></p>
<p><th>说明</th></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_module_path</td></p>
<p><td>string</td></p>
<p><td>因平台而异</td></p>
<p><td>已启用</td></p>
<p><td>JVM</td></p>
<p><td>共享库的位置,使用 $SYBASE 下的相对路径或完全限定的文件名。</td></p>
<p></tr></p>
<p></table></p>
<h4>表 2:pva_jvm_opt.</h4>
<p>此表描述了 pva_jvm_opt。</p>
<p>> 注意</br></p>
<p>> 除非有 SAP 技术支持部门的指导,否则不要更改缺省值。</p>
<table>
<p><tr></p>
<p><th>参数</th></p>
<p><th>单元类型</th></p>
<p><th>缺省值</th></p>
<p><th>缺省状态</th></p>
<p><th>说明</th></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_abort</td></p>
<p><td>switch</td></p>
<p><td>打开</td></p>
<p><td>已启用</td></p>
<p><td>一旦失败即中止全部 abort(2)。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_allow_unchecked_sockops</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已禁用</td></p>
<p><td>允许执行未选中的套接字操作。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_debug</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已禁用</td></p>
<p><td>报告 PCA_DEBUG 请求。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_except</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已启用</td></p>
<p><td>报告除 PCA/VM JNI/JVM 调用之外的信息。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_heap_ratio</td></p>
<p><td>string</td></p>
<p><td>0.3</td></p>
<p><td>已启用</td></p>
<p><td>VM</td></p>
<p><td>堆/PCI 内存比。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_jvmti</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已禁用</td></p>
<p><td>Java VM 工具接口。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_min_port</td></p>
<p><td>number</td></p>
<p><td>1026</td></p>
<p><td>已启用</td></p>
<p><td>允许 VM 网络支持。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_netio</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已禁用</td></p>
<p><td>允许 VM 网络支持。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_report</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已禁用</td></p>
<p><td>报告 PCA/VM JNI/JVM 调用。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_security_manager_enabled</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已禁用</td></p>
<p><td>在 PCA/JVM 中启用 SecurityManager。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_density</td></p>
<p><td>number</td></p>
<p><td>100</td></p>
<p><td>已启用</td></p>
<p><td>PCA/VM 签名高速缓存目标密度。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_enabled</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已启用</td></p>
<p><td>启用 PCA/VM 签名高速缓存。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_fixed_ratio</td></p>
<p><td>number</td></p>
<p><td>50</td></p>
<p><td>已启用</td></p>
<p><td>PCA/VM 签名高速缓存的大小(固定百分比)。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_freeboard</td></p>
<p><td>number</td></p>
<p><td>30</td></p>
<p><td>已启用</td></p>
<p><td>高速缓存扫描时的 PCA/VM 签名高速缓存空间恢复百分比。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_size</td></p>
<p><td>number</td></p>
<p><td>512</td></p>
<p><td>已启用</td></p>
<p><td>PCA/VM 签名高速缓存的大小,单位为 KB。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_size_type</td></p>
<p><td>number</td></p>
<p><td>1</td></p>
<p><td>已启用</td></p>
<p><td>PCA/VM 签名高速缓存 size_type 0:AS_PCT 1:Kbyte 2:Mbyte。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_washcycle</td></p>
<p><td>number</td></p>
<p><td>1000</td></p>
<p><td>已启用</td></p>
<p><td>PCA/VM 签名高速缓存清晰守护程序周期时间 (ms)。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_sigcache_washdaemon</td></p>
<p><td>switch 不适用</td></p>
<p><td>已禁用</td></p>
<p><td>启用</td></p>
<p><td>PCA/VM 签名高速缓存清洗守护程序。</td></p>
<p></tr></p>
<p><tr></p>
<p><td>pca_jvm_strace</td></p>
<p><td>switch</td></p>
<p><td>不适用</td></p>
<p><td>已启用</td></p>
<p><td>对非模拟 VM 处理生成堆栈跟踪。</td></p>
<p></tr></p>
<p></table></p>
<h4>表 3:pca_jvm_dir_options.</h4>
<p>pca_jvm_dir_options 将配置 JVM 对 ROOT 和 TEMP 目录使用的目录定义。除非您是资深用户或有 SAP 技术支持部门的指导,否则不要更改这些值。</p>
<p>> 警告</br></p>
<p>> 使用此指令时应十分谨慎。PCA_JVM_DIR_OPTIONS 指令中的 pca_jvm_tmp_dir 应始终指向系统临时目录。更改此位置可能会带来重大安全风险。JVM 允许打开文件以执行读写操作,并允许在该目录中创建文件。`
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_root_dir | string | 因平台而异 | 已启用 | 系统根目录的绝对路径。是文件 I/O 所必需的。 |
| pca_jvm_tmp_dir | string | 因平台而异 | 已启用 | 系统临时目录的绝对路径。是文件 I/O 所必需的。 |
pca_jvm_work_dir 配置 JVM 信任的目录。此参数由文件系统中的特定位置集合组成,在这些位置中,Java 程序类可执行某些文件 I/O 操作。每个目录均可具有可选的权限屏蔽来定义各目录中允许的文件 I/O 操作。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_work_dir array | 因平台而异 | 已禁用 | 允许 | JVM 在其中执行文件 I/O 的绝对路径(和可选的权限屏蔽)。 |
pca_jvm_min_jni_version 配置最低的向后兼容 JNI 版本。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_min_jni_version | string | 'JNI_VERSION_1_2' | 已启用 | 最低的向后兼容 JNI 版本。 |
pva_jvm_logging 配置 JRE/VM 记录选项。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_ase_logging | switch | 不适用 | 已启用 | 配置 SAP ASE 记录。 |
| pca_jvm_log_filename | string | '/tmp/Java_vm.log1' | 已禁用 | VM 用于记录的完全限定文件名。 |
pca_jvm_ext_class_loader 配置全局和数据库扩展类装载程序。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_ext_class_loader_global | array | 无 | 已禁用 | 全局扩展类装载程序。 |
| pca_jvm_ext_class_loader_dbase | array | 无 | 已禁用 | 数据库扩展类装载程序。 |
pva_jvm_java_options 配置正常和扩展的 Java 启动选项。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_java_options | array | "-Djava.awt.headless=true" | 已启用 | 以随机模式运行 Java。 |
| pca_jvm_java_options | array | "-Djava.compiler=JIT" | 已启用 | 强制 JIT 编译和优化。 |
| pca_jvm_java_options | array | "-XX:+CITune:" | 已禁用 | JIT 编译器(仅限 1.4)所花的时间。 |
| pca_jvm_java_options | array | "-XX:+Use AltSigs" | 已禁用 | 此选项似乎会使 J2SE 崩溃。 |
| pca_jvm_java_options | array | "-XX:CodeCacheExpansionSize=512000" | 已启用 | 代码高速缓存扩展大小。 |
| pca_jvm_java_options | array | "-Xbatch" | 已禁用 | 禁用的后台编译。 |
| pca_jvm_java_options | array | "-Xcheck:jni" | 已启用 | 对 JNI 函数执行附加检查。 |
| pca_jvm_java_options | array | "-Xfuture" | 已禁用 | 执行严格检查,预测未来缺省值。 |
| pca_jvm_java_options | array | "-Xincgc" | 已禁用 | 启用增量碎片收集。 |
| pca_jvm_java_options | array | "-Xint" | 已禁用 | 仅以解释模式执行。 |
| pca_jvm_java_options | array | "-Xloggc:./myGClog" | 已禁用 | 将 GC 状态和时间戳记录到文件中。 |
| pca_jvm_java_options | array | "-Xmixed" | 已禁用 | 混合模式执行(缺省设置)。 |
| pca_jvm_java_options | array | "-Xms64m" | 已禁用 | 设置初始 Java 堆大小。 |
| pca_jvm_java_options | array | "-Xmx64m" | 已禁用 | 设置最大 Java 堆大小。 |
| pca_jvm_java_options | array | "-XnoClassgc" | 已禁用 | 禁用类碎片收集。 |
| pca_jvm_java_options | array | "-Xprof" | 已禁用 | 输出 CPU 分析数据。 |
| pca_jvm_java_options | array | "-Xrs" | 已禁用 | 减少 Java/VM 对 OS 信号的使用。 |
| pca_jvm_java_options | array | "-Xshare:auto" | 已禁用 | 配置共享类数据(设置为 auto、off 或 on)。 |
| pca_jvm_java_options | array | "-Xss64m" | 已禁用 | 设置 Java 线程堆栈大小。 |
| pca_jvm_java_options | array | "-XX:MaxPermSize" | 已禁用 | 设置永久堆的最大大小 |
| pca_jvm_java_options | array | "-enablesystemassertions" | 已启用 | 启用 Java/VM 系统断言 - 仅适用于使用 Sun HotSpot (TM) JavaVM 的平台。 |
| pca_jvm_java_options | array | "-esa" | 已启用 | 启用所有系统断言 - 仅适用于使用 Sun HotSpot (TM) JavaVM 的平台。 |
| pca_jvm_java_options | array | "-verbose:class" | 已禁用 | 在 JRE/VM 内部装载类。 |
| pca_jvm_java_options | array | "-verbose:gc" | 已禁用 | 碎片收集统计信息。 |
| pca_jvm_java_options | array | "-verbose:jni" | 已禁用 | Java 本地接口(JNI)调用。 |
pva_jvm_java_dbg_agent_port 配置 Java VM 调试代理端口号(用于通过 Java 调试程序调试 Java 应用程序)。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|---|---|---|---|
| pca_jvm_java_dbg_agent_port | number | 8000 | 已禁用 | 配置端口号和 Java VM 调试代理。 |
| pca_jvm_java_dbg_agent_suspend | switch | 不适用 | 已禁用 | 启用时开始挂起 Java VM 调试代理。 |
pca_jvm_sys_device_path 配置特定于平台的系统设备目录(在 Solaris 上需要)。
| 参数 | 单元类型 | 缺省值 | 缺省状态 | 说明 |
|---|
|pca_jvm_sys_device_path| array |因平台而异| 因平台而异 |Sun OS 的内部系统选项。请勿更改。|