WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

メッセージ・セット: グローバル・エレメントの dateTime タイプ用の TDS プロパティー

グローバル・エレメントの dateTime タイプ用の TDS 形式プロパティー。

ここで説明されている TDS 形式のプロパティーは、以下のものに適用されます。

フィールド識別

プロパティー タイプ 意味
タグ ストリング メッセージ・ビット・ストリーム内のオブジェクトを識別するために使用される値を指定します。

オブジェクトが単純であり、そのオブジェクトが子となる複合タイプの「データ・エレメント分離」プロパティーが 「タグ付き区切り」「タグ付き固定長」、または「タグ付きエンコード長」の場合、このプロパティー内には空でない値がなければなりません。

オブジェクトが複合エレメントで、その親の「データ・エレメント分離」プロパティーが「タグ付き区切り」「タグ付き固定長」、または「タグ付きエンコード長」の場合は、プロパティーに空の値を 含めることができます。

このプロパティーの値は、メッセージ・セット内のすべてのエレメントに対して固有でなければなりません。 つまり、メッセージ・セット内にこのプロパティーの値が等しい 2 つのエレメントが存在することはできません。

データ・パターン ストリング オブジェクトに割り当てるメッセージ内のデータを識別するためにパーサーが使用する正規表現を指定します。 このプロパティーは、「データ・エレメント分離 」メソッドが複合タイプの「データ・パターンを使用」に設定されている場合に使用します。 詳細については、メッセージ・セット: 正規表現の構文を参照してください。

物理表現

プロパティー タイプ 意味
物理タイプ 列挙タイプ オブジェクトの物理タイプを選択します。
メッセージ・セットの「メッセージング標準」プロパティーが「ユーザー定義テキスト」「ユーザー定義混合」「CSV」、または「TLOG」の場合、以下の値の 1 つを選択します。
  • テキスト。 データは文字フォーマットです。
  • 長さエンコード・ストリング 1。 データの最初のバイトに、その長さバイトの後に続くデータ・ストリングの長さが (長さ単位で) 含まれます。 「長さエンコード・ストリング 1」エレメントの最大長は、255 長さ単位です。
  • 長さエンコード・ストリング 2。 データの最初の 2 バイトに、その 2 つの長さバイトの後に続くデータ・ストリングの長さが (長さ単位で) 含まれます。 「長さエンコード・ストリング 2」エレメントの最大長は 65535 長さ単位です。
  • ヌル終端ストリング。 データ・ストリングは 16 進ヌル文字 X'00' で終わります。
  • パック 10 進数。 データはパック 10 進数であり、これは COBOL の COMP-3 データ型に相当します。
  • バイナリー。 データはビット・ストリング・フォーマットです。
  • 時刻 (秒)。 この値は C の time_t と、Java™ の Date および Time オブジェクトをサポートします。 これは、「DateTime 形式」プロパティーが数値のみのデータを表している場合にのみ有効です。
  • 時刻 (ミリ秒)。 この値は C の time_t と、Java の Date および Time オブジェクトをサポートします。 これは、「DateTime 形式」プロパティーが数値のみのデータを表している場合にのみ有効です。
デフォルトは、「メッセージング標準」プロパティーに依存します。

他のすべての「メッセージング標準」値で、「物理タイプ」プロパティーが「テキスト」に設定されます。

長さ 整数 予期されるオブジェクトの長さを指定します (長さ単位)。
次のステートメントのいずれかが真であれば、ゼロ以外の長さを指定する必要があります。
  • 「物理タイプ」「パック 10 進数」である。
  • 「物理タイプ」「テキスト」であり、「長さの参照」は指定がなく、親の複合タイプまたはグループの「データ・エレメント分離」「固定長」「タグ付き固定長」、または「固定長 AL3」である。

デフォルトは、オブジェクトの物理タイプに依存します。

「物理タイプ」「長さエンコード・ストリング 1」「長さエンコード・ストリング 2」、または「ヌル終端ストリング」の場合、このプロパティーは適用されません。

「物理タイプ」「時刻 (秒)」の場合、このプロパティーの値は 4 であり、変更できません。

「物理タイプ」「時刻 (ミリ秒)」の場合、このプロパティーの値は 8 であり、変更できません。

長さ単位 列挙タイプ オブジェクトの長さの単位を選択します。
以下のどちらか 1 つのオプションを選択します (物理タイプによっては、両方のオプションは提供されていません)。
  • 「バイト」。 長さはバイト単位です。
  • 「文字」。 長さは文字単位です。 ビット・ストリームで処理されるバイト数は、メッセージのコード・ページによって異なります。
    • latin-1 (CCSID 850) などの 1 バイト・コード・ページ (SBCS CCSID) の場合、バイト数は文字数と等しくなります。
    • UTF-16 (CCSID 1200) などの 2 バイト・コード・ページ (DBCS CCSID) の場合、バイト数は文字数のちょうど倍になります。
    • UTF-8 (CCSID 1208) などのマルチバイト・コード・ページ (MBCS CCSID) の場合、バイト数はビット・ストリームによって異なります。 パーサーは一度に 1 文字を読み取って、文字が 1 バイト以上で構成されているかどうかを判別します。

デフォルトは、オブジェクトの物理タイプに依存します。

位置調整 列挙タイプ

書き込み中または構文解析中のデータが固定長値よりも小さい場合の、オブジェクトの位置調整を指定します。 このプロパティーが使用されるのは、値が固定長ストリングとして書き込まれる場合だけです。

リストから以下のいずれかの値を選択します。

  • 適用外
  • 左寄せ
  • 右寄せ
埋め込み文字 ストリング データが固定長の値より短い場合に、固定長オブジェクトの書き込みまたは解析で挿入または 解釈される埋め込み文字を指定します。 このプロパティーが使用されるのは、値が固定長ストリングとして書き込まれる場合だけです。

この文字は、以下のいずれかの方法によって指定できます。

  • ドロップダウン・リストから NUL'0'、または SPACE を選択します。
  • 引用符で囲われた英数字、例えば "c" または 'c' (c は任意の英数字) を入力します。
  • 16 進文字コードを、0xYY (YY は 16 進値) の形式で入力します。
  • ユニコード値を U+xxxx (xxxx は 16 進数で指定されたユニコード値) の形式で指定します。 入力できるストリングの最大長は 10 です。

MRM エレメントにどの埋め込み文字形式を使用するかの選択は、どの埋め込み文字が必要か、 また埋め込み文字がデータ変換されるかどうかに応じて異なります。

ほとんどの場合、埋め込み文字を指定するだけで十分であり、その埋め込み文字が使用されるとき、生成される MRM 出力メッセージのターゲット・コード・ページに変換されます。

埋め込み文字フィールドに簡単に入力できない埋め込み文字が必要とされる場合、Unicode ニーモニック形式を使用して必要な文字を指定することができます。 使用する場合、この Unicode 値もまた、生成される MRM メッセージのターゲット・コード・ページに変換されます。

データ変換されない埋め込み文字が必要な場合、16 進数形式を使用できます。 これによって、出力メッセージに直接挿入される埋め込み文字を指定できます。 この形式を使用する場合には、16 進値が MRM 定義を使用して作成されるすべての出力メッセージのコード・ページに有効であることを確認する必要があります。

メッセージを 1 つのコード・ページから別のコード・ページに変換する場合、埋め込み文字の変換後の値は後者のコード・ページで有効であることを確認する必要があります。 例えば、ASCII から コード・ページ 500 に変換する場合に、埋め込み文字として数値 8 を指定すると、その文字は 0x08 から 0x15 (ASCII および EBCDIC の「バックスペース」表記) に変換されます。

現行バージョンでは、U+007F より大きい値を埋め込み文字として指定できないという制限があります。 Unicode の mnemonic 値または numeric 値を入力すると、UTF-8 では、その値がその数値で表される文字と見なされます。

日時形式 ストリング 日時のテンプレートを選択します。

デフォルトの日時形式は、オブジェクトの論理タイプに応じて異なります。 論理タイプごとの日時形式のデフォルトについては、メッセージ・セット: 論理タイプによる DateTime デフォルトを参照してください。

日時形式に関する詳細は、メッセージ・セット: DateTime 形式を参照してください。

数値表現

プロパティー タイプ 意味
符号あり チェック・ボックス 値に符号が付いているかどうかを指定します。

このプロパティーが適用されるのは、「物理タイプ」プロパティーが「パック 10 進数」である場合だけです。 デフォルトでは、このチェック・ボックスはクリアされていて、値に符号が付いていないことを示しています。

ヌル値の表記

プロパティー タイプ 意味
ヌルのエンコード方式 列挙タイプ リストから以下のいずれかのオプションを選択します。
  • NULLPadFill。 このオプションは、固定長オブジェクトでのみ有効です。これがデフォルト値です。
  • NULLLogicalValue. 「ヌルのエンコード値」プロパティーは、最初に実際の値に変換されて、 フィールドに指定された方法でレンダリングされます。
  • NULLLiteralValue。 このオプションは、「ヌルのエンコード値」に、 それがストリングであるかのように直接置換される値が含まれていることを示します。 dateTime エレメントの場合に、「ヌルのエンコード値」プロパティーを使用してメッセージ内のフィールドの内容を検査または比較するには、このオプションを使用します。
  • NULLLiteralFill。 このオプションは、フィールドに「ヌルのエンコード値」プロパティーで指定された値が埋め込まれることを指定します。 「ヌルのエンコード値」は、単一の文字に解決されなければなりません。

選択したオプションによって、プロパティー「ヌルのエンコード値」に設定する値が決まります。

これらのオプションの使用法についての詳細は、メッセージ・セット: TDS ヌルの処理に関するオプションを参照してください。

ヌルのエンコード値 ストリング このプロパティーの使用は、「ヌルのエンコード方式」プロパティーに依存します。 デフォルト値はゼロです。

dateTime オブジェクトの「ヌルのエンコード方式」プロパティーを NULLLogicalValue に設定する場合、設定した値を ISO8601 の日時形式にする必要があります。

これらの形式については、メッセージ・セット: ストリング・データとしての DateTimeで説明しています。

例えば、1970-12-01 のように、yyyy-MM-dd'T'HH:mm:ss 形式に準拠した値を指定します。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:46:44


参照トピック参照トピック | バージョン 8.0.0.5 | ad15510_