INQUIRE BRFACILITY
检索有关由 3270 网桥机制使用的虚拟终端（网桥设施）的信息。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: END ， ILLOGIC ， NOTAUTH 和 NOTFOUND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
描述
INQUIRE BRFACILITY 命令返回有关网桥设施的信息。 这是 3270 网桥机制在桥接环境中运行 CICS® 3270 应用程序时用于模拟实际 3270 的虚拟终端。 您可以在创建了网桥设施的 Link3270 网桥程序或 AOR 区域中运行的任何应用程序中使用此命令，以检索有关任何活动网桥设施的信息，即使它不是您的主设施也是如此。
浏览
您还可以使用 INQUIRE BRFACILITY 命令上的浏览选项 (START ， NEXT 和 END) 来浏览系统中安装的网桥设施。 请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。
选项
- BRFACILITY (data-value)
- 指定要查询的网桥设施的 8 字节的设施令牌。
- KEEPTIME (数据区)
- 返回完整的词二进制字段，其中显示网桥设施在处于不活动状态时保留的时间长度 (以秒计)。
- 如果要显示的网桥设施是 Link-Bridge ，那么此值是分配该设施时指定的时间，或者缺省值为 5 分钟。 如果 KEEPTIME 值大于 BRMAXKEEPTIME 系统初始化参数的值，那么会将其降为 BRMAXKEEPTIME。
- 如果要显示的设施是 Web 网桥，那么 KEEPTIME 值最初设置为 Webdelay 终端保留时间 ( WEBDELAY 系统初始化参数的第二部分)。
- LINKSYSNET (数据区)
- 如果 Link3270 网桥请求路由到另一个区域，那么返回 AOR 的 8 字节 applid。 如果在与 Link3270 网桥程序相同的区域中处理请求，那么此字段为空。 如果动态事务路由多次尝试在 Link3270 会话中运行第一个事务，那么此字段可能会更改。 此字段仅在 Link3270 网桥程序区域中设置。
- LINKSYSTEM (data-area)
- 如果 Link3270 网桥请求路由到另一个区域，那么返回 AOR 的 4 字节 SYSID。 如果在与 Link3270 网桥程序相同的区域中处理请求，那么此字段为空。 如果动态事务路由多次尝试在 Link3270 会话中运行第一个事务，那么此字段可能会更改。 此字段仅在 Link3270 网桥程序区域中设置。
- 名称空间 (cvda)
- 返回 CVDA 值，指示用于分配网桥设施名称的名称空间的作用域。 CVDA 值包括：
- LOCAL
- 网桥设施由 START BREXIT 网桥机制分配，因此其名称仅在创建该网桥设施的本地区域中唯一。
- 共享
- 网桥设施是由 Link3270 网桥机制分配的，因此其名称在 CICSplex 中所有有权访问共享 DFHBRNSF 名称空间文件的 CICS Link3270 网桥区域中是唯一的。
- NETNAME (data-area)
- 指定要查询的网桥设施的 8 字节虚拟网络名。
- REMOTESYSNET (数据区)
- 返回 8–byte 字段，提供路由器的 APPLID。 此字段仅在 AOR 区域中设置。 如果 AOR 是路由器区域，那么该值为空白。
- REMOTESYSTEM (数据区)
- 返回给出路由器 SYSID 的 4 字节。 此字段仅在 AOR 区域中设置。 如果 AOR 是路由器区域，那么该值为空白。
- TASKID (data-area)
- 返回完整的字二进制字段，其中显示运行用户事务的任务的编号。 此字段仅在 AOR 中设置。 此字段为零，表示网桥设施当前未在使用。
- TERMID (数据区)
- 指定要查询的网桥设施的 4 字节虚拟终端名称。
- TERMSTATUS (cvda)
- 返回 CVDA 值，指示网桥设施的状态。 CVDA 值包括：
- ACQUIRED
- 桥梁设施目前正在使用中。
- AVAILABLE
- 网桥设施未在使用中。 它可由客户机复用。
- RELEASED
- 已针对网桥设施发布 SET BRFACILITY。 它将在下一个清除周期中被删除。
- TRANSACTION (数据区)
- 返回一个 4 字节字段，该字段提供由 3270 网桥运行的用户事务的名称 (在当前区域中已知)。 如果网桥设施当前未在使用中，那么此值为空。
- USERID (数据区)
- 返回一个 8 字节字段，该字段提供与此网桥设施相关联的用户标识。
条件
- END
- RESP2 值：
- 1
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值：
- 1
- 当浏览此资源类型时，您已发出 START 命令，或者当浏览此资源类型时，您已发出 NEXT 或 END 命令。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- 未找到
- RESP2 值：
- 1
- 找不到指定的网桥设施。