Debian Codegraph @

x3270/html/ibm_hosts.html

raw
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>