Pathway/iTS Management Programming Manual

Terminal Control Process (TCP) Commands
NonStop Pathway/iTS Management Programming Manual—426749-002
7-3
ADD TCP
Tokens in Response Buffer
ZSPI-TKN-RETCODE
For ADD TCP, common error values for ZSPI-TKN-RETCODE are:
For descriptions of error-token values and their associated error lists, see
Section 11, TCP Event Messages and Section 12, TCP Error Messages.
Considerations
•
Before adding a TCP description to the PATHMON configuration file, you must
assign values to all of the required fields listed in this command.
•
Each TCP name (the value in ZPWY-DDL-SEL-TCP) must be unique in the
Pathway subsystem.
•
A Pathway/iTS TCP shares links among its multiple SCREEN COBOL requesters.
Only one SCREEN COBOL requester at a time can use a link by performing a
SCREEN COBOL SEND statement.
•
The ZLINKDEPTH field in ZPWY-DDL-DEF-SC specifies the maximum number of
concurrent links that any one link manager, such as a TCP or LINKMON process,
can have to the same server in a server class. A link manager, however, can also
have links to other servers in the class.
For example, if ZLINKDEPTH is 1, a LINKMON process or TCP can only have one
link to each server process. Each request to the PATHMON process for an
additional link will result in a link to a different server process.
•
Each link from a link manager results in a single open of the server. The link
manager makes the open available for use by multiple SCREEN COBOL programs
or Pathsend requesters, respectively.
•
You can specify either specific node names or \*, a generic name representing the
node on which the PATHMON process is currently running. If you do not specify a
node name, the default node for file-name expansion can be affected by the value
you specify for the ZNODEINDEPENDENT field of the TS/MP START PATHWAY
command. For more information on node independence, see the Pathway/iTS
System Management Manual.
Error
Number Error Token Description
1012 ZPWY-ERR-PM-DUPNAME The PATHMON process encountered a
duplicate TCP name.
1100 ZPWY-ERR-PM-TOOMANYTCP The value specified for ZMAXTCPS
was reached.