source: trunk/third/x3270/ibm_hosts.man @ 9081

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