8.2.1.8 MQDPUTMSG (メッセージを送信する)

MessageQueueDirector説明書

目次索引

8.2.1.8 MQDPUTMSG (メッセージを送信する)

機能説明

　メッセージを送信します。

記述形式

----------------------------------------------------------------------------------------
      CALL  "MQDPUTMSG" USING  メッセージキューアドレス格納域名,
            ユニットフラグ格納域名, メッセージヘッダ域名, メッセージ本体域名,
            復帰情報域名, 復帰値格納域名
----------------------------------------------------------------------------------------

パラメタ

メッセージキューアドレス格納域: POINTER

　MQDCONNECTQプログラムから通知されたメッセージキューアドレスをそのまま指定します。

ユニットフラグ格納域: PIC 9(5) COMP-5

　ユニット内のメッセージの位置を指定します。

　1:　ユニットの終了。一つのメッセージを一つのユニットで送信する場合に指定します。また、複数のメッセージを一つのユニットで送信する場合には、ユニット内の最後のメッセージを送信する際に指定します。
　2:　ユニットの途中。複数のメッセージを一つのユニットで送信する場合は、ユニット内の先頭および途中のメッセージを送信する際に指定します。

メッセージヘッダ域

　メッセージヘッダの領域を指定します。事前にメッセージヘッダを作成しておく必要があります。メッセージヘッダの詳細については、“8.2.2 パラメタの詳細説明”を参照してください。

メッセージ本体域

　メッセージ本体の領域を指定します。事前にメッセージ本体を作成しておく必要があります。メッセージ本体の詳細については、“8.2.2 パラメタの詳細説明”を参照してください。

復帰情報域

　例外処理のための復帰情報が通知されます。エラー詳細コードには以下の値(10進数)が返されます。復帰情報の詳細については、“8.4 復帰情報の説明”を参照してください。

   16 (SYNTAX),         18 (NOSYSTEM),     19 (NOCONNECT),       21 (INVALIDAPI),
   22 (NOCONNECTQUE),   25 (DOWNRCV),      30 (BACKOUT),         32 (IO),
   33 (NOMEMORY),       34 (NODISK),       36 (PROCESSOVER),     39 (TRANFILE),
   40 (MSGFILE),        51 (UNITMSGOVER),  52 (UNITSUMOVER),     66 (NOQUE),
   69 (LONGMSG),        72 (QUEWINHIBIT),  74 (PURGEMSG),       113 (QNAME),
  114 (MSGNAME),       131 (PRIORITY),    132 (TIMELIMIT),      135 (MSGBODYLENGTH), 
  136 (ACCESSRIGHT),   148 (UNITFLAG)

   16 (SYNTAX),         18 (NOSYSTEM),      19 (NOCONNECT),    21 (INVALIDAPI),
   22 (NOCONNECTQUE),   25 (DOWNRCV),       30 (BACKOUT),      31 (OTHERTHR), 
   32 (IO),             33 (NOMEMORY),      34 (NODISK),       36 (PROCESSOVER),
   39 (TRANFILE),       40 (MSGFILE),       51 (UNITMSGOVER),  52 (UNITSUMOVER),
   66 (NOQUE),          69 (LONGMSG),       72 (QUEWINHIBIT),  74 (PURGEMSG),
  113 (QNAME),         114 (MSGNAME),      131 (PRIORITY),    132 (TIMELIMIT),
  135 (MSGBODYLENGTH), 136 (ACCESSRIGHT),  148 (UNITFLAG)

復帰値格納域: PIC S9(5) COMP-5

　本プログラムの処理結果が通知されます。詳細は復帰値の説明を参照してください。

復帰値

　本プログラムの処理結果が、復帰値格納域と特殊レジスタ“PROGRAM-STATUS”で以下のように通知されます。

　正常時:　0
　異常時: -1

注意事項

　一つのアプリケーションから複数のメッセージキューに対して送信する場合は、必ずメッセージキューごとにユニット内の全メッセージを送信するようにしてください。

　エラー詳細コード“31”は、Symfoware/RDBトランザクション連携機能を使用している場合に限り通知されます。

目次索引