1dnl Copyright (c) 1994-2009, Paul Mattes. 2dnl All rights reserved. 3dnl 4dnl Redistribution and use in source and binary forms, with or without 5dnl modification, are permitted provided that the following conditions are met: 6dnl * Redistributions of source code must retain the above copyright 7dnl notice, this list of conditions and the following disclaimer. 8dnl * Redistributions in binary form must reproduce the above copyright 9dnl notice, this list of conditions and the following disclaimer in the 10dnl documentation and/or other materials provided with the distribution. 11dnl * Neither the names of Paul Mattes nor the names of his contributors 12dnl may be used to endorse or promote products derived from this software 13dnl without specific prior written permission. 14dnl 15dnl THIS SOFTWARE IS PROVIDED BY PAUL MATTES "AS IS" AND ANY EXPRESS OR IMPLIED 16dnl WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 17dnl MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 18dnl EVENT SHALL PAUL MATTES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 19dnl SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED 20dnl TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 21dnl PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 22dnl LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 23dnl NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 24dnl SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25XX_TH(IBM_HOSTS,5,XX_DATE) 26XX_SH(Name) 27ibm_hosts XX_DASHED() host database for x3270 and c3270 28XX_SH(Synopsis) 29/usr/lib/X11/x3270/ibm_hosts 30XX_SH(Description) 31The XX_FB(ibm_hosts) 32file contains information regarding IBM hosts on the network. 33An XX_FI(IBM host) is a host which can communicate with a 3270 terminal 34emulator such as XX_FB(x3270) or XX_FB(c3270). 35Each line defines a name in the following format 36(optional fields are shown in brackets): 37XX_LP 38XX_FI(name) XX_FI(type) [XX_FI(opt):]...[XX_FI(luname)@]XX_FI(hostname)[:XX_FI(port)] [XX_FI(actions)] 39XX_LP 40Items are separated by any number of blanks and/or TAB characters. 41A line beginning with `#' is taken as a comment (note that `#' anywhere 42else on a line does XX_FI(not) indicate a comment). 43XX_LP 44The XX_FI(name) field is a mnemonic used to identify the host. 45XX_LP 46The XX_FI(type) field is a keyword that indicates the type of entry. 47The value XX_FB(primary) means that the XX_FI(name) 48will be included in host-selection menus that may be displayed by a 493270 emulator. 50The value XX_FB(alias) means that the XX_FI(name) 51will not be included in menus, but will still be accepted as valid input 52when a host name is required. 53XX_LP 54The XX_FI(hostname) 55field is the Internet hostname or dot-notation Internet address of the host. 56XX_LP 57The XX_FI(hostname) 58can `include' ``s:'' or ``p:'' prefixes, e.g., XX_FB(s:finicky) 59(see the XX_LINK(x3270-man.html,XX_FI(x3270)(1)) or 60XX_LINK(c3270-man.html,XX_FI(c3270)(1)) man page sfor details). 61It can also include an LU name, separated by an ``@'' character, e.g., 62XX_FB(oddlu@bluehost). 63Finally, it can include a non-default XX_FI(port) number, appended to the 64XX_FI(hostname) with a colon ``:'' character, e.g., 65XX_FB(bluehost:97). 66(For compatability with earlier versions of XX_FI(x3270), 67the XX_FI(port) can also be separated by a slash ``/'' character.) 68XX_LP 69The optional XX_FI(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, e.g., 73XX_FB(PF(1)), 74it is unmodified; otherwise it is taken as the parameter to the 75XX_FB(String()) 76action. 77The 78XX_FI(actions) 79are not intended for entering usernames and passwords; rather they provide an 80automated way of specifying a front-end menu option. 81XX_SH(Example) 82Given the following 83XX_FB(ibm_hosts) 84file: 85XX_LP 86XX_RS(`mvs primary mvs-host 87XX_BR 88tso alias mvs-host 89XX_BR 90mvs2 primary mvs-host:4012 91XX_BR 92vm primary vtam Tab() String(3) Enter() 93') 94A 3270 emulator will display four names (XX_FB(mvs), XX_FB(mvs2), 95XX_FB(afhost) and XX_FB(vm)) on its hosts menu. 96The names XX_FB(mvs) and XX_FB(tso) will cause connections to the host 97XX_FB(mvs-host). 98The name XX_FB(mvs2) will also cause a connection to 99XX_FB(mvs-host), 100but to port 4012 rather than the emulator's default port (usually 23). 101The name XX_FB(vm) will cause the 3270 emulator to connect to the host 102XX_FB(vtam) (presumably some sort of host-selection front-end), 103enter the string ``3'' on the second data-entry field on the screen, and 104send the Enter XX_SM(AID) sequence. 105XX_SH(Files) 106/usr/lib/X11/x3270/ibm_hosts 107XX_SH(See Also) 108XX_LINK(x3270-man.html,x3270(1)), 109XX_LINK(c3270-man.html,c3270(1)) 110