Pathway/XM System Management Manual

Configuring Clients and Requesters
Compaq NonStop™ Pathway/XM System Management Manual—426761-001
5-6
Specifying Maximum Server Classes and Server
Processes per TCP
Specifying Maximum Server Classes and Server Processes per TCP
The MAXSERVERCLASSES and MAXSERVERPROCESSES attributes specify the
maximum number of server classes and server processes, respectively, with which each
TCP can communicate simultaneously. If you omit these attributes, the defaults are the
respective maximum numbers of server classes and server processes possible in this
Pathway/XM environment, as calculated by the PXMCFG process.
If TCP processes created from this TCP template need to communicate with server
processes in other (external) Pathway/XM environments, you must set the values of
MAXSERVERCLASSES and MAXSERVERPROCESSES high enough to allow for
these extra servers.
Requesting TCP Error Dumping
You can enable TCP error dumping either at configuration time by specifying the
SET TCP, DUMP ON statement or at run time by issuing the CONTROL TCP, DUMP
ON command.
•
Use the SET TCP statement if you want to request error dumping and you have not
yet started the TCP.
•
Use the CONTROL TCP command if you want to request error dumping but you
have already started the TCP. Use of this command is described in more detail under
Enabling and Disabling TCP Dumping and Statistics Collection on page 8-6.
If dumping is enabled and an internal or fatal error occurs, the TCP generates an error
dump and writes it to a file with a name assigned by the Pathway/XM environment.
For example, the following statement directs the TCP to write error information to a
dump file:
SET TCP, DUMP ON
After this statement is entered and the TCP is started, if an internal or fatal TCP error
occurs, the TCP writes the contents of its data stack and its extended data segment to its
dump file. To find the name of the dump file, you can issue a STATUS TCP command.
If you request the help of your Compaq representative in analyzing a problem, the
representative will likely require a DUMP file. It is therefore recommended that you
always set the DUMP option to ON for production systems.
Configuring TCPs for a Customized TCP Object Library
Compaq allows for nine user conversion procedures for data passed between a SCREEN
COBOL program and a terminal screen or intelligent device. These procedures are
stored in the TCP user library object file, $SYSTEM.SYSTEM.PATHTCPL.
You can write your own user conversion procedures to replace those provided in the
standard TCP user library object file, and then customize the library object file to
include these procedures. The programming guide that describes SCREEN COBOL
requester programming for your version of the Pathway/iTS product outlines these tasks
in detail.