START BREXIT
在 3270 网桥环境中启动任务,然后将其与指定的网桥出口关联。
另请参阅:
语法
条件: INVREQ , REGERR , NOSTART , NOTAUTH , PGMIDERR , TRANSIDERR 和 USERIDERR
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 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 不启动
- 在废弃启动任务的请求时发生。
- 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)
⋮
