Hercules V4.00.0 - User Reference Guide

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

§¬¬¬ ¬¬¬«

¬¬¬¬ ¬¬¬¬¬«

-1 ¬¬¬¬¬
«

nnn

6.12.1.3 Parameter

devaddr

This is the device address.

devtype

This is the device type. A valid device type is 2703.

DIAL=

This specifies the call direction (if any). If DIAL=NO is specified the TCP outgoing
connection is attempted as soon as an ENABLE CCW is executed. Also in this
mode, an incoming connection will always be accepted. If DIAL=IN or INOUT is
specified, a TCP incoming call is accepted only if an ENABLE CCW is currently
executing on the device. With DIAL=OUT the ENABLE CCW is rejected. When
DIAL=IN or INOUT is coded a DIAL CCW allows the application to establish a TCP
connection to a specific host. For other DIAL values the DIAL CCW is rejected.

LHOST=

Specifies which IP address to listen on. This also conditions the network interface
from which incoming calls will be accepted. An asterisk (“*”) means all incoming
TCP calls are accepted regardless of the destination IP address or call origin. A
given IP address when DIAL=OUT is specified has no effect.

LPORT=

Specifies the TCP port for which to listen to incoming TCP calls. This value is man-
datory for DIAL=IN, DIAL=INOUT or DIAL=NO. It is ignored for DIAL=OUT.

RHOST=

Specifies the remote host to which to direct a TCP connection on a DIAL=NO line
when an ENABLE CCW is executed. This value is mandatory when DIAL=NO is
specified, It is ignored for other DIAL values.

RPORT=

Specifies the remote port to which to direct a TCP connection on a DIAL=NO line
when an ENABLE CCW is executed. This value is mandatory when DIAL=NO is
specified, It is ignored for other DIAL values.

RTO=

Specifies the number of milliseconds before terminating a read on a timeout when
no read termination control character is received. A value of zero means the read
ends immediately. “-1” specifies that there is no timeout.

PTO=

Specifies the number of milliseconds before terminating a POLL on a timeout when
no ACK or NACK sequence is received. A value of zero means the POLL ends im-
mediately. “-1” specifies that there is no timeout.

ETO=

Specifies the number of milliseconds before terminating an ENABLE operation on a
timeout. The timeout applies when DIAL=NO, DIAL=IN or DIAL=INOUT is speci-
fied, , the outgoing TCP call fails (DIAL=NO) and there is no previously or currently
established TCP connection for this line. When DIAL=NO is specified the timeout
defaults to 10 seconds, for DIAL=IN or DIAL=INOUT, the timeout defaults to “-1”,
meaning there is no timeout.

RTO, PTO and ETO are tuning options. In most cases using the default values will give the best result.

6.12.1.4 Examples

Example 1:

Define a 2703 BSC emulation line on device address 0023. The outgoing connection should be attempted
as soon as an ENABLE CCW is expected, incoming connections should always be accepted (DIAL=NO).
The IP address to listen on is 127.0.0.1 with port 3780. The remote host has the IP address 192.168.0.99
and the port to which to direct a TCP connection is 3781.

0023 2703 DIAL=NO LHOST=127.0.0.1 LPORT=3780 RHOST=192.168.0.99 RPORT=3781

Example 2:

Example 2 is basically the same as example 1, but needs optimized timing options. The timeout for ter-
minating a read must be 5000 ms, the timeout for terminating a POLL must also be 5000 ms and the
timeout for terminating an ENABLE operation must be 12000 ms.

0023 2703 DIAL=NO LHOST=127.0.0.1 LPORT=3780 RHOST=192.168.0.99 RPORT=3781
RT=5000 PTO=5000 ETO=12000

6.12.2 TTY (Preliminary 2703 TELE2 TTY Support)

6.12.2.1 Function

This statement describes a 2703 Telegraph Terminal Control Type II (TTY 33/35) stop/start line, providing
access to the Host OS via a standard telnet client.