SLI_OPEN

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

SLI_OPEN動詞は、指定された論理ユニット (LU) の制御を Microsoft® Windows® 論理ユニットアプリケーション (LUA) アプリケーションに転送します。 SLI_OPEN は、システム・サービス制御ポイント (SSCP) と指定された LU、および LU-LU セッションの間にセッションを確立します。

次の構造体は、SLI_OPENによって使用される動詞制御ブロック (VCB) のLUA_COMMON メンバーについて説明します。

2 番目の構文共用体は、 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
指定されたパラメーター。セッションレベルインターフェイス (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_OPEN。

lua_correlator
指定されたパラメーター。動詞を他のユーザー指定の情報とリンクするユーザー指定の値が含まれます。 LUA では、この情報は使用または変更されません。このパラメーターは省略可能です。

lua_luname
指定されたパラメーター。 Windows LUA セッションで使用されるローカル LU の ASCII 名を指定します。

SLI_OPENには、このパラメーターが必要です。

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

lua_extension_list_offset
指定されたパラメーター。 VCB の先頭からユーザー指定のダイナミックリンクライブラリ (DLL) の拡張リストへのオフセットを指定します。拡張リストがない限り、値は単語の境界の先頭である必要があります。この場合、値を 0 に設定する必要があります。

このオプションをSLI_OPENで使用しない場合は、このメンバーを 0 に設定する必要があります。

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

lua_sid
返されたパラメーター。セッション識別子を指定します。

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

lua_data_length
指定されたパラメーター。送信されるデータの実際の長さを指定します。

lua_data_ptr
SLI_OPENに送信されるデータを含むアプリケーション提供のバッファーへのポインター。

SNA コマンドとデータはどちらもこのバッファーに入れられ、拡張バイナリ・コード化 10 進数交換コード (EBCDIC) 形式にすることができます。

SLI_OPENを発行する場合、このパラメーターには次のいずれかを指定できます。

初期化の種類が未フォーマットの LOGON メッセージを含むセカンダリである場合の SSCP 標準フローの LOGON メッセージ。
INITSELF の要求/応答ユニット (RU)。初期化の種類が INITSELF でセカンダリである場合、アプリケーションに必要なデータが提供されます。
他のすべての開いている型の場合、このフィールドは 0 に設定する必要があります。

この情報は、Windows LUA アプリケーションによって提供されます。

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

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

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

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

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

lua_flag2
返されたパラメーター。 LUA によって返されるメッセージのフラグが含まれます。そのサブパラメーターは次のとおりです。

lua_flag2.async

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

lua_resv56
指定されたパラメーター。 SLI_OPENおよびRUI_INITによって使用される予約済みフィールド。詳細については、「解説」を参照してください。

lua_resv56[1]

指定されたパラメーター。このパラメーターは 0 に設定する必要があります。

lua_resv56[2]

指定されたパラメーター。 SLI アプリケーションが LUA LU に加えて、3270 RU として構成された LU にアクセスできるかどうかを示します。このパラメーターが 1 に設定されている場合は、3270 RU にアクセスできます。

lua_resv56[3]

指定されたパラメーター。不完全な読み取りがサポートされているかどうかを示します。このパラメーターが 1 に設定されている場合は、不完全読み取りまたは切り捨て読み取りがサポートされます。詳細については、 RUI_READに関する解説を参照してください。

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

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

指定されたパラメーター。ホストが次のいずれかのメッセージを送信した後に INITSELF または LOGON メッセージの送信を再試行する前に、Windows LUA インターフェイスが待機する秒数を示す 2 次再試行待機時間を表します。
負の応答と 2 番目のリターンコードは、次のいずれかです。

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

lua_waitが 0 に設定され、上記のいずれかが発生した場合、SLI_OPENはエラーで終了することに注意してください。
ネットワークサービスプロシージャエラー (NSPE) メッセージ。
NOTIFY コマンド。プロシージャエラーを示します。

open.lua_open_extension

指定されたパラメーター。 BIND、STSN、CRV コマンドを処理するためのアプリケーション指定の拡張 DLL の一覧が含まれます。

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 モジュール名を提供します。モジュール名は最大 8 文字まで使用でき、残りのバイト数は 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_RECEIVEまたはSLI_SENDに指定されたデータセグメントは、必要に応じて読み取り/書き込みデータセグメントではありません。
SLI_RECEIVEに提供されるデータセグメントは、lua_max_lengthで提供されている限りではありません。
SLI_SENDに提供されるデータセグメントは、lua_data_lengthで提供されている限りではありません。

LUA_RESERVED_FIELD_NOT_ZERO

セカンダリリターンコード。発行した動詞の予約パラメーターが 0 に設定されていません。

LUA_INVALID_POST_HANDLE

セカンダリリターンコード。非同期投稿方法としてイベントを使用する Microsoft Windows オペレーティングシステムの場合、Windows LUA VCB には有効なイベントハンドルが含まれていません。

LUA_VERB_LENGTH_INVALID

セカンダリリターンコード。LUA によって予期しない lua_verb_length の値を持つ LUA 動詞が発行されました。

LUA_INVALID_OPEN_INIT_TYPE

セカンダリリターンコード。SLI_OPENに含まれるlua_init_typeの値が無効です。

LUA_INVALID_OPEN_DATA

セカンダリリターンコード。発行された SLI_OPEN の lua_init_type は、データのバッファーに有効な INITSELF コマンドがない場合にLUA_INIT_TYPE_SEC_ISに設定されます。

LUA_INVALID_OPEN_ROUTINE_TYPE

セカンダリリターンコード。拡張ルーチンの SLI_OPEN リストの lua_open_routine_type が無効です。

LUA_DATA_LENGTH_ERROR

セカンダリリターンコード。アプリケーションは、発行された動詞に必要なユーザー指定のデータを提供しませんでした。 SNA LUSTAT コマンドに対してSLI_SEND を発行する場合は、状況 (4 バイト単位) が必要であり、 SLI_OPEN が 2 次初期設定で発行される場合は、データが必要であることに注意してください。

LUA_INVALID_SLI_ENCR_OPTION

セカンダリリターンコード。SLI_OPENでは、lua_encr_decr_option パラメーターが 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 を 0 以外の値に設定します。 LOGON または INITSELF コマンドは、ホストの準備が整うか、SLI_CLOSEを発行するまで再試行されます。

LUA_RECEIVED_UNBIND

セカンダリリターンコード。プライマリ論理ユニット (PLU) は、セッションがアクティブな場合に SNA UNBIND コマンドを LUA インターフェイスに送信しました。その結果、セッションは停止しました。

LUA_SLI_LOGIC_ERROR

セカンダリリターンコード。LUA インターフェイスでロジックに内部エラーが見つかりました。

LUA_NO_RUI_SESSION

セカンダリリターンコード。発行された LUA 動詞に対してセッションが初期化されていないか、セッションが初期化される前 にSLI_OPEN 以外の動詞が発行されました。

LUA_RESOURCE_NOT_AVAILABLE

セカンダリリターンコード。要求装置で指定された論理装置、物理装置、リンク、またはリンク・ステーションは使用できません。このリターンコードは、再試行オプションを使用しない限り、リソースが使用できない場合に SLI_OPEN にポストされます。

再試行オプションを使用するには、 lua_wait を 0 以外の値に設定します。 LOGON または INITSELF コマンドは、ホストの準備ができるまで、または SLI_CLOSEを発行するまで再試行されます。

LUA_SESSION_LIMIT_EXCEEDED

セカンダリリターンコード。NAU がセッション制限に達しているため、要求されたセッションはアクティブ化されませんでした。この SNA センスコードは、BID、CINIT、INIT、ACTDRM の各要求に適用されます。

RETRY オプションを使用しない限り、NAU が制限されている場合、コードは SLI_OPEN にポストされます。

リセットオプションを使用するには、 lua_wait を 0 以外の値に設定します。 LOGON または INITSELF コマンドは、ホストの準備ができるまで、または SLI_CLOSEを発行するまで再試行されます。

LUA_LU_COMPONENT_DISCONNECTED

セカンダリリターンコード。LU コンポーネントは正しく接続されていないため使用できません。電源がオンになっていることを確認します。

LUA_NEGOTIABLE_BIND_ERROR

セカンダリリターンコード。交渉可能な 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 は、セカンダリ LU がセッションに対応できることを示す NOTIFY 要求に否定的に応答しました。要求を受信したハーフセッションコンポーネントは、要求を認識し、サポートしましたが、実行できませんでした。

LUA_LU_INOPERATIVE

セカンダリリターンコード。SLI がセッションの停止を試みている間に重大なエラーが発生しました。この LU は、アクティブ化論理ユニット (ACTLU) がホストから受信されるまで、すべての LUA 要求で使用できません。

LUA_CANCELED
主なリターンコード。セカンダリリターンコードは、コマンドを取り消す理由を与えます。

LUA_TERMINATED

セカンダリリターンコード。動詞が保留中のときにセッションが終了しました。動詞プロセスが取り消されました。

LUA_IN_PROGRESS
主なリターンコード。非同期コマンドが受信されましたが、完了していません。

LUA_COMM_SUBSYSTEM_ABENDED
プライマリリターンコード。次のいずれかの条件を示します。
このメッセージ交換で使用されているノードで、ABEND が発生しました。
トランザクションプログラム (TP) と物理ユニット (PU) 2.1 ノード間の接続が切断されました (LAN エラー)。
TP コンピューターの SnaBase で、異常終了が発生しました。

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 インターフェイスは次の手順を実行します。

通信セッションを開始します。
BIND コマンドをホストから読み取って検証し、BIND 拡張ルーチンが指定されている場合はアプリケーションに渡します。
BIND 応答を書き込みます。
STSN コマンドを読み取って処理し、BIND 拡張機能が指定されている場合はアプリケーションに渡します (必要な場合)。
STSN 応答を書き込みます (必要な場合)。
CRV コマンドを読み取ります (必要な場合)。
CRV 応答を書き込みます (必要な場合)。
SDT コマンドを読み取って処理します。
SDT 応答を書き込みます。

Windows LUA インターフェイスは、開いている型が LUA_INIT_TYPE_SEC_IS または LUA_INIT_TYPE_SEC_LOG に設定 されたSLI_OPEN を発行するセッションに対して、次の追加機能を実行します。
INITSELF または書式設定されていない LOGON メッセージを書き込みます。
INITSELF 応答または LOGON メッセージ応答を読み取って処理します。

すべての SNA メッセージトラフィックは、SDT コマンド応答を介して SLI_OPEN によって管理されます。

Windows LUA 用に構成された特定の LU を選択するために、アプリケーションは ASCII の LU 名にlua_lunameを設定し、必要に応じて末尾のスペースを埋め込みます。

lua_prim_rc パラメーターに LUA_OK を指定してSLI_OPENがポストされると、SLI_OPEN正常に完了し、LU-LU データフローセッションが確立されました。アプリケーションで、SLI_BID、SLI_CLOSE、SLI_PURGE、SLI_RECEIVE、SLI_SENDを発行できるようになりました。

SLI_OPENがLUA_OKまたはLUA_IN_PROGRESS以外の主要な戻りコードと共にポストされた場合、コマンドはセッションを正常に確立しませんでした。

SLI_OPENを使用する場合、Windows LUA アプリケーションでセッション初期化の種類を指定する必要があります。有効な型は次のとおりです。
INITSELF によるセカンダリ
書式設定されていない LOGON メッセージによるセカンダリ
BIND コマンドを待機しているプライマリ
SSCP アクセスによるプライマリ
INITSELF によるセカンダリ
書式設定されていない LOGON メッセージによるセカンダリ
BIND コマンドを待機しているプライマリ
SSCP アクセスによるプライマリ
BIND、CRV、および STSN ルーチン
BIND の例
SESSION_FAILURE からの回復
保留中の SLI_OPEN の終了

参照

RUI_INIT
SLI_RECEIVE
SLI_SEND

SLI_OPEN

構文

メンバー

リターン コード

注釈

参照

その他のリソース

リターンコード