MessageQueueDirector説明書

8.3.1.5 mqd_connectq (メッセージキューに接続する)

機能説明

　当該アプリケーションをメッセージキューに接続します。

記述形式

---------------------------------------------------------------------------------------
      #include "mqdapi.h"
      int mqd_connectq(MQD_System *system, char *qname, MQD_Environment *env,
                       MQD_MessageQueue **queue)
---------------------------------------------------------------------------------------

パラメタ

system

　mqd_connect関数から返されたMQDシステム情報へのポインタをそのまま指定します。

qname

　メッセージキュー名へのポインタを指定します。メッセージキュー名は、メッセージキューを作成したときに指定したメッセージキューの名前です。

env

　例外処理のための復帰情報へのポインタを指定します。エラー詳細コードに以下の値が返されます。復帰情報(MQD_Environment構造体)の詳細については、“8.4 復帰情報の説明”を参照してください。

  MQD_ERR_SYNTAX,   MQD_ERR_NOSYSTEM,    MQD_ERR_NOCONNECT,
  MQD_ERR_NOMEMORY, MQD_ERR_PROCESSOVER, MQD_ERR_OPENQUEOVER,
  MQD_ERR_NOQUE,    MQD_ERR_QNAME

queue

　メッセージキューに接続できた場合にはメッセージキュー(MQD_MessageQueue構造体)へのポインタを返します。メッセージキューへのポインタは、後述の各関数の入力パラメタとして使用します。

復帰値

　本関数の処理結果が以下の復帰値で通知されます。

　正常時:　0
　異常時: -1

注意事項

　メッセージキューに接続するためには、MQDを起動し、メッセージキューを作成しておく必要があります。