使用 CMCI 查询系统初始化参数

您可以使用在 CICSSystemParameter 外部资源上运行的 CMCI GET 请求来发现有关系统初始化参数及其覆盖的信息。

开始之前

您必须具有与 CMCI 的连接; 有关更多信息，请参阅 设置 CICS Explorer的访问权。

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

关于此任务

CMCI 请求可以检索系统初始化表参数和/或系统初始化表覆盖。

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

请完成以下步骤，以检索有关系统初始化参数及其覆盖的信息。

过程

  1. 使用 HTTP GET 方法并指定 CICSSystemParameter 作为资源名称来形成 CMCI 请求。
    1. 使用 context 和 scope 参数可指定要对其执行请求的 CICS 区域。
    2. 在 URI 中，使用包含参数 PARMSRCE 和 PARMTYPE 的参数表达式来指定要检索的参数或覆盖。
      这两个参数都是必需的。 对于 PARMTYPE，必须指定值 SIT。 对于 PARMSRCE，请指定下列其中一个选项:
      组合
      原始系统初始化表定义与任何应用的参数覆盖的组合
      CONSOLE
      在系统控制台上启动时指定的覆盖参数
      JCL
      覆盖通过 JCL EXEC PGM 语句提供的参数
      SYSIN
      覆盖 SYSIN 数据集中定义的启动作业流中的参数
      TABLE
      从 DFHSITxx 装入模块中抽取的原始系统初始化表值
    有关 GET 请求的更多信息，请参阅 CICS 管理客户机接口 GET 请求。
  2. 提交 CMCI 请求。
    参数和覆盖值按 SYSPARM 资源表的 KEYWORD 属性的顺序返回，而不考虑它们在源中的顺序，例如 SYSIN 数据集。

    此行为可能会对覆盖参数组合产生意外结果: SPCTR 和 SPCTRxx以及 STNTR 和 STNTRxx ，因为指定这些对的顺序很重要。 例如，如果指定 SPCTRAP=ALL 后跟 SPCTR=OFF，那么 SPCTRAP 跟踪不可用，但如果指定 SPCTR=OFF 后跟 SPCTRAP=ALL，那么 SPCTRAP 跟踪可用。 但是，针对 SYSPARM 资源的请求始终返回 SPCTR 早于 SPCTRxx。

示例

  • 此请求检索为 CICSplex MYPLEX中的区域 REGION 设置的控制表后缀的值。
    /CICSSystemManagement/CICSSystemParameter/<MYPLEX>/<REGION>?PARAMETER=PARMSRCE(COMBINED)
%20PARMTYPE(SIT)&CRITERIA=KEYWORD%3D++T%20AND%20NOT%20KEYWORD%3DMXT
    请求会返回结果摘要和大量匹配记录，例如:
    <resultsummary api_response1="1024" api_response2="0" api_response1_alt="OK" api_response2_alt="" 
recordcount="10" displayed_recordcount="10" />
<records>
<cicssystemparameter _keydata="C3D3E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="CLT" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="NO" valuelen="2" />
< cicssystemparameter _keydata="C6C3E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="FCT" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="NO" valuelen="2" />
<cicssystemparameter _keydata="D4C3E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="MCT" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="NO" valuelen="2" />
<cicssystemparameter _keydata="D4E7E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="MXT" segnum="1" segtot="1" source="SYSIN" 
totallen="3" type="SIT" value="100" valuelen="3" />
<cicssystemparameter _keydata="D9E2E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="RST" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="NO" valuelen="2" />
< cicssystemparameter _keydata="E2C9E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="SIT" segnum="1" segtot="1" source="SYSIN" 
totallen="2" type="SIT" value="EU" valuelen="2" />
<cicssystemparameter _keydata="E2D9E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="SRT" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="1$" valuelen="2" />
<cicssystemparameter _keydata="E3C3E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="TCT" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="DY" valuelen="2" />
<cicssystemparameter _keydata="E3E2E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="TST" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="NO" valuelen="2" />
<cicssystemparameter _keydata="E7D3E3404040404040404040404040404040404040404040404040404040404000000001" 
eyu_cicsname="WLW26W1" eyu_cicsrel="E660" eyu_reserved="0" keyword="XLT" segnum="1" segtot="1" source="TABLE" 
totallen="2" type="SIT" value="NO" valuelen="2" />
</records>
</response>
  • 以下请求检索为 CICsplex MYPLEX中所有区域的 MXT (MAX TASKS) 系统初始化参数设置的值。
    /CICSSystemManagement/CICSSystemParameter/<MYPLEX>?PARAMETER=PARMSRCE(COMBINED)
%20PARMTYPE(SIT)&CRITERIA=KEYWORD%3DMXT
  • 以下内容检索为 CICSplex MYPLEX中的区域 REGION 设置的控制表后缀的值。
    /CICSSystemManagement/CICSSystemParameter/<MYPLEX>/<REGION>?PARAMETER=PARMSRCE(COMBINED)
%20PARMTYPE(SIT)&CRITERIA=KEYWORD%3D++T%20AND%20NOT%20KEYWORD%3DMXT
  • 以下请求检索 CICSplex MYPLEX 中已关闭缺省失控任务时间间隔的区域的名称。
    /CICSSystemManagement/CICSSystemParameter/<MYPLEX>?PARAMETER=PARMSRCE(COMBINED)
%20PARMTYPE(SIT)&CRITERIA=KEYWORD%3DICVR%20AND%20VALUE%3D0
  • 以下请求检索通过 SYSIN 覆盖应用于 CICSplex MYPLEX 中区域 REGION 的覆盖。
    /CICSSystemManagement/CICSSystemParameter/<MYPLEX>/<REGION>?PARAMETER=PARMSRCE(SYSIN)%20PARMTYPE(SIT)
  • 以下请求将通过 JCL 覆盖检索应用于 CICSplex MYPLEX 中区域 REGION 的覆盖。
    /CICSSystemManagement/CICSSystemParameter/<MYPLEX>/<REGION>?PARAMETER=PARMSRCE(JCL)%20PARMTYPE(SIT)