MQManagedObject.NET クラス

MQManagedObject を使用して、MQDestination、MQProcess、MQQueueManager、および MQSubscription の属性を照会、設定します。 MQManagedObject は、これらのクラスのスーパークラスです。

クラス

System.Object
        |
        └─ IBM.WMQ.MQBase
                |
                └─ IBM.WMQ.MQBaseObject
                        |
                        └─ IBM.WMQ.MQManagedObject
                                |
                                └─ IBM.WMQ.MQProcess
                                |
                                └─ IBM.WMQ.MQQueueManager
                                |
                                └─ IBM.WMQ.MQSubscription
                                |
                                └─ IBM.WMQ.MQDestination

public class IBM.WMQ.MQManagedObject extends IBM.WMQ.MQBaseObject;

プロパティー
方式
コンストラクター

プロパティー

プロパティーの取得時にスローされた MQException をテストします。

public string AlternateUserId {get; set;}

リソースのオープン時に設定された代替ユーザー ID (もしあれば)。 AlternateUserID.set は、オープンしているオブジェクトに対して出される場合は無視されます。 AlternateUserId は、サブスクリプションには無効です。

public int CloseOptions {get; set;}

この属性は、リソースのクローズ方法を制御するために設定します。デフォルト値は MQC.MQCO_NONEです。 MQC.MQCO_NONE は、永続動的キュー、一時動的キュー、サブスクリプション、およびそれらを作成したオブジェクトによってアクセスされているトピック以外のすべてのリソースに対して許可される唯一の値です。

キューおよびトピックの場合、以下の追加値を指定できます。

MQC.MQCO_DELETE: メッセージがない場合は、キューを削除します。
MQC.MQCO_DELETE_PURGE: キューを削除し、そこに入っているすべてのメッセージを除去します。
MQC.MQCO_QUIESCE: キューをクローズし、残っているメッセージがあれば警告を受け取ることを要求します (最終クローズの前にメッセージを取り出すことが可能になります)。

サブスクリプションの場合、以下の追加値を指定できます。

MQC.MQCO_KEEP_SUB: サブスクリプションは削除されません。このオプションは、元のサブスクリプションが永続的である場合のみに有効です。 MQC.MQCO_KEEP_SUB は、永続的トピックのデフォルト値です。
MQC.MQCO_REMOVE_SUB: サブスクリプションは削除されます。 MQC.MQCO_REMOVE_SUB は、非永続的な非管理トピックのデフォルト値です。
MQC.MQCO_PURGE_SUB: サブスクリプションは削除されます。 MQC.MQCO_PURGE_SUB は、非永続的な管理トピックのデフォルト値です。

public MQQueueManager ConnectionReference {get;}

このリソースが属しているキュー・マネージャー。

public string MQDescription {get;}

キュー・マネージャーによって保持されるリソースの説明。サブスクリプションおよびトピックの場合、MQDescription は空ストリングを返します。

public boolean IsOpen {get;}

リソースが現在オープンしているかどうかを示します。

public string Name {get;}

リソースの名前。この名前は、アクセス方式で指定されたものか、キュー・マネージャーによって動的キューに割り振られたものかのいずれかです。

public int OpenOptions {get; set;}

OpenOptions は、 IBM MQ オブジェクトが開かれるときに設定されます。 OpenOptions.set メソッドは無視されるので、エラーは起こりません。サブスクリプションには OpenOptionsがありません。

方法

public virtual void Close();

MQException をスローします。

オブジェクトをクローズします。 Close を呼び出した後、このリソースに対してさらに操作を行うことは許可されません。 Close メソッドの動作を変更するには、closeOptions 属性を設定します。

public string GetAttributeString(int selector, int length);

MQException をスローします。

属性ストリングを取得します。

selector: 照会する属性を示す整数。
length: 必要なストリングの長さを示す整数。

public void Inquire(int[] selectors, int[] intAttrs, byte[] charAttrs);

MQException をスローします。

キュー、プロセス、またはキュー・マネージャーの属性が入っている整数の配列と一連の文字ストリングを返します。照会する属性は、セレクター配列で指定します。

注: より一般的な属性の多くは、 MQManagedObject、 MQQueue 、および MQQueueManagerで定義されている Get メソッドを使用して照会できます。

selectors: 照会する値を持つ属性を指定する整数の配列。
intAttrs: 整数属性値が戻される配列。整数属性値は、セレクター配列の整数属性セレクターと同じ順序で戻されます。
charAttrs: 文字属性が連結されて戻されるバッファー。文字属性は、セレクター配列の文字属性セレクターと同じ順序で戻されます。各属性ストリングの長さは、属性ごとに固定されています。

public void Set(int[] selectors, int[] intAttrs, byte[] charAttrs);

MQException をスローします。

セレクターのベクトルで定義されている属性を設定します。設定する属性は、セレクター配列で指定します。

selectors: 設定する値を持つ属性を指定する整数の配列。
intAttrs: 設定する整数属性値の配列。これらの値は、セレクター配列の整数属性セレクターと同じ順序にする必要があります。
charAttrs: 設定する文字属性が連結されるバッファー。これらの値は、セレクター配列の文字属性セレクターと同じ順序にする必要があります。各文字属性の長さは固定されています。

public void SetAttributeString(int selector, string value, int length);

MQException をスローします。

属性ストリングを設定します。

selector: 設定する属性を示す整数。
value: 属性値として設定するストリング。
length: 必要なストリングの長さを示す整数。

コンストラクター

protected MQManagedObject(): コンストラクター・メソッド。このオブジェクトは、単独ではインスタンス化できない抽象基本クラスです。