WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 Operating Systems: Linux, Windows

XMSFactoryFactory

If an application is not using administered objects, use this class to create connection factories, queues and topics.

Inheritance hierarchy:
None

.NET properties

Summary of .NET properties:
.NET property Description
MetaData Get the metadata that is appropriate to the connection type of the XMSFactoryFactory object.

MetaData – Retrieve MetaData

Interface:
IConnectionMetaData MetaData

Get the metadata that is appropriate to the connection type of the XMSFactoryFactory object.

Exceptions:
None

Methods

Summary of methods:
Method Description
CreateConnectionFactory Create a ConnectionFactory object of the declared type.
CreateQueue Create a Destination object to represent a queue in the messaging server.
CreateTopic Create a Destination object to represent a topic.
GetInstance Create an instance of XMSFactoryFactory. An XMS application uses an XMSFactoryFactory object to get a reference to a ConnectionFactory object that is appropriate to the required type of protocol. This ConnectionFactory object can then only produce connections for that protocol type.

CreateConnectionFactory - Create Connection Factory

Interface:
IConnectionFactory CreateConnectionFactory();

Create a ConnectionFactory object of the declared type.

Parameters:
None
Returns:
The ConnectionFactory object.
Exceptions:
  • XMSException

CreateQueue – Create Queue

Interface:
IDestination CreateQueue(String name);

Create a Destination object to represent a queue in the messaging server.

This method does not create the queue in the messaging server. You must create the queue before an application can call this method.

Parameters:
name (input)
A String object encapsulating the name of the queue, or encapsulating a uniform resource identifier (URI) that identifies the queue.
Returns:
The Destination object representing the queue.
Exceptions:
  • XMSException

CreateTopic – Create Topic

Interface:
IDestination CreateTopic(String name);

Create a Destination object to represent a topic.

Parameters:
name (input)
A String object encapsulating the name of the topic, or encapsulating a uniform resource identifier (URI) that identifies the topic.
Returns:
The Destination object representing the topic.
Exceptions:
  • XMSException

GetInstance - Get an instance of XMSFactoryFactory

Interface:
static XMSFactoryFactory GetInstance(int connectionType);

Create an instance of XMSFactoryFactory. An XMS application uses an XMSFactoryFactory object to get a reference to a ConnectionFactory object that is appropriate to the required type of protocol. This ConnectionFactory object can then only produce connections for that protocol type.

Parameters:
connectionType (input)
The type of connection for which the ConnectionFactory object will produce connections:
  • XMSC.CT_WPM
  • XMSC.CT_RTT
  • XMSC.CT_WMQ
Returns:
The XMSFactoryFactory object dedicated to the declared connection type.
Exceptions:
  • NotSupportedException

Reference topic

Terms of Use | Rate this page

Last updated: 7 Dec 2005

© Copyright IBM Corporation 2005. All Rights Reserved.