Progress
External Program
Interfaces
Configuring the SonicMQ Adapter From the Command Line
The SonicMQ Adapter can be configured and started by manually editing the
ubroker.properties
file. The Adapter root group in theubroker.properties
file supports the SonicMQ Adapter broker.If the default service name for the SonicMQ Adapter in appserviceNameList is modified from
adapter.progress.jms
, the new value must be specified by the 4GL client using the setAdapterService Session object method specified in the property in theubroker.properties
file.The following portions of the
ubroker.properties
file include the SonicMQ Adapter property groups and properties:
You can specify the following attributes in the srvrStartupParam property of the SonicMQ Adapter. Specifying srvrStartupParam attributes is optional when a single default is desired for all of the clients. The 4GL–JMS API allows clients to overwrite the srvrStartupParam default. Names of attributes are case sensitive; the attributes must be separated with a semicolon (;):
For example:
You can use two command-line tools, adaptconfig and adaptman, with the SonicMQ Adapter on all Progress-supported platforms.
Adaptconfig
Use adaptconfig to validate manual changes you made to the
ubroker.properties
file for SonicMQ Adapter instances:
The adaptconfig tool has these parameters:
Adaptman
Use adaptman to start, stop, query, and kill an existing SonicMQ Adapter broker. Enter the –i or the –name parameter followed by the name of the adapter broker and then the command to start, stop, query, or kill a broker. You can also use adaptman to manipulate brokers on other machines by using the –host and the –port parameters to specify the name of the machine and the port the AdminServer is running on:
The adaptman tool has these parameters:
- –help or –h — Displays command line help
- –name or –i (Name) — Name of the SonicMQ Adapter Broker (required)
- –start or –x — Starts the named SonicMQ Adapter broker
- –user or –u (UserName) — User name
- –host or –r — Host name where the AdminServer is running
- –port — Port number of the running AdminServer
- –query or –q — Queries the named SonicMQ Adapter broker
- –kill or –k — Causes emergency shutdown of the SonicMQ Adapter broker
- –stop or –e — Stops the SonicMQ Adapter broker
The following examples show how to use the adaptman parameters.
Use the following adaptman parameters to start an instance called SonicMQ1:
Use the following adaptman parameters to query the instance for its status:
Use the following adaptman parameters to stop an instance:
Use the following adaptman parameters to get status of an instance on the machine whose AdminServer is on port 12935:
Use the following adaptman parameters to kill an instance:
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |