27.2 MSMQアクセスサービスルーチン
COBOL2002でMSMQを使ったキューイングを処理するプログラムを作成するには,MSMQアクセスサービスルーチンを使用します。
MSMQアクセスサービスルーチンの一覧を次に示します。
サービスルーチン名 |
機能 |
---|---|
CBLMQCREATE |
キューを作成する |
CBLMQDELETE |
キューを削除する |
CBLMQOPEN |
キューをオープンする |
CBLMQCLOSE |
キューをクローズする |
CBLMQSENDMSG |
メッセージを送信する |
CBLMQRECEIVEMSG |
メッセージを受信する |
CBLMQLOCATE |
キューのパス名を検索する |
MSMQアクセスサービスルーチンを呼び出すときには,インタフェース領域とデータパラメタ領域を引数に設定します。インタフェース領域は,COBOLプログラムとMSMQシステムとの間で情報をやり取りするための領域です。また,データパラメタ領域は,キューに対して送受信するデータやそのデータ長を格納するための領域です。
MSMQアクセスサービスルーチンは,キューのパス名,キューのラベル,メッセージのラベル,およびデータ変換フラグに有効を指定して送受信するメッセージデータの文字列を,内部的にワイド文字列(Unicode)にデータ変換,またはワイド文字列(Unicode)からデータ変換して使用します。
なお,各サービスルーチンの戻り値は,ほかのサービスルーチンと同様にRETURN-CODE特殊レジスタで参照できます。詳細は,「30.2 戻り値の使い方」を参照してください。
MSMQアクセスサービスルーチンを使用するには,「メッセージキュー」が組み込まれている必要があります。
MSMQアクセスサービスルーチンでは,必要な権限が与えられているプライベートキューとパブリックキューに対して,非トランザクションのメッセージの送受信,およびキューの作成と削除が実行できます。