1IBM_HOSTS(5) File Formats Manual IBM_HOSTS(5)
2
6 ibm_hosts - host database for x3270 and c3270
7
9 /etc/ibm_hosts
10
12 The ibm_hosts file contains information regarding IBM hosts on the net‐
13 work. An IBM host is a host which can communicate with a 3270 terminal
14 emulator such as x3270 or c3270. Each line defines a name in the fol‐
15 lowing format (optional fields are shown in brackets):
16 name type [opt:]...[luname@]hostname[:port] [actions]
18 Items are separated by any number of blanks and/or TAB characters. A
20 line beginning with # is taken as a comment (note that # anywhere else
21 on a line does not indicate a comment).
22 The name field is a mnemonic used to identify the host.
24 The type field is a keyword that indicates the type of entry. The
26 value primary means that the name will be included in host-selection
27 menus that may be displayed by a 3270 emulator. The value alias means
28 that the name will not be included in menus, but will still be accepted
29 as valid input when a host name is required.
30 The hostname field is the Internet hostname or dot-notation Internet
32 address of the host.
33 The hostname can include `s:' or `p:' prefixes, e.g., s:finicky (see
35 the x3270(1) or c3270(1) man page sfor details). It can also include
36 an LU name, separated by an `@' character, e.g., oddlu@bluehost. Fi‐
37 nally, it can include a non-default port number, appended to the host‐
38 name with a colon `:' character, e.g., bluehost:97. (For compatability
39 with earlier versions of x3270, the port can also be separated by a
40 slash `/' character.)
41 The optional actions field specifies actions to be taken once the con‐
43 nection is made and a data-entry field is defined. If the text looks
44 like an action, e.g., PF(1), it is unmodified; otherwise it is taken as
45 the parameter to the String() action. The actions are not intended for
46 entering usernames and passwords; rather they provide an automated way
47 of specifying a front-end menu option.
48
50 Given the following ibm_hosts file:
51 mvs primary mvs-host
53 tso alias mvs-host
54 mvs2 primary mvs-host:4012
55 vm primary vtam Tab() String(3) Enter()
56 A 3270 emulator will display four names (mvs, mvs2, afhost and vm) on
58 its hosts menu. The names mvs and tso will cause connections to the
59 host mvs-host. The name mvs2 will also cause a connection to mvs-host,
60 but to port 4012 rather than the emulator's default port (usually 23).
61 The name vm will cause the 3270 emulator to connect to the host vtam
62 (presumably some sort of host-selection front-end), enter the string
63 `3' on the second data-entry field on the screen, and send the Enter
64 AID sequence.
65
67 /etc/ibm_hosts
68
70 x3270(1), c3270(1)
71 31 January 2021 IBM_HOSTS(5)