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

機能説明

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

記述形式

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

パラメタ

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

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

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

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

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

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

復帰情報域

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

16 (SYNTAX)
18 (NOSYSTEM)
19 (NOCONNECT)
21 (INVALIDAPI)
22 (NOCONNECTQUE)
25 (DOWNRCV)
29 (DEADLOCK)
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)

31 (OTHERTHR)

復帰値格納域: PIC S9(5) COMP-5: 本プログラムの処理結果が通知されます。詳細は復帰値の説明を参照してください。

復帰値

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

正常時:0
異常時: -1

注意事項

一つのアプリケーションから複数のメッセージキューに対して送信する場合は、必ずメッセージキューごとにユニット内の全メッセージを送信するようにしてください。
エラー詳細コード“29”は、メッセージ格納ファイルとしてデータベースを使用している場合に限り通知されます。

エラー詳細コード“31”は、MQDCONNECTRDBプログラムを使用してMQDに接続している場合に限り通知されます。