Open(SSCP) 请求

Open (SSCP) Request 消息从应用程序流向节点。 它与 SSCP) 连接 (系统服务控制点一起使用。

语法

struct Open(SSCP) Request {  
    PTRBFHDR  nxtqptr;  
    PTRBFELT  hdrept;  
    CHAR      numelts;  
    CHAR      msgtype;  
    CHAR      srcl;  
    CHAR      srcp;  
    INTEGER   srci;  
    CHAR      destl;  
    CHAR      destp;  
    INTEGER   desti;  
    CHAR      ophdr.openqual;  
    CHAR      ophdr.opentype;  
    CHAR      ophdr.appltype;  
    CHAR      ophdr.opluno;  
    INTEGER   ophdr.opresid;  
    INTEGER   ophdr.icreditr;  
    INTEGER   ophdr.icredits;  
    CHAR      ophdr.opninfo1;  
    CHAR      ophdr.opnpad1;  
};   
struct Open(SSCP) Request {  
    PTRBFELT   hdreptr->elteptr;  
    INTEGER    hdreptr->startd;  
    INTEGER    hdreptr->endd;  
    CHAR       hdreptr->trpad;  
    CHAR[268]  hdreptr->dataru;  
};  
struct Open(SSCP) Request {  
    PTRBFELT  hdreptr->elteptr->elteptr;  
    INTEGER   hdreptr->elteptr->startd;  
    INTEGER   hdreptr->elteptr->endd;  
    CHAR      hdreptr->elteptr->trpad;  
    CHAR[268] hdreptr->elteptr->dataru;  
};  

成员

nxtqptr
指向下一个缓冲区标头的指针。

hdrept
指向第一个缓冲区元素的指针。

numelts
(0x02) 缓冲区元素的数目。

msgtype
消息类型 OPENMSG (0x01) 。

srcl
源位置。

srcp
源伙伴。 (有关更多信息,请参阅“备注”。)

srci
源索引。

destl
目标位置。

destp
目标伙伴。

desti
目标索引。

ophdr.openqual
打开限定符 REQU (0x01) 。

ophdr.opentype
打开类型 SSCPSEC (0x01) 。

ophdr.appltype
应用程序接口类型。

函数管理接口 (FMI) ,无需分块 (0x02) 。

具有分块 (0x82) 的 FMI。 (有关更多信息,请参阅“备注”。)

ophdr.opluno
逻辑单元号。 (有关更多信息,请参阅“备注”。)

ophdr.opresid
资源标识符。

ophdr.icreditr
保留。

ophdr.icredits
保留。

ophdr.opninfo1
保留。

ophdr.opnpad1
打开强制类型。 (有关更多信息,请参阅“备注”。)

OPEN_TEST (0x00)

OPEN_FORCE (0x01)

元素 1

hdreptr-elteptr>
指向下一个缓冲区元素的指针。

hdreptr-startd>
此 buffer 元素中的数据开头 (1) 。

hdreptr-endd>
此缓冲区元素中的结束数据。

hdreptr-trpad>
保留 (1 个字节) 。

hdreptr-dataru>
(RU) 的数据请求/响应单位,如下所示:

dataru[0–9]

源名称。 应用空白填充。

dataru[10–19]

目标名称。 设置为要与之通信的 LU) (逻辑单元。

dataru[20]

感知 4003 标志。

dataru[21]

感知 4004 标志。

dataru[22]

感知 4006 标志。

dataru[23]

感知 4007 标志。

dataru[24]

感知 4009 标志。

dataru[25]

感知 400A 标志。

dataru[26]

感知 400B 标志。

dataru[27]

感知 400C 标志。

dataru[28]

感知 400D 标志。

dataru[29]

感知 400F 标志。

dataru[30]

感知 4011 标志。

dataru[31]

感知 4012 标志。

dataru[32]

感知 4014 标志。

dataru[33]

高优先级指示器。

高 (0x01)

低 (0x02)

dataru[34]

逻辑单元应用程序 (LUA) 支持的指示器。

支持的 (0x01)

不支持 (0x00)

dataru[35–36]

从动态访问模块获取的区块大小 (DMOD) 。 (有关更多信息,请参阅“备注”。)

dataru[37]

细分交付选项。

不要 (RU) 段 (0x00) 传递请求/响应单元

(0x01) 传递 RU 段

dataru[38]

高级语言应用程序编程接口 (HLLAPI) 会话标识符。 (有关更多信息,请参阅“备注”。)

元素 2

hdreptr-elteptr-elteptr>>
指向下一个缓冲区元素的指针 (NIL) 。

hdreptr-elteptr-startd>>
此缓冲区元素中的数据开始 (1) 。

hdreptr-elteptr-endd>>
此缓冲区元素中的结束数据。

hdreptr-elteptr-trpad>>
保留。

hdreptr-elteptr-dataru>>
数据 RU,如下所示:

dataru[0]

标识 3270 模拟器的 ASCII 字符串。 (有关更多信息,请参阅“备注”。)

注解

  • “打开 (SSCP) 请求”消息由一个缓冲区标头和两个缓冲区元素组成。

  • 源 L 值、目标 Locality Partner Index (LPI) 值,并保留源名称。

  • 对于 3270 模拟器,源 P 值必须设置为 S3PROD (0x12) ,这将应用程序标识为 3270 模拟器。 如果) 少于 10 个字符,则应将目标名称设置为 LU 名称或池名称(取自 3270 个用户记录 (右填充 ASCII 空格)。

  • LUA 应用程序使用源 P 值 LUAPROD (0x1D) 。 这与选择 FMI 的 LUA 变体的 LUA 支持的指示器的值无关。

  • SNS4014字段SNS4003以及高优先级指示器在文本中称为 SSCP 连接信息控制块 (CICB) 。 (有关详细信息,请参阅打开 SSCP Connection.) 值0x00指示 (DFC) 接收检查,此 LU 不支持与感知代码对应的数据流控制。 值 0x01 表示支持它。 请注意,无论这些值如何,始终执行相应的发送检查。

  • LU 编号仅在 Open (SSCP) 请求的本地节点内部使用。 它是从第一个元素中的目标名称生成的。

  • 当跨多个服务器查找资源时,将使用开放强制类型字段;当应用程序希望使用连接处于非活动状态的 LU 时,将使用“打开强制类型”字段来自动激活连接。 应用程序不需要设置此标志。 它由 DL-BASE 使用。 有关详细信息,请参阅 打开 SSCP 连接

  • 应用程序接口类型字段定义是否使用从本地节点到应用程序的 RU 分块。 如果使用大型 RU,则可能需要这样做。 有关 FMI 分块的详细信息,请参阅 节奏和分块

  • dataru[35] 处 (区块大小字段) 是整数值。

  • 段传递选项指定本地节点是应在收到 RU 段后立即将其传送到应用程序,还是应在将整个 RU 传递到应用程序之前将其组合起来。 分段传递允许应用程序在收到数据(称为窗口着色)后立即更新用户的屏幕,这可以更快地感知响应。 有关详细信息,请参阅段传递。 仅当使用分块时,才需要此选项。 它包含在此消息中,以便本地节点可以计算相应主逻辑单元上的初始区块信用值 (PLU) 连接。 仍必须在 “打开 (PLU) 响应”上设置选项。 如果存在冲突,在该消息上指定的设置将替代此处指定的设置。 如果发生这种情况,则初始信用值可能不适用。

  • LUA 支持的指示器指定应用程序是否使用 FMI 的 LUA 变体。

  • 如果该元素短于 (s+34) 字节,则 Microsoft® Host Integration Server 假定没有 LUA 和区块。 这可确保向后兼容以前版本的本地节点软件,其中这些选项不可用。

  • HLLAPI 会话标识符是一个 ASCII 字符,用于标识 Open (SSCP) 适用的 3270 显示会话。 HLLAPI 使用此来标识 HLLAPI 函数所引用的特定 3270 演示空间。 它也被 3270 称为会话的短名称,或 HLLAPI 作为表示空间标识符 (PS 标识符) 。 如果 3270 模拟器不支持会话标识符,则此字段应设置为零。

  • 第二个元素包含一个 ASCII 字符串,可用于标识 3270 模拟器的类型。 此字符串将由客户端的 DL-BASE 记录在审核日志文件中,也可以在跟踪中看到。 必须设置 起始 字段和 结束 字段,以定义此字符串的限制。