PURPOSE

servopts - runtime options for TUXEDO System/T server processes

SYNOPSIS

AOUT CLOPT=
[ -A ]
[ -s { @filename | service[,service...][:func] } ]
[ -e stderr-file]
	[ -p
[L][low_water][,[terminate_time]][:[high_water][,create_time]]
	[ -h ]
[ -l locktype]
[ -n prio]
[ -o stdout-file]
[ -r ]
	[ -- uargs]

DESCRIPTION

servopts is not a command. Rather, it is a list of runtime options recognized by servers in a TUXEDO System/T system.

The server using these options may be one of the TUXEDO System/T-supplied servers such as FRMPRT(5), or it may be an application-supplied server built with the buildserver(1) command.

Running servers in a TUXEDO System/T system is accomplished through the tmboot(1) and tmadmin(1) commands working with servers (and other resources) specified in the application configuration file. Desired selections from the servopts list are specified with the server in the configuration file. The following options are recognized:

-A

indicates that the server should initially offer all services with which it was constructed. For TUXEDO System/T-supplied servers, -A is the only way of specifying services.

-s { @filename | service[,service...][:func] }

specifies the names of services to be advertised when the server is booted. In the most common case, a service is performed by a function that carries the same name; that is, the x service is performed by function x. For example, the specification -s x,y,z will run the associated server initially offering services x, y, and z, each processed by a function of the same name. In other cases, a service (or several services) may be performed by a function of a different name. The specification -s x,y,z:abc will run the associated server with initial services x, y, and z, each processed by the function abc. Spaces are not allowed between commas. Function name is preceded by a colon. Service names (and implicit function names) must be less than or equal to 15 characters in length. An explicit function name (that is, a name specified after a colon) can be up to 128 characters in length. Names longer than these limits are truncated with a warning message. When retrieved by tmadmin(1) or TM_MIB(5), only the first 15 characters of a name are displayed. A filename can be specified with the -s option by prefacing the filename with the '@' character. Each line of this file is treated as an argument to the -s option. You may put comments in this file. All comments start with '#' or ':'. The -s option may be specified multiple times. The runtime association of service name with processing function within a server load module is called the dynamic service capability. The tmadmin advertise command can be used to change the list of services offered as the server continues to run. Service names beginning with the character '_' or '.' are reserved for system servers. Application servers specifying such services will fail to boot.

-e

specifies the name of a file to be opened as the server's standard error file. Providing this option ensures that a restarted server will have the same standard error file as its predecessors. If this option is not used, a default diversion file called stderr is created in the directory specified by $APPDIR.

-p [L][low_water][,[terminate_time]][:[high_water][,create_time]]

This option can be used to support automatic spawning/decay of servers. It may be used for servers on an MSSQ with MAX greater than 1; it is not allowed (and not necessary) for conversational servers. Arguments to the option have the following meanings: L The decision to spawn more servers is based on load rather than number of servers or messages. -- the remaining arguments, low_water, terminate_time, high_water, and create_time are used to control when servers are spawned or deactivated. The algorithm is: if high_water is met or exceeded for at least create_time, a new server is spawned. If low_water is exceeded (on the low side) for at least terminate_time, a server is deactivated.

The L option works only in SHM mode with load balancing turned on. If SHM/LDBAL+Y is not set, then a userlog message (LIBTUX_CAT:1542) is printed and no spawning is done.

low_water defaults to an average of 1 server or message on the MSSQ or a workload of 50. high_water defaults to an average of 2 servers or messages, or a workload of 100. create_time defaults to 50: terminate_time defaults to 60.

-h

don't run the server immune to hangups. If not supplied, the server will ignore the hangup signal.

-l

lock the server in core. The argument is t, d, or p according to whether the text (TXTLOCK), data (DATLOCK), or the entire process (text and data - PROCLOCK), should be locked. See plock(2) for details. The lock will fail if the server is not run as root. There is no way to unlock a server once it is locked.

-n

nice the server according to the argument. Giving the process better priority (a negative argument) requires it to be run with the uid of root. See nice(2) for details.

-o

specifies the name of a file to be opened as the server's standard output file. Providing this option ensures that a restarted server will have the same standard output file as its predecessors. If this option is not used, a default diversion file called stdout is created in the directory specified by $APPDIR.

-r

specifies that the server should record, on its standard error file, a log of services performed. This log may be analyzed by the txrpt(1) command. When the -r option is used, make sure that the ULOGDEBUG variable is not set to "y". That prevents debugging messages from being sent to stderr. Debugging messages in the file will be misinterpreted by txrpt.

--

marks the end of system-recognized arguments and the start of arguments to be passed to a subroutine within the server. This option is only needed if the user wishes to supply application-specific arguments to the server. The system-recognized options precede the --; application arguments should follow it. Application arguments may be processed by a user-supplied version of the tpsvrinit(3c) function. getopt(3) should be used to parse them. Since all system arguments are processed prior to the call to tpsvrinit(3c), when the call is made the external integer optind points to the start of the user flags. The same option letters (for example, -A) may be reused after the -- argument, and given any meaning appropriate to the application.

EXAMPLES

See the EXAMPLES section of ubbconfig(5).

PURPOSE

SYNOPSIS

DESCRIPTION

EXAMPLES

SEE ALSO