检索有关系统启动时使用的系统初始化参数的信息

您可以使用 CICSPlex® SM API 发现有关系统启动时使用的 CICS® 系统初始化参数和系统初始化参数重载的信息。 CICSPlex SM 命令级界面、CICS 管理客户端界面 (CMCI) 和 CICSPlex SM Web 用户界面 (WUI) 都支持系统初始化参数检索。

注: CICSPlex SM API 仅检索在系统启动时指定的系统初始化参数，而不显示当前的活动系统值。
检索参数时，您具有以下选项:
  • 您可以检索与任何指定覆盖值组合的系统初始化参数。
  • 您可以检索在系统启动时指定的原始系统初始化参数值。
  • 您可以从单个覆盖源检索值。

与许多其他 CICSPlex SM 操作一样，您可以通过指定上下文和作用域来控制检索操作所针对的 CICS 区域。

系统初始化参数检索是使用 CICSPlex SM 资源 SYSPARM 实现的。 SYSPARM 资源具有与 GET 操作关联的两个必需参数 PARMSRCE 和 PARMTYPE。 您可以使用这些参数来指定要根据其源检索的参数。

您可以通过以下方式实现系统初始化参数发现:
  • 在 CICS Explorer® SM 业务观点 > 地区视图 中。 右键单击区域，然后选择 显示 SIT 参数。
  • 在 API 程序中，使用在 SYSPARM 对象上运行的 EXEC CPSM GET 命令。
  • 使用在 CICSSystemParameter 外部资源上运行的 CMCI GET 方法。
  • 使用基于从 CICS 区域视图集链接的 SYSPARM 资源表的 WUI 操作视图。
使用 EXEC CPSM GET 命令或 CMCI 时，可以使用 PARMSRCE 和 PARMTYPE 来定义参数表达式，以指定要检索的参数。 在 WUI 中，可以使用 PARMSRCE 和 PARMTYPE 作为过滤器来控制显示的记录。 这两个参数都是必需的。 对于 PARMTYPE，必须指定值 SIT。 对于 PARMSRCE，请指定下列其中一个选项:
组合
原始系统初始化参数定义与任何已应用参数覆盖的组合
CONSOLE
在系统控制台上启动时指定的覆盖参数
JCL
覆盖通过 JCL EXEC PGM 语句提供的参数
SYSIN
覆盖 SYSIN 数据集中定义的启动作业流中的参数
TABLE
从 DFHSITxx 装入模块中抽取的原始系统初始化表值

参数和覆盖值按 SYSPARM 资源表的 KEYWORD 属性的顺序返回，而不考虑它们在源中的顺序，例如 SYSIN 数据集。

系统参数值可以超过 255 个字节。 在这些情况下，参数值将拆分为多条记录，每条记录最多包含 255 个字节的参数值。 每条记录都具有唯一的段号 (可用于正确对记录进行排序) ，包含此参数值的段数的总段号，以及包含加在一起的段长度的总长度字段。

必须确保要检索的系统初始化参数在 CICS 启动时对 CICS 区域有效。 如果在启动时从控制台更正了无效参数值，那么检索操作的行为可能不一致。 某些参数显示更正后的值，而其他参数显示其原始值。 此外，对于某些更正的值，可能会将系统参数源位置作为控制台返回，而不是作为原始源位置返回。

示例

以下 CMCI 请求检索为 CICSplex MYPLEX中的区域 REGION 设置的控制表后缀的值。

/CICSSystemManagement/CICSSystemParameter/<MYPLEX>/<REGION>?PARAMETER=PARMSRCE(COMBINED)
%20PARMTYPE(SIT)&CRITERIA=KEYWORD%3D++T%20AND%20NOT%20KEYWORD%3DMXT