機能説明
当該アプリケーションを複数のメッセージキューに接続します。
記述形式
CALL "MQDCONNECTQEX" USING MQDシステム情報アドレス格納域名, メッセージキュー名一覧域名, 個数格納域名, エラーメッセージキュー番号格納域名, 復帰情報域名, メッセージキューグループアドレス格納域名, 復帰値格納域名
パラメタ
MQDCONNECTプログラムから通知されたMQDシステム情報アドレスをそのまま指定します。
接続するメッセージキュー名の一覧を設定します。メッセージキュー名は、メッセージキューを作成したときに指定したメッセージキューの名前です。個数格納域で指定した分の領域を用意する必要があります。メッセージキュー名一覧の詳細については、“8.2.29 パラメタの詳細説明”を参照してください。
接続するメッセージキューの個数を指定します。
異常が発生したメッセージキューの番号が通知されます。番号は、メッセージキュー名一覧の出現番号で、以下のように通知されます。
正数：異常が発生したメッセージキューの出現番号（先頭は1）
-1 ：メッセージキューに関係なく異常復帰した場合
例外処理のための復帰情報が通知されます。エラー詳細コードには以下の値(10進数)が返されます。復帰情報の詳細については、“8.4 復帰情報の説明”を参照してください。
16 (SYNTAX)
18 (NOSYSTEM)
21 (INVALIDAPI)
49 (OPENQUEOVER)
66 (NOQUE)
75 (QUEUSE)
113 (QNAME)
19 (NOCONNECT)
33 (NOMEMORY)
36 (PROCESSOVER)
メッセージキューグループのアドレスが通知されます。メッセージキューグループは、メッセージキュー名一覧で指定した複数のメッセージキューを管理するものです。メッセージキューグループのアドレスは、後述のMQDDISCONNECTQEX、MQDGETMSGEX、MQDPEEKMSGEX、MQDSEEKMSGEXの各プログラムの入力パラメタとして使用します。
本プログラムの処理結果が通知されます。詳細は復帰値の説明を参照してください。
復帰値
本プログラムの処理結果が、復帰値格納域と特殊レジスタ“PROGRAM-STATUS”で以下のように通知されます。
正常時:0
異常時: -1
注意事項
メッセージキューに接続するためには、MQDを起動し、メッセージキューを作成しておく必要があります。
本プログラムが異常復帰した場合は、メッセージキュー名一覧で指定したすべてのメッセージキューから切断します。
本プログラムを、1つのスレッドで複数呼び出すことはできません。
