FAQ: OS/2 Warp


Contents

Introduction

This document gives detailed instructions for connecting to Camnet from a PC running the IBM operating system OS/2 Warp.

This is nearly $Revision: 0.10 $ of this FAQ (http://www.cam.net.uk/manuals/os2faq/os2faq.html), last updated $Date: 1998/08/14 14:14:14 $.

Please send comments to Patrick Campbell-Preston (patrick@cam.net.uk).

You may need to have your OS/2 installation CDs or floppy disks available, and you will also need your CamNet user ID and password which can be found on your welcome letter.

You should have a modem either installed inside your PC or connected externally to a spare serial port. Although OS/2 recognises a wide selection of different modems, it may help to have the modem manufacturer's documentation to hand.

Versions of OS/2 covered by this document

This FAQ covers access to CamNet from either OS/2 Warp version 3 or OS/2 Warp version 4 (Merlin). Both of these come with bundled support for Internet access: in version 3 this is found in the BonusPak, while in version 4 it comes as an optional component of the operating system itself (along with TCP/IP support for a local area network, whether you need it or not).

Although a few cosmetic details have changed between version 3 and version 4 (in particular the default arrangement of the Desktop is quite different), most of the instructions below apply identically to both versions; differences are noted where necessary. I don't have access to a copy of Warp Connect, but since this is basically Warp version 3 with some extra LAN support, it should not be too different to set up.

If you are using an earlier version of OS/2, you may still be able to access CamNet, although this will depend on obtaining a suitable version of 'IBM TCP/IP for OS/2', since TCP/IP support was not originally supplied free with the operating system. I don't know whether TCP/IP support for all OS/2 versions is still available (still less whether it is now free), but you could try looking on the IBM Internet helpdesk home page for Europe, Middle East and Africa ("EMEA"), or phoning the IBM UK Software Enquiry Desk (01329 242728) for further advice.

OS/2 support for Internet access has been under continuous development over the past few years, so unless you have a brand new copy of Warp version 4 it is almost certainly worth looking at EMEA or the IBM Software Download library for upgrades and bugfixes to your particular version. A good list of these on the web is the Cincinnati Team OS/2 Master Warp Update List.

Some early copies of Warp version 3 (eg the version shipped with many PCs sold in Germany a few years ago) came with a somewhat restricted version of the Internet Access Kit, with no WebExplorer and no support in the dialler for the PPP protocol - although it is possible to connect to CamNet from one of these systems using SLIP instead of PPP, it will be easier if you obtain and install a more recent version of the IAK. Feel free to contact me if you need help with this.

Installing the Internet Access Kit

If you have not already done so, you should begin by installing the Internet Access Kit, as follows:

Warp 3:

In Warp version 3, the Internet Access Kit can be found in the BonusPak; to install it, run the BonusPak installation utility \UK\INSTALL.CMD from the BonusPak CD, select 'IBM Internet Connection for OS/2', and follow the simple instructions [If your BonusPak came on floppy disks, run INSTALL.CMD from the floppy labelled 'BonusPak Installation Utility diskette']. At the end you will be prompted to reboot your PC to complete the installation and take account of the changes it has made to CONFIG.SYS.

Warp 4:

In Warp version 4, the Internet Access Kit can be installed from the OS/2 Program Disk CD using the 'Selective Install for Networking' utility, which can be found in
'OS/2 System' -> 'System Setup' -> 'Install/Remove'.
Select the option 'TCP/IP services' from the list of choices presented, and follow the remaining instructions. At the end you will be prompted to reboot your PC to complete the installation and take account of the changes it has made to CONFIG.SYS.

Finding things on the Desktop

After installing the Internet Access Kit, you will find the program objects you will need to access CamNet in the following places:

Warp 3:

The Dialler can be found in
'IBM Information Superhighway' -> 'IBM Internet Connection for OS/2' -> 
    'Internet Utilities'
(along with other useful programs such as FTP-PM), while the WebExplorer, Newsreader/2 and Ultimedia Mail/2 Lite can be found in the parent folder
'IBM Information Superhighway' -> 'IBM Internet Connection for OS/2'
Some help for the TCP/IP applications and commands can be found in
'IBM Information Superhighway' -> 'IBM Internet Connection for OS/2' -> 
    'Introduction to the IBM Internet Connection'

Warp 4:

The folder containing the Dialler is now more modestly called
'Programs' -> 'Internet (Modem)' -> 'Internet Utilities (Modem)'
while the WebExplorer and other programs can be found as before in the parent folder
'Programs' -> 'Internet (Modem)'
The on-line reference manual for TCP/IP applications can be found in
'Assistance Center' -> 'Information' -> 'Reference and Commands' ->
    'TCP/IP Command Reference' 
or alternatively by typing tcphelp at an OS/2 command prompt.

Note: see the Hints section below for ideas on managing the clutter of folders and objects which come with the IAK, to make it easier to get at the programs you actually use regularly.

Configuring the Dialler

Dialup icon The 'IBM Dial-up for TCP/IP' utility SLIPPM.EXE can be found in the 'Internet Utilities' folder, where it is named 'Dial Other Internet Providers' (don't be confused by the 'IBM Internet Dialer', which is only useful for connecting to IBM's global network).

To set up a dialler configuration which you can use to connect to CamNet, double-click on the 'Dial Other Internet Providers' icon, then click on the 'Add Entry' button. This brings up a window with the first of four pages with fields for you to fill in:

Now click on the right arrow or 'Connect Info' tab to go to the second page, and fill in the following fields (leaving the other fields blank): Now click on the right arrow or 'Server Info' tab to go to the third page, and fill in the following fields (leaving the other fields blank): Now click on the right arrow or 'Modem Info' tab to go to the last page. Set the fields as follows (leaving the remaining fields to be set by default):

Once you have finished filling the settings on all four pages, close the window and select 'Save'; you can now connect to CamNet by clicking on the 'Dial' button of the main Dialler window.

Getting started with OS/2 Internet applications

WebExplorer

Once you have set up the Dialler, configuring the WebExplorer is easy: start it by double-clicking on the icon, and select 'Servers...' from the 'Options' menu. You will need to set your email address (in the form username@home.cam.net.uk), and you should set the 'Proxy Gateway' to http://www-proxy.cam.net.uk/ so that you can reach external URLs supported by the CamNet web proxy server. You may also want to set the location of your home page.

Recent versions of WebExplorer support many more HTML extensions (but not all - the chief omission is any support for frames) than the version which shipped with Warp 3, have better mail and news integration, and are also much more stable - so it's well worth downloading the latest version from the IBM WebExplorer home page (the latest available at the time of writing is version 1.1h).

WebExplorer is simple to use, and relatively small and fast, with a few really neat features: in particular, the WebMap hierarchical history is an excellent way of working out where you've been in a browsing session and how you got there; and the Presentation mode (which hides the menus and icon bar to fill the whole screen with the web page) is occasionally very useful.

Nevertheless, WebExplorer does suffer from a few limitations (even assuming that you can live without framebloat) - for example: it does not cope gracefully with very large pages; it has no 'New window with this link' function; the Quicklist is just a flat list of URLs which you cannot group into categories or annotate with long descriptions; and it does not understand Java (even in Warp 4, which comes with Java support built in). Much has been made of WebExplorer's inability to let you follow a link while a page is still loading, but in truth it isn't too difficult to get into the habit of hitting the Escape key when you want to interrupt the loading of a slow page.

It is unlikely that IBM will continue to develop WebExplorer at a rate which will enable it to catch up with prevailing browser fashion, if at all; for all these reasons, even if you continue to use WebExplorer for some purposes, you will probably find yourself wanting to obtain an 'industry standard' browser before too long (see below).

Ultimedia Mail/2 'Lite'

My experience with this program is not good, and I would hesitate to recommend it. If you do want to use it you may find some useful advice on John Silvia's excellent help pages or IBM's Ultimail Help page.

There are several alternative mail programs available, both free and commercial; of these I would recommend Innoval's Post Road Mailer (of which a free edition is available), unless of course you prefer to use the mailer which is built into Netscape.

FTP-PM

FTP-PM is a simple point-and-click graphical interface to FTP; it is easy to learn, and useful for uploading web pages to CamNet.

To configure FTP-PM to connect to CamNet, start it by double-clicking on the icon, and set the host name to ftp.cam.net.uk. Set your username and password as usual, and the program should start up with a view of your CamNet home directory. Remember to put web pages into the web subdirectory, or they won't be visible; see How to use CamNet Web Space for more details.

Newsreader/2

Newsreader/2 is a simple online Usenet News reader. It should require no further configuration, but the first time you start it you must select 'Load Newsgroups' from the 'Actions' menu; you can then select a group to read, download its article list, and read the postings just by clicking around with the mouse.

TelnetPM

TelnetPM is a simple GUI program which runs telnet, with a few minor advantages over the raw command-line interface (eg you can customise fonts and screen dimensions).

To use TelnetPM to access the CamNet BBS interface, simply click on the 'Telnet (Modem)' icon, and then select 'Open session...' from the 'Connection' menu; enter bbs.cam.net.uk in the 'Host name' field and select VT100 emulation. When you hit 'OK' you should see a login prompt from CamNet's BBS machine, at which point you can just enter your CamNet username and password as usual to enter the Lynx browser.

Alternative applications - freeware

Netscape for OS/2

The final version of Netscape 2.02 for OS/2 is now available for downloading from IBM.

Although it's a port of an out-of-date version of Netscape, it has full support for multimedia plug-ins and both Java and Javascript, and has been well integrated with OS/2 features such as VoiceType navigation, support for Desktop URL objects, drag and drop and so on. It also seems to be very stable - so long as you don't try to close it while it's busy loading a page (in which case it sometimes locks up). It is, however, huge, and I still use WebExplorer regularly because it's so much quicker to start up.

I haven't tried using Netscape for mail and news under OS/2, but it looks as if it's very easy to set up, so it might be the simplest approach to these for some (especially those already used to the Netscape interface and happy with it).

As with the WebExplorer, you will need to configure Netscape to use the CamNet web proxy server www-proxy.cam.net.uk (in the 'Manual Proxy' section under 'Network Preferences...' in the 'Options' menu) if you want to be able to access the external web pages which we support.

Emacs

An excellent OS/2 port of GNU Emacs, maintained by Eberhard Mattes, can be obtained from the Leo OS/2 Archive and several other OS/2 ftp sites such as Hobbes.

The standard Emacs mail and news packages (rmail and gnus) are supported, and are reasonably straightforward to set up - instructions are given in the README file which comes with the distribution. You should also be able to use the slightly more advanced Emacs mail package vm if you prefer; but this does not come with the standard distribution, so you need to obtain it separately from UUNET. Other Emacs packages and related GNU software can be found on the GNU ftp site at MIT.

Note: under Warp 4 some mail configuration details have changed slightly - in particular the files you need to customise will be found in \MPTN\ETC rather than \TCPIP\ETC, and sendmail.cf is slightly more complicated because of Warp 4's extra LAN support.

If you do not want to use Ultimail at all, you can replace sendmail.uml with a copy of your customised sendmail.cf; this means that outgoing mail created with Emacs can be queued whenever you like and will be sent automatically when you next connect to CamNet.

Beware: if for any reason you should need to modify TCP/IP settings using the TCP/IP Configuration program (usually this will not be necessary unless your computer is on a LAN) , you should realise that it may overwrite some of the files you customise for Emacs, so it's a good idea to take copies of them before you do so, in case any of your changes are lost.

Lynx/2

A good beta port of the text-only browser Lynx (as used in the CamNet BBS interface) to OS/2 is available from Hobbes, or you can get the latest (interim) version directly from the port author, Derek J Decker.

HotJava

If you have an up-to-date copy of the Java Development Kit (ie Java 1.1.x, not the version which came with Warp 4) from the IBM Centre for Java Technology Development, you can install and run the unix version of Sun's HotJava browser with only slight modifications to the configuration - see Aaron Williams' OS/2 Java page for details. Among other novel features the Hotjava browser includes a fairly strict HTML checker, which is very useful for debugging pages as you write them.

Post Road Mailer (free edition)

Innoval Software have produced a fully-functional free version of their Post Road Mailer for OS/2, in order to encourage people to try the forthcoming Java version. It's very easy to install and use, although you need to obtain a licence number from Innoval in order to enable indefinite use - see http://www.innoval.com/free for details.

Pine

Pine is the text-mode mailer which is used in the CamNet BBS interface, so if you're familiar with that you may also want to use it under OS/2. The OS/2 version is available directly from the port author, David Nugent, or from the usual OS/2 ftp sites such as Leo or Hobbes.

Lotus Notes Mail (Warp 4 only)

Warp 4 comes with a CD containing the client software for Lotus Notes Mail; I haven't tried this myself, but if you want to use it to access Internet mail from CamNet via POP and SMTP you will need to download Loren Bandiera's instructions and configuration files.

WebWriter/2

The best HTML authoring tool available for OS/2 is John Blumel's freeware WebWriter/2; it uses your existing browser to display pages rather than providing WYSIWYG editing, but it is very flexible and easy to use so long as you know a little HTML.

Alternative applications - commercial

There are quite a few good commercial Internet applications available for OS/2, including replacements for the Dialler and all the other IAK programs; most of them are available on the Web as shareware or in slightly crippled demo versions. The best source for OS/2 shareware is probably BMT Micro Inc. who have a detailed online catalogue, and accept credit card payments via fax, phone, or email.

Other mailers

There are several commercial OS/2 mail applications, all of which are bound to be a lot better than Ultimail. In particular, you might try SouthSide Software's PMMail, Nick Knight's MR/2 ICE, or Innoval's Post Road Mailer (of which a free version is also available).

Other browsers

A few alternative OS/2 web browsers are available, mostly using the WebExplorer DLL (which means they're small to download, and don't take up much extra disk space) and adding one or two cosmetic features which WebExplorer itself lacks - such as better bookmarks functionality, or the ability to follow links while a page is still loading, eg JMA Software Technologies' Web Navigator.

Kim Rasmussen's Internet Adventurer is a web browser with an integrated suite of applications which also supports FTP, IRC, telnet, mail, and news.

Office Suites

Most suites of 'office' applications now provide integrated support for Internet applications such as email, news, web browsing and HTML authoring. The choice for OS/2 users is between Stardivision's Staroffice package and Lotus Smartsuite.

Hints, advanced topics, and toys

Using LINKUP.EXE to start the Dialler when required

Several program objects in the default IAK installation will prompt you to start the Dialler if it is not already running when you start them; you can play the same trick with any TCP/IP application, by creating a program object with the program name LINKUP.EXE and the required application (and any further arguments it requires) named in the 'Parameters' field of the program object settings.

Using parameters to begin dialling automatically

If you want the dialler to begin dialling straight away when you start it up (instead of requiring you to click on the 'Dial' button), simply supply the name of the required Dialler entry as a parameter. This feature is especially useful if you use more than one dial-up account, since you can create a special program object for each one, with the appropriate account name in the 'Parameters' field of the object settings.

Leaving passwords blank for security

It is quite possible to leave all the password fields in the Dialler notebook, FTP-PM, and any other applications which require them blank, in which case you will be prompted for a password as required when you start each application. You might prefer to do this if you want to prevent anyone with access to your computer from using your CamNet account without your permission.

Using a work-area folder

Every OS/2 folder has a checkbox called 'Work area' on the 'File' page of its settings notebook. When this checkbox is ticked, the folder becomes a work-area folder, designed to help you manage a set of objects which all relate to a particular task.

When you close a work-area folder, all windows belonging to the objects within the folder are closed automatically and the view of each object is saved. When you open the folder the next time, the windows for the objects in the folder are displayed with their previous view. Thus a work-area folder behaves like a kind of meta-application, which you can use to start several programs at once, and when you have finished with them, close them all down at once. While the folder is open, you can of course start and stop the enclosed applications as normal. Oddly enough, exactly the same mechanism is used in the OS/2 Desktop itself (the only difference being that the Desktop is a folder which you cannot close except by shutting down the system).

This facility is extremely useful if you usually run several TCP/IP applications at once when you connect to CamNet; simply create a new folder on the Desktop, make it into a work-area folder, and fill it with shadows of the Dialler and other applications you want to use while connected (in some cases you may prefer to create new program objects rather than shadows, for example if you want to supply specific parameters when dialling CamNet but not in general).

A further benefit of using a work-area folder for the applications you use with CamNet is that you will no longer need to go digging in the clutter of folders in which the applications were originally installed in order to find them!

Using URL objects and folders (Warp 4 only)

URL objects and folders are a neat addition to OS/2 in version 4. You can use them instead of Netscape Bookmarks or the WebExplorer Quicklist to store and categorise the URLs of pages or local HTML files you want to refer to - with the advantage that they're browser-independent, but each one can be customised to record which browser you prefer to view it with, and various other settings which are usually controlled once and for all for each browser but which you might want to change for a particular page (such as whether you want images loaded, which working directory to use, and so on). URL objects can also be used to associate pages containing Java applets with the applet viewer rather than with a web browser.

You can use drag and drop from a browser window to create a URL object, and conversely can load the page back into a running browser by dropping the URL object on it. You can also create a VoiceType macro for each URL object so that you can jump to it quickly (see below).

Showing off - VoiceType web navigation! (Warp 4 only)

Warp 4 has IBM's VoiceType dictation and navigation system built into it; you need a reasonably powerful machine (the absolute minimum recommended for navigation alone is a 75MHz Pentium with 16Mb, although I've seen it working quite adequately on a 66MHz 486), and the dictation software takes a bit of training before it is really usable - but voice navigation works incredibly well straight out of the box. You can use it to control any Desktop object: opening folders, starting and closing programs, selecting menu items, and so on; and you can create your own voice macros to jump directly to particular objects.

Where VoiceType navigation really pays off is in controlling Netscape or the WebExplorer: you can jump straight to your favourite pages, follow arbitrary links, scroll around, and do anything you can do with the pull-down menus, all without touching the mouse or the keyboard! Of course, you almost certainly won't want to use it all the time, but there are some kinds of browsing for which it really is the best option. And it's nice to be able to show off by saying things like

    
        "Jump to camnet"
        "Jump to os2faq"
to dial in, start a browser, and load a particular page.

Web Browser Intelligence

WBI (or "Webby") is a personal web browsing agent which remembers all the pages you have visited in any browser, enabling you to navigate and search through everything you've seen. It prompts you with shortcuts to pages you visit frequently, watches your favourite pages for changes, and highlights links with colour indicating whether they are fast or slow.

WBI is a cute toy with a few rough edges, but it is very useful if you habitually switch between two or more browsers, if you find yourself bookmarking hundreds of pages and find the list difficult to manage, or if you often forget to bookmark a page you will want to see again. It is available free from IBM's alphaWorks web site (set up to give away new Internet technology early in the development cycle to get some feedback before IBM Marketing get their hands on it - they're also doing some interesting things with Java).

Miscellaneous

Various other utilities, such as Internet Relay Chat clients, HTML authoring tools, web mirroring programs and offline news readers can be found on Hobbes.

References

This section contains URLs for all the software mentioned above, plus a few more which may be useful.

All these sites should be supported by the CamNet web proxy, so if you cannot reach any of them from within the CamNet firewall, please report the problem to Editor@cam.net.uk.

IBM
FTP sites
Miscellaneous
Other sources of information

CamNet support

Further information on using CamNet's facilities, and administrative details such as how to set your mail and web aliases, can be found on the How to use CamNet page.

See the CamNet Support page for details of all the different ways to get help if you are having difficulties connecting to CamNet and using the facilities. General support via email is available from support@cam.net.uk, while for discussion of OS/2 specific problems there is a dedicated newsgroup cam.net.support.os2.

---------

All trademarks acknowledged. Many thanks to those here plagiarised (and credited where possible).
The right of Patrick Campbell-Preston to identify himself as the author of these opinions has been asserted.