RUI_TERM
RUI_TERM動詞會結束邏輯單元 (LU) 會話,以及指定 LUA LU 的系統服務控制點 (SSCP) 會話。
下列結構描述LUA_COMMON RUI_TERM RUI_TERM所使用的動詞控制項區塊 (VCB) 成員。
語法
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_verb
提供的參數。 包含動詞程式碼,LUA_VERB_RUI要求單位介面 (RUI) 動詞命令。
lua_verb_length
提供的參數。 指定邏輯單元應用程式 (LUA) VCB 的位元組長度。 它必須包含發出之動詞記錄的長度。
lua_prim_rc
LUA 在動詞完成時所設定的主要傳回碼。 有效的傳回碼會根據發出的 LUA 動詞命令而有所不同。
lua_sec_rc
LUA 在動詞完成時所設定的次要傳回碼。 有效的傳回碼會根據發出的 LUA 動詞命令而有所不同。
lua_opcode
提供的參數。 包含 LUA 命令程式碼 (動詞作業程式碼,) 發出動詞命令,LUA_OPCODE_RUI_TERM。
lua_correlator
提供的參數。 包含使用者提供的值,這個值會連結動詞命令與其他使用者提供的資訊。 LUA 不會使用或變更此資訊。 這是選擇性參數。
lua_luname
提供的參數。 指定 Windows LUA 會話所使用的本機 LU 的 ASCII 名稱。
RUI_TERM 只有在 lua_sid 為零時,才需要此參數。
如果名稱短于八個字元,則此參數長度為 8 個位元組,在右側填補空格 (0x20) 。
lua_extension_list_offset
未由 Microsoft® Host Integration Server 中的 RUI 使用,而且應該設定為零。
lua_cobol_offset
LUA 在主機整合伺服器中未使用,且應設定為零。
lua_sid
提供和傳回的參數。 指定會話識別碼,並由 SLI_OPEN 和 RUI_INIT傳回。 其他動詞命令會使用此參數來識別用於命令的會話。 如果其他動詞使用 lua_luname 參數來識別會話,請將 lua_sid 參數設定為零。
lua_max_length
RUI_TERM未使用,且應設定為零。
lua_data_length
RUI_TERM未使用,且應設定為零。
lua_data_ptr
RUI_TERM未使用,且應設定為零。
lua_post_handle
提供的參數。 如果事件要完成非同步通知,請在 Microsoft Windows Server 下使用。 此變數包含要發出訊號的事件控制碼或視窗控制碼。
lua_th
RUI_TERM未使用,且應設定為零。
lua_rh
RUI_TERM未使用,且應設定為零。
lua_flag1
RUI_TERM未使用,且應設定為零。
lua_message_type
RUI_TERM未使用,且應設定為零。
lua_flag2
RUI_TERM未使用,且應設定為零。
lua_resv56
保留 且 應設定為零。
lua_encr_decr_option
保留 且 應設定為零。
傳回碼
LUA_OK
主要傳回碼;已成功執行動詞。
LUA_PARAMETER_CHECK
主要傳回碼;動詞未執行,因為發生參數錯誤。
LUA_BAD_SESSION_ID
次要傳回碼;lua_sid在 VCB 中指定了不正確值。
LUA_INVALID_POST_HANDLE
次要傳回碼;對於使用事件做為非同步張貼方法的 Windows 作業系統,Windows LUA VCB 不包含有效的事件控制碼。
LUA_RESERVED_FIELD_NOT_ZERO
次要傳回碼;動詞記錄中的保留字段或這個動詞未使用的參數設定為非零值。
LUA_VERB_LENGTH_INVALID
次要傳回碼;LUA 動詞發出時,LUA 的值 lua_verb_length非預期 。
LUA_STATE_CHECK
主要傳回碼;指令動詞未執行,因為發出狀態無效。
LUA_NO_RUI_SESSION
次要傳回碼; RUI_INIT 尚未針對 在 RUI_TERM上指定的 LU 名稱順利完成。
LUA_UNSUCCESSFUL
主要傳回碼;提供的動詞記錄有效,但動詞未順利完成。
LUA_COMMAND_COUNT_ERROR
次要傳回碼;發出動詞時 ,RUI_TERM 已經擱置中。
LUA_INVALID_PROCESS
次要傳回碼;發出此動詞命令的 OS/2 程式與發出此會話 RUI_INIT 的程式不同。 只有啟動會話的程式可以發出該會話的動詞命令。
LUA_COMM_SUBSYSTEM_ABENDED
主要傳回碼;表示下列其中一個條件:
此交談所使用的節點遇到 ABEND。
交易程式 (TP) 與實體單位 (PU) 2.1 節點之間的連線中斷, (LAN 錯誤) 。
TP 電腦上的 SnaBase 遇到 ABEND。
LUA_SESSION_FAILURE
主要傳回碼;必要的主機整合伺服器元件已終止。LUA_LU_COMPONENT_DISCONNECTED
次要傳回碼;表示 LUA 會話因為連結服務或主機 LU 發生問題而失敗。
LUA_RUI_LOGIC_ERROR
次要傳回碼;LUA 內偵測到內部錯誤。 在正常作業期間不應該發生此錯誤。
LUA_INVALID_VERB
主要傳回碼;動詞程式碼或作業程式碼或兩者都無效。 動詞未執行。LUA_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小,無法執行動詞。 增加應用程式的堆疊大小。LUA_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;無法載入必要的元件,或在處理動詞時終止。 因此,無法進行通訊。 請連絡系統管理員以採取更正動作。LUA_UNEXPECTED_DOS_ERROR
主要傳回碼;發出作業系統呼叫之後,收到非預期的作業系統傳回碼,並在次要傳回碼中指定。
備註
在發出RUI_INIT (是否已完成 ) 之後,隨時可以發出這個動詞。 如果發出 RUI_TERM 時任何其他 LUA 動詞擱置中,則不會對擱置動詞進行進一步處理,並且會傳回具有主要傳回碼LUA_CANCELED。
完成此動詞之後,此會話無法發出任何其他 LUA 動詞。