8.2.14 MQDPURGEMSG (メッセージを一括削除する)

機能説明

メッセージキューに存在するすべてのメッセージを削除します。

記述形式

----------------------------------------------------------------------------------------
      CALL  "MQDPURGEMSG" USING  メッセージキューアドレス格納域名, 復帰情報域名,
                                 復帰値格納域名
----------------------------------------------------------------------------------------

パラメタ

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

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

復帰情報域

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

  16 (SYNTAX),      18 (NOSYSTEM), 19 (NOCONNECT), 22 (NOCONNECTQUE),
  23 (ONTRAN),      25 (DOWNRCV),  32 (IO),        33 (NOMEMORY),
  36 (PROCESSOVER), 39 (TRANFILE), 40 (MSGFILE),   66 (NOQUE),
  71 (MSGEXIST),    74 (PURGEMSG)

  16 (SYNTAX),       18 (NOSYSTEM),    19 (NOCONNECT), 21 (INVALIDAPI),
  22 (NOCONNECTQUE), 23 (ONTRAN),      25 (DOWNRCV),   32 (IO),
  33 (NOMEMORY),     36 (PROCESSOVER), 39 (TRANFILE),  40 (MSGFILE),
  66 (NOQUE),        71 (MSGEXIST),    74 (PURGEMSG)

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

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

復帰値

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

正常時: 0
異常時: -1

注意事項

メッセージを一括削除する場合には、いくつかの注意すべき事項があります。詳細については、“2.2.7 メッセージの一括削除”を参照してください。

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