SLI_OPEN

SLI_OPEN動詞會將指定邏輯單元 (LU) 的控制權傳輸到 LUA) 應用程式 (Microsoft® Windows® 邏輯單元應用程式。 SLI_OPEN 會在系統服務控制點 (SSCP) 和指定的 LU 和 LU-LU 會話之間建立會話。

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

第二個語法聯集描述SLI_OPEN所使用的 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 {  
    struct union SLI_OPEN open;  
};  
  
The SLI_OPEN structure contains the following nested structures and members:  
struct LUA_EXT_ENTRY {  
    unsigned char lua_routine_type;  
    unsigned char lua_module_name[9];  
    unsigned char lua_procedure_name[33];  
} ;  
  
struct SLI_OPEN {  
    unsigned char         lua_init_type;  
    unsigned char         lua_resv65;  
    unsigned short        lua_wait;  
    struct LUA_EXT_ENTRY  lua_open_extension[3];  
    unsigned char         lua_ending_delim;  
} ;  

成員

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_OPEN。

lua_correlator
提供的 參數。 包含使用者提供的值,可連結動詞與其他使用者提供的資訊。 LUA 不會使用或變更此資訊。 這是選擇性參數。

lua_luname
提供的 參數。 指定 Windows LUA 會話所使用的本機 LU 的 ASCII 名稱。

SLI_OPEN需要此參數。

此參數長度為八個位元組,如果名稱小於八個字元,則以空格填補右邊 (0x20) 。

lua_extension_list_offset
提供的 參數。 指定 VCB 開頭到使用者提供之動態連結程式庫擴充清單的位移, (DLL) 。 除非沒有延伸模組清單,否則此值必須是字界限的開頭。 在此情況下,值必須設定為零。

如果SLI_OPEN未使用此選項,則此成員應設定為零。

lua_cobol_offset
在 Microsoft® Host Integration Server 中,LUA 不會使用 ,而且應該是零。

lua_sid
傳回的參數。 指定會話識別碼。

lua_max_length
SLI_OPEN未使用,且應該設定為零。

lua_data_length
提供的 參數。 指定所傳送資料的實際長度。

lua_data_ptr
應用程式提供的緩衝區指標,其中包含要針對 SLI_OPEN傳送的資料。

SNA 命令和資料都會放在此緩衝區中,而且它們可以是擴充二進位編碼十進位交換程式碼, (EBCDIC) 格式。

發出SLI_OPEN時,此參數可以是下列其中一項:

  • 當初始化類型為次要且未格式化的 LOGON 訊息時,SSCP 一般流程的 LOGON 訊息。

  • INITSELF 的要求/回應單位 (RU) 。 當初始化類型是 INITSELF 的次要時,會提供應用程式的必要資料。

  • 對於所有其他開啟類型,此欄位應設定為零。

    此資訊是由 Windows LUA 應用程式提供。

    lua_post_handle
    提供的 參數。 如果事件要完成非同步通知,則用於 Microsoft Windows Server。 此變數包含要發出訊號的事件控制碼或視窗控制碼。

    lua_th
    SLI_OPEN未使用,且應該設定為零。

    lua_rh
    SLI_OPEN未使用,且應該設定為零。

    lua_flag1
    SLI_OPEN未使用,且應該設定為零。

    lua_message_type
    SLI_OPEN未使用,且應該設定為零。

    lua_flag2
    傳回的參數。 包含 LUA 所傳回之訊息的旗標。 其子參數如下所示:

    lua_flag2.async

    指出如果設定為 1,LUA 介面動詞會以非同步方式完成。

    lua_resv56
    提供的 參數。 SLI_OPENRUI_INIT所使用的保留字段。 如需詳細資訊,請參閱<備註>一節。

    lua_resv56[1]

    提供的 參數。 此參數必須設定為零。

    lua_resv56[2]

    提供的 參數。 指出 SLI 應用程式是否可以存取設定為 3270 RU 的 RU,以及 LUA RU。 如果此參數設定為 1,則可以存取 3270 RU。

    lua_resv56[3]

    提供的 參數。 指出是否支援不完整的讀取。 如果此參數設定為 1,則支援不完整或截斷的讀取。 如需詳細資訊,請參閱 RUI_READ的備註。

    lua_encr_decr_option
    SLI_OPEN未使用,且應該設定為零。

    open
    SLI_OPEN所使用的聯集成員LUA_SPECIFIC。 提供的參數集,包含在SLI_OPEN所需的SLI_OPEN結構中。

    open.lua_init_type

    提供的 參數。 定義 Windows LUA 介面如何初始化 LU-LU 會話。

    下列是有效值:

    LUA_INIT_TYPE_SEC_IS

    LUA_INIT_TYPE_SEC_LOG

    LUA_INIT_TYPE_PRIM

    LUA_INIT_TYPE_PRIM_SSCP

    open.lua_resv65

    保留的欄位。

    open.lua_wait

    提供的 參數。 表示次要重試等候時間,指出 Windows LUA 介面在重試 INITSELF 傳輸之前要等候的秒數,或在主機傳送其中一則訊息之後的 LOGON 訊息:

  • 負回應和次要傳回碼是下列其中一項:

    RESOURCE_NOT_AVAILABLE (0x08010000) SESSION_LIMIT_EXCEEDED (0x08050000) SESSION_SERVICE_PATH_ERROR (0x087D0000)

    請注意,如果lua_wait設定為零且發生上述其中一項,SLI_OPEN就會終止併發生錯誤。

  • NSPE) 訊息 (網路服務程式錯誤。

  • NOTIFY 命令,表示程式錯誤。

    open.lua_open_extension

    提供的 參數。 包含應用程式提供的擴充 DLL 清單,以處理 BIND、STSN 和 CRV 命令。

    open.open_extension.lua_routine_type

    擴充常式類型。 法律值如下:

    LUA_ROUTINE_TYPE_BIND

    LUA_ROUTINE_TYPE_CRV

    LUA_ROUTINE_TYPE_END (指出延伸模組清單結尾)

    LUA_ROUTINE_TYPE_STSN

    open.open_extension.lua_module_name

    提供的 參數。 提供使用者提供的擴充 DLL 的 ASCII 模組名稱。 模組名稱長度上限為八個字元,其餘位元組設定為 0x00。

    open.open_extension.lua_procedure_name

    提供的 參數。 提供使用者提供擴充 DLL 之 ASCII 中的程式名稱。 程式名稱長度上限為 32 個字元,其餘位元組設定為 0x00。

    open.lua_ending_delim

    延伸模組清單分隔符號。

傳回碼

LUA_OK
主要傳回碼;成功執行動詞。

LUA_SEC_OK

次要傳回碼;LUA_OK沒有任何其他資訊存在。

LUA_PARAMETER_CHECK
主要傳回碼;動詞因為參數錯誤而未執行。

LUA_INVALID_LUNAME

次要傳回碼;指定了無效 lua_luname 名稱。

LUA_BAD_SESSION_ID

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

LUA_BAD_DATA_PTR

次要傳回碼; lua_data_ptr 參數不包含有效的指標,或未指向讀取/寫入區段,而且需要提供的資料。

LUA_DATA_SEGMENT_LENGTH_ERROR

次要傳回碼;發生下列其中一項:

  • SLI_RECEIVESLI_SEND所提供的資料區段並非視需要讀取/寫入資料區段。

  • SLI_RECEIVE所提供的資料區段,只要lua_max_length中提供的資料區段就不一樣。

  • SLI_SEND所提供的資料區段,只要lua_data_length中提供的資料區段就不一樣。

    LUA_RESERVED_FIELD_NOT_ZERO

    次要傳回碼;剛發出動詞的保留參數不會設定為零。

    LUA_INVALID_POST_HANDLE

    次要傳回碼;對於使用事件做為非同步張貼方法的 Microsoft Windows 作業系統,Windows LUA VCB 不包含有效的事件控制碼。

    LUA_VERB_LENGTH_INVALID

    次要傳回碼;LUA 動詞是針對 LUA 非預期的 lua_verb_length 發出。

    LUA_INVALID_OPEN_INIT_TYPE

    次要傳回碼;SLI_OPEN中包含的lua_init_type無效。

    LUA_INVALID_OPEN_DATA

    次要傳回碼;當資料的緩衝區沒有有效的 INITSELF 命令時,所發出之SLI_OPENlua_init_type會設定為 LUA_INIT_TYPE_SEC_IS。

    LUA_INVALID_OPEN_ROUTINE_TYPE

    次要傳回碼;延伸模組常式SLI_OPEN清單的lua_open_routine_type無效。

    LUA_DATA_LENGTH_ERROR

    次要傳回碼;應用程式未提供所發出動詞所需的使用者提供資料。 請注意,當針對 SNA LUSTAT 命令發出 SLI_SEND 時,需要四個位元組的狀態 () , 而且當SLI_OPEN 發出次要初始化時,需要資料。

    LUA_INVALID_SLI_ENCR_OPTION

    次要傳回碼; lua_encr_decr_option 參數在 SLI_OPEN中設定為 128,不支援加密/解密處理選項。

    LUA_STATE_CHECK
    主要傳回碼;動詞未執行,因為其發行狀態無效。

    LUA_NOT_ACTIVE

    次要傳回碼;LUA 在發出 LUA 動詞時,在 Microsoft Host Integration Server 或 SNA Server 內未使用。

    LUA_UNEXPECTED_SNA_SEQUENCE

    次要傳回碼;在處理 SLI_OPEN 時,會從主機接收非預期的資料或命令。

    LUA_NEG_RSP_FROM_BIND_ROUTINE

    次要傳回碼;使用者提供的SLI_BIND常式會以負面方式回應 BIND。 SLI_OPEN 未成功結束。

    LUA_NEG_RSP_FROM_STSN_ROUTINE

    次要傳回碼;使用者提供的 SLI STSN 常式會以負面方式回應 STSN。 SLI_OPEN 未成功結束。

    LUA_PROCEDURE_ERROR

    次要傳回碼;主機程式錯誤是由收到 NSPE 或 NOTIFY 訊息所表示。 未使用重試選項時,傳回碼會張貼至 SLI_OPEN 。 若要使用重設選項, 請將lua_wait 設定為零以外的值。 系統會重試 LOGON 或 INITSELF 命令,直到主機就緒或發出 SLI_CLOSE為止。

    LUA_RECEIVED_UNBIND

    次要傳回碼;PLU 主要邏輯單元 (PLU) 在會話作用中時,將 SNA UNBIND 命令傳送至 LUA 介面。 因此,會話已停止。

    LUA_SLI_LOGIC_ERROR

    次要傳回碼;LUA 介面在邏輯中發現內部錯誤。

    LUA_NO_RUI_SESSION

    次要傳回碼;未針對發出 LUA 動詞的會話進行初始化,或在初始化會話之前發出 SLI_OPEN 以外的一些動詞。

    LUA_RESOURCE_NOT_AVAILABLE

    次要傳回碼;要求單位中指定的邏輯單元、實體單位、連結或連結站無法使用。 除非您使用重試選項,否則當資源無法使用時,此傳回碼會張貼至 SLI_OPEN

    若要使用重試選項,請將 lua_wait 設定為零以外的值。 系統會重試 LOGON 或 INITSELF 命令,直到主機就緒或發出 SLI_CLOSE為止。

    LUA_SESSION_LIMIT_EXCEEDED

    次要傳回碼;要求的會話未啟動,因為 NAU 在其會話限制中。 此 SNA 感知碼適用于下列要求:BID、CINIT、INIT 和 ACTDRM。

    除非您使用 RETRY 選項,否則當 NAU 處於限制時,程式碼將會張貼至 SLI_OPEN

    若要使用重設選項,請將 lua_wait 設定為零以外的值。 系統會重試 LOGON 或 INITSELF 命令,直到主機就緒或發出 SLI_CLOSE為止。

    LUA_LU_COMPONENT_DISCONNECTED

    次要傳回碼;因為 LU 元件未正確連線,所以無法使用。 請確定電源已開啟。

    LUA_NEGOTIABLE_BIND_ERROR

    次要傳回碼;收到一個SLI_BIND系結,只有在使用者提供的SLI_BIND常式隨附 SLI_OPEN時,SLI 才允許此常式。

    LUA_BIND_FM_PROFILE_ERROR

    次要傳回碼;LUA 介面僅支援檔案管理標頭設定檔 3 和 4。 在 BIND 上找到 3 或 4 以外的檔案管理設定檔。

    LUA_BIND_TS_PROFILE_ERROR

    次要傳回碼;LUA 介面僅支援傳輸服務 (TS) 設定檔 3 和 4。 在 BIND 上找到 3 或 4 以外的 TS 設定檔。

    LUA_BIND_LU_TYPE_ERROR

    次要傳回碼;LUA 僅支援 LU 0、LU 1、LU 2 和 LU 3。 找到 0、1、2 或 3 以外的 LU。

    LUA_SSCP_LU_SESSION_NOT_ACTIVE

    次要傳回碼;必要的 SSCP-LU 為非作用中。 特定感知程式碼資訊以位元組 2 和 3 為單位。 有效的設定為0x0000、0x0001、0x0002、0x0003和0x0004。

    LUA_SESSION_SERVICES_PATH_ERROR

    次要傳回碼;會話服務的要求無法重新路由傳送至 SSCP-SSCP 會話路徑。 位元組 2 和 3 中的特定意義程式碼資訊提供有關為何無法重新路由要求的詳細資訊。

    LUA_UNSUCCESSFUL
    主要傳回碼;提供的動詞記錄有效,但動詞未順利完成。

    LUA_VERB_RECORD_SPANS_SEGMENTS

    次要傳回碼;LUA VCB 長度參數加上區段位移超出區段結尾。

    LUA_SESSION_ALREADY_OPEN

    次要傳回碼;會話已經針對 SLI_OPEN中指定的 LU 名稱開啟。

    LUA_INVALID_PROCESS

    次要傳回碼;發出 LUA 動詞命令的會話無法使用,因為另一個進程擁有會話。

    LUA_LINK_NOT_STARTED

    次要傳回碼;LUA 無法在會話初始化期間啟動資料連結。

    LUA_INVALID_ADAPTER

    次要傳回碼;資料連結控制項的組態 (DLC) 發生錯誤,或組態檔損毀。

    LUA_ENCR_DECR_LOAD_ERROR

    次要傳回碼;嘗試載入使用者提供的加密或解密動態連結模組時,OS/2 DosLoadModule 函式收到未預期的傳回碼。

    LUA_ENCR_DECR_PROC_ERROR

    次要傳回碼;嘗試在使用者提供的加密或解密動態連結模組內取得程式位址時,從 OS/2 DosGetProcAddr 函 式收到未預期的傳回碼。

    LUA_NEG_NOTIFY_RSP

    次要傳回碼;SSCP 以負面方式回應發出 NOTIFY 要求,指出次要 LU 能夠進行會話。 已瞭解並支援要求的半會話元件,但無法執行要求。

    LUA_LU_INOPERATIVE

    次要傳回碼;SLI 嘗試停止會話時發生嚴重錯誤。 任何 LUA 要求都無法使用此 LU,直到從主機收到啟動邏輯單元 (ACTLU) 為止。

    LUA_CANCELED
    主要傳回碼;次要傳回碼會提供取消命令的原因。

    LUA_TERMINATED

    次要傳回碼;當動詞擱置時,會話已終止。 已取消動詞程式。

    LUA_IN_PROGRESS
    主要傳回碼;已收到非同步命令,但尚未完成。

    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_OPEN,Windows LUA 介面:

另請參閱

RUI_INIT
SLI_RECEIVE
SLI_SEND