TMQFORWARD - TUXEDO System/T Message Forwarding Server
TMQFORWARD SRVGRP="identifier" SRVID="number" REPLYQ=N CLOPT=" [ -A ] [ servopts options ] -- -q queuename[,queuename . . ..] [ -t trantime ] [ -i idletime ] [ -e ] [ -d ] [ -n ] [ -f delay ] "
The message forwarding server is a System/T-supplied server that forwards messages that have been stored using tpenqueue(3c) for later processing. The application administrator enables automated message processing for the application servers by specifying this server as an application server in the *SERVERS section.
The location, server group, server identifier and other generic server related parameters are associated with the server using the already defined configuration file mechanisms for servers. The following is a list of additional command line options that are available for customization.
Messages will be sent to a server providing a service whose name matches the queue name from which the message is read. The message priority will be the priority specified when the message was enqueued, if set. Otherwise, the priority will be the priority for the service, as defined in the configuration file, or the default value (50).
The message will be dequeued and sent to the server within a transaction. If the service succeeds, the transaction will be committed and the message is deleted from the queue. If the message is associated with a reply queue, then any reply from the service will be enqueued to the reply queue, along with the returned tpurcode. If the reply queue does not exist, the reply will be dropped.
If the service fails, then the transaction will be rolled back and the message will be put back on the queue, up to the number of times specified by the retry limit configured for the queue. When a message is put back on the queue, the rules for ordering and dequeueing that applied when it was first put on the queue are, in effect, suspended for delay seconds; this opens up the possibility that a message of a lower priority may be dequeued ahead of the restored message.
If the -d option is specified, then the message will be deleted from the queue if the service fails and a reply message is received from the server, and the reply message (and associated tpurcode) will be enqueued to the failure queue, if one is associated with the message and the queue exists.
Any configuration condition that prevents TMQFORWARD from de-queuing or forwarding messages will cause the server to fail to boot. These conditions include the following. The SRVGRP must have TMSNAME set to TMS_QM, and must have OPENINFO set to indicate the associated device and queue name. The SERVER entry must not be part of an MSSQ and must have REPLYQ set to N. The -q option must be specified in the command line options. The server must not advertise any services (e.g., the -s option must not be specified).
As delivered, TMQFORWARD handles the standard buffer types provided with TUXEDO System/T. If additional application buffer types are needed, then a customized version of TMQFORWARD needs to be built using buildserver(1) with a customized type switch.
If your application uses shared libraries, it is not necessary to go through this compile and link process. See the description in the "Buffers" chapter of the TUXEDO Administrator's Guide.
The files included by the caller should include only the application buffer type switch and any required supporting routines. buildserver is used to combine the server object file, $TUXDIR/lib/TMQFORWARD.o, with the application type switch file(s), and link it with the needed TUXEDO System/T libraries. The following example provides a sample for further discussion. buildserver -v -o TMQFORWARD -r TUXEDO/QM -f ${TUXDIR}/lib/TMQFORWARD.o \e -f apptypsw.o
The buildserver options are as follows:
The -s option must not be specified to advertise services.
TMQFORWARD is supported as a TUXEDO System/T-supplied server on UNIX operating systems.
TMQFORWARD may be run in an interoperating application, but it must run on a Release 4.2 or later node.
*GROUPS # For NT/Netware, :myqueue becomes ;myqueue TMQUEUEGRP LMID=lmid GRPNO=1 TMSNAME=TMS_QM OPENINFO="TUXEDO/QM:/dev/device:myqueue" # no CLOSEINFO is required *SERVERS # recommended values RESTART=Y GRACE=0 TMQFORWARD SRVGRP="TMQUEUEGRP" SRVID=1001 RESTART=Y GRACE=0 CLOPT=" -- -qservice1,service2" REPLYQ=N TMQUEUE SRVGRP="TMQUEUEGRP" SRVID=1000 RESTART=Y GRACE=0 CLOPT="-s ACCOUNTING:TMQUEUE"
buildserver(1), servopts(5), TMQUEUE(5), tpenqueue(3c), tpdequeue(3c), ubbconfig(5), BEA TUXEDO Administrator's Guide BEA TUXEDO Programmer's Guide