34/37

# B Stability of Message Queue Interfaces

Message Queue uses many interfaces that can help administrators automate tasks. This appendix classifies the interfaces according to their stability. The more stable an interface is, the less likely it is to change in subsequent versions of the product.

Any interface that is not listed in this appendix is private and not for customer use.

## Classification Scheme

Table B-1 describes the stability classification scheme.

Table B-1 Interface Stability Classification Scheme

Classification | Description
--- | ---
Private | Not for direct use by customers. May change or be removed in any release.
Evolving | For use by customers. Subject to incompatible change at a major (e.g. 3.0, 4.0) or minor (e.g. 3.1, 3.2) release. The changes will be made carefully and slowly. Reasonable efforts will be made to ensure that all changes are compatible but that is not guaranteed.
Stable | For use by customers. Subject to incompatible change at a major (for example, 3.0 or 4.0) release only.
Standard | For use by customers. These interfaces are defined by a formal standard, and controlled by a standards organization. Incompatible changes to these interfaces are rare.
Unstable | For use by customers. Subject to incompatible change at a major (e.g. 3.0, 4.0) or minor (e.g. 3.1, 3.2) release. Customers are advised that these interfaces may be removed or changed substantially and in an incompatible way in a future release. It is recommended that customers not create explicit dependencies on unstable interfaces.

## Interface Stability

Table B-2 lists the interfaces and their classifications.

Table B-2 Stability of Message Queue Interfaces

Interface | Classification
--- | ---
Command Line Interfaces |
`imqbrokerd` command line interface | Evolving
`imqadmin` command line interface | Unstable
`imqcmd` command line interface | Evolving
`imqdbmgr` command line interface | Unstable
`imqkeytool` command line interface | Evolving
`imqobjmgr` command line interface | Evolving
`imqusermgr` command line interface | Unstable
`imqbridgemgr` command line interface | Evolving
Output from `imqbrokerd`, `imqadmin`, `imqcmd`, `imqdbmgr`, `imqkeytool`, `imqobjmgr`, `imqusermgr` | Unstable
Commands |
`imqobjmgr` command file | Evolving
`imqbrokerd` command | Stable
`imqadmin` command | Unstable
`imqcmd` command | Stable
`imqdbmgr` command | Unstable
`imqkeytool` command | Stable
`imqobjmgr` command | Stable
`imqusermgr` command | Unstable
`imqbridgemgr` command | Evolving
APIs |
JMS API (`javax.jms`) | Standard
JAXM API (`javax.xml`) | Standard
C-API | Evolving
C-API environment variables | Unstable
Message-based monitoring API | Evolving
Administered Object API (`com.sun.messaging`) | Evolving
.jar and .war Files |
`imq.jar` location and name | Stable
`jms.jar` location and name | Evolving
`imqbroker.jar` location and name | Private
i`mqutil.jar` location and name | Private
`imqadmin.jar` location and name | Private
`imqservlet.jar` location and name | Evolving
`imqhttp.war` location and name | Evolving
`imqhttps.war` location and name | Evolving
`imqjmsra.rar` location and name | Evolving
`imqxm.jar` location and name | Evolving
`jaxm-api.jar` location and name | Evolving
`saaj-api.jar` location and name | Evolving
`saaj-impl.jar` location and name | Evolving
`activation.jar` location and name | Evolving
`mail.jar` location and name | Evolving
`dom4j.jar` location and name | Private
`fscontext.jar` location and name | Unstable
Files |
Broker log file location and content format | Unstable
password file | Unstable
`accesscontrol.properties` file | Unstable
System Destinations |
`mq.sys.dmq` destination | Stable
`mq.metrics.*` destinations | Evolving
Configuration Properties |
Message Queue JMS Resource Adapter configuration properties | Evolving
Message Queue JMS Resource Adapter JavaBean and ActivationSpec configuration properties | Evolving
Message Properties and Formats |
Dead message queue message property, `JMSXDeliveryCount` | Standard
Dead message queue message properties, `JMS_SUN_*` | Evolving
Message Queue client message properties: `JMS_SUN_*` | Evolving
JMS message format for metrics or monitoring messages | Evolving
Miscellaneous |
Message Queue JMS Resource Adapter package, `com.sun.messaging.jms.ra` | Evolving
JDBC schema for storage of persistent messages | Evolving