3270cn 特殊文件

用途

通过 3270 连接适配器设备处理程序提供对 3270 连接适配器的访问。

描述

3270cn 字符特殊文件提供对 3270 连接适配器设备处理程序的访问，以用于仿真 3270 显示站和打印机。 设备处理程序是一个多路复用设备处理程序，它支持其每个通道上的独立逻辑 3270 会话。

设备处理程序支持两种操作方式:

设备处理程序最多支持四个 3270 连接适配器，其中每个适配器最多可以有五个 DFT 会话或一个 CUT 会话。

/usr/include/sys/io3270.h 文件包含由设备处理程序使用的结构的定义。

使用注意事项

当访问 3270 连接设备处理程序时，应考虑下列各项:

子例程支持

3270 设备处理程序为以下子例程提供特定于 3270 的支持:

• 开
• 关闭
• 读
• 读 (仅限非 SNA DFT 方式)
• 写
• 写 (仅限非 SNA DFT 方式)
• ioctl

打开和关闭子例程

设备处理程序将 3270cn 特殊文件作为字符多路复用特殊文件来支持。 必须同时打开特殊文件以进行读写操作 (0-RDWR)。

对于关闭 3270cn 特殊文件，存在特殊注意事项。 如果同时以 CUT 方式和 CUT-文件传输方式打开文件，那么针对 CUT-文件传输方式的 关闭 操作必须在针对 CUT 方式的 关闭 操作之前。

开 调用中使用的特殊文件名采用几种不同的格式，具体取决于设备的打开方式。 特殊文件名的类型为:

在非 SNA DFT 方式下读取子例程

通信适配器从主机接收到的数据将放置在缓冲区中，直到消息完成或缓冲区已满为止。 当出现任一情况时，驱动程序会将程序控制返回给应用程序。 该应用程序可以通过发出 WDC_INQ ioctl 操作来确定 读 子例程调用的状态。

如果 WDC_INQ 操作返回指示有更多数据可用的状态，那么应用程序应立即发出另一个 读 调用。 必须尽快读取可用数据以避免降级链接或降低主机性能。

如果进行了 读 调用并且没有可用的数据，那么调用过程将被阻止，直到数据变为可用为止。 要避免阻塞，请使用 轮询 子例程来确定数据是否可用。

主机将数据作为出站 3270 数据流进行发送。 设备处理程序将转换出站 3270 数据流中的命令代码。 以下是命令代码和转换:

以 SNA DFT 方式读取子例程

与非 SNA DFT 方式不同，在 SNA DFT 方式下，设备驱动程序既不执行链接也不执行命令解释。 应用程序必须同时累积 SNA 数据段以形成响应单元 (RU) 并解释其中包含的任何 3270 数据。

非 SNA DFT 方式下的 readx 子例程

通信适配器从主机接收到的数据将放置在缓冲区中，直到消息完成或缓冲区已满为止。 在完成 读 调用后， 读 扩展指向的 io3270 结构将包含状态。 下列其中一个状态码是在io_flagsio3270 结构的字段:

重置时， WDI_DAVAIL 标志指示刚刚读取的数据将标记出站 3270 数据流已完成。

如果 WDI_DAVAIL 标志指示更多数据可用，那么应立即发出另一个 读 子例程。 必须尽快读取可用数据以避免降级链接或降低主机性能。

如果进行了 读 子例程调用并且没有可用的数据，那么调用过程将被阻止，直到数据变为可用为止。 要避免阻塞，请使用 轮询 子例程来确定数据是否可用。

在非 SNA DFT 方式下写子例程

在非 SNA DFT 方式下， 写 子例程会将入站 3270 数据流发送至主机。 在 写 子例程调用上指定的缓冲区必须包含完整的入站 3270 数据流。 当 写 调用已从子例程调用上指定的缓冲区成功传输时，它已完成。

SNA DFT 方式下的写子例程

在 SNA DFT 方式下， 写 子例程将 SNA 数据传送至主机系统。 此数据可以是具有 SNA 头的 3270 数据流，也可以是 SNA 响应。

应用程序将数据发送到设备驱动程序，一次发送一个 RU。 然后，设备驱动程序负责对入站 SNA 数据进行分段。 如果在处理第一个调用之前进行第二个 写 调用，那么在设备驱动程序就绪之前，第二个调用不会继续。 在将数据从应用程序的用户空间传送到设备驱动程序的内核空间之后， 写 子例程完成，并将控制权返回给应用程序。

如果设备驱动程序检测到两个 写 调用之间的 coax 断开连接，那么第二个 写 调用将返回到应用程序，并且 错误号 全局变量设置为 EFAULT。

非 SNA DFT 方式下的 writex 子例程

写 子例程会将入站 3270 数据流发送至主机。 在 写 子例程调用上指定的缓冲区必须包含完整的入站 3270 数据流。

当 写 子例程从指定缓冲区成功传输数据时，它已完成。 在完成 写 子例程调用后， 写 扩展所指向的 io3270 结构将包含状态。 下列其中一个状态码是在io_flagsio3270 结构的字段:

DFT 方式下的 ioctl 子例程

当设备处理程序处于 DFT 方式时，可以向它发出 ioctl 子例程。 下列是可用的 ioctl 操作:

DFT 方式中的错误条件

通过 3270cn 特殊文件访问设备处理程序时，可能返回以下错误条件:

在 CUT 方式下读取子例程

两个 ioctl 操作控制 读 子例程的操作方式: EMNWAIT 和 电子邮件等待 操作。 EMNWAIT 操作指示应立即满足后续读调用的要求。 电子邮件等待 ioctl 操作 (缺省值) 指示只有在来自控制单元的中断指示屏幕上的某些内容已更改之后，才应该满足读调用。 以下是控制单元中断:

在 CUT 方式下写子例程

写 子例程会将入站 3270 数据流发送至主机。 在 写 子例程上指定的缓冲区必须包含完整的入站 3270 数据流。 要将偏移量设置到通信适配器缓冲区以开始写入，请使用 Emseek ioctl 操作。

CUT 方式下的 ioctl 子例程

可以在 CUT 方式下向设备处理程序发出 ioctl 子例程。 以下是可接受的 ioctl 操作:

CUT 方式中的错误条件

通过 dev/3270cn 特殊文件访问设备处理程序时，可能返回以下错误条件:

此特殊文件需要 IBM 3270 连接适配器。