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 the ubroker.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 the ubroker.properties file.

The following portions of the ubroker.properties file include the SonicMQ Adapter property groups and properties:

# Linkage to the parent group name for the plugin for the Unified Broker tool # 
[ParentGroup] 
    WebSpeed=UBroker.WS 
    AppServer=UBroker.AS 
    NameServer=NameServer 
    Oracle DataServer=UBroker.OR 
    ODBC DataServer=UBroker.OD 
    MSS DataServer=UBroker.MS 
    Messengers=WebSpeed.Messengers 
    SonicMQ Adapter=Adapter 
    AppServer Internet Adapter=AIA 
 # Default properties for SonicMQ Adapter broker # 
 [Adapter] 
     infoVersion=9010 
     workDir=@{WorkPath} 
     srvrLogFile=@{WorkPath}\server.log 
     brokerLogFile=@{WorkPath}\broker.log 
     maxClientInstance=512 
     registrationRetry=30 
     userName= 
     groupName= 
     appserviceNameList= 
     portNumber=3600 
     controllingNameServer= 
     environment= 
     uuid= 
     brkrLoggingLevel=2 
     brkrLogAppend=1 
     srvrLoggingLevel=2 
     srvrLogAppend=1 
     jvmArgs=@{JAVA\JVMARGS} 
     registrationMode=Register-IP 
     hostName= 
     description= 
     classMain=com.progress.ubroker.broker.ubroker 
     srvrStartupParam= 
# Sample SonicMQ adapter definition # 
 [Adapter.sonicMQ1] 
     srvrLogFile=@{WorkPath}\sonicMQ1.server.log 
     brokerLogFile=@{WorkPath}\sonicMQ1.broker.log 
     appserviceNameList=adapter.progress.jms 
     uuid=932.99.999.XXX:1ee77e:cf3bbe3d33:-8030 
     portNumber=3620 
     controllingNameServer=NS1 
     description=Sample SonicMQ adapter broker 

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 (;):

jmsServerName              /*The default is SonicMQ.*/ 
brokerURL                  /*The default is null.*/ 
user                       /*The default is null.*/  
password                   /*The default is null.*/ 
clientID                   /*The default is null.*/ 
pingInterval               /*In seconds; setPingInterval is not called 
                             by default.*/ 

For example:

srvrStartupParam=brokerURL=localHost; user=u1; password=p1; 

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:

adaptconfig [
  [ [ -name adapter-broker ]
    [ -propfile path-to-properties-file ]
    [ -validate ]
 ] | -help ] 

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:

adaptman {
  { -name adapter-broker
    { -kill | -start | -stop | -query }
    [ -host host-name -user user-name | -user user-name ]
    [ -port port-number ]
  } | -help } 

The adaptman tool has these parameters:

The following examples show how to use the adaptman parameters.

Use the following adaptman parameters to start an instance called SonicMQ1:

adaptman -i sonicMQ1 -start 

Use the following adaptman parameters to query the instance for its status:

adaptman -i sonicMQ1 -query 

Use the following adaptman parameters to stop an instance:

adaptman -name sonicMQ1 -stop 

Use the following adaptman parameters to get status of an instance on the machine whose AdminServer is on port 12935:

adaptman -host xxxxxx -port 12935 -i sonicMQ1 -q 

Use the following adaptman parameters to kill an instance:

adaptman -i sonicMQ1 -kill 


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095