Neoview Database Administrator's Guide (R2.2)

The Gelserver installer for the Linux platform contains these entries to support JMS:
The directory where the JBOSS J2EE
Appserver is installed
j2ee_home=/opt/jboss-4.0.0
The directory where BEA JROCKIT JVM is
installed
java_home=/usr/lib/jvm/java-1.4.2-bea-1.4.2.08
The limit on the number of entries to be
processed from the JMS Queue
jms_msgcount_limit=50000
The idle time in minutes
jms_idletime_limit=10
NOTE: When setting up Java-compliant and J2EE 1.4-compliant environments for app servers,
please note that the JMS Queue-reading functionality has been tested and validated only with
the JMS provider that is bundled with Sun Web Appserver, Platform Edition 8.1 2005Q1
Configuring a JMS Task
Configuring a task to use JMS Queue is similar to configuring a task to use either a file or
named-pipe. Starting and stopping a JMS-queue related task is no different from starting and
stopping a file or named pipe-based task.
Configuring a JMS task requires that:
• The JMS Queue is set up using the JBOSS console.
• The JMS Producer and the GEL JMS Consumer use the same queue names, although they
can use different Connection Factories.
• The JMS Queue is used to perform trickle updates, so it is strongly recommended that the
transaction size (-ts) be set to 1. This setting causes each record read from the JMS Queue
to be immediately sent to the Neoview platform.
Using the normal CONFIG_TASK_LOAD request, specify these required parameters:
• -tt REAL (task type must be set to REAL)
• -it QUEUE (input type must be set to QUEUE)
• -ii connection-factory:queue (where queue is the JMS Queue name)
NOTE: You must use a colon (:) to delimit the connection-factory from the queue-name.
Using the normal CONFIG_TASK_LOAD request, specify these optional parameters:
• -il idletime-value-in-minutes
• -ml message-count-limit
NOTE: The defaults for these required and optional parameters are defined at installation
time.
This is a sample JMS configuration task request for two input queues, where the message limit
is set to 1000, the idle time is set to 5 minutes, and the transaction size is set to 1. Options for the
JMS-related parameters are highlighted in bold.
./gcmd -rt CONFIG_TASK_LOAD \
-tk GENUS_JMS_REAL \
-gs nskit06 -tn NEO-CMSERVER \
-op INSERT -rd LF -hd N -cp N -es INFO \
-ii jms/ConnectionFactory:queue/A \
-ii jms/ConnectionFactory:queue/B \
-ml 1000 \
-il 5 \
-ot TABLE -oi USRCAT.USRSCH.T1 \
-un user1 -pw mypasswd \
-of N
Reading Data From a JMS Queue 145