IBM_HOSTS(5)							File Formats Manual						      IBM_HOSTS(5)

NAME

       ibm_hosts - host database for x3270 and c3270

SYNOPSIS

       /etc/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 termi-
       nal emulator such as x3270 or c3270.  Each line defines a name in the following format (optional fields are shown in brackets):

       name type [opt:]...[luname@]hostname[:port] [actions]

       Items are separated by any number of blanks and/or TAB characters.  A line beginning with # is taken as a comment  (note  that  #  anywhere
       else on a line does not indicate 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-notation Internet address of the host.

       The  hostname can include `s:' or `p:' prefixes, e.g., s:finicky (see the x3270(1) or c3270(1) man page sfor details).  It can also include
       an LU name, separated by an `@' character, e.g., oddlu@bluehost.  Finally, it can include a non-default port number, appended to the  host-
       name with a colon `:' character, e.g., bluehost:97.  (For compatability with earlier versions of x3270, the port can also be separated by a
       slash `/' character.)

       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()

       A 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

       /etc/ibm_hosts

SEE ALSO

       x3270(1), c3270(1)

								  25 August 2012						      IBM_HOSTS(5)