Beginner's Guide to Understanding OS/2 
FixPaks

Beginner's Guide to Understanding OS/2 FixPaks


Welcome to the world of OS/2 FixPaks. You may have also heard them called ServicePaks, SupportPaks, Corrective Service Deliveries (CSDs), or APAR fixes. Whatever you call them, hopefully the information below will make them easier to understand.

TABLE OF CONTENTS:


Getting to know your system

First, there are a couple of things you need to know about the software installed on your system. Open an OS/2 window and at the command prompt enter: ver /r

You will see something like this:

     The Operating System/2 Version is 4.00
     Revision 9.023

This tells you that you are running OS/2 Warp v4 and the Internal Revision Level (sometimes referred to as Build Level or FixPak Level) is 9.023. Revision 9.023 is the OS/2 base level, without any fixpaks applied.

Here are the internal revision levels for OS/2 Warp v4, to date:

     Revision 9.023 = OS/2 Warp 4, without any FixPaks
     Revision 9.025 = OS/2 Warp 4, with FixPak 1
     Revision 9.026 = OS/2 Warp 4, with FixPak 2
     Revision 9.027 = OS/2 Warp 4, with FixPak 3
     Revision 9.028 = OS/2 Warp 4, with FixPak 4
     Revision 9.029 = OS/2 Warp 4, with FixPak 5
     Revision 9.030 = OS/2 Warp 4, with FixPak 6
     Revision 9.031 = OS/2 Warp 4, with FixPak 7
     Revision 9.032 = OS/2 Warp 4, with FixPak 8
     Revision 9.033 = OS/2 Warp 4, with FixPak 9
     Revision 9.034 = OS/2 Warp 4, with FixPak 10

Next, at the command prompt enter: syslevel
To generate a file with this information, enter: syslevel > syslevel.txt (can be any file name)

The "syslevel" command scans the system for SYSLEVEL.* files, which indicate what products are installed and what level they are at. For OS/2, SYSLEVEL.OS2 indicates what version of OS/2 is installed and may indicate the current fixpak installed, depending on what version of the Corrective Service Facility (CSF) was last used (see Notes below). Also, depending on what OS/2 fixpak has been installed, you may find SYSLEVEL.FPK (see Notes below).

In the following example, "syslevel" was run on an OS/2 Warp v4 system where Corrective Service Facility (CSF) v1.39 has been used, and SYSLEVEL.OS2 indicates that FixPak 9 has been applied (Current CSD level: XR04009).

     C:\OS2\INSTALL\SYSLEVEL.OS2
                                IBM OS/2 Base Operating System
     Version 4.00     Component ID 5639A6100
     Type 0C
     Current CSD level: XR04009
     Prior   CSD level: XR04000

Notes:

Other key components "syslevel" shows you are: LAN Server, LAN Requester, Peer, LAN Adapter and Protocol Support (MPTS), and TCP/IP.

Finally, at an OS/2 command prompt enter: inetver

You will see something like this:

     Inet Version: 4.00e
This is the internal version number for the TCP/IP stack. The TCP/IP stack may be updated from two different sources: MPTS fixes may update the stack, and TCP/IP stack APAR fixes do update the stack. Both sources of fixes update the internal stack version which is reflected by "inetver".


Understanding OS/2 FixPaks

Okay, information is power! Now you know several important items about your system software. You know what products are installed, the product versions, and the fixpak levels. From here, you can select the correct fixes for your system.

Important Note: One key point to keep in mind is that fixes are applied to each OS/2 component separately. For example, if you have OS/2 Warp v4 installed, you cannot apply one fixpak for all components. OS/2 Warp fixpaks service the base operating system only. MPTS fixpaks service the transport layer and the TCP/IP stack. LAN Server and Peer (File and Print Client) fixpaks service the network components. TCP/IP APAR fixes will service their own sub-components (i.e., Print, TelNet, Stack, FTP, DHCP, DDNS).

Most OS/2 and LAN fixpaks and TCP/IP APAR fixes are cumulative. This means that the current fixpak includes all of the fixes from ALL prior fixpaks plus new fixes. Therefore, it isn't necessary to install fixpaks in sequential order. If you have already applied FixPak 1 for OS/2 Warp v4, you can skip to FixPak 4, knowing that the fixes in FixPaks 2 and 3 will be included.


Important terms to know

Here are a few terms you need to know:


FixPak README files

Important Note: Review the README file(s) for each fixpak before installing it. The READMEs will tell you if there are any pre-requisite or co-requisite fixes required to install the fixpak. The READMEs will also tell you if this fixpak is superseded by or supersedes another fixpak. This is very important information. Taking the time to review the READMEs can save you lots of time, trouble, and headaches later on.

For OS/2 fixpaks, key README files you should review are:


Corrective Service Facility (CSF), or FixTool

The Corrective Service Facility (CSF), also called FixTool, is used to apply OS/2 and LAN fixpaks. Earlier versions of the CSF (v1.37B and earlier) used "boot" or "kicker" diskettes to start the CSF and apply service to the OS/2 base. Beginning with CSF v1.38B, boot or kicker diskettes are no longer used. The CSF files can still be copied to a diskette, or they can be copied to your hard drive and run from there.

OS/2 fixpaks do not include the Corrective Service Facility. If you have Internet access, you can get the CSF from ftp://service.boulder.ibm.com/ps/products/os2/fixtool. Be sure to get the latest version available (currently, for English U.S., the latest version is 1.40).

LAN fixpaks do include the CSF with the fixpak. In some LAN fixpaks, the CSF file is named CSFTOOL1.DSK. In other LAN fixpaks, the CSF file name indicates the version of the CSF being used, e.g., CS_139.DSK for CSF v1.39. (None of these diskettes are bootable.) And in still other LAN fixpaks, the CSF is included in the fixpak's .ZIP file. Follow the fixpak installation instructions to use the CSF to install the fixpak.

The CSF includes a README.INF file that provides general information on applying fixpaks and also on how to remove a fixpak if you have problems with your system after installing one. To view this file, use the OS/2 VIEW command (e.g., in the directory where the README.INF file is located, enter: view readme.inf).


Downloading FixPak diskette images using your browser

Fixpaks frequently have diskette image files with extensions like .1dk, .2dk, or .dk1, .dk2, etc. Your browser may not know how to handle these file extensions. If you click on one of these files and the file displays as unreadable characters, you can do one of the following to download it:

In the Save As window, select the drive and directory where you want to save the file.


How to create FixPak installation diskettes using LOADDSKF

To create fixpak installation diskettes, you will need the LOADDSKF.EXE tool. If you have Internet access, you can download LOADDSKF from ftp://ftp.software.ibm.com/ps/tools/loaddskf.

To create the diskettes, insert a blank diskette and enter: loaddskf <\path\filename.dsk> A: /F, where A: is your diskette drive, and /F is the 'format diskette' parameter. Repeat for each diskette image file.

LOADDSKF can be run under OS/2 or DOS. For a complete list of parameters, run loaddskf without any parameters.


Where do I go to find the latest FixPaks? And what FixPaks do I get?

If you have Internet access, there are several places where you can find the latest fixpaks:


OS/2 and the Year 2000

IBM has a Web site to help you determine if your version of OS/2 and its components are ready for the Year 2000 date transition, or if you need to apply fixpaks to make them ready. If you have Internet access, you can visit this Web site at http://www.ibm.com/software/os/warp/solutions/and/y2000/year2000.html.


This document was updated March 5, 1999.