读取结构化字段 (126)

3270 5250 VT
编号

读取结构化字段功能允许应用程序从主机应用程序读取结构化字段数据。如果调用指定 S(表示同步),则在完成读取结构化字段之前,应用程序不会获得控制权。如果调用指定 A(表示异步),则应用程序会在调用后立即获得控制权。如果调用指定 M(表示异步、消息模式),则应用程序会在调用后立即获得控制权。应用程序可以等待消息。在任何情况下(S、A 或 M),应用程序都提供将在其中放置来自主机的数据的缓冲区地址。

要成功地异步完成此功能,以下陈述将适用:

参数列表中的返回码字段可能不包含所请求 I/O 的结果。如果返回码不是 0,则请求失败。应用程序必须根据返回码采取适当的措施。

如果此请求的返回码为 0,则应用程序必须使用此功能调用返回的请求标识,发出获取请求完成功能调用,以确定与请求标识关联的功能的完成结果。获取请求完成功能调用返回以下信息:
  1. 功能请求标识
  2. 来自异步请求的数据字符串的地址
  3. 数据字符串的长度
  4. 已完成功能的返回码