FEPI INQUIRE CONNECTION

查询 FEPI 连接。

FEPI INQUIRE CONNECTION

备注信息：

描述

FEPI INQUIRE CONNECTION 返回有关 FEPI 连接的信息。通过指定其目标和节点来标识连接。

以下命令允许您浏览所有 FEPI 连接。

FEPI INQUIRE CONNECTION START
FEPI INQUIRE CONNECTION NEXTNODE|NEXTTARGET
NODE(8-character data-area)
TARGET(8-character data-area)
[The options are as for FEPI INQUIRE CONNECTION]
FEPI INQUIRE CONNECTION END

条件:

INVREQ,
NOTAUTH

返回信息的下一个连接取决于是否指定了 NEXTNODE 或 NEXTTARGET。如果指定了 NEXTNODE ，那么返回的信息如下所示:

连接到当前目标的下一个节点
如果没有更多节点连接到当前目标，那么第一个节点连接到下一个目标。

如果指定了 NEXTTARGET ，那么返回的信息如下所示:

连接到当前节点的下一个目标
如果没有更多目标连接到当前节点，那么第一个目标连接到下一个节点。

选项

ACQNUM (全字二进制数据区域)

返回已获取连接的次数。

ACQSTATUS (cvda)

返回获取状态; 即，是否绑定了连接上的会话。相关 CVDA 值如下所示:

ACQUIRED: 会话已绑定。
ACQUIRING: 已请求状态 ACQUIRED ，但尚未完成绑定会话。
RELEASED: 未绑定任何会话。
RELEASING: 已请求 RELEASED 状态，但尚未完成对会话的取消绑定。

If ACQUIRING or RELEASING persist, the operator might need to intervene using z/OS® Communications Server commands to recover the connection.

CONVNUM (全字二进制数据区域)

返回已使用连接的对话数。

INSTLSTATUS (cvda)

返回连接的安装状态。相关 CVDA 值如下所示:

已安装: 该连接位于 INSTALL 定义的池中，可供使用。
未安装: 连接位于池中，或者涉及正在废弃但仍在使用的节点或目标。

LASTACQCODE (全字二进制数据区)

返回连接的最后一个获取请求的结果; 即，来自最后一个 z/OS Communications Server VTAM ® REQSESS 的检测代码，零表示成功。

注: 可以在此字段中返回 CLSDST (PASS) X'32020000 ' 。这是 CICS® 在 CLSDST (PASS) 处理期间接收到的取消绑定流。

有关 z/OS Communications Server 检测代码的详细信息，请参阅 z/OS Communications Server: IP and SNA Codes。

NODE (8 个字符 data-value/8-character data-area)

标识连接的节点。

池 (8 个字符的数据区域)

返回定义连接的池的名称。

服务器状态 (cvda)

返回连接的服务状态。相关 CVDA 值如下所示:

INSERVICE: 连接在服务中，可以在对话中使用。
OUTSERVICE: 连接不起作用，不能用于任何新对话，但使用该连接的对话不受影响。服务状态为 GOINGOUT ，直到任何此类对话结束。
GOINGOUT: 已请求 OUTSERVICE 状态，但某些对话仍在使用该连接。

状态 (cvda)

返回使用连接的对话的状态。相关 CVDA 值如下所示:

NOCONV: 没有任何对话在连接上处于活动状态。
PENDSTSN: 已调度 STSN 处理任务。
STSN: STSN 处理任务拥有对话。
暂挂开始: 已调度开始会话处理任务。
BEGINSESSION: 开始会话处理任务拥有对话。
应用程序: 正常应用程序任务拥有对话。
养恤金数据管理协会: FEPI 正在等待入站数据，请遵循 FEPI START 命令。
暂挂启动: 入站数据已到达，已调度由 FEPI START 指定的任务。
无暂挂: 在 FEPI FREE 命令之后，已调度结束会话处理任务。
FREE: 在 FEPI FREE 命令之后，结束会话处理任务拥有对话。
暂挂发行版: 在取消绑定请求之后，已调度结束会话处理任务。
RELEASE: 在执行取消绑定请求之后，结束会话处理任务拥有对话。
暂挂索尔: 已调度非请求的数据处理任务。
UNSOLDATA: 非请求的数据处理任务拥有对话。
养恤金: 在执行 FEPI FREE PASS 命令之后，对话是无主的。

暂挂状态指示对话未拥有，暂挂所指示的事件或任务; 当任务发出 FEPI ALLOCATE PASSCONVID 命令时，状态不再处于暂挂状态。如果暂挂状态仍然存在，那么可能是应用程序以某种方式失败; 请考虑通过发出 FEPI SET CONNECTION RELEASED 来重置连接。

TARGET (8 个字符 data-value/8-character data-area)

标识连接的目标。

USERDATA (64 个字符的数据区)

返回连接的用户数据。如果未设置任何用户数据，那么将返回空值。

WAITCONVNUM (全字二进制数据区)

返回正在等待开始使用连接的对话数。如果对话可以使用多个连接中的任何一个，那么会将其计算为等待每个连接。

条件

ILLOGIC

RESP2 值：

1: 对于 START: 此资源类型的浏览已在进行中。对于 NEXT 或 INQUIRE: 未发出 END。

END

RESP2 值：

2: 对于 NEXT: 已检索所有资源定义。

INVREQ

RESP2 值：

116: TARGET 名称未知。
117: NODE 名称未知。
118: 连接未知 (已知 TARGET 和 NODE 名称，但不在公共池中)。