DSN_WLM_APPLENV 存储过程

此程序为 Db2 定义、安装和激活新的WLM应用环境提供了便捷的方式。 您也可以使用它来移除WLM应用环境。

环境

DSN_WLM_APPLENV在WLM建立的存储过程地址空间中运行。

授权

要执行CALL DSN_WLM_APPLENV语句，包含CALL语句的程序包或计划的所有者必须在存储过程使用的每个程序包上具有以下一项或多项权限：

  • DSN_WLM_APPLENV存储过程中的EXECUTE权限
  • 存储过程的所有权
  • SYSADM 权限

如果 RACF® 设施类处于活动状态，并且为 MVSADMIN.WLM.POLICY 设施类定义了配置文件，则存储过程的调用者需要以下访问权限：

  • 访问（读取）操作 WLMINFO：
    PERMIT MVSADMIN.WLM.POLICY CLASS(FACILITY) ID(user) ACCESS(READ)
  • ACCESS(UPDATE) 用于操作 ADD、ADD_ACTIVATE、ACTIVATE：
    PERMIT MVSADMIN.WLM.POLICY CLASS(FACILITY) ID(user) ACCESS(UPDATE)

语法

阅读语法图跳过可视化语法图 CALL DSN_WLM_APPLENV ( 操作 , policyID , wlm选项 , 返回码 , 消息 )

过程参数

ACTION
一个VARCHAR(20)类型的输入参数，用于标识要执行的操作类型。 这是一个必填参数，支持以下值：
ACTIVATE
存储过程会激活WLM服务策略。
ADD
该存储过程无需激活服务策略，即可将新的WLM应用环境安装到现有的WLM服务定义中。 新的WLM应用环境只有在下次激活WLM策略时才可用。
ADD_ACTIVATE
存储过程将新的WLM应用程序环境安装到现有的WLM服务定义中，并自动激活WLM服务策略以启用新的WLM应用程序环境。
REMOVE
存储过程从现有的WLM服务定义安装WLM应用程序环境，并安装修改后的服务定义，但不激活它。
删除_激活
存储过程从现有的WLM服务定义中删除WLM应用程序环境，安装修改后的服务定义并激活它。
如果存在则删除
与REMOVE相同，但若要删除的WLM应用环境不存在，则返回代码为4（警告），而非8（错误）。
REMIFEXISTS_ACTIVATE
与 REMOVE_ACTIVATE 相同，但若要删除的 WLM 应用程序环境不存在，则返回代码为 4（警告），而非 8（错误）。
WLMINFO
存储过程查询现有的WLM服务定义并返回基本信息。 返回的信息示例包括：
  • 服务定义名称
  • 安装服务定义的当地时间时间戳
  • 安装服务定义的服务管理员的用户ID
  • 安装服务定义的系统名称
  • 当前定义的应用环境数量
如果指定了除ACTIVATE或WLMINFO以外的任何操作，则还需要输入参数WLOPTIONS。
POLICYID
一个VARCHAR(8)类型的输入参数，用于标识要激活的WLM服务策略。 长度可为1-8个字符，或输入单词“ACTIVE”。 如果指定的保单为“有效”，则使用有效保单。 如果指定了以下任何操作，则必须填写此参数：
  • ACTIVATE
  • 添加_激活
  • 删除_激活
  • REMIFEXISTS_ACTIVATE

否则，它将被忽略，并设置为NULL或空字符串。

WLMOPTIONS
VARCHAR(4000)类型的输入参数。

如果指定了以下任何操作，且其他WLM参数无效，则必须使用此参数和WLMNAME参数：

  • ADD
  • 添加_激活
  • REMOVE
  • 删除_激活
  • 删除_I
  • REMIFEXISTS_ACTIVATE

支持以下WLM选项。 多个选项之间使用一个或多个空格隔开。

WLMNAME（名字 ）
WLMNAME是应用程序环境的定义名称。 长度为1-32个字符。 它不能以字母SYS开头。 这是必需选项。
DESCRIPTION（描述 ）
描述区（DESCRIPTION）用于描述应用程序环境，最多可输入32个字符。 此选项并非必需，可设置为空值。 例如，
DESCRIPTION()
PROCNAME（程序名称 ）
PROCNAME定义了WLM用于启动应用程序环境服务器地址空间的JCL程序。 长度为1-8个字符。 这是必需选项。
STARTPARM（启动参数 ）
STARTPARM包含WLM用于启动JCL程序的参数。 参数最多可输入115个字符。 如果参数中包含子系统名称，可以使用符号&IWMSSNM来让WLM替换子系统名称，而无需直接键入子系统名称。 此选项非常有用，因为具有不同名称的子系统的多个实例可以使用应用程序环境。 例如：
STARTPARM(DB2SSN=&IWMSSNM,APPLENV=WLMENV1,NUMTCB=1)
此选项并非必需，可设置为空值。
WLMOPT(WLM_MANAGED|SINGLE_SERVER)
WLMOPT 命令 WLM 限制服务器地址空间的数量。 例如，如果服务器地址空间需要独占使用资源，则只能存在一个地址空间。 对于 Db2 例程，如果例程需要，您可以将每个系统的地址空间限制为1。 请注意，如果给定系统中有多个 Db2 子系统，WLM将为每个调用例程的 Db2 子系统创建1个服务器。 每个系统单元的地址空间限制不适用于 Db2 例程。

此选项并非必需，可设置为空值。 默认值为WLM_MANAGED。

示例

示例：返回WLM服务定义的基本信息
CALL SYSPROC.DSN_WLM_APPLENV('WLMINFO', NULL, NULL, ?, ?)
以下是输出示例：
RETURN_CODE: 0
MESSAGE: DSNT051I DSNTWLMS ACTIVE WLM SERVICE DEFINITION
           SERVICE DEFINITION NAME     WLMSAMPL
           INSTALLED ON                2010-01-25-07.11.57.764052
           INSTALLED BY                SYSADM
           INSTALLED FROM              LABEC130
           NUMBER OF APPL ENVIRONMENT  12
DSNT023I DSNTWLMS DISPLAY WLM INFORMATION SUCCESSFUL
示例：确定操作和WLM选项
CALL SYSPROC.DSN_WLM_APPLENV('ADD_ACTIVATE',
                             'ACTIVE',
                             'WLMNAME(DSNWLM_SAMPLE)
                              DESCRIPTION(DB2 SAMPLE WLM ENVIRONMENT)
                              PROCNAME(DSNWLMS)
                              STARTPARM(DB2SSN=&IWMSSNM,APPLENV=''DSNWLM_SAMPLE'')
                              WLMOPT(WLM_MANAGED)', ?, ?)
以下是输出示例：
RETURN_CODE: 0
MESSAGE: DSNT023I DSNTWLMS ADD WLM APPLICATION ENVIRONMENT DSNWLM_SAMPLE SUCCESSFUL

 APPLICATION ENVIRONMENT NAME : DSNWLM_SAMPLE
 DESCRIPTION                  : DB2 SAMPLE WLM ENVIRONMENT
 SUBSYSTEM TYPE               : DB2
 PROCEDURE NAME               : DSNWLMS
 START PARAMETERS             : DB2SSN=&IWMSSNM,APPLENV='DSNWLM_SAMPLE'

STARTING OF SERVER ADDRESS SPACES FOR A SUBSYSTEM INSTANCE:
  (x) MANAGED BY WLM
  ( ) LIMITED TO A SINGLE ADDRESS SPACE PER SYSTEM
  ( ) LIMITED TO A SINGLE ADDRESS SPACE PER SYSPLEX

  DSNT023I DSNTWLMS ACTIVATE WLM POLICY WLMPOLY1 SUCCESSFUL