1IBM_HOSTS(5)                  File Formats Manual                 IBM_HOSTS(5)
2
3
4

NAME

6       ibm_hosts - host database for x3270 and c3270
7

SYNOPSIS

9       /etc/ibm_hosts
10

DESCRIPTION

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
17       name type [opt:]...[luname@]hostname[:port] [actions]
18
19       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
23       The name field is a mnemonic used to identify the host.
24
25       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
31       The hostname field is the Internet hostname  or  dot-notation  Internet
32       address of the host.
33
34       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
42       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

EXAMPLE

50       Given the following ibm_hosts file:
51
52              mvs  primary   mvs-host
53              tso  alias     mvs-host
54              mvs2 primary   mvs-host:4012
55              vm   primary   vtam Tab() String(3) Enter()
56
57       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

FILES

67       /etc/ibm_hosts
68

SEE ALSO

70       x3270(1), c3270(1)
71
72
73
74                                31 January 2021                   IBM_HOSTS(5)
Impressum