示例: 诊断 CICS 管理客户机接口安装错误

要使用 CICS 管理客户机接口安装 BAS 资源，请将 PUT 请求与 INSTALL 操作配合使用。 如果安装失败，那么 CICSPlex ® SM 将生成包含诊断信息的 BINSTERR 记录。 This record is returned in an <installerror> element, which is a child element of <feedback>.

关于此任务

您尝试使用带有以下 URI 和 XML 主体的 PUT 请求将名为 URIMAP_A 的 URIMAP 资源安装到区域 DEVRGN1中:
http://wmvs2c.mycorp.com:27640/CICSSystemManagement/CICSDefinitionURIMap/IBEUR912?
CRITERIA=name%3DURIMAP_A

<request>
  <action name="INSTALL">
    <parameter name="TARGET" value="DEVRGN1"/>
    <parameter name="USAGE" value="LOCAL"/>
  </action>
</request>
虽然您从 CICS 管理客户机接口接收到 HTTP/1.1 200 OK 响应，指示请求格式正确，但未安装 URIMAP。 响应包含以下信息:
<resultsummary api_function="PERFORM SET" api_response1="1038" api_response1_alt="TABLEERROR"
api_response2="1361" api_response2_alt="DATAERROR"  recordcount="1"/>
  <errors>
    <feedback action="INSTALL" attribute1="NAME" errorcode="31">  <installerror eibfn="3036" 
		eibfn_alt="CREATE  URIMAP" errorcode="4" eyu_cicsname="IBWUIA" resourcename="URIMAP_A" 
		resourceversion="1" resp="16" resp2="500"/>
    </feedback>
  </errors>
要了解此问题的原因，请执行以下步骤:

过程

  1. 从 api_function 属性确定错误的来源。
    此属性指示 CICS 管理客户机接口已尝试调用 PERFORM SET 函数，但此操作失败。
  2. 从 api_response1_alt 和 api_response2_alt 属性确定失败原因。
    这些值是 CICSPlex SM EYUDA 响应和原因码。
    EYUDA 响应值为 TABLEERROR ， EYUDA 原因值为 DATAERROR。
  3. Determine the API call that failed by combining the information in the api_function attribute of the <resultsummary> tag with the 行动 attribute from the <feedback> element.
    使用此信息可以确定 CICS 管理客户机接口尝试执行 CICSPlex SM API 命令 EXEC CPSM PERFORM SET ACTION('INSTALL') 时发生故障
  4. Identify the associated EXEC CICS command from the 艾布弗特 attribute of the <installerror> element.
    eibfn_alt 表示命令 EXEC CICS CREATE URIMAP
  5. Use the value of the 错误代码 attribute of the <installerror> element to determine the CICSPlex SM BINSTERR error code.
    请参阅 BINSTERR 资源表 以获取错误代码及其含义的列表。 在这种情况下， errorcode 值 4 是(INSTFAIL) - Install failure.
  6. Use the 雷斯普 and resp2 attributes of the <installerror> element to determine the exact cause of the failure.
    这两个值都以十进制格式显示。
    1. 查找 CICS® resp 值 16 的符号名称。
      请参阅 EIB 字段 以获取 EIBRESP 值的列表。
      从此列表中，您可以确定值为 16 的 EIBRESP 字段具有符号名称 INVREQ。
    2. 最后，查找 resp2 值为 500 的 INVREQ 响应对于 EXEC CICS CREATE URIMAP 命令的含义。
      请参阅 CREATE 和 CSD 命令的 RESP2 值 ，以获取 EXEC CICS CREATE 命令的列表 RESP2 值。