------------------------------------------------------------------------

                            User's Manual

           SCSI MO Device Driver and Formatter for OS/2 Warp


                           February 12, 1999

     All Rights Reserved, Copyright (C) FUJITSU LIMITED 1996-1999

------------------------------------------------------------------------

Notes:
 
(1) This product is protected by copyright law.
(2) Transferring part or all of this manual without our permission is 
    prohibited. The transfer includes electronic copy and distribution 
    of publications.
(3) Software contained in the package cannot be copied or modified 
    without our permission.
(4) Disassembling the software contained in the package is prohibited.
(5) The contents of this manual are subject to change for improvement 
    without prior notice.
(6) The specifications of the software contained in the package are 
    subject to change for upgrading without prior notice.
(7) Trademarks
    - FMR is a trademark of Fujitsu limited.
    - IBM, OS/2 and PC/AT are trademarks of International Business 
      Machines Corporation in the United States.
    - Microsoft and MS are trademarks of Microsoft Corporation, 
      United States.
    - Windows, Windows 95, Windows NT and MS-DOS are trademarks of 
      Microsoft Corporation, United States.
    - Other company names and product names are registered trademarks 
      or trademarks of their respective companies. 


==========
 CONTENTS
==========

1. INTRODUCTION

2. INSTALLING DEVICE DRIVER PACKAGE
  2.1 Operating Environment and Requirements 
  2.2 MO Disk Types Supported
  2.3 Installing with the OS/2 System Installer (DDINSTAL)
  2.4 Installing the package Manually
  2.5 Setting hardware

3. MO DEVICE DRIVER
  3.1 Overview
  3.2 Option Parameters
  3.3 Startup notification
  3.4 Supported Logical Formats
  3.5 Software Configuration
  3.6 Notes on Use

4. MO DISK FORMATTER
  4.1 Overview
  4.2 How to start MO Disk Formatter 
  4.3 Flow of the operation
  4.4 Selecting MO drive
  4.5 Volume label
  4.6 End of formatting


================
1. INTRODUCTION
================
Thank you very much for purchasing the SCSI MO Device Driver Package.
This package includes the 

    - MODISK.SYS    (MO Device Driver)
    - MOFORMAT.EXE  (MO Disk Formatter)

This driver enables access to magneto-optical (MO) disk drives 
connected to the IBM PC compatible PC under OS/2.
This package supports both 512 bytes and 2048 bytes per sectored 
MO disks. 


====================================
2. Installing device driver package
====================================

2.1 Operating Environment and Requirements 
-------------------------------------------
Hardware requirements;
 - IBM PC or compatible PC which is compatible with OS/2 Warp.
 - SCSI host adapter card
 - Fujitsu MO disk drive connected via a SCSI interface

Software requirements;
 - OS: OS/2 Warp version 3.0 or later                       *1
 - SCSI adapter driver supplied with OS/2 (*.ADD file)      *2

    *1 If you use the older version of OS/2 Warp 3.0, you might have 
       some errors. For example, CHKDSK may return error. So we 
       recommend  you to apply CSDs which you can get from IBM.

    *2 Most major SCSI adapter drivers are included in the OS/2 
       package or accompanied with the SCSI adapter card.


2.2 MO Disk Types Supported 
----------------------------
This package supports

 - 3.5 inch MO disk
 - 2048 byte/sector disks (1.3GB and 640MB capacities) and 
   512 byte/sector disks (540, 230 and 128MB capacities)


2.3 Installing with the OS/2 System Installer (DDINSTAL) 
----------------------------------------------------------
Here we assume the following drive configuration.

 - A: drive contains the device driver disk.
 - C: drive contains the OS/2 system and is the boot drive.

To install this package, proceed as follows;

  (1) Start DDINSTAL.EXE 

      Mouse operation installation; 
      - Double click on the icon of "OS/2 System" to show "OS/2 System - 
        Icon View" window.
      - Double click on the icon of "Device Driver Install" to show 
        "OS/2 Device Driver Installation" window. (as below)

      Command line operation installation;
      -  In the "OS/2 window", type "DDINSTAL" then return.

    +---+----------------------------------------------------------+
    |   | OS/2 Device Driver Installation                          |
    +---+----------------------------------------------------------+
    |   +---- Source directory ---------------------------+        |
    |   | +-------------------------------------------+   |        |
    |   | | A:\                                       |   |        |
    |   | +-------------------------------------------+   |        |
    |   |                                                 |        |
    |   | +-------------+                                 |        |
    |   | | Change ...  |                                 |        |
    |   | +-------------+                                 |        |
    |   +-------------------------------------------------+        |
    |                                                              |
    |   +---- Destination directory ----------------------+        |
    |   | +-------------------------------------------+   |        |
    |   | | C:\                                       |   |        |
    |   | +-------------------------------------------+   |        |
    |   |                                                 |        |
    |   | +-------------+                                 |        |
    |   | | Change ...  |                                 |        |
    |   | +-------------+                                 |        |
    |   +-------------------------------------------------+        |
    |   +===========+     +--------+      +---------+              |
    |   |  Install  |     |  Exit  |      |  Help   |              |
    |   +===========+     +--------+      +---------+              |
    +--------------------------------------------------------------+

  (2) Check the Source and Destination directory, then click on "Install" 
      to select the device driver program. Then "Select Device driver to 
      be installed" dialog will appear (shown below).

    +---+-------------------------------------------------------------+
    | V | Select Device drivers to be installed                       |
    +---+-------------------------------------------------------------+
    |   +------------------------------------------------------+---+  |
    |   | 3.5" SCSI MO Disk Device Driver ver X.XX             |   |  |
    |   +------------------------------------------------------+---+  |
    |   |                                                      |   |  |
    |   |                                                      |   |  |
    |   |                                                      |   |  |
    |   |                                                      |   |  |
    |   |                                                      |   |  |
    |   |                                                      +---+  |
    |   |                                                      |   |  |
    |   +---+----------------------------------------------+---+---+  |
    |   | < |                                              | > |      |
    |   +---+----------------------------------------------+---+      |
    |   +=========+     +----------+     +---------+                  |
    |   |   O K   |     |  Cancel  |     |  Help   |                  |
    |   +=========+     +----------+     +---------+                  |
    +-----------------------------------------------------------------+

  (3) In the window of "Select Device drivers to be installed", select
      "SCSI MO Disk Device Driver for OS/2 v3.0 US". Then click on "OK" 
      to start installation of the MO Device Driver and Formatter onto 
      the C:\OS2 directory as designated.

      When the installation is finished, "OS/2 Device Driver 
      Installation" window will appear again. Click on "End" to quit 
      the program.

  (4) Reboot the OS/2 to make the installation effective.


2.4 Installing the package Manually 
------------------------------------
To install the package manually, follow the instruction below.

  (1) Copy both device driver and formatter onto system directory.
      For example, in the OS/2 window, type as follows.
        copy a:modisk.sys   c:\os2
        copy a:moformat.exe c:\os2

  (2) Register device driver and ASPI manager in the "config.sys" file.
      The ASPI manager is included in the OS/2 system.
      For example, using your editor, add the following two lines in
      "config.sys".
        BASEDEV=OS2ASPI.DMD
        DEVICE=C:\OS2\MODISK.SYS 


2.5 Setting hardware 
---------------------
You may have to setup the SCSI adapter card or the MO drive again. 
Please consult each manual to setup them.

  (a) SCSI adapter card (Enable DISCONNECT command) 
      Some SCSI adapter card can disable DISCONNECT command. Disabling 
      DISCONNECT will greatly slow down the performance and you cannot 
      get OS/2 benefit. So, please make sure that DISCONNECT command is 
      enabled.

      (Disable 'mount removable disk as fixed disk' function)
      Some SCSI adapter card can mount removable disk drive as fixed 
      disk drive. This function is will not suitable for MO.

  (b) MO Disk drive (Set as MO-type, not HDD-type)
      Usually, MO drive has two drive modes - MO mode and HDD mode. And if 
      the drive is set as HDD mode, it may not be recognized by ASPI 
      manager. Please consult the MO drive manual and check that is set 
      in MO mode.
  
  (c) Review the setting of MO disk and other SCSI equipment
      Wrong configuration of SCSI equipment may cause malfunctions. 
      Please consult the manual of each piece of SCSI equipment and check 
      the following items.
      - No two SCSI equipment have same SCSI-ID.
      - SCSI cable is connected in fastens, and is not too long.
      - There are two and only two SCSI terminators. (one at each end)
        Some equipment has internal terminator that can result in 
        improper setup.


====================
3. MO DEVICE DRIVER 
====================

3.1 Overview 
-------------
The MODISK.SYS is an OS/2 device driver needed to access Magneto-Optical 
(MO) disk drives connected to IBM PC compatible computers.
This device driver automatically detects and accesses the following MO 
disk formats. So it is easy to exchange your data between different kinds 
of system using MO disk.

 - Superfloppy type disk format 
 - PC hard disk type format 

This version supports both 512 bytes and 2048 bytes per sectored MO disk.


3.2 Option Parameters 
----------------------
You may add optional parameters in the config.sys file. Optional 
parameters are not case sensitive such as /R and /r.

  (1) /Rn or /R:n (Number of reserved drives)
      'n' is a number between 1 and 10. Default is 1. A series of 
      logical drive names can be reserved for each MO drive for future 
      partitioning. If the number of valid partitions exceeds the number 
      specified /R option, and if /S option is not specified, up to 16 
      partitions are allowed.

      <Sample description> DEVICE= (path name)\MODISK.SYS /R2

      Note: This sample description assigns two logical drives on each 
      MO drives. If the MO disk inserted at boot time has 3 partitions, 
      3 logical drives are assigned.

  (2) /S (Reserved drive priority)
      No more logical drives than the number of /R option is assigned. 
      When the number of reserved drives specified with the /R option is
      fewer than the number of valid partitions on a disk, the number of
      reserved drives takes priority.  For example, if there are four
      valid partitions on the disk and the number of reserved drives is
      specified at 3, a logical drive name cannot be assigned to the
      fourth partition, and hence it cannot be accessed.

      * Relationship between the number of logical drives assigned and
        the number of partitions

      -----------------------------------------------------------------
      Option Parameter                     /Rn /S            /Rn
      =================================================================
      Number of valid partitions > n          n        Number of valid
                                                        partitions
      -----------------------------------------------------------------
      Number of valid partitions < or = n     n               n
      -----------------------------------------------------------------

      <Sample description> DEVICE= (path name)\MODISK.SYS /S

  (3) /I {h:} m {[n]} {+-{h:} m {[n]}}+-... (Specify the drive ID)
      This parameter specifies the target MO drive by the host adapter 
      number and SCSI-ID number. If this option is not used, all 
      accessible MO drives are used by default. 
      h is the host adapter number (between 0 and 9). The default is 0.
      m is the SCSI-ID number (0 to 7). 
      n is the number of reserved drives. When 'n' is omitted, the value
      specified with the /R option is used.

      <Sample description> DEVICE= (path name)\MODISK.SYS /I0:1[2]+1:0[1] 

      Note: This sample description try to use two MO drives
             - SCSI_ID 1 MO drive connected to host adapter 0 
             - SCSI_ID 0 MO drive connected to host adapter 1
               Two logical drive letters will be assigned for the first 
               MO drive, and one for the latter drive.

      Note: The host adapter number is 0(zero) if you have only one SCSI
              host adapter card.


3.3 Startup notification 
-------------------------
MODISK.SYS displays the following message at startup;

  1) MODISK.SYS OS/2 MO Driver Version X.X Copyright (C) FUJITSU LTD 199X-XX
  2) ### Mounted Adapter=0 SCSI-ID=3 VendorID=FUJITSU ProductID=XXXXXXXXXXXXXXX
  3) ### MediaFormat=Super FPD Partition=00 FirstDrive=F
  4) ### Drive=F Ready Start=0x00000000

Explanation
  1) Driver name, version, and copyright.
  2) The adapter number, the SCSI ID number of the drive and the vendor
     identification.
  3) The format of the current MO disk is displayed as MediaFormat=.
     - UncertainMedia   = Unknown format or no MO disk in drive
     - Super FPD Format = Superfloppy disk format
     - AT DISK Format   = PC hard disk format
  4) Status display for each logical drive
     - Ready Start=0x00000000= Accessible and start positions
     - Not Ready

  * Device related error messages

   No.  Error Message                    Meanings
  ---------------------------------------------------------------------
    1.  MO: Cannot attach to SCSIMGR$    OS2ASPI.DMD is not loaded 
    2.  MO: Cannot Open to SCSIMGR$      OS2ASPI.DMD cannot be opened
    3.  MO: No mounted                   MO drive not available
    4.  MO: Invalid Option 'X'           Illegal option specified
  ---------------------------------------------------------------------


3.4 Supported Logical Formats 
------------------------------
The MODISK.SYS driver automatically detects the following two disk 
formats, and assigns logical drive names such as D:, E:, etc.;

 - Superfloppy disk format
   Typical MO format used in PS-DOS or Windows.  Only one logical drive
   is assigned onto the one entire disk. This format is often referred 
   to as "IBM format."

 - PC/AT hard disk format
   Partition format used for PC/AT hard disks which is supported by 
   FDISK command. This format is commonly used under Windows NT, or
   when MO drive is set as HDD compatible mode.  

Note: MO disk formatted or partitioned using other format is 
      considered as empty disk.

      VFAT (virtual file allocation table) long file name uses different 
      method than OS/2. So if you use long file name, be careful because 
      Windows 95 (or Windows NT) and OS/2 are not compatible in the way 
      they manage file names. 


3.5 Software configuration 
---------------------------
The MODISK.SYS device driver operates under OS/2 version 2.1 or later,
and accesses the MO drive via the SCSI manager (OS2ASPI.DMD).  
The following software programs must be present;

    +----------------------------------------------------------------+
    |                   OS/2 KERNEL                                  |
    +-------------+-------------------------------------+------------+
                  |                                     |
    +-------------+------------+         +--------------+------------+
    |     HPFS file system     |         |    FAT file system        |
    |         HPFS.IFS         |         |                           |
    +-------------+------------+         +--+-----------+------------+
                  |                         |           |
                  |             +-----------+           |
                  |             |                       |
    +-------------+-------------+-+         +===========+==============+
    |General Purpose Disk Manager |         |       MO Disk Driver     |
    |        OS2DASD.DMD          |         |         MODISK.SYS       |
    +-------------+---------------+         +===========+==============+
                  |                                     |
                  |                      +--------------+--------------+
                  |                      |        SCSI Manager         |
                  |                      |         OS2ASPI.DMD         |
                  |                      +--------------+--------------+
                  |                                     |
    +-------------+-------------+         +-------------+--------------+
    |   Disk Control Adapter    |         |       SCSI Adapter         |
    |        XXXXXX.ADD         |         |        XXXXX.ADD           |
    +---------------------------+         +----------------------------+

Notes;
  1. OS2ASPI.DMD is required as the SCSI manager. Because OS2SCSI.DMD 
     may also work as SCSI manager, some allocation may be required. 

  2. Because MO disk is removable media, OS/2 does not support HPFS 
     file system for MO.


3.6 Notes on Use 
-----------------
  (1) MODISK.SYS has the device name 'MO-DISK$', so this name will not 
      be allowed as file name.

  (2) DISKCOPY command supports non-partitioned disks only. So only the 
      superfloppy formatted MO disks can be used with DISKCOPY command.

  (3) If, when using /R option, more than the actual number of the 
      partitions have been specified as reserved drives, some logical 
      drive may not relate to the physical partition. If you access such 
      a logical drive, you will get a "drive not ready" message.

  (4) The very early version of OS/2 Warp 3.0 (3.00) may cause problems.
      For example, CHKDSK command may return error even for the normal 
      MO disk. We recommend you apply the CSD (or FIXPACK) which you 
      can get from IBM.

  (5) Some SCSI adapters can disable the DISCONNECT command. But do not 
      disable DISCONNECT command or you'll get poor performance and you 
      might have trouble if you try to access the SCSI disk from more 
      than 2 programs at once.

  (6) If you use long file names and exchange data between Windows95 
      (or NT) and OS/2, be careful because these operating systems use 
      different way to manage long file names. Refer to the manual of 
      OS/2 for detail. 


=====================
4. MO DISK FORMATTER 
=====================

4.1 Overview 
-------------
The MOFORMAT utility is designed to initialize MO disks using the 
Fujitsu MO drive and MODISK.SYS. Both low level and high level format 
is possible.
Low level format may be referred to as 'physical format' or 'long format'.
The MO disk is normally low level formatted at the factory.
Logical format may be refereed to 'hi-level format'. So that OS/2 
correctly recognize the disk, logical format is required.

    'Low level format', which is the physical formatting of the disk 
    surface, creates sectors on the disk. MOFORMAT enables you to do 
    a low level format on an MO disk. Before you can use a MO disk, 
    it must have been low level formatted.  However, low level 
    re-formatting is normally only required if the disk generates many 
    errors during use. This is because nearly all MO disks currently on 
    the market have already been Low level formatted before you buy them.

This MOFORMAT utility supported the following logical formats.

 - Superfloppy format
 - PC hard disk format

This version of MOFORMAT supports both 512 and 2048 bytes per sectored 
disk.


4.2 How to start MO Disk Formatter 
-----------------------------------
There are two ways to start MOFORMAT.

  (1) Type 'MOFORMAT' and [Enter] on the command line.
  (2) Double click on the icon of MOFORMAT.EXE in the '\OS2' folder.

Then, MOFORMAT will start and show the drive selection dialog.

If MOFORMAT does not show the drive selection dialog or displays any 
error message, quit the program and review all software and hardware  
configurations.


4.3 Flow of the operation 
--------------------------
The following chart shows the MOFORMAT functions and dialogs.

                Start
          quit
            |    |
        (up)|    |(down)
      +------------------------+
      |Start up dialog        |
      |  Select a Drive Unit  |
      |  Select a Format type |
      +------------------------+
            |    |
      +------------------------+ 
      |  Specify the detail    |
      |    of Format           |
      +------------------------+
            |    |
      +----------------------+
      |  Confirm dialog      |
      +----------------------+
                 |
      +----------------------+
      |  Formatting dialog   |
      +----------------------+
                 |
      +----------------------+
      | Format is end dialog | * Click on [OK] when the formatting is 
      +----------------------+   finished then the disk will be ejected.
                 |
      return to Startup dialog


4.4 Selecting MO drive 
-----------------------
On this dialog, select the MO drive that you want to format and select 
the type of logical format which you are going to create.
To select one item, use mouse click or short cut key (ALT + one key).

  +------------------------------------------------------------------+
  | V| Magneto-optical Disk Formatter                                |
  +------------------------------------------------------------------+
  |About..                                                           |
  +------------------------------------------------------------------+
  | +--Select a Drive Unit-------------------------------------+     |
  | | +-------------------------------------------------+----+ |     |
  | | | HA#0 - SCSI ID 4 : FUJITSU MCD3130SS            |  | |     |
  | | |                                                 +----+ |     |
  | | |                                                 |    | |     |
  | | |                                                 +----+ |     |
  | | |                                                 |  | |     |
  | | +-------------------------------------------------+----+ |     |
  | |   Drive Info : E:                                        |     |
  | |  Format Type : Floppy type                               |     |
  | |                  121 MB                                  |     |
  | |                  512 bytes/Sector                        |     |
  | +----------------------------------------------------------+     |
  |                                                                  |
  |  +--Select a Format Type-------------------+    +---------+      |
  |  |                                         |    |  START  |      |
  |  |  mFloppy type               n         |    +---------+      |
  |  |                                         |                     |
  |  |     [ ]  Low level Format               |    +---------+      |
  |  |                                         |    |   END   |      |
  |  +-----------------------------------------+    +---------+      |
  |                                                                  |
  +------------------------------------------------------------------+

  (1) Select a Drive Unit (Drive Info:)
      Here is a list of the MO Drivers that are currently managed by 
      MODISK.SYS. Select one of these drives which will be used to 
      format your disk. If there is a MO disk inserted in the selected 
      MO drive, the current logical format of the disk is shown at the 
      lower part of this area.

  (2) Select a Format Type
      The logical format type that will be created on the disk is 
      displayed here. If this format type is differ form what you want 
      open the list box, then select format type. You may select 
      Superfloppy type, PC Hard disk type.

      [ ] Low level Format
      To do Low-level Format, click mouse button to mark this check box 
      or move cursor to the box and press space key.

  (3) START
      Click here to continue formatting. Then MO disk is locked and the 
      eject button on the drive will not function until you finish the 
      formatting or you quit the program. After click the START button, 
      The volume label window will appear (5.4).

  (4) END
      Click here to quit the program.

  (5) Error messages 
      You might encounter the following error message.

      - MO Drive is not ready.
      - Device is already in use.

      In these occurs, please check the MO drive status or insert the 
      MO disk into the drive and wait until the green LED is off.


4.5 Volume label 
-----------------
Here, you can specify volume label. Partition name is used as the label 
of a partition. Depending on the type of format, there are two kind of 
dialogs;

    +-------------------------------------------------+
    |     Input Volume label                          | 
    +-------------------------------------------------+
    |                                                 | 
    |        Volume label [                      ]    | 
    |                                                 | 
    |   +---------+   +---------+                     | 
    |   | FORMAT  |   |  CANCEL |                     | 
    |   +---------+   +---------+                     | 
    +-------------------------------------------------+

Click on [FORMAT] to start format. Then next dialog will appear.

    +---------------------------------------------------+
    |                                                   | 
    +---------------------------------------------------+
    |   +---------+                                     | 
    |   | CAUTION | All existing data on disk will      | 
    |   +---------+ be lost.                            | 
    |               Continue ?                          | 
    |   +------+  +------+                              | 
    |   |  Yes |  |  No  |                              | 
    |   +------+  +------+                              | 
    +---------------------------------------------------+

Click on [Yes] to confirm then formatting will start.

If you have checked [ ] Low level format on the startup dialog, it will 
take about 10 to 20 minutes to do the Low level format. The actual time 
depends on the condition of the MO disk.


4.6 End of formatting 
----------------------
When formatting has been finished, following dialog will appear.

    +------------------------------------------+
    |                                          | 
    +------------------------------------------+
    |     Format was successful                | 
    |   +--------+                             | 
    |   |   OK   |                             | 
    |   +--------+                             |
    +------------------------------------------+

Click on [OK]. Then MO disk will be ejected and the Startup dialog 
will be displayed again.

Click on [END] in the Startup dialog to quit the program.

