Release 10.1A: OpenEdge Development:
Messaging and ESB

> ## Using ServerConnect and ClientConnect

> 4GL clients can connect directly to a SonicMQ Broker by using the OpenEdge Adapter for SonicMQ for a messaging session. By connecting directly to the SonicMQ Broker, the 4GL client has better control over connection management, and there is no need to manage and configure a OpenEdge Adapter for SonicMQ server process. Additional benefits include the availability of client persistence and fault tolerance. For more information on client persistence, see the "Client persistence" section. For more information on fault tolerance, see the "Fault tolerance" section.

> Caution: This method creates a larger run-time footprint for your 4GL client or AppServer/WebSpeed process.

> In the following example, the application creates a session procedure by calling `jmssession.p` persistently specifying the `-SMQConnect` connection parameter:

> Using SMQConnect on a client example
>     DEFINE VARIABLE sessionH AS HANDLE.
>     RUN jms/jmssession.p PERSISTENT SET sessionH ("-SMQConnect").
>     RUN setBrokerURL IN sessionH ("MQBrokerHost:2506").
>     RUN beginSession IN sessionH.

> Note: Each messaging session creates a connection to the SonicMQ Broker. You can minimize the number of connections to the SonicMQ Broker by using the AppServer or WebSpeed process to execute a shared 4GL-JMS session.

> ##### Using ServerConnect

> Prior to using ServerConnect in an AppServer or WebSpeed server, the AppServer or WebSpeed server must be enabled for SonicMQ ServerConnect enabled using Progress Explorer.

> | To enable the AppServer or WebSpeed server for ServerConnect:

> 1. Select the Messaging properties for the AppServer or WebSpeed server.

> 2. Select the SonicMQ ServerConnect enabled check box, as shown:

> 3. Select unique broker and server log filenames.

> 4. Select the logging level.

> These settings start a SonicMQ ServerConnect process when the AppServer or WebSpeed server starts with specified logging options. After starting the AppServer or WebSpeed server, ensure the SonicMQ Broker is running.

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