1The full syntax for XX_FI(host) is:
2XX_RS([XX_FI(prefix):]...[XX_FI(LUname)@]XX_FI(hostname)[:XX_FI(port)][=XX_FI(accept)])
3ifelse(XX_PRODUCT,wc3270,,`XX_LP
4Prepending a XX_FB(P:) onto XX_FI(hostname) causes the connection to go
5through the XX_FI(telnet-passthru) service rather than directly to the host.
6See XX_LINK(#Passthru,XX_SM(PASSTHRU)) below.
7')dnl
8XX_LP
9Prepending an XX_FB(S:) onto XX_FI(hostname) removes the "extended data
10stream" option reported to the host.
11See XX_LINK(#tn,XX_FB(XX_DASHED(tn))) below for further information.
12XX_LP
13Prepending an XX_FB(N:) onto XX_FI(hostname)
14turns off TN3270E support for the session.
15XX_LP
16Prepending an XX_FB(L:) onto XX_FI(hostname)
17causes XX_FB(XX_PRODUCT) to first create a TLS tunnel to the host, and then
18create a TN3270 session inside the tunnel.  (This function is supported only if
19XX_FB(XX_PRODUCT) was built with TLS support).
20Note that TLS-encrypted sessions using the TELNET START-TLS option are
21negotiated with the host automatically; for these sessions the XX_FB(L:) prefix
22should not be used.
23XX_LP
24Prepending a XX_FB(Y:) onto XX_FI(hostname)
25causes XX_FB(XX_PRODUCT) to skip validation of host TLS certificates.
26This overrides any other configuration or command-line options.
27XX_LP
28Prepending an XX_FB(A:) onto XX_FI(hostname) is equivalent to setting the
29XX_FB(XX_DASHED(nvt)) option; it forces an NVT-mode session instead of a
303270-mode session.
31XX_LP
32A specific Logical Unit (LU) name to use may be specified by prepending it to
33the XX_FI(hostname) with an XX_DQUOTED(XX_FB(@)).
34Multiple LU names to try can be separated by commas.
35An empty LU can be placed in the list with an extra comma.
36(Note that the LU name is used for different purposes by different kinds of
37hosts.
38For example, CICS uses the LU name as the Terminal ID.)
39XX_LP
40The XX_FI(hostname) may optionally be placed inside square-bracket
41characters XX_DQUOTED(XX_FB([)) and XX_DQUOTED(XX_FB(])).
42This will prevent any colon XX_DQUOTED(XX_FB(:)) characters in the hostname
43from being interpreted as indicating option prefixes or port numbers.
44This allows numeric IPv6 addresses to be used as hostnames.
45ifelse(XX_PRODUCT,wc3270,,XX_PRODUCT,ws3270,,`XX_LP
46On systems that support the XX_FI(forkpty) library call, the
47XX_FI(hostname) may be replaced with XX_FB(XX_DASHED(e)) and a command string.
48This will cause XX_FB(XX_PRODUCT) to connect to a local child process, such as
49a shell.
50')dnl
51XX_LP
52The port to connect to defaults to
53XX_FB(telnet).
54This can be overridden with the XX_FB(XX_DASHED(port)) option, or by appending
55a XX_FI(port) to the XX_FI(hostname) with a colon
56XX_DQUOTED(XX_FB(:)).
57(For compatability with previous versions of XX_FB(XX_PRODUCT)
58and with XX_FI(tn3270)(1), the XX_FI(port)
59may also be specified as a second, separate argument.)
60XX_LP
61An optional accept name (a hostname to accept in the host's TLS
62certificate) may be specified by appending it to the hostname with an equals
63sign (XX_DQUOTED(XX_FB(=))).
64The accept name can also be specified with the XX_FB(XX_DASHED(accepthostname))
65option.
66