1dnl Copyright (c) 1994-2009, Paul Mattes.
2dnl All rights reserved.
3dnl
4dnl Redistribution and use in source and binary forms, with or without
5dnl modification, are permitted provided that the following conditions are met:
6dnl     * Redistributions of source code must retain the above copyright
7dnl       notice, this list of conditions and the following disclaimer.
8dnl     * Redistributions in binary form must reproduce the above copyright
9dnl       notice, this list of conditions and the following disclaimer in the
10dnl       documentation and/or other materials provided with the distribution.
11dnl     * Neither the names of Paul Mattes nor the names of his contributors
12dnl       may be used to endorse or promote products derived from this software
13dnl       without specific prior written permission.
14dnl
15dnl THIS SOFTWARE IS PROVIDED BY PAUL MATTES "AS IS" AND ANY EXPRESS OR IMPLIED
16dnl WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
17dnl MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
18dnl EVENT SHALL PAUL MATTES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
19dnl SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
20dnl TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21dnl PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
22dnl LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
23dnl NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24dnl SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25XX_TH(IBM_HOSTS,5,XX_DATE)
26XX_SH(Name)
27ibm_hosts XX_DASHED() host database for x3270 and c3270
28XX_SH(Synopsis)
29/usr/lib/X11/x3270/ibm_hosts
30XX_SH(Description)
31The XX_FB(ibm_hosts)
32file contains information regarding IBM hosts on the network.
33An XX_FI(IBM host) is a host which can communicate with a 3270 terminal
34emulator such as XX_FB(x3270) or XX_FB(c3270).
35Each line defines a name in the following format
36(optional fields are shown in brackets):
37XX_LP
38XX_FI(name)	XX_FI(type) [XX_FI(opt):]...[XX_FI(luname)@]XX_FI(hostname)[:XX_FI(port)] [XX_FI(actions)]
39XX_LP
40Items are separated by any number of blanks and/or TAB characters.
41A line beginning with `#' is taken as a comment (note that `#' anywhere
42else on a line does XX_FI(not) indicate a comment).
43XX_LP
44The XX_FI(name) field is a mnemonic used to identify the host.
45XX_LP
46The XX_FI(type) field is a keyword that indicates the type of entry.
47The value XX_FB(primary) means that the XX_FI(name)
48will be included in host-selection menus that may be displayed by a
493270 emulator.
50The value XX_FB(alias) means that the XX_FI(name)
51will not be included in menus, but will still be accepted as valid input
52when a host name is required.
53XX_LP
54The XX_FI(hostname)
55field is the Internet hostname or dot-notation Internet address of the host.
56XX_LP
57The XX_FI(hostname)
58can `include' ``s:'' or ``p:'' prefixes, e.g., XX_FB(s:finicky)
59(see the XX_LINK(x3270-man.html,XX_FI(x3270)(1)) or
60XX_LINK(c3270-man.html,XX_FI(c3270)(1)) man page sfor details).
61It can also include an LU name, separated by an ``@'' character, e.g.,
62XX_FB(oddlu@bluehost).
63Finally, it can include a non-default XX_FI(port) number, appended to the
64XX_FI(hostname) with a colon ``:'' character, e.g.,
65XX_FB(bluehost:97).
66(For compatability with earlier versions of XX_FI(x3270),
67the XX_FI(port) can also be separated by a slash ``/'' character.)
68XX_LP
69The optional XX_FI(actions)
70field specifies actions to be taken once the connection is made and a
71data-entry field is defined.
72If the text looks like an action, e.g.,
73XX_FB(PF(1)),
74it is unmodified; otherwise it is taken as the parameter to the
75XX_FB(String())
76action.
77The
78XX_FI(actions)
79are not intended for entering usernames and passwords; rather they provide an
80automated way of specifying a front-end menu option.
81XX_SH(Example)
82Given the following
83XX_FB(ibm_hosts)
84file:
85XX_LP
86XX_RS(`mvs	primary	mvs-host
87XX_BR
88tso	alias	mvs-host
89XX_BR
90mvs2	primary	mvs-host:4012
91XX_BR
92vm	primary	vtam	Tab() String(3) Enter()
93')
94A 3270 emulator will display four names (XX_FB(mvs), XX_FB(mvs2),
95XX_FB(afhost) and XX_FB(vm)) on its hosts menu.
96The names XX_FB(mvs) and XX_FB(tso) will cause connections to the host
97XX_FB(mvs-host).
98The name XX_FB(mvs2) will also cause a connection to
99XX_FB(mvs-host),
100but to port 4012 rather than the emulator's default port (usually 23).
101The name XX_FB(vm) will cause the 3270 emulator to connect to the host
102XX_FB(vtam) (presumably some sort of host-selection front-end),
103enter the string ``3'' on the second data-entry field on the screen, and
104send the Enter XX_SM(AID) sequence.
105XX_SH(Files)
106/usr/lib/X11/x3270/ibm_hosts
107XX_SH(See Also)
108XX_LINK(x3270-man.html,x3270(1)),
109XX_LINK(c3270-man.html,c3270(1))
110