SLI_BID
SLI_BID動詞命令會通知工作階段層級介面 (SLI) 應用程式,訊息正在等候使用SLI_RECEIVE讀取。 SLI_BID 也會提供會話的目前狀態給 Windows 邏輯單元應用程式, (LUA) 應用程式。
下列結構描述SLI_BID所使用的動詞控制區塊 (VCB) LUA_COMMON成員。
第二個語法聯集描述SLI_BID所使用的 VCB LUA_SPECIFIC成員。 為了清楚起見,會省略其他等位成員。
語法
struct LUA_COMMON {
unsigned short lua_verb;
unsigned short lua_verb_length;
unsigned short lua_prim_rc;
unsigned long lua_sec_rc;
unsigned short lua_opcode;
unsigned long lua_correlator;
unsigned char lua_luname[8];
unsigned short lua_extension_list_offset;
unsigned short lua_cobol_offset;
unsigned long lua_sid;
unsigned short lua_max_length;
unsigned short lua_data_length;
char FAR * lua_data_ptr;
unsigned long lua_post_handle;
struct LUA_TH lua_th;
struct LUA_RH lua_rh;
struct LUA_FLAG1 lua_flag1;
unsigned char lua_message_type;
struct LUA_FLAG2 lua_flag2;
unsigned char lua_resv56[7];
unsigned char lua_encr_decr_option;
};
union LUA_SPECIFIC {
unsigned char lua_peek_data[12];
};
成員
lua_verb
提供的參數。 包含動詞程式碼,LUA_VERB_SLI SLI 動詞命令。
lua_verb_length
提供的參數。 指定 LUA VCB 的位元組長度。 它必須包含發出之動詞記錄的長度。
lua_prim_rc
LUA 在動詞完成時所設定的主要傳回碼。 有效的傳回碼會根據發出的 LUA 動詞命令而有所不同。
lua_sec_rc
LUA 在動詞完成時所設定的次要傳回碼。 有效的傳回碼會根據發出的 LUA 動詞命令而有所不同。
lua_opcode
提供的參數。 包含 LUA 命令程式碼 (動詞作業程式碼) ,以便發出動詞命令,LUA_OPCODE_SLI_BID。
lua_correlator
提供的參數。 包含使用者提供的值,這個值會連結動詞命令與其他使用者提供的資訊。 LUA 不會使用或變更此資訊。 這是選擇性參數。
lua_luname
提供的參數。 指定 Windows LUA 會話所使用的本機 LU 的 ASCII 名稱。
SLI_BID只有在lua_sid為零時,才需要此參數。
如果名稱短于八個字元,則此參數長度為 8 個位元組,在右側填補空格 (0x20) 。
lua_extension_list_offset
SLI_BID 未 使用 ,且 應設定為零。
lua_cobol_offset
LUA 在 Microsoft® Host Integration Server 中未使用,且應為零。
lua_sid
提供的參數。 指定會話識別碼,並由 SLI_OPEN 和 RUI_INIT傳回。 其他動詞命令會使用此參數來識別用於命令的會話。 如果其他動詞使用 lua_luname 參數來識別會話,請將 lua_sid 參數設定為零。
lua_max_length
SLI_BID 未 使用 ,且 應設定為零。
lua_data_length
傳回的參數。 指定 lua_peek_data中傳回的資料長度。
lua_data_ptr
應用程式提供的緩衝區指標,其中包含要針對 SLI_SEND 和 RUI_WRITE 傳送的資料,或是接收 SLI_RECEIVE 和 RUI_READ的資料。 其他 RUI 和 SLI 動詞未使用,而且應該設定為零。
lua_post_handle
提供的參數。 如果事件要完成非同步通知,請在 Microsoft Windows Server 下使用。 此變數包含要發出訊號的事件控制碼或視窗控制碼。
對於所有其他環境,此參數會保留下來,而且應該設定為零。
lua_th
傳回的參數。 包含所接收訊息的 SNA 傳輸標頭 (TH) 。 會針對讀取和計價函式傳回各種子參數。 其子參數如下所示:
lua_th.flags_fid
格式識別類型 2,四個位。
lua_th.flags_mpf
區隔對應欄位,兩個位。 定義資料區段的類型。 下列是有效值:
0x00 [中間區段] 0x04 [最後一個區段] 0x08 [僅限第一個區段] 0x0C 區段
lua_th.flags_odai
原始位址欄位-目的地位址欄位 (OAF–DAF) 指派器指標,一位。
lua_th.flags_efi
加速流量指示器,一位。
lua_th.daf
[目的地位址] 欄位 (DAF) 為未簽署的字元。
lua_th.oaf
原始位址欄位 (OAF) ,不帶正負號的字元。
lua_th.snf
序號欄位,不帶正負號的 char[2]。
lua_rh
傳回的參數。 包含傳送或接收之訊息的 SNA 要求/回應標頭 (RH) 。 其子參數如下所示:
lua_rh.rri
要求-回應指標,一個位。
lua_rh.ruc
要求/回應單位 (RU) 類別,兩個位。 下列是有效值:
LUA_RH_FMD (LUA_RH_FMD 0x00) FM資料區段LUA_RH_NC ( (0x20) 網路 (控制LUA_RH_DFC0x40 () ) 資料流程控制LUA_RH_SC 0x60) 會話控制)
lua_rh.fi
格式指標,一位。
lua_rh.sdi
內含指標的感知資料,一個位。
lua_rh.bci
開始鏈結指標,一個位。
lua_rh.eci
結束鏈結指標,一個位。
lua_rh.dr1i
明確回應 1 指標,一個位。
lua_rh.dr2i
明確回應 2 指標,一位。
lua_rh.ri
要求) 的例外狀況回應指標 (,或回應類型指標 (回應) ,一位。
lua_rh.qri
佇列回應指標,一位。
lua_rh.pi
步調指標,一位。
lua_rh.bbi
開始括弧指標,一位。
lua_rh.ebi
尾括弧指標,一位。
lua_rh.cdi
變更方向指標,一位。
lua_rh.csi
程式碼選取指標,一位。
lua_rh.edi
加密的資料指標,一個位。
lua_rh.pdi
填補的資料指標,一個位。
lua_flag1
提供的 參數。 包含包含應用程式所提供訊息旗標的資料結構。 其子參數如下所示:
lua_flag1.bid_enable
Bid enable indicator, one bit.
lua_flag1.close_abend
關閉立即指標,一位。
lua_flag1.nowait
沒有等候資料旗標,一個位。
lua_flag1.sscp_exp
系統服務控制點 (SSCP) 加速流程,一位。
lua_flag1.sscp_norm
SSCP 一般流程,一位。
lua_flag1.lu_exp
LU 加速流程,一位。
lua_flag1.lu_norm
LU 一般流程,一位。
lua_message_type
傳回的參數。 指定表示給 SLI_BID
的 SNA 訊息類型。 可能的值包括:
LUA_MESSAGE_TYPE_LU_DATA
LUA_MESSAGE_TYPE_SSCP_DATA
LUA_MESSAGE_TYPE_RSP
LUA_MESSAGE_TYPE_BID
LUA_MESSAGE_TYPE_BIND
LUA_MESSAGE_TYPE_BIS
LUA_MESSAGE_TYPE_CANCEL
LUA_MESSAGE_TYPE_CHASE
LUA_MESSAGE_TYPE_LUSTAT_LU
LUA_MESSAGE_TYPE_LUSTAT_SSCP
LUA_MESSAGE_TYPE_QC
LUA_MESSAGE_TYPE_QEC
LUA_MESSAGE_TYPE_RELQ
LUA_MESSAGE_TYPE_RTR
LUA_MESSAGE_TYPE_SBI
LUA_MESSAGE_TYPE_SIGNAL
LUA_MESSAGE_TYPE_STSN
SLI 會透過 LUA 介面延伸模組常式接收和回應 BIND 和 STSN 要求。
LU_DATA、LUSTAT_LU、LUSTAT_SSCP和SSCP_DATA不是 SNA 命令。
lua_flag2
傳回的參數。 包含 LUA 所傳回之訊息的旗標。 其子參數如下所示:
lua_flag2.bid_enable
表示 如果設定 為 1,則已成功重新啟用SLI_BID。
lua_flag2.async
指出如果設定為 1,LUA 介面動詞會以非同步方式完成。
lua_flag2.sscp_exp
如果設定為 1,表示 SSCP 加速流程。
lua_flag2.sscp_norm
如果設定為 1,則表示 SSCP 正常流程。
lua_flag2.lu_exp
如果設定為 1,則表示 LU 加速流程。
lua_flag2.lu_norm
如果設定為 1,則表示 LU 正常流程。
lua_resv56
保留且應設定為零。
lua_encr_decr_option
SLI_BID 未 使用,且 應設定為零。
lua_peek_data
RUI_BID和SLI_BID動詞所使用之LUA_SPECIFIC的等位成員。 傳回的參數。 包含最多 12 個位元組的資料等候讀取。
傳回碼
LUA_OK
主要傳回碼;成功執行動詞。
LUA_SEC_OK
次要傳回碼;LUA_OK沒有任何其他資訊存在。
LUA_PARAMETER_CHECK
主要傳回碼;動詞因為參數錯誤而未執行。
LUA_INVALID_LUNAME
次要傳回碼;指定了無效 lua_luname 名稱。
LUA_BAD_SESSION_ID
次要傳回碼;在 VCB 中指定 了無效值lua_sid 。
LUA_RESERVED_FIELD_NOT_ZERO
次要傳回碼;剛發出動詞的保留參數不會設定為零。
LUA_INVALID_POST_HANDLE
次要傳回碼;對於使用事件做為非同步張貼方法的 Windows 作業系統,Windows LUA VCB 不包含有效的事件控制碼。
LUA_VERB_LENGTH_INVALID
次要傳回碼;LUA 動詞發出時,LUA 的值 lua_verb_length非預期 。
LUA_STATE_CHECK
主要傳回碼;指令動詞未執行,因為發出狀態無效。
LUA_NO_SLI_SESSION
次要傳回碼;當發出命令時,會話未開啟或因為 SLI_CLOSE 或會話失敗而關閉。
LUA_SLI_BID_PENDING
次要傳回碼;發出另一個 SLI_BID 時,SLI 動詞仍然作用中。 一次只能有一個 SLI_BID 作用中。
LUA_SESSION_FAILURE
主要傳回碼;次要傳回碼中指定的錯誤狀況導致會話失敗。
LUA_RECEIVED_UNBIND
次要傳回碼;主要邏輯單元 (PLU) 會話使用中時,將 SNA UNBIND 命令傳送至 LUA 介面。 因此,會話已停止。
LUA_SLI_LOGIC_ERROR
次要傳回碼;LUA 介面在邏輯中發現內部錯誤。
LUA_NO_RUI_SESSION
次要傳回碼;未針對發出 LUA 動詞命令初始化任何會話,或在初始化會話之前發出 SLI_OPEN 以外的某些動詞。
LUA_MODE_INCONSISTENCY
次要傳回碼;目前狀態不允許執行此函式。 即使已瞭解並支援傳送至半會話元件的要求,也不會執行。 此 SNA 感知程式碼也是例外狀況要求感知程式碼。
LUA_RECEIVER_IN_TRANSMIT_MODE
次要傳回碼;處理正常流程資料所需的資源都無法使用,或收到一般流程要求時,未收到半雙工競爭的狀態。 結果是競爭條件。 此 SNA 感知程式碼也是例外狀況要求感知程式碼。
LUA_LU_COMPONENT_DISCONNECTED
次要傳回碼;因為 LU 元件未正確連線,所以無法使用。 請確定電源已開啟。
LUA_FUNCTION_NOT_SUPPORTED
次要傳回碼;LUA 不支援要求的函式。 控制字元、RU 參數或格式化的要求程式碼可能已指定 函式。 特定感知程式碼資訊以位元組 2 和 3 為單位。
LUA_CHAINING_ERROR
次要傳回碼;鏈結指標設定的順序發生錯誤。 找到接收者目前會話控制或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_BRACKET
次要傳回碼;傳送者無法強制執行會話括弧規則。 請注意,爭用和競爭條件會豁免此錯誤。 找到接收者目前會話控制或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_DIRECTION
次要傳回碼;雖然NOT_RECEIVE半雙工翻轉盤狀態,但收到正常流程的要求。 找到接收者目前會話控制或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_DATA_TRAFFIC_QUIESCED
次要傳回碼;資料流程控制 (DFC) 或函式管理資料 (FMD) 要求是從傳送 SHUTC 命令或 QC 命令的半會話接收,而 DFC 或 FMD 要求尚未回應 RELQ 命令。 找到接收者目前會話控制或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_NO_BEGIN_BRACKET
次要傳回碼;當收到指定 BBI=BB 的 BID 或 FMD 要求時,接收者已將正回應傳送至 BIS 命令。 找到接收的目前會話控制或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_IMMEDIATE_REQUEST_MODE_ERROR
次要傳回碼;要求違反立即要求模式通訊協定。 找到接收的目前會話控制或資料流程控制狀態的標頭要求或要求單位無效。 已防止傳遞至半會話元件。
LUA_QUEUED_RESPONSE_ERROR
次要傳回碼;要求違反佇列回應通訊協定。 找到接收的目前會話控制或資料流程控制狀態的標頭要求或要求單位無效。 已防止傳遞至半會話元件。
LUA_ERP_SYNC_EVENT_ERROR
次要傳回碼;發生 ERP 同步事件通訊協定的違規。 找到接收的目前會話控制或資料流程控制狀態的標頭要求或要求單位無效。 已防止傳遞至半會話元件。
LUA_RSP_CORRELATION_ERROR
次要傳回碼;已傳送的回應未對應至先前接收的要求,或收到未對應至先前傳送要求的回應。
LUA_RSP_PROTOCOL_ERROR
次要傳回碼;在從主要半會話收到的回應中找到回應通訊協定違規。
LUA_BB_NOT_ALLOWED
次要傳回碼;未正確指定開頭括弧指標。 要求標頭參數值違反先前選擇的 BIND 選項或架構規則。 已防止傳遞至半會話元件。 這些錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
允許LUA_EB_NOT
次要傳回碼;未正確指定結尾括弧指標。 要求標頭參數值違反先前選擇的 BIND 選項或架構規則。 已防止傳遞至半會話元件。 這些錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_EXCEPTION_RSP_NOT_ALLOWED
次要傳回碼;不允許例外狀況回應時,會要求一個。 要求標頭參數值違反先前選擇的 BIND 選項或架構規則。 已防止傳遞至半會話元件。 這些錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_DEFINITE_RSP_NOT_ALLOWED
次要傳回碼;不允許明確回應時,即會要求一個回應。 要求標頭參數值違反先前選擇的 BIND 選項或架構規則。 已防止傳遞至半會話元件。 這些錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_CD_NOT_ALLOWED
次要傳回碼;變更方向指標未正確指定。 要求標頭參數值違反先前選擇的 BIND 選項或架構規則。 已防止傳遞至半會話元件。 這些錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_NO_RESPONSE_NOT_ALLOWED
次要傳回碼;EXR 以外的要求包含「NO RESPONSE」 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_CHAINING_NOT_SUPPORTED
次要傳回碼;鏈結指標未正確指定。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_BRACKETS_NOT_SUPPORTED
次要傳回碼;括弧指標未正確指定。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_CD_NOT_SUPPORTED
次要傳回碼;已設定變更方向指標,但 LUA 不支援這種情況的變更方向。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_USE_OF_FI
次要傳回碼;格式指標未正確指定。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_ALTERNATE_CODE_NOT_SUPPORTED
次要傳回碼;已設定程式碼選取指標,但 LUA 不支援此會話的程式碼選取。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_RU_CATEGORY
次要傳回碼;要求單位類別指標未正確指定。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_REQUEST_CODE
次要傳回碼;要求程式碼未正確指定。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_SPEC_OF_SDI_RTI
次要傳回碼;SDI (SDI) 和回應類型指標 (RTI) 未在回應上正確指定 sense-data-include 指標。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_DR1I_DR2I_ERI
次要傳回碼;明確回應 1 指標 (DR1I) 、明確回應 2 指標 (DR2I) ,而例外狀況回應指標 (ERI) 未正確指定。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_USE_OF_QRI
次要傳回碼;QRI) 未正確指定佇列回應指標 (。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_USE_OF_EDI
次要傳回碼;未正確指定 EDI) (加密的資料指標。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_INCORRECT_USE_OF_PDI
次要傳回碼;未正確指定 PDI 資料指標 (PDI) 。 先前選擇的 BIND 選項,或要求標頭參數值違反架構規則。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_UNSUCCESSFUL
主要傳回碼;提供的動詞記錄有效,但動詞未順利完成。
LUA_VERB_RECORD_SPANS_SEGMENTS
次要傳回碼;LUA VCB 長度參數加上區段位移超出線段結尾。
LUA_NOT_ACTIVE
次要傳回碼;當發出 LUA 動詞時,LUA 在 Microsoft Host Integration Server 中沒有作用中。
LUA_INVALID_PROCESS
次要傳回碼;發出 LUA 動詞的會話無法使用,因為另一個進程擁有會話。
LUA_LU_INOPERATIVE
次要傳回碼;嘗試停止會話時發生嚴重錯誤。 在從主機收到啟動邏輯單元 (ACTLU) 之前,任何 LUA 要求都無法使用此 LU。
LUA_RECEIVE_CORRELATION_TABLE_FULL
次要傳回碼;會話接收要求之流程的相互關聯資料表已達到其容量。
LUA_NEGATIVE_RESPONSE
主要傳回碼;LUA 會傳送負面回應給從主要邏輯單元接收的訊息, (PLU) ,因為訊息中發現錯誤,或應用程式對已到達鏈結的鏈結回應負數。
LUA_FUNCTION_NOT_SUPPORTED
次要傳回碼;LUA 不支援要求的函式。 控制字元、RU 參數或格式化的要求程式碼可能已指定 函式。 特定感知程式碼資訊以位元組 2 和 3 為單位。
LUA_DATA_TRAFFIC_RESET
次要傳回碼;作用中會話的半會話,但具有非作用中資料流量的一般流量 DFC 或 FMD 要求。 找到接收者目前會話控制項或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_DATA_TRAFFIC_NOT_RESET
次要傳回碼;當資料流量狀態未重設時,已收到會話控制要求。 找到接收之目前會話控制項或資料流程控制狀態的要求標頭或要求單位無效。 已防止傳遞至半會話元件。
LUA_SC_PROTOCOL_VIOLATION
次要傳回碼;發生 SC) 通訊協定 (會話控制項違規。 只有在 SC 要求之後才允許的要求 (,以及成功交換該要求的正面回應,) 在必要的交換之前收到。 感知資料的位元組 4 包含要求碼。 此意義程式碼沒有任何使用者資料存在。 找到接收之目前會話控制項或資料流程控制狀態的標頭要求或要求單位無效。 已防止傳遞至半會話元件。
LUA_INVALID_SC_OR_NC_RH
次要傳回碼;SC 或 NC 要求的 RH 無效。
LUA_PACING_NOT_SUPPORTED
次要傳回碼;當接收半會話或界限函式半會話不支援步調時,要求會包含步調指標。 先前選擇的 BIND 選項或架構規則遭到 lua_rh 值違反。 已防止傳遞至半會話元件。 錯誤不相依于目前的會話狀態。 傳送者無法強制執行會話規則可能會導致錯誤。
LUA_NAU_INOPERATIVE
次要傳回碼;NAU) (網路可定址單位無法處理回應或要求。 由於下列其中一個原因,無法傳遞至接收者:
路徑資訊單位錯誤
路徑中斷
啟用的要求序列無效
如果在作用中的會話期間收到路徑錯誤,這通常表示會話夥伴不再有有效的路徑。
LUA_CANCELED
主要傳回碼;次要傳回碼提供取消命令的原因。
LUA_TERMINATED
次要傳回碼;當動詞擱置時,會話已終止。 動詞程式已取消。
LUA_IN_PROGRESS
主要傳回碼;已收到非同步命令,但尚未完成。
LUA_STATUS
主要傳回碼;次要傳回碼包含應用程式的 SLI 狀態資訊。
LUA_READY
次要傳回碼;在NOT_READY狀態之後,系統會發出此狀態,通知您 SLI 已準備好處理命令。
LUA_NOT_READY
次要傳回碼;收到 SNA UNBIND 類型0x02命令,這表示即將推出新的 BIND。
如果在開始SLI_OPEN完成後收到 UNBIND 類型 0x02 ,會話會暫停,直到收到 BIND、選擇性 CRV 和 STSN,以及收到 SDT 流程為止。 這些常式會重新進入,因為它們必須再次呼叫。 會話會在 SLI 處理 SDT 命令之後繼續。
如果在SLI_OPEN仍在處理時收到 UNBIND 類型0x02,則主要傳回碼為會話失敗,而不是狀態。 或者,收到 SNA CLEAR 會導致暫停。 收到 SNA SDT 會導致會話繼續。
LUA_INIT_COMPLETE
次要傳回碼;LUA 介面會在 處理SLI_OPEN 時初始化會話。 發出SLI_OPEN lua_open_type_prim_sscp參數的 LUA 應用程式會在SLI_RECEIVE或SLI_BID上收到此狀態。
LUA_SESSION_END_REQUESTED
次要傳回碼;LUA 介面從主機收到 SNA 關機命令 (SHUTDOWND) ,這表示主機已準備好關閉會話。
LUA_COMM_SUBSYSTEM_ABENDED
主要傳回碼;指出下列其中一個條件:
此交談所使用的節點遇到 ABEND。
交易程式 (TP) 與實體單位 (PU) 2.1 節點之間的連線已中斷, (LAN 錯誤) 。
TP 電腦上的 SnaBase 遇到 ABEND。
LUA_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;處理動詞時,無法載入或終止必要的元件。 因此,無法進行通訊。 請連絡系統管理員以採取更正動作。
LUA_INVALID_VERB_SEGMENT
主要傳回碼;延伸超過資料區段結尾的 VCB。
LUA_UNEXPECTED_DOS_ERROR
主要傳回碼;發出作業系統呼叫之後,收到非預期的作業系統傳回碼,並在次要傳回碼中指定。
LUA_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小,無法執行動詞。 增加應用程式的堆疊大小。
LUA_INVALID_VERB
主要傳回碼;動詞程式碼或作業程式碼或兩者都無效。 動詞未執行。
備註
SLI_BID 會執行下列動作:
通知 Windows LUA 應用程式訊息正在等候讀取。
提供目前的會話狀態。
提供SLI_RECEIVE將讀取的下一則訊息預覽。
此預覽版最多包含 12 個位元組的資訊, (查看資料) ,讓 Windows LUA 應用程式能夠定義資料的處理策略。
若要在 Windows LUA 應用程式中使用 SLI_BID ,請發出 SLI_BID。 動詞完成時,可以透過下列兩種方式重新啟用:
重新發出 SLI_BID。
lua_flag1_bid_enable設為 1 的問題SLI_RECEIVE。 這會發出SLI_BID,該SLI_BID會針對 VCB 使用最近接受的位址,並建立作用中的報價。
每個會話一次只能有一個 SLI_BID 。
如果 Windows LUA 應用程式發出SLI_BID時有多個訊息可用,則會傳回具有最高優先順序的資料流程。 可以傳回資料的順序如下:
SSCP 加速
LU 加速
SSCP 一般
LU 一般
如果 SLI_RECEIVE 的旗標設定為讀取多個訊息流程類型, 則SLI_BID 傳回的資料可能適用于與您實際透過 SLI_RECEIVE接收資料的流程不同。 當優先順序較高的資料在 SLI_BID 完成處理之後從主機抵達,但在發出 SLI_RECEIVE 之前,就會發生這種情況。
為了確保SLI_RECEIVE讀取資料,傳回的SLI_BID會指定符合已完成SLI_BID傳回之lua_flag2的流程。
會話狀態傳回值
如果LUA_STATUS是主要傳回碼,次要傳回碼可以是LUA_READY、LUA_NOT_READY、LUA_SESSION_END_REQUESTED或LUA_INIT_COMPLETE。 此外,如果LUA_STATUS是主要傳回碼,則會使用下列參數:
lua_sec_rc
lua_sid
LUA_READY會在LUA_NOT_READY狀態之後傳回,並指出 SLI 再次準備好執行所有命令。
LUA_NOT_READY表示 SLI 會話已暫停,因為 SLI 已收到 SNA CLEAR 命令或具有0X02 UNBIND 類型的 SNA UNBIND 命令, (即將) 使用 BIND 的 UNBIND。 視造成暫停的原因而定,會話可以重新啟用,如下所示:
當暫停是由 SNA CLEAR 所造成時,接收 SNA SDT 會重新啟用會話。
當 SNA UNBIND 類型 BIND 即將引發會話暫停,且開啟會話的 SLI_OPEN 完成時,會話會暫停,直到 SLI 收到 BIND 和 SDT 命令為止。 會話也可以選擇性地接收 STSN 命令。 因此,必須重新輸入以初始SLI_OPEN發出的使用者提供常式,因為將會重新叫用這些常式。
應用程式可以在 CLEAR 或 UNBIND 類型 BIND 即將抵達且讀取 NOT READY 狀態之前傳送 SSCP 資料。 應用程式可以在讀取 NOT READY 之後傳送和接收 SSCP 資料。
當 SNA UNBIND 類型 BIND 即將抵達,然後才完成開啟會話的SLI_OPEN時,LUA_SESSION_FAILURE (未LUA_STATUS) 是主要傳回碼。
LUA_SESSION_END_REQUESTED表示應用程式從主機收到 SNA SHUTD。 Windows LUA 應用程式應該會在方便時發出 SLI_CLOSE 關閉會話。
只有在SLI_OPEN的lua_init_type LUA_INIT_TYPE_PRIM_SSCP時,才會傳回LUA_INIT_COMPLETE。 狀態表示SLI_OPEN已足夠處理,以便立即傳送或接收 SSCP 資料。
例外狀況要求
如果主應用程式要求單位轉換成 EXR,則會傳回感知資料。 當 SLI_BID 完成並設定傳回的動詞參數時,會發生 EXR 轉換。
成員 | 設定為 |
---|---|
lua_prim_rc | 確定 (0x0000) |
lua_sec_rc | 確定 (0x00000000) |
lua_rh.rri | 位關閉 (要求單位) |
lua_rh.sdi | bit on (包含感知資料) |
在 lua_peek_data 中的七個位元組資料 中,位元組 0 到 3 會定義偵測到的錯誤。 下表指出可能的感知資料和位元組 0 到 3 的值。
感知資料 | 位元組 0–3 的值 |
---|---|
LUA_MODE_INCONSISTENCY | 0x08090000 |
LUA_BRACKET_RACE_ERROR | 0x080B0000 |
LUA_BB_REJECT_NO_RTR | 0x08130000 |
LUA_RECEIVER_IN_TRANSMIT_MODE | 0x081B0000 |
LUA_CRYPTOGRAPHY_FUNCTION_INOP | 0x08480000 |
LUA_SYNC_EVENT_RESPONSE | 0x10010000 |
LUA_RU_DATA_ERROR | 0x10020000 |
LUA_RU_LENGTH_ERROR | 0x10020000 |
LUA_INCORRECT_SEQUENCE_NUMBER | 0x20010000 |
lua_peek_data 中傳 回至位元組 3 到 6 的資訊是由造成錯誤之初始要求單位的前 3 個位元組所決定。