Open(SSCP) Request
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
第一個緩衝區專案的指標。
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
此緩衝區元素中的資料開頭 (1) 。
hdreptr– > endd
這個緩衝區專案中的資料結束。
hdreptr– > trpad
保留 (1 個位元組) 。
hdreptr– > dataru
資料要求/回應單位 (RU) ,如下所示:
dataru[0–9]
來源名稱。 應該填入空白。
dataru[10–19]
目的地名稱。 設定為您想要與其通訊的 LU) 邏輯單元 (。
dataru[20]
Sense 4003 旗標。
dataru[21]
Sense 4004 旗標。
dataru[22]
Sense 4006 旗標。
dataru[23]
Sense 4007 旗標。
dataru[24]
Sense 4009 旗標。
dataru[25]
Sense 400A 旗標。
dataru[26]
Sense 400B 旗標。
dataru[27]
Sense 400C 旗標。
dataru[28]
Sense 400D 旗標。
dataru[29]
Sense 400F 旗標。
dataru[30]
Sense 4011 旗標。
dataru[31]
Sense 4012 旗標。
dataru[32]
Sense 4014 旗標。
dataru[33]
高優先順序指標。
高 (0x01)
低 (0x02)
dataru[34]
邏輯單元應用程式 (LUA) 支援的指標。
支援的 (0x01)
不支援 (0x00)
dataru[35–36]
從動態存取模組取得的區塊大小 (DMOD) 。 (如需詳細資訊,請參閱<備註>)。
dataru[37]
區段傳遞選項。
請勿傳遞要求/回應單位 (RU) 區段 (0x00)
傳遞 RU 區段 (0x01)
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 字串。 (如需詳細資訊,請參閱<備註>)。
備註
Open (SSCP) 要求訊息包含緩衝區標頭和兩個緩衝區元素。
來源 L 值、目的地 Locality Partner Index (LPI) 值,以及保留來源名稱。
針對 3270 模擬器,來源 P 值必須設定為 S3PROD (0x12) ,以將應用程式識別為 3270 模擬器。 如果) 少於 10 個字元,則目的地名稱應設定為取自 3270 使用者記錄的 LU 名稱或集區名稱, (以滑鼠右鍵按一下 ASCII 空格。
LUA 應用程式會使用來源 P 值 LUAPROD (0x1D) 。 這與 LUA 支援指標的值無關,它會選取 FMI 的 LUA 變體。
SNS4003 SNS4014欄位與高優先順序指標一起稱為 SSCP 連線資訊控制區塊 (CICB) 。 (如需詳細資訊,請參閱 開啟 SSCP Connection.) 值 0x00 表示資料流程控制 (DFC) 接收與此 LU 不支援的感知程式碼對應檢查。 0x01值表示支援此值。 請注意,不論這些值為何,都會一律執行對應的傳送檢查。
LU 號碼只會在 [開啟 (SSCP) 要求] 的本機節點上內部使用。 它會從第一個專案中的目的地名稱產生。
在多個伺服器中尋找資源時,以及當應用程式想要使用連線非使用中之 LU 時,會自動啟用連線時,會使用開啟強制類型欄位。 應用程式不需要設定此旗標。 DL-BASE 會使用它。 如需詳細資訊,請參閱 開啟 SSCP 連線。
應用程式程式介面類別型欄位會定義是否從本機節點使用 RU 區塊化至應用程式。 如果使用大型 RU,則可能是必要的。 如需 FMI 區塊化的詳細資訊,請參閱 步調和區塊化。
dataru[35]) 的區塊大小欄位 (為整數值。
區段傳遞選項會指定本機節點在收到 RU 時,應該立即將 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 記錄檔記錄在稽核記錄檔中,也可以在追蹤中看到。 必須設定開始和結束欄位,才能定義此字串的限制。