1 | '\\" t |
---|
2 | .TH IBM_HOSTS 5 "10 July 1995" |
---|
3 | .SH NAME |
---|
4 | ibm_hosts \- |
---|
5 | host database for |
---|
6 | .B x3270 |
---|
7 | .SH SYNOPSIS |
---|
8 | /usr/lib/X11/x3270/ibm_hosts |
---|
9 | .SH DESCRIPTION |
---|
10 | The |
---|
11 | .B ibm_hosts |
---|
12 | file contains information regarding IBM hosts on the network. |
---|
13 | An |
---|
14 | .I "IBM host" |
---|
15 | is a host which can communicate with a 3270 terminal emulator such as |
---|
16 | .B x3270 |
---|
17 | or |
---|
18 | .B tn3270. |
---|
19 | Each line defines a name in the following format |
---|
20 | (optional fields are shown in brackets): |
---|
21 | .nf |
---|
22 | |
---|
23 | \fIname type hostname\fP[/\fIport\fP] [\fIactions\fP] |
---|
24 | |
---|
25 | .fi |
---|
26 | Items are separated by any number of blanks and/or TAB characters. |
---|
27 | A line beginning with `#' is taken as a comment (note that `#' anywhere |
---|
28 | else on a line does |
---|
29 | .I not |
---|
30 | indicate a comment). |
---|
31 | .LP |
---|
32 | The |
---|
33 | .I name |
---|
34 | field is a mnemonic used to identify the host. |
---|
35 | .LP |
---|
36 | The |
---|
37 | .I |
---|
38 | type |
---|
39 | field is a keyword that indicates the type of entry. |
---|
40 | The value |
---|
41 | .B primary |
---|
42 | means that the |
---|
43 | .I name |
---|
44 | will be included in host-selection menus that may be displayed by a |
---|
45 | 3270 emulator. |
---|
46 | The value |
---|
47 | .B alias |
---|
48 | means that the |
---|
49 | .I name |
---|
50 | will not be included in menus, but will still be accepted as valid input |
---|
51 | when a host name is required. |
---|
52 | .LP |
---|
53 | The |
---|
54 | .I hostname |
---|
55 | field is the Internet hostname or dot-notation Internet address of the host. |
---|
56 | .LP |
---|
57 | The |
---|
58 | .I hostname |
---|
59 | can also optionally include a non-default |
---|
60 | .I port |
---|
61 | number, appended to the |
---|
62 | .I hostname |
---|
63 | with |
---|
64 | a slash ``/'' character, |
---|
65 | .IR e . g ., |
---|
66 | .BR bluehost/97 . |
---|
67 | .LP |
---|
68 | The optional |
---|
69 | .I actions |
---|
70 | field specifies actions to be taken once the connection is made and a |
---|
71 | data-entry field is defined. |
---|
72 | If the text looks like an action, |
---|
73 | .IR e . g ., |
---|
74 | .BR PF(1) , |
---|
75 | it is unmodified; otherwise it is taken as the parameter to the |
---|
76 | .B String() |
---|
77 | action. |
---|
78 | The |
---|
79 | .I actions |
---|
80 | are not intended for entering usernames and passwords; rather they provide an |
---|
81 | automated way of specifying a front-end menu option. |
---|
82 | .SH EXAMPLE |
---|
83 | Given the following |
---|
84 | .B ibm_hosts |
---|
85 | file: |
---|
86 | .nf |
---|
87 | |
---|
88 | mvs primary mvs-host |
---|
89 | tso alias mvs-host |
---|
90 | mvs2 primary mvs-host/4012 |
---|
91 | vm primary vtam Tab() String(3) Enter() |
---|
92 | |
---|
93 | .fi |
---|
94 | An 3270 emulator will display four names |
---|
95 | .RB ( mvs , |
---|
96 | .BR mvs2 , |
---|
97 | .B afhost |
---|
98 | and |
---|
99 | .BR vm ) |
---|
100 | on its hosts menu. |
---|
101 | The names |
---|
102 | .B mvs |
---|
103 | and |
---|
104 | .B tso |
---|
105 | will cause connections to the host |
---|
106 | .BR mvs-host. |
---|
107 | The name |
---|
108 | .B mvs2 |
---|
109 | will also cause a connection to |
---|
110 | .BR mvs-host , |
---|
111 | but to port 4012 rather than the emulator's default port (usually 23). |
---|
112 | The name |
---|
113 | .B vm |
---|
114 | will cause the 3270 emulator to connect to the host |
---|
115 | .B vtam |
---|
116 | (presumably some sort of host-selection front-end), |
---|
117 | enter the string ``3'' on the second data-entry field on the screen, and |
---|
118 | send the ENTER AID sequence. |
---|
119 | .SH FILES |
---|
120 | /usr/lib/X11/x3270/ibm_hosts |
---|
121 | .SH "SEE ALSO" |
---|
122 | x3270(1) |
---|