用于使用 BAS 来安装 CICS 定义的参数

您可以使用 CICSPlex SM 在支持 EXEC CICS CREATE 命令的 CICS 系统中安装 CICS ® 定义对象。

可以通过以下方式安装由 CICS 定义表示的 CICS 资源:
  • 单独对 CICS 定义对象 (例如 CONNDEF) 使用 INSTALL 操作。
  • 作为资源组的一部分，对 RESGROUP 对象使用 INSTALL 操作。
  • 作为资源描述的一部分，对 RESDESC 对象使用 INSTALL 操作。
INSTALL 操作的语法 (随支持该操作的每个资源表一起显示) 与每个安装方法的语法基本相同。 可以使用以下部分或全部参数:
分配
(可选) 安装资源组时，指定要用于安装的资源分配 (RASGNDEF) 的名称。
条件
(可选) 安装资源组时，请标识要用于选择要安装的资源的属性。 CICSPlex SM 只处理那些符合指定过滤条件的资源。
过滤表达式可以由以下格式的一个或多个属性表达式组成:

过滤表达式

读取语法图跳过可视语法图 logic_expr  .
逻辑表达式
读取语法图跳过可视语法图AND/ORNOTattr_expr(logic_expr)
属性表达式
读取语法图跳过可视语法图attr操作值
其中：
attr
是资源定义中属性的名称。

您可以在一个过滤器表达式中多次指定相同的属性。

注: 不能在过滤器表达式中指定 EYU_CICSNAME 或 EYU_CICSREL 属性。
操作
是下列其中一个比较运算符:
<
小于
<=
小于或等于
=
等于
>=
大于或等于
>
大于
¬=
不等于
值
正在测试属性的值。 该值必须是 CICSPlex SM 资源表属性的有效值。
如果属性接受字符数据，那么此值可以是通用值。 通用值可以包含:
  • 星号 (*) 表示任意数目的字符，包括零。 星号必须是指定值中的最后一个或唯一字符。 例如：
      TRANID=PAY*
  • 加号 (+) ，表示单个字符。 + 可以出现在指定值中的一个或多个位置。 例如：
      TRANID=PAY++96
如果该值包含嵌入的空格或特殊字符 (例如句点，逗号或等号) ，那么必须将整个值字符串括在单引号中。 例如：
  TERMID=‘Z AB'
要在值中包含单引号或撇号，必须重复该字符，如下所示:
  DESCRIPTION=‘October''s Payroll'
AND/OR
使用逻辑运算符 AND 和 OR 将属性表达式组合到复合逻辑表达式中，如下所示:
  attr_expr AND attr_expr.
过滤表达式从左到右进行求值。 您可以使用括号来改变过滤表达式的含义。 例如，以下表达式:
  attr_expr AND (attr_expr OR attr_expr).
具有与以下含义不同的含义:
  (attr_expr AND attr_expr) OR attr_expr.
非
对一个或多个属性表达式求反。
您可以对单个属性表达式求反，如下所示:
  NOT attr_expr
您还可以对多个属性表达式求反，甚至可以对整个过滤表达式求反，如下所示:
  NOT (attr_expr OR attr_expr).
请注意，必须在要求反的属性表达式 (或过滤表达式) 周围放置括号。
强制
(可选) 指定 YES 或 NO 以指示是否要安装资源 (即使该资源已存在)。 YES 是缺省值。

如果指定 NO ，那么该定义将安装在其当前不存在的任何位置。 CICSPlex SM 检查资源当前是否安装在 CICS 系统中。 如果是这样，那么 CICSPlex SM 不会安装新资源，以避免无意中更改活动资源的属性。

如果指定 YES，CICSPlex SM 会忽略对重复资源的检查，并无条件地安装新资源。

MODE
(可选。 使用分配参数安装 RESGROUP 时，请参阅 在指定 ASSIGNMENT 时安装 RESGROUP。) 对于某些资源类型，CICSPlex SM 需要额外的信息以确定为完成安装，需要使用资源属性的哪个子集。 您应该指定的 MODE 值取决于要安装的资源类型:
程序定义 (PROGDEF)
如果在 "使用情况" 字段中指定了 REMOTE ，那么可以确定程序的路由方式:
戴不结盟运动
程序由动态路由程序 (DTR) 处理。
STAT
将程序发送到 "相关作用域" 中标识的远程 CICS 系统
事务定义 (TRANDEF)
如果指定了 USAGE 为 REMOTE ，那么必须标识远程引用的类型:
戴不结盟运动
事务应由动态事务路由 (DTR) 程序处理。
STAT
应该将每个事务发送到事务定义 (TRANDEF) 中标识的远程系统。
您在此处指定的值将覆盖 TRANDEF 中的动态值。
瞬时数据队列定义 (TDQDEF)
您可以标识要安装的瞬时数据队列的类型:
INTRA
分区内 TDQ。
EXTRA
分区外 TDQ。
印度
间接 TDQ。
如果未指定 MODE 参数，那么 CICSPlex SM 将使用 TDQDEF 中的 "类型" 值来安装瞬时数据队列。 如果类型值为 REMOTE ，那么 CICSPlex SM 会安装间接 TDQ。
通知
(可选) 指定在尝试安装资源之前应执行的检查类型:
否
不执行任何检查。
INACTIVE
检查目标作用域中当前未处于活动状态的 CICS 系统。
RELEASE
检查目标作用域中不支持 EXEC CICS CREATE 命令的 CICS 系统。
full
执行 INACTIVE 和 RELEASE 检查。
OVERRIDE
(可选。 使用分配参数安装 RESGROUP 时，请参阅 在指定 ASSIGNMENT 时安装 RESGROUP。) 标识在一个或多个指定作用域中安装时要修改其值的指定资源的属性。 (OVERTYPE 值确定覆盖值应用于的作用域。)
覆盖表达式可以由以下格式的一个或多个属性表达式组成:

覆盖表达式

读取语法图跳过可视语法图 ,attr=值  .
其中：
attr
是资源定义中可修改属性的名称。
值
是要将属性设置为的值。 存在下列限制：
  • 该值必须是该属性的有效值。
  • 如果该值包含嵌入的空格或特殊字符 (例如句点，逗号或等号) ，那么必须将整个值字符串括在单引号中，如下所示:
      DESCRIPTION=‘Payroll.OCT'
  • 要在值中包含单引号或撇号，必须重复该字符，如下所示:
      DESCRIPTION=‘October''s Payroll'
概述类型
(可选。) 如果计划为安装指定 OVERRIDE 表达式，请指示应将覆盖值应用于的作用域:
TARGET
仅将覆盖值应用于 TARGET 作用域。
相关
仅将覆盖值应用于 RELATED 作用域。
两者都
将覆盖值应用于 TARGET 和 RELATED 作用域。
NONE
不应用任何覆盖值。
重新分配
(安装 CONNDEF 时必需) 标识应用于相关会话定义 (SESSDEF) 的资源分配 (RASGNDEF)。 对于每个连接定义， CICSPlex SM 都需要一个或多个会话定义来正确构造实际 CICS 连接。
相关
(必需，如果 USAGE 为 REMOTE。 使用分配参数安装 RESGROUP 时可选。 请参阅 在指定 ASSIGNMENT 时安装 RESGROUP。) 指定要将标识为 REMOTE 的资源安装为 LOCAL 的现有 CICS 系统或 CICS 系统组的名称。
RESTYPE
(安装 RESGROUP 时必需) 指定要安装的资源类型，作为以下 CICS 定义对象之一:
请注意，无法直接安装会话定义 (SESSDEF)。 它们与其关联的连接定义 (CONNDEF) 一起安装
统计信息 (STATECHK)
(可选) 指定 YES 或 NO 以指示在发出 EXEC CICS CREATE 命令之前是否检查资源的存在和操作状态。 如果指定 YES 并且一个或多个资源未处于所需状态，那么不会对任何所选资源发出 EXEC CICS CREATE COMMAND 。 FORCEINS 和 STATECHK 参数都必须设置为 YES 才能执行检查。
TARGET
(必需，但使用分配参数安装 RESGROUP 时除外。 请参阅 在指定 ASSIGNMENT 时安装 RESGROUP。) 指定要将资源安装到其中的现有 CICS 系统或 CICS 系统组的名称。
USAGE
(必需，但使用分配参数安装 RESGROUP 时除外。 请参阅 在指定 ASSIGNMENT 时安装 RESGROUP。) 指定将如何使用资源:
LOCAL
资源包含在目标 CICS 系统中。 LOCAL 对所有受支持的资源类型都有效。
REMOTE
资源定义是指安装在其他 CICS 系统中的资源。 如果指定 REMOTE ，那么还必须指定 RELATED 值以标识包含资源的本地实例的 CICS 系统。 REMOTE 仅对以下资源类型有效:
  • FILEDEF
  • PROGDEF
  • TDQDEF
  • TRANDEF