| 1 |
<html> |
| 2 |
<head> |
| 3 |
<title>ibm_hosts Manual Page</title> |
| 4 |
<link HREF="http://www.w3.org/StyleSheets/Core/Steely" TYPE="text/css" REL="stylesheet"> |
| 5 |
</head> |
| 6 |
<body> |
| 7 |
<h1>ibm_hosts Manual Page</h1> |
| 8 |
<hr> |
| 9 |
<p><b>Note:</b> This page is no longer being maintained for ibm_hosts 4.0 and later. |
| 10 |
Please refer to the <a href="https://x3270.miraheze.org/wiki/Main_Page">the x3270 Wiki</a> for up-to-date documentation.</p> |
| 11 |
<hr> |
| 12 |
<h2>Contents</h2> |
| 13 |
<blockquote> |
| 14 |
<a HREF="#Name">Name</a><br> |
| 15 |
<a HREF="#Synopsis">Synopsis</a><br> |
| 16 |
<a HREF="#Description">Description</a><br> |
| 17 |
<a HREF="#Example">Example</a><br> |
| 18 |
<a HREF="#Files">Files</a><br> |
| 19 |
<a HREF="#See-Also">See Also</a><br> |
| 20 |
</blockquote> |
| 21 |
<a NAME="Name"></a><h2>Name</h2> |
| 22 |
ibm_hosts - host database for x3270 and c3270 |
| 23 |
<a NAME="Synopsis"></a><h2>Synopsis</h2> |
| 24 |
/usr/lib/X11/x3270/ibm_hosts |
| 25 |
<a NAME="Description"></a><h2>Description</h2> |
| 26 |
The <b>ibm_hosts</b> |
| 27 |
file contains information regarding IBM hosts on the network. |
| 28 |
An <i>IBM host</i> is a host which can communicate with a 3270 terminal |
| 29 |
emulator such as <b>x3270</b> or <b>c3270</b>. |
| 30 |
Each line defines a name in the following format |
| 31 |
(optional fields are shown in brackets): |
| 32 |
<p> |
| 33 |
<i>name</i> <i>type</i> [<i>opt</i>:]...[<i>luname</i>@]<i>hostname</i>[:<i>port</i>] [<i>actions</i>] |
| 34 |
<p> |
| 35 |
Items are separated by any number of blanks and/or TAB characters. |
| 36 |
A line beginning with # is taken as a comment (note that # anywhere |
| 37 |
else on a line does <i>not</i> indicate a comment). |
| 38 |
<p> |
| 39 |
The <i>name</i> field is a mnemonic used to identify the host. |
| 40 |
<p> |
| 41 |
The <i>type</i> field is a keyword that indicates the type of entry. |
| 42 |
The value <b>primary</b> means that the <i>name</i> |
| 43 |
will be included in host-selection menus that may be displayed by a |
| 44 |
3270 emulator. |
| 45 |
The value <b>alias</b> means that the <i>name</i> |
| 46 |
will not be included in menus, but will still be accepted as valid input |
| 47 |
when a host name is required. |
| 48 |
<p> |
| 49 |
The <i>hostname</i> |
| 50 |
field is the Internet hostname or dot-notation Internet address of the host. |
| 51 |
<p> |
| 52 |
The <i>hostname</i> |
| 53 |
can include `s:' or `p:' prefixes, e.g., <b>s:finicky</b> |
| 54 |
(see the <a HREF="x3270-man.html"><i>x3270</i>(1)</a> or |
| 55 |
<a HREF="c3270-man.html"><i>c3270</i>(1)</a> man page sfor details). |
| 56 |
It can also include an LU name, separated by an `@' character, e.g., |
| 57 |
<b>oddlu@bluehost</b>. |
| 58 |
Finally, it can include a non-default <i>port</i> number, appended to the |
| 59 |
<i>hostname</i> with a colon `:' character, e.g., |
| 60 |
<b>bluehost:97</b>. |
| 61 |
(For compatibility with earlier versions of <i>x3270</i>, |
| 62 |
the <i>port</i> can also be separated by a slash `/' character.) |
| 63 |
<p> |
| 64 |
The optional <i>actions</i> |
| 65 |
field specifies actions to be taken once the connection is made and a |
| 66 |
data-entry field is defined. |
| 67 |
If the text looks like an action, e.g., |
| 68 |
<b>PF(1)</b>, |
| 69 |
it is unmodified; otherwise it is taken as the parameter to the |
| 70 |
<b>String()</b> |
| 71 |
action. |
| 72 |
The |
| 73 |
<i>actions</i> |
| 74 |
are not intended for entering usernames and passwords; rather they provide an |
| 75 |
automated way of specifying a front-end menu option. |
| 76 |
<a NAME="Example"></a><h2>Example</h2> |
| 77 |
Given the following |
| 78 |
<b>ibm_hosts</b> |
| 79 |
file: |
| 80 |
<p> |
| 81 |
<blockquote>mvs primary mvs-host |
| 82 |
<br> |
| 83 |
tso alias mvs-host |
| 84 |
<br> |
| 85 |
mvs2 primary mvs-host:4012 |
| 86 |
<br> |
| 87 |
vm primary vtam Tab() String(3) Enter() |
| 88 |
</blockquote> |
| 89 |
A 3270 emulator will display four names (<b>mvs</b>, <b>mvs2</b>, |
| 90 |
<b>afhost</b> and <b>vm</b>) on its hosts menu. |
| 91 |
The names <b>mvs</b> and <b>tso</b> will cause connections to the host |
| 92 |
<b>mvs-host</b>. |
| 93 |
The name <b>mvs2</b> will also cause a connection to |
| 94 |
<b>mvs-host</b>, |
| 95 |
but to port 4012 rather than the emulator's default port (usually 23). |
| 96 |
The name <b>vm</b> will cause the 3270 emulator to connect to the host |
| 97 |
<b>vtam</b> (presumably some sort of host-selection front-end), |
| 98 |
enter the string `3' on the second data-entry field on the screen, and |
| 99 |
send the Enter <font size=-1>AID</font> sequence. |
| 100 |
<a NAME="Files"></a><h2>Files</h2> |
| 101 |
/usr/lib/X11/x3270/ibm_hosts |
| 102 |
<a NAME="See-Also"></a><h2>See Also</h2> |
| 103 |
<a HREF="x3270-man.html">x3270(1)</a>, |
| 104 |
<a HREF="c3270-man.html">c3270(1)</a> |
| 105 |
<hr> |
| 106 |
<i> |
| 107 |
This HTML document and the accompanying troff document were generated with |
| 108 |
a set of write-only <b>m4</b> macros and the powerful <b>vi</b> editor. |
| 109 |
<br>Last modified 15 December 2024. |
| 110 |
</i> |
| 111 |
</body> |
| 112 |
</html> |