Boot Parameters
Boot parameters are used by tmboot
when it executes a server. Once running,
a server reads its entry from the configuration file to determine its run-time options. The
unique server identification number is used to find the right entry. The following are boot
parameters.
CLOPT=string_value
The CLOPT
parameter specifies a string of command-line options to be passed to AOUT
when booted. The servopts(5)
page in the File Formats, Data Descriptions, MIBs, and System Processes Reference lists the valid parameters.
Some of the available options apply primarily to servers under development. For example,
the-r
option directs the server to write a record to its standard error
file each time a service request begins or ends.
Other command-line options can be used to direct the server’s standard out
(stdout
) and standard error (stderr
) to specific files, or
to start the server so that it initially advertises a limited set of its available
services.
The default value for the CLOPT
parameter is -A
, which
means that the server is started with all available services advertised.
The maximum length of the CLOPT
parameter value is 256 characters; it must
be enclosed in double quotes.
SEQUENCE=number
This parameter specifies when to shut down or boot relative to other servers. If
SEQUENCE
is not specified, servers are booted in the order found in the
SERVERS
section (and shut down in the reverse order). If some servers have
sequence numbers specified and others do not, all servers with sequence numbers are booted
first from low to high sequence number, then all servers without sequence numbers are booted
in the order in which they appear in the configuration file. Sequence numbers range between 1
and 9999. If the same sequence number is assigned to more than one server,
tmboot
may boot those servers in parallel.
MIN=number
The MIN
parameter specifies the minimum number of occurrences of the server
to boot by tmboot
. 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
The MAX
parameter 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.
-
tmboot
startsMIN
occurrences unless you explicitly call for more with the-i
SRVID
option oftmboot.
- If
RQADDR
is specified andMIN
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 isMIN.
-
MAX
is especially important for conversational servers because they are spawned automatically as needed.
Parent topic: Optional Parameters