1. Opos-Mtd.exe Driver
2. ReadMe.TXT File Contents

ReadMe.TXT Driver File Contents (Opos-Mtd.exe)

******* This is release 1.05 of the OMTD --
OLE for Retail POS (OPOS) Support for Mag-Tek Devices.
It contains the Control Objects for the MICR, MSR, PINPad, and Line Display
device classes, and a Service Object, as well as an installation and
configuration utility.

For more complete information on the use of the OMTD package, refer to
the Mag-Tek OMTD Programming Reference Manual (99875144).

NOTE: Installation of OMTD controls will fail when installed
from a directory with a long file name that contains a space.  

***** The following files are located in the root directory of disk 1:
  DMW32.DLL     DriverMagic Engine
  OMTDCFG.DLL   OMTD Configuration Utility
  OMTDCFG.EXE   OMTD Configuration Utility
  OMTDDFLT.DLL  Localizable Resources (English)
  OMTDINST.INF  Installation descriptor file 
  PWD__.BAT     Batch File Installation utility (DO NOT EDIT OR RUN!)
  README.TXT    This document
  SETUP.BAT     Batch File Installation script
  \MTC          Directory (MTD Class Installer)
  \OMTD         Directory (OMTD Binary files)

The \MTC directory contains the files that constitute the MTD Class Installer.
  MAGTEKCL.DLL  Class Installer
  MAGCDFLT.DLL  Resource DLL for the default locale
  MAGCDFLT.HLP  Default Help File

The \OMTD directory contains the files that constitute the OMTD Controls for
Windows 95/98 and Windows NT.
  OMTDMICR.OCX  ActiveX Control for MICR Device Class
  OMTDMSR.OCX   ActiveX Control for MSR Device Class
  OMTDPPAD.OCX  ActiveX Control for PINPad Device Class
  OMTDLDSP.OCX  ActiveX Control for Line Display Device Class
  OMTDSO.DLL    Common Service Object

***** Disk 2 contains VBRUN60.EXE in the OLE directory.


***** Installing the OMTD Controls:

Before installing the OMTD Controls, please verify the following prerequisites:
1. That OLEAUT32.DLL, in the Windows system directory (\system for Windows 95/98
   and \system32 for Windows NT), has at least the following file version:
   2.40.4268.  If OLEAUT32.DLL is missing or is an older version, run the
   VBRUN60.EXE application, which is located under \OLE directory on disk 2.
2. That the MTD or MTDNT driver is installed and has at least one device
   configured.  Verify that the driver communicates with the device.
3. That no applications are running and the MTD driver property sheets are not
   open.

      ***************************************************************
      *****  NOTE: before proceeding, ensure that the selected  *****
      *****        device will operate with the MTD driver as   *****
      *****        indicated in step 2 above.                   *****
      ***************************************************************

***** To install the OMTD Controls:
1. Insert the installation disk into drive a.
2. Click on the Start menu and select Run.
3. Type a:\setup and click Ok.
4. The setup.bat file performs the following tasks:
    * Copies all files from the installation disk to the Windows system
      directory
    * Upgrades the MTD Class Installer (if necessary)
    * Registers the OMTD Controls and Service object using regsvr32.exe
    * Configures currently installed Mag-Tek devices for OPOS support using
      omtdcfg.exe
5. A message box will be displayed describing the success/failure of the
   installation.


***** Adding and Removing Devices (Windows 95/98)
The updated MTD Class Installer automatically updates the OMTD configuration
when Mag-Tek devices are added, deleted, or modified.
To obtain a list of the current OMTD configuration:
     1. Click on the Start menu and select Run.
     2. Type omtdcfg /L and click Ok.
     3. A dialog box should be displayed showing which Mag-Tek devices are
        currently configured for OPOS.

***** Adding and Removing Devices (Windows NT)
After the OMTD Controls are installed, the configuration utility (OMTDCFG.EXE)
can be used to update/remove OPOS configuration for installed Mag-Tek devices.
It is copied to the Windows system32 directory when the OMTD controls are
installed.  OMTDCFG.EXE is a Win32 console application that has the following
usage:
          omtdcfg [/|-][option] [class flag]
The [option] parameter can be one of the following:
     * c , C  -->  Configure OPOS support for installed Mag-Tek devices 
     * d , D  -->  Remove OPOS support for configured Mag-Tek devices
     * l , L  -->  List currently configured Mag-Tek devices 
     * ?      -->  Display usage help
The [Class flag] parameter gives the option to select specific device classes to
configure, remove, or list.  It is a bit flag that can be one or more of the
following:
     * <empty>  -->  Perform operation for all device classes listed below.
     * 0x01     -->  Perform operation for MSR device class
     * 0x02     -->  Perform operation for MICR device class
     * 0x04     -->  Perform operation for PIN Pad device class
     * 0x08     -->  Perform operation for Line Display device class
The configuration utility should be run every time after Mag-Tek devices are
installed, removed, or modified in Windows NT.
The configuration utility should be run from the command line so that its output
may be seen.


***** Removing the Controls
Complete removal of the OMTD Controls requires three basic steps:
   1. Remove OMTD configuration for Mag-Tek devices.
   2. Unregister the controls.
   3. Delete the OMTD files from the windows system directory.
To uninstall the controls, perform the following tasks:
   1. Stop any applications that are using the controls.
   2. Insert the installation disk into drive a:
   3. Click on the Start menu and select Run.
   4. Type a:\setup u in the edit dialog and click Ok.
   5. The setup.bat file will perform the following tasks:
       * Remove OPOS configuration for all Mag-Tek devices using omtdcfg.exe
       * Unregister the OMTD Controls and Service object using regsvr32.exe
       * Delete all files from the installation disk to the Windows system[32]
         directory.  The DriverMagic-related files will not be removed because
         other applications may depend on them.
   6. A message box will be displayed when the uninstallation is complete.

Note: any applications that used the controls will no longer function properly.


***** Modifying OMTD Device Configuration
The OMTD Service Object accepts per-device parameterization from the registry
under the following path:
"HKLM\Software\OLEForRetail\ServiceInfo\Mag-Tek\Devices\<device friendly name>"
The following values are currently supported for each device:
   msr.enable_sentinels  -->  When set to 1, the OMTD MSR Control includes
                              start and end sentinels with the TrackXData
                              properties.  The default value is 0 (disabled).

When OMTD is installed or reconfigured, the device configuration, as described
above, is reset to the default values for each device.


***** Opening the device
The device name that should be provided on the Open method for the control is
made up of the friendly name for the device and the device class for which the
open method is being called.  It has the following format:
       <device friendly name>.<device class>
The <device class> can be one of the following: "msr", "micr", "pinp",
"ldsp".  For example, the OPOS device name for MICR+ is "micr+.micr".