事务管理器域出口 XXMATT

出口 XXMATT 在事务连接期间调用，并且能够更改正在连接的事务的某些属性。

出口可以通过更改 UEPATPTI 寻址的字段来更改事务的连接事务标识。 不能从此出口使用 EXEC CICS 命令。

特定于出口的参数
UEPTRANID
事务标识的地址 (请参阅 Notes)。
UEPUSER
与事务关联的用户标识的地址 (如果当前任务是用户任务) (请参阅 Notes)。
UEPTERM
与事务关联的终端标识的地址 (如果有) (请参阅 Notes)。
UEPPROG
此事务的应用程序名称的地址 (如果有) (请参阅 Notes)。
UEPATPTI
包含主事务标识的 4 字节字段的地址。 您可以通过修改指定的字段来更改主事务标识。
UEPATOTI
4 字节连接事务标识的地址。 X'00000000 ' 的转换指示未在连接上提供转换。
UEPATTPL
包含连接 TPName 长度的区域的地址。 长度为零表示未在连接上提供 TPName。
UEPATTPA
包含连接 TPName 的地址的全字的地址。 连接 TPName 的长度可以是 1 到 64 个字节，如 UEPTTPL 所定义。
UEPATLOC
指示是否找到事务的 1 字节字段的地址。 请注意，如果未找到事务，但指定了系统初始化参数 DTRTRAN 和 DTRPGM ，那么将连接 DTRTRAN 上指定的事务，并且 CICS® 将认为已找到该事务。
等同的值为:
UEATFND
已找到事务。
UEATNFND
找不到事务。
UEPATTST
1 字节事务定义状态的地址。 定义状态的等同值为:
UEATENAB
已启用事务。
UEATDISA
事务已禁用。
UEPATTTK
包含事务令牌的双字的地址。 请注意，某些事务管理器 XPI 调用需要此令牌来标识正在连接的事务。
返回码
UERCNORM
继续连接处理。
XPI 调用
用户出口可以使用 UEPATTTK 事务令牌作为 XMIQ INQUIRE_TRANSACTION XPI 调用的输入来查询正在连接的事务。

该出口还可以使用 XMIQ SET_TRANSACTION XPI 调用来设置总优先级和 TCLASS。

可以使用大多数 XPI 调用，但请谨慎，因为通常在 TCP 任务下调用此出口。 因此，建议不要发出任何可能导致 TCP 任务等待的 XPI 调用。

注：
  1. 以下 XPI 调用对于获取可用于修改事务连接的信息很有用:
    • INQUIRE_TRANSACTION
    • INQUIRE_MXT
    • INQUIRE_TCLASS
    • INQUIRE_TRANDEF
    • INQUIRE_SYSTEM
  2. UEPTRANID ， UEPUSER ， UEPTERM 和 UEPPROG 字段是许多域全局用户出口点的公共字段，通常返回与当前用户任务相关联的值。 但是，对于 XXMATT ，当调用出口时，正在连接的用户任务 不是 当前任务。 在任务连接完成之前，当前任务是正在执行连接的 CICS 任务。

    当正在连接的任务是由立即 START 命令启动的任务 (即，没有时间间隔的 START) 时，当前任务是发出 START 命令的任务，并且字段包含与该任务关联的值。