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 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.