开始浏览容器 (BTS)

启动与 BTS 活动或流程关联的容器的浏览。

语法

STARTBROWSE CONTAINER

读取语法图跳过可视语法图STARTBROWSECONTAINERACTIVITYID( data-value)PROCESS( data-value)PROCESSTYPE( data-value)BROWSETOKEN( data-area)

条件: ACTIVITYERR , IOERR , NOTAUTH 和 PROCESSERR

此命令是线程安全的。

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

STARTBROWSE CONTAINER 初始化浏览令牌,该令牌可用于标识与指定 BTS 活动或进程关联的每个数据容器的名称。
注: 仅应由发出 STARTBROWSE 命令的程序使用浏览令牌。

如果未指定 ACTIVITYI 或 PROCESS 选项,那么 CICS® 将检查请求的上下文 (通道或 BTS)。 如果存在当前通道,那么假定该命令是 STARTBROWSE CONTAINER (CHANNEL) 命令。 如果存在当前活动,那么将浏览其容器。 如果两者都不存在,那么将生成 ACTIVITYERR 2: 请参阅下面的 ACTIVITYERR 条件描述。

选项

ACTIVITYID (数据值)
指定要浏览其容器的活动的标识 (1-52 个字符)。

通常,此选项上指定的标识已在先前的 GETNEXT ACTIVITY 命令上返回。

BROWSETOKEN (数据区)
指定一个全字二进制数据区, CICS 将在该数据区中放置浏览令牌。
PROCESS (数据值)
指定要浏览其容器的进程的名称 (1-36 个字符)。
注: 与流程关联的容器 (流程容器) 在整个流程中全局可用。 它们与根活动的容器不同。
PROCESSTYPE (数据值)
指定在 PROCESS 选项上指定的进程的进程类型 (1-8 个字符)。

条件

109 个 ACTIVITYERR
RESP2 值:
1
找不到 ACTIVITYID 选项指示的活动。
2
未指定任何 ACTIVITYID , PROCESS 或 CHANNEL 选项,并且没有与请求关联的当前通道和当前活动。
29 日
存储库文件不可用。
30
在存储库文件上发生输入/输出错误。
17 IOERR
RESP2 值:
30
在存储库文件上发生输入/输出错误。
70 NOTAUTH
RESP2 值:
101
未授权与发出任务关联的用户以所请求的方式访问此资源。
108 进程
RESP2 值:
3
找不到在 PROCESS 选项上指定的进程。
4
找不到在 PROCESSTYPE 选项上指定的进程类型。
13
请求超时。 可能是另一个使用此进程记录的任务已被阻止结束。