        OS/2 BakupWiz

Release Notes & Manual Addendum
        Version 1.13

       June 20, 1995



Introduction
------------

Thank you for purchasing OS/2 BakupWiz to solve your OS/2 backup 
needs. We promise to stand behind this product and give you the 
best service possible.

OS/2 BakupWiz has been extensively BETA tested by a dedicated 
group of outside users. Without these testers, OS/2 BakupWiz 
would not be the robust product it has become. 

In these pages you will find installation instructions and 
addendums to the printed manual you received with OS/2 BakupWiz. 
There have been many changes, additions, and enhancements made as 
we ported the DOS version of BakupWiz to create OS/2 BakupWiz. We 
are in the process of rewriting our existing manual to encompass 
these changes but this process has been delayed.

OS/2 BakupWiz has minor (right of the decimal point) maintenance 
releases about every 60 days. Customers are able to download the 
updated code from our BBS free of charge. When available, the new 
manual may be obtained directly from PCX for a small handling and 
shipping charge.

Diskette Contents
-----------------

There are 12 files on the OS/2 BakupWiz distribution diskette. 
Below is a list of the files and a short explanation of the 
purpose of each file.

BWS5.EXE - Main executable file.
BWS5.HLP - Help text file.
BWS5.ICO - OS/2 BakupWiz icon.
BWS5.CFG - Default configuration file.
BWOS2ADD.SYS - Driver.
BWOS2ADD.MSG - Driver message text.
BWS5DLL.DLL - OS/2 BakupWiz dll.
BOOTOS2.ZIP - OS/2 boot disk maker.
PATCH.EXE - Program to apply patches.
README.TXT - Last minute notes.
CRONRF.ZIP - Scheduler.
SQLUEXIT.CMD - DB2/2 User Exit.

Installation
------------

Please ignore Chapter 2 in the manual. This procedure has been 
revised and the correct procedure is described below.
After inserting the BakupWiz diskette in your A: drive, type:

INSTALL2 install_directory A: P{=3 

The installation procedure will create the specified directory, 
if it does not exist, and then decompress and copy all the 
BakupWiz files into it. An Icon for BakupWiz will also be created 
on your desktop.

A few manual steps are still necessary before you can use OS/2 
BakupWiz effectively. BWS5DLL.DLL must be in a directory that is 
listed in the LIBPATH statement in your CONFIG.SYS. You may 
either copy BWS5DLL.DLL into a directory that is listed or edit 
your CONFIG.SYS to include your OS/2 BakupWiz directory. In the 
latter case, you must reboot in order to make the change 
effective.

If you are backing up to a SCSI tape drive, you must also add a 
statement to your config.sys and make certain that several others 
are already present.

You must add a DEVICE= statement in your config.sys to load 
BWOS2ADD.SYS. You can put

DEVICE = path\BWOS2ADD.SYS 

at the end of your config.sys; path is the fully qualified path 
to your OS/2 BakupWiz directory. Elsewhere in your CONFIG.SYS 
file, you need to verify the existence of two BASEDEV= 
statements. One will refer to the ADD driver that supports your 
SCSI card and the other refers to OS2SCSI.DMD.  A typical 
CONFIG.SYS might have:

BASEDEV=AHA154X.ADD
BASEDEV=OS2SCSI.DMD 
DEVICE=E:\BWS5\BWOS2ADD.SYS  

AHA154X.ADD is the ADD driver for the Adaptec 1540 and 1542 SCSI 
adapters. You must substitute the proper ADD driver for your SCSI 
adapter. When all this is done, please shutdown and reboot. You 
are now ready to use OS/2 BakupWiz!

Configuration
-------------

Chapter 8 in the manual describes the configuration procedures 
for OS/2 BakupWiz. There are several enhancements that you need 
to be aware of.

Prior to the OS/2 version of BakupWiz, all the configuration 
information was saved inside the BakupWiz executable file. The 
OS/2 version has introduced the concept of external configuration 
files. With that in mind, selecting the Configuration entry from 
the Main Menu now results in a pull down menu with Load, Save, 
and Configure selections. Load and Save perform the corresponding 
operations on an external configuration file. In either case, a 
small window will open up and allow you to specify the name of 
the configuration file to act on. p73 

Configure allows you to set the configurable parameters. One 
noteworthy point is that under DOS, you were able to specify the 
actual SCSI address of your tape device. This concept changes 
under OS/2. With OS/2 BakupWiz you specify the ordinal number of 
the tape drive you wish to use. If you have only one tape device 
attached, the proper entry would be 1; the second tape drive 
would be 2, etc.

OS/2 BakupWiz will automatically recognize all the tape devices 
that are listed in the About selection from the Main Menu. Should 
you have a tape device that is not listed or recognized, OS/2 
BakupWiz can still work with it. 

When you are configuring OS/2 BakupWiz and it does not recognize 
any listed tape devices, the program will determine the existence 
of ANY tape devices. It will then present you with a list of such 
devices. Highlight one entry and select it by hitting Enter. A 
larger window now opens listing all the preconfigured devices 
that OS/2 BakupWiz recognizes. If you know your drive to function 
the same as one of the listed devices, highlight that device and 
select it with Enter. Use F10 to accept the change and then 
follow the prompts to save the modified configuration file.

If you do not know that your tape drive is similar to one of the 
listed devices, there is still hope. You will have noticed 3 
entries at the head of the device list: Dumb SCSI, Generic SCSI-
1, and Generic SCSI-2. You must determine from the user manual 
for your tape drive if your tape drive is a SCSI-1 or SCSI-2 
device and set it accordingly. If you do not know the answer or 
you have a VERY old tape drive, you may have to select Dumb SCSI. 
If this seems confusing, please call PCX Technical Support to 
assist you.

In a few circumstances, you may want to override a tape drive 
that has been automatically recognized. One reason for this is a 
rash of very old, refurbished tape drives that seem to hit the 
market periodically. Some of these drives claim to be SCSI-1 or 
SCSI-2 compatible, even though they are not. In this case, simply 
press F8 while the cursor is on the SCSI address line in the 
configuration panel. OS/2 BakupWiz will then allow you to 
redefine the drive in the same manner as described above when no 
recognized drives where found. 

Command Line Switches
---------------------

OS/2 BakupWiz uses a series of command line switches to customize 
its' operation. OS/2 BakupWiz will recognize either the dash (-) 
or forward slash (/) as the switch leadin character. This section 
will describe each Switch in detail.

-A

This switch will tell OS/2 BakupWiz to append the current Backup  p73 
you are requesting to any existing FileSets on the tape. Without 
this switch, the default is to overwrite existing data.     

-Blist

This switch will initiate a command line operated Backup. The 
list consists of any valid drives, paths, or file names. Wildcard 
designations may be used. 

Example: -Bc:\ e:\bin f:\*.exe

Please note that this is a selective backup operation. Therefore, 
if you wish to backup an entire drive, C:, you should specify C:\ 
rather than just C:. C: and C:\ are equivalent only if the 
current directory on drive C: is the root.

-Cconfig-file-name

This switch allows you to specify the location and name of a 
configuration file for this run. There must be no space between 
the -C and the file name. Should you wish to not use a 
configuration file, you may enter -C- and OS/2 BakupWiz will use 
a default built-in configuration.

OS/2 BakupWiz has a search hierarchy for locating configuration 
files:

1. Use the file and path exactly as specified with the -C switch;
2. Look in the path specified in the BWDIR environment variable; and
3. Look in the directory where BWS5.EXE is located.

In cases 2 and 3, the default configuration file name, BWS5.CFG, 
will be searched.  

-D

OS/2 BakupWiz will perform a tape directory operation in response 
to this switch.

-EBnnnn

This options sets the buffer size that BakupWiz uses. The value 
is expressed in  kilobytes and may range from 150 to 6000. 1000 
is the default value.

-EC

This switch will cause OS/2 BakupWiz to delete all existing log 
and error files before creating the one for the current session.

-EK

Force BakupWiz to use enhanced keyboard character set. Use this 
switch only if your keyboards arrow keys do not all work with 
BakupWiz. p73 

-EM

This switch will force OS/2 BakupWiz to use monochrome display 
mode.

-EPnn

Set the CPU priority that BakupWiz will use. Valid range is from 
1 to 99. 50 is the default value.

-Ffilesetnum

This parameter specifies which FileSet the requested operation is 
to process. Since FIleSets are numbered starting at 1, specifying 
-F1 is equivalent to not specifying the parameter at all.

-FNfilesetname

This parameter specifies which FileSet the requested operation is 
to process. OS/2 BakupWiz will search the tape for a FileSet 
matching the filesetname specified.

-Gmm/dd/yy

This parameter specifies the date that the disk grooming function 
will use to delete files after they have been backed up. All 
files that have been successfully backed up and have a last 
modified date older than the date specified will be deleted. 
NOTE: by default, the actual deletion is not performed unless you 
set the appropriate configuration option to Y.

-Ifilename

OS/2 BakupWiz has the capability of backing up to and restoring 
from any arbitrary drive/path/file name. Using the -I switch to 
specify the filename triggers this mode of operation. The file 
may be on another hard drive, a network file server, a remote 
AS400, or any other device that is drive letter addressable.    

-L

This command will create a list of all the FileSets on the tape.

-Nname

The name you specify will become the tape descriptive Comment 
that is displayed when the FileSet is referenced during other 
operations. You must enclose name in quotation marks (") if there 
are any blanks or special characters.    

-OI

Specifying this parameter in conjunction with the -B parameter 
will cause OS/2 BakupWiz to perform an incremental backup. All  p73 
files that have been changed, as defined by the archive attribute 
being set for the files, will be backed up and the archive bits 
will then be reset.

-OL"list"

This switch applies only to the auto-changer version of BakupWiz. 
It allows you to specify the cartridge order list from the 
command line. The list is a blank delimited string containing the 
tape cartridges in the order you wish to use them.

-ON

This switch will prevent BakupWiz from including subdirectories 
in its file scan.

-OP

Specifying this parameter in conjunction with the -B parameter 
will cause OS/2 BakupWiz to perform a progressive backup. All 
files that have been changed, as defined by the archive attribute 
being set for the files, will be backed up but the archive bits 
will not be reset. This method of backing up has the advantage of 
only requiring two FileSets in order to compeletely restore your 
data.

-OR

This function simply resets the archive bits of the selected 
files.

-OT

This switch will cause BakupWiz to include subdirectories in its 
file scan.

-Rlist

This switch will initiate a command line operated Restore. The 
list consists of any valid drives, paths, or file names. Wildcard 
designations may be used. 

Example: -Rc:\ e:\bin f:\*.exe     

-Shh:mm

This will delay OS/2 BakupWiz from beginning the requested 
operation until the specified time has been reached or exceeded.

-Tspecifier

The T switch is used in conjunction with the -R and -V switches. 
It overrides the drive and path used to restore to or verify 
against. The default is to use the drive and path from which the 
files were backed up from. For instance: -Tc:\temp will cause all  p73 
the files to be restored into a directory tree beginning with 
c:\temp - the subdirectory structure from the tape is preserved 
and "appended" to c:\temp. If you specify -Tc:\temp\\, all the 
files from the tape, regardless of what subdirectories they might 
be in, will be restored into c:\temp.

-UAdnn

This switch applies only to the auto-changer version of BakupWiz. 
It allows you to position the drive/magazine to drive d and 
cartridge nn. This operation may not be applicable to all auto-
changers that BakupWiz supports.

-UE

This Utility function will erase the tape in the drive. The 
function will be performed prior to any other command line 
functions.

-UJ

This Utility function will eject the tape in the drive. The 
function will be performed after any other command line 
functions.

-UL

This switch applies only to the auto-changer version of BakupWiz. 
It allows you to load the magazine into operating position. This 
operation may not be applicable to all auto-changers that 
BakupWiz supports.

-UMnn

This switch applies only to the auto-changer version of BakupWiz. 
It allows you to mount tape number nn into the drive. This 
operation may not be applicable to all auto-changers that 
BakupWiz supports.

-UP

This switch applies only to the auto-changer version of BakupWiz. 
It allows you to park the magazine. This operation may not be 
applicable to all auto-changers that BakupWiz supports.

-UR

This Utility function will rewind the tape in the drive. The 
function will be performed prior to any other command line 
functions.

-UUnn

This switch applies only to the auto-changer version of BakupWiz. 
It allows you to remove the tape from the drive and place it into  p73 
magazine position nn. This operation may not be applicable to all 
auto-changers that BakupWiz supports.

-V

The V switch initiates a command line driven verify operation. 
When used in conjunction with the -B switch, a verify will be 
initiated after the backup is complete.

-Xlist

This switch allows you to specify directories or files to be 
excluded from the current operation. The list consists of any 
valid drives, paths, or file names. Wildcard designations may be 
used. 

Example: -XRc:\ e:\bin f:\*.exe     

Specifying File Lists
---------------------

It is often convenient and desirable to maintain a file that 
contains a list of files you want to include or exclude from an 
OS/2 BakupWiz operation. This is easy to do with OS/2 BakupWiz! 
Simply create an ASCII text file that contains a list of files 
and specify the name of this file at any point where OS/2 
BakupWiz is expecting filenames to be entered. Precede the file 
name with @ to indicate that it contains a list. In a command 
line operation, for example:

BWS5 -b@listfile

will back up all the files specified in the file listfile.

The list file contains one line per file specification. You may 
also append -T or -NT to a file specification. -T will cause all 
subdirectories bellow the specifed path to be included in the 
backup. -NT will not scan any subdirectories below the current 
one.

A New Restore Option
--------------------

A new option has been added make restoring files even more 
flexible. The Restore/Options setting 'Overwrite Existing Files' 
now has an 'Older Files' choice. Using this setting effects how 
OS/2 BakupWiz handles the situations where a file selected for 
restore already exists on the hard drive. When this setting is 
used, the disk copy will be replaced with the tape copy only if 
the disk copy is older than the copy on tape. Thus you are 
assured to have the most recent copy on the disk after the 
restore operation.

Selective Verify
---------------- 

Verify now has the capability to operate on only selected files 
rather than an entire FileSet. To accomplish this, the Verify 
selection from the Main Menu now has a pull down menu with Full, 
Selective, and Quit choices. Similarly, the Verify selection from 
the Directory Menu has a side pull menu with the same choices.

Non Tape Operations
-------------------

Normally OS/2 BakupWiz uses a SCSI tape drive as the 
backup/restore device. Another hard drive, file server, remote 
AS400, diskette, Bernoulli, etc can also be used by OS/2 
BakupWiz. To use this capability, you must enter the 
configuration panel and select the "Edit Backup/Restore Image 
File Name" option. Pressing ENTER will popup an edit window 
wherein you can enter a drive/path/filename. OS/2 BakupWiz 
willthen use the specified file instead of a tape drive for 
backup/restore operations.

This same configuration option also triggers removable drive 
support. To use this feature, enter only the drive letter 
followed by a colon (A:) of the removable media device in the 
"Edit Backup/Restore Image File Name" option described above. 
OS/2 BakupWiz will now detect when a cartridge/diskette is full 
and prompt you to insert a new one when needed. NOTE: OS/2 
BakupWiz will not format or otherwise prepare the new 
cartridge/diskette.

Running OS/2 BakupWiz
---------------------

OS/2 BakupWiz can be operated via a system of menus or from the 
command line. Executing BWS5 without any command line switches 
will use the menu operation mode. Command line operation is 
triggered by the -B, -D, -R, or -V switches.

Return Codes
------------

OS/2 BakupWiz sets the OS/2 return code depending on the results 
of operations performed:

0 = Normal completion
4 = Completion with errors
8 = Aborted (control break/window closed)
12 = Catastrophic error

Optionally, if allowed by a setting in the Configuration Panel, 
the FileSet number multiplied by 16 will be added to the return 
code. For example: if there were some errors and OS/2 BakupWiz 
had just written the third FileSet on the tape: 3 * 16 + 4 = a 
return code of 52.

Name Mangling p73 
-------------

OS/2 supports file names on an HPFS volume that are illegal on a 
FAT volume. HPFS file names may be up to 255 characters long, may 
contain multiple periods, and may contain characters that are 
invalid on FAT files systems.

This presents a problem when you back up files from HPFS volumes 
with illegal FAT file names and then restore them to a FAT 
volume.

In order to restore the files, OS/2 BakupWiz generates a new name 
for them. The generated name will consist of up to the first 8 
characters from the HPFS name that are valid FAT file name 
characters. If necessary, an extension will be appended to the 
file name to prevent conflict. The extension consists of three 
numeric digits.

The HPFS file name is saved as an extended attribute and can be 
subsequently recovered.

Boot Volume Restoration
-----------------------

OS/2 BakupWiz can restore your OS/2 boot volume without you 
having to buy any extra programs.

Since OS/2 BakupWiz is not a Presentation Manager program, it is 
quite feasible to boot from diskette and restore your boot volume 
from tape. An even better solution is to set aside a small extra 
partition on your hard drive that contains a stripped down OS/2 
boot. To this end, we have included the file BOOTOS2.ZIP on the 
distribution diskette. It is an IBM EWS product that will create 
boot diskettes or hard drive boot volumes for you.

The following are some notes and hints on using BOOTOS2 in 
addition to the documentation file contained in BOOTOS2.ZIP.

* Create a subdirectory for BOOTOS2
* Unzip BOOTOS2.ZIP into this subdirectory.
* Execute BOOTOS2:
  * Use Source = D:\OS2IMAGE, where D: is your CDROM drive     
    containing your installation CD. The default is A: otherwise 
    and you will the first 2 OS/2 install diskettes.
  * Use 2DISK=A to force a 2 diskette build for A:.
  * USE GA300 if you are runnign WARP.
  * Follow the prompts. Modules will be copied from libraries of 
    the currently running system and the SOURCE directory.
  * Edit CONFIG.SYS on boot diskette # 2 to include the following:
       BASEDEV=xxxxxxxx.ADD - your SCSI adapter driver;
       BASEDEV=OS2SCSI.DMD
       DEVICE=BWOS2ADD.SYS
  * Copy BWOS2ADD.SYS and BWOS2ADD.MSG from your BakupWiz directory on
    your running system onto OS/2 boot diskette # 2.
  * If you are using OS/2 Warp Utility diskettes, also copy \OS\2\BOOT\
    xxxxxxxx.ADD and \OS2\BOOT\OS2SCSI.DMD to diskette # 2.
* You need to make a third diskette containing all the OS/2 
  BakupWiz program files. Onto this diskette you must also copy the 
  following 5 modules from the OS2\DLL subdirectory of the running 
  system: VIOCALLS.DLL, NLS.DLL, MSG.DLL, MOUCLLS.DLL, and 
  OS2CHAR.DLL.
* Boot OS/2 from the boot diskettes. When at the A: prompt, insert the
  BakupWiz diskette and type BWS5.
* You must now change the BakupWiz configuration file to place the temp
  and log file onto the hard drive, rather than the diskette.
  * From the BakupWiz main menu, type C to get to the Configuration
    menu. Then type C again to Configure.
  * Tab to the Logfile Path entry and enter a convenient path on your
    hard drive; C:\ for instance.
  * Do the same for Tempfile path.
  * Hit F10, select Y for Save Configuration, and hit F10 to accept the
    default configuration file name.
  * Quit BakupWiz and execute it again by typing BWS5.
* BakupWiz is now ready for a stand-alone backup or restore.


There are 2 steps you must perform before restoring your boot  p73 
volume from tape. You must first format the boot volume with the 
OS/2 format program. You must then use SYSINSTX to place the OS/2 
boot loader on the volume. Then you may use OS/2 BakupWiz to 
restore the rest.

Migrating Boot Partition from FAT to HPFS
-----------------------------------------

Thanks to Niel Kempson, a member of the OS/2 BakupWiz BETA team 
for this writeup.

Some time ago I asked how I might migrate my boot partition from 
FAT to HPFS.  What I had in mind was something like:

a. backup FAT C: to tape
b. boot from an emergency floppy set
c. format C: as an HPFS drive
d. restore tape to HPFS C:

This doesn't work because the boot process recognizes that the 
drive is "supposed" to be FAT.  The only suggestions amounted to 
reinstalling the first 5 disks of OS/2 to "prepare" the HPFS 
drive for booting.

I've finally worked out how to do convert from FAT to HPFS 
quickly and easily. There's a hidden file called \OS2BOOT that 
controls the booting process and it's quite different for FAT and 
HPFS: 

FAT:    \OS2BOOT, 1099 bytes
HPFS:   \OS2BOOT, 50318 bytes  

The program SYSINSTX.COM on installation disk 0 creates the 
appropriate \OS2BOOT for the file system.

After steps a-d above, add a final step before rebooting from the 
"new" HPFS C: drive:

e. execute the command "SYSINST C:" from the emergency floppy set 
or the OS/2 "installation diskette"

If you have a reliable tape backup system (e.g. GTAK, BakupWiz), 
it's ever so easy to convert that last remaining FAT partition to 
HPFS.  (If you want to go from HPFS to FAT, the same procedure 
applies.)

Problem Areas
-------------

On some 2.1 systems, OS/2 BakupWiz might come up in monochrome 
mode incorrectly. The reason for this is that OS/2 returns some 
values for video/monitor configurations that are undocumented. 

If you run into this situation, please run OS/2 BakupWiz with a 
/1 command line switch: BWS5 /1. This will cause several lines of  p73 
diagnostic information to be written to the log file. Please call 
PCX technical support with those values so that we may correct 
the difficulty for the next release.

You can also overcome this problem by using the Configuration 
system. Select the Video Mode entry and set it to C for color or 
M for monochrome and save the configuration. -EM command line 
switch can also force monochrome mode.

Contacting PCX
--------------

We at PCX take great pride in the level of service we provide our 
customers. Please do not hesitate to call us if you should 
experience any problems, questions, or have uncertainties about 
program operation.

PCX now has its own support forum on Compuserve - OS2BVEN section 
2. Please stop by and visit us there.




PCX
542 Stevens Ave
Suite J
Solana Beach, CA 92075
USA

619-259-6300
619-481-6474 FAX
619-481-6479 BBS
Compuserve: 70216,174
Internet: support@pcx.com
FTP: cts.com, pub/pcx


