IBM_HOSTS(5)

NAME
       ibm_hosts - host database for x3270

SYNOPSIS
       /usr/lib/X11/x3270/ibm_hosts

DESCRIPTION
       The  ibm_hosts  file  contains  information  regarding IBM
       hosts on the network.  An IBM host is  a  host  which  can
       communicate with a 3270 terminal emulator such as x3270 or
       tn3270.  Each line defines a name in the following  format
       (optional fields are shown in brackets):

            name type hostname[/port] [actions]

       Items  are  separated  by  any number of blanks and/or TAB
       characters.  A line beginning with `#' is taken as a  com-
       ment (note that `#' anywhere else on a line does not indi-
       cate a comment).

       The name field is a mnemonic used to identify the host.

       The type field is a keyword that  indicates  the  type  of
       entry.   The  value  primary  means  that the name will be
       included in host-selection menus that may be displayed  by
       a 3270 emulator.  The value alias means that the name will
       not be included in menus, but will still  be  accepted  as
       valid input when a host name is required.

       The  hostname  field is the Internet hostname or dot-nota-
       tion Internet address of the host.

       The hostname can also  optionally  include  a  non-default
       port  number,  appended to the hostname with a slash ``/''
       character, e.g., bluehost/97.

       The optional actions field specifies actions to  be  taken
       once  the  connection  is  made  and a data-entry field is
       defined.  If the text looks like an action,  e.g.,  PF(1),
       it  is  unmodified; otherwise it is taken as the parameter
       to the String() action.  The actions are not intended  for
       entering  usernames  and passwords; rather they provide an
       automated way of specifying a front-end menu option.

EXAMPLE
       Given the following ibm_hosts file:

            mvs  primary   mvs-host
            tso  alias     mvs-host
            mvs2 primary   mvs-host/4012
            vm   primary   vtam Tab() String(3) Enter()

       An 3270 emulator  will  display  four  names  (mvs,  mvs2,
       afhost  and  vm) on its hosts menu.  The names mvs and tso

       will cause connections to the  host  mvs-host.   The  name
       mvs2 will also cause a connection to mvs-host, but to port
       4012 rather than the emulator's default port (usually 23).
       The name vm will cause the 3270 emulator to connect to the
       host vtam (presumably some sort of  host-selection  front-
       end),  enter  the  string  ``3''  on the second data-entry
       field on the screen, and send the ENTER AID sequence.

FILES
       /usr/lib/X11/x3270/ibm_hosts

SEE ALSO
       x3270(1)