SLI_PURGE
SLI_PURGE動詞は、待機条件で発行SLI_RECEIVE動詞を取り消します。
次の構造体は、SLI_PURGEによって使用される動詞制御ブロック (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_PURGE。
lua_correlator
指定されたパラメーター。 動詞を他のユーザー指定の情報とリンクするユーザー指定の値が含まれます。 LUA では、この情報は使用または変更されません。 このパラメーターは省略可能です。
lua_luname
指定されたパラメーター。 Windows LUA セッションで使用されるローカル LU の ASCII 名を指定します。
SLI_PURGEは、lua_sidが 0 の場合にのみ、このパラメーターを必要とします。
このパラメーターの長さは 8 バイトで、名前が 8 文字より短い場合は、右側にスペース (0x20) が埋め込まれます。
lua_extension_list_offset
SLI_PURGEでは使用されず、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_PURGEでは使用されず、0 に設定する必要があります。
lua_data_length
SLI_PURGEでは使用されず、0 に設定する必要があります。
lua_data_ptr
SLI_PURGEが発行されると、このパラメーターは取り消されるSLI_RECEIVE動詞 VCB の位置を指します。
lua_post_handle
指定されたパラメーター。 イベントによって非同期通知を実行する場合は、Microsoft Windows Server で使用されます。 この変数には、通知されるイベントのハンドルまたはウィンドウ ハンドルが含まれます。
lua_th
SLI_PURGEでは使用されず、0 に設定する必要があります。
lua_rh
SLI_PURGEでは使用されず、0 に設定する必要があります。
lua_flag1
SLI_PURGEでは使用されず、0 に設定する必要があります。
lua_message_type
SLI_PURGEでは使用されず、0 に設定する必要があります。
lua_flag2
返されたパラメーター。 LUA によって返されるメッセージのフラグが含まれます。
lua_flag2.async
LUA インターフェイス動詞が 1 に設定されている場合に非同期的に完了したことを示します。
lua_resv56
予約済み で、0 に設定する必要があります。
lua_encr_decr_option
SLI_PURGEでは使用されず、0 に設定する必要があります。
リターン コード
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_RESERVED_FIELD_NOT_ZERO
セカンダリ リターン コード。発行した動詞の予約パラメーターが 0 に設定されていません。
LUA_INVALID_POST_HANDLE
セカンダリ リターン コード。非同期投稿方法としてイベントを使用する Microsoft Windows オペレーティング システムの場合、Windows LUA VCB には有効なイベント ハンドルが含まれていません。
LUA_VERB_LENGTH_INVALID
セカンダリ リターン コード。LUA によって予期しない lua_verb_length の値を持つ LUA 動詞が発行されました。
LUA_STATE_CHECK
プライマリ リターン コード。動詞は無効な状態で発行されたため、実行されませんでした。
LUA_NO_SLI_SESSION
セカンダリ リターン コード。コマンドの発行時に SLI_CLOSE またはセッションエラーが発生したため、セッションが開かられなかったか、または停止しました。
LUA_NO_RECEIVE_TO_PURGE
セカンダリ リターン コード。 SLI_PURGE を発行したときに未処理の SLI_RECEIVEはありません。 次の 2 つの状況のいずれかが原因で問題が発生しました。
SLI_RECEIVE処理が 完了 SLI_PURGE 前に完了します。 エラー状態ではないので、この問題を処理するようにアプリケーションを変更できます。
lua_data_ptr パラメーターが、消去するSLI_RECEIVEを正しく指していません。
LUA_SLI_PURGE_PENDING
セカンダリ リターン コード。別の SLI_PURGE が発行されたときに、 SLI_PURGE がまだアクティブでした。 一度 に アクティブにできるSLI_PURGEは 1 つだけです。
LUA_SESSION_FAILURE
プライマリ リターン コード。セカンダリ リターン コードで指定されたエラー条件によって、セッションが失敗しました。LUA_RECEIVED_UNBIND
セカンダリ リターン コード。プライマリ論理ユニット (PLU) は、セッションがアクティブな場合に SNA UNBIND コマンドを LUA インターフェイスに送信しました。 その結果、セッションは停止しました。
LUA_LU_COMPONENT_DISCONNECTED
セカンダリ リターン コード。LU コンポーネントが正しく接続されていないため、使用できません。 電源がオンになっていることを確認します。
LUA_UNSUCCESSFUL
プライマリ リターン コード。指定された動詞レコードは有効でしたが、動詞が正常に完了しませんでした。LUA_VERB_RECORD_SPANS_SEGMENTS
セカンダリ リターン コード。LUA VCB 長さパラメータとセグメント オフセットがセグメント終端を超えています。
LUA_NOT_ACTIVE
セカンダリ リターン コード。LUA 動詞が発行されたときに、LUA が Microsoft Host Integration Server または SNA Server 内でアクティブでなかった。
LUA_NOT_READY
セカンダリ リターン コード。次のいずれかの原因で、SLI セッションが一時的に中断されました。
SNA UNBIND タイプ0x02コマンドが受信されました。これは、新しい BIND が着信中であることを示します。 開始SLI_OPENが完了した後に UNBIND タイプ0x02を受信した場合、BIND、オプションの CRV および STSN、および SDT フローが受信されるまでセッションは中断されます。 これらのルーチンは、再度呼び出す必要があるため、再入可能です。 SLI が SDT コマンドを処理した後、セッションが再開されます。 SLI_OPENの処理中に UNBIND 型0x02を受信した場合、1 次戻りコードはLUA_STATUSではなくSESSION_FAILUREされます。
SNA CLEAR を受信すると、中断が発生しました。 SNA SDT を受信すると、セッションが再開されます。
LUA_INVALID_PROCESS
セカンダリ リターン コード。別の OS/2 プロセスがセッションを所有しているため、要求ユニット・インターフェース (RUI) 動詞が発行されたセッションは使用不可です。
LUA_LU_INOPERATIVE
セカンダリ リターン コード。RUI がセッションの停止を試みている間に重大なエラーが発生しました。 この LU は、アクティブ化論理ユニット (ACTLU) がホストから受信されるまで、LUA 要求では使用できません。
LUA_CANCELED
プライマリ リターン コード。2 次戻りコードは、 コマンドを取り消す理由を提供します。LUA_TERMINATED
セカンダリ リターン コード。動詞が保留中のときにセッションが終了しました。 動詞プロセスが取り消されました。
LUA_IN_PROGRESS
プライマリ リターン コード。非同期コマンドが受信されましたが、完了していません。LUA_COMM_SUBSYSTEM_ABENDED
プライマリ リターン コード。次のいずれかの条件を示します。このメッセージ交換で使用されているノードで、ABEND が発生しました。
トランザクション・プログラム (TP) と物理装置 (PU) 2.1 ノードの間の接続が切断されました (LAN エラー)。
TPs コンピューターの SnaBase で、ABEND が発生しました。
LUA_COMM_SUBSYSTEM_NOT_LOADED
プライマリ リターン コード。動詞の処理中に、必要なコンポーネントを読み込めなかったか、終了できませんでした。 そのため、通信を行うことができませんでした。 是正措置については、システム管理者に問い合わせてください。LUA_INVALID_VERB_SEGMENT
プライマリ リターン コード。VCB がデータ セグメントの終わりを越えています。LUA_UNEXPECTED_DOS_ERROR
プライマリ リターン コード。オペレーティング システム呼び出しを発行した後、予期しないオペレーティング システムのリターン コードが受信され、セカンダリ リターン コードで指定されます。LUA_STACK_TOO_SMALL
プライマリ リターン コード。アプリケーションのスタック サイズが小さすぎて動詞を実行できません。 アプリケーションのスタック サイズを増やしてください。LUA_INVALID_VERB
プライマリ リターン コード。動詞コードまたは操作コード、またはその両方が無効です。 動詞が実行されませんでした。
注釈
SLI_PURGE は、待機条件 でSLI_RECEIVE コマンドを取り消します。
通常、SLI_PURGEは、SLI_RECEIVEの完了に時間がかかりすぎる場合に発行されます。 SLI_RECEIVEを取り消すには、lua_data_ptrが取り消すSLI_RECEIVE VCB を指す必要があります。 SLI_PURGEがSLI_RECEIVEの取り消しに成功すると、SLI_RECEIVEの主なリターン コードは LUA_CANCELED に設定されます。