開放(SSCP)請求

Open(SSCP) 請求訊息從應用程式流向節點。 它與系統服務控制點(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
指標指向第一個緩衝元件。

紐梅爾茨
緩衝元件數量(0x02)。

MSGTYPE
訊息類型為 OPENMSG(0x01)。

SRCL
資料來源所在地。

SRCP
來源夥伴。 (更多資訊請參見備註。)

SRCI
資料來源索引。

DEST
目的地地區。

DESP
目的地夥伴。

德斯提
目的地索引。

ophdr.openqual
公開資格賽 REQU(0x01)。

ophdr.opentype
開放型 SSCPSEC(0x01)。

ophdr.appltype
應用程式介面類型。

功能管理介面(FMI)無分區(0x02)。

FMI與分塊(0x82)。 (更多資訊請參見備註。)

奧夫德·奧普魯諾
邏輯單元編號。 (更多資訊請參見備註。)

奧夫德·奧普雷西德
資源識別碼。

ophdr.icreditr
已保留。

ophdr.icredits
已保留。

ophdr.opninfo1
已保留。

ophdr.opnpad1
開放型力量。 (更多資訊請參見備註。)

OPEN_TEST(0x00)

OPEN_FORCE(0x01)

元素一

hdreptr–>elteptr
指標指向下一個緩衝元件。

HDREPTR–>STARTD
此緩衝元件(1)中資料的起始。

HDREPTR–>終結
此緩衝元件中資料的結束。

HDREPTR–>TRPAD
保留(1 位元組)。

HDREPTR–>Dataru
資料請求/回應單元(RU),內容如下:

達塔魯[0–9]

來源名稱。 應該要填滿空白。

達塔魯[10–19]

目的地名稱。 設定為你想要通訊的邏輯單元(LU)。

達露[20]

Sense 4003 旗標。

達露[21]

Sense 4004 旗幟。

達塔魯[22]

Sense 4006 旗幟。

達塔魯[23]

Sense 4007 旗幟。

達留[24]

Sense 4009 標誌。

達塔魯[25]

Sense 400A 標誌。

達塔魯[26]

Sense 400B 標誌。

達露[27]

Sense 400C 旗幟。

達塔魯[28]

Sense 400D 旗幟。

達塔魯[29]

Sense 400F 旗幟。

達留[30]

Sense 4011 標誌。

達塔魯[31]

Sense 4012 標誌。

達塔魯[32]

Sense 4014 標誌。

達塔魯[33]

高優先權指示器。

高(0x01)

低(0x02)

達露[34]

支援邏輯單元應用(LUA)指示器。

支援(0x01)

不支援(0x00)

達塔魯[35–36]

區塊大小來自動態存取模組(DMOD)。 (更多資訊請參見備註。)

達塔魯[37]

分段配送選項。

請勿交付請求/回應單元(RU)段(0x00)

交付 RU 段落(0x01)

達塔魯[38]

高階語言應用程式介面(HLLAPI)會話識別碼。 (更多資訊請參見備註。)

元素二

hdreptr–>elteptr–>elteptr
指標指向下一個緩衝元件(NIL)。

hdreptr–>elteptr–>startd
此緩衝元件(1)中資料的起始。

hdreptr–>elteptr–>endd
此緩衝元件中資料的結束。

hdreptr–>elteptr–>trpad
已保留。

hdreptr–>elteptr–>dataru
數據為 RU,具體如下:

達塔魯[0]

ASCII 字串識別 3270 模擬器。 (更多資訊請參見備註。)

備註

  • Open(SSCP) 請求訊息由一個緩衝標頭和兩個緩衝區元素組成。

  • 來源 L 值、目的地區域性夥伴索引(LPI)值及來源名稱皆為保留。

  • 對於 3270 模擬器,原始 P 值必須設為 S3PROD(0x12),以識別該應用程式為 3270 模擬器。 目的名稱應設定為 3270 使用者記錄中的 LU 名稱或池名(若少於 10 個字元,則右邊填入 ASCII 空格)。

  • LUA 應用程式使用原始 P 值 LUAPROD(0x1D)。 這與LUA支援指示器的值無關,LUA指示器選擇的是FMI的LUA變體。

  • SNS4003 SNS4014欄位連同高優先權指示器,在文本中稱為 SSCP 連線資訊控制區塊(CICB)。 (更多資訊請參見 開啟SSCP連線。)值為 0x00 表示此 LU 不支援對應 sense 碼的資料流控制(DFC)接收檢查。 0x01 表示該項目有支援。 請注意,對應的傳送檢查無論這些值如何,都會被執行。

  • LU 編號僅在本地節點內部使用 Open(SSCP) 請求。 它是從第一個元素中的目的地名稱產生的。

  • 開放力場用於在多台伺服器間定位資源,以及當應用程式希望使用該連線未啟用的 LU 時,自動啟動連線。 應用程式不需要設定這個標誌。 該系統由DL-BASE使用。 詳情請參見 「開啟SSCP連線」。

  • 應用程式介面類型欄位定義了從本地節點到應用程式是否使用 RU 分塊。 若使用大型 RU 時,這可能是必要的。 欲了解更多關於FMI分區的資訊,請參見 「節奏與分區」。

  • 區塊大小欄位( dataru[35])是一個整數值。

  • 分段交付選項指定本地節點是否應在收到 RU 分段後立即送達應用程式,或是在交付應用程式前組裝整個 RU 後再送達應用程式。 分段傳送允許應用程式在收到資料後立即更新使用者螢幕,稱為視窗著色,這能帶來更快的感知回應。 欲了解更多資訊,請參閱 分段交付。 此選項僅在使用分區時使用。 此訊息中包含此訊息,以便本地節點能計算對應主要邏輯單元(PLU)連線上的初始區塊信用值。 選項仍必須在 開放(PLU)回應中設定。 如果有衝突,該訊息中指定的設定會覆蓋此處指定的設定。 若發生這種情況,初始信用額度可能不適用。

  • LUA 支援的指示器會指定應用程式是否使用 FMI 的 LUA 變體。

  • 若元素短於 (s+34) 位元組,Microsoft® 主機整合伺服器假設沒有 LUA 也沒有分塊。 這確保了與先前版本本地節點軟體的向下相容,因為之前版本中沒有這些選項。

  • HLLAPI 會話識別碼是一個 ASCII 字元,用以識別 Open(SSCP) 所適用的 3270 顯示會話。 HLLAPI 利用此方法識別 HLLAPI 函數所指涉的特定 3270 呈現空間。 3270 也稱之為會話的短名稱,或在 HLLAPI 中稱為呈現空間識別碼(PS 識別碼)。 若 3270 模擬器不支援會話識別碼,該欄位應設為零。

  • 第二個元素包含一個 ASCII 字串,可以用來辨識 3270 模擬器的類型。 此字串會被客戶 DL-BASE 登錄在稽核日誌檔中,並可在追蹤中看到。 必須設定 起始 欄位與 結束 欄位以定義此字串的極限。