Sun JavaTM System 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.
Appendix B, Stability of Message Queue Interfaces 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. |
Appendix B, Stability of Message Queue Interfaces 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 |
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 |
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 |
imqutil.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 |