8.3.2 mqd_connect (MQDに接続する)

機能説明

当該アプリケーションをMQDに接続します。

記述形式

---------------------------------------------------------------------------------------
      #include "mqdapi.h"
      int mqd_connect(char *sysname, MQD_Environment *env, MQD_System **system)
---------------------------------------------------------------------------------------

パラメタ

sysname

MQDシステム名へのポインタを指定します。MQDシステム名は、mqdsetupコマンドを実行したときに指定したMQDのシステム環境の名前です。

env

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

  MQD_ERR_SYNTAX,      MQD_ERR_NOENV,      MQD_ERR_NOSYSTEM,
  MQD_ERR_CONNECTED,   MQD_ERR_IO,         MQD_ERR_NOMEMORY,
  MQD_ERR_PROCESSOVER, MQD_ERR_ACCESSDENY, MQD_ERR_SYSNAME

  MQD_ERR_SYNTAX,      MQD_ERR_NOENV,       MQD_ERR_NOSYSTEM,
  MQD_ERR_INVALIDAPI,  MQD_ERR_CONNECTED,   MQD_ERR_IO,
  MQD_ERR_NOMEMORY,    MQD_ERR_PROCESSOVER, MQD_ERR_ACCESSDENY,
  MQD_ERR_SYSNAME

system

MQDに接続した場合にはMQDシステム情報(MQD_System構造体)へのポインタを返します。MQDシステム情報へのポインタは、後述の各関数の入力パラメタとして使用します。

復帰値

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

正常時: 0
異常時: -1

注意事項

MQDに接続するためにはMQDを起動しておく必要があります。
マルチスレッドのアプリケーションでMQDのプログラムインターフェイスを使用する場合には、MQDのプログラムインターフェイスを使用するスレッドでそれぞれmqd_connectを実行する必要があります。
MQDを利用するアプリケーションとJava言語で作成したアプリケーションを連携する場合、以下の制限があります。本制限を厳守しなかった場合、MQDシステムが異常終了するなどの事象が発生します。システムプログラムの動作保証外となりますので注意してください。
- Java言語で作成したアプリケーションからMQDを利用するアプリケーションをJNI経由で利用することはできません。
- Java言語で作成したアプリケーションと同じプロセスでMQDのアプリケーションインタフェースを利用することはできません。
- Java言語で作成したアプリケーションから非同期通信機能を利用する場合は、“Interstage JMS”を利用してください。“Interstage JMS”の詳細は、“J2EEユーザーズガイド”を参照してください。

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