SLI_STSN_ROUTINE

[アーティクル]
07/21/2023

SLI_STSN_ROUTINE動詞は、STSN コマンドがホストから送信されたことを Microsoft® Windows® 論理ユニットアプリケーション (LUA) アプリケーションに通知し、ユーザーが指定したルーチンが要求を調べて応答を作成できるようにします。

次の構造体は、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
指定されたパラメーター。セッションレベルインターフェイス (SLI) 動詞のLUA_VERB_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が 0 の場合にのみこのパラメーターを必要とします。

このパラメーターの長さは 8 バイトで、名前が 8 文字より短い場合は、右側にスペース (0x20) が埋め込まれます。

lua_extension_list_offset
SLI_STSN_ROUTINEでは使用されず、0 に設定する必要があります。

lua_cobol_offset
Microsoft® Host Integration Server または SNA Server の LUA では使用されず、ゼロにする必要があります。

lua_sid
指定されたパラメーター。セッション識別子を指定し、 SLI_OPEN および RUI_INITによって返されます。他の動詞では、このパラメーターを使用して、コマンドに使用されるセッションを識別します。他の動詞で lua_luname パラメーターを使用してセッションを識別する場合は、 lua_sid パラメーターを 0 に設定します。

lua_max_length
SLI_STSN_ROUTINEでは使用されず、0 に設定する必要があります。

lua_data_length
返されたパラメーター。データバッファーで返される STSN 要求/応答ユニット (RU) データの長さを指定します。

lua_data_ptr
SLI_STSN_ROUTINEの場合、このパラメーターには STSN RU のアドレスが含まれます。

lua_post_handle
指定されたパラメーター。イベントによって非同期通知を実行する場合は、Microsoft Windows Server で使用されます。この変数には、シグナル処理されるイベントまたはウィンドウハンドルのハンドルが含まれます。

他のすべての環境では、このパラメーターは予約されており、ゼロに設定する必要があります。

lua_th
返されたパラメーター。受信したメッセージの SNA 伝送ヘッダー (TH) を格納します。読み取り関数と入札関数では、さまざまなサブパラメーターが返されます。

lua_rh
返されたパラメーター。送受信されるメッセージの SNA 要求/応答ヘッダー (RH) が含まれます。

lua_flag1
指定されたパラメーター。アプリケーションによって提供されるメッセージのフラグを含むデータ構造が含まれます。

lua_message_type
指定されたパラメーター。ホストに送信される SNA データまたはコマンドの種類を指定します。

lua_flag2
返されたパラメーター。 LUA によって返されるメッセージのフラグが含まれています。

lua_flag2.async

LUA インターフェイス動詞が 1 に設定されている場合に非同期的に完了したことを示します。

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
予約済みで、0 に設定する必要があります。

lua_encr_decr_option
SLI_STSN_ROUTINEでは使用されず、0 に設定する必要があります。

リターンコード

LUA_OK
プライマリリターンコード。動詞は正常に実行されました。

LUA_SEC_OK

セカンダリリターンコード。LUA_OKに関する追加情報は存在しません。

LUA_NEGATIVE_RSP
主なリターンコード。LUA がプライマリ論理ユニット (PLU) から受信したメッセージに否定応答を送信したか、メッセージでエラーが見つかったか、アプリケーションがチェーンの終了が到着したチェーンに否定的に応答しました。

注釈

SLI_STSN_ROUTINE は、Windows LUA アプリケーションが STSN コマンドを調べて応答するためのメカニズムを提供します。 Windows LUA は、ホストから STSN コマンドが受信されたことを Windows LUA アプリケーションに通知します。これは、ユーザー指定のダイナミックリンクライブラリ (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

構文

メンバー

リターン コード

注釈

参照

その他のリソース

リターンコード