共用方式為


RUI_TERM

RUI_TERM動詞會結束給定 LUA LU 的邏輯單元 (LU) 工作階段和系統服務控制點 (SSCP) 工作階段。

下列結構描述RUI_TERM所使用的動詞控制區塊 (VCB) LUA_COMMON 成員。

語法

  
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主機整合伺服器中 ® RUI 未使用,且應設定為零。

lua_cobol_offset
在主機整合伺服器中,LUA 不會使用 ,而且應該設定為零。

lua_sid
提供和傳回的參數。 指定會話標識碼,並由 SLI_OPENRUI_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

次要傳回碼;在 VCB 中指定 無效lua_sid值。

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 動詞。

另請參閱

RUI_INIT
SLI_OPEN