LUA_COMMON

2025-06-05

下列結構列出所有邏輯單元應用程式（LUA）動詞所使用的通用數據結構參數。

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;  
} LUA_COMMON;

備註

成員

lua_verb
提供的參數。包含動詞程式代碼，LUA_VERB_RUI要求單位介面（RUI）動詞或會話層級介面（SLI）動詞動詞的LUA_VERB_SLI。在這兩個巨集中，值都是0x5200。

lua_verb_length
提供的參數。指定 LUA VCB 的位元組長度。它必須包含所發出動詞記錄的長度。

lua_prim_rc
LUA 在動詞完成時設定的主要傳回碼。有效的傳回碼會根據所發出的 LUA 動詞而有所不同。

lua_sec_rc
LUA 在動詞完成時所設定的次要傳回碼。有效的傳回碼會根據所發出的 LUA 動詞而有所不同。

lua_opcode
提供的參數。包含要發出動詞命令的 LUA 命令程式代碼（動詞作業程式代碼），例如， LUA_OPCODE_RUI_BID RUI_BID 動詞命令。

lua_correlator
提供的參數。包含使用者提供的值，這個值會鏈接動詞與其他使用者提供的資訊。 LUA 不會使用或變更這項資訊。這是選擇性參數。

lua_luname
提供的參數。指定 Windows LUA 工作階段所使用的本機 LU 的 ASCII 名稱。

SLI_OPEN 和 RUI_INIT 需要此參數。如果 lua_sid 為零，其他 Windows LUA 動詞只需要此參數。

如果名稱短於八個字元，則此參數長度為8個字節，以空格（0x20）填補右邊。

lua_extension_list_offset
指定 VCB 開頭到使用者提供的動態連結庫延伸模組清單（DLL）的位移。主機整合伺服器中 RUI 未使用，且應設定為零。

lua_cobol_offset
COBOL 延伸模組的位移。在主機整合伺服器中，LUA 不會使用，而且應該是零。

lua_sid
提供和傳回的參數。指定會話標識碼，並由 SLI_OPEN 和 RUI_INIT傳回。其他動詞會使用此參數來識別用於命令的會話。如果其他動詞使用 lua_luname 參數來識別會話，請將 lua_sid 參數設定為零。

lua_max_length
指定 RUI_READ和 SLI_RECEIVE的接收緩衝區長度。若為其他 RUI 和 SLI 動詞，則不會使用它，而且應該設定為零。

lua_data_length
傳回的參數。指定RUI_BID動詞命令lua_peek_data中傳回的數據長度。

lua_data_ptr
應用程式提供之緩衝區的指標，其中包含要針對 SLI_SEND 和 RUI_WRITE 傳送的數據，或是接收 SLI_RECEIVE 和 RUI_READ的數據。若為其他 RUI 和 SLI 動詞，則不會使用此參數，而且應該設定為零。

lua_post_handle
提供的參數。如果事件要完成異步通知，則會在 Windows 下使用。此變數包含要發出訊號的事件句柄或視窗句柄。

lua_th
傳回的參數。包含已傳送或接收之訊息的 SNA 傳輸標頭（TH）。針對寫入函式設定各種子參數，並針對讀取和投標函式傳回。

lua_th.flags_fid

格式識別類型 2，四個位。

lua_th.flags_mpf

區隔對應欄位，兩個位。

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.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
提供的參數。包含包含應用程式所提供訊息旗標的資料結構。此參數由 RUI_BID、RUI_READ、RUI_WRITE、SLI_BID、SLI_RECEIVE 和 SLI_SEND 使用。若為其他 LUA 動詞命令，則不會使用此參數，而且應該設定為零。

lua_flag1.bid_enable

投標啟用指標，一個位。

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
指定輸入或輸出 SNA 命令和資料的類型。這是 RUI_INIT 和 SLI_OPEN 的傳回參數，也是 SLI_SEND提供的參數。若為其他 LUA 動詞，則不會使用此變數，而且應該設定為零。

可能的值為：

LUA_MESSAGE_TYPE_LU_DATA

LUA_MESSAGE_TYPE_SSCP_DATA

LUA_MESSAGE_TYPE_BID

LUA_MESSAGE_TYPE_BIND

LUA_MESSAGE_TYPE_BIS

LUA_MESSAGE_TYPE_CANCEL

LUA_MESSAGE_TYPE_CHASE

LUA_MESSAGE_TYPE_CLEAR

LUA_MESSAGE_TYPE_CRV

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_RQR

LUA_MESSAGE_TYPE_RTR

LUA_MESSAGE_TYPE_SBI

LUA_MESSAGE_TYPE_SHUTD

LUA_MESSAGE_TYPE_SIGNAL

LUA_MESSAGE_TYPE_SDT

LUA_MESSAGE_TYPE_STSN

LUA_MESSAGE_TYPE_UNBIND

SLI 會透過 LUA 介面擴充例程接收並回應 BIND、CRV 和 STSN 要求。

LU_DATA、LUSTAT_LU、LUSTAT_SSCP和SSCP_DATA不是 SNA 命令。

lua_flag2
傳回的參數。包含 LUA 所傳回之訊息的旗標。此參數是由 RUI_BID、 RUI_READ、 RUI_WRITE、 SLI_BID、 SLI_RECEIVE 和 SLI_SEND 所傳回。對於其他 LUA 動詞，這個參數不會使用，而且應該設定為零。

lua_flag2.bid_enable

表示如果設定為 1，則已成功重新啟用 RUI_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
提供的參數。 SLI_OPEN和RUI_INIT所使用的保留欄位。對於所有其他 LUA 動詞，此參數是保留的，而且應該設定為零。

lua_encr_decr_option
密碼編譯選項的欄位。在 RUI_INIT上，僅支援下列專案：

lua_encr_decr_option = 0
lua_encr_decr_option = 128

對於所有其他 LUA 動詞，此參數是保留的，而且應該設定為零。

共用方式為

LUA_COMMON

備註

成員

其他資源