响应的原因码: USER_ERROR

EXCI CALL 命令失败。此类错误表示客户机程序， CICS® 服务器程序或 CICS 服务器区域中存在错误。 USER_ERROR 响应的每个原因码值都说明是可以直接重新发出命令，还是必须先关闭并重新打开所使用的管道。响应 USER_ERROR 的原因码为 401 到 434。

401 :INVALID_CALL_TYPE

说明

在此 EXCI 请求中指定了无效的 call-type 参数值。

系统操作

请求被拒绝。

用户响应

检查 EXCI 客户机程序并确保 call_type 参数指定 EXCI 调用的相应值，如下所示。

1: 初始化用户
2: Allocate_Pipe
3: Open_Pipe
4: 收尾管道
5: 取消分配管道
6: DPL

402 :INVALID_VERSION_NUMBER

说明: version_number 参数未指定值 1 ， 2 或 3。
系统操作: 请求被拒绝。
用户响应: 请检查客户机应用程序，并确保所有 EXCI 调用都为版本号指定 1 ， 2 或 3 的值。

403 :INVALID_APPL_NAME

说明: user_name 参数由所有空白字符 (X'40 ') 组成。
系统操作: 调用被拒绝。
用户响应: 更改应用程序以指定有效的非空白用户名。

404 :INVALID_USER_TOKEN

说明: 客户机应用程序已使用外部 CICS 接口未知的用户令牌发出 EXCI 请求。
系统操作: 请求被拒绝。
用户响应: Initialize_User 调用返回必须用于该用户的所有进一步请求的 4 字节令牌。请检查客户机应用程序并更正错误，以确保传递正确的令牌。

405 :PIPE_NOT_CLOSED

说明: 已对尚未关闭的管道发出 Dedelocate_Pipe 请求。
系统操作: 外部 CICS 接口将忽略该请求，并且管道保持打开状态。
用户响应: 检查客户机应用程序，并确保需要 Deallocate_Pipe 请求。如果是这样，请先针对管道发出 Close_Pipe 请求，然后再发出 Deallocate_Pipe 请求。

406 : 管道未打开

说明: 已在未打开的管道上发出 DPL 调用。
系统操作: 外部 CICS 接口拒绝 DPL 请求。
用户响应: 检查客户机应用程序，并确保在对 DPL 请求使用管道之前发出 Open_Pipe 请求。如果应用程序已发出 Open_Pipe ，请在发出所有 DPL 请求之前检查它是否已无意中关闭。

407 :INVALID_USERID

说明: 已发出带有 USERID 参数的 DPL 请求，该参数由所有空白组成。
系统操作: DPL 请求被拒绝。
用户响应: 请检查 EXCI 客户机程序，并确保 DPL 请求传递有效的 USERID 参数。如果不想指定用户标识，请使用 userid的空地址对调用参数列表进行编码。如果传递空地址，那么外部 CICS 接口将传递运行客户机应用程序的用户标识 (批处理区域的用户标识)。

408 :INVALID_UOWID

说明: 已使用具有无效长度字段的 uowid 参数发出 DPL 请求。
系统操作: DPL 请求被拒绝。
用户响应: 检查客户机应用程序并确保 DPL 请求传递有效的 uowid 参数。如果您不想指定工作单元标识，请使用 uowid的空地址对调用参数列表进行编码，在这种情况下，外部 CICS 接口将为您生成工作单元标识。

409 :INVALID_TRANSID

说明: 已使用由所有空白组成的 transid 参数发出 DPL 请求。
系统操作: DPL 请求被拒绝。
用户响应: 检查客户机应用程序并确保正确指定了 transid 参数或未以某种方式覆盖该参数。如果您不想指定自己的 transid ，请使用 transid的空地址对调用参数列表进行编码，在这种情况下，外部 CICS 接口使用缺省 CICS 镜像事务 CSMI。

410 :DFHMEBM_LOAD_FAILED

说明: 在 Initialize_User 处理期间，外部 CICS 接口尝试装入主消息模块以准备发出外部 CICS 接口消息，但装入此模块失败。
系统操作: 已拒绝 Initialize_User 调用。在子原因 field-1中返回来自 z/OS® 装入宏 (R15) 的返回码。外部 CICS 接口处理错误，并返回在子原因 field-2中可能发生的异常终止 (R0)。
用户响应: 使用 z/OS 返回代码，确定加载失败的原因。最可能的原因是消息模块 DFHMEBMX 不在批处理作业的 STEPLIB 中包含的任何库中。确保在 STEPLIB 连接中包含 CICSTSnn.CICS.SDFHEXCI 库（其中 nn 反映 CICS 的版本：例如 CICSTS63.CICS.SDFHEXCI 代表 CICS TS 6. 3 ）。重新启动客户机应用程序。

411: DFHMET4E_LOAD_FAILED

说明: 装入消息模块 DFHMET4E失败。在 Initialize_User 处理期间，外部 CICS 接口尝试装入其消息表以准备发出消息。装入此模块失败。
系统操作: 已拒绝 Initialize_User 调用。在子原因 field-1中返回来自 z/OS 装入宏 (R15) 的返回码。外部 CICS 接口处理错误，并返回在子原因 field-2中可能发生的异常终止 (R0)。
用户响应: 使用 z/OS 原因代码，确定加载失败的原因。最可能的原因是批处理任务的 STEPLIB 中没有包含报文表 DFHMET4E。确保在 STEPLIB 连接中包含 CICSTSnn.CICS.SDFHEXCI 库（其中 nn 反映 CICS 的版本：例如 CICSTS63.CICS.SDFHEXCI 代表 CICS TS 6. 3 ）。重新启动客户机应用程序。

412 :DFHXCURM_LOAD_FAILED

说明: 在 Initialize_User 处理期间，外部 CICS 接口尝试装入用户可替换模块 DFHXCURM。装入此模块失败。
系统操作: 已拒绝 Initialize_User 调用。在子原因 field-1中返回来自 z/OS 装入宏 (R15) 的返回码。外部 CICS 接口处理错误，并返回在子原因 field-2中可能发生的异常终止 (R0)。
用户响应: 使用 z/OS 原因代码，确定加载失败的原因。最可能的原因是模块 DFHXCURM 不在批处理作业的 STEPLIB 中包含的任何库中。确保包含模块的库包含在 STEPLIB 并置中，然后重新启动客户机应用程序。

413 :DFHXCTRA_LOAD_FAILED

说明: 在 Initialize_User 处理期间，外部 CICS 接口尝试装入陷阱模块 (DFHXCTRA)。装入此模块失败。
系统操作: 已拒绝 Initialize_User 调用。在子原因 field-1中返回来自 z/OS 装入宏 (R15) 的返回码。外部 CICS 接口处理错误，并返回在子原因 field-2中可能发生的异常终止 (R0)。
用户响应: 使用 z/OS 原因代码，确定加载失败的原因。最可能的原因是 DFHXCTRA 不在批处理作业的 STEPLIB 中包含的任何库中。确保包含模块的库包含在 STEPLIB 并置中，然后重新启动客户机应用程序。

414 :IRP_ABORT_RECEIVED

说明: 处理 DPL 请求时，在 CICS 服务器区域中发生错误，导致异常中止 FMH7 流返回到外部 CICS 接口。
系统操作: 这将向客户机应用程序返回一条消息。如果服务器程序是从终端启动的，那么将向终端发出此消息。将消息的指针返回到 EXCI 返回区域的消息指针字段中的客户机应用程序。请参阅 EXCI 返回区域的描述以获取消息格式的准确定义。管道处于必须关闭状态。
用户响应: 使用此消息来确定错误原因。典型的示例是无法连接服务器事务，原因是禁用了服务器事务，或者未定义服务器事务，或者由于安全故障。更正问题，关闭并重新打开管道，然后重新发出 DPL 请求。

415 :INVALID_CONNECTION_DEFN

说明: CICS 已拒绝 DPL 请求，因为未定义目标连接以供外部 CICS 客户机应用程序使用。
系统操作: DPL 请求被拒绝，并且管道处于必须关闭状态。
用户响应: 最可能的原因是 CICS 服务器区域中的连接定义未正确定义为 CICS-to-CICS MRO 连接，而不是 EXCI 连接。确保在相应的 CONNECTION 和 SESSIONS 资源定义上指定 PROTOCOL (EXCI)。在重新发出 DPL 请求之前，必须关闭并重新打开管道。

416 :INVALID_CICS_RELEASE

说明: 目标 CICS 服务器区域已拒绝 DPL 请求，因为它无法识别该请求。
系统操作: DPL 调用被拒绝，并且管道处于必须关闭状态。
用户响应: 最可能的原因是客户机应用程序指定了不支持外部 CICS 接口的目标 CICS 服务器区域。

417: 管道必须关闭

说明: 已在处于必须关闭状态的管道上发出 DPL 请求。
系统操作: DPL 请求被拒绝。
用户响应: 某些EXCI错误非常严重，需要关闭并重新打开管道，才能恢复管道，使其可用于进一步的DPL请求。其他的，比较小的错误，允许进一步的呼叫，而不需要关闭和重新打开管道。此管道上的先前错误具有更严重的种类，并且该管道现在处于必须关闭状态。关闭并重新打开管道，然后重新发出 DPL 请求。

418:无效管道令牌

说明: 已发出 Open_Pipe ， close_Pipe ， Delocate_Pipe 或 DPL 请求，但调用上传递的管道令牌不是有效管道，或者不是为此用户分配的有效管道 (即，用户令牌与管道令牌不匹配)。
系统操作: 调用被拒绝。
用户响应: 请确保管道令牌未被覆盖，并在调用时正确传递。另外，请确保用户令牌与管道令牌之间不匹配。

419 :CICS_AFCB_PRESENT

说明: 已对 CICS已使用的 TCB 发出 Initialize_User 请求。外部 CICS 接口无法与 CICS共享 TCB ，从而确保 CICS 应用程序无法发出 EXCI 请求。
系统操作: 已拒绝 Initialize_User 请求。
用户响应: 要使用外部 CICS 接口，必须创建新的 TCB (或子 TCB) ，并在该唯一 TCB 下发出 EXCI 调用。

420 :DFHXCOPT_LOAD_FAILED

说明: 在 Initialize_User 处理期间，外部 CICS 接口尝试装入其选项模块 DFHXCOPT。装入此模块失败。
系统操作: 已拒绝 Initialize_User 调用。在子原因 field-1中返回来自 z/OS 装入宏 (R15) 的返回码。外部 CICS 接口处理错误，并返回在子原因 field-2中可能发生的异常终止 (R0)。
用户响应: 使用 z/OS 原因代码，确定加载失败的原因。最可能的原因是 DFHXCOPT 不在批处理作业的 STEPLIB 中包含的任何库中。更正问题并重新启动客户机应用程序。

421 :RUNNING_UNDER_AN_IRB

说明: 在 z/OS IRB 下发出 EXCI 调用，这是不允许的。
系统操作: 调用被拒绝。
用户响应: 确定在 IRB 下发出调用的原因，并更改客户机应用程序。

422 :SERVER_AB幕

说明: 处理 DPL 请求时， CICS 服务器应用程序异常终止而未处理错误。
系统操作: 服务器应用程序异常结束并回退。在 EXCI 返回区域的异常终止代码字段中返回异常终止代码。
用户响应: 确定服务器程序异常终止的原因并解决问题。

423: 代理检查失败

说明

已发出指定 USERID 参数的 DPL 请求。指定的用户标识受代理用户检查的约束。代理用户检查失败。代理安全检查将验证是否授权 EXCI 批处理区域的用户标识作为 DPL 调用上指定的用户标识的代理。

系统操作

已拒绝 DPL 调用。 RACF® 返回码和原因码在子原因 field-1 和 field-2中返回。对于 RACF，这些内容记录在 z/OS Security Server RACROUTE 宏参考中。

用户响应

确保 EXCI 批处理区域的用户标识对概要文件 userid具有 READ 访问权。SURROGAT 常规资源类中的 DFHEXCI ，其中 userid 是在 DPL 调用上指定的用户标识。

请参阅代理用户检查以获取更多信息。

424 :RRMS_NOT_SUPPORTED

说明: 在未运行 z/OS 发行版 5 (或更高版本，向上兼容的发行版) 的系统上发出了省略 SYNCONRETURN 选项的 DPL 请求。
系统操作: 调用被拒绝。
用户响应: 确保批处理程序在运行正确级别的 z/OS的系统上运行。

425 :UOWID_NOT_ALLOWED

说明: DPL 请求省略了 SYNCONRETURN 选项，但指定了值 UOWID。在 DPL 请求中不允许此参数组合。
系统操作: DPL_Request 被拒绝。
用户响应: 检查客户机应用程序并确保在 DPL 调用上使用正确的参数组合。

426: INVALID_TRANSID2

说明: 已使用由所有空白组成的 transid2 参数发出 DPL 请求。
系统操作: DPL 请求被拒绝。
用户响应: 检查客户机应用程序并确保正确指定了 transid2 参数或未以某种方式覆盖该参数。

427 :INVALID_CCSID

说明: 已使用指定了无效值的 ccsid 参数发出 DPL 请求。
系统操作: DPL 请求被拒绝。
用户响应: 请检查客户机应用程序，并确保正确指定了 ccsid 参数或未以某种方式覆盖该参数。

428 :INVALID_ENDIAN

说明: 已发出带有指定无效值的 endian 参数的 DPL 请求。
系统操作: DPL 请求被拒绝。
用户响应: 检查客户机应用程序，并确保正确指定了 endian 参数或未以某种方式覆盖该参数。

429 :DFHXCEIX_LOAD_FAILED

说明: 在处理 EXEC CICS LINK 调用期间，外部 CICS 接口尝试装入模块 (DFHXCEIX)。装入此模块失败。
系统操作: EXEC CICS LINK 调用被拒绝。
用户响应: 最可能的原因是 DFHXCEIX 不在批处理作业的 STEPLIB 中包含的任何库中。确保包含模块的库包含在 STEPLIB 并置中，然后重新启动客户机应用程序。

430 :DFHXCPRX_LOAD_FAILED

说明: 在 Initialize_User 处理期间，外部 CICS 接口尝试装入模块 (DFHXCPRX)。装入此模块失败。
系统操作: 已拒绝 Initialize_User 调用。在子原因 field-1中返回来自 z/OS 装入宏 (R15) 的返回码。外部 CICS 接口处理错误，并返回在子原因 field-2中可能发生的异常终止 (R1)。
用户响应: 使用 z/OS 原因代码，确定加载失败的原因。最可能的原因是 DFHXCPRX 不在批处理作业的 STEPLIB 中包含的任何库中。确保包含模块的库包含在 STEPLIB 并置中，然后重新启动客户机应用程序。

431: 逗号区长度不允许

说明

已发出指定 CHANNEL 参数和 COMMAREA_LEN 参数的 DPL 请求。

使用通道在程序之间传输数据时， COMMAREA_LEN 参数必须为空。

系统操作

请求被拒绝。

用户响应

检查 EXCI 程序。如果它包含指定通道的 DPL 请求，请确保 COMMAREA_LEN 参数为空。

432 :DATA_LEN_NOT_ALLOWED

说明

已发出指定 CHANNEL 参数和 DATA_LEN 参数的 DPL 请求。

使用通道在程序之间传输数据时， DATA_LEN 参数必须为空。

系统操作

请求被拒绝。

用户响应

检查 EXCI 程序。如果它包含指定通道的 DPL 请求，请确保 DATA_LEN 参数为空。

433 :CCSID_NOT_ALLOWED

说明

已发出指定 CHANNEL 参数和 CCSID 参数的 DPL 请求。

使用通道在程序之间传输数据时， CCSID 参数必须为空。

系统操作

请求被拒绝。

用户响应

检查 EXCI 程序。如果它包含指定通道的 DPL 请求，请确保 CCSID 参数为空。