创建、编辑和删除 WebSphere 变量

可使用 WebSphere 变量为产品配置文件中包含的任何字符串数据类型属性提供设置。

开始之前

因为应用程序无法直接访问 WebSphere 变量,所以,如果您在应用程序中定义 WebSphere 变量,那么将返回诸如“变量未知”之类的错误消息。如果需要从应用程序中引用 WebSphere 变量,请在该应用程序中包括以下方法,以便将使用了 WebSphere 变量的字符串展开:

避免故障 避免故障: 展开 WebSphere 变量需要您具有管理特权。gotcha
private String expandVariable(String s) throws
javax.management.JMException {  
com.ibm.websphere.management.AdminService as = 
com.ibm.websphere.management.AdminServiceFactory.getAdminService 
();  

String server = as.getProcessName();  

java.util.Set result = as.queryNames(new javax.management.ObjectName("*:*,type=AdminOperations,process=" 
+ server), null);  

return (String)as.invoke((javax.management.ObjectName) 
result.iterator().next(),"expandVariable",new Object[] 
{"${"+s+"}"}, new String[] {"java.lang.String"});
同样,如果要使用脚本命令来展开 WebSphere 变量,那么可以在脚本文件中包括以下代码行。
  • 使用 Jacl:
    set mbean [$AdminControl completeObjectName WebSphere:*,type=AdminOperations]
    $AdminControl invoke $mbean expandVariable {{"${APP_INSTALL_ROOT}"}}
  • 使用 Jython:
    AdminOperations = AdminControl.completeObjectName('WebSphere:*,type=AdminOperations')
    print AdminControl.invoke(AdminOperations, 'expandVariable', '${APP_INSTALL_ROOT}')

关于此任务

WebSphere 变量通常用于指定文件路径。“变量设置”主题提供了有关指定变量的更多详细信息,并着重描述了有关使用变量的产品组件的更多详细信息。

WebSphere 变量还用于配置以下各项:
  • 产品路径名,例如 JAVA_HOME 和 APP_INSTALL_ROOT。
  • 配置特定单元范围或集群范围定制值。
  • [z/OS]位置服务。
  • [z/OS]环境变量。

WebSphere 变量的变量范围限定机制使您能够在节点、集群或单元级别以及服务器级别定义变量。此机制使您能够为节点、集群或单元中的所有服务器指定一种设置,而不必为每个服务器分别指定该设置。

要定义新变量、更改现有变量的值或者删除现有变量,请完成下列相应步骤。

过程

  1. 在管理控制台中,请单击环境 > WebSphere 变量
  2. 从可用范围的列表中选择变量的范围。

    如果您创建新变量,那么将在所选范围中进行创建。如果在多个级别定义同一个变量,那么细化的定义将覆盖高级别的设置。例如,如果在单元级别和节点级别指定了同一个变量,那么节点级设置将覆盖单元级设置。

    在测试数据源对象时,限定变量的范围尤其重要。变量范围限定可导致数据源测试连接失败但运行时却成功,或者通过测试连接但运行时却失败。

  3. 创建新变量。
    1. 单击新建
    2. 指定变量的名称、值以及描述(可选)。

      [z/OS]应用程序服务器将 WebSphere® Application Server 内部变量用于其自身用途。表明变量是内部变量的前缀为 WAS_DAEMON_<server custom property>WAS_DAEMON_ONLY_<server custom property>WAS_SERVER_ONLY_<server custom property>。任何带这些标记的变量都不是要供您使用的。专门保留他们,以供服务器运行时使用。修改这些变量可能会导致意外错误。

      [z/OS]可以使用 WebSphere 变量来修改守护程序配置。通过追加服务器定制属性到守护程序标记,您可以特别为该守护程序指定变量。在名称字段中输入 DAEMON_<server custom property>。例如,如果您在“名称”字段中输入 DAEMON_ras_trace_outputlocation,而在“值”字段中输入 SYSOUT,您可以将该特定守护程序的跟踪输出导向 SYSPRINT。

      您可以创建支持替换的 WebSphere 变量。例如,如果在名称字段中输入 ${<variable name>},那么 <variable name> 的值将成为新 WebSphere 变量的名称。例如,如果输入 ${JAVA_HOME} 作为变量名,那么所创建的 WebSphere 变量的名称将是 Java™ 主目录。

    3. 单击确定
    4. 在管理控制台导航窗格中,单击环境 > WebSphere 变量,然后验证该变量是否已显示在所选范围的变量列表中。

      管理控制台不会采纳输入错误。如果错误地引用了此变量,就会忽略此变量。

  4. 修改现有变量的设置。
    1. 单击要更改的变量的名称。
    2. 修改“值”字段的内容。

      您在安装产品时定义的一些变量的“值”字段处于只读状态,这是因为,更改对那些变量指定的值可能会引起产品处理错误。

    3. 单击确定
  5. 删除现有的变量。
    1. 选择要删除的变量。
    2. 单击删除
    3. 单击确定
    4. 验证是否已从所选范围的变量列表中移除此变量。
  6. 保存配置。
  7. 停止受影响的服务器,然后再次将其启动以使变量配置更改生效。

    如果所作的更改影响节点,那么必须停止并重新启动该节点上的所有服务器。同样,如果所作的更改影响单元,那么必须停止并重新启动该单元中的所有服务器。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcws_variable
文件名:tcws_variable.html