SET TRANSACTION

更改 TRANSACTION 定义。

SET TRANSACTION

条件: INVREQ ， NOTAUTH 和 TRANSIDERR

有关使用 CVDA 的更多信息，请参阅 CICS-value 数据区 (CVDA)。

此命令是线程安全的。

描述

SET TRANSACTION 命令允许您更改事务定义的某些属性。

只能使用此命令来更改本地 CICS® 系统中的定义。如果更改远程执行的事务 (即，指定 REMOTESYSTEM 值的事务) ，那么将进行更改，但这些更改不会影响本地定义所指向的远程系统中的定义，因此不会影响执行该事务的任务。

更改事务定义仅影响将来的任务; 要更改已执行事务的任务，请使用 SET TASK 命令。

不能将 SET TRANSACTION 命令用于已定义并安装在 CICS 束中的 TRANSACTION 资源。如果尝试修改由 CICS 束安装的动态生成的 TRANSACTION 资源，那么将发出 RESP2 值为 300 的 INVREQ 响应。

您可以通过启用或禁用安装了动态生成的 TRANSACTION 资源的 BUNDLE 资源来控制这些资源的状态。
您可以使用 CICS Explorer®中的资源编辑器来修改动态生成的 TRANSACTION 资源的定义。要更新该定义，请遵循使用 CICS Explorer 产品文档中的束中的指示信息，将旧版本的 CICS 束替换为新束。可以单独更新单独部署或使用平台部署的 CICS 束。如果 CICS 束是作为应用程序的一部分或通过应用程序绑定进行部署，请更新整个应用程序。

选项

正在转储 (cvda)

指定如果执行此事务的任务异常终止，那么 CICS 是否应执行事务转储。 CVDA 值包括：

NOTRANDUMP: 不应执行转储。
TRANDUMP: 应执行转储。

此值仅适用于异常终止转储，对 DUMP TRANSACTION 命令没有任何影响。

OTSTIMEOUT (数据区)

返回一个全字数据区，其中包含允许在此 CICS 事务下执行的 EJB 环境中创建的 OTS 事务在同步点之前执行的缺省时间段 (以秒计)。

PRIORITY (data-value)

指定此事务相对于 CICS 系统中其他事务的优先级作为全字二进制值。该值必须在 0-255 范围内。

PURGEABILITY (cvda)

返回一个 CVDA 值，指示是否允许 CICS 清除此任务 (即，异常终止此任务)。清除请求来自 SET TASK PURGE 命令 (或相当于 CEMT 的请求) ， CICS 可以在内部生成这些请求以回收资源来缓解系统停滞状况。 CVDA 值包括：

不可清除: 无法清除该任务。
可清除: 可以清除该任务。

PURGEABILITY 值最初由此任务正在执行的事务的定义中的 SPURGE 选项设置。

RUNAWAY (data-value)

以全字二进制值的形式指定执行此事务的任务的失控任务时间 (以毫秒计)。该值必须为 0 ，或者在 250-2700000 范围内。检查任务是否处于失控状态时， CICS 会将您指定的值向下舍入到 250 的倍数。如果任务保持对处理器的控制超过此时间间隔，那么 CICS 会假定它处于循环中并异常终止。如果该值为零，那么 CICS 不会监视任务是否存在失控情况。

注: 如果指定 RUNAWAY ，那么必须在同一 SET 命令中将 RUNAWAYTYPE 设置为 USER ，即使 RUNAWAYTYPE 的值已为 USER。

RUNAWAYTYPE (cvda)

指定应该在何处获取执行此事务的任务的失控任务时间。 CVDA 值包括：

SYSTEM: 应使用失控任务时间的系统缺省值。 (带有 RUNAWAY 选项的 INQUIRE SYSTEM 命令告诉您系统值是什么。)
USER: 应使用此事务的 RUNAWAY 值。指定 USER 时，必须为 RUNAWAY 指定值。

SHUTDOWN (cvda)

指定在 CICS 关闭期间，是否可以由为处理非请求终端输入而创建的任务来执行此事务。（如果此事务包含在用于关闭的事务列表（XLT）中，那么它也可以在这种情况下执行。） CVDA 值包括：

已禁用: 无法执行事务。
已关闭: 可以执行事务。

状态 (cvda)

指定事务是否可供使用。 CVDA 值包括：

DISABLED: 事务不可用。
ENABLED: 该事务可供使用。

具有以字母 C 开头的名称以及具有以 DFH ， EYU 或 CJx 开头的初始程序名 (其中 x 是 A 到 J) 的事务是 CICS提供的并且不能禁用。

TCLASS (data-value)

指定事务所属的事务类作为全字二进制值。 SET TRANSACTION TCLASS 在 TRANSACTION 定义中设置 TRANCLASS 值。

提供 TCLASS 只是为了与较早发行版的 CICS兼容，其中事务类是编号而不是命名的，您只能使用它来指定格式为 DFHTCLnn的名称，其中 nn 是您指定的编号，范围为 0-10。 (它不会更改 TRANSACTION 定义中的 TCLASS 值，对于将同一 TRANSACTION 定义用于多个不同发行版的情况， CICS 会维护该值。请参阅 INQUIRE TRANSACTION 命令中 TCLASS 和 TRANCLASS 的描述以获取更多信息。)

跟踪 (cvda)

指定要对执行此事务的任务执行的跟踪类型。请参阅使用 CICS 跟踪以获取跟踪类型的定义。 CVDA 值包括：

特殊跟踪: 跟踪是特殊的。
SPRSTRACE: 将禁止跟踪。
节跟踪: 跟踪是标准的。

TRANCLASS (data-value)

指定此事务所属的事务类的 8 字符名称。

TRANSACTION (data-value)

指定要更改的事务定义的 4 字符名称。

条件

INVREQ

RESP2 值：

2: PURGEABILITY 具有无效的 CVDA 值。
3: STATUS 具有无效的 CVDA 值。
4: 为名称以 C 开头的事务指定了 DISABLED ，并具有名称以 DFH ， EYU 或 CJx 开头的初始程序 (其中 x 是 A 到 J)。
5: TCLASS 或 TRANCLASS 名称未知。
7: TRACING 具有无效的 CVDA 值。
8: 转储具有无效的 CVDA 值。
9: PRIORITY 值超出范围。
10: RUNAWAYTYPE 具有无效的 CVDA 值。
11: SHUTDOWN 具有无效的 CVDA 值。
12: 指定了 USER ，但未指定 RUNAWAY 值。
13: 指定了不带 RUNAWAYTYPE 值 USER 的 RUNAWAY。
14: RUNAWAY 值超出范围。
300: 针对由 CICS 束 (BUNDLE) 创建的 TRANSACTION 资源发出了 SET TRANSACTION SPI 命令。

NOTAUTH

RESP2 值：

100: 未授权与发出任务关联的用户使用此命令。
101: 未授权与发出任务关联的用户以此命令所需的方式访问此特定资源。

TRANSIDERR

RESP2 值：

1: 找不到事务。