适用于 z/OS 平台

在 z/OS 上管理 Liberty

在 z/OS® 平台上,可以使用 MVS™ 操作员命令来启动、停止或修改 Liberty。

开始之前

请确保已按在 Liberty for z/OS 上启用 z/OS 授权服务中所述设置以下安全概要文件。
  • 服务器进程和 Angel 进程的 STARTED 概要文件
  • 允许访问授权 z/OS 服务的 SERVER 概要文件
注意: 每个 LPAR 都有一个 Angel 进程。在服务级别 8.5.5.2 或更高级别启动的 Angel 可以与也使用服务级别 8.5.5.2 或更高级别的 Angel 的其他 Liberty for z/OS 服务器共存。对于在同一 LPAR 上运行且服务级别高于和低于 8.5.5.2 并需要一个 Angel 进程的多个 Liberty for z/OS 服务器,需要先启动服务级别为 8.5.5.2 或更高的 Angel 以确保 Angel 进程的正常运行。

关于此任务

本主题描述如何使用 MVS 控制台来启动、修改和停止 Liberty。您也可以从 shell 启动和停止服务器,或使用 shell 将服务器作为启动任务启动,请参阅从命令行启动和停止服务器。

启动任务是为响应操作员 START 命令立即运行的 JCL。wlp/templates/zos/procs 目录中提供了两个 JCL 过程模板 (PROC)。一个模板适用于服务器进程,另一个模板适用于 Angel 进程:
  • 用于 Liberty 的 bbgzsrv。
  • 用于 Angel 进程的 bbgzangl,控制对 z/OS 平台上系统授权服务的访问权时,这是必需项。
管理员可将模板复制到用户位置,然后定制模板以从 MVS 控制台启动 Liberty 服务器。
注: 应用产品更新时,可能会更新 /templates 目录中的文件。
示例部分提供有关两个 PROC 模板的进一步信息。

操作员 STOP 命令的目标是作业或启动任务。

定制 JCL 过程模板后,必须将这些模板放置到系统过程库并置中。过程成员的名称会成为 START 命令的参数。

过程

示例

以下示例显示了服务器进程的过程模板 (bbgzsrv)。此 PROC 在 z/OS proclib 并置内的数据集中。

//BBGZSRV PROC PARMS='defaultServer'
//*------------------------------------------------------------------
//* INSTDIR - the path to the WebSphere Liberty install.
//*           This path is used to find the product code and is
//*           equivalent to the WLP_INSTALL_DIR environment variable
//*           in the Unix shell.
//* USERDIR - the path to the WebSphere Liberty user area.
//*           This path is used to store shared and server specific
//*           configuration information and is equivalent to the
//*           WLP_USER_DIR environment variable in the Unix shell.
//*------------------------------------------------------------------
//  SET INSTDIR='/u/MSTONE1/wlp'
//  SET USERDIR='/u/MSTONE1/wlp/usr'
//*------------------------------------------------------------------
//* Start the Liberty server
//*
//* WLPUDIR - PATH DD that points to Liberty's "user"
//*           directory. If the DD is not allocated, the user
//*           directory location defaults to the wlp/usr directory
//*           in the install tree.
//* STDOUT  - Destination for stdout (System.out)
//* STDERR  - Destination for stderr (System.err)
//* MSGLOG  - Destination for messages.log (optional)
//* STDENV  - Initial Unix environment - read by the system.  The 
//*           installation default and server specific server
//*           environment files will be merged into this environment
//*           before the JVM is launched.
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATSL,REGION=0M,
//  PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS' 
//WLPUDIR  DD PATH='&USERDIR.' 
//STDOUT    DD SYSOUT=*
//STDERR   DD SYSOUT=*
//*MSGLOG   DD SYSOUT=*
//*STDENV   DD PATH='/etc/system.env',PATHOPTS=(ORDONLY) 
//*STDOUT   DD PATH='&ROOT/std.out', 
//*            PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
//*            PATHMODE=SIRWXU 
//*STDERR   DD PATH='&ROOT/std.err', 
//*            PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
//*            PATHMODE=SIRWXU
Notes:
  • 启动程序将 STDENV DD 用作初始环境,但此 DD 是可选的。在 PROC 中定义进程的初始环境。它可以指向 LE 支持的任何类型的数据集,但格式必须与预期内容兼容。例如,EBCDIC,不带扩展的简单“key=value”。
  • 允许指向现有目录(不是文件)的 PATH DD。如果打开该 DD,那么返回的 FILE 流对 fldata 有效,因此可以使用与该 DD 相关联的 HFS 路径。PROC 模板定义用来表示 WLP_USER_DIR 等价项的 WLPUDIR PATH DD。
  • WLP_USER_DIR 由下列逻辑确定:
    • 如果定义了 WLPUDIR DD,那么会将关联的路径用作 WLP_USER_DIR
    • 如果未定义 WLPUDIR,但在初始环境中(通过 STDENV)设置了 WLP_USER_DIR,那么会使用 WLP_USER_DIR
    • 如果未定义 WLPUDIR,并且未在初始环境中设置 WLP_USER_DIR,那么会使用缺省值 $WLP_INSTALL_DIR/usr
  • 环境由下列逻辑确定:
    • 如果定义了 STDENV DD,那么 LE 会将其读取为初始环境。如果要设置 _BPX_BATCH_UMASK 环境变量,那么必须在此处的 STDENV DD 中设置该环境变量。
    • 如果 $WLP_INSTALL_DIR/etc/server.env 存在且可读,那么将读取其“键=值”内容并设置到环境中。文件可以是 ASCII 或 EBCDIC。注释以“#”开头且转至行尾。包含空格的值可括在双引号中。在此文件中指定的任何环境条目会覆盖初始环境中的条目
    • 如果 $WLP_USER_DIR/servers/{serverName}/server.env 存在并可读,那么将读取其“键=值”内容并设置到环境中。此文件也可以是 ASCII 或 EBCDIC,并且支持注释。此处指定的任何条目都会覆盖初始环境和 etc/server.env 中的条目。
    • 不管用户指定的环境如何,都会显式设置以下条目: _BPXK_WLM_PROPAGATE=NO, JAVA_THREAD_MODEL=HEAVY 和 JAVA_PROPAGATE=NO。如果未设置 _EDC_PTHREAD_YIELD,那么它设置为 -2。
  • 设置环境后,JAVA_HOME 由以下逻辑确定:
    • 如果在环境中设置了 JAVA_HOME,那么该环境位置将用作 JAVA_HOME
    • 如果未在环境中设置 JAVA_HOME,但 $WLP_INSTALL_DIR/../java64 存在,那么 $WLP_INSTALL_DIR/../java64 将用作 JAVA_HOME
    • 如果未在环境中设置 JAVA_HOME,并且 $WLP_INSTALL_DIR/../java64 不存在,那么 $WLP_INSTALL_DIR/../java 将用作 JAVA_HOME
  • 确定 JAVA_HOME 后,JVM 命令行选项由以下逻辑确定:
    • 如果 $WLP_USER_DIR/servers/{serverName}/jvm.options 存在并可读,那么将读取其内容。文件可以是 ASCII 或 EBCDIC,并且文件的每一行都必须是单一 Java 命令行参数。注释以“#”开头且转至行尾。
    • 如果 $WLP_USER_DIR/servers/{serverName}/jvm.options 不存在,但 $WLP_INSTALL_DIR/etc/jvm.options 存在并可读,那么将读取其内容。文件可以是 ASCII 或 EBCDIC,并且每一行都必须具有一个 Java 命令行参数。支持注释。
    • 不论任何 jvm.options 的内容如何,-Dfile.encoding=iso8859-1、-javaagent:$WLP_INSTALL_DIR/lib/bootstrap-agent.jar 和 -classpath $WLP_INSTALL_DIR/lib/server-launcher.jar 都在命令行中
  • 如果要将参数传递至 JVM,请定义 JAVAOPTS DD 语句以便从此 DD 读取 Java™ 命令行参数。以下示例显示了样本输入文件:
    -Xmx512m
    -Xms256m
    -Daaa.bbb.ccc=something.forsomeone
  • 如果从过程启动 Liberty 服务器,那么服务器会验证它是否在 umask 为 000 的情况下运行。如果检测到 umask 为 000,那么它会覆盖为值 022。
以下示例显示通过对已配置“defaultServer”使用样本 bbgzsrv 过程来启动 Liberty 的命令:
start bbgzsrv,parms='defaultServer' 
以下示例显示了 Angel 进程的过程模板 (bbgzangl):
//BBGZANGL PROC PARMS='',COLD=N
//*------------------------------------------------------------------
//  SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//STEP1   EXEC PGM=BPXBATA2,REGION=0M,
//  PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD &PARMS'
//STDOUT    DD SYSOUT=*
//STDERR    DD SYSOUT=*

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



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_admin_zos
文件名:twlp_admin_zos.html