TS/MP System Management Manual (G06.24+, H06.03+)

SERVER Commands
NonStop TS/MP System Management Manual—541819-001
12-23
SET SERVER Command
LINKDEPTH number
specifies the maximum number of concurrent links that any one link manager, such
as the LINKMON process or a TCP, can have to a given server process before the
PATHMON process directs that link manager's link requests to another server
within the server class.
The value of LINKDEPTH should not exceed the value of MAXLINKS and cannot
exceed 255. In the unlikely event that if MAXLINKS is set to 0, the value of
LINKDEPTH should be set to 1. For information about configuration limits, see
Appendix C, Configuration Limits and Defaults.
If you omit this attribute, the default is 1.
Typically, you use the LINKDEPTH attribute to allow multithreaded servers; for
servers that are not multithreaded, use the default of 1 for LINKDEPTH.
This attribute is valid for Guardian and OSS server processes.
MAXLINKS number
specifies the maximum number of concurrent links permitted between all
LINKMON processes and TCPs and a server in a server class.
number must be a value from 0 through 4095. This attribute establishes the
maximum number of concurrent send operations to a single server process. The
TCP or LINKMON process does not check how many links a server has with other
TCPs or LINKMON processes.
If the value for this attribute is too large, it can cause the requests to the server
process to be queued at the server for an unacceptable length of time. For
example, if MAXLINKS is equal to 20, there could be 20 concurrent requests
outstanding to a server. If the transaction service time is 1 second, a response
time of more than 20 seconds can occur.
If you omit this attribute, the default is an unlimited number of links. It is strongly
recommended that you set a value for MAXLINKS.
If this is an associative server, you should include links allocated by other
PATHMON environments when calculating the size of the RECEIVE-CONTROL
paragraph.
The value of MAXLINKS should always be greater than or equal to the value of
LINKDEPTH (unless MAXLINKS is set to 0).
Note. The value of SET SERVER MAXLINKS and the value of the TABLE OCCURS clause in
the RECEIVE–CONTROL paragraph of your COBOL server programs must correspond. The
value you specify for TABLE OCCURS must be greater than or equal to the MAXLINKS value
When the COBOL RECEIVE–CONTROL table is full, new requests to the server fail with file-
system error 12 (File in use). This error is most likely to occur during peak transaction load
times. For more information about the RECEIVE–CONTROL paragraph of a COBOL program,
see the
COBOL Reference Manual .