TRANSACTION 属性
描述 TRANSACTION 资源的语法和属性。
- ACTION({BACKOUT|COMMIT})
- 指定在工作单元进入不确定周期后的 2 阶段落实处理期间,当 CICS® 区域发生故障或与其协调程序失去连接时要执行的操作。 操作取决于 WAIT 属性。 如果 WAIT 指定 YES ,那么除非 WAITTIME 在从故障中恢复之前到期,否则 ACTION 无效。如果 WAIT 指定 NO ,那么所执行的操作是下列其中一项:
- 备份
- 对可恢复资源所作的所有更改都将回退,并且这些资源将返回到 UOW 启动之前所处的状态。
- 落实
- 将落实对可恢复资源所作的所有更改,并将 UOW 标记为已完成。
- ALIAS(别名)
- 指定此事务的别名事务名称。 该名称的最大长度为 4 个字符。 如果要在使用 UCTRAN (NO) 定义的终端或允许混合大小写输入 (PROFILE UCTRAN (NO)) 的事务上运行,那么此选项很有用。 例如,可以通过 ALIAS (abcd) 启动与 ABCD 相同的事务。安装包含 ALIAS 属性的 TRANSACTION 定义时,结果取决于别名是否已在系统中使用:
- 如果别名正用作主事务标识,那么将忽略 ALIAS 属性。
- 如果别名正用作其他事务的别名,那么原始别名将替换为新别名。 换言之,在安装了 TRANSACTION 定义之后,别名指的是新事务,而不是原始事务。
- BREXIT(程序)
- 定义要与此事务关联的缺省网桥出口的名称 (如果它是在 3270 网桥环境中使用未在其 BREXIT 选项上指定名称的 START BREXIT 命令启动的)。 该名称的最大长度为 8 个字符。
可接受的字符:
除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ #如果定义了 BREXIT ,请不要指定 REMOTESYSTEM , REMOTENAME , DYNAMIC (YES) 或 RESTART (YES) ,因为它们被忽略。
注: 现在建议使用 Link3270 机制来使用 3270 网桥。 - CMDSEC({NO|YES})
- 指定是否对系统编程命令应用安全性检查。
- 否
- 不进行检查。 这些命令始终运行。
- YES
- 调用外部安全管理器 (ESM)。 CICS 授权或阻止访问。 如果 ESM 无法识别资源或资源类型,那么将阻止访问。
- CONFDATA({NO|YES})
- 指定在 CONFDATA 系统初始化参数指定 HIDETC 时,CICS 是否阻止 CICS 跟踪条目中的用户数据。 如果系统初始化参数指定 CONFDATA=SHOW ,那么将忽略事务定义上的 CONFDATA。如果系统初始化参数指定 CONFDATA=HIDETC ,那么以下选项有效:
- 否
- CICS 不会禁止任何用户数据。 z/OS® Communications Server 和 MRO 初始用户数据在跟踪点 AP FC9B中进行跟踪。 在正常 CICS FEPI 跟踪点中跟踪 FEPI 用户数据。 IPIC 用户数据在正常 CICS IS 跟踪点中进行跟踪。
- YES
- CICS 禁止来自 CICS 跟踪点的用户数据。
- DESCRIPTION(文本)
- 您可以提供在此字段中定义的资源的描述。 描述文本的长度最多可以为 58 个字符。 您可以使用的字符没有任何限制。 但是,如果使用括号,请确保对于每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令,那么对于文本中的每个单撇号,请对两个单撇号进行编码。
- DTIMOUT({NO|mmss})
- 指定是否将死锁超时应用于任务。 如果任务处于暂挂状态 (例如,由于缺少存储器) ,那么当任务处于暂挂状态的时间超过 DTIMOUT 值时,将启动任务清除。 如果清除使得事务异常终止,那么所使用的异常终止代码取决于 CICS 暂挂了任务的哪部分。 使用 CEDF 时,用户任务 (如果可能) 指定 DTIMOUT (NO) 或大值。 现在,如果 DTIMOUT 非零,那么此值也将用作所有 RLS 文件请求的超时值; 否则,请求将获取 SIT FTIMEOUT 值。 FTIMEOUT 应用于没有处于活动状态的死锁超时时间间隔的事务。 如果为 TRANSACTION 定义的 DTIMOUT 关键字指定了时间值,那么此值将用作该事务的文件超时值。
使用 CEDF 时,如果为用户任务指定了任何 DTIMOUT 值,那么在用户任务暂挂且 CEDF 任务处于活动状态时,将忽略 DTIMOUT 值。 因此,当 CEDF 任务正在等待用户响应时,暂挂的用户任务无法以死锁超时 (abend AKCS) 结束。
要使 DTIMOUT 在非 RLS 使用中有效,请将 SPURGE 设置为 YES。
CICS 在某些点上禁止死锁超时。
DTIMOUT 不会因终端 I/O 等待而触发。 由于中继事务不会在获得会话后访问资源,因此它不需要 DTIMOUT,除非为了使暂挂的分配请求进入陷阱。 但是,对于会话上的 I/O 等待,可以在 PROFILE 定义上为 IPIC 或 MRO 会话和映射的 APPC 连接上的事务路由指定 RTIMOUT 属性。
您必须定义一些具有 DTIMOUT 值的事务,因为死锁超时是 CICS 用于处理存储空间不足 (SOS) 情境的机制。- 否
- 不需要死锁超时功能。
- mmss
- 时间长度 (mm 表示分钟, ss 表示秒) ,在此时间之后,死锁超时将结束暂挂的任务。 可以指定的最大值为 68 分钟 (6800); 此值精确到 1 秒。
- DUMP({YES|NO})
- 指定在事务异常结束时是否对转储域进行调用以生成事务转储。此操作数对以下转储操作没有影响:
- EXEC CICS DUMP 命令,它始终生成转储。
- CICS 使用 ASRA , ARSB 或 ASRD 异常终止生成的转储代码 AP0001 和 SR0001 的系统转储。 如果在事务 DUMP 属性上指定 NO ,那么 CICS 将禁止事务转储,但不禁止系统转储。
- 是
- CICS 调用转储域以生成事务转储。 请注意,事务转储的最终生产或禁止由事务转储表控制。 有关转储表的更多信息,请参阅 您可以指定的转储代码选项。
如果事务异常终止时不存在给定转储代码的事务转储表条目,那么 CICS 将创建一个临时条目,其缺省值为生成事务转储。
您可以使用 CEMT SET TRDUMPCODE 命令或 SET TRANDUMPCODE SPI 命令来控制事务转储的转储表条目。
- 否
- 不调用转储域,禁止任何潜在的事务转储。
- DYNAMIC({NO|YES})
- 指定是否可以使用 CICS 动态事务路由工具将事务动态路由到远程区域。
- 否
- 根据 REMOTESYSTEM 属性创建本地或远程定义。
- YES
- 允许动态事务路由程序在调用时动态地确定本地或远程状态。 有关动态事务路由程序的编程信息,请参阅 编写动态路由程序。
- EXTSEC
- 该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
- GROUP(groupname)
- 每个资源定义都必须具有 GROUP 名称。 资源定义成为组的成员,并在安装组时安装在 CICS 系统中。
可接受的字符:
输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ #GROUP 名称的长度最多可以为 8 个字符。 小写字符被视为大写字符。
- INDOUBT
- 该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
- ISOLATE({YES|NO})
- 指定 CICS 是否隔离事务用户密钥任务生存期存储器以提供事务到事务保护。 (请参阅 TASKDATAKEY 属性以获取用户密钥存储器的描述。) 隔离意味着用户键任务生存期存储器由其他事务的用户键程序 (即,从使用 EXECKEY (USER) 定义的程序) 进行读写时受到保护。 存储器访问的隔离属性的影响 显示了集中属性的效果。
要使用事务隔离,必须使用 STGPROT 系统初始化参数 设置存储器保护,并使用 TRANISO 系统初始化参数设置整个区域的事务隔离。
注:- 隔离属性不会针对在 CICS 键中运行的应用程序提供任何保护; 即,来自使用 EXECKEY (CICS) 定义的程序。
- 使用事务隔离的事务不支持 VSAM 非共享资源 (NSR)。 当您定义使用 NSR 访问 VSAM 文件的事务时,必须指定隔离 (NO)。 您还可以将文件请求交付到远程区域。 执行请求的 DFHMIRS 程序是使用 EXECKEY CICS定义的。 CICS-key 程序对其自己的任务和所有其他任务的 CICS-key 和用户密钥存储器具有读写访问权,无论事务隔离是否处于活动状态。
- 事务隔离不适用于 64 位存储器。
- 是
- 事务用户密钥任务生存期存储器与所有其他事务的用户密钥程序隔离; 即,与使用 EXECKEY (USER) 定义的程序隔离,但与使用 EXECKEY (CICS) 定义的程序隔离。
此外, 所有 其他事务的用户密钥任务生存期存储器 从 使用隔离 (YES) 定义的事务的用户密钥程序受到保护。
- 否
- 如果指定了隔离 (NO) ,那么事务任务生存期存储器将与使用隔离 (YES) 定义的那些事务的用户键程序隔离。 但是,不会将事务存储器与其他事务的用户键程序隔离,这些事务还指定了隔离 (NO) ,因为使用此选项时,会将事务全部分配给公共子空间。
Note also that the user-key task-lifetime storage of all transactions defined with ISOLATE(YES) is protected 从 the user-key programs of transactions defined with ISOLATE(NO).
为那些共享其用户密钥任务生存期存储器的任何部分的事务指定隔离 (NO)。
图 1。 存储器访问的隔离属性的影响
此图显示使用隔离 (YES) 定义的四个事务 (A , B , C 和 D) 以及使用隔离 (NO) 定义的三个事务 (E , F 和 G):- 每个事务 A , B , C 和 D 的用户密钥任务生存期存储与所有其他事务隔离。
- 事务 E , F 和 G 的用户键任务生存期存储可由事务 E , F 和 G 的所有用户键应用程序访问,但与事务 A , B , C 和 D 的用户键程序隔离。
- 所有事务都具有对 CICS密钥存储器的只读访问权。
- LOCALQ({NO|YES})
- 指定是否在本地系统上执行排队。
- 否
- 不执行本地排队。
- YES
- 当系统 或 IPIC 连接 不可用且系统名称有效时,可以尝试对带有 NOCHECK 选项请求的 START 命令进行本地排队。
您可以使用全局用户出口 XISLCLQ 或 XISQLCL来覆盖 LOCALQ 属性的设置。 有关系统间通信程序中用户出口的编程信息,请参阅 全局用户出口点。
- OTSTIMEOUT({NO|hhmmss})
- 以小时,分钟和秒为单位,指定在企业 Bean 环境中创建并作为此 CICS 事务下的任务运行的对象事务服务 (OTS) 事务允许在 OTS 事务的发起方必须获取同步点或回滚事务之前运行的时间长度。 如果指定的时间段到期,那么 CICS 将清除该任务。OTS 事务的发起方可以是下列其中一项:
- 企业 bean 的客户机。
- EJB 容器。 容器在 bean 方法的末尾发出同步点。
- 管理其自己的 OTS 事务的会话 Bean。
管理自己的 OTS 事务的会话 Bean 方法可以使用
javax.Transaction.UserTransaction接口的setTransactionTimeout方法来覆盖缺省超时值。- 否
- OTS 事务不会超时。 缺省值为 NO。
- hhmmss
- 清除任务之前的时间 (采用 HHMMSS 格式)。 最大时间段为 24 小时(240000)。
- PARTITIONSET({partitionset|KEEP|OWN})
- 指定作为缺省应用程序分区集的分区集名称。 该名称的最大长度为 8 个字符。
可接受的字符:
除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ #如果未指定分区集名称或任何一个保留名称,那么 CICS 将在从事务到终端的第一个 BMS 输出之前销毁现有分区。- 分区集
- CICS 会破坏现有分区,并在事务的第一个 BMS 输出到终端之前装入指定的分区集。 (如果终端分区集与应用程序分区集匹配,那么不会破坏现有分区。)
此名称不得与 PROGRAM 中指定的名称相同 (name)。
- KEEP
- 事务使用此终端的应用程序分区集。 此选项通常用于伪会话式事务链中的后继事务。
- 已关闭
- 事务执行其自己的分区管理。
- PRIMEDSIZE
- 该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
- PRIORITY({1|优先级})
- 指定事务优先级。 此从 0 到 255 的 1 到 3 位十进制值用于建立整体事务处理优先级。 事务处理优先级等于终端优先级,事务优先级和操作员优先级之和,不超过 255。 数字越高,优先级越高。
- PROFILE({DFHCICST|概要文件})
- 指定用于启动事务的终端的处理选项的 PROFILE 定义的名称。
缺省值为 DFHCICST。可接受的字符: A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >缺省 DFHCICST 提供的处理选项显示在组 DFHISC 中的 PROFILE 定义中。 DFHCICST 不适合用于分布式事务处理。 而是指定具有 INBFMH=ALL 的 DFHCICSA。
- PROGRAM(程序)
- 指定 CICS 为其提供控制以处理此事务的程序的名称。 该名称的最大长度为 8 个字符。
可接受的字符:
除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ #请确保此名称与 PARTITIONSET (name) 中指定的名称不同。
如果为 REMOTESYSTEM 指定了名称,并且该名称与当前系统的名称不同,那么不需要为 PROGRAM 指定名称。 如果在这些情况下指定了 PROGRAM 的名称,那么可能会将其忽略。
如果此事务定义用于远程程序链接请求,那么在此属性中指定的程序名必须是 CICS 镜像程序 DFHMIRS 的名称。 请参阅 PROGRAM 属性中的 PROGRAM 定义上的 TRANSID 属性。
- REMOTENAME(事务)
- 指定此事务在远程系统中已知的名称 (如果要使用系统间通信在远程系统或区域中运行)。 远程系统可以是其他 CICS 区域或 IMS 系统。 如果 REMOTESYSTEM 属性指定另一个 CICS 区域,那么 REMOTENAME 的长度可以是 1-4 个字符; 如果 REMOTESYSTEM 指定 IMS 系统,那么其长度可以是 1-8 个字符。 IMS 使用 8 字符名称,如果 REMOTENAME 少于 8 个字符,那么 IMS 会将其转换为可用格式。
可接受的字符: A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >如果指定 REMOTESYSTEM 并省略 REMOTENAME ,那么 REMOTENAME 的值缺省为本地名称; 即,此定义上的 TRANSACTION 名称。 请注意,事务不必在远程系统或区域上。
- REMOTESYSTEM(连接)
- 指定用于标识相互通信链路的名称,该链路用于发送事务连接请求。
可接受的字符:
除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ #REMOTESYSTEM 是下列其中一个标识:- 对于 IPIC 连接而言,已启用并获取的 IPCONN 定义中 IPCONN 名称的前 4 个字符。
- 对于 MRO 和 APPC 连接而言,CONNECTION 定义中的 CONNECTION 名称。
REMOTESYSTEM 用于 CICS 函数请求发送 (异步处理和事务路由)。
确保为一组事务指定的 REMOTESYSTEM 选项不引用该集中的任何其他事务; 即,它们不是自引用的,这可能导致多个镜像事务的循环启动。
- RESSEC({NO|YES})
- 指定是否将资源安全性检查用于由此事务访问的资源。
- 否
- 所有资源都可供有权使用此事务的任何用户使用。
- YES
- 使用外部安全管理器。 有关外部安全性检查的更多详细信息,请参阅 资源定义的安全性
- RESTART({NO|YES})
- 指定是否使用事务重新启动设施来重新启动那些异常结束并且稍后由动态事务回退设施回退的任务。如果指定了 RESTART (YES) ,那么将从初始程序开始重新启动失败的任务。 如果动态事务回退失败,或者如果动态禁止重新启动,那么将以正常方式调用 DFHPEP。 在诸如程序隔离死锁之类的情况下,事务重新启动工具特别有用,在这种情况下,可以自动重新启动任务,而不是手动重新提交任务。 即使指定了 SHUTDOWN (DISABLED) ,也允许终端启动的事务在 CICS 关闭期间重新启动。 有关自动事务重新启动的更多详细信息,请参阅 将应用程序拆分为事务 。
- 否
- 不需要重新启动设施。
- YES
- 将使用重新启动工具。
- ROUTABLE({NO|YES})
- 仅适用于与终端相关的事务。 指定如果事务是符合条件的 EXEC CICS START 命令的主体,是否使用增强型路由方法对其进行路由。
- 否
- 如果事务是 START 命令的主题,那么将使用传统方法对其进行路由。
- YES
- 如果事务是符合条件的 START 命令的主体,那么将使用增强型方法对其进行路由。
如果指定 ROUTABLE (YES) ,那么不能指定 LOCALQ (YES)。
有关 EXEC CICS START 命令调用的路由事务的增强方法和传统方法的详细信息,请参阅 START 命令调用的路由事务。
- RSL
- 该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
- RUNAWAY({SYSTEM|0|250-2700000})
- 在此事务定义下运行的任何任务在假定处于失控状态 (逻辑循环) 之前可以控制处理器的时间 (以毫秒为单位)。 当此时间间隔到期时, CICS 可能会异常结束该任务。
- 系统
- CICS 将使用 ICVR 系统初始化参数值作为此事务的失控时间限制。
- 0
- 不应用任何限制,并且不需要对事务进行失控任务检测。
- 250-2700000
- 范围在 250 到 2700000 之间的失控时间限制。 检查任务是否处于失控状态时, CICS 会将您指定的值向下舍入到 250 的倍数。
- SHUTDOWN({DISABLED|ENABLED})
- 适用于所有事务,并指定在 CICS 关闭期间是否可以运行该事务。 此选项补充 PERFORM SHUTDOWN 命令的 XLT 选项。 对于要在关闭期间连接的事务,必须将其定义为 SHUTDOWN (ENABLED) ,或者在基于终端的事务的情况下,在 PERFORM SHUTDOWN 命令中指定的 XLT 中进行命名。
- 已禁用
- 在 CICS 关闭期间,将禁止事务运行。
- ENABLED
- 允许事务在 CICS 关闭期间运行。
- SPURGE({YES|NO})
- 指定事务最初是否为 system purgeable 。SPURGE=NO 可防止通过以下方式清除事务:
- 死锁超时 (DTIMOUT)
- EXEC CICS ... PURGE 命令
- 正在节点错误程序 (NEP) 中设置 TWAOCT (取消任务)
- CEMT SET ... PURGE 命令
SPURGE=YES 允许对用户进行此类清除。 但是,如果在事务到达时允许清除是不安全的,那么 CICS 可能会阻止清除。
请注意, SPURGE=NO 不会阻止读超时 (RTIMOUT) 工具 (EXEC CICS SET ...) 清除事务。 FORCEPURGE 命令或 CMT SET TRANSACTION (TRANID) FORCEPURGE 命令。 SPURGE 仅确定初始值,该初始值可以由事务在运行时更改。- 是
- 该事务最初是可系统清除的。
- NO
- 该事务最初不是系统可清除的。
- STATUS({ENABLED|DISABLED})
- 指定事务状态。
- 已启用
- 允许事务正常运行。
- DISABLED
- 阻止事务运行。
对于 CICS 束动态生成的 TRANSACTION 资源,将忽略此属性。 TRANSACTION 资源的初始状态派生自定义该资源的捆绑软件的初始状态。
- STORAGECLEAR({NO|YES})
- 指定是否要在释放时清除该事务的任务生存期存储器。 使用 STORAGECLEAR 可防止其他任务意外地查看此事务在任务生存期存储器中存储的任何机密或敏感数据。
- TASKDATAKEY({USER|CICS})
- 指定 CICS 在任务初始化期间分配的存储器的存储器密钥 (任务生存期存储器) ,应用程序可访问该存储器。 这些存储区域是 EXEC 接口块(EIB)和事务工作区(TWA)。TASKDATAKEY 还指定 CICS 代表在事务下运行的所有程序获取的存储器的密钥。 CICS 在指定键中分配的与程序相关的存储器包括以下项:
- CICS 为应用程序的每次运行获取的工作存储器的副本。
- CICS 为程序获取的存储器,用于响应隐式和显式 GETMAIN 请求。 例如,程序可以通过 GETMAIN 或 GETMAIN64 命令请求存储器,或者作为其他 CICS 命令上的 SET 选项的结果。
如果事务中的任何程序是使用 EXECKEY (USER) 定义的,那么必须指定 TASKDATAKEY (USER)。 如果为事务指定 TASKDATAKEY (CICS) ,那么尝试在此事务下的用户密钥中运行任何程序将导致任务异常终止,异常终止代码为 AEZD。- 用户
- CICS 获取此事务的用户密钥存储器。 在任何密钥中运行的应用程序都可以读取和修改这些存储区域。
使用隔离 (YES) 定义的事务的用户密钥程序只能访问其自己的任务的用户密钥任务生存期存储器。
使用隔离 (NO) 定义的事务的用户键程序也可以访问使用隔离 (NO) 定义的其他任务的用户键任务生存期存储。
有关任务存储器保护的更多信息,请参阅 PROGRAM 定义中 EXECKEY 属性的描述。
- CICS
- CICS 获取此事务的 CICS密钥存储器。 在 CICS 密钥中运行的应用程序可以读取和修改这些存储区域。 在用户密钥中运行的应用程序只能读取这些存储区域。
- TASKDATALOC({ANY|BELOW})
- 指定 CICS 在事务持续时间内获取的任务生存期存储器是否可以位于虚拟存储器中的 16 MB 界线上。 这些与特定 CICS 任务相关的区域包括 EXEC 接口块(EIB)和事务工作区(TWA)。
如果构成事务的任何程序以 24 位寻址方式运行,那么必须指定 TASKDATALOC (BELOW)。 此限制也适用于代表事务运行的与任务相关的用户出口)。
对于未满足任何条件的事务,可以指定 ANY 以降低相关联的虚拟存储器约束。
CICS 监视 TASKDATALOC (ANY) 的使用,特别是以下操作:- 尝试调用在使用 TASKDATALOC (ANY) 定义的事务下运行的 AMODE 24 程序会导致 AEZC 异常终止。
- 在指定了 TASKDATALOC (ANY) 的情况下运行 AMODE (24) 时尝试发出 EXEC CICS 命令或调用与任务相关的用户出口会导致 AEZA 异常终止。
- 作为带有 TASKDATALOC (ANY) 的事务运行的 AMODE 31 程序尝试调用强制运行 AMODE (24) 的任务相关用户出口,导致 AEZB 异常终止。
- 如果为任务启动启用了强制在 AMODE 24 中运行的任务相关用户出口,那么对于 CICS 运行的其余部分中的所有事务, CICS 将强制 TASKDATALOC (BELOW)。
- 任何
- CICS 为事务获取的存储区域可以位于虚拟存储器中 16 MB 界线以上或以下。
- BELOW
- CICS 为事务获取的存储区域必须位于 16 MB 界线以下。
- TASKREQ(值)
- 指定是通过按功能 (F 或 PF) 键,使用光笔还是使用卡来启动事务。 可能的值包括:
- PA1、PA2 或 PA3(表示 PA 键)。
- PF1 到 PF24 表示功能键。
- OPID(表示操作员标识读卡器)。
- LPA(表示 3270 设备上的光笔可检测字段)。
- MSRE(表示 10/63 字符磁槽阅读器)。
对于 PA 和 PF 键,请注意以下事项:- 如果在 PRINT 系统初始化参数中指定了 PA 或 PF 键,那么不能使用与 TASKREQ 相同的 PF 键来启动事务。
- 在 SKRxxxx 系统初始化参数中指定为页面检索键的 PA 或 PF 键将在页面检索会话期间解释为此类键。 您可以使用相同的密钥在其他时间启动事务。 使用以下值定义密钥:
TASKREQ=KEY-ID PROGRAM=DFHTPR TWASIZE=1024 TPURGE=NO SPURGE=NO - 如果使用 PROGRAM (DFHTPR) 定义事务并定义 TASKREQ 密钥,那么该密钥将启动事务并同时打开页面检索会话。
- TCLASS
- 该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
- TPNAME(名称)
- 如果 TRANSACTION 属性的 4 字符长度限制过于严格,那么指定 APPC 伙伴可以使用的事务的名称。 该名称的最大长度为 64 个字符。
如果此字符范围不足以用于要指定的名称,那么可以使用 XTPNAME 属性来代替 TPNAME。可接受的字符: A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < > - TPURGE({YES|NO})
- 仅对于非z/OS Communications Server 终端,指定是否可以由于终端错误而清除事务。
- 是
- 当发生终端错误时,可以清除该任务。
- NO
- 发生终端错误时,无法清除任务。 发生这种情况时,需要主终端操作员进行手动干预。
- TRACE({YES|NO})
- 指定是否要跟踪该事务的活动。
- 是
- 跟踪此事务的活动。
- 否
- 请勿跟踪此事务的活动。
CICS为 CEDF 和 CSGM 提供的事务定义指定 TRACE (NO)。
- TRANCLASS(DFHTCL00|tranclass)
- 指定事务所属的事务类的名称。 属于事务类的事务在被允许运行之前受调度约束。 保留的 TRANCLASS 名称 DFHTCL00 用于标识不属于任何事务类的事务。
如果运行事务并且未安装其关联的 TRANCLASS 定义,那么该事务将在没有 TRANCLASS 中指定的任何调度约束的情况下运行。 发出消息 DFHXM0212 作为警告。
TRANCLASS 的长度最多可以为 8 个字符。
可接受的字符:
除非使用 CREATE 命令,否则您输入的任何小写字符都将转换为大写。A-Z 0-9 $ @ # - TRANSACTION(名称)
- 指定事务或事务标识 (TRANSID) 的名称。 该名称的最大长度为 4 个字符。
可接受的字符: A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >最好不要使用以 C 开头的名称,因为此字符保留供 CICS使用。 当您升级或提供新功能或修订时, CICS 可能会删除或废弃此类资源,并将其替换为 CICS 资源。
注:- 如果在名称中使用逗号 (,) ,那么不能使用如下命令:
其中逗号用作列表定界符。 有关使用资源标识列表的信息,请参阅 资源标识列表 。CEMT INQUIRE TRANSACTION(value1,value2) CEMT SET TRANSACTION(value1,value2) - 如果使用 RACF®保护瞬时数据队列,请避免在名称中使用
%和&。 当在概要文件名称中使用这些字符时, RACF 命令会对这些字符指定特殊含义。 请参阅 事务安全性 (Transaction security)。
如果要在事务标识中使用其他特殊字符,请使用 XTRANID 属性指定可用于启动事务的其他名称。 您还必须指定 TRANSACTION 名称,因为此名称是 CSD 文件上已知 TRANSACTION 定义的名称。
定义事务时,还必须指定 PROGRAM 或 REMOTESYSTEM。
- 如果在名称中使用逗号 (,) ,那么不能使用如下命令:
- TRANSEC
- 该属性已过时,但仍受支持,用于提供与 CICS 较早发行版的兼容性。
- TRPROF({DFHCICSS|概要文件})
- 指定在 ISC 事务路由期间携带系统间流的会话的 PROFILE 的名称。 该名称的最大长度为 8 个字符。
可接受的字符: A-Z a-z 0-9 $ @ # . / - _ % & ? ! : | " = ¬ , ; < >只能对远程事务指定此选项。
- TWASIZE({0|number})
- 指定要为此事务获取的事务工作区的大小 (以字节计)。 指定范围为 0-32767 的 1 到 5 位十进制值。注:
- 如果 TWASIZE 太小,那么您的存储器可能已损坏。
- 请勿更改 CICS提供的事务的 TWASIZE。
- WAIT({YES|NO})
- 指定不确定工作单元 (UOW) 是否要等待,暂挂从 UOW 进入不确定状态后发生的故障恢复。
CICS接受使用 INDOUBT (WAIT) 的旧式事务定义,并将其解释为 WAIT (YES) ACTION (BACKOUT)。
- 是
- UOW 将等待故障恢复,以解决其不确定状态,并确定是要回退还是落实可恢复资源。 换言之, UOW 将被 搁置。可恢复资源可以包括下列其中一项:
- DBCTL 数据库
- DB2® 数据库
- 临时存储器队列
- 在 TDQUEUE 定义中指定 WAIT (YES) 的逻辑可恢复分区内瞬时数据队列
- VSAM 数据集
- BDAM 数据集
如果以下选项都不适用,那么 WAIT (YES) 选项将生效 :- 该事务具有到备份级别系统的下级 MRO 会话。
- 事务具有 LU6.1 下级会话。 请注意,在此上下文中, LU6.1 IMS 会话不是下级会话。
- 该事务有多个会话,其协调程序会话是针对后级系统或 LU6.1的。
- 连接到事务的任务相关用户出口不支持 CICS 不确定协议。
如果先前的异常都不适用,但您将下级 LU6.2 会话连接到不使用 CICS Transaction Server for z/OS 不确定体系结构的 CICS Transaction Server for z/OS 系统以外的系统,那么 CICS 可以通过强制会话中断来指示下级必须等待。
如果任何资源无法等待协调程序的不确定解析,那么将根据 ACTION 属性对事务作出决策。 在实践中,以这种方式强制决策的唯一情况是使用 TDQUEUE 定义中指定的 WAIT (NO) 更新瞬时数据队列,以及安装与终端相关的资源。 后者通常使用 INSTALL 命令进行安装。
表 1 显示了在 TRANSACTION 定义上定义的 WAIT 属性与逻辑上可恢复的 TDQUEUE 定义发生冲突时如何解析这些属性。
- 否
- UOW 不等待。 CICS 立即采取 ACTION 属性上指定的操作。
表 1. TRANSACTION 和 TDQUEUE 定义上的 WAIT 属性的解析 TDQUEUE 定义的 WAIT 属性 TDQUEUE 定义的 WAITACTION 属性 TRANSACTION 定义的 WAIT 属性 操作 否 不适用 YES TD WAIT (NO) 覆盖 TRANSACTION 定义上的 WAIT (YES)。 根据事务的 ACTION 属性,强制 UOW 落实或回退。 否 不适用 否 根据事务的 ACTION 属性,强制 UOW 落实或回退。 YES QUEUE YES UOW 等待; 即,它被搁置。 来自另一个任务的对 TD 队列的锁定的请求必须等待,并且由 CICS进行排队。 YES QUEUE 否 事务 WAIT (NO) 覆盖 TDQUEUE 定义。 根据事务的 ACTION 属性,强制 UOW 落实或回退。 YES 拒绝 YES UOW 等待; 即,它被搁置。 来自另一个任务的对 TD 队列的锁定的请求被拒绝,条件为 LOCKED。 YES 拒绝 否 事务 WAIT (NO) 覆盖 TDQUEUE 定义。 根据事务的 ACTION 属性,强制 UOW 落实或回退。 如果 UOW 引用多个瞬时数据队列,并且这些队列具有不一致的 WAIT 选项,那么 WAIT (NO) 始终优先并覆盖 WAIT (YES)。 因此,一个 TDQUEUE 定义上的 WAIT (NO) 强制失败的不确定 UOW 采用 UOW 的 TRANSACTION 定义上定义的 BACKUP 或 COMMIT 属性。
- WAITTIME({00,00,00|dd , hh , mm})
- 根据 ACTION 属性中指定的内容,指定事务在作出有关不确定工作单元的决策之前要等待的时间长度。
- 00,00,00
- 事务无限期等待。
- dd , hh , mm
- 事务要等待的时间 (以天,小时和分钟为单位)。 最大值为 99,23,59。
仅当指定了 WAIT (YES) 时, WAITTIME 才会生效。
- XTPNAME(值)
- 您可以使用此属性作为 TPNAME 的替代方法。 输入长度最多为 128 个字符的十六进制字符串,表示 APPC 伙伴可以使用的事务的名称。 所有十六进制组合都可接受 ,但 X'40 ' 除外。 要对 DFHCSDUP 指定长度超过 72 个字符的 XTPNAME ,请在第 72 列中放入星号。 星号会将以下行并置到当前行。
- XTRANID(xtranid)
- 指定要用于启动事务的另一个名称,而不是 TRANSACTION 名称。 该名称的长度最多可以是 8 个十六进制数字。 由于 XTRANID 是以十六进制格式指定的,因此您可以在名称中使用无法在 TRANSACTION 属性中指定的字符。另请参阅 TASKREQ ,这是可以指定的另一个事务别名。
- 值
- 以十六进制表示法表示的 4 字节事务标识; 因此,该标识最多使用 8 个十六进制数字。 如果指定少于 8 个十六进制数字,那么将在右边用空格填充标识。某些值保留供 CICS使用,因此您可以指定的值受到限制:
- 第一个字节不得为 X'C3'。
- 第一个字节不得小于或等于 X'40 '。
- 该值不得为 X'00000000 '。
- 最后 3 个字节不得为 X'FFFFFF '。
