---
name: "ibm_hosts"
section: "5x"
platform: "linux"
package: "x3270"
version: "3.1.1.5-1"
release: "Debian 1.3 (Bo)"
platforms: ["linux"]
url: "https://new.carta.tech/ibm_hosts/5x"
---

# ibm\_hosts(5x)

host database for x3270

## 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 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 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)](/x3270/1.md)