How to Start/Stop and get the status of the SonicMQ Adapter in OpenEdge 12.0?

OpenEdge 12.0 introduced the oemessaging utility, which replaces the legacy Sonic and Generic JMS Adapter which are managed from the UBroker.

ClientConnect still works in OpenEdge 12.0 and later releases when executed from an OpenEdge ABL client process, inlcuding _progres, prowin and prowin32.
 

In OpenEdge 12.0 there are two ways to Start, Stop and get the status of Sonic & other JMS Adapter processes:

1. Use OpenEdge Management (12.0 and 12.1 only; requires additional actions. See Workaround section in article: OpenEdge 12.0 Installer fails to install the OpenEdge Adapter for SonicMQ)
2. Use the oemessaging utility - See https://documentation.progress.com/output/oe117sp/index.html#page/gssp2%2Fopenedge-jms-adapter-commands.html%23

Please note that you should choose one or the other interface for managing this, as there is a limitation with these methods in that the oemessaging utility does not use the Adminserver.  Therefore the two tools are unaware of each other's activity. 

In other words:

• If the adapter is started using the oemessaging command line utility; OpenEdge Management doesn’t know that it is started, and it will not correctly report the status displayed in the OpenEdge Management user interface.
• If the adapter is started using OpenEdge Management; the oemessaging utility doesn’t know that it is started, and it will not correctly report the status in the command line tool.

Example:

Stating the broker from proenv using the command: oemessaging start sonicMQ1

 Starting OE JMS Adapter "sonicMQ1" with:
 ......................................
 DLC:               C:\PROGRE~1\OpenEdge
 WRKDIR:            C:\OPENED~1\WRK
 JMSPROVIDER:       SonicMQ
 JMSPROVIDERFILE:   C:\PROGRE~1\OpenEdge\properties\jmsProvider.properties
 JMSCLIENTJAR:      C:\PROGRE~1\OpenEdge\sonic\MQ10.0\lib\sonic_client.jar
 ......................................
ubroker : v11.7.3 (06-Nov-2017)
Starts the Adapter broker.
::S-Summary D-SrvrDetail X-AddSrvr T-TrimSrvr  K-KillSrvr  E-Exit A-Abort
::L-ConnSummary C-ConnDetail Y-ListAllProps Z-ListPropName

Note: This is currently a product limitation and there are no plans to change this in the immediate future.  

Progress Article(s):
 OpenEdge 12.0 Installer fails to install the OpenEdge Adapter for SonicMQ
 How to submit an idea for a Progress product enhancement