複合エレメントの dateTime タイプ用の CWF プロパティー

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

物理表現

プロパティー タイプ 意味
物理タイプ 列挙タイプ ドロップダウン・リストから以下のいずれかを選択します。
  • 固定長ストリング。 エレメントの長さは、以下の他の長さプロパティーによって決まります。
  • 長さエンコード・ ストリング 1。エレメントの最初のバイトに、長さ単位での、 その長さバイトの後に続くストリングの長さが含まれます。「長さエンコード・ストリング 1」エレメントの最大長は、255 長さ単位です。
  • 長さエンコード・ ストリング 2。エレメントの最初の 2 バイトに、長さ単位での、その 2 つの長さバイトの後に続くストリングの 長さが含まれます。「長さエンコード・ストリング 2」エレメントの最大長は 65535 長さ単位です。2 つの長さバイトは、WebSphere MQキュー・ マネージャーの Encoding の形式です。
  • ヌル終端ストリング。ストリングは 16 進ヌル文字 X'00' で終わります。
  • パック 10 進数。dateTime はパック 10 進数としてコード化されます。 これは、「DateTime 形式」プロパティーが数値のみのデータを表している場合に のみ有効です。
  • バイナリー。 dateTime はバイトのバイナリー・シーケンスとしてエンコードされます。このオプションを選択する場合、「形式ストリング」プロパティーに指定できる記号の範囲は、ストリング・オプションを選択する場合に指定できる記号の範囲よりも狭くなります (詳細については、DateTime 形式 を参照)。
  • 時刻 (秒)。この値は、 C の time_t と、Java の Date および Time オブジェクトをサポートします。 これは、「DateTime 形式」プロパティーが数値のみのデータを表している場合に のみ有効です。
  • 時刻 (ミリ秒)。この値は、 C の time_t と、Java の Date および Time オブジェクトをサポートします。 これは、 「DateTime 形式」プロパティーが数値のみのデータを表している場合にのみ 有効です。

デフォルト値は fixed length string です。

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

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

「物理タイプ」「バイナリー」に設定すると、テンプレートは ストリング・データとしての DateTime で定義されているコンポーネントに制限されます。「物理タイプ」「パック 10 進数」「時刻 (秒)」、または「時刻 (ミリ秒)」に設定すると、テンプレートは数値を表す それらのコンポーネントに制限されます。これらの場合には、この「DateTime 形式」プロパティーを更新する必要があります。

日時形式に関する詳細は、DateTime 形式を参照してください。

長さカウント ボタンおよび整数 「固定長ストリング」「パック 10 進数」、または 「バイナリー」「物理タイプ」を選択して、 「長さタイプ」「カウント」に設定している場合は、 エレメントの長さ単位の数値を入力します。

指定できる最小値は、すべての物理タイプの場合に 1 です。

指定できる最大値は、固定長ストリングの場合 256パック 10 進数の場合 10バイナリーの場合 2147483647 です。

デフォルト値は 0 (ゼロ) です。

長さ参照 ボタンおよび列挙タイプ 「長さ参照」によって長さを定義するように 選択した場合は、そのオブジェクトの長さを指定する Integer オブジェクトの名前を選択します。現行オブジェクトの兄弟として 定義され、メッセージの構造の中でこれより前に現れる Integer オブジェクトのドロップダウン・リストから選択してください。

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

長さ単位 列挙タイプ 設定されている「物理タイプ」に応じて、 ドロップダウン・リストから以下のいずれかを選択します。
  • バイト。 これは、X バイトが処理されることを示します (X は「長さカウント」の値か、 「長さ参照」で指定されている INTEGER の値)。
  • 文字。 このオプションの意味は、メッセージの CCSID に設定した値、またはメッセージ・セット・プロパティーの デフォルト CCSID として設定した値に依存します。
    • SBCS CCSID を指定した場合は、X バイトが処理されます (X は「長さカウント」の値か、 「長さ参照」で指定されている INTEGER の値)。
    • DBCS CCSID を指定した場合は、Y バイトが処理されます (Y は 「長さカウント」の値または 「長さ参照」で指定されている INTEGER の値に 2 を乗算したもの)。
    • MBCS CCSID を指定した場合、パーサーは一度に 1 文字を読み取って、文字が 1 バイト以上で構成されているかどうかを 判別します。パーサーは、Z 回の読み取りを実行します (Z は 「長さカウント」の値か、 「長さ参照」で指定されている INTEGER の値)。
  • 文字単位。これは、文字単位のサイズが、ユーザーがメッセージの CCSID に設定した値か、メッセージ・セット・プロパティーの デフォルト CCSID として指定した値によって決定されることを示します。 処理されるバイト数は、文字単位のサイズに「長さカウント」の値または 「長さ参照」に指定されている INTEGER の値を乗算したものになります。
  • 「ビット・ストリームの終了」。ビット・ストリームの終了までのすべてのデータが処理されます。 このオプションは、エレメントがメッセージ内の最後のエレメントである場合にのみ有効です。 この値を選択した場合には、「長さカウント」または 「長さ参照」に値を入力する必要はありません。

デフォルトは bytes です。

符号あり ブール 「物理タイプ」プロパティー を「パック 10 進数」「時刻 (秒)」、または「時刻 (ミリ秒)」に設定した場合は、「符号付き」を選択 (デフォルト) または選択解除します。 「物理タイプ」に別の値を選択した場合、このプロパティーは無効です。
ストリング位置調整 列挙タイプ 「物理タイプ」プロパティーを固定長 ストリング に設定している場合は、ドロップダウン・リストから 「左寄せ」 (デフォルト値) または「右 寄せ」を選択します。「物理タイプ」に別の値を選択している場合は、このプロパティーは非アクティブです。
埋め込み文字 ストリング

「物理タイプ」プロパティーを「固定長ストリング」に設定し、「ストリング位置調整」プロパティーを「左寄せ」または「右寄せ」のいずれかに設定した場合、このプロパティーが該当します。

出力メッセージを書き込むとき、ストリング長が 「長さカウント」 または 「長さリファレンス」 プロパティーで示す長さより短い場合、残りの文字の位置を埋めるために埋め込み文字を使用します。ストリングを左方または右方のいずれから埋め込むかは、「ストリング位置調整」プロパティーに支配されます。

入力メッセージを構文解析するとき、埋め込み文字はストリングの末尾からトリムされます。ストリングを左方または右方のいずれからトリムするかは、「ストリング位置調整」 プロパティーに支配されます。

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

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

MRM エレメントにどの埋め込み文字形式を使用するかの選択は、どの埋め込み文字が必要か、 また埋め込み文字がデータ変換されるかどうかに応じて異なります。 ほとんどの場合、埋め込み文字を引用符で指定するだけで十分であり、その埋め込み文字が使用されるとき、 生成される MRM 出力メッセージのターゲット・コード・ページに変換されます。 例えば、ASCII からコード・ページ 500 に変換する場合、 埋め込み文字として U+0008 を指定すると、 これは 0x08 から 0x15 (つまり ASCII および EBCDIC での「バックスペース」表記) に変換されます。

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

メッセージを 1 つのコード・ページから別のコード・ページに変換する場合、 埋め込み文字の変換後の値は後者のコード・ページで有効でなければなりません。 埋め込み文字がターゲットのコード・ページで表せない場合、置換文字に置換されます。置換文字は固定値で、その値は指定したターゲットのコード・ページに依存します。

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

ヌル値の表記

プロパティー タイプ 意味
ヌルのエンコード方式 列挙タイプ ドロップダウン・リストから以下のいずれかのオプションを選択します。 選択したオプションによって、プロパティー「ヌルのエンコード値」に設定する値 が決まります。
  • NULLPadFill。 これは、「物理タイプ」「固定長ストリング」の場合にのみ有効です。フィールドには、 「埋め込み文字」で指定された値が埋め込まれます。 これはデフォルト値です。
  • NULLLogicalValue「ヌルのエンコード値」プロパティーはまず実際の値に変換され、フィールドに指定された方法でレンダーされます。
  • NULLLiteralValue。 これは、「ヌルのエンコード値」に、 それがストリングであるかのように直接置換される値が含まれていることを示します。このオプションは、ヌル日付を指定するために 「ヌルのエンコード値」に設定した値が、標準の dateTime 値でないか、標準の dateTime 形式 yyyy-MM-dd 'T'HH:mm:ss に準拠していないときに使用します。
  • NULLLiteralFill. フィールドには、「ヌルのエンコード値」で指定された値が埋め込まれます。 「ヌルのエンコード値」は、単一の文字に解決されなければなりません。
ヌルのエンコード値 ストリング

「ヌルのエンコード 方式」プロパティーを NULLPadFill に設定すると、 このプロパティーは使用不可になります (グレー化されます)。

「ヌルのエンコード 方式」プロパティーを NULLLogicalValue に設定する 場合は、このプロパティーを ISO8601 の dateTime 形式に設定する必要があります。これらの形式については、 ストリング・データとしての DateTime で説明されています。例えば、1970-12-01 のように、yyyy-MM-dd'T'HH:mm:ss に 準拠した値を指定します。

「ヌルのエンコード方式」プロパティーを NULLLiteralValue に設定すると、フィールドと同じ長さの 任意の値を入力することができます。

「ヌルのエンコード方式」 プロパティーを NULLLiteralFill に設定した場合、値は 単一の文字に解決されなければなりません。この文字は、以下のいずれかの方法によって指定できます。
  • ドロップダウン・リストから SPACE、NUL、0x00、または 0xFF を選択します。
  • 引用符で囲われた文字、例えば 'c' または "c" (c は任意の英数字) を入力する。
  • 16 進文字コードを、0xYY (YY は 16 進値) の形式で入力します。
  • 10 進文字コードを、YY (YY は 10 進値) の形式で入力します。
  • ユニコード値を U+xxxx (xxxx は 16 進数の形式で指定されたユニコード値) の形式で入力します。

バイト位置合わせ

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

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

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

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

反復

プロパティー タイプ 意味
反復参照 列挙タイプ オブジェクトが複数回出現し、出現回数がメッセージ内のフィールドですでに動的に指定されている場合に、このプロパティーを使用します。

メッセージの構造の中でこのオブジェクトの前に置かれる Integer オブジェクトのドロップダウン・リストから、Integer オブジェクトを選択します。 選択した整数の値は、このオブジェクトの出現回数を指定します。 オブジェクトがリストにない場合には、メッセージ構造の中にこのオブジェクトの前には Integer オブジェクトがありません。

反復参照」を指定すると、メッセージの構文解析および書き込みをする際に「最大オカレンス」論理プロパティーの設定をオーバーライドしますが、メッセージの妥当性検査の設定はオーバーライドしません。

関連概念
メッセージのモデル化
メッセージ・モデル
カスタム・ワイヤー形式: 論理モデルとの関係
関連タスク
メッセージ・モデルの開発
メッセージ・モデル・オブジェクトの処理
関連資料
メッセージ・モデルの参照情報
メッセージ・モデル・オブジェクトのプロパティー
推奨されないメッセージ・モデル・オブジェクトのプロパティー
複合エレメントのプロパティー
複合エレメントの CWF プロパティー
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ad15920_