RUI_TERM
RUI_TERM動詞は、特定の LUA LU の論理ユニット (LU) セッションとシステム サービス制御ポイント (SSCP) セッションの両方を終了します。
次の構造体は、 RUI_TERM によって使用される動詞制御ブロック (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
指定されたパラメーター。 要求ユニット インターフェイス (RUI) 動詞のLUA_VERB_RUI動詞コードが含まれています。
lua_verb_length
指定されたパラメーター。 論理ユニット アプリケーション (LUA) VCB の長さをバイト単位で指定します。 これには、発行される動詞レコードの長さが含まれている必要があります。
lua_prim_rc
動詞の完了時に LUA によって設定されたプライマリ リターン コード。 有効な戻りコードは、発行される LUA 動詞によって異なります。
lua_sec_rc
動詞の完了時に LUA によって設定されたセカンダリ リターン コード。 有効な戻りコードは、発行される LUA 動詞によって異なります。
lua_opcode
指定されたパラメーター。 発行される動詞の LUA コマンド コード (動詞操作コード) が含LUA_OPCODE_RUI_TERM。
lua_correlator
指定されたパラメーター。 動詞を他のユーザー指定の情報とリンクするユーザー指定の値が含まれます。 LUA では、この情報は使用または変更されません。 このパラメーターは省略可能です。
lua_luname
指定されたパラメーター。 Windows LUA セッションで使用されるローカル LU の ASCII 名を指定します。
RUI_TERMは 、lua_sidが 0 の場合にのみ、このパラメーター を 必要とします。
このパラメーターの長さは 8 バイトで、名前が 8 文字より短い場合は、右側にスペース (0x20) が埋め込まれます。
lua_extension_list_offset
Microsoft® Host Integration Server の RUI では使用されず、ゼロに設定する必要があります。
lua_cobol_offset
ホスト統合サーバーの LUA では使用されず、0 に設定する必要があります。
lua_sid
指定されたパラメーターと返されるパラメーター。 セッション識別子を指定し、 SLI_OPEN と RUI_INITによって返されます。 他の動詞では、このパラメーターを使用して、 コマンドに使用されるセッションを識別します。 他の動詞で lua_luname パラメーターを使用してセッションを識別する場合は、 lua_sid パラメーターを 0 に設定します。
lua_max_length
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_data_length
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_data_ptr
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_post_handle
指定されたパラメーター。 イベントによって非同期通知を実行する場合は、Microsoft Windows Server で使用されます。 この変数には、通知されるイベントのハンドルまたはウィンドウ ハンドルが含まれます。
lua_th
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_rh
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_flag1
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_message_type
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_flag2
RUI_TERMでは使用されず、0 に設定する必要があります。
lua_resv56
予約済み で、0 に設定する必要があります。
lua_encr_decr_option
予約済み で、0 に設定する必要があります。
リターン コード
LUA_OK
プライマリ リターン コード。動詞は正常に実行されました。
LUA_PARAMETER_CHECK
プライマリ リターン コード。パラメーター エラーのため、動詞は実行されませんでした。
LUA_BAD_SESSION_ID
セカンダリ リターン コード。VCB でlua_sid の無効な値が指定されました。
LUA_INVALID_POST_HANDLE
セカンダリ リターン コード。非同期投稿方法としてイベントを使用する Windows オペレーティング システムの場合、Windows LUA VCB には有効なイベント ハンドルが含まれていません。
LUA_RESERVED_FIELD_NOT_ZERO
セカンダリ リターン コード。動詞レコードの予約フィールド、またはこの動詞で使用されていないパラメーターが 0 以外の値に設定されました。
LUA_VERB_LENGTH_INVALID
セカンダリ リターン コード。LUA 動詞が LUA によって予期しない値 lua_verb_length 発行されました。
LUA_STATE_CHECK
プライマリ リターン コード。動詞は無効な状態で発行されたため、実行されませんでした。
LUA_NO_RUI_SESSION
セカンダリ リターン コード。 RUI_TERMで 指定された LU 名に対して、 RUI_INITがまだ正常に完了していません。
LUA_UNSUCCESSFUL
プライマリ リターン コード。指定された動詞レコードは有効でしたが、動詞が正常に完了しませんでした。
LUA_COMMAND_COUNT_ERROR
セカンダリ リターン コード。 動詞が発行されたときに、RUI_TERM は既に保留中でした。
LUA_INVALID_PROCESS
セカンダリ リターン コード。この動詞を発行した OS/2 プロセスは、このセッション に対してRUI_INIT を発行したのと同じプロセスではありません。 セッションを開始したプロセスのみが、そのセッションで動詞を発行できます。
LUA_COMM_SUBSYSTEM_ABENDED
プライマリ リターン コード。次のいずれかの条件を示します。
このメッセージ交換で使用されているノードで、ABEND が発生しました。
トランザクション・プログラム (TP) と物理装置 (PU) 2.1 ノードの間の接続が切断されました (LAN エラー)。
TPs コンピューターの SnaBase で、ABEND が発生しました。
LUA_SESSION_FAILURE
プライマリ リターン コード。必要な Host Integration Server コンポーネントが終了しました。LUA_LU_COMPONENT_DISCONNECTED
セカンダリ リターン コード。は、リンク サービスまたはホスト LU に問題があるため、LUA セッションが失敗したことを示します。
LUA_RUI_LOGIC_ERROR
セカンダリ リターン コード。LUA 内で内部エラーが検出されました。 このエラーは、通常の操作中には発生しません。
LUA_INVALID_VERB
プライマリ リターン コード。動詞コードまたは操作コード、またはその両方が無効です。 動詞が実行されませんでした。LUA_STACK_TOO_SMALL
プライマリ リターン コード。アプリケーションのスタック サイズが小さすぎて動詞を実行できません。 アプリケーションのスタック サイズを増やしてください。LUA_COMM_SUBSYSTEM_NOT_LOADED
プライマリ リターン コード。必要なコンポーネントを読み込めなかったか、動詞の処理中に終了しました。 そのため、通信を行うことができませんでした。 是正措置については、システム管理者に問い合わせてください。LUA_UNEXPECTED_DOS_ERROR
プライマリ リターン コード。オペレーティング システム呼び出しを発行した後、予期しないオペレーティング システムのリターン コードが受信され、セカンダリ リターン コードで指定されます。
注釈
この動詞は、 RUI_INIT が発行された後 (完了したかどうかにかかわらず) いつでも発行できます。 RUI_TERMが発行されたときに他の LUA 動詞が保留中の場合、保留中の動詞に対するそれ以上の処理は行われず、LUA_CANCELEDのプライマリ リターン コードを使用して が返されます。
この動詞が完了すると、このセッションに対して他の LUA 動詞を発行することはできません。