Link3270 编程注意事项

用户事务未更改,但鉴于它现在在网桥环境中的执行方式,对可执行的操作有一些限制,并且因为它不是真正的终端,对如何使用网桥设施有一些限制。

您可以使用 "装入模块扫描程序" 实用程序 (如 管理 CICS 操作中所述) ,使用提供的表 DFHEIDBR 来标识程序中不受网桥支持的任何 CICS® 命令。

注: 网桥仅支持有效记录的 CICS API 接口。 如果应用程序或供应商程序使用未记录的接口,那么结果将不可预测。
异常终止信息
在由于异常终止而生成的任何诊断信息中,网桥设施名称不用作 TERMID ,但在事务转储中除外。
ASSIGN
如果用户事务发出 ASSIGN NETNAME ,那么返回的值为 NETNAME (如果有) 或 TERMID。 该名称在用户事务外部不可见,并且可能包含 "}" 个字符。

仅当映射集中存在 ADS 描述符时,才能使用 ASSIGN 来请求有关 MAPCOLUMN , MAPHEIGHT , MAPLINE 和 MAPWIDTH 等 BMS 属性的信息。 请参阅 应用程序数据结构 (ADS)

BMS 请求
Link3270 网桥支持以下 BMS 命令。 如果使用需要主体设施的其他 BMS 功能,那么会导致用户事务异常终止 ABR3。
RECEIVE 命令
  • 接收映射终端
  • RECEIVE MAP 源
  • RECEIVE MAP MAPPINGDEV
注: 如果既未指定 TERMINAL ,也未指定 FROM ,那么将隐含 TERMINAL。
SEND 命令
  • 发送映射终端
  • 发送文本终端
  • 发送文本 Noedit 终端
  • 发送文本映射终端
  • 发送控制终端
  • 发送映射集
  • SEND 文本集
  • 发送文本 Noedit 集
  • 发送文本映射集
注:
  1. 如果未指定 TERMINAL , SET 或调页,那么意味着 TERMINAL。
路由
支持从在网桥设施上运行的事务路由到实际终端,但无法路由到网桥设施,也无法将网桥设施指定为 ROUTE 上的 ERRTERM。 如果在网桥环境中发出的 ROUTE 请求上指定了不带名称的 ERRTERM ,那么将产生之逆条件。

仅在路由下支持调页。

分区
支持与分区相关的命令和选项,但这些命令和选项的处理方式与不支持分区的实际终端相同。
SEND PARTNSET
受支持,但未调用网桥出口。
RECEIVE PARTN
受支持; 使用为终端控制 RECEIVE 设置的网桥出口区域命令字段来调用网桥出口。
INPARTN
已接受但已忽略; 未传递到网桥出口。
输出参数
已接受但已忽略; 未传递到网桥出口。
ACTPARTN
已接受但已忽略; 未传递到网桥出口。
CICS 提供的事务
CEDF , CEDX , CSFE 和 CSGM 不能作为用户事务运行。
Db2® 授权检查
请勿在 DB2CONN 定义中使用 AUTHTYPE (TERM) 或 AUTHTYPE (OPID) 设置,因为这些安全性检查在网桥环境中失败。
外部安全性定制
在 DFHXSID 参数列表中未传递 TERMID , OPID 和 TCTUA 信息。
全局用户出口
由于网桥设施不是实际终端,因此 驱动以下全局用户出口 (GLUEs)。
XBMIN
以拦截 RECEIVE MAP 请求。
XBMOUT
以拦截 SEND MAP 请求。
XTCATT
在任务连接之前。
XZCATT
在任务连接之前 ( z/OS® Communications Server SNA)。
XZCIN
在输入事件 ( z/OS Communications Server SNA) 之后。
XZCOUT
在输出事件 ( z/OS Communications Server SNA) 之前。
XZCOUT1
在将消息分解为 RU 之前 ( z/OS Communications Server SNA)。

如果对网桥设施发出请求,那么可以驱动 XALTENF 和 XICTENF 出口。 由于网桥设施不是实际终端,因此会出现 "未找到终端" 情况。

没有为网桥任务下调用的出口设置指向 TERMID 的标准用户出口参数列表字段 UEPTERM。

ISSUE PASS
不支持 ISSUE PASS ,这将生成 INVREQ。
ISSUE PRINT
ISSUE PRINT 不受支持,并导致 no-op。 返回 NORMAL 条件。
监视
3270 网桥事务标识存在于监视记录中。
远程 DLI 请求数
不会对功能交付的 DLI 请求执行针对终端的 PSB 安全性检查。
安全处理
创建网桥设施时,将使用客户机的 USERID 作为预设 USERID 终端登录。 与其他预设终端一样,不允许 SIGNON 和 SIGNOFF 命令,并且会产生 INVREQ。

当废弃网桥设施时,会将其注销。 在发送特定删除设施请求或 keeptime 时间间隔到期之前,它保持以会话方式登录。

START
用户事务可以针对其自己的网桥设施发出 EXEC CICS START 请求。 这允许使用此接口的现有菜单驱动和伪会话应用程序在网桥环境中工作。 请参阅 伪会话事务 以获取 START TERMID 的描述,其中 TERMID 指定网桥设施。

时间延迟选项 (INTERVAL , TIME , AFTER , AT , HOURS , MINUTES , SECONDS) 通常不会在网桥环境中使用,但网桥机制使用它们来将特定网桥设施的 START 按时间顺序放置,但未实现所请求的确切延迟。 完全忽略 TIME 和 AT 规范。

START 命令上的其他选项部分受支持:
TERMID
您可以为此事务或任何实际终端指定自己的网桥设施的名称。
USERID
USERID 和 TERMID 互斥。 CICS 转换程序拒绝同时指定了 USERID 和 TERMID 的 START 请求。
TRANSID
如果 TRANSID 无法定义为 REMOTE ,那么如果将请求发送到远程系统,那么将找不到 TERMID。
SYSID
在网桥环境中无法路由 START 请求。 不支持此选项,除非 SYSID 的值是本地 SYSID。 如果指定任何其他值,那么将发送请求,并且在远程系统上找不到 TERMID。
NoCheck
此选项仅适用于已交付的启动请求,将被忽略。
保护
如果对网桥设施的 START 请求指定 PROTECT 选项,并且启动任务在获取同步点之前异常终止,那么将废弃 START 请求。 PROTECT 通常会延迟新任务的启动,直到发生 SYNCPOINT。 对于为其自己的设施发出 START 的任务,会自动发生此情况,因为在启动任务终止并释放其网桥设施之前, START 无法生效。
启动的事务
某些菜单应用程序使用 START 来启动后续事务。

您可以在单个事务方式请求消息的 BRIH-STARTCODE 字段中或在会话方式伪对话的第一个事务中指定 BRIHSC-START ,以返回对用户事务发出的 ASSIGN STARTCODE 和 INQUIRE TASK STARTCODE 命令的正确响应。

START 启动的用户事务可能会发出一个或多个 RETRIEVEs 以获取 START 上传递的数据。 当网桥已传递 Link3270 请求消息中提供的所有数据时,将向用户事务返回 ENDDATA。

统计信息
如果 xxxx 是网桥设施,那么不能使用 EXEC CICS COLLECT STATISTICS TERMINAL(xxxx)
存储器违例计数
没有存储违例计数将保留在网桥设施中。
TCTUA
TCTUA 可用于使用 EXEC CICS ADDRESS 命令的用户事务。 您可以使用 XFAINTU 全局用户出口来修改 TCTUA 的内容。 请注意, TCTUA 不可用于由用户事务使用 DPL 链接到的其他 CICS 区域中的任何程序。
事务重新启动
由于 CICS 无法复原初始输入消息,因此对用户事务强制 RESTART (NO)。
事务路由
不直接支持事务路由,请参阅 事务路由注意事项 以了解您可以使用的方法。 Link3270 网桥支持具有亲缘关系的工作负载均衡。
TWA
TWA 可用于用户事务。