属性参照およびローカル属性の浮動タイプ用の CWF プロパティー

ここで説明されているカスタム・ワイヤー形式のプロパティーは、以下のものに適用されます。

物理表現

プロパティー タイプ 意味
物理タイプ (Physical Type) 列挙タイプ ドロップダウン・リストから以下のいずれかを選択します。
  • Integer (整数)。 これは C のデータ型 SHORT または LONG、あるいは COBOL の COMP、COMP-4、COMP-5、または BINARY 数値データ型に相当します。
  • Float (浮動)。 これは C のデータ型 FLOAT または DOUBLE、 あるいは COBOL の COMP-1 または COMP-2 データ型に相当します。 これはデフォルト値です。
  • Packed Decimal (パック 10 進数)。これは COBOL の COMP-3 データ型に相当します。
  • External Decimal (外部 10 進数)。 これは COBOL のデータ型 PIC 9 USAGE DISPLAY に相当します。

数値エレメントの表記は、 WebSphere MQ キュー・マネージャーに設定されている Encoding および CodedCharSetId 属性の影響を受ける可能性があります。

  • 「Physical Type (物理タイプ)」「Integer (整数)」「Packed Decimal (パック 10 進数)」、または「Float (浮動)」に設定されているエレメントは、 適切な WebSphere MQ Encoding 値で表記されます。
  • 「Physical Type (物理タイプ )」「External Decimal (外部 10 進数)」に設定されているエレメントは、 WebSphere MQ CodedCharSetId 値で表記されます。
長さカウント (Length Count) 整数 エレメントの長さを示すバイト数を入力します。
  • 「Physical Type (物理タイプ )」「Float (浮動)」に設定する場合は、 ドロップダウン・リストから値を選択します。デフォルト値は 8 です。
  • 「Physical Type ( 物理タイプ)」「Integer (整数)」に設定する場合は、 ドロップダウン・リストから 12、または 4 (デフォルト ) を選択します。
  • 「Physical Type (物理タイプ )」「Packed Decimal (パック 10 進数)」に設定する場合は、1 と 10 の間の値を入力します。
  • 「Physical Type (物理タイプ )」「Extended Decimal (拡張 10 進数)」に設定する場合は、1 と 256 の間の値を入力します。 (最大 COBOL PICTURE 文節の 18 より大きな数は、18 と見なされます。)
長さ (Length Units) 列挙タイプ 設定済みの「物理タイプ (Physical Type)」に応じて、ドロップダウン・リストから以下のいずれかの値を選択します。
  • 「バイト (Bytes)」
  • 「文字 (Characters)」。 このオプションの意味は、メッセージの CCSID に設定した値、またはメッセージ・セット・プロパティーの デフォルト CCSID として設定した値に依存します。
    • SBCS CCSID を指定した場合は、X バイト (X は 「長さカウント (Length Count)」の値か、 「長さの参照 (Length Reference)」で指定されている INTEGER の値) が処理されます。
    • DBCS CCSID を指定した場合は、Y バイト (Y は 「長さカウント (Length Count)」の値または 「長さの参照 (Length Reference)」で指定されている INTEGER の値に 2 を乗算したもの) が処理されます。
    • MBCS CCSID を指定した場合、パーサーは一度に 1 文字を読み取り、 文字が 1 バイト以上で構成されているかどうかを判別します。 パーサーは Z 回の読み取り (Z は「長さカウント (Length Count)」の値か、「長さの参照 (Length Reference)」で指定されている INTEGER の値) を実行します。
  • 「文字単位 (Character Units)」。 これは、文字単位のサイズが、ユーザーがメッセージの CCSID に設定した値か、メッセージ・セット・プロパティーの デフォルト CCSID として指定した値によって決定されることを示します。 処理されるバイト数は、文字単位のサイズに、 「長さカウント (Length Count)」の値または 「長さの参照 (Length Reference)」で指定されている INTEGER の値を乗算したものになります。
  • 「ビット・ストリームの終了 (End of Bitstream)」。 ビット・ストリームの終了までのすべてのデータが処理されます。 このオプションは、エレメントがメッセージ内の最後のエレメントである場合にのみ有効です。 この値を選択する場合は、 「長さカウント (Length Count)」.

デフォルト値は bytes です。

符号あり ブール このプロパティーを選択または選択解除 (符号なし、デフォルト) します。 「Physical Type (物理タイプ )」「Float (浮動)」に設定した場合、これが選択されます。 このプロパティーは、「符号の付け方 (Sign Orientation)」とともに使用されます。
符号付 EBCDIC カスタム (Signed EBCDIC Custom) ブール 「物理タイプ (Physical Type)」「外部 10 進数 (External Decimal)」に設定されており、 「符号付 EBCDIC カスタム (Signed EBCDIC Custom)」プロパティーが設定されている場合、これは「符号 EBCDIC カスタム (Sign EBCDIC Custom)」表記が ASCII 環境内で使用されることを示します。 このチェック・ボックスが設定されていない場合 (デフォルト)、 「符号 ASCII (Sign ASCII)」表記が使用されます。

符号 EBCDIC カスタム (Sign EBCDIC Custom)」チェック・ボックスの設定は、「符号の付け方 (Sign Orientation)」プロパティーが 「先頭 (Leading)」または「末尾 (Trailing)」に設定されている (エレメント/属性が組み込み符号表記を持っていることを示している) 場合にのみ適切です。

エレメント/属性が符号付きでない場合 (たとえば、「符号付き (Signed)」チェック・ボックスが設定されていない場合)、チェック・ボックスは使用不可となります。

符号の付け方 (Sign Orientation) 列挙タイプ 「物理タイプ (Physical Type)」「外部 10 進数 (External Decimal)」に設定し、 「符号付き (Signed)」を設定した場合、数値データの表示のための COBOL オプションを表す以下のオプションの選択を行ってください。
  • Included Leading (先頭に組み込む)。 これは、数値が負の場合に、最初のバイトの 1 ビットを有効にします。 数値が正の場合には、設定は行われません。 たとえば、数値 22 の ASCII 16 進数表記は x'3232' です。 このオプションを使用する場合、 数値 +22x'3232' になり、 数値 -22x'7232' になります。 これはデフォルト値です。
  • Separate Leading (先頭に付加)。 これは、エレメントの最初のバイトを、数値が正の場合 '+' に、数値が負の場合 '-' に設定します。 このオプションの場合には、長さに符号バイトが含まれていなければなりません。
  • Included Trailing (末尾に組み込む)。 これは、数値が負の場合に、最後のバイトの 1 ビットを有効にします。 数値が正の場合には、設定は行われません。 このオプションを使用する場合、数値 +22 x'3232' になり、数値 -22x'3272' になります。
  • Separate Trailing (末尾に付加)。 これは、エレメントの最後のバイトを、数値が正の場合 '+' に、数値が負の場合 '-' に設定します。 このオプションの場合には、長さに符号バイトが含まれていなければなりません。
「Physical Type (物理タイプ)」を他の値に設定した場合は、 値「Not Applicable (適用不可)」が設定されます。
仮想小数点 (Virtual Decimal Point) 整数 小数点の位置を、その想定位置から右 (正の値の場合)、または左 (負の値の場合) にいくつ移動すべきかを指定します。 たとえば、1234 を含む「仮想小数点 (Virtual Decimal)」値が 3 の FLOAT エレメントは 1.234 です。

「Physical Type (物理タイプ )」「Float (浮動)」に設定した場合、これは適用不可です。

ストリング位置調整 (String Justification) 列挙タイプ 「物理タイプ (Physical Type)」プロパティーを External Decimal (外部 10 進数) に設定した場合、 ドロップダウン・リストから「Left Justify (左寄せ)」 または「Right Justify (右寄せ)」(デフォルト値) を選択します。 「物理タイプ (Physical Type)」に別の値を選択した場合、このプロパティーは無効です。
埋め込み文字 (Padding Character) ストリング 埋め込み文字は、ストリング長が指定されたストリング・サイズよりも短い場合に、残りの文字の位置を埋めるために使用されます。 「物理タイプ (Physical Type)」プロパティーをExtended Decimal (拡張 10 進数)に設定し、「ストリング位置調整 (String Justification)」 プロパティーを「Left Justify (左寄せ)」または「Right Justify (右寄せ)」のいずれかに設定した場合は、以下のいずれかの方法でこの文字を設定します。
  • ドロップダウン・リストから NUL'0'、または SPACE を選択します。
  • 引用符で囲われた英数字、たとえば "c" または 'c' (c は任意の英数字) を入力します。
  • 16 進文字コードを、0xYY (YY は 16 進値) の形式で入力します。

    MRM エレメントにどの埋め込み文字形式を使用するかの選択は、どの埋め込み文字が必要か、 また埋め込み文字がデータ変換されるかどうかに応じて異なります。 ほとんどの場合、埋め込み文字を指定するだけで十分であり、その埋め込み文字が使用されるとき、 生成される MRM 出力メッセージのターゲット・コード・ページに変換されます。 埋め込み文字フィールドに簡単に入力できない埋め込み文字が必要とされる場合、 Unicode ニーモニック形式を使って必要な文字を入力することができます。 この Unicode 値もまた、生成される MRM メッセージのターゲット・コード・ページに変換されます。 データ変換されない埋め込み文字が必要な場合、16 進数形式を使用できます。 これによって、出力メッセージに直接挿入される埋め込み文字を指定できます。 16 進形式を使用する場合、 これらの MRM 定義を使って作成されるすべての出力メッセージのコード・ページで有効な 16 進数を必ず使用してください。

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

    現在のところ、U+007F より大きい値を埋め込み文字として指定できないという制限があります。 Unicode の mnemonic 値または numeric 値を入力する場合、utf-8ではその数値で表される文字と見なされます。

  • ユニコード値を U+xxxxxx (xxxxxx は 16 進数で指定されたユニコード値) の形式で指定します。 入力できるストリングの最大長は 10 です。
  • 空のストリングであるデフォルト値を選択します。

ヌル値の表記

プロパティー タイプ 意味
ヌルのエンコード (Encoding Null) 列挙タイプ ドロップダウン・リストから以下のいずれかのオプションを選択します。
  • NULLPadFill。 これは 「物理タイプ (Physical Type)」「External Decimal (拡張 10 進数)」の場合のみ有効です。 フィールドは、 「埋め込む文字 (Padding Character)」によって指定された値で埋められます。 「ヌル値のエンコード (Encoding Null Value)」は空ストリングに設定する必要があります。
  • NULLLogicalValue「ヌル値のエンコード (Encoding Null Value)」は、フィールドに必要な形式と一致するように変換されます。 これはデフォルト値です。
  • NULLLiteralValue「ヌル値のエンコード (Encoding Null Value)」は、それ自体がストリングであるかのように直接置換されます。 非数値の値を 「ヌル値のエンコード (Encoding Null Value)」に指定することができます。
ヌル値のエンコード (Encoding Null Value) ストリング このプロパティーの使用は、上記の「ヌルのエンコード (Encoding Null)」プロパティーに依存します。 デフォルト値はゼロです。

バイト位置合わせ

プロパティー タイプ 意味
バイト位置合わせ (Byte Alignment) 列挙タイプ メッセージ開始を基点とした、オブジェクトの位置合わせ方法を指定します。 以下のいずれかを選択します。
  • 1 Bytes (1 バイト)。 これはデフォルト値です。
  • 2 Bytes (2 バイト)
  • 4 Bytes (4 バイト)
  • 8 Bytes (8 バイト)
  • 16 Bytes (16 バイト)
先頭のスキップ・カウント (Leading Skip Count) 整数 このオブジェクトの読み取りまたは書き込みの前にスキップするバイト数を指定します。 デフォルトは0、 最小値は0、 最大値は 999999 です。 この値を使用して構造内の不要なフィールドを無視したり、または 2、4、8 または 16 の バイト境界に位置合わせを必要とする、C または COBOL データで定義されたフィールドをモデル化 したりすることができます。 このオブジェクトの読み取りまたは書き込みの前にスキップするバイト数を指定します。 出力メッセージが書き込まれるとき、 スキップ・カウント・バイトにはメッセージ・セットの「バイト位置合わせパッド」プロパティーの値が割り当てられます。

反復オブジェクトについては、このプロパティーは最初のインスタンスにのみ適用されます。

末尾のスキップ・カウント (Trailing Skip Count) 整数 このオブジェクトの読み取りまたは書き込みの後にスキップするバイト数を指定します。 デフォルトは0、 最小値は0、 最大値は 999999 です。 この値を使用して構造内の不要なフィールドを無視したり、または 2、4、8 または 16 の バイト境界に位置合わせを必要とするフィールドを含む繰り返し構造をモデル化 したりすることができます。 出力メッセージが書き込まれるとき、 スキップ・カウント・バイトにはメッセージ・セットの「バイト位置合わせパッド」プロパティーの値が割り当てられます。

反復オブジェクトについては、このプロパティーはすべてのインスタンスに適用されます。

関連概念
メッセージのモデル化
メッセージ・モデル

関連タスク
メッセージ・モデルの開発
メッセージ・モデル・オブジェクトの処理

関連資料
メッセージ・モデル参照情報
メッセージ・モデル・オブジェクトのプロパティー
メッセージ・モデル・オブジェクトの論理プロパティー
メッセージ・モデル・オブジェクトのカスタム・ワイヤー形式の物理プロパティー
メッセージ・モデル・オブジェクトの XML ワイヤー形式の物理プロパティー
メッセージ・モデル・オブジェクトのタグ付き/区切りストリング形式の物理プロパティー
すべてのメッセージ・セット・オブジェクトの文書プロパティー
オブジェクトによるメッセージ・モデル・オブジェクトのプロパティー
追加の MRM ドメイン情報