メッセージ・データ変換

符号化文字集合識別子 （CCSID）は、符号化方式識別子、文字集合識別子、コードページ識別子、および文字データを一意に識別するその他の情報の集合を含む16ビットの番号である。 これらの識別子は、文字データを識別し、データ変換処理中にデータの整合性を維持するための IBM アーキテクチャの一部である。 登録されているCCSIDのリストなど、このアーキテクチャの詳細については、オンラインで入手可能な文字データ表現アーキテクチャの PDFを参照してください。

CCSIDは、文字と文字以外のデータを'00'から'FF'までの16進数値（漢字など256ポジションで表現できないアルファベットに使われるDBCS（ダブルバイト文字セット）CCSIDでは'0000'から'FFFF'）に割り当てる。 あるCCSIDから別のCCSIDへの変換に使われるCCSID変換テーブルは、一般に文字データと制御文字を変換する。 よく知られているCCSIDには、1208（ UTF-8 ）や500（主に z/OS ）で使用されているEBCDID CCSID）などがある。 サポートされるCCSIDのリストについては、 コードページ変換を参照のこと。

データ変換の文脈では、 エンコードとは、プラットフォームが数値データを表現するために使用する方法を意味する。 番号の最下位バイトと最上位バイトの順序は、プラットフォームのエンディアンによって異なる場合がある。 例えば、 IBM Z ハードウェア上の z/OS はビッグエンディアン（数値の最下位バイトが最上位アドレス、最上位バイトが最下位アドレス）であるのに対し、 x86 ハードウェア上の Windows はリトルエンディアン（ビッグエンディアンとはバイトが逆順）である。 つまり、数字437は16進法では z/OS の X’01BF’、 Windows の X’BF01’ として表される。 IBM Power® はリトルエンディアンかビッグエンディアンのどちらかである。 そのため、同じCCSIDを使用するプラットフォーム間で受け渡しする場合でも、数値データの変換が必要になる場合がある。

フォーマットは、 IBM MQ メッセージの送信者が、メッセージのデータの性質を受信者に示すために使用する名前である。

IBM MQ には、 で始まるいくつかのメッセージ・フォーマットが組み込まれています。 MQ 例えば、MQFMT_STRING。 これらの書式は、例えば文字列、 CICS データ、 IBM MQ イベントに関する情報、あるいは受信キュー・マネージャが実行するためのプログラマブル・コマンド・フォーマット（PCF）コマンドなどがメッセージに含まれていることを示すために使用することができます。 独自のフォーマットを定義することもできる。

キュー・マネージャーはまた、メッセージのフォーマットを設定するかもしれない。 例えば、キュー・マネージャがメッセージを配送できない場合、メッセージの先頭に新しいヘッダを追加し、MQFMT_DEAD_LETTER_HEADER というフォーマットで、メッセージが配送されなかったことを示し、そのメッセージをデッド・レター（未配信メッセージ）・キューに入れます。

各キューマネージャには CCSID があり、これはマルチプラットフォームでのキューマネージャの作成で説明されているように、キューマネージャを作成する際に自動的に設定されます（後で変更することも可能です）。 2つの IBM MQ キューマネージャ間のチャネルが開始されると、2つのキューマネージャはチャネル通信に使用するCCSIDとマシンエンコーディングをネゴシエートする。 このCCSIDと符号化スキームは、次に IBM MQ の送信セグメントヘッダ（ IBM MQ のトレースを見ると、キューマネージャ間で渡されるのを見ることができるかもしれない IBM MQ 制御ブロック）とメッセージ記述子の符号化に使用される。 メッセージ・ディスクリプタは、アプリケーションがメッセージをキューに入れるときに、アプリケーションによって作成され、入力されます。 メッセージ記述子内のデータは，ローカルのキューマネージャの文字セットとエンコーディング（キューマネージャのCCSIDとローカルのマシンのエンコーディングによって決定されます），あるいは，アプリケーションがアプリケーションの場合は，クライアントシステムの文字セットとエンコーディング（クライアントまたはサーバのCCSIDの選択を参照してください）でなければなりません。 IBM MQ MQI client アプリケーションであれば，クライアントシステムの文字セットとエンコーディング（ クライアントまたはサーバの CCSID の選択参照）でなければなりません。 IBM MQ 記述子が作成されたプラットフォームに関係なく、メッセージ記述子の内容を理解する必要があるため、、メッセージ記述子は自動的に変換される。 IBM MQ

メッセージ・ディスクリプタの詳細については、 MQMD - メッセージ・ディスクリプタを参照のこと。

一般的に、 IBM MQ はアプリケーションデータを自動的に変換しない。なぜなら、変換せずに渡したい場合があるからである（Java アプリケーションは例外であることは後述する）。 したがって、アプリケーションデータの変換を要求しなければならない。

送信側のアプリケーションは、メッセージをキューに入れる前に、適切なメッセージ記述子フィールドを設定することによって、アプリケーション・データのCCSID、エンコーディング、フォーマットを指定します。 アプリケーションは実際の値または IBM MQ 特殊な値。たとえば、データがメッセージを送信するキュー マネージャーと同じ CCSID を使用していることや、データがアプリケーションが実行されているマシンと同じエンコードを使用していることを示す文字列です。 アプリケーションデータには、ヘッダーに続くアプリケーションデータの異なるCCSID、エンコーディング、フォーマット情報を指定するヘッダーを含めることもできる。 MQIアプリケーション用のこれらのフィールドの詳細については、『 Field details for MQMD 』の「 CodedCharSetId, Encoding」および「Format」のセクションを参照のこと。 （他のアプリケーションタイプでは、オプションは異なりますが同等のオプションがあります。たとえば、 IBM MQ classes for JMS JMS フィールドとプロパティーおよび対応する MQMD フィールドのリストにあるように、JMS_IBM_Character_Set プロパティーを持ちます。

****Message descriptor****
 
  StrucId  : 'MD  '  Version : 2
  Report   : 0  MsgType : 8
  Expiry   : -1  Feedback : 0
  Encoding : 546  CodedCharSetId : 850
  Format : 'MQEVENT '
  Priority : 0  Persistence : 0
  MsgId : X'414D512073617475726E2E71756575650005D30033563DB8'
  CorrelId : X'000000000000000000000000000000000000000000000000'
  BackoutCount : 0
  ReplyToQ       : '                                                '
  ReplyToQMgr    : 'saturn.queue.manager                            '
  ** Identity Context
  UserIdentifier : '            '
  AccountingToken :
   X'0000000000000000000000000000000000000000000000000000000000000000'
  ApplIdentityData : '                                '
  ** Origin Context
  PutApplType    : '7'
  PutApplName    : 'saturn.queue.manager        '
  PutDate  : '19970417'    PutTime  : '15115208'
  ApplOriginData : '    '
 
  GroupId : X'000000000000000000000000000000000000000000000000'
  MsgSeqNumber   : '1'
  Offset         : '0'
  MsgFlags       : '0'
  OriginalLength : '104'

****  Message   ****

length - 104 bytes

00000000: 0700 0000 2400 0000 0100 0000 2C00 0000 '....→.......,...'
00000010: 0100 0000 0100 0000 0100 0000 AE08 0000 '................'
00000020: 0100 0000 0400 0000 4400 0000 DF07 0000 '........D.......'
00000030: 0000 0000 3000 0000 7361 7475 726E 2E71 '....0...saturn.q'
00000040: 7565 7565 2E6D 616E 6167 6572 2020 2020 'ueue.manager    '
00000050: 2020 2020 2020 2020 2020 2020 2020 2020 '                '
00000060: 2020 2020 2020 2020 

受信側のアプリケーションは、アプリケーションがキューからメッセージを受け取ったときに、データ変換を要求することができる。 たとえばMQIアプリケーションでは、 MQGET コールで MQGMO_CONVERT オプションを指定してデータ変換を要求する。 キュー・マネージャーは、変換が必要かどうかをチェックし、必要であればデータを変換する。 これらのチェックには、例えば、メッセージ記述子のCCSIDとエンコーディングが、受信アプリケーションが期待するCCSIDとエンコーディングと一致するかどうかが含まれる。 受信側のMQIアプリケーションは、MQGETコールで MsgDesc パラメータを設定することで、期待する値を指定する。 メッセージ受信時に MQ が行うチェックとデータ変換処理の詳細については、 変換処理を参照。

アプリケーション・データのCCSIDとエンコーディングが IBM MQ （ コード・ページ変換と マシン・エンコーディングを参照）でサポートされており、フォーマットが組み込みの IBM MQ フォーマットであれば、 IBM MQ 、組み込みの変換ルーチンを使用してデータ変換を実行できる。 そうでない場合は、アプリケーション・プログラマーが、 データ変換終了として知られるユーザー終了プログラムで、変換コードを供給しなければならない。 IBM MQ は、これらのユーザー終了を作成するのに役立つスケルトン構造とユーティリティを提供する。 詳しくは、 データ変換終了の書き方を参照のこと。

あるいは、システム管理者は、 IBM MQ Sender、Server、Cluster-receiver、Cluster-senderチャネルの CONVERT オプションをYESに設定することで、メッセージ送信時に変換を要求することができる。 メッセージは受信キュー・マネージャの CCSID を用いて変換される。 メッセージ・チャンネルによるデータ変換は、通常、他の形式の変換が不可能な場合にのみ使用される。

AIX の換算表は /usr/lib/nls/loc/iconvTable である。

iconv -f fromcodeset -t tocodeset fromfile > tofile

使用される変換コードは Windows と同様である。

表の名前は、コードページ番号の16進数を連結したもので、500から850への変換は表 01F40352.tbl。 変換テーブル・ディレクトリ・ファイルでは、 readme.ccs 、出荷されたテーブルのほとんどが記述されている。

Windowsのテーブルの名前は、コードページ番号の16進数を連結したものであるため、500から850への変換はテーブル 01F40352.tbl。 コンバージョンテーブルディレクトリでは、ファイル readme.ccs 、出荷されたテーブルのほとんどが記述されている。