Jolt 1.2 Developer's Guide

Specifies the minimum number of occurrences of the server to booted. If an RQADDR is specified, and MIN is greater
than 1, the servers form a Multiple Servers Single Queue (MSSQ) set. The identifiers for the servers are SRVID up to
(SRVID + (MAX -1)). All occurrences of the server have the same sequence numbers as well as any other server
parameters. The value range for MIN is 0 to 1000. If MIN is not specified, the default value is 1.
MAX=number
Sets the maximum number of occurrences of the server to be booted. Initially, tmboot boots MIN servers, and additional
servers can be booted up to MAX occurrences using the -i option of tmboot to specify the associated server identifier. The
value range for MAX is 0 to 1000. If no value is specified for MAX, the default is the same as for MIN, or 1. Keep in mind
that:
tmboot starts MIN occurrences unless you explicitly call for more with the -i SRVID option of tmboot.
If RQADDR is specified and MIN is greater than one, an MSSQ set is formed.
If MIN is not specified, the default is 1.
If MAX is not specified, the default is MIN.
MAX is especially important for conversational servers because they are spawned automatically as needed.
Runtime Parameters
The runtime parameters are used by the server after it has been started by tmboot. As indicated above, tmboot uses the values
found in the TUXDIR, APPDIR and ENVFILE parameters for the MACHINES section when booting the server. It also sets the
PATH for the server to:
"APPDIR:TUXDIR/bin:/bin:<path>"
where <path> is the value of the last PATH= line appearing in the ENVFILE file. The following parameters are runtime
parameters.
ENVFILE=string_value
Adds values to the environment established by tmboot during initialization of the server. Variables specified in the file
named in the SERVERS ENVFILE parameter are set after those in the MACHINES ENVFILE used by tmboot. These files
cannot be used to override TUXDIR, APPDIR, TUXCONFIG, or TUXOFFSET. The best policy is to include in the
server's ENVFILE only those variable assignments needed to ensure proper running of the application.
Note that on the server, this file is processed after the server starts. Therefore, it cannot be used to set the pathnames used
to find executable or dynamically loaded files needed to execute the server. If you need to perform these tasks, use the
machine ENVFILE instead.
Within ENVFILE only lines of the form
VARIABLE =string
are allowed. VARIABLE must start with an underscore or alphabetic character and can contain only underscore or
alphanumeric characters. If the server is associated with a server group that can be migrated to a second machine, the
ENVFILE must be in the same location on both machines.
CONV={Y | N}
Specifies whether or not the server is a conversational server. CONV takes a Y value if a conversational server is being
defined. Connections can only be made to conversational servers, and rpc requests (via tpacall or tpcall) can only be made
to non-conversational servers. For a request/response server, you can either set CONV=N, which is the default, or omit the
parameter.
RQADDR=string_value
Assigns a symbolic name to the request queue of this server. MSSQ sets are established by using the same symbolic name
for more than one server (or by specifying MIN greater than 1). All members of an MSSQ set must offer an identical set of
services and must be in the same server group.
If RQADDR is not specified, the system assigns a unique key to serve as the queue address for this server. However,
tmadmin commands that take a queue address as an argument are easier to use if queues are given symbolic names.