jmqrun - The JMS Client Program Runner

The jmqrun utility is the JMS client program runner.

SYNOPSIS

jmqrun <class name> [parameters]

DESCRIPTION

The client runner runs JMS client programs. It sets the appropriate command line parameters and jvm flags for clients and then invokes class name with the arguments specified in parameters. The jmqrun runner automatically includes the JMS libraries in the system settings but users must set their application CLASSPATH manually.

Running:

   jmqrun <class name> [parameters]

is equivalent to invoking java with the following command line parameters:

   java -DORBDefaultInitRef=iioploc://localhost:53506 \
      -Djava.naming.factory.object=com.sssw.jms.naming.JMQObjectFactory \
      -Djava.naming.factory.initial=com.sun.jndi.cosnaming.CNCtxFactory \
      -Dorg.omg.CORBA.ORBClass=com.sssw.jbroker.ORBLite \
      -Dorg.omg.CORBA.ORBSingletonClass=com.sssw.jbroker.orb.SingletonORB \
      -Djavax.rmi.CORBA.StubClass=com.sssw.jbroker.rmi.StubDelegate \
      -Djavax.rmi.CORBA.UtilClass=com.sssw.jbroker.rmi.UtilDelegate \
      -Djavax.rmi.CORBA.PortableRemoteObjectClass=com.sssw.jbroker.rmi.PortableRemoteObjectDelegate \
      -cp <all .jar and .zip files in the top-level lib directory prepended to CLASSPATH>
      <class name> [parameters]

Note that the host and port information in the ORBDefaultInitRef parameter are derived from the msgsvc.properties file of the JMS server.

JVM FLAGS

It is possible to pass arguments to the jvm using the -J flag. In order to set the heap size to 250 MB, the following command line may be used:

   jmqrun -J-Xms250m <class name> [parameters]

If you want to use jmqrun for clients running on a different host than the JMS server, you can also use the -J flag to re-define some of the above system properties:

   jmqrun -J-DORBDefaultInitRef=iioploc://<hostname>:<port> <class name> [parameters]