OS/2 Professional/OS2PRO194.ISO/os2/network/gopher/gopher.hlp

OS/2 Help File | 1993-06-23 | 30KB | 892 lines

ΓòÉΓòÉΓòÉ 1. About Gopher ΓòÉΓòÉΓòÉ

This section has general information about Gopher and the OS/2 Gopher Client.

o Gopher History

o About the OS/2 Gopher Client

o Where to Find More Information on Gopher

o Changes to the OS/2 Gopher Client


ΓòÉΓòÉΓòÉ 1.1. Gopher History ΓòÉΓòÉΓòÉ

The Gopher protocol was developed in April, 1991, by the University of
Minnesota's Microcomputer, Workstation, and Networks Center to help users on
campus find answers to their computer questions.


ΓòÉΓòÉΓòÉ 1.2. About the OS/2 Gopher Client ΓòÉΓòÉΓòÉ

The OS/2 Gopher Client is Copyright (c) 1993 International Business Machines
Corporation.  All Rights Reserved.

It was written by David Singer ([e-mail]) and is distributed
under the terms of the OS/2 Employee-Written Software program.

Comments about this program may be posted to the OS2BBS in the OS2EWS CFORUM,
or to the Usenet newsgroup comp.infosystems.gopher. IBMers may append to GOPHER
FORUM on IBMPC.

Gopher is a trademark of the University of Minnesota.

GIF and Graphics Interchange Format are trademarks of Compuserve.

You may also want to read Gopher Command Options and Known Bugs and
Infelicities.


ΓòÉΓòÉΓòÉ 1.2.1. Gopher Command Options ΓòÉΓòÉΓòÉ

The full format of the Gopher command is:

GOPHER [hostname [string]]

Where:

hostname
          is the name of the host to which you want to connect for the initial
          menu.

string
          is the string to send to obtain the initial menu.  If the string
          contains spaces or special characters, you should enclose it in
          double quotes, like this:

                    "1 about"

If you omit both parameters, Gopher will use your initial bookmark if you have
one.  If you do not have an initial bookmark, Gopher will connect to the Gopher
server at the University of Minnesota (if you are on the Internet) or the
Gopher server at the IBM Almaden Research Center (if you are on the IBM IP
network).

If you only specify a hostname, Gopher will send an empty string as the initial
request -- this will cause the remote Gopher server to send you its main menu.


ΓòÉΓòÉΓòÉ 1.2.2. Known Bugs and Infelicities ΓòÉΓòÉΓòÉ

Bugs

o Font manipulation on the main menu doesn't always work correctly.

o You cannot interrupt a TCP/IP activity -- you must wait for it to complete or
  time out.

o If you close Gopher while a choice box is on the screen, it may not end
  completely.

o If your GIF-viewing program requires DLLs, and if the DLLs are not on your
  LIBPATH, Gopher may abruptly terminate.

Infelicities

o Your initial bookmark must be of type menu.

o The help isn't as helpful as it might be.

o The main menu may jump horizontally when you use the cursor keys to scroll it
  vertically.


ΓòÉΓòÉΓòÉ 1.2.3. Future Plans ΓòÉΓòÉΓòÉ

While nothing is guaranteed, and IBM and I explictly disclaim any support for
Gopher, I hope to continue working on the program.  I would like to make these
improvements:

o Fix the bugs and infelicities.

o Add a Rexx interface so that you can write Gopher programs.

Your comments are welcome -- see About the OS/2 Gopher Client  to see where to
post comments.


ΓòÉΓòÉΓòÉ 1.3. Where to Find More Information on Gopher ΓòÉΓòÉΓòÉ

The Gopher Frequently Asked Questions file is posted every two weeks to the
Usenet newsgroups comp.infosystems.gopher, comp.answers, and news.answers.  It
can be gotten through Gopher to the University of Minnesota's Gopher server, or
via anonymous FTP from pit-manager.mit.edu in the file
/pub/usenet/news.answers/gopher-faq.

Those without FTP access should send e-mail to [e-mail] with
"send usenet/news.answers/finding-sources" in the body to find out how to do
FTP by e-mail.

Inside IBM, the Gopher FAQ file is available on the NETINFO disk as GOPHER
ANSWERS.


ΓòÉΓòÉΓòÉ 1.4. Changes to the OS/2 Gopher Client ΓòÉΓòÉΓòÉ

Version 1.04

o Moving Gopher's windows while they are minimized no longer causes them to
  restore themselves.

Version 1.03

o Changed the network selection code (again) so that it is only done one time
  per machine, rather than every time Gopher is started up.

o Fixed some serious memory allocation errors.

Version 1.01

o Minor changes to .INI file handling to work around a change in the March beta
  of OS/2 2.1.

o You can now use the '=' key as well as Ctrl-I (or the Gopher pulldown menu)
  to see the details of the currently selected item.


ΓòÉΓòÉΓòÉ 2. The Main Window ΓòÉΓòÉΓòÉ

Gopher's main window allows you to:

o Select an item from the current menu

o Return to the previous menu

o Exit from the program

o See the definition of the current menu (Current Menu Details)

o See the definition of the currently selected item (Current Item Details)

o See the bookmark list and optionally load or delete a bookmark. (Bookmark
  List)

o See the definition of the Initial Bookmark, which is used when you invoke
  Gopher without specifying any parameters.

o Change the font or colors used on the menu

o Save, load, or delete a set of font and color choices (a scheme)

o See and change the options Gopher uses for:

   - The program used for Telnet sessions
   - The program used for TN3270 sessions
   - The program used for viewing GIF files
   - The default directory used for saving text files
   - The default directory used for saving binary files


ΓòÉΓòÉΓòÉ 2.1. Current Menu Details ΓòÉΓòÉΓòÉ

This selection brings up a dialog box which has five fields:

Name      The name that will be displayed in the main window's title bar. This
          will also be the name used if you save this menu as a bookmark.

Host      The name (or IP address) of the system which offers this menu.

Port      The port number at which this menu can be found.

Path      The string Gopher should send the server to select this menu.

Type      The one-character Gopher type of this menu.  (For a menu, this is
          always "1")

You will almost never change any of these fields except name.

The dialog box allows you to select any of these actions:

OK        Gopher uses the definition in the dialog box as if you had selected
          it from a menu.

Cancel    Return to the main window.

Save      Saves the current definition as a bookmark.  You can use it later in
          this session, or in a future session, by selecting the Bookmark List
          menu item.

Save as First Saves the current definition as a bookmark, and establishes it as
          the starting point for future Gopher sessions.

Help      Enters the help system.


ΓòÉΓòÉΓòÉ 2.2. Current Item Details ΓòÉΓòÉΓòÉ

This selection brings up a dialog box which has five fields:

Name      The name that will be displayed in the main window's title bar. This
          will also be the name used if you save this item as a bookmark.

Host      The name (or IP address) of the system which offers this item.

Port      The port number at which this item can be found.

Path      The string Gopher should send the server to select this item.

Type      The one-character Gopher type of this item.

You will almost never change any of these fields except name.

The dialog box allows you to select any of these actions:

OK        Gopher uses the definition in the dialog box as if you had selected
          it from a menu.

Cancel    Return to the main window.

Save      Saves the current definition as a bookmark.  You can use it later in
          this session, or in a future session, by selecting the Bookmark List
          menu item.

Save as First Saves the current definition as a bookmark, and establishes it as
          the starting point for future Gopher sessions.

Help      Enters the help system.


ΓòÉΓòÉΓòÉ 2.3. Bookmark List ΓòÉΓòÉΓòÉ

Gopher displays a dialog box which contains a list of all the bookmarks you
have established, in this or previous sessions.  You may choose one by
double-clicking it (or highlighting it and pressing the "OK" button) -- Gopher
will request that bookmark from the appropriate server.

You may also select a bookmark and choose one of the other buttons:

Cancel    Gopher returns to the main menu.

Details   Gopher shows a dialog box with the full definition of this bookmark.
          You can then modify it, choose it, resave it, or delete it.

Delete    Gopher deletes this bookmark from its .INI file.  You can no longer
          select this bookmark.


ΓòÉΓòÉΓòÉ 2.4. Initial Bookmark ΓòÉΓòÉΓòÉ

Gopher displays the definition of the initial bookmark, which will be used
whenever you start Gopher (unless you override it with command-line
parameters).  You can change it, save it as an ordinary bookmark, or go to it.


ΓòÉΓòÉΓòÉ 2.5. Font ΓòÉΓòÉΓòÉ

You can select the font you wish to use in this window.  Gopher opens the
standard system font dialog to allow you to select a font.

Note:  There are bugs in Gopher's handling of fonts in the main window; your
selection may not actually be honored.  If Gopher cannot use your selection,
the main window will be redrawn in the standard system font, System
Proportional.


ΓòÉΓòÉΓòÉ 2.6. Color ΓòÉΓòÉΓòÉ

You can select the foreground and background colors you wish to use in this
window.

In addition to normal colors (like red, green, and light blue), Gopher's color
list includes three system-defined colors:

o System Foreground

o System Background

o System Text Output


ΓòÉΓòÉΓòÉ 2.7. Save Scheme ΓòÉΓòÉΓòÉ

You can save the current font and colors in Gopher's .INI file.  You can then
use this scheme later in this or future sessions, and you can use the same
scheme in any of Gopher's windows.

Gopher displays a dialog box and allows you to give the scheme a name.  You may
choose to save the scheme as the default scheme for this type of window.


ΓòÉΓòÉΓòÉ 2.8. Load Scheme ΓòÉΓòÉΓòÉ

You can load a previously-saved scheme, or revert to the default scheme for
this type of window.

Gopher displays a dialog box which allows you to select any of the
previously-saved schemes.


ΓòÉΓòÉΓòÉ 2.9. Delete Scheme ΓòÉΓòÉΓòÉ

You can delete any of the schemes you have saved.

Gopher displays a dialog box which allows you to select any of the
previously-saved schemes.


ΓòÉΓòÉΓòÉ 2.10. Telnet Options ΓòÉΓòÉΓòÉ

You can select the program which is to be invoked when you choose a menu item
of type telnet.  By default, Gopher uses a program named tn.exe, but you may
specify any program.

The dialog box has the following fields:

Program name Enter the full name of the program.  It is best if you enter the
          full path, too (d:\tcpip\bin\tn.exe rather than tn.exe), but if you
          only specify the name of the program, Gopher will automatically
          search your path for it.

          Warning: If the program you specify requires dynamic link libraries
          (DLLs), you must ensure that the DLLs are available and are in a
          directory mentioned in the LIBPATH= statement in your CONFIG.SYS
          file.  If the DLLs are not available, Gopher may terminate abruptly
          when it tries to start the program.

Parameters Enter any parameters you want to pass to the program.  Gopher will
          automatically add the name of the system to connect to and the port
          number (as provided by the menu entry) as the last two parameters.

Notification options Some menu entries carry additional data (for example, you
          may have to login as a specific user name).  You can choose to have
          this data displayed in any of the following ways:

   o As a message box -- If there is additional data for this entry, Gopher
     will display a message box before invoking the telnet program. Once the
     message box has been displayed, you can choose to continue or to cancel
     the telnet session.

   o As the window title -- If there is additional data for this entry, Gopher
     will use the first sixty characters as the title of the window in which
     the telnet program is run.

Run via CMD.EXE Normally, Gopher runs the program directly.  You may, however,
          choose to run the program under control of CMD.EXE (the system
          command processor).

          If the program is a batch file (ends in .CMD or .BAT), Gopher will
          automatically invoke CMD.EXE to run it whether or not you have
          checked this box.

Any changes you make to the options take effect when you press the OK button;
the changes are also saved in Gopher's .INI file for future sessions.


ΓòÉΓòÉΓòÉ 2.11. TN3270 Options ΓòÉΓòÉΓòÉ

You can select the program which is to be invoked when you choose a menu item
of type TN3270.  By default, Gopher uses a program named TN3270.exe, but you
may specify any program.

The dialog box has the following fields:

Program name Enter the full name of the program.  It is best if you enter the
          full path, too (d:\tcpip\bin\TN3270.exe rather than TN3270.exe), but
          if you only specify the name of the program, Gopher will
          automatically search your path for it.

          Warning: If the program you specify requires dynamic link libraries
          (DLLs), you must ensure that the DLLs are available and are in a
          directory mentioned in the LIBPATH= statement in your CONFIG.SYS
          file.  If the DLLs are not available, Gopher may terminate abruptly
          when it tries to start the program.

Parameters Enter any parameters you want to pass to the program.  Gopher will
          automatically add the name of the system to connect to and the port
          number (as provided by the menu entry) as the last two parameters.

Notification options Some menu entries carry additional data (for example, you
          may have to login as a specific user name).  You can choose to have
          this data displayed in any of the following ways:

   o As a message box -- If there is additional data for this entry, Gopher
     will display a message box before invoking the TN3270 program. Once the
     message box has been displayed, you can choose to continue or to cancel
     the TN3270 session.

   o As the window title -- If there is additional data for this entry, Gopher
     will use the first sixty characters as the title of the window in which
     the TN3270 program is run.

Run via CMD.EXE Normally, Gopher runs the program directly.  You may, however,
          choose to run the program under control of CMD.EXE (the system
          command processor).

          If the program is a batch file (ends in .CMD or .BAT), Gopher will
          automatically invoke CMD.EXE to run it whether or not you have
          checked this box.

Any changes you make to the options take effect when you press the OK button;
the changes are also saved in Gopher's .INI file for future sessions.


ΓòÉΓòÉΓòÉ 2.12. GIF Viewer Options ΓòÉΓòÉΓòÉ

You can select the program which is to be invoked when you choose a menu item
of type GIF.  There is no default program.

The dialog box has the following fields:

Program name Enter the full name of the program.  It is best if you enter the
          full path, too (d:\tcpip\bin\gifview.exe rather than gifview.exe),
          but if you only specify the name of the program, Gopher will
          automatically search your path for it.

          Warning: If the program you specify requires dynamic link libraries
          (DLLs), you must ensure that the DLLs are available and are in a
          directory mentioned in the LIBPATH= statement in your CONFIG.SYS
          file.  If the DLLs are not available, Gopher may terminate abruptly
          when it tries to start the program.

Parameters Enter any parameters you want to pass to the program.  Gopher will
          automatically add the full file identifier of the GIF file as the
          last parameter.

Run via CMD.EXE Normally, Gopher runs the program directly.  You may, however,
          choose to run the program under control of CMD.EXE (the system
          command processor).

          If the program is a batch file (ends in .CMD or .BAT), Gopher will
          automatically invoke CMD.EXE to run it whether or not you have
          checked this box.

Use for <GIF> files? You can have Gopher use this program for files of type
          <GIF>.  This box is checked by default.  If you uncheck the box, you
          can still transfer GIF files to your disk, but you cannot
          automatically view them.

Use for <image> files? You can have Gopher use this program for files of type
          <image>.  This box is checked by default.  If you uncheck the box,
          you can still transfer image files to your disk, but you cannot
          automatically view them.

          Note that not all image files are actually in GIF format; there is no
          way to tell if such a file will be viewable by a GIF viewer before it
          has been transferred.

Any changes you make to the options take effect when you press the OK button;
the changes are also saved in Gopher's .INI file for future sessions.


ΓòÉΓòÉΓòÉ 2.13. Setting Default Directories ΓòÉΓòÉΓòÉ

Text Files

You can specify the directory where Gopher will normally save text files (files
you save from a document window or phonebook search results).  This directory
is used as the initial directory in the dialog box that is displayed when you
select the Save As... menu item in a document window or phonebook search
window.

If you do not specify a directory, Gopher uses the working directory for the
Gopher session.

Binary Files

You can specify the directory where Gopher will normally save binary files,
which include files of the following types

o Mac Binary

o PC Binary

o UUencoded

o Binary

o GIF

o Image

For all files but GIF and image, Gopher opens a dialog box to allow you to
specify the actual filename -- you can override the directory in that dialog.

However, files of type GIF and image are automatically transferred to your
default directory for binary files; you are not given a chance to override the
directory.

If you do not specify a directory, Gopher uses the working directory for the
Gopher session.


ΓòÉΓòÉΓòÉ 2.14. Network Selection ΓòÉΓòÉΓòÉ

This option allows you to tell Gopher whether your system is located on the
Internet or the IBM IP network.  Normally, Gopher deduces which network you are
connected to by checking the name of your system; if it ends in ibm.com, Gopher
assumes you are on the IBM IP network; otherwise, Gopher assumes you are on the
Internet.  Gopher only does this check the first time you use it on a
particular machine (or if you erase the GOPHER.INI file).

You can override Gopher's assumption by selecting the correct network from this
dialog box.

The network you specify only affects two minor aspects of Gopher's behavior:

o Initial Menu

  If you have not specified an initial menu (which you can do from the Menu
  Details, Item Details, or Bookmark List menus), Gopher will choose the first
  menu depending on which network your system is connected to.

  If your system is on the Internet, Gopher will get its first menu from one of
  the primary Gopher servers at the University of Minnesota (either
  gopher.micro.umn.edu or gopher2.tc.umn.edu).  If your system is on the IBM IP
  network, Gopher will get its first menu from the Gopher server at the IBM
  Almaden Research Center.

o Useful Gopher Servers

  Gopher has two short lists of useful servers built in.  One list includes
  servers on the Internet; the other list includes servers on the IBM IP
  network.  Gopher will only display the list which matches your network.


ΓòÉΓòÉΓòÉ 3. Menu items ΓòÉΓòÉΓòÉ

When Gopher connects to a server, it may receive a menu or a document.  A
document is displayed in a document window Menus are displayed in the container
in the main window.  You can select an item in the container and:

o Double-click it (or press the OK button).  This causes Gopher to contact the
  server mentioned in the menu item and request that the document (or menu)
  referred to by the item be sent to you.

o Choose Item Details (or press '=' or Ctrl-I), to see information about the
  current item.

You may also:

o Choose Menu Details (or press Ctrl-M), to see information about the current
  menu.

o Choose Bookmark List (or press Ctrl-B), to select from bookmarks you have
  previously saved.

o Press the Previous Menu button (if available) to return to the menu from
  which you selected the current menu.

o Press the Exit button to exit Gopher completely.


ΓòÉΓòÉΓòÉ 3.1. Item Types ΓòÉΓòÉΓòÉ

Each item on a menu has a specific type, as defined by the Gopher protocol.
The OS/2 Gopher client understands how to deal with the following types:

document  Gopher requests the document from the server and displays it in a new
          document window on your screen. (Documents are Gopher type 0.)

menu      Gopher requests the menu from the server and displays it in the menu
          window on your screen, replacing the current menu.  You can return to
          the current menu by pressing the Previous Menu button. (Menus are
          Gopher type 1.)

phonebk   Gopher opens a phonebook search window on your display. You can then
          fill in that window with a query, which Gopher will send to the
          phonebook server.  (Phonebooks are Gopher type 2.)

error     An item of type error appears when the remote server could not handle
          a request.  If you select an item of type error, Gopher does nothing
          with your request.

Mac binary Gopher opens a dialog box for you to specify the name and location
          of the file in which you want the remote file to be stored. Gopher
          transfers the remote file exactly as the remote server presents it;
          it does not try to interpret the contents of the file.  (Mac binary
          files are Gopher type 4.)

PC binary Gopher opens a dialog box for you to specify the name and location of
          the file in which you want the remote file to be stored. Gopher
          transfers the remote file exactly as the remote server presents it;
          it does not try to interpret the contents of the file. (PC binary
          files are Gopher type 5.)

UUencoded Gopher opens a dialog box for you to specify the name and location of
          the file in which you want the remote file to be stored. Gopher
          transfers the remote file exactly as the remote server presents it;
          it does not try to interpret the contents of the file. (UUencoded
          files are Gopher type 6.)

Search    Gopher opens a dialog box in which you can type a search term.  This
          term can be one or more words; it will be intepreted by the remote
          server, not by the OS/2 Gopher client. The remote server will create
          a new menu (which may be empty) and send it to the client for
          display.  (Search is Gopher type 7.)

Telnet    This menu item represents a Telnet session to a remote computer.  If
          you select it, Gopher will open up a new window on your screen and
          run the Telnet program you have specified. (Telnet is Gopher type 8.)

Binary    Gopher opens a dialog box for you to specify the name and location of
          the file in which you want the remote file to be stored. Gopher
          transfers the remote file exactly as the remote server presents it;
          it does not try to interpret the contents of the file. (Binary files
          are Gopher type 9.)

TN3270    This menu item represents a TN3270 session to a remote computer.  If
          you select it, Gopher will open up a new window on your screen and
          run the TN3270 program you have specified. (TN3270 sessions are
          Gopher type T.)

GIF       This menu item represents a Graphics Interchange Format file.  If you
          select it and you have defined a GIF viewing program, Gopher will
          transfer the file from the remote server and open a new session on
          your screen in which it will run the GIF viewing program.  Gopher
          will not delete the GIF file; you can do that manually, or your GIF
          viewing program can do that for you.

          The file will be stored in your default directory for binary files;
          the name of the file will be GOnnn.GIF, where nnn starts with 0 for
          the first file of a Gopher session and increases by 1 for each
          additional file. (GIF files are Gopher type g.)

image     This menu item represents a file of an undetermined image type, often
          GIF. If you select it and you have defined a image viewing program,
          Gopher will transfer the file from the remote server and open a new
          session on your screen in which it will run the image viewing
          program.  Gopher will not delete the image file; you can do that
          manually, or your image viewing program can do that for you.

          The file will be stored in your default directory for binary files;
          the name of the file will be GOnnn.GIF, where nnn starts with 0 for
          the first file of a Gopher session and increases by 1 for each
          additional file.

          Note:  Gopher treats image files as equivalent to GIF files -- the
          same viewing program is used for both, and the files are always
          transferred with an extension of GIF. (Image files are Gopher type
          I.)

"nothing" A menu item without a leading type represents inline information
          about the current menu.  If you select such an item, Gopher does
          nothing. (Inline items are Gopher type i.)

Other     Any type that Gopher does not recognize is reported as <type x>.  If
          you select such an item, Gopher does nothing.


ΓòÉΓòÉΓòÉ 4. Document Windows ΓòÉΓòÉΓòÉ

When you select a menu item of type document, Gopher opens a document window on
your screen and displays its contents in that window.  A document window is,
basically, a Presentation Manager multiline edit control (MLE) and inherits
most of its behavior from the basic system.  However, Gopher augments the basic
MLE with some additional options, which are accessible from the menu bar or via
accelerator keys.  These options are:

Exit (F3) Closes this document window.  Does not affect any other Gopher
          window.

Save As (Ctrl-A) Opens a file selection dialog box and allows you to save the
          contents of this document window as a file anywhere on the system.

Select Font (Ctrl-F) Opens a font selection dialog box and allows you to select
          the font to be used to display this document window.

Select Color (Ctrl-C) Opens a color selection dialog box and allows you to
          select the colors to be used to display this document window.

Load Scheme (Ctrl-L) Shows a list of all saved schemes (font and color
          combinations). You may choose a saved scheme, revert to the default
          scheme for document windows, or leave the window unchanged.

Save Scheme (Ctrl-S) Shows a list of all saved schemes (font and color
          combinations). You may save the current scheme (giving it a new name,
          or overwriting an existing scheme); you may also specify that the
          current scheme become the default for future document windows.

Delete Scheme (Ctrl-D) Shows a list of all saved schemes (font and color
          combinations). You may delete any of the saved schemes.

In addition to these actions, the usual actions for a multiline edit control
are available -- these include cutting, copying, and pasting to and from the
clipboard and editing the text in the window.


ΓòÉΓòÉΓòÉ 5. The Phonebook Search Window ΓòÉΓòÉΓòÉ

If you select an item of type phonebk, Gopher opens a new window on your
screen.  This window has two sections:

o The query section

o The results section

The results section is, in fact, a Gopher document window and has the same set
of menu selections and options as any other document window (however, it has
its own default font and color scheme).

The query section has four entry fields in which you compose a phonebook query
which Gopher will send to the remote server.  These fields are:

Name      The name of the person you want to find.  Most phonebook servers
          expect the name as "first last".

Phone     The phone number of the person you want to find.

Email Address The electronic mail address of the person you want to find.

Location  The location of the person you want to find.

Different phonebook lookup servers may interpret this information in different
ways.


ΓòÉΓòÉΓòÉ 6. Other Topics ΓòÉΓòÉΓòÉ

This section includes some miscellaneous information.


ΓòÉΓòÉΓòÉ 6.1. Saving the contents of a window ΓòÉΓòÉΓòÉ

You can save the contents of a document window (which includes the results of
phonebook searches).  Gopher displays the standard OS/2 "File Selection" dialog
and to allow you to select the file in which the window's contents are to be
saved.

If you select a file which already exists, Gopher displays a dialog box to
allow you to choose between overwriting the file, appending to it, or
cancelling the save operation.


ΓòÉΓòÉΓòÉ 6.2. Searching ΓòÉΓòÉΓòÉ

If you select an item of type search, Gopher opens a window in which you can
type one or more search words.  If you press Enter or click on the "OK" box in
this window, Gopher asks the remote server to search based on the words you
provided.

The remote server will build a menu from the results of the search, and Gopher
will display this menu for you.

If you type more than one word in the window, most servers will search for
items containing all the words you specified. However, some servers will search
for items containing the words you specified in exactly the order in which you
specified them, and still other servers will search for items containing any of
the words you specified.

Unfortunately, there is no way to know in advance how a specific server will
interpret a multi-word request.


ΓòÉΓòÉΓòÉ 6.3. About Bookmarks ΓòÉΓòÉΓòÉ

You can save any menu or entry on a menu as a bookmark and use it in the
current session, or in any later session.

A bookmark has five parts:

Name      The name of the bookmark.  Names can be of any length and are
          case-sensitive; you can only have one bookmark with a particular
          name.

Host      The name (or IP address) of the system which offers this menu.

Port      The port number at which this menu can be found.

Path      The string Gopher should send the server to select this menu.

Type      The one-character Gopher type of this menu.


ΓòÉΓòÉΓòÉ 6.4. Information about this Telnet or TN3270 session ΓòÉΓòÉΓòÉ

If the Gopher server providing the pointer to the Telnet or TN3270 session you
are about to start has provided additional information, it is displayed in this
dialog box.

If you select OK, Gopher will invoke your Telnet or TN3270 program in a
separate Presentation Manager session.

If you select Cancel, Gopher will not start the Telnet or TN3270 session.


ΓòÉΓòÉΓòÉ 6.5. Gopher's .INI file use ΓòÉΓòÉΓòÉ

Gopher maintains a private .INI file, named gopher.ini, in the directory
referenced by the ETC environment variable. This is the same directory that
OS/2 TCP/IP programs use to maintain their customization.

The .INI file contains:

o The initial menu to be displayed on Gopher startup

o Bookmarks

o Saved schemes

o The programs to be used for menu items of types:

   - Telnet
   - TN3270
   - GIF

o Default directories for saving files

o Whether your system is on the Internet or the IBM IP network

If you erase this file, Gopher will lose all of your customizations and will
return to its built-in defaults:

o The initial menu will be depend on the name of your OS/2 system.

   - If the name ends in ".ibm.com", the initial menu will be obtained from
     gopher.almaden.ibm.com (the primary Gopher server at the IBM Almaden
     Research Center)
   - If the name ends in anything but ".ibm.com", the initial menu will be
     obtained from one of the primary Gopher servers at the University of
     Minnesota, either gopher.micro.umn.edu or gopher2.tc.umn.edu.

o No bookmarks

o All windows are displayed in standard system colors using the System
  Proportional font

o The following programs are used for special menu items:

   - tn.exe is used for menu items of type telnet
   - TN3270.exe is used for menu items of type TN3270
   - No GIF Viewer program is defined, so menu items of type GIF cannot be
     displayed

o Files are saved into the working directory of the Gopher session


ΓòÉΓòÉΓòÉ 6.6. Useful Servers on the Internet ΓòÉΓòÉΓòÉ

This menu item opens a short list of useful Gopher servers on the Internet.
These are not, by any means, a complete list of useful Gopher servers, but they
provide a place to start exploring.

The servers are:

University of Minnesota This is the original Gopher server, as developed at the
          University of Minnesota.  This server has the most current
          information on Gopher, and has a long list of pointers to other
          Gopher servers around the world.  Gopher will randomly pick one of
          the two primary Gopher servers, either gopher.micro.umn.edu or
          gopher2.tc.umn.edu.

U of I Weather Machine This server, at the University of Illinois, provides
          weather information.

IBM Almaden Research Center This is an experimental Gopher server.  It provides
          information about the IBM Almaden Research Center (including seminars
          and press releases).  It also contains information about other IBM
          organizations and products.


ΓòÉΓòÉΓòÉ 6.7. Useful Servers on the IBM IP Network ΓòÉΓòÉΓòÉ

You can only access these servers if your system is on the IBM IP network --
these servers are not available from the Internet.

IBM Almaden Research Center Information of use to people at Almaden, including
          local weather, IBM TV schedules, and network status information.

IBM Weather Gopher Weather forecasts for selected cities; weather maps and
          satellite pictures.