COBOL2002 ユーザーズガイド

[目次][用語][索引][前へ][次へ]

29.2 MSMQアクセスサービスルーチン

COBOL2002でMSMQを使ったキューイングを処理するプログラムを作成するには,MSMQアクセスサービスルーチンを使用します。

MSMQアクセスサービスルーチンの一覧を次に示します。

表29-1 MSMQアクセスサービスルーチンの一覧

サービスルーチン名 機能
CBLMQCREATE キューを作成する
CBLMQDELETE キューを削除する
CBLMQOPEN キューをオープンする
CBLMQCLOSE キューをクローズする
CBLMQSENDMSG メッセージを送信する
CBLMQRECEIVEMSG メッセージを受信する
CBLMQLOCATE キューのパス名を検索する

MSMQアクセスサービスルーチンを呼び出すときには,インタフェース領域とデータパラメタ領域を引数に設定します。インタフェース領域は,COBOLプログラムとMSMQシステムとの間で情報をやり取りするための領域です。また,データパラメタ領域は,キューに対して送受信するデータやそのデータ長を格納するための領域です。

MSMQアクセスサービスルーチンは,キューのパス名,キューのラベル,メッセージのラベル,およびデータ変換フラグに有効を指定して送受信するメッセージデータの文字列を,内部的にワイド文字列(Unicode)にデータ変換,またはワイド文字列(Unicode)からデータ変換して使用します。

なお,各サービスルーチンの戻り値は,ほかのサービスルーチンと同様にRETURN-CODE特殊レジスタで参照できます。詳細は,「32.2 戻り値の使い方」を参照してください。

MSMQアクセスサービスルーチンを使用するには,「メッセージキュー」が組み込まれている必要があります。

MSMQアクセスサービスルーチンでは,必要な権限が与えられているプライベートキューとパブリックキューに対して,非トランザクションのメッセージの送受信,およびキューの作成と削除が実行できます。

<この節の構成>
29.2.1 キューを作成する(CBLMQCREATE)
29.2.2 キューを削除する(CBLMQDELETE)
29.2.3 キューをオープンする(CBLMQOPEN)
29.2.4 キューをクローズする(CBLMQCLOSE)
29.2.5 メッセージを送信する(CBLMQSENDMSG)
29.2.6 メッセージを受信する(CBLMQRECEIVEMSG)
29.2.7 キューのパス名を検索する(CBLMQLOCATE)