From sacadmin Wed Oct 22 13:06:20 2008 Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m9MK6KAs002397; Wed, 22 Oct 2008 13:06:20 -0700 (PDT) Received: (from racer1@localhost) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit) id m9MK6KHt002393; Wed, 22 Oct 2008 13:06:20 -0700 (PDT) Date: Wed, 22 Oct 2008 13:06:20 -0700 (PDT) From: Linda Schneider Message-Id: <200810222006.m9MK6KHt002393@sac.sfbay.sun.com> To: LSARC-record@sac.sfbay.sun.com Subject: OpenMQ/SJSMQ 4.3 (Robin) [LSARC/2008/648 FastTrack timeout 10/28/2008] Status: RO Content-Length: 187 I'm sponsering the following proposal for fast-track approval. The timer is set for 10/28/2008. Proposed release binding is minor. See: http://sac.sfbay/arc/LSARC/2008/648/robin.html From Linda.Schneider@Sun.COM Wed Oct 22 21:07:09 2008 Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m9N479Nt016778 for ; Wed, 22 Oct 2008 21:07:09 -0700 (PDT) Received: from sca-es-mail-2.sun.com (sca-es-mail-2.Sun.COM [192.18.43.133]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m9N479Bm060029 for ; Wed, 22 Oct 2008 21:07:09 -0700 (PDT) Received: from fe-sfbay-09.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m9N473IZ009252 for ; Wed, 22 Oct 2008 21:07:03 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K9600H01BF6Z300@fe-sfbay-09.sun.com> (original mail from Linda.Schneider@Sun.COM) for LSARC-ext@sac.sfbay.sun.com; Wed, 22 Oct 2008 21:07:03 -0700 (PDT) Received: from linda-schneiders-computer.local ([129.150.17.190]) by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K96001NXBFQJGC0@fe-sfbay-09.sun.com> for LSARC-ext@sac.sfbay.sun.com; Wed, 22 Oct 2008 21:07:03 -0700 (PDT) Date: Wed, 22 Oct 2008 21:06:50 -0700 From: Linda Schneider Subject: OpenMQ/SJSMQ 4.3 (Robin) [LSARC/2008/648 FastTrack timeout 10/28/2008] Sender: Linda.Schneider@Sun.COM To: LSARC-ext@sac.sfbay.sun.com Message-id: <48FFF85A.3080701@sun.com> MIME-version: 1.0 Content-type: multipart/mixed; boundary="Boundary_(ID_ocaGdeqbZ61qk7bm9pNe9w)" User-Agent: Thunderbird 2.0.0.17 (Macintosh/20080914) Status: RO Content-Length: 110072 This is a multi-part message in MIME format. --Boundary_(ID_ocaGdeqbZ61qk7bm9pNe9w) Content-type: multipart/alternative; boundary="Boundary_(ID_dcTXJunrvBy2ndE6J3TqvQ)" --Boundary_(ID_dcTXJunrvBy2ndE6J3TqvQ) Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT I'm sponsoring the following proposal for fast-track approval. The timer is set for 10/28/2008. Proposed release binding is minor. Fastrack content is [now] included below (it will look better if viewed as html) The attached zip file [additional.zip] contains copies of the functional specs referenced in this document. The document (and related files) is also available at: http://sac.sfbay/arc/LSARC/2008/648/robin.html ------------------------------------------------------------------------ FastTrack: /OpenMQ / Sun Java System Message Queue 4.3 (Robin)/ Sponsor: /Linda Schneider/ Release Binding: / Minor/ This is a FastTrack request for minor interface changes in Open Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). Robin is a maintenance release to Message Queue 4.2 (LSARC/2008/387) . It includes bug fixes and a small number of minor enhancements. This FastTrack adds modifies several committed and uncommitted exported interfaces and adds two new imported interfaces. It does not change the classification or remove any existing interface. Overview of Changes Several changes were added to 4.3 which impact the product's interface: * A REST style API was added to allow messages to be produced or consumed to the MQ provider * A new bundling and layout scheme was added to support the product installed by our new Zip based installer (which will also be used in future releases for IPS packages) * Minor administration changes * Minor modifications to the windows installer * Addition of a command to make it easier to locate the uninstaller on the OpenMQ packages. _Public interface changes_ 1. /*New Exported Interfaces*/: Creation of the Universal Message Service (UMS) API: * The UMS Protocol <#umsproto> used by applications to connect to the service. * The UMS Configuration <#umsconfig> which contains the set of configuration parameters for the service. * A new war file (imqums.war) containing the servlet required by UMS. 2. /*New Exported Interface*/: Creation of a the new filesystem layout for use by the new packages. This layout will also be used for our new install bundles specifically: * Our OpenMQ product * Our AIX product (the platform is new to 4.3) No changes have been made to our existing packages used in earlier releases. (They will still use the old filesystem laytout) 3. /*New Exported Interface*/: A new uninstall bat/shell script has been added as a shortcut for uninstalling the openMQ-only release. 4. /*Modified Exported Interface*/: Minor changes have been made to JMX to add additional information for destinations and consumers. 5. */New Imported Interfaces/*: Installation of the product on windows (both for SJSMQ and OpenMQ) now uses Java registry keys as a fallback to locate a JRE to use to start the installer. _Private interface changess_ Additional changes have been made to private interfaces: 1. */Modified Interface/*: Output of imqcmd. This interface is Uncommitted. Descriptions of Changes *_Universal Message Service (UMS)_* - a REST style API The Universal Message Service is a simple REST based API that allows any HTTP capable device to access Message Queue. This allows clients written in languages such as c-sharp and phython to send and receive messages. A new web component (imqums.war) can be deployed on any web container. That component serves as a bridge between the ums client and the JMS provider. The ums client sends the ums protocol (which uses http posts) to connect to the imqums service. That service uses standard JMS apis to connect to the MQ server (the broker). [High level Diagram of UMS] _Client->web component protocol_ The protocol has two types of messages service requests (messages sent to the messaging system) and service responses (responses received from the messaging system). There are also two services (XML and basic text) which are provided in this release. The API supports the following commands: * _login_ logs into the system and creates a UMS session (note: the password must be sent in plaintext since it is going as part of the http command line, however use of SSL is recommended). * _send_ Sends a message (which will become a JMS message) to MQ. * _receive_ Receive a message from MQ. * _commit_ Commit a transaction (provided the UMS session is transacted). * _rollback_ Rollback a transaction. (provided the UMS session is transacted). * _close_ Close the UMS session. All messages are request/response: /Service Requests/ The http POST method is used for all interaction with the UMS. Each protocol message is represented with the following syntax: /http://host:port//[?];/ Where: * /ums_conext-root/: the location where the WAR file was deployed * /simple/: the type of service used (simple or XML) * /query_string/: used for the simple service. Provides a set of name value pairs separated by & which specify information such as the service type, messaging domain, and destination name For the Messages: * For XML messages, the body contains the command information in XML format * For the simple service, the body is empty (since the protocol information in in the URL) /Service Responses/ For the XML service, the body of the HTTP request returns a SOAP message containing return information. For the simple message service, the body of the message may contain some specific return information. Lower level details of the Protocol are found in the UMS Protocol description . _UMS configuration_ When the war file is deployed, several configuration options are available for the servlet including password to be used to the broker, how often to poll for messages and the broker address. Specific configuration parameters are found in the UMS Configuration specification . *_Filesystem layout and packaging change_* - support for new packages which can handle multi-install In MQ 4.3 we are adding a new zip based packaging bundle. In the following release (Crane), we will be replacing the zip bundles for IPS packages. This layout is the one we will be using for going forward for all future unbundled products (either zip based or IPS). *Note:* Our current SVR4 or Linux RPM based packaging is unaffected by these changes. MQ's filesystem will be laid out following the JES Filesystem Layout for Unbundled Software . || | |-------- etc | | | |-mq [MQ etc files] | |-------- var | | | |- install [contains installer information] | | | |-mq [used by the server for storing data] | |-------- mq | |-------- bin [MQ executables] | | | | | |- sparcv9 (amd64) [64 bit solaris executables] | | | |-------- lib [MQ jar files and libraries] | | | | | |- sparcv9 (amd64) [64 bit libraries for the MQ C API] | | | |-------- include [C-API file system headers] | | | |-------- lib64 [note: linux libs used instead of sparcv9] | | | |-------- examples [demos] | |-------- install | |- open installer implementation and jar files For more details and specific locations for each file installed by MQ see the MQ 4.3 Filesystem and Packaging specification . *_mquninstall[.bat]_* - script to improve uninstall experience The installer places the script to uninstall the product in: //var/install/contents/mq/uninstaller/ A low level install script (used by the mq installer) is located at: //install/bin/uninstaller/ While we do document the location of the uninstaller, it is difficult to find and users often attempt to uninstall with the wrong uninstaller executable. For this release, we are adding a new script (or bat file) called /mquninstall/ that is being placed in the //mq/bin/ directory. This will will only be in OpenMQ bundles for this release (it will not be available in package based installs). *_JMX Administration API changes_ * - minimal JMX attribute and CompositeData changes The following changes will be made to the JMX monitoring api: * A new attribute NextMessageID will be added to consumers and destinations * A new attribute NumMsgsPending to consumers The specific changes are: * DestinationMonitorMBean *New Attributes:* Name Set/Get Type Description NextMessageID G String JMS Message Id of the next message to be sent to any consumer * ConsumerMonitorMBean: *new Keys for Composite Data* Key Value Type Description NextMessageID String JMS Message Id of the next message to be sent to this consumer NumMsgsPending Long The number of messages which have been sent to this consumer but have not been acknowledged. They may either be queued for delivery or delivered to the consumer *_Administration API (imqcmd) output changes_ * - imqcmd output changes for durable subscribers *Note: the output returned from this application has a classification of uncommitted.* This changes the output of the command imqcmd list dur to list all destinations (and include a directory name) if the -d is omitted. The following examples show the ouptut changes: * Output when listing durables when a destination passed in on the command line. (Unchanged from previous releases) /imqcmd list dur -d mydest / || Listing all durable subscriptions on the topic 'mydest' on the broker specified by: ------------------------- Host Primary Port ------------------------- localhost 7676 --------------------------------------------------------------------------- Durable Sub. Name Client ID Number of Messages Durable Sub. State - --------------------------------------------------------------------------- mydn mycid 0 INACTIVE - Successfully listed durable subscriptions. * Output when listing durables when a destination is not provided on the command line (adds new column DestinationName) /imqcmd list dur -- listing all destinations/ | Listing all durable subscriptions ------------------------- Host Primary Port ------------------------- localhost 7676 ------------------------------------------------------------------------------------------ Durable Sub. Name Client ID *Destination Name* Number of Messages Durable Sub. State ------------------------------------------------------------------------------------------ 456 123 **.foo* 0 INACTIVE mydn mycid *mydest* 0 INACTIVE Successfully listed durable subscriptions. | *_Additional Installation Imported interfaces_ * The windows Installer.vbs script now uses the following variables to locate a JRE for the installer: * /HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion/ * /HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\\JavaHome/ During installation, the installer will first attempt to use the jdk (if any) which was passed into the installation script, if no jdk is passed in it will look for a jre installed as part of the bundle, if no jre is found it will look at the keys to find the current JDK and its javahome. *_Additional Logging Messages_ * Some bug fixes require the addition or modification of log messages. No change was made in the format of those messages. Imported/Exported Intefaces *Exported Interfaces* Interface Classification Comments imqcmd Ouput Uncommitted Modifies an existing interface to support listing of all durables including their destination. See specific changes above. MQ MBean Attributes names Committed Modifies an existing interface to add support for NextMessageID method. See specific changes above MQ MBean Lookup keys for CompositeData Committed Modifies an existing interface to add support for NextMessageID method and NumMsgsPending. See specific changes above. Unbundled Filesystem Layout Committed *New Interface.* Creates a new filesystem layout for the product when it is not shipped with native packaging. See the Filesystem Layout specification Broker Log Infomation Uncommitted Modified an existing interface by adding new log messages (no format changes) UMS Protocol Committed *New Interface.* Defines the protocol for the new ums service.See the UMS Protocol Specification UMS Configuration Committed *New Interface.* Defines the configuration properties for the new ums service. See the UMS Configuration Specification imqums.war Committed *New Interface.* Defines the name of the war file used for deploying the new ums service. See specific changes above. /bin/mqunistall[.bat] Committed *New Interface.* A new script file which is available only on the new openMQ bundles that makes it easier for users to find the uninstaller. See specific changes above. *Imported Interfaces* Interface Classification Comments HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion Standard *New Interface* Location of the latest release of the JRE on a windows system. HKLM\SOFTWARE\Java Soft\Java Runtime Environment\\JavaHome Standard *New Interface* Location of the java home for a release of the JRE on a windows system. References *Current Release*: Message Queue 4.3 feature functional specifications: * UMS protocol * UMS configuration specification * MQ Filesystem Layout and packaging specification for Robin *Previous Release*: Message Queue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387 --Boundary_(ID_dcTXJunrvBy2ndE6J3TqvQ) Content-type: multipart/related; boundary="Boundary_(ID_UZlsx0QciJCREbkLKqqGnA)" --Boundary_(ID_UZlsx0QciJCREbkLKqqGnA) Content-type: text/html; charset=ISO-8859-1 Content-transfer-encoding: 7BIT I'm sponsoring the following proposal for fast-track approval. The timer is set for 10/28/2008.

Proposed release binding is minor.

Fastrack content is [now] included below (it will look better if viewed as html)

The attached zip file [additional.zip] contains copies of the functional specs referenced in this document.
The document (and related files) is also available at:  http://sac.sfbay/arc/LSARC/2008/648/robin.html OpenMQ/Sun Java System Message Queue 4.3 (Robin) fast-track

FastTrack: OpenMQ / Sun Java System Message Queue 4.3 (Robin)

Sponsor: Linda Schneider

Release Binding: Minor

This is a FastTrack request for minor interface changes in Open Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). Robin is a maintenance release to Message Queue 4.2 (LSARC/2008/387). It includes bug fixes and a small number of minor enhancements.

This FastTrack adds modifies several committed and uncommitted exported interfaces and adds two new imported interfaces. It does not change the classification or remove any existing interface.

Overview of Changes

Several changes were added to 4.3 which impact the product's interface:

  • A REST style API was added to allow messages to be produced or consumed to the MQ provider
  • A new bundling and layout scheme was added to support the product installed by our new Zip based installer (which will also be used in future releases for IPS packages)
  • Minor administration changes
  • Minor modifications to the windows installer
  • Addition of a command to make it easier to locate the uninstaller on the OpenMQ packages.

Public interface changes

  1. New Exported Interfaces: Creation of the Universal Message Service (UMS) API:
    • The UMS Protocol used by applications to connect to the service.
    • The UMS Configuration which contains the set of configuration parameters for the service.
    • A new war file (imqums.war) containing the servlet required by UMS.
  2. New Exported Interface: Creation of a the new filesystem layout for use by the new packages. This layout will also be used for our new install bundles specifically:
    • Our OpenMQ product
    • Our AIX product (the platform is new to 4.3)
    No changes have been made to our existing packages used in earlier releases. (They will still use the old filesystem laytout)
  3. New Exported Interface: A new uninstall bat/shell script has been added as a shortcut for uninstalling the openMQ-only release.
  4. Modified Exported Interface: Minor changes have been made to JMX to add additional information for destinations and consumers.
  5. New Imported Interfaces: Installation of the product on windows (both for SJSMQ and OpenMQ) now uses Java registry keys as a fallback to locate a JRE to use to start the installer.

Private interface changess

Additional changes have been made to private interfaces:

  1. Modified Interface: Output of imqcmd. This interface is Uncommitted.

Descriptions of Changes

Universal Message Service (UMS) - a REST style API

The Universal Message Service is a simple REST based API that allows any HTTP capable device to access Message Queue. This allows clients written in languages such as c-sharp and phython to send and receive messages.

A new web component (imqums.war) can be deployed on any web container. That component serves as a bridge between the ums client and the JMS provider. The ums client sends the ums protocol (which uses http posts) to connect to the imqums service. That service uses standard JMS apis to connect to the MQ server (the broker).

[High level Diagram of UMS]

Client->web component protocol

The protocol has two types of messages service requests (messages sent to the messaging system) and service responses (responses received from the messaging system). There are also two services (XML and basic text) which are provided in this release.

The API supports the following commands:

  • login logs into the system and creates a UMS session (note: the password must be sent in plaintext since it is going as part of the http command line, however use of SSL is recommended).
  • send Sends a message (which will become a JMS message) to MQ.
  • receive Receive a message from MQ.
  • commit Commit a transaction (provided the UMS session is transacted).
  • rollback Rollback a transaction. (provided the UMS session is transacted).
  • close Close the UMS session.

All messages are request/response:

Service Requests
The http POST method is used for all interaction with the UMS. Each protocol message is represented with the following syntax:

http://host:port/<ums-context-root>/<service>[?<query_string_if_simple>];

Where:

  • ums_conext-root: the location where the WAR file was deployed
  • simple: the type of service used (simple or XML)
  • query_string: used for the simple service. Provides a set of name value pairs separated by & which specify information such as the service type, messaging domain, and destination name
For the Messages:
  • For XML messages, the body contains the command information in XML format
  • For the simple service, the body is empty (since the protocol information in in the URL)

Service Responses

For the XML service, the body of the HTTP request returns a SOAP message containing return information. For the simple message service, the body of the message may contain some specific return information.

Lower level details of the Protocol are found in the UMS Protocol description.

UMS configuration
When the war file is deployed, several configuration options are available for the servlet including password to be used to the broker, how often to poll for messages and the broker address. Specific configuration parameters are found in the UMS Configuration specification.

Filesystem layout and packaging change - support for new packages which can handle multi-install

In MQ 4.3 we are adding a new zip based packaging bundle. In the following release (Crane), we will be replacing the zip bundles for IPS packages. This layout is the one we will be using for going forward for all future unbundled products (either zip based or IPS).

Note: Our current SVR4 or Linux RPM based packaging is unaffected by these changes.

MQ's filesystem will be laid out following the JES Filesystem Layout for Unbundled Software. 

<install_home>
   |
   |-------- etc
   |          |
   |          |-mq [MQ etc files]
   |
   |-------- var
   |          |
   |          |- install [contains installer information]
   |          |
   |          |-mq [used by the server for storing data]
   |
   |-------- mq
   |         |-------- bin   [MQ executables]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit solaris executables]
   |         |
   |         |-------- lib [MQ jar files and libraries]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit libraries for the MQ C API]
   |         |
   |         |-------- include [C-API file system headers]
   |         |
   |         |-------- lib64  [note: linux libs used instead of sparcv9]
   |         |
   |         |-------- examples [demos]
   |         
   |-------- install
               |
               |- open installer implementation and jar files
For more details and specific locations for each file installed by MQ see the MQ 4.3 Filesystem and Packaging specification.

mquninstall[.bat] - script to improve uninstall experience

The installer places the script to uninstall the product in:
<install_home>/var/install/contents/mq/uninstaller

A low level install script (used by the mq installer) is located at:
<install_home>/install/bin/uninstaller

While we do document the location of the uninstaller, it is difficult to find and users often attempt to uninstall with the wrong uninstaller executable.

For this release, we are adding a new script (or bat file) called mquninstall that is being placed in the <install_home>/mq/bin directory. This will will only be in OpenMQ bundles for this release (it will not be available in package based installs).

JMX Administration API changes - minimal JMX attribute and CompositeData changes

The following changes will be made to the JMX monitoring api:

  • A new attribute NextMessageID will be added to consumers and destinations
  • A new attribute NumMsgsPending to consumers

The specific changes are:

  • DestinationMonitorMBean

    New Attributes:
    Name Set/Get Type Description
    NextMessageID G String JMS Message Id of the next message to be sent to any consumer

  • ConsumerMonitorMBean:

    new Keys for Composite Data
    Key Value Type Description
    NextMessageID String JMS Message Id of the next message to be sent to this consumer
    NumMsgsPending Long The number of messages which have been sent to this consumer but have not been acknowledged. They may either be queued for delivery or delivered to the consumer

Administration API (imqcmd) output changes - imqcmd output changes for durable subscribers

Note: the output returned from this application has a classification of uncommitted.

This changes the output of the command imqcmd list dur to list all destinations (and include a directory name) if the -d is omitted. The following examples show the ouptut changes:

  • Output when listing durables when a destination passed in on the command line. (Unchanged from previous releases)

    imqcmd list dur -d mydest 

    Listing all durable subscriptions on the topic 'mydest'
on the broker specified by:

-------------------------
Host         Primary Port
-------------------------
localhost    7676

---------------------------------------------------------------------------
Durable Sub. Name   Client ID   Number of Messages   Durable Sub. State   -
---------------------------------------------------------------------------
mydn                mycid       0                    INACTIVE             -

Successfully listed durable subscriptions.
  • Output when listing durables when a destination is not provided on the command line (adds new column DestinationName)

    imqcmd list dur -- listing all destinations

    
Listing all durable subscriptions
-------------------------
Host         Primary Port
-------------------------
localhost    7676

------------------------------------------------------------------------------------------
Durable Sub. Name   Client ID   Destination Name   Number of Messages   Durable Sub. State
------------------------------------------------------------------------------------------
456                 123         *.foo              0                    INACTIVE
mydn                mycid       mydest             0                    INACTIVE

Successfully listed durable subscriptions.
Additional Installation Imported interfaces

The windows Installer.vbs script now uses the following variables to locate a JRE for the installer:

  • HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion
  • HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\<version>\JavaHome

During installation, the installer will first attempt to use the jdk (if any) which was passed into the installation script, if no jdk is passed in it will look for a jre installed as part of the bundle, if no jre is found it will look at the keys to find the current JDK and its javahome.

Additional Logging Messages

Some bug fixes require the addition or modification of log messages. No change was made in the format of those messages.

Imported/Exported Intefaces

Exported Interfaces
Interface Classification Comments
imqcmd Ouput Uncommitted Modifies an existing interface to support listing of all durables including their destination. See specific changes above.
MQ MBean Attributes names Committed Modifies an existing interface to add support for NextMessageID method. See specific changes above
MQ MBean Lookup keys for CompositeData Committed Modifies an existing interface to add support for NextMessageID method and NumMsgsPending. See specific changes above.
Unbundled Filesystem Layout Committed New Interface.

Creates a new filesystem layout for the product when it is not shipped with native packaging. See the Filesystem Layout specification
Broker Log Infomation Uncommitted Modified an existing interface by adding new log messages (no format changes)
UMS Protocol Committed New Interface.

Defines the protocol for the new ums service.See the UMS Protocol Specification
UMS Configuration Committed New Interface.

Defines the configuration properties for the new ums service. See the UMS Configuration Specification
imqums.war Committed New Interface.

Defines the name of the war file used for deploying the new ums service. See specific changes above.
<mq_home>/bin/mqunistall[.bat] Committed New Interface.

A new script file which is available only on the new openMQ bundles that makes it easier for users to find the uninstaller. See specific changes above.

Imported Interfaces
Interface Classification Comments
HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion Standard New Interface

Location of the latest release of the JRE on a windows system.
HKLM\SOFTWARE\Java Soft\Java Runtime Environment\<version>\JavaHome Standard New Interface

Location of the java home for a release of the JRE on a windows system.

References

Current Release:

Message Queue 4.3 feature functional specifications:

Previous Release:

Message Queue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387

--Boundary_(ID_UZlsx0QciJCREbkLKqqGnA) Content-id: Content-type: image/gif; name=ums.gif; x-mac-creator=0; x-mac-type=0 Content-transfer-encoding: BASE64 Content-disposition: inline; filename=ums.gif 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 bs9/CEygAhfIwAZGKgEAOw== --Boundary_(ID_UZlsx0QciJCREbkLKqqGnA)-- --Boundary_(ID_dcTXJunrvBy2ndE6J3TqvQ)-- --Boundary_(ID_ocaGdeqbZ61qk7bm9pNe9w) Content-type: application/zip; name=additional.zip Content-transfer-encoding: BASE64 Content-disposition: inline; filename=additional.zip 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 BQqZCaqY8rmdkvmhaJpGaqoKe/qoR+OnvAmoaYmf3XmpBIr+qAZanApqp//UqL+n NpLqXFRaqZqaoJeKoCMJAxS6qJ8AqqEqqqOKWh7aqpv6ncc5nCF6pZ26m8EIq7H6 VLM6bJR6lsJ5oMLJmvQpoBLqqsTXoMHKqFJKq3JqmYKaqL9pn6t5rdeanM6KaMAa rRY1qgXEq3R6rkrJo0wJreKqpdOaPqWKrnT6rUkQru1KMkNarvK6r5Cprl55r7KJ HNXKr+dKr9dmrwCbDAJ7PAS7rwYbLAibsAp7HmTWsPL6sLUQsRIbMDPRIRaLrhjb LRq7sbFIA9DysQXrr2xJsiJGHBcBbyg7ryrbl+zKsk3CDR0LFjE7pyFrAnhqs6GB gjn+Ow74sLNm2rPvMrJAW5W/MLTH8QtGW6ZIi0JKu7R/ig8zQBX2YK5R26ozi5lW mzJs4bQvqw1de6RTy7E1G7ZpZDEdu7DWcLZY+rXjubZsu6JuexNkK7c6mrYKe7c2 eAs3YLZ866J+q01VC7ipAxaDmwuFa7h0e6F2m4pOemCBWz814LiPK6KH606Je7CI eBSfC3wV17hcu7mVGrmv2pDtMLqIS4WT2y2YiwPCgLqKqrrPygd4apBuSTpkeLOl qwO267WeSh37GCihyy6xm4mMuwPD26y4m7vC2Luuo4h2SQ0myw3P663RK73vmor+ yaFXO7Dbm7rFa7zTq5mbEIH+nGkQXSC+HUq+5Wus3Quu6eug/YSbYnk28AsP8Tq/ alm/9vu9O7Mu0yidKZF9+oqUldvAQyDA9TqsP5m/JkIhCtIgDcO+ddm2xWqTX7VW INh+EBzBvAuW68sligInKHzA6dW/i1urXOlaIax/Iwy6JUy9+RGYUuMmO7x5EgnD FSrDIdi542qIt0jB13KOgxmUhDl5LkyqHbyXQjyBRFzErutMBgxirQgzg0md1xuh DDzFBljFMvizMckmLxM1ZcMoPqyO/yvFojXDB1jDEbwjDNQZEIq94qGWYpx/ZFzG dhwiyVuYT2x5P/EVpsHHcTzEdJwE1EGMePzDzbsXpzv+on3Mfn8MD8eLvw9qA7UA b3Abt2G8yFTcyJ6rcRl3w075hw78lUiTvb2gyJclxxRoymWMZlesWGFCLU1sIa18 YE0Ly7U7yrPMyOerK7TMYbnsXGEClernVlM5FL9cuaJ8lB8MTcnsgracNdmcbst7 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 3iasUSCs3PS7E5SBcTFmOhAzilOdZktDXAyi5Bha+9GkYl6pOC1BlTAtuWBp81G/ +070CZ6T7DuEPEkdlGAjbyiSKyxiBggVLuE6A9/jK31ONvpnSJqeEC6qNydAQghM tvypqptFhQj4hmRi7d5F/lS/nhwBtanycvpvTRLmFIsjD1W+Pvaa7n9g4Dbbx9ss hxs/u3CNo8r9vn4zfrzh9ru2Q+e3O98P5BdTqcDK7+5fUJpRTgMaqb9AHRxcylc+ 8Re2wKE0Xzd2seMM8X6av7CKl/1/AFBLAwQUAAAACAC9clU5qXNpLfIFAABQFAAA GgAVAHNwZWNzL3Vtcy9jbG9zZV9yZXBseS5odG1sVVQJAAP1R/5Ir4P/SFV4BAAA dQoAzVjbctpIEH1eqviHXj24dreMhMDERlyquMixazGwICebfUkJaQDFkkZIw81f v9O6YBiUjZNUKvtgI8709HSf7ulu0fy1P+oZH8Y63BkPAxg/dgf3PZBKivK+2lOU vtFPFq7kMhih6UcOc6hvuoqiD6V2sdDE1fhT7/T55y/NB93o8D3GuKT/9Xj/riX1 RkNDHxolPEWC9FtLYmTHlCXz3AZYSzOMCGttHd+m26ikVmoVKVZm3BsDvd1Uks+D +mHnQW9Jb/WhPukYo8mR1ikzw9F87lgEbgB+e+/41crvkriz82jcnWyzlo7pOf7i TLI30TuG3j8SrZTLN+V6udJQK9V6rV4un++56wzfnu1Ry2W1oVZrldqbWj2mTkk5 a3ZH/Q8w4JtaEvFLj1MJ+veTljQwJrHcuN3MVJNnWZM4H51TqJyDqTlYJQer5mBX AraXF7scSDzWrTt2nik1Adtp9EmAaLUiGoKQuHO+Wa8EaOU/LQVo5lkr0X3ExBP8 fWWbc6jIEmIiI7PyiohyaInoPmKiKY5ctnIgceuzWb/Ogc4ItjeiNoREsVlp4wiQ vd6rohhior2Iib4iJtKJmMgTYmIQEXuTg4neInaTg9XzbM51RPSE1YnIlbnbzgRo aZsbAQpkx8uBzqK9monpuQ3nUQ4k7kRMtBYxkXfERN4Xs/lZaN+cXTpMgDOSuJiI hYuqWGKC0m4tQp46E3ciJvqAmOgDYqIPiIm5g5joBWJinoTPH8VjERLN29WuaY5Y 3lbRYsREixHLs1jMWIxOegaW+nbzlncFmN7/o7eu2pZLI/IxJIG7b3Yn7fhPQYGT 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 AAABAAAApIEhGwAAc3BlY3MvdW1zL2Nsb3NlLmh0bWxVVAUAA/VH/khVeAAAUEsB AhcDFAAAAAgAvXJVOalzaS3yBQAAUBQAABoADQAAAAAAAQAAAKSB5iAAAHNwZWNz L3Vtcy9jbG9zZV9yZXBseS5odG1sVVQFAAP1R/5IVXgAAFBLAQIXAxQAAAAIAL1y VTmEKkZjlQUAACkQAAAVAA0AAAAAAAEAAACkgSUnAABzcGVjcy91bXMvY29tbWl0 Lmh0bWxVVAUAA/VH/khVeAAAUEsBAhcDFAAAAAgAvXJVOZld66MaBgAAChUAABsA DQAAAAAAAQAAAKSBAi0AAHNwZWNzL3Vtcy9jb21taXRfcmVwbHkuaHRtbFVUBQAD 9Uf+SFV4AABQSwECFwMUAAAACAC9clU5MHM/MRkHAAAuGQAAFQANAAAAAAABAAAA pIFqMwAAc3BlY3MvdW1zL2NvbmZpZy5odG1sVVQFAAP1R/5IVXgAAFBLAQIXAxQA AAAIAL1yVTn7mnztRgMAADYGAAAXAA0AAAAAAAEAAACkgcs6AABzcGVjcy91bXMv ZmVhdHVyZXMuaHRtbFVUBQAD9Uf+SFV4AABQSwECFwMUAAAACAC9clU5mTa2+E8G AAAXFQAAFAANAAAAAAABAAAApIFbPgAAc3BlY3MvdW1zL2xvZ2luLmh0bWxVVAUA A/VH/khVeAAAUEsBAhcDFAAAAAgAvXJVOYu441syBwAASxcAABoADQAAAAAAAQAA AKSB8UQAAHNwZWNzL3Vtcy9sb2dpbl9yZXBseS5odG1sVVQFAAP1R/5IVXgAAFBL AQIXAxQAAAAIAL1yVTnTDVfyvRQAANRTAAAXAA0AAAAAAAEAAACkgXBMAABzcGVj cy91bXMvcHJvdG9jb2wuaHRtbFVUBQAD9Uf+SFV4AABQSwECFwMUAAAACAC9clU5 WqHFInMGAAA0FAAAFgANAAAAAAABAAAApIF3YQAAc3BlY3MvdW1zL3JlY2VpdmUu aHRtbFVUBQAD9Uf+SFV4AABQSwECFwMUAAAACAC9clU5fvjTKsQIAAD0JQAAHAAN AAAAAAABAAAApIEzaAAAc3BlY3MvdW1zL3JlY2VpdmVfcmVwbHkuaHRtbFVUBQAD 9Uf+SFV4AABQSwECFwMUAAAACAC9clU5ltSiaJoFAACWEAAAFwANAAAAAAABAAAA pIFGcQAAc3BlY3MvdW1zL3JvbGxiYWNrLmh0bWxVVAUAA/VH/khVeAAAUEsBAhcD FAAAAAgAvXJVOUKJ+f0JBQAAeQ8AAB0ADQAAAAAAAQAAAKSBKncAAHNwZWNzL3Vt cy9yb2xsYmFja19yZXBseS5odG1sVVQFAAP1R/5IVXgAAFBLAQIXAxQAAAAIAL1y VTkSuXVBxgcAAMIXAAATAA0AAAAAAAEAAACkgYN8AABzcGVjcy91bXMvc2VuZC5o dG1sVVQFAAP1R/5IVXgAAFBLAQIXAxQAAAAIAL1yVTmeKX8VjgYAAD0WAAAZAA0A AAAAAAEAAACkgY+EAABzcGVjcy91bXMvc2VuZF9yZXBseS5odG1sVVQFAAP1R/5I VXgAAFBLAQIXAxQAAAAIAL1yVTkPhiT+swIAABEFAAASAA0AAAAAAAEAAACkgWmL AABzcGVjcy91bXMvdW1zLmh0bWxVVAUAA/VH/khVeAAAUEsBAhcDFAAAAAgAvXJV OcvDFA8uCQAAyhwAABcADQAAAAAAAQAAAKSBYY4AAHNwZWNzL3Vtcy91bXNJbnRy by5odG1sVVQFAAP1R/5IVXgAAFBLAQIXAxQAAAAIAL1yVTkX72xI3AIAAHYFAAAW AA0AAAAAAAEAAACkgdmXAABzcGVjcy91bXMvdW1zTWFpbi5odG1sVVQFAAP1R/5I VXgAAFBLAQIXAxQAAAAIALllVjlSmIY/Tw8AAPZGAAAVAA0AAAAAAAEAAACAgf6a AABzcGVjcy9maWxlbGF5b3V0Lmh0bWxVVAUAA+6C/0hVeAAAUEsFBgAAAAAUABQA XwYAAJWqAAAAAA== --Boundary_(ID_ocaGdeqbZ61qk7bm9pNe9w)-- From tom.childers@sun.com Tue Oct 28 10:04:30 2008 Received: from dm-sfbay-01.sfbay.sun.com (dm-sfbay-01.SFBay.Sun.COM [129.145.155.118]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m9SH4UHj028975 for ; Tue, 28 Oct 2008 10:04:30 -0700 (PDT) Received: from sca-es-mail-2.sun.com (sca-es-mail-2.Sun.COM [192.18.43.133]) by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m9SH4TQs015061 for ; Tue, 28 Oct 2008 10:04:29 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m9SH4Oda012652 for ; Tue, 28 Oct 2008 10:04:24 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K9G00801ITW0500@fe-sfbay-10.sun.com> (original mail from tom.childers@sun.com) for LSARC-ext@sac.sfbay.sun.com; Tue, 28 Oct 2008 10:04:24 -0700 (PDT) Received: from labnis-qfe4.SFBay.Sun.COM ([75.101.10.233]) by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K9G00HOKKQZMY00@fe-sfbay-10.sun.com> for LSARC-ext@sac.sfbay.sun.com; Tue, 28 Oct 2008 10:04:12 -0700 (PDT) Date: Tue, 28 Oct 2008 10:04:05 -0700 From: Tom Childers Subject: Re: OpenMQ/SJSMQ 4.3 (Robin) [LSARC/2008/648 FastTrack timeout 10/28/2008] In-reply-to: <48FFF85A.3080701@sun.com> Sender: Thomas.Childers@sun.com To: Linda Schneider Cc: LSARC-ext@sac.sfbay.sun.com Message-id: <9B1B74E8-EDEF-4E90-A58F-A057BA3C9480@sun.com> MIME-version: 1.0 X-Mailer: Apple Mail (2.928.1) Content-type: multipart/alternative; boundary="Boundary_(ID_BELL9l5nkzWQ+RgdQVCIGg)" References: <48FFF85A.3080701@sun.com> Status: RO Content-Length: 37286 --Boundary_(ID_BELL9l5nkzWQ+RgdQVCIGg) Content-type: text/plain; delsp=yes; format=flowed; charset=US-ASCII Content-transfer-encoding: 7BIT Hi, Linda. Looking through this case today, I notice that the UMS specification is hosted on an internal machine, and the onepager links to an internal machine. Since this is an open case, the specs are not available to outside ARC members. Apparently this is a new interface that we created from scratch. Isn't there a public or FOSS interface available to support .net, Python and Ajax clients? Everything else looks pretty straightforward. -tdc On Oct 22, 2008, at 9:06 PM, Linda Schneider wrote: > I'm sponsoring the following proposal for fast-track approval. The > timer is set for 10/28/2008. > > Proposed release binding is minor. > > Fastrack content is [now] included below (it will look better if > viewed as html) > > The attached zip file [additional.zip] contains copies of the > functional specs referenced in this document. > The document (and related files) is also available at: http://sac.sfbay/arc/LSARC/2008/648/robin.html > > FastTrack: OpenMQ / Sun Java System Message Queue 4.3 (Robin) > Sponsor: Linda Schneider > > Release Binding: Minor > > This is a FastTrack request for minor interface changes in Open > Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). > Robin is a maintenance release to Message Queue 4.2 (LSARC/ > 2008/387). It includes bug fixes and a small number of minor > enhancements. > > This FastTrack adds modifies several committed and uncommitted > exported interfaces and adds two new imported interfaces. It does > not change the classification or remove any existing interface. > > > Overview of Changes > > Several changes were added to 4.3 which impact the product's > interface: > > A REST style API was added to allow messages to be produced or > consumed to the MQ provider > A new bundling and layout scheme was added to support the product > installed by our new Zip based installer (which will also be used in > future releases for IPS packages) > Minor administration changes > Minor modifications to the windows installer > Addition of a command to make it easier to locate the uninstaller on > the OpenMQ packages. > Public interface changes > > New Exported Interfaces: Creation of the Universal Message Service > (UMS) API: > The UMS Protocol used by applications to connect to the service. > The UMS Configuration which contains the set of configuration > parameters for the service. > A new war file (imqums.war) containing the servlet required by UMS. > New Exported Interface: Creation of a the new filesystem layout for > use by the new packages. This layout will also be used for our new > install bundles specifically: > Our OpenMQ product > Our AIX product (the platform is new to 4.3) > No changes have been made to our existing packages used in earlier > releases. (They will still use the old filesystem laytout) > New Exported Interface: A new uninstall bat/shell script has been > added as a shortcut for uninstalling the openMQ-only release. > Modified Exported Interface: Minor changes have been made to JMX to > add additional information for destinations and consumers. > New Imported Interfaces: Installation of the product on windows > (both for SJSMQ and OpenMQ) now uses Java registry keys as a > fallback to locate a JRE to use to start the installer. > Private interface changess > > Additional changes have been made to private interfaces: > > Modified Interface: Output of imqcmd. This interface is Uncommitted. > > Descriptions of Changes > > > Universal Message Service (UMS) - a REST style API > The Universal Message Service is a simple REST based API that allows > any HTTP capable device to access Message Queue. This allows clients > written in languages such as c-sharp and phython to send and receive > messages. > > A new web component (imqums.war) can be deployed on any web > container. That component serves as a bridge between the ums client > and the JMS provider. The ums client sends the ums protocol (which > uses http posts) to connect to the imqums service. That service uses > standard JMS apis to connect to the MQ server (the broker). > > > > Client->web component protocol > The protocol has two types of messages service requests (messages > sent to the messaging system) and service responses (responses > received from the messaging system). There are also two services > (XML and basic text) which are provided in this release. > > > The API supports the following commands: > > login logs into the system and creates a UMS session (note: the > password must be sent in plaintext since it is going as part of the > http command line, however use of SSL is recommended). > send Sends a message (which will become a JMS message) to MQ. > receive Receive a message from MQ. > commit Commit a transaction (provided the UMS session is transacted). > rollback Rollback a transaction. (provided the UMS session is > transacted). > close Close the UMS session. > All messages are request/response: > > Service Requests > The http POST method is used for all interaction with the UMS. Each > protocol message is represented with the following syntax: > http://host:port//[? > ]; > > Where: > > ums_conext-root: the location where the WAR file was deployed > simple: the type of service used (simple or XML) > query_string: used for the simple service. Provides a set of name > value pairs separated by & which specify information such as the > service type, messaging domain, and destination name > For the Messages: > For XML messages, the body contains the command information in XML > format > For the simple service, the body is empty (since the protocol > information in in the URL) > > Service Responses > For the XML service, the body of the HTTP request returns a SOAP > message containing return information. For the simple message > service, the body of the message may contain some specific return > information. > > Lower level details of the Protocol are found in the UMS Protocol > description. > > UMS configuration > When the war file is deployed, several configuration options are > available for the servlet including password to be used to the > broker, how often to poll for messages and the broker address. > Specific configuration parameters are found in the UMS Configuration > specification. > > Filesystem layout and packaging change - support for new packages > which can handle multi-install > In MQ 4.3 we are adding a new zip based packaging bundle. In the > following release (Crane), we will be replacing the zip bundles for > IPS packages. This layout is the one we will be using for going > forward for all future unbundled products (either zip based or IPS). > > Note: Our current SVR4 or Linux RPM based packaging is unaffected by > these changes. > > MQ's filesystem will be laid out following the JES Filesystem Layout > for Unbundled Software. > > > | > |-------- etc > | | > | |-mq [MQ etc files] > | > |-------- var > | | > | |- install [contains installer information] > | | > | |-mq [used by the server for storing data] > | > |-------- mq > | |-------- bin [MQ executables] > | | | > | | |- sparcv9 (amd64) [64 bit solaris > executables] > | | > | |-------- lib [MQ jar files and libraries] > | | | > | | |- sparcv9 (amd64) [64 bit libraries for the > MQ C API] > | | > | |-------- include [C-API file system headers] > | | > | |-------- lib64 [note: linux libs used instead of > sparcv9] > | | > | |-------- examples [demos] > | > |-------- install > | > |- open installer implementation and jar files > > > For more details and specific locations for each file installed by > MQ see the MQ 4.3 Filesystem and Packaging specification. > > > mquninstall[.bat] - script to improve uninstall experience > The installer places the script to uninstall the product in: > /var/install/contents/mq/uninstaller > > A low level install script (used by the mq installer) is located at: > /install/bin/uninstaller > > While we do document the location of the uninstaller, it is > difficult to find and users often attempt to uninstall with the > wrong uninstaller executable. > > For this release, we are adding a new script (or bat file) called > mquninstall that is being placed in the /mq/bin > directory. This will will only be in OpenMQ bundles for this release > (it will not be available in package based installs). > > > JMX Administration API changes - minimal JMX attribute and > CompositeData changes > The following changes will be made to the JMX monitoring api: > > A new attribute NextMessageID will be added to consumers and > destinations > A new attribute NumMsgsPending to consumers > The specific changes are: > > DestinationMonitorMBean > New Attributes: > Name Set/Get Type Description > NextMessageID G String JMS Message Id of the next message to be sent > to any consumer > ConsumerMonitorMBean: > new Keys for Composite Data > Key Value Type Description > NextMessageID String JMS Message Id of the next message to be sent > to this consumer > NumMsgsPending Long The number of messages which have been sent to > this consumer but have not been acknowledged. They may either be > queued for delivery or delivered to the consumer > > > Administration API (imqcmd) output changes - imqcmd output changes > for durable subscribers > Note: the output returned from this application has a classification > of uncommitted. > > This changes the output of the command imqcmd list dur to list all > destinations (and include a directory name) if the -d is omitted. > The following examples show the ouptut changes: > > Output when listing durables when a destination passed in on the > command line. (Unchanged from previous releases) > imqcmd list dur -d mydest > > > Listing all durable subscriptions on the topic 'mydest' > on the broker specified by: > > ------------------------- > Host Primary Port > ------------------------- > localhost 7676 > > --------------------------------------------------------------------------- > Durable Sub. Name Client ID Number of Messages Durable Sub. > State - > --------------------------------------------------------------------------- > mydn mycid 0 > INACTIVE - > > Successfully listed durable subscriptions. > > Output when listing durables when a destination is not provided on > the command line (adds new column DestinationName) > imqcmd list dur -- listing all destinations > > > Listing all durable subscriptions > ------------------------- > Host Primary Port > ------------------------- > localhost 7676 > > ------------------------------------------------------------------------------------------ > Durable Sub. Name Client ID Destination Name Number of > Messages Durable Sub. State > ------------------------------------------------------------------------------------------ > 456 123 *.foo > 0 INACTIVE > mydn mycid mydest > 0 INACTIVE > > Successfully listed durable subscriptions. > > Additional Installation Imported interfaces > The windows Installer.vbs script now uses the following variables to > locate a JRE for the installer: > > > HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion > HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\\JavaHome > > During installation, the installer will first attempt to use the jdk > (if any) which was passed into the installation script, if no jdk is > passed in it will look for a jre installed as part of the bundle, if > no jre is found it will look at the keys to find the current JDK and > its javahome. > > Additional Logging Messages > Some bug fixes require the addition or modification of log messages. > No change was made in the format of those messages. > > Imported/Exported Intefaces > > Exported Interfaces > Interface Classification Comments > imqcmd Ouput Uncommitted Modifies an existing interface to support > listing of all durables including their destination. See specific > changes above. > MQ MBean Attributes names Committed Modifies an existing interface > to add support for NextMessageID method. See specific changes above > MQ MBean Lookup keys for CompositeData Committed Modifies an > existing interface to add support for NextMessageID method and > NumMsgsPending. See specific changes above. > Unbundled Filesystem Layout Committed New Interface. > Creates a new filesystem layout for the product when it is not > shipped with native packaging. See the Filesystem Layout specification > > Broker Log Infomation Uncommitted Modified an existing interface by > adding new log messages (no format changes) > UMS Protocol Committed New Interface. > Defines the protocol for the new ums service.See the UMS Protocol > Specification > > UMS Configuration Committed New Interface. > Defines the configuration properties for the new ums service. See > the UMS Configuration Specification > > imqums.war Committed New Interface. > Defines the name of the war file used for deploying the new ums > service. See specific changes above. > > /bin/mqunistall[.bat] Committed New Interface. > A new script file which is available only on the new openMQ bundles > that makes it easier for users to find the uninstaller. See specific > changes above. > > > Imported Interfaces > Interface Classification Comments > HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion > Standard New Interface > Location of the latest release of the JRE on a windows system. > > HKLM\SOFTWARE\Java Soft\Java Runtime Environment\\JavaHome > Standard New Interface > Location of the java home for a release of the JRE on a windows > system. > > > > References > > Current Release: > > Message Queue 4.3 feature functional specifications: > > UMS protocol > UMS configuration specification > MQ Filesystem Layout and packaging specification for Robin > > Previous Release: > > Message Queue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387 > > > > --Boundary_(ID_BELL9l5nkzWQ+RgdQVCIGg) Content-type: text/html; charset=US-ASCII Content-transfer-encoding: QUOTED-PRINTABLE Hi, Linda.

Looking through this case today, I notice that the UMS specificati= on is hosted on an internal machine, and the onepager links to an int= ernal machine. Since this is an open case, the specs are not availabl= e to outside ARC members.

Apparently this is= a new interface that we created from scratch.  Isn't there a pu= blic or FOSS interface available to support .net, Python and Ajax cli= ents?

Everything else looks pretty straightf= orward.
-tdc

On Oct 22, 2008, at 9:= 06 PM, Linda Schneider wrote:

I'm sponsoring the following proposal for fast-track approval.= The timer is set for 10/28/2008.

Proposed release binding = is minor.

Fastrack content is [now] included below (it will= look better if viewed as html)

The attached zip file [addit= ional.zip] contains copies of the functional specs referenced in this= document.
The document (and related files) is also available at:=   http://sac.sfbay/arc/LSARC/2008/648/robi= n.html

FastTrack: OpenMQ / Sun Java System = Message Queue 4.3 (Robin)

Sponsor: Linda Schneider

=

Release Binding: Minor

This is a FastTrack r= equest for minor interface changes in Open Message Queue (OpenMQ) / J= ava System Message Queue 4.3 (Robin). Robin is a maintenance release = to Message Queue 4.2 (LSARC/2008/387). It includes bug fixes and a s= mall number of minor enhancements.

This FastTrack adds modifie= s several committed and uncommitted exported interfaces and adds two = new imported interfaces. It does not change the classification or rem= ove any existing interface.


Overview of Changes

Seve= ral changes were added to 4.3 which impact the product's interface: =

    A REST style API was added to allow messages to be produced or consu= med to the MQ provider
  • A new bundling and layout scheme= was added to support the product installed by our new Zip based inst= aller (which will also be used in future releases for IPS packages)
  • Minor administration changes
  • Minor modific= ations to the windows installer
  • Addition of a command t= o make it easier to locate the uninstaller on the OpenMQ packages.

Public interface changes

    =
  1. New Exported Interfaces: Creation of the Universa= l Message Service (UMS) API:
    • The UMS Protocol used by applications to connect to th= e service.
    • The UMS Configur= ation which contains the set of configuration parameters for the = service.
    • A new war file (imqums.war) containing the= servlet required by UMS.
  2. <= b>New Exported Interface: Creation of a the new filesystem la= yout for use by the new packages. This layout will also be used for o= ur new install bundles specifically:
    • Our Ope= nMQ product
    • Our AIX product (the platform is new to= 4.3)
    No changes have been made to our existing pac= kages used in earlier releases. (They will still use the old filesyst= em laytout)
  3. New Exported Interface:= A new uninstall bat/shell script has been added as a shortcut for un= installing the openMQ-only release.
  4. Modified Ex= ported Interface: Minor changes have been made to JMX to add = additional information for destinations and consumers.
    5. New Imported Interfaces: Installation of the product o= n windows (both for SJSMQ and OpenMQ) now uses Java registry keys as = a fallback to locate a JRE to use to start the installer. =

Private interface changess

Additional cha= nges have been made to private interfaces:

  1. = Modified Interface: Output of imqcmd. This interface is= Uncommitted.

Descriptions of Changes


= Universal Message Service (UMS) - a REST style API
=

The Universal Message Service is a simple REST based API= that allows any HTTP capable device to access Message Queue. This al= lows clients written in languages such as c-sharp and phython to send= and receive messages.

A new web component (imqums.war)= can be deployed on any web container. That component serves as a bri= dge between the ums client and the JMS provider. The ums client sends= the ums protocol (which uses http posts) to connect to the imqums se= rvice. That service uses standard JMS apis to connect to the MQ serve= r (the broker).

<ums.gif>

<= dl>
Client->web component pr= otocol

The protocol has two types of message= s service requests (messages sent to the messaging system) and servic= e responses (responses received from the messaging system). There are= also two services (XML and basic text) which are provided in this re= lease.


The AP= I supports the following commands:

    =
  • login logs into the system and creates a UMS se= ssion (note: the password must be sent in plaintext since it is going= as part of the http command line, however use of SSL is recommended)= .
  • send Sends a message (which will beco= me a JMS message) to MQ.
  • receive Receive= a message from MQ.
  • commit Commit a tran= saction (provided the UMS session is transacted).
    • <= li>rollback Rollback a transaction. (provided the UMS session = is transacted).
  • close Close the UMS sess= ion.

All messages are request/response: =

Service Requests<= /dt>
The http POST method is used for all interactio= n with the UMS. Each protocol message is represented with the followi= ng syntax:

http://host:port/<ums-context-root>/&= lt;service>[?<query_string_if_simple>];

Where: =

  • ums_conext-roo= t: the location where the WAR file was deployed
    • =
  • simple: the type of service used (simple or XML)
  • query_string: used for the simple servi= ce. Provides a set of name value pairs separated by & which speci= fy information such as the service type, messaging domain, and destin= ation name
For the Messages: =
  • For XML messages, the body contains the c= ommand information in XML format
  • For the si= mple service, the body is empty (since the protocol information in in= the URL)

=
Service Responses

For the XML ser= vice, the body of the HTTP request returns a SOAP message containing = return information. For the simple message service, the body of the m= essage may contain some specific return information. <= /p>

Lower level details of the Pr= otocol are found in the UMS Protocol description. <= p>

=
UMS configuration
When the war file is d= eployed, several configuration options are available for the servlet = including password to be used to the broker, how often to poll for me= ssages and the broker address. Specific configuration parameters are = found in the UMS Configuration specification.
=

=
Filesystem layout and packaging change - support for new packages which can handle multi-install
=

In MQ 4.3 we are adding a new zip based packaging bundle. I= n the following release (Crane), we will be replacing the zip bundles= for IPS packages. This layout is the one we will be using for going = forward for all future unbundled products (either zip based or IPS).<= /p>

Note: Our current SVR4 or Linux RPM based packaging is u= naffected by these changes.

MQ's filesystem will be laid out fo= llowing the JES Filesystem Layout for Unbundled= Software. 

<install_home>
   |
   |-------- etc
   |          |
   |          |-mq [MQ etc files]
   |
   |-------- var
   |          |
   |          |- install [contains installer information]
   |          |
   |          |-mq [used by the server for storing data]
   |
   |-------- mq
   |         |-------- bin   [MQ executables]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit solaris executable=
s]
   |         |
   |         |-------- lib [MQ jar files and libraries]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit libraries for the =
MQ C API]
   |         |
   |         |-------- include [C-API file system headers]
   |         |
   |         |-------- lib64  [note: linux libs used instead of sparc=
v9]
   |         |
   |         |-------- examples [demos]
   |        =20
   |-------- install
               |
               |- open installer implementation and jar files
For more details and specific locations for each file = installed by MQ see the MQ 4.3 Filesystem and Packaging specificatio= n.

=
= mquninstall[.bat] - script to improve uninstall experience=

The installer places the script to uninstall the pr= oduct in:
<install_home>/var/install/contents/mq/uni= nstaller

A low level install script (used by the mq install= er) is located at:
<install_home>/install/bin/uninst= aller

While we do document the location of the uninstaller,= it is difficult to find and users often attempt to uninstall with th= e wrong uninstaller executable.

For this release, we ar= e adding a new script (or bat file) called mquninstall that is= being placed in the <install_home>/mq/bin directory. This = will will only be in OpenMQ bundles for this release (it will not be = available in package based installs).


JMX Administ= ration API changes - minimal JMX attribute and CompositeData= changes

The following changes will be made to the J= MX monitoring api:

  • A new attribu= te NextMessageID will be added to consumers and destinations
    • =
  • A new attribute NumMsgsPending to consumers

    • The specific changes are:

    • = DestinationMonitorMBean

      New Attributes: = = = = = =
      Name Set/GetType Description
      NextMessageID G StringJMS Message Id of the next message to be sent to any= consumer

    • ConsumerMonitor= MBean:

      new Keys for Composite Data = Key Value Type = Description = NextMessageID String JMS Message Id of the next message to be sent= to this consumer = NumMsgsPending Long = The number of messages which have been sent to thi= s consumer but have not been acknowledged. They may either be queued = for delivery or delivered to the consumer =



=
Administration API (imqcmd) output changes - imq= cmd output changes for durable subscribers

Note: = the output returned from this application has a classification of unc= ommitted.

This changes the output of the command im= qcmd list dur to list all destinations (and include a directory name)= if the -d is omitted. The following examples show the ouptut changes= :

  • Output when listing durables = when a destination passed in on the command line. (Unchanged from pre= vious releases)

    imqcmd list dur -d mydest 

    Listing all durable subscriptions =
on the topic 'mydest'
on the broker specified by:

-------------------------
Host         Primary Port
-------------------------
localhost    7676

---------------------------------------------------------------------=
------
Durable Sub. Name   Client ID   Number of Messages   Durable Sub. Sta=
te   -
---------------------------------------------------------------------=
------
mydn                mycid       0                    INACTIVE        =
     -

Successfully listed durable subscriptions.
  • Output when listing d= urables when a destination is not provided on the command line (adds = new column DestinationName)

    imqcmd list dur -- listi= ng all destinations


    Listing all durable subscriptions
-------------------------
Host         Primary Port
-------------------------
localhost    7676

---------------------------------------------------------------------=
---------------------
Durable Sub. Name   Client ID   Destination Name   Number of M=
essages   Durable Sub. State
---------------------------------------------------------------------=
---------------------
456                 123         *.foo              0          =
          INACTIVE
mydn                mycid       mydest             0          =
          INACTIVE

Successfully listed durable subscriptions.
A= dditional Installation Imported interfaces
The windows Installer.vbs script now uses the following variables to= locate a JRE for the installer:


  • HKLM\SOFTWARE\J= avaSoft\Java Runtime Environment\CurrentVersion
    • HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\<version>\Java= Home

    <= /li>
During installation, the installer will first attem= pt to use the jdk (if any) which was passed into the installation scr= ipt, if no jdk is passed in it will look for a jre installed as part = of the bundle, if no jre is found it will look at the keys to find th= e current JDK and its javahome.

Additional Logging Mes= sages

Some bug fixes require the addition = or modification of log messages. No change was made in the format of = those messages.

Imported/Exported Intefaces
Exported Interfaces = = MQ MBean Lookup keys for CompositeData = = = = Committed
Interfac= e Classification Comments
imqcmd Ouput = Uncommitted Modifies an existing interface to supp= ort listing of all durables including their destination. See specific= changes above.
MQ MBean = Attributes names Committed Mod= ifies an existing interface to add support for NextMessageID method. = See specific changes above
Committed<= /td> Modifies an existing interface to add support for N= extMessageID method and NumMsgsPending. See specific changes above.
Unbundled Filesystem Layou= t Committed New Interface.

Creates a new filesystem layout for the product when it is not = shipped with native packaging. See the Filesystem Layout specificati= on
Brok= er Log Infomation Uncommitted Mo= dified an existing interface by adding new log messages (no format ch= anges)
UMS ProtocolCommitted New Interface.

De= fines the protocol for the new ums service.See the UMS Protocol Sp= ecification
UMS Configuration Committed = New Interface.

Defines the configuration properties for th= e new ums service. See the UMS Configuration Specification

=
imqums.warCommitted New Interface.

De= fines the name of the war file used for deploying the new ums service= . See specific changes above.
<mq_home>/bin/mqunistall[.bat] New Interface.

A new script f= ile which is available only on the new openMQ bundles that makes it e= asier for users to find the uninstaller. See specific changes above.<= /p>

Imported Interfaces = = =
Inte= rface Classification Comments
HKLM\SOFTWARE\Java Soft\Java= Runtime Environment\CurrentVersion StandardNew Interface

Location of the latest = release of the JRE on a windows system.
HKLM\SOFTWARE\Java Soft\Java Runtime Env= ironment\<version>\JavaHome StandardNew Interface

Location of the java home fo= r a release of the JRE on a windows system.



References

Current Release<= /b>:

Message Queue 4.3 feature functional specifications:


Previous Release:

Message Q= ueue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387



<a= dditional.zip>

--Boundary_(ID_BELL9l5nkzWQ+RgdQVCIGg)-- From Linda.Schneider@Sun.COM Tue Oct 28 10:38:04 2008 Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m9SHc4Qc000763 for ; Tue, 28 Oct 2008 10:38:04 -0700 (PDT) Received: from sca-es-mail-1.sun.com (sca-es-mail-1.Sun.COM [192.18.43.132]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m9SHc3iA045400 for ; Tue, 28 Oct 2008 10:38:03 -0700 (PDT) Received: from fe-sfbay-10.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m9SHbwWe017490 for ; Tue, 28 Oct 2008 10:37:58 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-10.sun.com by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K9G00K01KRALJ00@fe-sfbay-10.sun.com> (original mail from Linda.Schneider@Sun.COM) for LSARC-ext@sac.sfbay.sun.com; Tue, 28 Oct 2008 10:37:58 -0700 (PDT) Received: from [129.145.130.91] by fe-sfbay-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K9G00HHTMB4HA00@fe-sfbay-10.sun.com> for LSARC-ext@sac.sfbay.sun.com; Tue, 28 Oct 2008 10:37:52 -0700 (PDT) Date: Tue, 28 Oct 2008 10:37:02 -0700 From: Linda Schneider Subject: Re: OpenMQ/SJSMQ 4.3 (Robin) [LSARC/2008/648 FastTrack timeout 10/28/2008] In-reply-to: <9B1B74E8-EDEF-4E90-A58F-A057BA3C9480@sun.com> Sender: Linda.Schneider@Sun.COM To: Tom Childers Cc: LSARC-ext@sac.sfbay.sun.com Message-id: <49074DBE.4060409@sun.com> MIME-version: 1.0 Content-type: multipart/alternative; boundary="Boundary_(ID_+CQVixKVk/Q0KB5cG1OVDg)" References: <48FFF85A.3080701@sun.com> <9B1B74E8-EDEF-4E90-A58F-A057BA3C9480@sun.com> User-Agent: Thunderbird 2.0.0.12 (X11/20080228) Status: RO Content-Length: 47662 This is a multi-part message in MIME format. --Boundary_(ID_+CQVixKVk/Q0KB5cG1OVDg) Content-type: text/plain; format=flowed; charset=ISO-8859-1 Content-transfer-encoding: 7BIT / / /Looking through this case today, I notice that the UMS specification is hosted on an internal machine, and the onepager links to an internal machine. Since this is an open case, the specs are not available to outside ARC members./ A copy of the specification is attached in the zip file I attached to the original fast track email and the data is in the case directory. Is there also another place I should place it. /Isn't there a public or FOSS interface available to support .net, Python and Ajax clients?/ For JMS, not really. In general each JMS provider comes up with their own api's for .net, etc. There is a general api called STOMP which can be a bridge into JMS. and we have provided an example of using it on the openMQ site, but the licensing on the product prevent us from putting it in the product. Additionally its a more complex api. To login to the service to send a message with Stomp: / Console.WriteLine("CONNECT ..."); streamWriter.WriteLine("CONNECT"); streamWriter.WriteLine("login:guest"); streamWriter.WriteLine("passcode:guest"); streamWriter.WriteLine(""); streamWriter.Write('\0'); streamWriter.Flush(); / To long into the server to send a message with UMS: / POST /ums/simple?service=login&user=guest&password=guest HTTP/1.1 / NOTE: Ums (although part of the openMQ/SJSMQ project) is generic and will actually work with other providers. Tom Childers wrote: > Hi, Linda. > > Looking through this case today, I notice that the UMS specification > is hosted on an internal machine, and the onepager links to an > internal machine. Since this is an open case, the specs are not > available to outside ARC members. > > Apparently this is a new interface that we created from scratch. > Isn't there a public or FOSS interface available to support .net, > Python and Ajax clients? > > Everything else looks pretty straightforward. > -tdc > > On Oct 22, 2008, at 9:06 PM, Linda Schneider wrote: > >> I'm sponsoring the following proposal for fast-track approval. The >> timer is set for 10/28/2008. >> >> Proposed release binding is minor. >> >> Fastrack content is [now] included below (it will look better if >> viewed as html) >> >> The attached zip file [additional.zip] contains copies of the >> functional specs referenced in this document. >> The document (and related files) is also available at: >> http://sac.sfbay/arc/LSARC/2008/648/robin.html >> >> ------------------------------------------------------------------------ >> >> >> FastTrack: /OpenMQ / Sun Java System Message Queue 4.3 (Robin)/ >> >> Sponsor: /Linda Schneider/ >> >> Release Binding: / Minor/ >> >> This is a FastTrack request for minor interface changes in Open >> Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). Robin >> is a maintenance release to Message Queue 4.2 (LSARC/2008/387) >> . It includes >> bug fixes and a small number of minor enhancements. >> >> This FastTrack adds modifies several committed and uncommitted >> exported interfaces and adds two new imported interfaces. It does not >> change the classification or remove any existing interface. >> >> >> >> Overview of Changes >> >> Several changes were added to 4.3 which impact the product's >> interface: >> >> * A REST style API was added to allow messages to be produced >> or consumed to the MQ provider >> * A new bundling and layout scheme was added to support the >> product installed by our new Zip based installer (which >> will also be used in future releases for IPS packages) >> * Minor administration changes >> * Minor modifications to the windows installer >> * Addition of a command to make it easier to locate the >> uninstaller on the OpenMQ packages. >> >> _Public interface changes_ >> >> 1. /*New Exported Interfaces*/: Creation of the Universal >> Message Service (UMS) API: >> * The UMS Protocol <#umsproto> used by applications to >> connect to the service. >> * The UMS Configuration <#umsconfig> which contains the >> set of configuration parameters for the service. >> * A new war file (imqums.war) containing the servlet >> required by UMS. >> 2. /*New Exported Interface*/: Creation of a the new >> filesystem layout for use by the new packages. This layout >> will also be used for our new install bundles specifically: >> * Our OpenMQ product >> * Our AIX product (the platform is new to 4.3) >> No changes have been made to our existing packages used in >> earlier releases. (They will still use the old filesystem >> laytout) >> 3. /*New Exported Interface*/: A new uninstall bat/shell >> script has been added as a shortcut for uninstalling the >> openMQ-only release. >> 4. /*Modified Exported Interface*/: Minor changes have been >> made to JMX to add additional information for destinations >> and consumers. >> 5. */New Imported Interfaces/*: Installation of the product on >> windows (both for SJSMQ and OpenMQ) now uses Java registry >> keys as a fallback to locate a JRE to use to start the >> installer. >> >> _Private interface changess_ >> >> Additional changes have been made to private interfaces: >> >> 1. */Modified Interface/*: Output of imqcmd. This interface is >> Uncommitted. >> >> >> >> Descriptions of Changes >> >> >> *_Universal Message Service (UMS)_* - a REST style API >> >> The Universal Message Service is a simple REST based API that >> allows any HTTP capable device to access Message Queue. This >> allows clients written in languages such as c-sharp and >> phython to send and receive messages. >> >> A new web component (imqums.war) can be deployed on any web >> container. That component serves as a bridge between the ums >> client and the JMS provider. The ums client sends the ums >> protocol (which uses http posts) to connect to the imqums >> service. That service uses standard JMS apis to connect to >> the MQ server (the broker). >> >> >> >> _Client->web component protocol_ >> >> The protocol has two types of messages service requests >> (messages sent to the messaging system) and service >> responses (responses received from the messaging system). >> There are also two services (XML and basic text) which >> are provided in this release. >> >> >> The API supports the following commands: >> >> * _login_ logs into the system and creates a UMS >> session (note: the password must be sent in >> plaintext since it is going as part of the http >> command line, however use of SSL is recommended). >> * _send_ Sends a message (which will become a JMS >> message) to MQ. >> * _receive_ Receive a message from MQ. >> * _commit_ Commit a transaction (provided the UMS >> session is transacted). >> * _rollback_ Rollback a transaction. (provided the >> UMS session is transacted). >> * _close_ Close the UMS session. >> >> All messages are request/response: >> >> /Service Requests/ >> The http POST method is used for all interaction with >> the UMS. Each protocol message is represented with >> the following syntax: >> >> /http://host:port//[?];/ >> >> Where: >> >> * /ums_conext-root/: the location where the WAR >> file was deployed >> * /simple/: the type of service used (simple or XML) >> * /query_string/: used for the simple service. >> Provides a set of name value pairs separated by >> & which specify information such as the service >> type, messaging domain, and destination name >> >> For the Messages: >> >> * For XML messages, the body contains the command >> information in XML format >> * For the simple service, the body is empty >> (since the protocol information in in the URL) >> >> >> /Service Responses/ >> >> For the XML service, the body of the HTTP request >> returns a SOAP message containing return information. >> For the simple message service, the body of the >> message may contain some specific return information. >> >> Lower level details of the Protocol are found in the UMS >> Protocol description >> . >> >> >> _UMS configuration_ >> When the war file is deployed, several configuration >> options are available for the servlet including password >> to be used to the broker, how often to poll for messages >> and the broker address. Specific configuration parameters >> are found in the UMS Configuration specification >> . >> >> >> *_Filesystem layout and packaging change_* - support for new >> packages which can handle multi-install >> >> In MQ 4.3 we are adding a new zip based packaging bundle. In >> the following release (Crane), we will be replacing the zip >> bundles for IPS packages. This layout is the one we will be >> using for going forward for all future unbundled products >> (either zip based or IPS). >> >> *Note:* Our current SVR4 or Linux RPM based packaging is >> unaffected by these changes. >> >> MQ's filesystem will be laid out following the JES Filesystem >> Layout for Unbundled Software >> . >> || >> >> >> | >> |-------- etc >> | | >> | |-mq [MQ etc files] >> | >> |-------- var >> | | >> | |- install [contains installer information] >> | | >> | |-mq [used by the server for storing data] >> | >> |-------- mq >> | |-------- bin [MQ executables] >> | | | >> | | |- sparcv9 (amd64) [64 bit solaris executables] >> | | >> | |-------- lib [MQ jar files and libraries] >> | | | >> | | |- sparcv9 (amd64) [64 bit libraries for the MQ C API] >> | | >> | |-------- include [C-API file system headers] >> | | >> | |-------- lib64 [note: linux libs used instead of sparcv9] >> | | >> | |-------- examples [demos] >> | >> |-------- install >> | >> |- open installer implementation and jar files >> >> >> For more details and specific locations for each file >> installed by MQ see the MQ 4.3 Filesystem and Packaging >> specification >> . >> >> >> *_mquninstall[.bat]_* - script to improve uninstall experience >> >> The installer places the script to uninstall the product in: >> //var/install/contents/mq/uninstaller/ >> >> A low level install script (used by the mq installer) is >> located at: >> //install/bin/uninstaller/ >> >> While we do document the location of the uninstaller, it is >> difficult to find and users often attempt to uninstall with >> the wrong uninstaller executable. >> >> For this release, we are adding a new script (or bat file) >> called /mquninstall/ that is being placed in the >> //mq/bin/ directory. This will will only be in >> OpenMQ bundles for this release (it will not be available in >> package based installs). >> >> >> *_JMX Administration API changes_ * - minimal JMX attribute and >> CompositeData changes >> >> The following changes will be made to the JMX monitoring api: >> >> * A new attribute NextMessageID will be added to >> consumers and destinations >> * A new attribute NumMsgsPending to consumers >> >> The specific changes are: >> >> * DestinationMonitorMBean >> >> *New Attributes:* >> Name Set/Get Type Description >> NextMessageID G String JMS Message Id of the next >> message to be sent to any consumer >> >> * ConsumerMonitorMBean: >> >> *new Keys for Composite Data* >> Key Value Type Description >> NextMessageID String JMS Message Id of the next >> message to be sent to this consumer >> NumMsgsPending Long The number of messages which have >> been sent to this consumer but have not been >> acknowledged. They may either be queued for delivery or >> delivered to the consumer >> >> >> >> *_Administration API (imqcmd) output changes_ * - imqcmd output >> changes for durable subscribers >> >> *Note: the output returned from this application has a >> classification of uncommitted.* >> >> This changes the output of the command imqcmd list dur to >> list all destinations (and include a directory name) if the >> -d is omitted. The following examples show the ouptut changes: >> >> * Output when listing durables when a destination passed >> in on the command line. (Unchanged from previous releases) >> >> /imqcmd list dur -d mydest / >> >> || >> >> Listing all durable subscriptions on the topic 'mydest' >> on the broker specified by: >> >> ------------------------- >> Host Primary Port >> ------------------------- >> localhost 7676 >> >> --------------------------------------------------------------------------- >> Durable Sub. Name Client ID Number of Messages Durable Sub. State - >> --------------------------------------------------------------------------- >> mydn mycid 0 INACTIVE - >> >> Successfully listed durable subscriptions. >> >> * Output when listing durables when a destination is not >> provided on the command line (adds new column >> DestinationName) >> >> /imqcmd list dur -- listing all destinations/ >> >> >> |Listing all durable subscriptions >> ------------------------- >> Host Primary Port >> ------------------------- >> localhost 7676 >> >> ------------------------------------------------------------------------------------------ >> Durable Sub. Name Client ID *Destination Name* Number of Messages Durable Sub. State >> ------------------------------------------------------------------------------------------ >> 456 123 **.foo* 0 INACTIVE >> mydn mycid *mydest* 0 INACTIVE >> >> Successfully listed durable subscriptions. >> >> | >> >> *_Additional Installation Imported interfaces_ * >> >> The windows Installer.vbs script now uses the following >> variables to locate a JRE for the installer: >> >> >> * /HKLM\SOFTWARE\JavaSoft\Java Runtime >> Environment\CurrentVersion/ >> * /HKLM\SOFTWARE\JavaSoft\Java Runtime >> Environment\\JavaHome/ >> >> During installation, the installer will first attempt to use >> the jdk (if any) which was passed into the installation >> script, if no jdk is passed in it will look for a jre >> installed as part of the bundle, if no jre is found it will >> look at the keys to find the current JDK and its javahome. >> >> *_Additional Logging Messages_ * >> >> Some bug fixes require the addition or modification of log >> messages. No change was made in the format of those messages. >> >> >> Imported/Exported Intefaces >> >> *Exported Interfaces* >> Interface Classification Comments >> imqcmd Ouput Uncommitted Modifies an existing interface to >> support listing of all durables including their destination. See >> specific changes above. >> MQ MBean Attributes names Committed Modifies an existing >> interface to add support for NextMessageID method. See specific >> changes above >> MQ MBean Lookup keys for CompositeData Committed Modifies an >> existing interface to add support for NextMessageID method and >> NumMsgsPending. See specific changes above. >> Unbundled Filesystem Layout Committed *New Interface.* >> >> Creates a new filesystem layout for the product when it is not >> shipped with native packaging. See the Filesystem Layout >> specification >> >> >> Broker Log Infomation Uncommitted Modified an existing >> interface by adding new log messages (no format changes) >> UMS Protocol Committed *New Interface.* >> >> Defines the protocol for the new ums service.See the UMS Protocol >> Specification >> >> >> UMS Configuration Committed *New Interface.* >> >> Defines the configuration properties for the new ums service. See >> the UMS Configuration Specification >> >> >> imqums.war Committed *New Interface.* >> >> Defines the name of the war file used for deploying the new ums >> service. See specific changes above. >> >> /bin/mqunistall[.bat] Committed *New Interface.* >> >> A new script file which is available only on the new openMQ >> bundles that makes it easier for users to find the uninstaller. >> See specific changes above. >> >> >> *Imported Interfaces* >> Interface Classification Comments >> HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion >> Standard *New Interface* >> >> Location of the latest release of the JRE on a windows system. >> >> HKLM\SOFTWARE\Java Soft\Java Runtime >> Environment\\JavaHome Standard *New Interface* >> >> Location of the java home for a release of the JRE on a windows >> system. >> >> >> >> >> References >> >> *Current Release*: >> >> Message Queue 4.3 feature functional specifications: >> >> * UMS protocol >> >> * UMS configuration specification >> >> * MQ Filesystem Layout and packaging specification for Robin >> >> >> >> *Previous Release*: >> >> Message Queue 4.2 (Harrier) LSARC case: >> http://sac.sfbay.sun.com/arc/LSARC/2008/387 >> >> >> >> > --Boundary_(ID_+CQVixKVk/Q0KB5cG1OVDg) Content-type: text/html; charset=ISO-8859-1 Content-transfer-encoding: 7BIT
Looking through this case today, I notice that the UMS specification is hosted on an internal machine, and the onepager links to an internal machine. Since this is an open case, the specs are not available to outside ARC members.

A copy of the specification is attached in the zip file I attached to the original fast track email and the data is in the case directory. Is there also another place I should place it.

Isn't there a public or FOSS interface available to support .net, Python and Ajax clients?

For JMS, not really.  In general each JMS provider comes up with their own api's for .net, etc. 

There is a general api called STOMP which can be a bridge into JMS.  and we have provided an example of using it on the openMQ site, but the licensing on the product prevent us from putting it in the product.  Additionally its a more complex api.

To login to the service to send a message with Stomp:
            Console.WriteLine("CONNECT ...");
            streamWriter.WriteLine("CONNECT");
            streamWriter.WriteLine("login:guest");
            streamWriter.WriteLine("passcode:guest");
            streamWriter.WriteLine("");
            streamWriter.Write('\0');
            streamWriter.Flush();

To long into the server to send a message with UMS:
             POST /ums/simple?service=login&user=guest&password=guest HTTP/1.1

NOTE: Ums (although part of the openMQ/SJSMQ project) is generic and will actually work with other providers.



Tom Childers wrote:
Hi, Linda.

Looking through this case today, I notice that the UMS specification is hosted on an internal machine, and the onepager links to an internal machine. Since this is an open case, the specs are not available to outside ARC members.

Apparently this is a new interface that we created from scratch.  Isn't there a public or FOSS interface available to support .net, Python and Ajax clients?

Everything else looks pretty straightforward.
-tdc

On Oct 22, 2008, at 9:06 PM, Linda Schneider wrote:

I'm sponsoring the following proposal for fast-track approval. The timer is set for 10/28/2008.

Proposed release binding is minor.

Fastrack content is [now] included below (it will look better if viewed as html)

The attached zip file [additional.zip] contains copies of the functional specs referenced in this document.
The document (and related files) is also available at:  http://sac.sfbay/arc/LSARC/2008/648/robin.html

FastTrack: OpenMQ / Sun Java System Message Queue 4.3 (Robin)

Sponsor: Linda Schneider

Release Binding: Minor

This is a FastTrack request for minor interface changes in Open Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). Robin is a maintenance release to Message Queue 4.2 (LSARC/2008/387). It includes bug fixes and a small number of minor enhancements.

This FastTrack adds modifies several committed and uncommitted exported interfaces and adds two new imported interfaces. It does not change the classification or remove any existing interface.



Overview of Changes

Several changes were added to 4.3 which impact the product's interface:

  • A REST style API was added to allow messages to be produced or consumed to the MQ provider
  • A new bundling and layout scheme was added to support the product installed by our new Zip based installer (which will also be used in future releases for IPS packages)
  • Minor administration changes
  • Minor modifications to the windows installer
  • Addition of a command to make it easier to locate the uninstaller on the OpenMQ packages.

Public interface changes

  1. New Exported Interfaces: Creation of the Universal Message Service (UMS) API:
    • The UMS Protocol used by applications to connect to the service.
    • The UMS Configuration which contains the set of configuration parameters for the service.
    • A new war file (imqums.war) containing the servlet required by UMS.
  2. New Exported Interface: Creation of a the new filesystem layout for use by the new packages. This layout will also be used for our new install bundles specifically:
    • Our OpenMQ product
    • Our AIX product (the platform is new to 4.3)
    No changes have been made to our existing packages used in earlier releases. (They will still use the old filesystem laytout)
  3. New Exported Interface: A new uninstall bat/shell script has been added as a shortcut for uninstalling the openMQ-only release.
  4. Modified Exported Interface: Minor changes have been made to JMX to add additional information for destinations and consumers.
  5. New Imported Interfaces: Installation of the product on windows (both for SJSMQ and OpenMQ) now uses Java registry keys as a fallback to locate a JRE to use to start the installer.

Private interface changess

Additional changes have been made to private interfaces:

  1. Modified Interface: Output of imqcmd. This interface is Uncommitted.


Descriptions of Changes


Universal Message Service (UMS) - a REST style API

The Universal Message Service is a simple REST based API that allows any HTTP capable device to access Message Queue. This allows clients written in languages such as c-sharp and phython to send and receive messages.

A new web component (imqums.war) can be deployed on any web container. That component serves as a bridge between the ums client and the JMS provider. The ums client sends the ums protocol (which uses http posts) to connect to the imqums service. That service uses standard JMS apis to connect to the MQ server (the broker).

<ums.gif>

Client->web component protocol

The protocol has two types of messages service requests (messages sent to the messaging system) and service responses (responses received from the messaging system). There are also two services (XML and basic text) which are provided in this release.


The API supports the following commands:

  • login logs into the system and creates a UMS session (note: the password must be sent in plaintext since it is going as part of the http command line, however use of SSL is recommended).
  • send Sends a message (which will become a JMS message) to MQ.
  • receive Receive a message from MQ.
  • commit Commit a transaction (provided the UMS session is transacted).
  • rollback Rollback a transaction. (provided the UMS session is transacted).
  • close Close the UMS session.

All messages are request/response:

Service Requests
The http POST method is used for all interaction with the UMS. Each protocol message is represented with the following syntax:

http://host:port/<ums-context-root>/<service>[?<query_string_if_simple>];

Where:

  • ums_conext-root: the location where the WAR file was deployed
  • simple: the type of service used (simple or XML)
  • query_string: used for the simple service. Provides a set of name value pairs separated by & which specify information such as the service type, messaging domain, and destination name
For the Messages:
  • For XML messages, the body contains the command information in XML format
  • For the simple service, the body is empty (since the protocol information in in the URL)

Service Responses

For the XML service, the body of the HTTP request returns a SOAP message containing return information. For the simple message service, the body of the message may contain some specific return information.

Lower level details of the Protocol are found in the UMS Protocol description.

UMS configuration
When the war file is deployed, several configuration options are available for the servlet including password to be used to the broker, how often to poll for messages and the broker address. Specific configuration parameters are found in the UMS Configuration specification.

Filesystem layout and packaging change - support for new packages which can handle multi-install

In MQ 4.3 we are adding a new zip based packaging bundle. In the following release (Crane), we will be replacing the zip bundles for IPS packages. This layout is the one we will be using for going forward for all future unbundled products (either zip based or IPS).

Note: Our current SVR4 or Linux RPM based packaging is unaffected by these changes.

MQ's filesystem will be laid out following the JES Filesystem Layout for Unbundled Software. 

<install_home>
   |
   |-------- etc
   |          |
   |          |-mq [MQ etc files]
   |
   |-------- var
   |          |
   |          |- install [contains installer information]
   |          |
   |          |-mq [used by the server for storing data]
   |
   |-------- mq
   |         |-------- bin   [MQ executables]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit solaris executables]
   |         |
   |         |-------- lib [MQ jar files and libraries]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit libraries for the MQ C API]
   |         |
   |         |-------- include [C-API file system headers]
   |         |
   |         |-------- lib64  [note: linux libs used instead of sparcv9]
   |         |
   |         |-------- examples [demos]
   |         
   |-------- install
               |
               |- open installer implementation and jar files
For more details and specific locations for each file installed by MQ see the MQ 4.3 Filesystem and Packaging specification.


mquninstall[.bat] - script to improve uninstall experience

The installer places the script to uninstall the product in:
<install_home>/var/install/contents/mq/uninstaller

A low level install script (used by the mq installer) is located at:
<install_home>/install/bin/uninstaller

While we do document the location of the uninstaller, it is difficult to find and users often attempt to uninstall with the wrong uninstaller executable.

For this release, we are adding a new script (or bat file) called mquninstall that is being placed in the <install_home>/mq/bin directory. This will will only be in OpenMQ bundles for this release (it will not be available in package based installs).


JMX Administration API changes - minimal JMX attribute and CompositeData changes

The following changes will be made to the JMX monitoring api:

  • A new attribute NextMessageID will be added to consumers and destinations
  • A new attribute NumMsgsPending to consumers

The specific changes are:

  • DestinationMonitorMBean

    New Attributes:
    Name Set/Get Type Description
    NextMessageID G String JMS Message Id of the next message to be sent to any consumer

  • ConsumerMonitorMBean:

    new Keys for Composite Data
    Key Value Type Description
    NextMessageID String JMS Message Id of the next message to be sent to this consumer
    NumMsgsPending Long The number of messages which have been sent to this consumer but have not been acknowledged. They may either be queued for delivery or delivered to the consumer



Administration API (imqcmd) output changes - imqcmd output changes for durable subscribers

Note: the output returned from this application has a classification of uncommitted.

This changes the output of the command imqcmd list dur to list all destinations (and include a directory name) if the -d is omitted. The following examples show the ouptut changes:

  • Output when listing durables when a destination passed in on the command line. (Unchanged from previous releases)

    imqcmd list dur -d mydest 

    Listing all durable subscriptions on the topic 'mydest'
on the broker specified by:

-------------------------
Host         Primary Port
-------------------------
localhost    7676

---------------------------------------------------------------------------
Durable Sub. Name   Client ID   Number of Messages   Durable Sub. State   -
---------------------------------------------------------------------------
mydn                mycid       0                    INACTIVE             -

Successfully listed durable subscriptions.
  • Output when listing durables when a destination is not provided on the command line (adds new column DestinationName)

    imqcmd list dur -- listing all destinations


    Listing all durable subscriptions
-------------------------
Host         Primary Port
-------------------------
localhost    7676

------------------------------------------------------------------------------------------
Durable Sub. Name   Client ID   Destination Name   Number of Messages   Durable Sub. State
------------------------------------------------------------------------------------------
456                 123         *.foo              0                    INACTIVE
mydn                mycid       mydest             0                    INACTIVE

Successfully listed durable subscriptions.
Additional Installation Imported interfaces

The windows Installer.vbs script now uses the following variables to locate a JRE for the installer:


  • HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion
  • HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\<version>\JavaHome

During installation, the installer will first attempt to use the jdk (if any) which was passed into the installation script, if no jdk is passed in it will look for a jre installed as part of the bundle, if no jre is found it will look at the keys to find the current JDK and its javahome.

Additional Logging Messages

Some bug fixes require the addition or modification of log messages. No change was made in the format of those messages.


Imported/Exported Intefaces

Exported Interfaces
Interface Classification Comments
imqcmd Ouput Uncommitted Modifies an existing interface to support listing of all durables including their destination. See specific changes above.
MQ MBean Attributes names Committed Modifies an existing interface to add support for NextMessageID method. See specific changes above
MQ MBean Lookup keys for CompositeData Committed Modifies an existing interface to add support for NextMessageID method and NumMsgsPending. See specific changes above.
Unbundled Filesystem Layout Committed New Interface.

Creates a new filesystem layout for the product when it is not shipped with native packaging. See the Filesystem Layout specification
Broker Log Infomation Uncommitted Modified an existing interface by adding new log messages (no format changes)
UMS Protocol Committed New Interface.

Defines the protocol for the new ums service.See the UMS Protocol Specification
UMS Configuration Committed New Interface.

Defines the configuration properties for the new ums service. See the UMS Configuration Specification
imqums.war Committed New Interface.

Defines the name of the war file used for deploying the new ums service. See specific changes above.
<mq_home>/bin/mqunistall[.bat] Committed New Interface.

A new script file which is available only on the new openMQ bundles that makes it easier for users to find the uninstaller. See specific changes above.

Imported Interfaces
Interface Classification Comments
HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion Standard New Interface

Location of the latest release of the JRE on a windows system.
HKLM\SOFTWARE\Java Soft\Java Runtime Environment\<version>\JavaHome Standard New Interface

Location of the java home for a release of the JRE on a windows system.




References

Current Release:

Message Queue 4.3 feature functional specifications:


Previous Release:

Message Queue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387



<additional.zip>


--Boundary_(ID_+CQVixKVk/Q0KB5cG1OVDg)-- From tom.childers@sun.com Wed Oct 29 12:30:23 2008 Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id m9TJUNUj021020 for ; Wed, 29 Oct 2008 12:30:23 -0700 (PDT) Received: from sca-es-mail-1.sun.com (sca-es-mail-1.Sun.COM [192.18.43.132]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id m9TJUNXj062221 for ; Wed, 29 Oct 2008 12:30:23 -0700 (PDT) Received: from fe-sfbay-09.sun.com ([192.18.43.129]) by sca-es-mail-1.sun.com (8.13.7+Sun/8.12.9) with ESMTP id m9TJUILK015156 for ; Wed, 29 Oct 2008 12:30:18 -0700 (PDT) Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K9I00301LSJRJ00@fe-sfbay-09.sun.com> (original mail from tom.childers@sun.com) for LSARC-ext@sac.sfbay.sun.com; Wed, 29 Oct 2008 12:30:18 -0700 (PDT) Received: from [192.168.15.2] ([75.101.10.233]) by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K9I00HVKM63U4D0@fe-sfbay-09.sun.com> for LSARC-ext@sac.sfbay.sun.com; Wed, 29 Oct 2008 12:30:12 -0700 (PDT) Date: Wed, 29 Oct 2008 12:29:59 -0700 From: Tom Childers Subject: Re: OpenMQ/SJSMQ 4.3 (Robin) [LSARC/2008/648 FastTrack timeout 10/28/2008] In-reply-to: <49074DBE.4060409@sun.com> Sender: Thomas.Childers@sun.com To: Linda Schneider Cc: LSARC-ext@sac.sfbay.sun.com Message-id: <20087980-C9B1-46D3-81C6-EF96896DB917@sun.com> MIME-version: 1.0 X-Mailer: Apple Mail (2.928.1) Content-type: multipart/alternative; boundary="Boundary_(ID_cZoV+xdxOx7urmezGPUr9g)" References: <48FFF85A.3080701@sun.com> <9B1B74E8-EDEF-4E90-A58F-A057BA3C9480@sun.com> <49074DBE.4060409@sun.com> Status: RO Content-Length: 45419 --Boundary_(ID_cZoV+xdxOx7urmezGPUr9g) Content-type: text/plain; delsp=yes; format=flowed; charset=US-ASCII Content-transfer-encoding: 7BIT Hi, Linda. The external link is http://www.opensolaris.org/os/community/arc/caselog/2008/648/ , and when I look at the onepager there, it refers to an internal machine. For some reason, the materials don't show up, so we perhaps have a permissions problem. The links in the files should be made into relative links, so we don't have internal Sun machine names visible. I'm happy with your comments on the FOSS issue, and I have no problem closing this case as approved. -tdc On Oct 28, 2008, at 10:37 AM, Linda Schneider wrote: > > Looking through this case today, I notice that the UMS specification > is hosted on an internal machine, and the onepager links to an > internal machine. Since this is an open case, the specs are not > available to outside ARC members. > > A copy of the specification is attached in the zip file I attached > to the original fast track email and the data is in the case > directory. Is there also another place I should place it. > > Isn't there a public or FOSS interface available to support .net, > Python and Ajax clients? > > For JMS, not really. In general each JMS provider comes up with > their own api's for .net, etc. > > There is a general api called STOMP which can be a bridge into JMS. > and we have provided an example of using it on the openMQ site, but > the licensing on the product prevent us from putting it in the > product. Additionally its a more complex api. > > To login to the service to send a message with Stomp: > Console.WriteLine("CONNECT ..."); > streamWriter.WriteLine("CONNECT"); > streamWriter.WriteLine("login:guest"); > streamWriter.WriteLine("passcode:guest"); > streamWriter.WriteLine(""); > streamWriter.Write('\0'); > streamWriter.Flush(); > > To long into the server to send a message with UMS: > POST /ums/simple? > service=login&user=guest&password=guest HTTP/1.1 > > NOTE: Ums (although part of the openMQ/SJSMQ project) is generic and > will actually work with other providers. > > > > Tom Childers wrote: >> >> Hi, Linda. >> >> Looking through this case today, I notice that the UMS >> specification is hosted on an internal machine, and the onepager >> links to an internal machine. Since this is an open case, the specs >> are not available to outside ARC members. >> >> Apparently this is a new interface that we created from scratch. >> Isn't there a public or FOSS interface available to support .net, >> Python and Ajax clients? >> >> Everything else looks pretty straightforward. >> -tdc >> >> On Oct 22, 2008, at 9:06 PM, Linda Schneider wrote: >> >>> I'm sponsoring the following proposal for fast-track approval. The >>> timer is set for 10/28/2008. >>> >>> Proposed release binding is minor. >>> >>> Fastrack content is [now] included below (it will look better if >>> viewed as html) >>> >>> The attached zip file [additional.zip] contains copies of the >>> functional specs referenced in this document. >>> The document (and related files) is also available at: http://sac.sfbay/arc/LSARC/2008/648/robin.html >>> >>> FastTrack: OpenMQ / Sun Java System Message Queue 4.3 (Robin) >>> Sponsor: Linda Schneider >>> >>> Release Binding: Minor >>> >>> This is a FastTrack request for minor interface changes in Open >>> Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). >>> Robin is a maintenance release to Message Queue 4.2 (LSARC/ >>> 2008/387). It includes bug fixes and a small number of minor >>> enhancements. >>> >>> This FastTrack adds modifies several committed and uncommitted >>> exported interfaces and adds two new imported interfaces. It does >>> not change the classification or remove any existing interface. >>> >>> >>> >>> Overview of Changes >>> >>> Several changes were added to 4.3 which impact the product's >>> interface: >>> >>> A REST style API was added to allow messages to be produced or >>> consumed to the MQ provider >>> A new bundling and layout scheme was added to support the product >>> installed by our new Zip based installer (which will also be used >>> in future releases for IPS packages) >>> Minor administration changes >>> Minor modifications to the windows installer >>> Addition of a command to make it easier to locate the uninstaller >>> on the OpenMQ packages. >>> Public interface changes >>> >>> New Exported Interfaces: Creation of the Universal Message Service >>> (UMS) API: >>> The UMS Protocol used by applications to connect to the service. >>> The UMS Configuration which contains the set of configuration >>> parameters for the service. >>> A new war file (imqums.war) containing the servlet required by UMS. >>> New Exported Interface: Creation of a the new filesystem layout >>> for use by the new packages. This layout will also be used for our >>> new install bundles specifically: >>> Our OpenMQ product >>> Our AIX product (the platform is new to 4.3) >>> No changes have been made to our existing packages used in earlier >>> releases. (They will still use the old filesystem laytout) >>> New Exported Interface: A new uninstall bat/shell script has been >>> added as a shortcut for uninstalling the openMQ-only release. >>> Modified Exported Interface: Minor changes have been made to JMX >>> to add additional information for destinations and consumers. >>> New Imported Interfaces: Installation of the product on windows >>> (both for SJSMQ and OpenMQ) now uses Java registry keys as a >>> fallback to locate a JRE to use to start the installer. >>> Private interface changess >>> >>> Additional changes have been made to private interfaces: >>> >>> Modified Interface: Output of imqcmd. This interface is Uncommitted. >>> >>> >>> Descriptions of Changes >>> >>> >>> Universal Message Service (UMS) - a REST style API >>> The Universal Message Service is a simple REST based API that >>> allows any HTTP capable device to access Message Queue. This >>> allows clients written in languages such as c-sharp and phython to >>> send and receive messages. >>> >>> A new web component (imqums.war) can be deployed on any web >>> container. That component serves as a bridge between the ums >>> client and the JMS provider. The ums client sends the ums protocol >>> (which uses http posts) to connect to the imqums service. That >>> service uses standard JMS apis to connect to the MQ server (the >>> broker). >>> >>> >>> >>> Client->web component protocol >>> The protocol has two types of messages service requests (messages >>> sent to the messaging system) and service responses (responses >>> received from the messaging system). There are also two services >>> (XML and basic text) which are provided in this release. >>> >>> >>> The API supports the following commands: >>> >>> login logs into the system and creates a UMS session (note: the >>> password must be sent in plaintext since it is going as part of >>> the http command line, however use of SSL is recommended). >>> send Sends a message (which will become a JMS message) to MQ. >>> receive Receive a message from MQ. >>> commit Commit a transaction (provided the UMS session is >>> transacted). >>> rollback Rollback a transaction. (provided the UMS session is >>> transacted). >>> close Close the UMS session. >>> All messages are request/response: >>> >>> Service Requests >>> The http POST method is used for all interaction with the UMS. >>> Each protocol message is represented with the following syntax: >>> http://host:port//[? >>> ]; >>> >>> Where: >>> >>> ums_conext-root: the location where the WAR file was deployed >>> simple: the type of service used (simple or XML) >>> query_string: used for the simple service. Provides a set of name >>> value pairs separated by & which specify information such as the >>> service type, messaging domain, and destination name >>> For the Messages: >>> For XML messages, the body contains the command information in XML >>> format >>> For the simple service, the body is empty (since the protocol >>> information in in the URL) >>> >>> Service Responses >>> For the XML service, the body of the HTTP request returns a SOAP >>> message containing return information. For the simple message >>> service, the body of the message may contain some specific return >>> information. >>> >>> Lower level details of the Protocol are found in the UMS Protocol >>> description. >>> >>> UMS configuration >>> When the war file is deployed, several configuration options are >>> available for the servlet including password to be used to the >>> broker, how often to poll for messages and the broker address. >>> Specific configuration parameters are found in the UMS >>> Configuration specification. >>> >>> Filesystem layout and packaging change - support for new packages >>> which can handle multi-install >>> In MQ 4.3 we are adding a new zip based packaging bundle. In the >>> following release (Crane), we will be replacing the zip bundles >>> for IPS packages. This layout is the one we will be using for >>> going forward for all future unbundled products (either zip based >>> or IPS). >>> >>> Note: Our current SVR4 or Linux RPM based packaging is unaffected >>> by these changes. >>> >>> MQ's filesystem will be laid out following the JES Filesystem >>> Layout for Unbundled Software. >>> >>> >>> | >>> |-------- etc >>> | | >>> | |-mq [MQ etc files] >>> | >>> |-------- var >>> | | >>> | |- install [contains installer information] >>> | | >>> | |-mq [used by the server for storing data] >>> | >>> |-------- mq >>> | |-------- bin [MQ executables] >>> | | | >>> | | |- sparcv9 (amd64) [64 bit solaris >>> executables] >>> | | >>> | |-------- lib [MQ jar files and libraries] >>> | | | >>> | | |- sparcv9 (amd64) [64 bit libraries for >>> the MQ C API] >>> | | >>> | |-------- include [C-API file system headers] >>> | | >>> | |-------- lib64 [note: linux libs used instead of >>> sparcv9] >>> | | >>> | |-------- examples [demos] >>> | >>> |-------- install >>> | >>> |- open installer implementation and jar files >>> >>> >>> For more details and specific locations for each file installed by >>> MQ see the MQ 4.3 Filesystem and Packaging specification. >>> >>> >>> mquninstall[.bat] - script to improve uninstall experience >>> The installer places the script to uninstall the product in: >>> /var/install/contents/mq/uninstaller >>> >>> A low level install script (used by the mq installer) is located at: >>> /install/bin/uninstaller >>> >>> While we do document the location of the uninstaller, it is >>> difficult to find and users often attempt to uninstall with the >>> wrong uninstaller executable. >>> >>> For this release, we are adding a new script (or bat file) called >>> mquninstall that is being placed in the /mq/bin >>> directory. This will will only be in OpenMQ bundles for this >>> release (it will not be available in package based installs). >>> >>> >>> JMX Administration API changes - minimal JMX attribute and >>> CompositeData changes >>> The following changes will be made to the JMX monitoring api: >>> >>> A new attribute NextMessageID will be added to consumers and >>> destinations >>> A new attribute NumMsgsPending to consumers >>> The specific changes are: >>> >>> DestinationMonitorMBean >>> New Attributes: >>> Name Set/Get Type Description >>> NextMessageID G String JMS Message Id of the next message to be >>> sent to any consumer >>> ConsumerMonitorMBean: >>> new Keys for Composite Data >>> Key Value Type Description >>> NextMessageID String JMS Message Id of the next message to be sent >>> to this consumer >>> NumMsgsPending Long The number of messages which have been sent to >>> this consumer but have not been acknowledged. They may either be >>> queued for delivery or delivered to the consumer >>> >>> >>> Administration API (imqcmd) output changes - imqcmd output changes >>> for durable subscribers >>> Note: the output returned from this application has a >>> classification of uncommitted. >>> >>> This changes the output of the command imqcmd list dur to list all >>> destinations (and include a directory name) if the -d is omitted. >>> The following examples show the ouptut changes: >>> >>> Output when listing durables when a destination passed in on the >>> command line. (Unchanged from previous releases) >>> imqcmd list dur -d mydest >>> >>> >>> Listing all durable subscriptions on the topic 'mydest' >>> on the broker specified by: >>> >>> ------------------------- >>> Host Primary Port >>> ------------------------- >>> localhost 7676 >>> >>> --------------------------------------------------------------------------- >>> Durable Sub. Name Client ID Number of Messages Durable Sub. >>> State - >>> --------------------------------------------------------------------------- >>> mydn mycid 0 >>> INACTIVE - >>> >>> Successfully listed durable subscriptions. >>> >>> Output when listing durables when a destination is not provided on >>> the command line (adds new column DestinationName) >>> imqcmd list dur -- listing all destinations >>> >>> >>> Listing all durable subscriptions >>> ------------------------- >>> Host Primary Port >>> ------------------------- >>> localhost 7676 >>> >>> ------------------------------------------------------------------------------------------ >>> Durable Sub. Name Client ID Destination Name Number of >>> Messages Durable Sub. State >>> ------------------------------------------------------------------------------------------ >>> 456 123 *.foo >>> 0 INACTIVE >>> mydn mycid mydest >>> 0 INACTIVE >>> >>> Successfully listed durable subscriptions. >>> >>> Additional Installation Imported interfaces >>> The windows Installer.vbs script now uses the following variables >>> to locate a JRE for the installer: >>> >>> >>> HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion >>> HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\\JavaHome >>> >>> During installation, the installer will first attempt to use the >>> jdk (if any) which was passed into the installation script, if no >>> jdk is passed in it will look for a jre installed as part of the >>> bundle, if no jre is found it will look at the keys to find the >>> current JDK and its javahome. >>> >>> Additional Logging Messages >>> Some bug fixes require the addition or modification of log >>> messages. No change was made in the format of those messages. >>> >>> >>> Imported/Exported Intefaces >>> >>> Exported Interfaces >>> Interface Classification Comments >>> imqcmd Ouput Uncommitted Modifies an existing interface to >>> support listing of all durables including their destination. See >>> specific changes above. >>> MQ MBean Attributes names Committed Modifies an existing >>> interface to add support for NextMessageID method. See specific >>> changes above >>> MQ MBean Lookup keys for CompositeData Committed Modifies an >>> existing interface to add support for NextMessageID method and >>> NumMsgsPending. See specific changes above. >>> Unbundled Filesystem Layout Committed New Interface. >>> Creates a new filesystem layout for the product when it is not >>> shipped with native packaging. See the Filesystem Layout >>> specification >>> >>> Broker Log Infomation Uncommitted Modified an existing interface >>> by adding new log messages (no format changes) >>> UMS Protocol Committed New Interface. >>> Defines the protocol for the new ums service.See the UMS Protocol >>> Specification >>> >>> UMS Configuration Committed New Interface. >>> Defines the configuration properties for the new ums service. See >>> the UMS Configuration Specification >>> >>> imqums.war Committed New Interface. >>> Defines the name of the war file used for deploying the new ums >>> service. See specific changes above. >>> >>> /bin/mqunistall[.bat] Committed New Interface. >>> A new script file which is available only on the new openMQ >>> bundles that makes it easier for users to find the uninstaller. >>> See specific changes above. >>> >>> >>> Imported Interfaces >>> Interface Classification Comments >>> HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion >>> Standard New Interface >>> Location of the latest release of the JRE on a windows system. >>> >>> HKLM\SOFTWARE\Java Soft\Java Runtime Environment\ >>> \JavaHome Standard New Interface >>> Location of the java home for a release of the JRE on a windows >>> system. >>> >>> >>> >>> >>> References >>> >>> Current Release: >>> >>> Message Queue 4.3 feature functional specifications: >>> >>> UMS protocol >>> UMS configuration specification >>> MQ Filesystem Layout and packaging specification for Robin >>> >>> Previous Release: >>> >>> Message Queue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387 >>> >>> >>> >>> >> > --Boundary_(ID_cZoV+xdxOx7urmezGPUr9g) Content-type: text/html; charset=US-ASCII Content-transfer-encoding: QUOTED-PRINTABLE Hi, Linda.

The external link is http://www.opensolaris.org/os/commu= nity/arc/caselog/2008/648/, and when I look at the onepager there= , it refers to an internal machine. For some reason, the materials do= n't show up, so we perhaps have a permissions problem.

=
The links in the files should be made into relative links,= so we don't have internal Sun machine names visible.

<= /div>
I'm happy with your comments on the FOSS issue, and I have = no problem closing this case as approved.
-tdc

On Oct 28, 2008, at 10:37 AM, Linda Schnei= der wrote:


=
Looking through this case today, I notice that the UMS speci= fication is hosted on an internal machine, and the onepager links to = an internal machine. Since this is an open case, the specs are not av= ailable to outside ARC members.

A copy of = the specification is attached in the zip file I attached to the origi= nal fast track email and the data is in the case directory. Is there = also another place I should place it.

Isn't there a publi= c or FOSS interface available to support .net, Python and Ajax client= s?

For JMS, not really.  In general each JMS provi= der comes up with their own api's for .net, etc. 

Ther= e is a general api called STOMP which can be a bridge into JMS. = and we have provided an example of using it on the openMQ site, but = the licensing on the product prevent us from putting it in the produc= t.  Additionally its a more complex api.

To login to th= e service to send a message with Stomp:
   = ;         Console.WriteLine("= CONNECT ...");
        &n= bsp;   streamWriter.WriteLine("CONNECT");
  &= nbsp;         streamWriter.Wr= iteLine("login:guest");
       = ;     streamWriter.WriteLine("passcode:guest");            = streamWriter.WriteLine("");
      =       streamWriter.Write('\0');
 &n= bsp;          streamWrit= er.Flush();

To long into the server to send a message wi= th UMS:
      &= nbsp;      POST /ums/simple?service=3Dlogin&= amp;user=3Dguest&password=3Dguest HTTP/1.1
=

NOTE: Ums (although part of the openMQ/SJSMQ= project) is generic and will actually work with other providers.
=


Tom Childers wrote:
Hi, Linda.
<= br>
Looking through this case today, I notice that the = UMS specification is hosted on an internal machine, and the onepager = links to an internal machine. Since this is an open case, the specs a= re not available to outside ARC members.

Apparently this is a new interface that we created from scratch. &= nbsp;Isn't there a public or FOSS interface available to support .net= , Python and Ajax clients?

Everything = else looks pretty straightforward.
-tdc

=
On Oct 22, 2008, at 9:06 PM, Linda Schneider wrote:
I'm sponsoring the f= ollowing proposal for fast-track approval. The timer is set for 10/28= /2008.

Proposed release binding is minor.

F= astrack content is [now] included below (it will look better if viewe= d as html)

The attached zip file [additional.zip] contain= s copies of the functional specs referenced in this document.
The= document (and related files) is also available at:  http://sac.sfbay/arc/LSARC/2008/6= 48/robin.html

=

FastTrack: OpenMQ= / Sun Java System Message Queue 4.3 (Robin)

Sponsor: Linda= Schneider

Release Binding: Minor

= This is a FastTrack request for minor interface changes in Open Mess= age Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). Robin is = a maintenance release to Message Queue 4.2 (LSA= RC/2008/387). It includes bug fixes and a small number of minor e= nhancements.

This FastTrack adds modifies several committed an= d uncommitted exported interfaces and adds two new imported interface= s. It does not change the classification or remove any existing inter= face.


=

Overview of Changes

=
Several changes were added to 4.3 which impact the product's i= nterface:

=
  • A REST style API was added to allow m= essages to be produced or consumed to the MQ provider
    • <= li>A new bundling and layout scheme was added to support the product = installed by our new Zip based installer (which will also be used in = future releases for IPS packages)
  • Minor administrat= ion changes
  • Minor modifications to the windows inst= aller
  • Addition of a command to make it easier to lo= cate the uninstaller on the OpenMQ packages.

= Public interface changes

  1. New = Exported Interfaces: Creation of the Universal Message Servic= e (UMS) API:
    • The UMS Protocol used by applications to= connect to the service.
    • The UMS Configuration which contains t= he set of configuration parameters for the service.
      • =
    • A new war file (imqums.war) containing the servlet required by U= MS.
  2. New Expo= rted Interface: Creation of a the new filesystem layout for u= se by the new packages. This layout will also be used for our new ins= tall bundles specifically:
    • Our OpenM= Q product
    • Our AIX product (the platform is new = to 4.3)
    No changes have been made to our existi= ng packages used in earlier releases. (They will still use the old fi= lesystem laytout)
  3. New Exported Interface= : A new uninstall bat/shell script has been added as a shortcut f= or uninstalling the openMQ-only release.
  4. Mo= dified Exported Interface: Minor changes have been made to JM= X to add additional information for destinations and consumers.
    5. =
  5. New Imported Interfaces: Installation of = the product on windows (both for SJSMQ and OpenMQ) now uses Java regi= stry keys as a fallback to locate a JRE to use to start the installer= .

Private interface changess

Addit= ional changes have been made to private interfaces:

    =
  1. Modified Interface: Output of imqcmd. Thi= s interface is Uncommitted.


=

Descriptions of Changes


=
Universal Message Service (UMS) - a REST s= tyle API

The Universal Message Service is a simp= le REST based API that allows any HTTP capable device to access Messa= ge Queue. This allows clients written in languages such as c-sharp an= d phython to send and receive messages.

A new web component (i= mqums.war) can be deployed on any web container. That component serve= s as a bridge between the ums client and the JMS provider. The ums cl= ient sends the ums protocol (which uses http posts) to connect to the= imqums service. That service uses standard JMS apis to connect to th= e MQ server (the broker).

<ums.gif>

=
Client->web component protocol
=

The protocol has two types of messages service requests (messages = sent to the messaging system) and service responses (responses receiv= ed from the messaging system). There are also two services (XML and b= asic text) which are provided in this release.


The= API supports the following commands:

    =
  • login logs into the system and creates a UMS se= ssion (note: the password must be sent in plaintext since it is going= as part of the http command line, however use of SSL is recommended)= .
  • send Sends a message (which will = become a JMS message) to MQ.
  • receive= Receive a message from MQ.
  • commit C= ommit a transaction (provided the UMS session is transacted).
    • =
  • rollback Rollback a transaction. (provided = the UMS session is transacted).
  • close Close the UMS session.

All messages ar= e request/response:

= Service Requests
The http POST method i= s used for all interaction with the UMS. Each protocol message is rep= resented with the following syntax:

http://host:port/<ums-context-root>/<service>[?&l= t;query_string_if_simple>];

Where:

=
  • ums_conext-root: the location wh= ere the WAR file was deployed
  • simple= : the type of service used (simple or XML)
    • =
  • query_string: used for the simple service. Provides a= set of name value pairs separated by & which specify information= such as the service type, messaging domain, and destination name
For the Messages:
    =
  • For XML messages, the body contains the com= mand information in XML format
  • For the = simple service, the body is empty (since the protocol information in = in the URL)
<= br class=3D"webkit-block-placeholder">
=
Service Responses
=

For the XML service, the body of the HTTP re= quest returns a SOAP message containing return information. For the s= imple message service, the body of the message may contain some speci= fic return information.

Lower level details of the Protocol are found in the UMS Protocol description.

UMS configuration
Whe= n the war file is deployed, several configuration options are availab= le for the servlet including password to be used to the broker, how o= ften to poll for messages and the broker address. Specific configurat= ion parameters are found in the UMS Configu= ration specification.
=
Filesystem layout and packaging change - = support for new packages which can handle multi-install
=

In MQ 4.3 we are adding a new zip based packaging bundle. In= the following release (Crane), we will be replacing the zip bundles = for IPS packages. This layout is the one we will be using for going f= orward for all future unbundled products (either zip based or IPS).

Note: Our current SVR4 or Linux RPM based packaging is un= affected by these changes.

MQ's filesystem will be laid out fol= lowing the JES Filesys= tem Layout for Unbundled Software.

<= pre><install_home> | |-------- etc | | | |-mq [MQ etc files] | |-------- var | | | |- install [contains installer information] | | | |-mq [used by the server for storing data] | |-------- mq | |-------- bin [MQ executables] | | | | | |- sparcv9 (amd64) [64 bit solaris executable= s] | | | |-------- lib [MQ jar files and libraries] | | | | | |- sparcv9 (amd64) [64 bit libraries for the = MQ C API] | | | |-------- include [C-API file system headers] | | | |-------- lib64 [note: linux libs used instead of sparc= v9] | | | |-------- examples [demos] | =20 |-------- install | |- open installer implementation and jar files For more details and specific locations for each file = installed by MQ see the MQ 4.3 Filesystem a= nd Packaging specification.


mquninstall[.bat] - script to improve uninstall experi= ence

The installer places the script to uninstal= l the product in:
<install_home>/var/install/con= tents/mq/uninstaller

A low level install script (used by th= e mq installer) is located at:
<install_home>/in= stall/bin/uninstaller

While we do document the location of = the uninstaller, it is difficult to find and users often attempt to u= ninstall with the wrong uninstaller executable.

For this relea= se, we are adding a new script (or bat file) called mquninstall that is being placed in the <install_home>/mq/bin directo= ry. This will will only be in OpenMQ bundles for this release (it wil= l not be available in package based installs).

<= br class=3D"webkit-block-placeholder">
JMX Administration API changes - minim= al JMX attribute and CompositeData changes

The f= ollowing changes will be made to the JMX monitoring api:

=
  • A new attribute NextMessageID will be added= to consumers and destinations
  • A new attribute = NumMsgsPending to consumers

The specific cha= nges are:

  • DestinationMonitorMBe= an

    New Attributes: = = = = =
    Name Set/GetType Description
    NextMessageID GString JMS Message Id of= the next message to be sent to any consumer
    =

  • ConsumerMonitorMBean: =

    new Keys for Composite Data = Key Value Type Description = NextMessageID = String JMS Mes= sage Id of the next message to be sent to this consumer = Num= MsgsPending Long = The number of messages which have been sent to this consumer = but have not been acknowledged. They may either be queued for deliver= y or delivered to the consumer =

    =

    <= /div>

=
Administration API (imqcmd) output changes - i= mqcmd output changes for durable subscribers

= Note: the output returned from this application has a classification = of uncommitted.

This changes the output of the command imq= cmd list dur to list all destinations (and include a directory name) = if the -d is omitted. The following examples show the ouptut changes:=

  • Output when listing durables = when a destination passed in on the command line. (Unchanged from pre= vious releases)

    imqcmd list dur -d mydest 

    Listing all durable subscr=
iptions on the topic 'mydest'
on the broker specified by:

-------------------------
Host         Primary Port
-------------------------
localhost    7676

---------------------------------------------------------------------=
------
Durable Sub. Name   Client ID   Number of Messages   Durable Sub. Sta=
te   -
---------------------------------------------------------------------=
------
mydn                mycid       0                    INACTIVE        =
     -

Successfully listed durable subscriptions.
  • Output when l= isting durables when a destination is not provided on the command lin= e (adds new column DestinationName)

    imqcmd list = dur -- listing all destinations


    <= pre>Listing all durable subscriptions ------------------------- Host Primary Port ------------------------- localhost 7676 ---------------------------------------------------------------------= --------------------- Durable Sub. Name Client ID Destination Name Number of M= essages Durable Sub. State ---------------------------------------------------------------------= --------------------- 456 123 *.foo 0 = INACTIVE mydn mycid mydest 0 = INACTIVE Successfully listed durable subscriptions.
=
Additional Installation Imported interfaces =

The windows Installer.vbs script now us= es the following variables to locate a JRE for the installer:

=

  • HKLM\SOFTWARE\JavaSoft\Java Ru= ntime Environment\CurrentVersion
  • HKLM\SO= FTWARE\JavaSoft\Java Runtime Environment\<version>\JavaHome =

    =
During installation, t= he installer will first attempt to use the jdk (if any) which was pas= sed into the installation script, if no jdk is passed in it will look= for a jre installed as part of the bundle, if no jre is found it wil= l look at the keys to find the current JDK and its javahome. =

=
Additional Logging Messages <= /dt>

Some bug fixes require the addition or modificat= ion of log messages. No change was made in the format of those messag= es.


Imported/Exported Intefaces

Exported I= nterfaces = = = = = = = = = = <= /tr>
Interface Classification= Comments
imqcmd Ouput Uncommitted Modifies an existing interface to support listin= g of all durables including their destination. See specific changes a= bove.
MQ MBea= n Attributes names Committed Modifies an existing interface to add support for NextMessageI= D method. See specific changes above
MQ MBean Lookup keys for CompositeDataCommitted Modifies an existing = interface to add support for NextMessageID method and NumMsgsPending.= See specific changes above.
Unbundled Filesystem Layout Co= mmitted New Interface.

Creates a new= filesystem layout for the product when it is not shipped with native= packaging. See the Filesystem Layout speci= fication
Broker Log Infomation Uncommi= tted Modified an existing interface by adding = new log messages (no format changes)
UMS Protocol Committed<= /td> New Interface.

Defines the protocol = for the new ums service.See the UMS Proto= col Specification
UMS Configuration Co= mmitted New Interface.

Defines the c= onfiguration properties for the new ums service. See the UMS Configuration Specification

imqums.war Committed New Interface.=

Defines the name of the war file used for deploying the new u= ms service. See specific changes above.

<mq_home>/bin/mqunist= all[.bat] Committed N= ew Interface.

A new script file which is available only on the = new openMQ bundles that makes it easier for users to find the uninsta= ller. See specific changes above.

Imported Interfaces = = = HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion = = =
Interface ClassificationComments
Standard New Interface

Location of the latest release of the JRE on a win= dows system.
HKLM\SOFTWARE\Java Soft\Java Runtime Environment\&l= t;version>\JavaHome StandardNew Interface

Location of the java home f= or a release of the JRE on a windows system.

=


=

References

Curren= t Release:

Message Queue 4.3 feature functional specificati= ons:


=

Previous Release:

Message Queue 4.2 (Harrier)= LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387=


=

<additional.zip>=



--Boundary_(ID_cZoV+xdxOx7urmezGPUr9g)-- From tom.childers@sun.com Tue Nov 4 10:12:56 2008 Received: from dm-sfbay-02.sfbay.sun.com (dm-sfbay-02.SFBay.Sun.COM [129.146.11.31]) by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id mA4ICuss025515 for ; Tue, 4 Nov 2008 10:12:56 -0800 (PST) Received: from sca-es-mail-2.sun.com (sca-es-mail-2.Sun.COM [192.18.43.133]) by dm-sfbay-02.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id mA4ICuKr018099 for ; Tue, 4 Nov 2008 10:12:56 -0800 (PST) Received: from fe-sfbay-09.sun.com ([192.18.43.129]) by sca-es-mail-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id mA4ICphq010536 for ; Tue, 4 Nov 2008 10:12:51 -0800 (PST) Received: from conversion-daemon.fe-sfbay-09.sun.com by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) id <0K9T00801MKDUY00@fe-sfbay-09.sun.com> (original mail from tom.childers@sun.com) for LSARC-ext@sac.sfbay.sun.com; Tue, 04 Nov 2008 10:12:51 -0800 (PST) Received: from labnis-qfe4.SFBay.Sun.COM ([75.101.10.233]) by fe-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007)) with ESMTPSA id <0K9T00M7EMLDWX30@fe-sfbay-09.sun.com> for LSARC-ext@sac.sfbay.sun.com; Tue, 04 Nov 2008 10:12:50 -0800 (PST) Date: Tue, 04 Nov 2008 10:12:47 -0800 From: Tom Childers Subject: Re: OpenMQ/SJSMQ 4.3 (Robin) [LSARC/2008/648 FastTrack timeout 10/28/2008] In-reply-to: <20087980-C9B1-46D3-81C6-EF96896DB917@sun.com> Sender: Thomas.Childers@sun.com To: Chris Kasso , Linda Schneider Cc: LSARC-ext@sac.sfbay.sun.com Message-id: <6A3872FE-4A5A-4C47-B73C-052EBC81B05F@sun.com> MIME-version: 1.0 X-Mailer: Apple Mail (2.928.1) Content-type: multipart/alternative; boundary="Boundary_(ID_3eQyG/ycR3VFx8tAPV2Bog)" References: <48FFF85A.3080701@sun.com> <9B1B74E8-EDEF-4E90-A58F-A057BA3C9480@sun.com> <49074DBE.4060409@sun.com> <20087980-C9B1-46D3-81C6-EF96896DB917@sun.com> Status: RO Content-Length: 47448 --Boundary_(ID_3eQyG/ycR3VFx8tAPV2Bog) Content-type: text/plain; delsp=yes; format=flowed; charset=US-ASCII Content-transfer-encoding: 7BIT We went ahead and approved this case at LSARC today, and I've taken the liberty of closing the case as approved. Tom Childers Sr. Staff Engineer Sun Microsystems, Inc. SOA/Business Integration Engineering Phone x31943/+1 415-226-3398 Mobile +1 415-272-3565 Fax +1 415-226-3398 Email Tom.Childers@Sun.COM On Oct 29, 2008, at 12:29 PM, Tom Childers wrote: > Hi, Linda. > > The external link is http://www.opensolaris.org/os/community/arc/caselog/2008/648/ > , and when I look at the onepager there, it refers to an internal > machine. For some reason, the materials don't show up, so we perhaps > have a permissions problem. > > The links in the files should be made into relative links, so we > don't have internal Sun machine names visible. > > I'm happy with your comments on the FOSS issue, and I have no > problem closing this case as approved. > -tdc > > > On Oct 28, 2008, at 10:37 AM, Linda Schneider wrote: > >> >> Looking through this case today, I notice that the UMS >> specification is hosted on an internal machine, and the onepager >> links to an internal machine. Since this is an open case, the specs >> are not available to outside ARC members. >> >> A copy of the specification is attached in the zip file I attached >> to the original fast track email and the data is in the case >> directory. Is there also another place I should place it. >> >> Isn't there a public or FOSS interface available to support .net, >> Python and Ajax clients? >> >> For JMS, not really. In general each JMS provider comes up with >> their own api's for .net, etc. >> >> There is a general api called STOMP which can be a bridge into >> JMS. and we have provided an example of using it on the openMQ >> site, but the licensing on the product prevent us from putting it >> in the product. Additionally its a more complex api. >> >> To login to the service to send a message with Stomp: >> Console.WriteLine("CONNECT ..."); >> streamWriter.WriteLine("CONNECT"); >> streamWriter.WriteLine("login:guest"); >> streamWriter.WriteLine("passcode:guest"); >> streamWriter.WriteLine(""); >> streamWriter.Write('\0'); >> streamWriter.Flush(); >> >> To long into the server to send a message with UMS: >> POST /ums/simple? >> service=login&user=guest&password=guest HTTP/1.1 >> >> NOTE: Ums (although part of the openMQ/SJSMQ project) is generic >> and will actually work with other providers. >> >> >> >> Tom Childers wrote: >>> >>> Hi, Linda. >>> >>> Looking through this case today, I notice that the UMS >>> specification is hosted on an internal machine, and the onepager >>> links to an internal machine. Since this is an open case, the >>> specs are not available to outside ARC members. >>> >>> Apparently this is a new interface that we created from scratch. >>> Isn't there a public or FOSS interface available to support .net, >>> Python and Ajax clients? >>> >>> Everything else looks pretty straightforward. >>> -tdc >>> >>> On Oct 22, 2008, at 9:06 PM, Linda Schneider wrote: >>> >>>> I'm sponsoring the following proposal for fast-track approval. >>>> The timer is set for 10/28/2008. >>>> >>>> Proposed release binding is minor. >>>> >>>> Fastrack content is [now] included below (it will look better if >>>> viewed as html) >>>> >>>> The attached zip file [additional.zip] contains copies of the >>>> functional specs referenced in this document. >>>> The document (and related files) is also available at: http://sac.sfbay/arc/LSARC/2008/648/robin.html >>>> >>>> FastTrack: OpenMQ / Sun Java System Message Queue 4.3 (Robin) >>>> Sponsor: Linda Schneider >>>> >>>> Release Binding: Minor >>>> >>>> This is a FastTrack request for minor interface changes in Open >>>> Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin). >>>> Robin is a maintenance release to Message Queue 4.2 (LSARC/ >>>> 2008/387). It includes bug fixes and a small number of minor >>>> enhancements. >>>> >>>> This FastTrack adds modifies several committed and uncommitted >>>> exported interfaces and adds two new imported interfaces. It does >>>> not change the classification or remove any existing interface. >>>> >>>> >>>> >>>> Overview of Changes >>>> >>>> Several changes were added to 4.3 which impact the product's >>>> interface: >>>> >>>> A REST style API was added to allow messages to be produced or >>>> consumed to the MQ provider >>>> A new bundling and layout scheme was added to support the product >>>> installed by our new Zip based installer (which will also be used >>>> in future releases for IPS packages) >>>> Minor administration changes >>>> Minor modifications to the windows installer >>>> Addition of a command to make it easier to locate the uninstaller >>>> on the OpenMQ packages. >>>> Public interface changes >>>> >>>> New Exported Interfaces: Creation of the Universal Message >>>> Service (UMS) API: >>>> The UMS Protocol used by applications to connect to the service. >>>> The UMS Configuration which contains the set of configuration >>>> parameters for the service. >>>> A new war file (imqums.war) containing the servlet required by UMS. >>>> New Exported Interface: Creation of a the new filesystem layout >>>> for use by the new packages. This layout will also be used for >>>> our new install bundles specifically: >>>> Our OpenMQ product >>>> Our AIX product (the platform is new to 4.3) >>>> No changes have been made to our existing packages used in >>>> earlier releases. (They will still use the old filesystem laytout) >>>> New Exported Interface: A new uninstall bat/shell script has been >>>> added as a shortcut for uninstalling the openMQ-only release. >>>> Modified Exported Interface: Minor changes have been made to JMX >>>> to add additional information for destinations and consumers. >>>> New Imported Interfaces: Installation of the product on windows >>>> (both for SJSMQ and OpenMQ) now uses Java registry keys as a >>>> fallback to locate a JRE to use to start the installer. >>>> Private interface changess >>>> >>>> Additional changes have been made to private interfaces: >>>> >>>> Modified Interface: Output of imqcmd. This interface is >>>> Uncommitted. >>>> >>>> >>>> Descriptions of Changes >>>> >>>> >>>> Universal Message Service (UMS) - a REST style API >>>> The Universal Message Service is a simple REST based API that >>>> allows any HTTP capable device to access Message Queue. This >>>> allows clients written in languages such as c-sharp and phython >>>> to send and receive messages. >>>> >>>> A new web component (imqums.war) can be deployed on any web >>>> container. That component serves as a bridge between the ums >>>> client and the JMS provider. The ums client sends the ums >>>> protocol (which uses http posts) to connect to the imqums >>>> service. That service uses standard JMS apis to connect to the MQ >>>> server (the broker). >>>> >>>> >>>> >>>> Client->web component protocol >>>> The protocol has two types of messages service requests (messages >>>> sent to the messaging system) and service responses (responses >>>> received from the messaging system). There are also two services >>>> (XML and basic text) which are provided in this release. >>>> >>>> >>>> The API supports the following commands: >>>> >>>> login logs into the system and creates a UMS session (note: the >>>> password must be sent in plaintext since it is going as part of >>>> the http command line, however use of SSL is recommended). >>>> send Sends a message (which will become a JMS message) to MQ. >>>> receive Receive a message from MQ. >>>> commit Commit a transaction (provided the UMS session is >>>> transacted). >>>> rollback Rollback a transaction. (provided the UMS session is >>>> transacted). >>>> close Close the UMS session. >>>> All messages are request/response: >>>> >>>> Service Requests >>>> The http POST method is used for all interaction with the UMS. >>>> Each protocol message is represented with the following syntax: >>>> http://host:port//[? >>>> ]; >>>> >>>> Where: >>>> >>>> ums_conext-root: the location where the WAR file was deployed >>>> simple: the type of service used (simple or XML) >>>> query_string: used for the simple service. Provides a set of name >>>> value pairs separated by & which specify information such as the >>>> service type, messaging domain, and destination name >>>> For the Messages: >>>> For XML messages, the body contains the command information in >>>> XML format >>>> For the simple service, the body is empty (since the protocol >>>> information in in the URL) >>>> >>>> Service Responses >>>> For the XML service, the body of the HTTP request returns a SOAP >>>> message containing return information. For the simple message >>>> service, the body of the message may contain some specific return >>>> information. >>>> >>>> Lower level details of the Protocol are found in the UMS Protocol >>>> description. >>>> >>>> UMS configuration >>>> When the war file is deployed, several configuration options are >>>> available for the servlet including password to be used to the >>>> broker, how often to poll for messages and the broker address. >>>> Specific configuration parameters are found in the UMS >>>> Configuration specification. >>>> >>>> Filesystem layout and packaging change - support for new packages >>>> which can handle multi-install >>>> In MQ 4.3 we are adding a new zip based packaging bundle. In the >>>> following release (Crane), we will be replacing the zip bundles >>>> for IPS packages. This layout is the one we will be using for >>>> going forward for all future unbundled products (either zip based >>>> or IPS). >>>> >>>> Note: Our current SVR4 or Linux RPM based packaging is unaffected >>>> by these changes. >>>> >>>> MQ's filesystem will be laid out following the JES Filesystem >>>> Layout for Unbundled Software. >>>> >>>> >>>> | >>>> |-------- etc >>>> | | >>>> | |-mq [MQ etc files] >>>> | >>>> |-------- var >>>> | | >>>> | |- install [contains installer information] >>>> | | >>>> | |-mq [used by the server for storing data] >>>> | >>>> |-------- mq >>>> | |-------- bin [MQ executables] >>>> | | | >>>> | | |- sparcv9 (amd64) [64 bit solaris >>>> executables] >>>> | | >>>> | |-------- lib [MQ jar files and libraries] >>>> | | | >>>> | | |- sparcv9 (amd64) [64 bit libraries for >>>> the MQ C API] >>>> | | >>>> | |-------- include [C-API file system headers] >>>> | | >>>> | |-------- lib64 [note: linux libs used instead of >>>> sparcv9] >>>> | | >>>> | |-------- examples [demos] >>>> | >>>> |-------- install >>>> | >>>> |- open installer implementation and jar files >>>> >>>> >>>> For more details and specific locations for each file installed >>>> by MQ see the MQ 4.3 Filesystem and Packaging specification. >>>> >>>> >>>> mquninstall[.bat] - script to improve uninstall experience >>>> The installer places the script to uninstall the product in: >>>> /var/install/contents/mq/uninstaller >>>> >>>> A low level install script (used by the mq installer) is located >>>> at: >>>> /install/bin/uninstaller >>>> >>>> While we do document the location of the uninstaller, it is >>>> difficult to find and users often attempt to uninstall with the >>>> wrong uninstaller executable. >>>> >>>> For this release, we are adding a new script (or bat file) called >>>> mquninstall that is being placed in the /mq/bin >>>> directory. This will will only be in OpenMQ bundles for this >>>> release (it will not be available in package based installs). >>>> >>>> >>>> JMX Administration API changes - minimal JMX attribute and >>>> CompositeData changes >>>> The following changes will be made to the JMX monitoring api: >>>> >>>> A new attribute NextMessageID will be added to consumers and >>>> destinations >>>> A new attribute NumMsgsPending to consumers >>>> The specific changes are: >>>> >>>> DestinationMonitorMBean >>>> New Attributes: >>>> Name Set/Get Type Description >>>> NextMessageID G String JMS Message Id of the next message to be >>>> sent to any consumer >>>> ConsumerMonitorMBean: >>>> new Keys for Composite Data >>>> Key Value Type Description >>>> NextMessageID String JMS Message Id of the next message to be >>>> sent to this consumer >>>> NumMsgsPending Long The number of messages which have been sent >>>> to this consumer but have not been acknowledged. They may either >>>> be queued for delivery or delivered to the consumer >>>> >>>> >>>> Administration API (imqcmd) output changes - imqcmd output >>>> changes for durable subscribers >>>> Note: the output returned from this application has a >>>> classification of uncommitted. >>>> >>>> This changes the output of the command imqcmd list dur to list >>>> all destinations (and include a directory name) if the -d is >>>> omitted. The following examples show the ouptut changes: >>>> >>>> Output when listing durables when a destination passed in on the >>>> command line. (Unchanged from previous releases) >>>> imqcmd list dur -d mydest >>>> >>>> >>>> Listing all durable subscriptions on the topic 'mydest' >>>> on the broker specified by: >>>> >>>> ------------------------- >>>> Host Primary Port >>>> ------------------------- >>>> localhost 7676 >>>> >>>> --------------------------------------------------------------------------- >>>> Durable Sub. Name Client ID Number of Messages Durable Sub. >>>> State - >>>> --------------------------------------------------------------------------- >>>> mydn mycid 0 >>>> INACTIVE - >>>> >>>> Successfully listed durable subscriptions. >>>> >>>> Output when listing durables when a destination is not provided >>>> on the command line (adds new column DestinationName) >>>> imqcmd list dur -- listing all destinations >>>> >>>> >>>> Listing all durable subscriptions >>>> ------------------------- >>>> Host Primary Port >>>> ------------------------- >>>> localhost 7676 >>>> >>>> ------------------------------------------------------------------------------------------ >>>> Durable Sub. Name Client ID Destination Name Number of >>>> Messages Durable Sub. State >>>> ------------------------------------------------------------------------------------------ >>>> 456 123 *.foo >>>> 0 INACTIVE >>>> mydn mycid mydest >>>> 0 INACTIVE >>>> >>>> Successfully listed durable subscriptions. >>>> >>>> Additional Installation Imported interfaces >>>> The windows Installer.vbs script now uses the following variables >>>> to locate a JRE for the installer: >>>> >>>> >>>> HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion >>>> HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\\JavaHome >>>> >>>> During installation, the installer will first attempt to use the >>>> jdk (if any) which was passed into the installation script, if no >>>> jdk is passed in it will look for a jre installed as part of the >>>> bundle, if no jre is found it will look at the keys to find the >>>> current JDK and its javahome. >>>> >>>> Additional Logging Messages >>>> Some bug fixes require the addition or modification of log >>>> messages. No change was made in the format of those messages. >>>> >>>> >>>> Imported/Exported Intefaces >>>> >>>> Exported Interfaces >>>> Interface Classification Comments >>>> imqcmd Ouput Uncommitted Modifies an existing interface to >>>> support listing of all durables including their destination. See >>>> specific changes above. >>>> MQ MBean Attributes names Committed Modifies an existing >>>> interface to add support for NextMessageID method. See specific >>>> changes above >>>> MQ MBean Lookup keys for CompositeData Committed Modifies an >>>> existing interface to add support for NextMessageID method and >>>> NumMsgsPending. See specific changes above. >>>> Unbundled Filesystem Layout Committed New Interface. >>>> Creates a new filesystem layout for the product when it is not >>>> shipped with native packaging. See the Filesystem Layout >>>> specification >>>> >>>> Broker Log Infomation Uncommitted Modified an existing interface >>>> by adding new log messages (no format changes) >>>> UMS Protocol Committed New Interface. >>>> Defines the protocol for the new ums service.See the UMS Protocol >>>> Specification >>>> >>>> UMS Configuration Committed New Interface. >>>> Defines the configuration properties for the new ums service. See >>>> the UMS Configuration Specification >>>> >>>> imqums.war Committed New Interface. >>>> Defines the name of the war file used for deploying the new ums >>>> service. See specific changes above. >>>> >>>> /bin/mqunistall[.bat] Committed New Interface. >>>> A new script file which is available only on the new openMQ >>>> bundles that makes it easier for users to find the uninstaller. >>>> See specific changes above. >>>> >>>> >>>> Imported Interfaces >>>> Interface Classification Comments >>>> HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion >>>> Standard New Interface >>>> Location of the latest release of the JRE on a windows system. >>>> >>>> HKLM\SOFTWARE\Java Soft\Java Runtime Environment\ >>>> \JavaHome Standard New Interface >>>> Location of the java home for a release of the JRE on a windows >>>> system. >>>> >>>> >>>> >>>> >>>> References >>>> >>>> Current Release: >>>> >>>> Message Queue 4.3 feature functional specifications: >>>> >>>> UMS protocol >>>> UMS configuration specification >>>> MQ Filesystem Layout and packaging specification for Robin >>>> >>>> Previous Release: >>>> >>>> Message Queue 4.2 (Harrier) LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387 >>>> >>>> >>>> >>>> >>> >> > --Boundary_(ID_3eQyG/ycR3VFx8tAPV2Bog) Content-type: text/html; charset=US-ASCII Content-transfer-encoding: QUOTED-PRINTABLE We went ahead and approved = this case at LSARC today, and I've taken the liberty of closing the c= ase as approved.

= Tom Childers
Sr. Staff En= gineer

Sun Microsystems, Inc.
SOA/Business Integr= ation Engineering
Phone x31943/+1 415-226-3398
Mobile +1 415-= 272-3565
Fax +1 415-226-3398
Email Tom.Childers@Sun.COM

On Oct 29, 2008, at 12:29 PM, Tom C= hilders wrote:

Hi, Linda.
The external link is http://www.opensolaris.or= g/os/community/arc/caselog/2008/648/, and when I look at the onep= ager there, it refers to an internal machine. For some reason, the ma= terials don't show up, so we perhaps have a permissions problem.

The links in the files should be made into relat= ive links, so we don't have internal Sun machine names visible.
=

I'm happy with your comments on the FOSS issue, a= nd I have no problem closing this case as approved.
-tdc


On Oct 28, 2008, at 10:37 AM, Li= nda Schneider wrote:


Looking through this case today, I notice that the= UMS specification is hosted on an internal machine, and the onepager= links to an internal machine. Since this is an open case, the specs = are not available to outside ARC members.

= A copy of the specification is attached in the zip file I attached to= the original fast track email and the data is in the case directory.= Is there also another place I should place it.

Isn't the= re a public or FOSS interface available to support .net, Python and A= jax clients?

For JMS, not really.  In general each= JMS provider comes up with their own api's for .net, etc. 
=
There is a general api called STOMP which can be a bridge into = JMS.  and we have provided an example of using it on the openMQ = site, but the licensing on the product prevent us from putting it in = the product.  Additionally its a more complex api.

To l= ogin to the service to send a message with Stomp:
 &= nbsp;          Console.W= riteLine("CONNECT ...");
      &nbs= p;     streamWriter.WriteLine("CONNECT");
&nb= sp;           strea= mWriter.WriteLine("login:guest");
     &= nbsp;      streamWriter.WriteLine("passcode:= guest");
         &n= bsp;  streamWriter.WriteLine("");
    &n= bsp;       streamWriter.Write('\0');             = streamWriter.Flush();

To long into the server to send a = message with UMS:
    &nb= sp;        POST /ums/simple?servic= e=3Dlogin&user=3Dguest&password=3Dguest HTTP/1.1 <= br>

NOTE: Ums (although part of the op= enMQ/SJSMQ project) is generic and will actually work with other prov= iders.



Tom Childers wrote:
Hi, Lind= a.

Looking through this case today, I notice= that the UMS specification is hosted on an internal machine, and the= onepager links to an internal machine. Since this is an open case, t= he specs are not available to outside ARC members.

=
Apparently this is a new interface that we created from = scratch.  Isn't there a public or FOSS interface available to su= pport .net, Python and Ajax clients?

E= verything else looks pretty straightforward.
-tdc
=

On Oct 22, 2008, at 9:06 PM, Linda Schneider w= rote:

I'm sponso= ring the following proposal for fast-track approval. The timer is set= for 10/28/2008.

Proposed release binding is minor.
=
Fastrack content is [now] included below (it will look bette= r if viewed as html)

The attached zip file [additional.zi= p] contains copies of the functional specs referenced in this documen= t.
The document (and related files) is also available at:  <= a moz-do-not-send=3D"true" class=3D"moz-txt-link-freetext" href=3D"ht= tp://sac.sfbay/arc/LSARC/2008/648/robin.html">http://sac.sfbay/arc/LS= ARC/2008/648/robin.html

FastTrack:= OpenMQ / Sun Java System Message Queue 4.3 (Robin)

Sponsor= : Linda Schneider

Release Binding: Minor

=

This is a FastTrack request for minor interface changes in= Open Message Queue (OpenMQ) / Java System Message Queue 4.3 (Robin).= Robin is a maintenance release to Message Queue 4.2 (LSARC/2008/387). It includes bug fixes and a small number = of minor enhancements.

This FastTrack adds modifies several co= mmitted and uncommitted exported interfaces and adds two new imported= interfaces. It does not change the classification or remove any exis= ting interface.


=

Overview of Chang= es

Several changes were added to 4.3 which impact the p= roduct's interface:

  • A REST style API was added = to allow messages to be produced or consumed to the MQ provider
    • =
  • A new bundling and layout scheme was added to support th= e product installed by our new Zip based installer (which will also b= e used in future releases for IPS packages)
  • Minor a= dministration changes
  • Minor modifications to the wi= ndows installer
  • Addition of a command to make it ea= sier to locate the uninstaller on the OpenMQ packages.

    • Public interface changes

    1. = New Exported Interfaces: Creation of the Universal Mess= age Service (UMS) API:
      • The UMS Protocol used by appli= cations to connect to the service.
      • The UMS Configuration which = contains the set of configuration parameters for the service.
        • =
      • A new war file (imqums.war) containing the servlet req= uired by UMS.
    2. <= b>New Exported Interface: Creation of a the new filesystem la= yout for use by the new packages. This layout will also be used for o= ur new install bundles specifically:
        Our OpenMQ product
      • Our AIX product (the platfo= rm is new to 4.3)
      No changes have been made to = our existing packages used in earlier releases. (They will still use = the old filesystem laytout)
    3. New Exported Int= erface: A new uninstall bat/shell script has been added as a = shortcut for uninstalling the openMQ-only release.
      4. Modified Exported Interface: Minor changes have been = made to JMX to add additional information for destinations and consum= ers.
    4. New Imported Interfaces: Instal= lation of the product on windows (both for SJSMQ and OpenMQ) now uses= Java registry keys as a fallback to locate a JRE to use to start the= installer.

    Private interface changess

    Additional changes have been made to private interfaces:

    =
    1. Modified Interface: Output of i= mqcmd. This interface is Uncommitted.
    =
=

Descriptions of Changes

=

=
Universal Message Service (UMS) -= a REST style API

The Universal Message Service = is a simple REST based API that allows any HTTP capable device to acc= ess Message Queue. This allows clients written in languages such as c= -sharp and phython to send and receive messages.

A new web com= ponent (imqums.war) can be deployed on any web container. That compon= ent serves as a bridge between the ums client and the JMS provider. T= he ums client sends the ums protocol (which uses http posts) to conne= ct to the imqums service. That service uses standard JMS apis to conn= ect to the MQ server (the broker).

<ums.gif> <= /p>

Client->web component protocol
=

The protocol has two types of messages service reques= ts (messages sent to the messaging system) and service responses (res= ponses received from the messaging system). There are also two servic= es (XML and basic text) which are provided in this release.

=

=

The API supports the following commands:

=
  • login logs into the system and cre= ates a UMS session (note: the password must be sent in plaintext sinc= e it is going as part of the http command line, however use of SSL is= recommended).
  • send Sends a message= (which will become a JMS message) to MQ.
  • <= u>receive Receive a message from MQ.
  • commit Commit a transaction (provided the UMS session is transac= ted).
  • rollback Rollback a transactio= n. (provided the UMS session is transacted).
    • close Close the UMS session.

Al= l messages are request/response:

=
Service Requests
The http = POST method is used for all interaction with the UMS. Each protocol m= essage is represented with the following syntax: <= p>http://host:port/<ums-context-root>/<= ;service>[?<query_string_if_simple>];

Where:

=
  • ums_conext-root: th= e location where the WAR file was deployed
    • =
  • simple: the type of service used (simple or XML)
    • =
  • query_string: used for the simple servic= e. Provides a set of name value pairs separated by & which specif= y information such as the service type, messaging domain, and destina= tion name
For the Messages: =
  • For XML messages, the body con= tains the command information in XML format
    • =
  • For the simple service, the body is empty (since the protocol in= formation in in the URL)
=

=
Service Respo= nses

For the XML service, the body o= f the HTTP request returns a SOAP message containing return informati= on. For the simple message service, the body of the message may conta= in some specific return information.

=
Lower level details of the Protocol are found in the= UMS Protocol description. =

=
UMS configuration
=
When the war file is deployed, several configuration option= s are available for the servlet including password to be used to the = broker, how often to poll for messages and the broker address. Specif= ic configuration parameters are found in the UMS Configuration specification.
=

=
Filesystem layout and packaging chan= ge - support for new packages which can handle multi-install =

In MQ 4.3 we are adding a new zip based packagi= ng bundle. In the following release (Crane), we will be replacing the= zip bundles for IPS packages. This layout is the one we will be usin= g for going forward for all future unbundled products (either zip bas= ed or IPS).

Note: Our current SVR4 or Linux RPM based pa= ckaging is unaffected by these changes.

MQ's filesystem will be= laid out following the JES Filesystem Layout for Unbundled Software.

= 
<install_home>
   |
   |-------- etc
   |          |
   |          |-mq [MQ etc files]
   |
   |-------- var
   |          |
   |          |- install [contains installer information]
   |          |
   |          |-mq [used by the server for storing data]
   |
   |-------- mq
   |         |-------- bin   [MQ executables]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit solaris executable=
s]
   |         |
   |         |-------- lib [MQ jar files and libraries]
   |         |          |
   |         |          |- sparcv9 (amd64) [64 bit libraries for the =
MQ C API]
   |         |
   |         |-------- include [C-API file system headers]
   |         |
   |         |-------- lib64  [note: linux libs used instead of sparc=
v9]
   |         |
   |         |-------- examples [demos]
   |        =20
   |-------- install
               |
               |- open installer implementation and jar files
For more details and specific locations for each file = installed by MQ see the MQ 4.3 Filesystem a= nd Packaging specification.


mquninstall[.bat] - script to improve uninstall experi= ence

The installer places the script to uninstal= l the product in:
<install_home>/var/install/con= tents/mq/uninstaller

A low level install script (used by th= e mq installer) is located at:
<install_home>/in= stall/bin/uninstaller

While we do document the location of = the uninstaller, it is difficult to find and users often attempt to u= ninstall with the wrong uninstaller executable.

For this relea= se, we are adding a new script (or bat file) called mquninstall that is being placed in the <install_home>/mq/bin directo= ry. This will will only be in OpenMQ bundles for this release (it wil= l not be available in package based installs).

<= br class=3D"webkit-block-placeholder">
JMX Administration API changes - minim= al JMX attribute and CompositeData changes

The f= ollowing changes will be made to the JMX monitoring api:

=
  • A new attribute NextMessageID will be added= to consumers and destinations
  • A new attribute = NumMsgsPending to consumers

The specific cha= nges are:

  • DestinationMonitorMBe= an

    New Attributes: = = = = =
    Name Set/GetType Description
    NextMessageID GString JMS Message Id of= the next message to be sent to any consumer
    =

  • ConsumerMonitorMBean: =

    new Keys for Composite Data = Key Value Type Description = NextMessageID = String JMS Mes= sage Id of the next message to be sent to this consumer = Num= MsgsPending Long = The number of messages which have been sent to this consumer = but have not been acknowledged. They may either be queued for deliver= y or delivered to the consumer =

    =

    <= /div>

=
Administration API (imqcmd) output changes - i= mqcmd output changes for durable subscribers

= Note: the output returned from this application has a classification = of uncommitted.

This changes the output of the command imq= cmd list dur to list all destinations (and include a directory name) = if the -d is omitted. The following examples show the ouptut changes:=

  • Output when listing durables = when a destination passed in on the command line. (Unchanged from pre= vious releases)

    imqcmd list dur -d mydest 

    Listing all durable subscr=
iptions on the topic 'mydest'
on the broker specified by:

-------------------------
Host         Primary Port
-------------------------
localhost    7676

---------------------------------------------------------------------=
------
Durable Sub. Name   Client ID   Number of Messages   Durable Sub. Sta=
te   -
---------------------------------------------------------------------=
------
mydn                mycid       0                    INACTIVE        =
     -

Successfully listed durable subscriptions.
  • Output when l= isting durables when a destination is not provided on the command lin= e (adds new column DestinationName)

    imqcmd list = dur -- listing all destinations


    <= pre>Listing all durable subscriptions ------------------------- Host Primary Port ------------------------- localhost 7676 ---------------------------------------------------------------------= --------------------- Durable Sub. Name Client ID Destination Name Number of M= essages Durable Sub. State ---------------------------------------------------------------------= --------------------- 456 123 *.foo 0 = INACTIVE mydn mycid mydest 0 = INACTIVE Successfully listed durable subscriptions.
=
Additional Installation Imported interfaces =

The windows Installer.vbs script now us= es the following variables to locate a JRE for the installer:

=

  • HKLM\SOFTWARE\JavaSoft\Java Ru= ntime Environment\CurrentVersion
  • HKLM\SO= FTWARE\JavaSoft\Java Runtime Environment\<version>\JavaHome =

    =
During installation, t= he installer will first attempt to use the jdk (if any) which was pas= sed into the installation script, if no jdk is passed in it will look= for a jre installed as part of the bundle, if no jre is found it wil= l look at the keys to find the current JDK and its javahome. =

=
Additional Logging Messages <= /dt>

Some bug fixes require the addition or modificat= ion of log messages. No change was made in the format of those messag= es.


Imported/Exported Intefaces

Exported I= nterfaces = = = = = = = = = = <= /tr>
Interface Classification= Comments
imqcmd Ouput Uncommitted Modifies an existing interface to support listin= g of all durables including their destination. See specific changes a= bove.
MQ MBea= n Attributes names Committed Modifies an existing interface to add support for NextMessageI= D method. See specific changes above
MQ MBean Lookup keys for CompositeDataCommitted Modifies an existing = interface to add support for NextMessageID method and NumMsgsPending.= See specific changes above.
Unbundled Filesystem Layout Co= mmitted New Interface.

Creates a new= filesystem layout for the product when it is not shipped with native= packaging. See the Filesystem Layout speci= fication
Broker Log Infomation Uncommi= tted Modified an existing interface by adding = new log messages (no format changes)
UMS Protocol Committed<= /td> New Interface.

Defines the protocol = for the new ums service.See the UMS Proto= col Specification
UMS Configuration Co= mmitted New Interface.

Defines the c= onfiguration properties for the new ums service. See the UMS Configuration Specification

imqums.war Committed New Interface.=

Defines the name of the war file used for deploying the new u= ms service. See specific changes above.

<mq_home>/bin/mqunist= all[.bat] Committed N= ew Interface.

A new script file which is available only on the = new openMQ bundles that makes it easier for users to find the uninsta= ller. See specific changes above.

Imported Interfaces = = = HKLM\SOFTWARE\Java Soft\Java Runtime Environment\CurrentVersion = = =
Interface ClassificationComments
Standard New Interface

Location of the latest release of the JRE on a win= dows system.
HKLM\SOFTWARE\Java Soft\Java Runtime Environment\&l= t;version>\JavaHome StandardNew Interface

Location of the java home f= or a release of the JRE on a windows system.

=


=

References

Curren= t Release:

Message Queue 4.3 feature functional specificati= ons:


=

Previous Release:

Message Queue 4.2 (Harrier)= LSARC case: http://sac.sfbay.sun.com/arc/LSARC/2008/387=


=

<additional.zip>=




--Boundary_(ID_3eQyG/ycR3VFx8tAPV2Bog)--