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

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

メッセージ・セット: 組み込み単純タイプの浮動タイプの TDS プロパティー

フィールド識別、物理表現、数値表現、およびヌル値。

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

フィールド識別

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

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

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

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

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

エレメントが反復し、親グループまたは複合タイプの「データ・エレメント分離」プロパティーが「全エレメントを区切る」または「可変長エレメントを区切る」に設定されている場合にのみ、この区切り文字は使用されます。

前の条件が TRUE の場合、デフォルト値が指定されます。メッセージング標準が HL7 である場合、ニーモニック <HL7_RS> が使用されます。メッセージング標準が HL7 ではなく、反復の最大数が固定されている場合は、親グループまたは複合タイプの区切り文字が使用されます。

前の条件がいずれも TRUE でない場合は、デフォルトは適用されません。

物理表現

プロパティー タイプ 意味
物理タイプ 列挙タイプ オブジェクトの物理タイプを選択します。
メッセージ・セットの「メッセージング標準」プロパティーが「ユーザー定義テキスト」「ユーザー定義混合」「CSV」、または「TLOG」の場合、以下の値の 1 つを選択します。
  • テキスト。 データは文字フォーマットです。
  • 浮動。 C のデータ型 FLOAT または DOUBLE、あるいは COBOL の COMP-1 または COMP-2 数値データ型に相当します。
  • 整数。 C のデータ型 SHORT または LONG、あるいは COBOL の COMP、COMP-4、COMP-5、または BINARY 数値データ型に相当します。
  • パック 10 進数。 データはパック 10 進数であり、これは COBOL の COMP-3 データ型に相当します。
  • 外部 10 進数。 データは 10 進数であり、これは COBOL のデータ型 PIC 9 USAGE DISPLAY に相当します。
デフォルトは、「メッセージング標準」プロパティーに依存します。

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

長さ 整数 予期されるオブジェクトの長さを指定します (長さ単位)。

長さ参照」が指定されていない場合、ゼロ以外の長さを指定する必要があります。

位置調整 列挙タイプ

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

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

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

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

  • ドロップダウン・リストから 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 では、その値がその数値で表される文字と見なされます。

長さ参照 列挙タイプ このプロパティーが適用されるのは、「物理タイプ」「テキスト」「バイナリー」、または「TLOG 固有」である場合だけです。 設定された場合、このプロパティーが「長さ単位」プロパティー内の値よりも優先します。

その値が問題のオブジェクトの長さを判別する、兄弟となる整数オブジェクトの ID を指定します。 兄弟オブジェクトは、メッセージ構造内の現行のオブジェクトよりも前に定義しなければなりません。

エレメントの再配列の詳細については、メッセージ・セット: オブジェクトの再配列を参照してください。

数値表現

プロパティー タイプ 意味
仮想小数点 ボタンおよび整数 数値内の暗黙の小数点の位置を表すゼロ以外の整数を指定するか、または 0 (デフォルト) を指定して、「精度」プロパティーによって指定された Float または Decimal 数の形式を使用します。

正の整数の場合、小数点の位置は数値の右端から数えて左へ、指定された数だけ移動します。 例えば、3 を指定すると、10 進数値 1234 は 1.234 と表示されます。

負の整数の場合、小数点の位置は数値の右端から数えて右へ、指定された数だけ移動します。 例えば、-3 を指定すると、10 進数値 1234 は 1,234,000 と表示されます。

精度 ボタンおよび整数 このプロパティーが適用されるのは、「物理タイプ」「テキスト」のときだけです。 これは、「仮想小数点」プロパティーの値が、データ内に小数点があることを示す 0 の場合に使用されます。 このプロパティーでは、小数点以下の桁数を指定します (つまり、その桁数を超えた小数部分は切り捨てられることになります)。

次のいずれかの方法で桁数を指定します。

  • 「精度」を 0 に設定すると、 データが切り捨てられて小数部分が失われます。 例えば、値 123.45 は切り捨てられて 123 に なります。
  • 「精度」を小数部分の桁数より 小さい数値に設定すると、データは切り捨てられます。 例えば、「精度」を 2 に設定すると、値 123.4567 は切り捨てられて 123.45 になります。
  • 「精度」を小数部分の桁数より 大きい数値に設定すると、値に余分なゼロが埋め込まれます。 例えば、「精度」を 5 に設定すると、値 12.345 にはゼロが埋め込まれて 12.34500 になります。

あるいは、リストから 1 つのオプションを選択します。

  • 「すべての有効数字」 - 小数桁がある場合にのみ小数点が必要 (デフォルト): すべての有効数字が出力ビット・ストリームに書き込まれ、小数部分がなければ小数点は書き込まれません。
  • 「明示的小数点」 - 小数点が常時必要: すべての有効数字が出力ビット・ストリームに書き込まれ、小数桁がなくても常に小数点が組み込まれます。 小数桁が存在しない場合でも、小数点が入力ビット・ストリームに含まれなければなりません。
  • 「指数 表記」 - 例 "1.23456e002": データは [sign1]a.bbbe[sign2]ccc 形式の 符号付きの値としてビット・ストリームに書き込まれます。
    • [sign1] は、値が負の場合は 「負の符号」の値です。
    • a は単一の 10 進数です。
    • bbb は 1 つ以上の 10 進数です。
    • [sign2] は、指数が負の場合は 「負の符号」の値です。
    • ccc は、厳密に 3 桁の 10 進数 (指数) です。
    値と指数が正数の場合、[sign1] および [sign2] は存在しません。

    例えば、出力ビット・ストリームでは値 -123.456 は -1.23456e002 と表され、値 0.00012 は 1.2e-004 と表されます。ただし、「負の符号」の値が、"-" であって、「符号の付け方」が 「先頭」であることを前提とします。

    負の符号」が "*" であり、「符号の付け方」が「末尾」である場合、値 -0.00012 は 1.2*e*004 と表されます。

符号の付け方 列挙タイプ
このプロパティーに選択できる値は、以下のとおりです。
  • 先頭分離
  • 末尾分離
  • オーバーパンチされた先頭
  • オーバーパンチされた末尾

このプロパティーを使用できるのは、「物理タイプ」「テキスト」または「外部 10 進数」に設定していて、「符号付き」を選択しているときだけです。

「物理タイプ」「テキスト」の場合、「記号の方向」に有効な値は、「先頭分離」および「末尾分離」だけです。

「物理タイプ」「外部 10 進数」で、「オーバーパンチされた符号付き EBCDIC カスタマー」が選択されている場合、「記号の方向」に有効な値は、「オーバーパンチされた先頭」および「オーバーパンチされた末尾」だけです。

正の符号 ストリング 正の符号を表す値を指定します。 数値は指定しないでください。 値を設定しないと、"+" であるものと見なされます。 正の符号は出力メッセージの作成の際には書き込まれません。メッセージ・ビット・ストリームの構文解析の際に正の符号を認識するためにのみ使用されます。

このプロパティーが適用されるのは、「物理タイプ」「テキスト」で、「符号付き」が選択されているときだけです。

負の符号 ストリング 負の符号を表す値を指定します。 数値は指定しないでください。 値を設定しないと、"-" であるものと見なされます。

このプロパティーが適用されるのは、「物理タイプ」「テキスト」で、「符号付き」が選択されているときだけです。

ヌル値の表記

プロパティー タイプ 意味
ヌルのエンコード方式 列挙タイプ リストから以下のいずれかのオプションを選択します。
  • 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:49


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