次に示すのは、Connector 関連のエラーメッセージです。
&H3001-- 12289 LCFAIL_UNAVAILABLE -- Requested functionality is not available
サポートされていない機能が要求されました。このエラーは、使用している Connector が特定のオペレーションをサポートしていない場合 (例えば Create メソッドをサポートしていないものがあります) や、LC API メソッドが特定の要求をサポートしていない場合などに発生します (問題と思われるメソッドのドキュメントを参照してください)。
&H3002 -- 12290 LCFAIL_END_OF_DATA -- The last data value has been retrieved
使用可能なデータ値のリストから最後の要素が取り出されました。これは、複数のデータ値に対して反復処理を実行するために呼び出されたオペレーション (LCConnection.Fetch、LCConnect.ListProperty、LCFieldlist.List など) からの正常な戻り値です。致命的なエラーを表すものではなく、通常は正常なオペレーションフローの一部です。
&H3003 -- 12291 LCFAIL_INVALID_INDEX -- Cannot locate list element
複数値を持つオブジェクトに対する要求で指定されたインデックスが正しくありません。一般に、リストのエンティティ (フィールドリストのフィールドやテキストリストのテキストエントリなど) にアクセスするときに指定したインデックスがそのオブジェクトで有効なインデックスの最大値より大きい場合に、このエラーが発生します。インデックスはすべて 1 から始まります。したがって、3 つの要素を持つオブジェクトでは、有効なインデックス値は、1、2、および 3 です。
&H3004 -- 12292 LCFAIL_INVALID_LIST -- Invalid List direction
複数の値に対して反復処理を実行するメソッドを使用するとき、LCLIST パラメータによってリスト処理の方法 (最初から開始、次のエントリを返す、など) を指定します。指定したリスト処理方向が正しくないか、指定した方向が有効でも現在のコンテキストではサポートされていないかのいずれかです。
&H3005 -- 12293 LCFAIL_INVALID_CONVERT -- Invalid conversion
サポートされていないデータ変換を実行しようとしました。変換は、同じデータ型の「クラス」(数値、ストリーム、および日時) に属するメンバ間またはテキストとの間で実行できます。変換元と変換先のデータ型クラスが異なり、どちらもテキストでない場合 (例えば日時と通貨の間の変換など) に、このエラーが発生します。また、一般に、バイナリストリーム形式との間の変換は、変換元または変換先のいずれかの型がテキストまたはバイナリ BLOB 形式の場合にのみ実行できます。
&H3006 -- 12294 LCFAIL_INVALID_TEXT_LIST -- This operation requires a valid text list
テキストリストストリーム (LCSTREAMFMT_TEXT_LIST 形式のバイナリストリーム) を操作するアクションに対して、異なる形式または無効な構造のストリームが指定されました。ストリームデータが正しい形式のテキストリストであることを確認してください。
&H3007 -- 12295 LCFAIL_INVALID_NUMBER_LIST -- This operation requires a valid number list
数値リストストリーム (LCSTREAMFMT_NUMBER_LIST 形式のバイナリストリーム) を操作するアクションに対して、異なる形式または無効な構造のストリームが指定されました。ストリームデータが正しい形式の数値リストであることを確認してください。
&H3008 -- 12296 LCFAIL_INVALID_DATETIME_LIST -- This operation requires a valid datetime list
日時リストストリーム (LCSTREAMFMT_DATETIME_LIST 形式のバイナリストリーム) を操作するアクションに対して、異なる形式または無効な構造のストリームが指定されました。ストリームデータが正しい形式の日時リストであることを確認してください。
&H3009 -- 12297 LCFAIL_ZERO_INDEX -- All index values are one-based -- an index of zero is not valid
複数値を持つオブジェクトに対する要求で指定されたインデックスが 0 です。インデックス参照をサポートするすべてのオブジェクトおよびメソッド (フィールドリストやテキストリストなど) では、1 から始まるインデックスを使用します。0 は有効なインデックス値ではありません。
&H300A -- 12298 LCFAIL_ZERO_COUNT -- This operation requires a non-zero count
カウントを示すパラメータの値として 0 が指定されましたが、ここでは 0 は無効です。カウントとして 0 が有効なのは特定の場合に限られます。詳しくは、メソッドのドキュメントを確認してください。
&H300B -- 12299 LCFAIL_ZERO_OFFSET -- All offset values are one-based -- an offset of zero is not valid.
複数値オブジェクトに対する要求で指定されたオフセットが 0 です。オフセットパラメータをサポートするすべてのメソッド (LCStream.Merge など) では、1 から始まるオフセットを使用します。0 は有効なオフセット値ではありません。
&H300C -- 12300 LCFAIL_ZERO_FORMAT -- This operation requires a non-zero Stream Format
ストリーム形式を示すパラメータの値として 0 が指定されましたが、ここでは 0 は無効です。ストリーム形式として 0 が有効なのは特定の場合に限られます。詳しくは、メソッドのドキュメントを確認してください。有効なストリーム形式の一覧は、ドキュメントに記載されています。
&H300D -- 12301 LCFAIL_NULL_BUFFER -- A NULL buffer was provided when one was required
バッファパラメータを必要とするメソッドで、有効なバッファが必要にも関わらず値が指定されていません。詳しくは、メソッドのドキュメントを確認してください。
&H300E -- 12302 LCFAIL_NULL_RESULT -- A return parameter is required, but none was provided
出力パラメータを必要とするメソッドで、有効なパラメータが必要にも関わらず値が指定されていません。詳しくは、メソッドのドキュメントを確認してください。
&H300F -- 12303 LCFAIL_FIXED_LENGTH -- A fixed-length stream requires a non-zero length
固定長のストリームを要求する場合 (ストリームフラグ LCSTREAMF_FIXED を使用) は、LCStream.Create で最大長プロパティに 0 以外の値を指定する必要があります。
&H3010 -- 12304 LCFAIL_INVALID_FLAGS -- The supplied flags are invalid, possibly due to a conflict
オペレーションに対して指定されたビット単位のフラグが無効です。無効なフラグが指定されているか、フラグ間の矛盾があります。有効なフラグの詳細については、オブジェクトまたはメソッドのドキュメントを確認してください。
&H3011 -- 12305 LCFAIL_TEXT_TRANSLATE -- Text translation failure
キャラクタセット間の変換に失敗しました。原因として、キャラクタセットインジケータが正しくないか、ソーステキスト内のデータが無効なことが考えられます。問題が解消されない場合は、テクニカルサポートに連絡してください。
&H3012 -- 12306 LCFAIL_NULL_FIELDNAME -- A NULL field name was provided
有効なフィールド名が必要ですが、NULL または空のフィールド名が指定されました。1 文字以上のフィールド名が指定されていることを確認します。詳しくは、メソッドのドキュメントを確認してください。
&H3013 -- 12307 LCFAIL_INVALID_FIELDLIST -- Invalid fieldlist
LCFIELDLIST オブジェクトのハンドルが有効なハンドルでないか、0 です。オブジェクトハンドルは、新しいフィールドリストを作成するメソッドから返された有効な値でなければなりません。オブジェクトを解放すると、ハンドルは無効になります。
&H3014 -- 12308 LCFAIL_INVALID_CONNECTION -- Invalid connection
LCCONNECTION オブジェクトのハンドルが有効なハンドルでないか、0 です。オブジェクトハンドルは、新しいコネクションを作成するメソッドから返された有効な値でなければなりません。オブジェクトを解放すると、ハンドルは無効になります。
&H3015 -- 12309 LCFAIL_EMPTY_FIELDLIST -- This operation cannot be performed on a fieldlist with no fields
このコンテキストでは、フィールドが 1 つも含まれていないフィールドリストは無効です。このエラーを回避するには、フィールドリストにフィールドが追加されていることを確認します。詳しくは、メソッドのドキュメントを確認してください。
&H3016 -- 12310 LCFAIL_NAME_FIELDLIST -- This operation cannot be performed on a name-only fieldlist
レコードカウント 0 で作成されたフィールドリストは、このコンテキストでは無効です。このようなフィールドリストは名前のマッピングに使用するもので、データ値を保持することはできません。そのため、フィールドリストのデータの読み込みや書き込みを行う状況では使用できません。このエラーを回避するには、フィールドリストの作成時にレコードカウントとして 0 以外を指定します。
&H3017 -- 12311 LCFAIL_NATIVE_OVERRIDE -- Native text format override supplied is not a valid stream format indicator
ドキュメントに記載されているように、ネイティブキャラクタセットに優先する設定が .INI の変数で指定されました。指定されたキャラクタセットは、有効なキャラクタセット識別子ではありません。有効なキャラクタセット文字列の一覧については、ドキュメントを確認してください。
&H3018 -- 12312 LCFAIL_RECORD_INDEX -- An invalid fieldlist record index was encountered
フィールドリストのレコードインデックスが、このフィールドリストでは無効です。一般に、このエラーは、フィールドリストとレコードインデックスを受け取る LCConnection クラスのメソッドで発生します。インデックスの最小値は 1 です (インデックスはすべて 1 から始まります)。また、フィールドリストの作成時に指定されたレコード数を超えることはできません。
&H3019 -- 12313 LCFAIL_RECORD_COUNT -- Request to transfer more records than allocated in fieldlist
フィールドリストのレコードカウントが、このフィールドリストでは無効です。一般に、このエラーは、フィールドリストとレコードカウントを受け取る LCConnection クラスのメソッドで発生します。レコードカウントにレコードインデックスを加えた値が、フィールドリストの作成時に指定されたレコード数を超えてはなりません。また、レコードカウントに 0 を指定できるのは、特定の状況に限られます。詳しくは、メソッドのドキュメントを参照してください。
&H301A -- 12314 LCFAIL_LIST_SETUP -- Fieldlist iteration requires initial setup
LCFieldlist.List を使用してフィールドリスト内にフィールドリストを作成するには、まず LCFieldlist.ListSetup を呼び出して反復処理の準備を行う必要があります。
&H301B -- 12315 LCFAIL_NO_MERGE_DATA -- The data fieldlist in a merge cannot be a name-only fieldlist
メソッド LCFieldlist.Merge または MergeVirtual を使用する場合は、名前のみのフィールドリストをデータフィールドリストとして指定することはできません。データフィールドリストを作成するときは、レコードカウントに 0 以外を指定する必要があります。
&H301C -- 12316 LCFAIL_NO_RESULTSET -- This operation requires an active result set
要求された LCConnection オペレーションを実行するには、コネクションにアクティブな結果セットがなければなりません。このオペレーションを実行する前に結果セットを作成してください。一般に、結果セットを作成するメソッド (Execute、Select、Call、Catalog など) を呼び出す前に LCConnection.Fetch を呼び出すと、このエラーが発生します。
&H301D -- 12317 LCFAIL_NO_WRITEBACK -- This operation requires an active writeback result set
要求された LCConnection オペレーションを実行するには、コネクションにアクティブなライトバックの結果セットがなければなりません。このオペレーションを実行する前に、ライトバック可能な結果セットを作成してください。一般に、ライトバックの結果セットを作成するメソッド (「Writeback」プロパティを指定した Execute や Select など) を呼び出す前に、「Writeback」プロパティを指定して LCConnection.Update または Remove を呼び出すと、このエラーが発生します。Writeback プロパティを指定せずに結果セットを作成した場合は、その結果セットに対してライトバックオペレーションを実行することはできません。
&H301E -- 12318 LCFAIL_WRITEBACK_COUNT -- Writeback operation record counts must be one
LCConnection に対してライトバックオペレーションを要求するときは、最後に取り出されたレコードのみが対象となるため、レコードカウントは 1 でなければなりません。
&H301F -- 12319 LCFAIL_TRANSLATE_INIT -- Text translation subsystem initialization failure
内部キャラクタセット変換サブシステムが初期化に失敗しました。このエラーは、一般に、環境が適切にインストールされていない場合に発生します。インストールとプラットフォーム固有の注意事項について、ドキュメントで確認してください。問題が解消されない場合は、テクニカルサポートに連絡してください。
&H3020 -- 12320 LCFAIL_TIMEBOMB -- This time-limited version has expired [as of DATE]
これは、表示された日まで有効な期間限定版です。有効期間が残っている新しいバージョンまたは完全なバージョンを IBM® から入手してください。
&H3021 -- 12321 LCFAIL_SESSION_NOT_INIT -- The Connector Session must be initialized before performing any operation
Connector Session クラスを初期化してからでなければ、他の LC オブジェクトを作成したり、メソッドを使用したりすることはできません。
&H3022 -- 12322 LCFAIL_CONNECTOR_VERSION -- Incorrect Connector version
互換性のないバージョンの Connector Toolkit で Connector が作成されています。 または Connector の開発元に連絡して、新しいバージョンを入手してください。
&H3023 -- 12323 LCFAIL_NOT_CONNECTED -- This operation requires a connection to a connector
呼び出された LCConnection メソッドは、接続されていない LCConnection に対しては使用できません。このオペレーションの前に Connect メソッドを呼び出してください。一般に、結果セットを作成するオペレーションや、データまたはメタデータを操作するオペレーションは、接続前に呼び出すことはできません。接続する前は、プロパティの取得と設定だけが可能です。ただし、一部の Connector では、例外として接続の前であってもサーバーまたはデータベースカタログの結果セットの作成および取り出しが可能な場合があります。
&H3024 -- 12324 LCFAIL_CONNECTED -- This operation cannot be performed when there is a valid connection to a connector
実行された LCConnection オペレーションは、LCConnection がアクティブに接続されている場合は無効です。まず Disconnect メソッドを呼び出す必要があります。このエラーは、データベースに対する Drop メソッドなど、コネクションそのものに影響するアクションを実行した場合に発生する可能性があります。
&H3025 -- 12325 LCFAIL_EXTERNAL -- <外部エラーテキスト>
Connector によってアクセスした外部データベースまたはアプリケーションでエラーが発生しました。外部エラーのテキストとコードは、メソッド LCSession.GetStatus を使用して取得できます。
&H3026 -- 12326 LCFAIL_ACTIVE_SUBCONNECTOR -- The subconnector of a metaconnector can only be set once
Metaconnector のサブコネクタプロパティは、一度だけ設定できます。このプロパティを再設定しようとすると、このエラーが発生します。
&H3027 -- 12327 LCFAIL_TRANSLATE_TABLE -- No translation tables are available for the character set
サポートされているキャラクタセットのほとんどは、変換テーブルを使用して他のキャラクタセットに変換できます。このエラーは、特定のキャラクタセットまたはキャラクタセットの組み合わせに使用できる変換テーブルがなく、キャラクタセットの変換を実行できないことを意味します。多くの場合、類似のキャラクタセットを使用して同様の有効な変換結果を得ることができます。
&H3028 -- 12328 LCFAIL_NO_SCROLL -- This operation requires an active scrollable result set
LCConnection.Fetch メソッドで負のレコードカウントを指定できるのは、スクロール可能な結果セットを Connector がサポートしており、アクティブな結果セットの作成時に「Scrolling」プロパティが指定された場合に限られます。このエラーは、これらの条件のいずれかが満たされていない状況で、Fetch メソッドに負のレコードカウントを指定した場合に発生します。
&H3029 -- 12322 LCFAIL_BINARY_FORMAT -- This operation requires a non-binary Stream Format
LCStream の一部のメソッドは、フォーマット済みのバイナリストリーム形式に対しては無効です。このメソッドには、テキスト形式のストリームまたは未フォーマットの BLOB バイナリ形式を使用する必要があります。詳しくは、メソッドのドキュメントを確認してください。
&H302A -- 12330 LCFAIL_ASYNC_ACTIVE -- Asynchronous operation is still active
このエラーは、非同期処理の完了を待つメソッドで発生します。非同期処理がまだアクティブである間に指定の待機期間が経過すると、このエラーが返されます。