8.3.1.3 mqd_createq (メッセージキューを作成する)

MessageQueueDirector説明書

目次索引

8.3.1.3 mqd_createq (メッセージキューを作成する)

機能説明

　メッセージキューを作成します。

記述形式

---------------------------------------------------------------------------------------
      #include "mqdapi.h"
      int mqd_createq(MQD_System *system, MQD_QueueAttribute *qattribute,
                      MQD_Environment *env)
---------------------------------------------------------------------------------------

パラメタ

system

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

qattribute

　メッセージキュー属性情報へのポインタを指定します。メッセージキュー属性情報(MQD_QueueAttribute構造体)の詳細については、“8.3.2 パラメタの詳細説明”を参照してください。

env

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

  MQD_ERR_SYNTAX,    MQD_ERR_NOSYSTEM,  MQD_ERR_NOCONNECT,
  MQD_ERR_IO,        MQD_ERR_NOMEMORY,  MQD_ERR_NODISK,
  MQD_ERR_MSGFILE,   MQD_ERR_QUEOVER,   MQD_ERR_QUEEXIST,
  MQD_ERR_QNAME,     MQD_ERR_GUARANTEE, MQD_ERR_QUOTA,
  MQD_ERR_MSGMAXLEN, MQD_ERR_PRIORITY,  MQD_ERR_TIMELIMIT,
  MQD_ERR_PUTSTATUS, MQD_ERR_GETSTATUS

  MQD_ERR_SYNTAX,     MQD_ERR_NOSYSTEM,  MQD_ERR_NOCONNECT,
  MQD_ERR_INVALIDAPI, MQD_ERR_IO,        MQD_ERR_NOMEMORY,
  MQD_ERR_NODISK,     MQD_ERR_MSGFILE,   MQD_ERR_QUEOVER,
  MQD_ERR_QUEEXIST,   MQD_ERR_QNAME,     MQD_ERR_GUARANTEE,
  MQD_ERR_QUOTA,      MQD_ERR_MSGMAXLEN, MQD_ERR_PRIORITY,
  MQD_ERR_TIMELIMIT,  MQD_ERR_PUTSTATUS, MQD_ERR_GETSTATUS

復帰値

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

　正常時:　0
　異常時: -1

注意事項

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

　当該アプリケーションがSymfoware/RDBトランザクション連携機能を使用している場合、本関数はエラー詳細コード“MQD_ERR_INVALIDAPI”で復帰します。

目次索引