DEFINE ACTIVITY

描述

DEFINE ACTIVITY 向 CICS 业务事务服务定义活动。 它用于向当前活动添加子活动。

执行新活动时使用的程序的名称取自 PROGRAM 选项，或者如果未指定 PROGRAM ，那么取自 TRANSID 选项所指向的事务定义。

在 TRANSID 和 USERID 选项上指定的事务属性在活动由 RUN 命令激活时生效，但如果该活动由 LINK 命令激活，那么 不 生效-请参阅 上下文切换。

在发出请求的事务成功获取同步点之前， BTS 不会落实添加活动。

选项

ACTIVITY (数据值)

指定新活动的名称 (1-16 个字符)。 该名称不能是发出 DEFINE 命令的活动的另一个子活动的名称。

The acceptable characters are A-Z a-z 0-9 $ @ # / % & ? ! : | " = ¬ , ; < > . - and _. 不允许使用前导和嵌入的空白字符。 如果提供的名称少于 16 个字符，那么将使用最多 16 个字符的尾部空格来填充该名称。

ACTIVITYID (数据区)

返回由 CICS 分配给新定义的活动的 52 个字符的标识。 此标识在整个综合系统中是唯一的。

EVENT (数据值)

指定活动的完成事件的名称 (1-16 个字符)。 完成事件将在活动完成时发送到活动的父代。

如果未指定 EVENT ，那么将为完成事件提供与活动本身相同的名称。

可接受的字符为 A-Z a-z 0-9 $@ #。 -和 _。不允许使用前导和嵌入的空白字符。 如果提供的名称少于 16 个字符，那么将使用最多 16 个字符的尾部空格来填充该名称。

PROGRAM (数据值)

指定要定义的活动的程序的名称 (1-8 个字符)。 如果未指定程序，那么将从 TRANSID 定义中获取名称。

TRANSID (数据值)

指定当 RUN 命令激活活动时要运行该活动的事务的名称 (1-4 个字符)。

注: 如果此活动由 LINK 命令激活，那么它将在发出 LINK 的事务的 TRANSID 下运行。

必须在运行进程的 CICS 区域中定义事务。

USERID (数据值)

指定当 RUN 命令激活活动时，该活动将在其权限下运行的用户标识 (1-8 个字符)。

注: 如果此活动由 LINK 命令激活，那么它将在发出 LINK 的事务的用户标识下运行。

此字段的值称为 定义的用户标识。

如果省略 USERID ，那么定义的用户标识将缺省为发出 DEFINE 命令的事务运行时所使用的用户标识-我们可以将此称为 命令用户标识。

如果指定了 USERID ，那么 CICS 会 (在定义时) 执行代理安全检查，以验证命令用户标识是否有权使用定义的用户标识。 因此，如果指定 USERID ，那么必须将命令用户标识授权为已定义用户标识的代理用户。

条件

109 个 ACTIVITYERR

RESP2 值：

3

ACTIVITY 选项上指定的名称已用于命名当前活动的另一个子项。

111 个 EVENTERR

RESP2 值：

7

在 EVENT 选项上指定的完成事件已定义到当前活动的事件池。

16 INVREQ

RESP2 值：

4

在当前活动的作用域外发出了 DEFINE ACTIVITY 命令。

17 日

在 ACTIVITY 选项上指定的活动名称或在 EVENT 选项上指定的事件名称无效。

17 IOERR

RESP2 值：

29 日

存储库文件不可用。

30

在存储库文件上发生输入/输出错误。

70 NOTAUTH

RESP2 值：

101

与发出任务关联的用户无权访问与要存储活动详细信息的 BTS 存储库数据集关联的文件。

102

未授权与发出任务关联的用户作为 USERID 选项上指定的已定义用户标识的代理。

28 TRANSIDERR

TRANSID 选项上指定的事务标识未定义到 CICS。