次のデータ構造は、すべての Microsoft® Windows® 論理ユニット アプリケーション (LUA) 動詞に共通するパラメーターを示しています。
構文
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_COMMON;
解説
メンバー
lua_verb
指定されたパラメーター。 要求ユニット インターフェイス (RUI) 動詞のLUA_VERB_RUI動詞コード、または SLI 動詞のLUA_VERB_SLIが含まれます。 これらの両方のマクロの場合、値は0x5200。
lua_verb_length
指定されたパラメーター。 LUA VCB の長さをバイト単位で指定します。 これには、発行される動詞レコードの長さが含まれている必要があります。
lua_prim_rc
動詞の完了時に LUA によって設定されたプライマリ リターン コード。 有効な戻りコードは、発行される LUA 動詞によって異なります。
lua_sec_rc
動詞の完了時に LUA によって設定されたセカンダリ リターン コード。 有効な戻りコードは、発行される LUA 動詞によって異なります。
lua_opcode
指定されたパラメーター。 RUI_BID動詞のLUA_OPCODE_RUI_BIDなど、発行される動詞の LUA コマンド コード (動詞操作 コード) が含まれます。 有効な値は次のとおりです。
LUA_OPCODE_SLI_OPEN
LUA_OPCODE_SLI_CLOSE
LUA_OPCODE_SLI_RECEIVE
LUA_OPCODE_SLI_SEND
LUA_OPCODE_SLI_PURGE
LUA_OPCODE_SLI_BID
LUA_OPCODE_SLI_BIND_ROUTINE
LUA_OPCODE_SLI_STSN_ROUTINE
LUA_OPCODE_SLI_CRV_ROUTINE
LUA_OPCODE_RUI_INIT
LUA_OPCODE_RUI_TERM
LUA_OPCODE_RUI_READ
LUA_OPCODE_RUI_WRITE
LUA_OPCODE_RUI_PURGE
LUA_OPCODE_RUI_BID
lua_correlator
指定されたパラメーター。 動詞を他のユーザー指定の情報とリンクするユーザー指定の値が含まれます。 LUA では、この情報は使用または変更されません。 このパラメーターは省略可能です。
lua_luname
指定されたパラメーター。 Windows LUA セッションで使用されるローカル LU の ASCII 名を指定します。
SLI_OPEN と RUI_INIT には、このパラメーターが必要です。 他の Windows LUA 動詞では、 lua_sid が 0 の場合にのみこのパラメーターが必要です。
このパラメーターの長さは 8 バイトで、名前が 8 文字より短い場合は、右側にスペース (0x20) が埋め込まれます。
lua_extension_list_offset
VCB の先頭からユーザー指定のダイナミック リンク ライブラリ (DLL) の拡張リストへのオフセットを指定します。 このパラメーターは、Microsoft® Host Integration Server の RUI では使用されないため、ゼロに設定する必要があります。 拡張リストがない限り、値は単語の境界の先頭である必要があります。
lua_cobol_offset
COBOL 拡張機能のオフセット。 ホスト統合サーバーの LUA では使用されず、ゼロにする必要があります。
lua_sid
指定されたパラメーターと返されるパラメーター。 セッション識別子を指定し、 SLI_OPEN と RUI_INITによって返されます。 他の動詞では、このパラメーターを使用して、 コマンドに使用されるセッションを識別します。 他の動詞で lua_luname パラメーターを使用してセッションを識別する場合は、 lua_sid パラメーターを 0 に設定します。
lua_max_length
RUI_READとSLI_RECEIVEの受信バッファーの長さを指定します。 その他の RUI および SLI 動詞の場合は、この動詞は使用されず、ゼロに設定する必要があります。
lua_data_length
送受信されるデータの長さを指定します。
RUI_BID動詞のlua_peek_dataで返されるデータの長さを指定します。
lua_data_ptr
アプリケーション提供のバッファーへのポインター。
SLI_RECEIVEまたはRUI_READが発行されると、このパラメーターはホストからデータを受信する場所を指します。
SLI_SENDまたはRUI_WRITEが発行されると、このパラメーターは、ホストに送信されるアプリケーションのデータの場所を指します。
SLI_PURGEまたはRUI_PURGEが発行されると、このパラメーターは、取り消されるSLI_RECEIVEまたはRUI_READ動詞の VCB の場所を指します。
SLI_OPENが発行されると、このパラメーターは次のいずれかになります。
初期化の種類が未フォーマットのログオン メッセージを含むセカンダリである場合の SSCP 標準フローのログオン メッセージ。
INITSELF の要求/応答ユニット (RU)。 初期化の種類が INITSELF でセカンダリである場合、アプリケーションに必要なデータが提供されます。
他のすべての開いている型の場合、このフィールドは 0 に設定する必要があります。
他の RUI およびセッション レベル インターフェイス (SLI) 動詞の場合、このパラメーターは使用されず、0 に設定する必要があります。 SNA コマンドとデータはどちらもこのバッファーに入れられ、EBCDIC 形式にすることができます。
この情報は、Windows LUA アプリケーションによって提供されます。
lua_post_handle
指定されたパラメーター。 イベントによって非同期通知を実行する場合は、Windows で使用されます。 この変数には、通知されるイベントのハンドルまたはウィンドウ ハンドルが含まれます。lua_th
返されたパラメーター。 送受信されたメッセージの SNA 伝送ヘッダー (TH) が含まれます。 書き込み関数にはさまざまなサブパラメーターが設定され、読み取り関数と入札関数に対して返されます。 サブパラメーターは次のとおりです。lua_th.flags_fid
形式識別タイプ 2、4 ビット。
lua_th.flags_mpf
セグメントマッピングフィールド、2ビット。 データ セグメントの種類を定義します。 有効な値は、次のとおりです。
0x00 中間セグメント
最後のセグメント0x01
0x02 First セグメント
0x03 セグメントのみ
lua_th.flags_odai
発信元アドレス・フィールド・宛先アドレス・フィールド (OAF–DAF) アロケーター標識 (1 ビット)。
lua_th.flags_efi
迅速なフロー インジケーター、1 ビット。
lua_th.daf
宛先アドレス フィールド (DAF)、符号なし文字。
lua_th.oaf
発信元アドレス フィールド (OAF)、符号なし文字。
lua_th.snf
シーケンス番号フィールド。符号なし char[2]。
lua_rh
返されたパラメーター。 送受信されるメッセージの SNA 要求/応答ヘッダー (RH) が含まれます。 書き込み関数用に設定され、読み取り関数と入札関数によって返されます。 そのサブ パラメーターは次のとおりです。
lua_rh.rri
要求応答インジケーター、1 ビット。
lua_rh.ruc
RU カテゴリ、2 ビット。 有効な値は、次のとおりです。
LUA_RH_FMD (0x00) FM データ セグメントLUA_RH_NC (0x20) ネットワーク制御LUA_RH_DFC (0x40) データ フロー制御LUA_RH_SC (0x60) セッション制御
lua_rh.fi
書式インジケーター、1 ビット。
lua_rh.sdi
センサー データに含まれるインジケーター、1 ビット。
lua_rh.bci
開始チェーン インジケーター(1 ビット)。
lua_rh.eci
エンド チェーン インジケーター、1 ビット。
lua_rh.dr1i
確定応答 1 インジケーター、1 ビット。
lua_rh.dr2i
確定応答 2 インジケーター、1 ビット。
lua_rh.ri
例外応答インジケーター (要求の場合)、または応答の種類インジケーター (応答の場合)、1 ビット。
lua_rh.qri
キューに入った応答インジケーター(1 ビット)。
lua_rh.pi
ペースインジケーター、1ビット。
lua_rh.bbi
開始角かっこインジケーター(1 ビット)。
lua_rh.ebi
端かっこインジケーター、1 ビット。
lua_rh.cdi
方向インジケーターを 1 ビット変更します。
lua_rh.csi
コード選択インジケーター、1 ビット。
lua_rh.edi
暗号化されたデータ インジケーター(1 ビット)。
lua_rh.pdi
1 ビットの埋め込みデータ インジケーター。
lua_flag1
指定されたパラメーター。 アプリケーションによって提供されるメッセージのフラグを含むデータ構造が含まれます。 このパラメーターは、RUI_BID、RUI_READ、RUI_WRITE、SLI_BID、SLI_RECEIVE、およびSLI_SENDで使用されます。 他の LUA 動詞の場合、このパラメーターは使用されず、0 に設定する必要があります。 そのサブパラメーターは次のとおりです。
lua_flag1.bid_enable
入札単価有効化インジケーター(1 ビット)。
lua_flag1.close_abend
即時インジケーター (1 ビット) を閉じます。
lua_flag1.nowait
データ フラグ (1 ビット) を待機しません。
lua_flag1.sscp_exp
SSCP 優先フロー、1 ビット。
lua_flag1.sscp_norm
SSCP 標準フロー、1 ビット。
lua_flag1.lu_exp
LU 優先フロー、1 ビット。
lua_flag1.lu_norm
LU 標準フロー、1 ビット。
lua_message_type
インバウンドまたはアウトバウンドの SNA コマンドおよびデータのタイプを指定します。 これは、RUI_INITとSLI_OPENの返されるパラメーターと、SLI_SENDに指定されたパラメーターです。 他の LUA 動詞の場合、この変数は使用されず、0 に設定する必要があります。
次のいずれかの値になります。
LUA_MESSAGE_TYPE_LU_DATA
LUA_MESSAGE_TYPE_SSCP_DATA
LUA_MESSAGE_TYPE_BID
LUA_MESSAGE_TYPE_BIND
LUA_MESSAGE_TYPE_BIS
LUA_MESSAGE_TYPE_CANCEL
LUA_MESSAGE_TYPE_CHASE
LUA_MESSAGE_TYPE_CLEAR
LUA_MESSAGE_TYPE_CRV
LUA_MESSAGE_TYPE_LUSTAT_LU
LUA_MESSAGE_TYPE_LUSTAT_SSCP
LUA_MESSAGE_TYPE_QC
LUA_MESSAGE_TYPE_QEC
LUA_MESSAGE_TYPE_RELQ
LUA_MESSAGE_TYPE_RQR
LUA_MESSAGE_TYPE_RTR
LUA_MESSAGE_TYPE_SBI
LUA_MESSAGE_TYPE_SHUTD
LUA_MESSAGE_TYPE_SIGNAL
LUA_MESSAGE_TYPE_SDT
LUA_MESSAGE_TYPE_STSN
LUA_MESSAGE_TYPE_UNBIND
SLI は、LUA インターフェイス拡張ルーチンを介して BIND、CRV、および STSN 要求を受信して応答します。
LU_DATA、LUSTAT_LU、LUSTAT_SSCP、およびSSCP_DATAは SNA コマンドではありません。
lua_flag2
返されたパラメーター。 LUA によって返されるメッセージのフラグが含まれます。 このパラメーターは、 RUI_BID、 RUI_READ、RUI_WRITE、 SLI_BID、 SLI_RECEIVE、 およびSLI_SENDによって返 されます。 他の LUA 動詞の場合、このパラメーターは使用されず、0 に設定する必要があります。 そのサブパラメーターは次のとおりです。
lua_flag2.bid_enable
RUI_BIDが 1 に設定されている場合に正常に再有効化されたことを示します。
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
この指定されたパラメーターは、 SLI_OPEN と RUI_INITによって使用される予約フィールドです。 他のすべての LUA 動詞の場合、このパラメーターは予約されており、0 に設定する必要があります。
lua_encr_decr_option
このパラメーターは、暗号化オプションのフィールドです。
RUI_INITでは、次ののみがサポートされます。
lua_encr_decr_option = 0
lua_encr_decr_option = 128
他のすべての LUA 動詞の場合、このパラメーターは予約されており、0 に設定する必要があります。