Message Queue, v4.4 API Specification

## Package com.sun.messaging.jms

Provides additional Sun GlassFish(tm) Message Queue classes for features that relate to the MQ implementation of the Java Message Service (JMS).

See:
Description

Interface Summary
Connection: This interafce provides the following API for the MQ applications:
Message: The `com.sun.messaging.jms.Message` interface defines enhanced capabilities of a JMS Message in Sun GlassFish(tm) Message Queue.
QueueConnection: Provide interface to create a MQ NO_ACKNOWLEDGE queue session.
Session: MQ JMS Session.
TopicConnection: Provide interface to create a MQ NO_ACKNOWLEDGE Topic Session.

Exception Summary
IllegalStateException: This exception is thrown when a method is invoked at an illegal or inappropriate time or if the provider is not in an appropriate state for the requested operation.
InvalidClientIDException: This exception must be thrown when a client attempts to set a connection's client ID to a value that is rejected by a provider.
InvalidDestinationException: This exception must be thrown when a destination either is not understood by a provider or is no longer valid.
InvalidSelectorException: This exception must be thrown when a JMS client attempts to give a provider a message selector with invalid syntax.
JMSException: This class encapsulates MQ JMSExceptions.
JMSSecurityException: This exception must be thrown when a provider rejects a user name/password submitted by a client.
MessageEOFException: This exception must be thrown when an unexpected end of stream has been reached when a `StreamMessage` or `BytesMessage` is being read.
MessageFormatException: This exception must be thrown when a JMS client attempts to use a data type not supported by a message or attempts to read data in a message as the wrong type.
MessageNotReadableException: This exception must be thrown when a JMS client attempts to read a write-only message.
MessageNotWriteableException: This exception must be thrown when a JMS client attempts to write to a read-only message.
ResourceAllocationException: This exception is thrown when a provider is unable to allocate the resources required by a method.
TransactionInProgressException: This exception is thrown when an operation is invalid because a transaction is in progress.
TransactionRolledBackException: This exception must be thrown when a call to `Session.commit` results in a rollback of the current transaction.

## Package com.sun.messaging.jms Description

Provides additional Sun GlassFish(tm) Message Queue classes for features that relate to the MQ implementation of the Java Message Service (JMS).

Sun GlassFish(tm) System MQ classes in this package fall into the following basic categories:

- Custom messaging functionality that is available when standard JMS objects are cast using the interfaces in `com.sun.messaging.jms`.
- Enhanced exception classes that enable the application finer grained error handling than JMS exceptions.

### Custom Messaging Functionality

Sun GlassFish(tm) Message Queue provides custom message acknowledgment functionality that allows an application to acknowledge consumed messages in a `CLIENT-ACKNOWLEDGE` session with finer grained control than that available in the Java Message Service Specification.

### Enhanced exception classes

Sun GlassFish(tm) Message Queue provides exception classes that enable MQ JMS clients to perform finer grained error handling than that available with standard JMS exceptions.

See Also:
  `javax.jms`

Message Queue, v4.4 API Specification

Copyright 2009 Sun Microsystems, Inc.
4150 Network Circle, Santa Clara, CA 95054, U.S.A. All Rights Reserved.