START BREXIT

在 3270 网桥环境中启动任务,然后将其与指定的网桥出口关联。

语法

START BREXIT

读取语法图跳过可视语法图STARTBREXITBREXIT( 名称)TRANSID( 名称)BRDATA( data-area)BRDATALENGTH( data-value)USERID( data-value)

条件: INVREQ , REGERR , NOSTART , NOTAUTH , PGMIDERR , TRANSIDERR 和 USERIDERR

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

描述

START BREXIT 在本地 CICS® 区域中立即启动任务,并初始化指定的事务 (TRANSID) 和网桥出口 (BREXIT)。 在 3270 网桥环境中,由 TRANSID 指定的事务发出的所有 3270 终端请求都将被拦截并传递到 BREXIT 指定的用户可替换程序 (网桥出口)。

网桥出口 (BREXIT) 通过将终端请求传递到可能在 CICS内部或外部执行的客户机应用程序来模拟 3270 接口。

有关 3270 网桥及其接口的更多信息,请参阅 3270 网桥简介

无法取消连接的任务; 其 STARTCODE 由网桥出口定义。

选项

BREXIT (名称)
指定要与启动式任务关联的网桥出口的名称 (1-8 个字符)。 如果未指定名称,那么将使用 TRANSID 的 TRANSACTION 资源定义上的 BREXIT 值。
BRDATA (数据区)
指定要在任务启动时传递到 BREXIT 指定的网桥出口的数据。
BRDATALENGTH (data-value)
指定一个全字二进制数据值,该值是启动任务时要传递到 BREXIT 指定的网桥出口的 BRDATA 的长度。
TRANSID (名称)
指定要由 START BREXIT 命令启动的任务执行的事务的符号标识 (1-4 个字符)。 事务在 3270 网桥环境中启动,并与 BREXIT 中指定的网桥出口关联执行。

TRANSID 选项用于收集的先前中继段数据。 请参阅 关联数据 ,以获取有关将 TRANSID 选项与先前中继段数据配合使用的更多信息。

USERID (data-value)
指定要运行已启动事务的权限所使用的用户标识。

条件

16 INVREQ
RESP2 值:
11
尝试路由 START BREXIT 请求。
12
START BREXIT 请求失败。
18
指定了 USERID 选项,但未初始化 CICS 外部安全管理器接口。

缺省操作: 异常终止任务。

22 LENGERR
在 BRDATALENGTH 不大于零时发生。

缺省操作: 异常终止任务。

6.2 后来 10 不启动
在废弃启动任务的请求时发生。
RESP2 值:
1
已达到指定事务所属的 TRANCLASS 的 PURGETHRESH 限制,将废弃该请求 (如 PURGEACTION DISCARD 所设置)。
70 NOTAUTH
RESP2 值:
7
对 TRANSID (名称) 执行资源安全性检查失败。
9
对 USERID (name) 进行代理用户安全性检查失败。 发出该命令的事务的安全访问功能不允许使用 USERID 选项中指定的值执行该命令。

缺省操作: 异常终止任务。

27 PGMID错误
如果 BREXIT 选项未提供名称,并且 TRANSID 的事务定义未提供缺省 BREXIT 名称,那么将发生此情况。

缺省操作: 异常终止任务。

28 跨铁
如果尚未向 CICS定义 START BREXIT 命令中指定的 TRANSID ,那么将发生此情况。
RESP2 值:
11
指定的事务定义为远程事务。

缺省操作: 异常终止任务。

69 个用户标识
RESP2 值:
8
RACF® 不知道指定的用户 ID。
10
RACF 处于以下状态: CICS 无法确定指定的用户标识是否有效。

缺省操作: 异常终止任务。

将数据传递到网桥出口

可以使用 BRDATA 和 BRDATALENGTH 选项将数据传递到网桥出口。

以下示例显示如何在 3270 网桥环境中启动指定的任务并将数据传递到其网桥出口:
EXEC CICS START BREXIT('DFH0CBRE')
          TRANSID('TRNL')
          BRDATA(BRSD)
          BRDATALENGTH(72)
⋮