SLI_STSN_ROUTINE

發行項
07/21/2023

SLI_STSN_ROUTINE動詞會通知 Microsoft® Windows® 邏輯單元應用程式 (LUA) 應用程式，STSN 命令來自主機，並允許使用者提供的常式檢查要求並制定回應。

下列結構描述SLI_STSN_ROUTINE所使用的動詞控制項區塊 (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_SLI工作階段層級介面 (SLI) 動詞。

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

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

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

lua_opcode
提供的參數。包含 LUA 命令程式碼 (動詞作業程式碼) ，以便發出動詞LUA_OPCODE_SLI_STSN_ROUTINE。

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

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

SLI_STSN_ROUTINE只有在lua_sid為零時，才需要此參數。

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

lua_extension_list_offset
SLI_STSN_ROUTINE未 使用，且 應設定為零。

lua_cobol_offset
LUA 在 Microsoft® Host Integration Server 或 SNA Server 中使用，而且應該為零。

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

lua_max_length
SLI_STSN_ROUTINE未 使用，且 應設定為零。

lua_data_length
傳回的參數。指定 STSN 要求/回應單位的長度， (RU) 資料緩衝區中傳回的資料。

lua_data_ptr
針對 SLI_STSN_ROUTINE 此參數包含 STSN RU 的位址。

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

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

lua_th
傳回的參數。包含所接收訊息的 SNA 傳輸標頭 (TH) 。讀取和 bid 函式會傳回各種子參數。

lua_rh
傳回的參數。包含傳送或接收之訊息的 SNA 要求/回應標頭 (RH) 。

lua_flag1
提供的參數。包含包含應用程式所提供訊息旗標的資料結構。

lua_message_type
提供的參數。指定傳送至主機的 SNA 資料或命令類型。

lua_flag2
傳回的參數。包含 LUA 所傳回之訊息的旗標。

lua_flag2.async

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

lua_flag2.sscp_exp

指出系統服務控制點 (SSCP) 設定為 1 的加速流程。

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_STSN_ROUTINE未 使用，且 應設定為零。

傳回碼

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

LUA_SEC_OK

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

LUA_NEGATIVE_RSP
主要傳回碼;LUA 會傳送負回應給從主要邏輯單元接收的訊息， (PLU) ，因為訊息中發現錯誤，或應用程式對鏈結結束抵達的鏈結回應負數。

備註

SLI_STSN_ROUTINE 提供 Windows LUA 應用程式檢查及回應 STSN 命令的機制。 Windows LUA 會通知 Windows LUA 應用程式，STSN 命令已從主機接收。這是透過使用者提供的動態連結程式庫來完成， (DLL) 。使用者 DLL 會檢查 STSN 要求，並制定要求的回應。

常式的 DLL 名稱是以 SLI_OPEN 動詞 VCB 的延伸模組的形式提供。 lua_extension_list_offset 參數提供從 VCB 開頭到延伸模組清單中的名字的位移。

Windows LUA 介面會指派 VCB 結構化的儲存空間。 SLI_STSN_ROUTINE的 VCB 包含lua_th和lua_rh。 STSN RU 的位址是在 lua_data_ptr中指定，而 RU 的長度是在 lua_data_length中指定。

當SLI_STSN_ROUTINE返回 Windows LUA 時，SLI_STSN_ROUTINE的處理就會完成。 STSN 回應應覆寫 STSN RU。接受 STSN 時，主要傳回碼應設定為 LUA_OK。如果 STSN 遭到拒絕，則主要傳回碼應該設定為 LUA_NEGATIVE_RSP，而 STSN 緩衝區包含負感代碼。不應修改lua_data_ptr參數。

如果從SLI_STSN_ROUTINE傳回負回應，則會取消SLI_OPEN 。 SLI_OPEN lua_prim_rc會設定為 LUA_SESSION_FAILURE，而lua_sec_rc設定為 LUA_NEG_RSP_FROM_STSN_ROUTINE。

另請參閱

RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND

共用方式為

SLI_STSN_ROUTINE

語法

成員

傳回碼

備註

另請參閱

其他資源