MessageQueueDirector説明書
目次 索引 前ページ次ページ

第1部 基本機能編> 第8章 プログラムインタフェース> 8.3 C言語インタフェース> 8.3.2 パラメタの詳細説明

8.3.2.1 MQD_QueueAttribute構造体

 MQD_QueueAttribute構造体は、メッセージキューの作成、メッセージキュー属性の設定または参照する場合に使用します。以下にMQD_QueueAttributeの形式を示します。また、内容および入出力関係を表8.16および表8.17に示します。

MQD_QueueAttributeの形式

   
   Typedef struct mqd_queueattribute_t{
     MQDCHAR  qname[64];
     MQDBYTE  guarantee;
     MQDBYTE  reserve0[3];
     MQDLONG  quota;
     MQDLONG  msg_maxlen;
     MQDLONG  default_priority;
     MQDLONG  default_timelimit;
     MQDLONG  reserve1;
     MQDLONG  reserve2;
     MQDLONG  reserve3;
     MQDLONG  reserve4;
     MQDLONG  reserve5;
     MQDLONG  put_status;
     MQDLONG  get_status;
     MQDLONG  num_of_msg;
     MQDLONG  create_timestamp;
     MQDLONG  modify_timestamp:
     MQDLONG  reserve6;
     MQDLONG  reserve7;
     MQDLONG  reserve8;
     MQDLONG  reserve9;
     MQDLONG  reserve10;
   } MQD_QueueAttribute;

[表8.16 MQD_QueueAttributeの内容]

メンバ名

和名

データ型

意味説明

qname

メッセージキュー名

char

メッセージキューの名前です。

guarantee

メッセージ保証
レベル

char

受信メッセージのメッセージ保証レベルです。
MQD_MH_VOLATILE: メモリ型
MQD_MH_NONVOLATILE: ディスク型

quota

最大ディスク容量

long

メッセージキューが利用できる最大ディスク容量です。
本バージョンでは必ず0を指定します。

msg_maxlen

メッセージの最大長

long

メッセージキューに格納できるメッセージデータの最大長です。単位はバイトです。780〜 2097152(2M)バイトの範囲で指定します。メッセージヘッダとメッセージ本体を合計した長さを指定してください。メッセージヘッダは 780バイトの固定長です。

default_
priority

プライオリティの省略値

long

メッセージキューにメッセージを入れる際、メッセージの優先度を省略した場合に使用されます。小さい値ほど優先度が高くなります。

1〜3の値を指定します。

1〜7の値を指定します。

default_
timelimit

最大保存時間の
省略値

long

メッセージキューにメッセージを入れる際、メッセージの最大保存時間を省略した場合に使用されます。本バージョンでは必ず0を指定します。

put_status

送信状態

long

メッセージキューへの送信状態を以下の値で指定します。
0 : 変更なし
MQD_QUE_ACTIVE : 送信可能
MQD_QUE_INHIBIT: 送信禁止
属性通知の場合は上記および以下の値が通知されます。
MQD_QUE_PURGE: 使用禁止

get_status

受信状態

long

メッセージキューからの受信状態を以下の値で指定します。
0 : 変更なし
MQD_QUE_ACTIVE : 受信可能
MQD_QUE_INHIBIT: 受信禁止
属性通知の場合は上記および以下の値が通知されます。
MQD_QUE_PURGE: 使用禁止

num_of_msg

残存メッセージ数

long

メッセージキューに存在するメッセージの数です。

create_
timestamp

メッセージキューの作成日時

long

メッセージキューが作成された日時です。
1970/1/1 00:00:00 UTCからの秒数で表されます。

modify_
timestamp

メッセージキューの最終更新日時

long

メッセージキュー情報が最後に更新された日時です。
1970/1/1 00:00:00 UTCからの秒数で表されます。

[表8.17 MQD_QueueAttributeの入出力]

メンバ名

インタフェース(関数)名

mqd_createq

mqd_setqattr

mqd_getqattr

qname

入力

出力

guarantee

入力

出力

quota

入力

出力

msg_maxlen

入力

出力

default_priority

入力

出力

default_timelimit

入力

出力

put_status

入力

入力

出力

get_status

入力

入力

出力

num_of_msg

出力

出力

create_timestamp

出力

出力

modify_timestamp

出力

出力

入力:入力情報、出力:出力情報、―:無効


目次 索引 前ページ次ページ

All Rights Reserved, Copyright(C) 富士通株式会社 2005