TCP/IP Programming Manual

Specifies the name of the NonStop TCP/IP process or TCPSAM or
TCP6SAM process name
=TCPIP^PROCESS^NAME
When set with a file name of “SUPPRESS”, specifies that when an
application starts, socket calls that try to invoke a behavior allowed in a
=CIP^COMPAT^ERROR,FILE SUPPRESS
previous implementation, but not in CIP, return as if successful even though
the behavior did not occur as expected.
The runtime entries for various files should be:
ADD DEFINE =TCPIP^HOST^FILE, FILE $SYSTEM.ZTCPIP.HOSTS
ADD DEFINE =TCPIP^NODE^FILE, FILE $SYSTEM.ZTCPIP.IPNODES
ADD DEFINE =PTCPIP^FILTER^KEY, CLASS MAP, FILE file-name
ADD DEFINE =TCPIP^NETWORK^FILE, FILE $SYSTEM.ZTCPIP.NETWORKS
ADD DEFINE =PTCPIP^FILTER^TCP^PORTS, FILE Pstartport.Pendport
ADD DEFINE =PTCPIP^FILTER^UDP^PORTS, FILE Pstartport.Pendport
ADD DEFINE =TCPIP^PROTOCOL^FILE, FILE $SYSTEM.ZTCPIP.PROTOCOL
ADD DEFINE =TCPIP^RESOLVER^NAME, FILE $SYSTEM.ZTCPIP.RESCONF
ADD DEFINE =TCPIP^SERVICE^FILE, FILE $SYSTEM.ZTCPIP.SERVICES
ADD DEFINE =_SRL_01, CLASS MAP, FILE ZTCPSRL
ADD DEFINE =TCPIP^PROCESS^NAME, FILE $ZTC0
ADD DEFINE =CIP^COMPAT^ERROR, FILE SUPPRESS
A value for =TCPIP^PROCESS^NAME must be defined only if both the following conditions exist:
• The transport-service-provider process on your system has been configured with a name other
than $ZTC0.
• The program that is going to be run does not call the socket_set_inet_name routine to
specify a NonStop TCP/IP, TCPSAM, TCP6SAM, or CIP process name. A call to this routine
overrides both the default name $ZTC0 and =TCPIP^PROCESS^NAME (if it is defined).
A value for =TCPIP^RESOLVER^NAME must be defined only if both the following conditions exist:
• The program that is going to be run calls the gethostbyname, gethostbyaddr,
getnameinfo, or getaddrinfo routines.
• The name-server information normally contained in the $SYSTEM.ZTCPIP.RESCONF file is
contained in some other file.
For a DEFINE name to be available to a program, the DEFINE name must be defined prior to
running the program. When you define a DEFINE name during an interactive session at a terminal,
the DEFINE name stays in effect until you clear it (using the DELETE DEFINE command), redefine
it through another ADD DEFINE command, or log off from the session. You can also use the SHOW
DEFINE command to list DEFINE name values you have defined. The attributes of an established
DEFINE name can be changed using the ALTER DEFINE command. Descriptions of the various
DEFINE commands appear in the TACL Reference Manual.
The following example shows you how to use the ADD DEFINE command to set up the host file.
Here, $TESTV.TSUBV.HOSTXX is defined to be the file used for resolving domain names. Then,
a server program named XXTEST (which uses the HOSTXX file to resolve domain names) is run:
TACL 3> ADD DEFINE =TCPIP^HOST^FILE,FILE $TESTV.TSUBV.HOSTXX
.
.
.
TACL 4> RUN XXTEST
Always specify a fully qualified file name for the =TCPIP^HOST^FILE value.
If your system has been configured to have a TCP/IP process named $ZTCM, you must define
=TCPIP^PROCESS^NAME before running any clients or servers that use the TCP/IP subsystem (the
operator or system manager who starts the NonStop TCP/IP, Parallel Library TCP/IP, NonStop
TCP/IPv6, or CIP process must also define =TCPIP^PROCESS^NAME):
TACL 5> ADD DEFINE =TCPIP^PROCESS^NAME, FILE $ZTCM
30 Introduction to Programming to the Guardian Sockets Library