
                        The Weapons Control Commander
                 Thrustmaster WCS Remap TSR and Setup Program
                                  Version 1.0

                             Detailed Instructions
                                    12/3/93


General Description:
   This Disk contains a TSR and some associated setup files that
allow the user to remap keys on the Thrustmaster WCS to most any other
keys on a standard AT-style 101-button keyboard. The program is written
to be used with the Thrustmaster WCS I, WCS I with UPROM upgrade, the 
WCS II and FCS/PFCS, and flight-simulator games, but the program can also 
be used to remap other keys on the keyboard for other programs even if you
are not using the WCS or FCS/PFCS at the time.  This program is Copyrighted,
however, so you cannot distribute it or post it on BBS' or online services.

   You can post any .RMP or .BAT files you create with the WCC.EXE file on
any BBS or online service or share .RMP and .BAT files with friends, but
you CANNOT copy or distribute, in any way, the actual WCC program files, 
WCC.EXE, TBL_FLL.EXE, CH_FILE.DAT, KBDRMP.COM and KBDPEF3.COM. These files
are Copyrighted by ThrustMaster, Inc. and cannot be distributed or sold by 
you, or in any way duplicated or shared with others. You CANNOT post these
files on BBS' or online services either.

   In general, you must remember to use a key that actually performs a
function in the program you are remapping the keys for.  You may have a
keypress perform a null operation by assigning a key that is not supported
by the program you are remapping for if you wish.  For example, in Falcon 3.0 
and OFT, the numeric keypad key "5" does nothing in the simulation Falcon.  
In the MiG-29 Add-on program to Falcon, it does perform a function.
If you find yourself in need of assigning a key to a button that does nothing 
in Falcon 3.0, you can use the numeric keypad "5" key, if you are using
MiG-29 then you should only use the keypad "5" key if you intend to perform
a function with it in MiG-29.

   If you attempt to assign a button a key that is not recognized in Falcon 
3.0 you may get unpredictable results.  For example, Falcon 3.0 substitutes 
its own keyboard handler - it does not use the DOS keyboard handler, 
therefore, if you attempted to assign a "$" (a shifted 4 at the top of the 
keyboard), Falcon 3.0 will interpret that as a 4 just as if you had never 
pressed the shift key at all.

   Also, NOTE THAT IN SOME SIMULATIONS, YOU MAY HAVE TO COPY THE WCC FILES 
TO THE SIMULATION SUBDIRECTORY SINCE THE PROGRAM MAY IGNORE THE DOW PATH 
COMMAND.  

You may find this necessary with several sims.  To determine which files to 
copy, simply refer to the batch file you create to load the remap and the 
simulation with.  The files will be included in that batch file.  In general 
it will be the .RMP files and any other files that must be utilized in the 
operation of the Remap program itself.  Typically, as a minimum you would
have to copy the following files to the flight simulator or other program's
subdirectory:

   KBDRMP.COM (or for Falcon 3.0 and the Pilot's Edge - KBDPEF3.COM) 
   TBL_FLL.EXE
   CH_FILE.DAT
   {filname.RMP} file you created with WCC.EXE.

Main Features:

   - Allows you to program up to five different remap modes ... i.e.
     five different remap tables that can be selected and/or toggled
     between. This feature can be used, for example, in F15 Strike Eagle
     III to set up different WCS key definitions for the air-air, nav,
     and air-gnd modes.

   - Allows you to also specify key remaps that will toggle between two
     different keys each time a key is pressed. For example, you could remap
     the f (flare) key to f,c (flare/chaff), so that each press of the
     remaped f key would alternate between an f and a c key (flare and chaff
     functions). This would free-up the c (chaff) key on the WCS for another
     function.

   - Easily generates batch files to run the remap TSR and a game program
     based on your inputs.


How it Works:

   The main setup program, WCC.EXE:

    - Creates remap configuration files (.RMP files), based on inputs from
      you, which tell the remap TSR what keys to remap.

    - Creates batch files (.BAT files) that you use to call the remap TSR
      and run a game.

    - Allows you to view/edit any .RMP or .BAT files you have created before.

    - Load the example F15.RMP and F15.BAT files and view them by clicking on
      the menu options at the top to see how the remap and bat files are
      structured.  Note the example F15.RMP file does not have a mode key
      for each mode, but uses the "t" key (mode toggle key) to toggle between 
      the modes created.
      Pressing F12 (Remap on/off key) will toggle the remap on, pressing F12 
      will toggle it off and return you to the default settings on the WCS 
      you have programmed with the UPROM chip or that were on the WCS without
      the UPROM chip installed.


How to Install the Program:

   1) The program is installed for you automatically when you use the
      install program that came with your ThrustMaster Mark II WCS.

   2) The path command in your autoexec.bat file will also be updated
      for you automatically when you use the above install routine.


How to Use:

   Create remap File:

       -  Change directory to the location of the remap files and run
          the program. For Example:

           CD REMAP
           WCC

       -  Select the File | New | Remap File option to create a new remap
          file.

           * The main remap configuration screen will appear.

           * Enter the Remap File Description, Select the number of
             remap modes and the desired Startup Mode. Then enter
             the desired Mode Toggle key, and the Remap on/off key.

             Note: The Startup Mode is the remap mode that the TSR will
                   initially be in when it runs.

                   The Mode Toggle key is the key that will toggle
                   thru the remap modes when it is pressed.
                   (optional)

                   The Remap on/off key is the key that will toggle
                   all the key remapping functions on/off when it is
                   pressed.

           * When you have made all you selections, press OK.


       - Select the Remap File | Mode 1 option to setup the remap table
         for mode 1.

           * Enter a name for the mode, if desired.

           * Enter a key on the Mode Key line. This is a key that will
             immediately activate this remap mode when it is pressed.
             (optional)

           * Enter your remap table:

             In the Key From column, press the key you want to redefine,
             and then press the new definition for the key in the Key To
             column. Continue until all the key remaps are entered.

             Note: It is NOT necessary to remap keys you are not going to
                   change.  If you ever do a remap line that looks like:

                   Key From  Key To  Toggle To

                   t         t       t

                   You have just remapped a 't' key to a 't' key to toggle
                   to a 't' key.  The result will be that when you press
                   a button, a 't' will be generated.  Remapping a 't' to
                   a 't' is not necessary.

                   We have seen this many times when users send in a remap
                   table to us:

                   Key From  Key To  Toggle To
                   a         b       c
                   q         q       q
                   x         s       s
                   g         g       g
                   k         k       k
                   y         y       y

                   This is unnecessary.  The following remap table will
                   produce exactly the same results:

                   Key From  Key To  Toggle To
                   a         b       c
                   x         s       s

                   The q, g, k, and y, keypresses you did not want to change 
                   when a button is pressed on the WCS II will not change.   
                   The same keys you programmed those buttons to generate 
                   with your ADV file will still be generated even if you 
                   switch to a remap mode unless you remap them to something 
                   else.

             Note: The keys pressed in the Key To column will automatically
                   copy over to the Key Toggle column. If you want the key
                   to toggle between two different key definitions, enter
                   a different key definition in the Key Toggle column.

           * When you have entered all of the key redefinitions, press OK.

       - Repeat the above step for the rest of the modes that you selected.

       - Select the File | Save | Remap File to save your file.


   Create a .BAT file:

       -  Select the File | New | BAT File menu option. This will help
          you create a .BAT file to run a game program with the remap
          file you just created.

          * The Batch File Generator screen will appear.

          * Enter the desired name for the batch filename, and the game
            file name. Press the Select buttons next to these lines
            if you would like to see a listing of files to pick from.

          * Enter a description for the batch file. (optional) This
            description will be displayed when the bat file is run.

          * If you own The Pilot's Edge TSR for the Thrusmaster FCS, and
            want to set up the batch file to call it: Select Yes at the
            Pilot's Edge Line, and enter the name of the filename.

          * Select No at the CD to game directory line if you do not
            want the batch file to change directories to the game
            directory before running.  YES is a MUST with some simulations
            such as FALCON 3.0.

          * If you would like the batch file to pause to let you view
            the description you entered, select Yes at the Pause Line.

          * When you have entered all the required information press
            OK to create the batch file.

   Use the BAT File:

       1) Exit from the program. (ALT-X)

       2) Run the BAT file:
          For Example: FALCON

Other Functions:

   Editing previously generated remap and batch files:

       - Remap files can be loaded back into the program using the
         File | Load | Remap File option. They can then be edited and
         saved using the same procedure used when creating a new remap
         file.

       - Batch files can be loaded and view/edited using the programs
         built-in text editor by selecting the File | Load | Batch file
         option.


Program Limitations:

 * Because of some nasty details in the way the AT keyboard and the TSR
   work, there are some keys that can't be redefined by the program:

       Caps Lock
       Right ALT
       Right Cntl
       Insert
       Delete
       Left,Right,Down,Up Arrow
       Home
       End
       Page Up/Down
       /      (On the numeric keypad only)
       Enter  (On the numeric keypad only)
       Print Sreen
       Pause


   The WCC program will not recognize these keys as valid if you
   try to redefine them.

 * Because the remap TSR works with raw key-pressed scan-codes on your machine,
   it won't remap a single key press to a shift key press. This is because
   a shift key press is really two separate key presses. (For example,
   shift-N is really a shift key press (held down) AND a N key press).  You
   CAN, however often times get around this limitation by remapping a shifted
   key you have programmed in your ADV file.  For example, suppose you have
   entered in your ADV file any of the following lines:

   BTN UB SHF b
   BTN UB ALT b
   BTN UB CTL b

   you can remap the b to another key - the SHF, ALT, and CTL will be
   ignored by the remapper since you have not tried to remap them.  This
   may be one case where you would enter a 'SHF b' in an ADV file you create
   instead of a 'B'.  This would allow you to remap the 'b' to some other key.
   

 * At the present time the remap TSR does not work with ill-behaved protected-
   mode programs like Commanche Maximum Overkill. (ill-behaved = doesn't
   like to coexist with other programs)

Manually loading the REMAP TSR by creating a batch file using your favorite
   editor:
To enter the proper commands to load the REMAP TSR in a batch file you create
with your own text editor, follow the procedure below:
1. To load the REMAP TSR - Type KBDRMP.COM or C:\MARK2\REMAP\KBDRMP.COM
2. To load the remap file you created - Type TBL_FLL {filename}.RMP
   (You must have loaded KBDRMP.COM first - as in step 1.)
To unload the remap TSR simply type KBDRMP and hit enter while in the
C:\MARK2\REMAP subdirectory.

For example, let's assume you wish to load the remap TSR, a remap file you
created, a third party TSR and then run Falcon 3.0.  The following is a
sample BAT file you could create to do this.  What you would name the BAT
file is up to you.

CD\MARK2\REMAP
KBDRMP {or KBDRMP.COM} (to load the REMAP TSR program itself)
TBL_FLL FALCON.RMP (to load the FALCON.RMP file into the remap key table)
CD\FALCON3 (to change to the FALCON3 subdirectory)
F302PAD (to load Ken "Stinger" Richardson's F3.02 Padlock program
FALCON3 (to run Falcon 3.0)
F302PAD (to unload F3.20 Padlock AFTER you exit Falcon 3.02
CD\MARK2\REMAP (to change to the REMAP subdirectory)
KBDRMP (to unload the REMAP TSR)

NOTE: In the above example, the TSR program loaded FIRST is removed LAST to
ensure that your memory isn't corrupted.  The TSR loaded SECOND is removed
FIRST.  If you didn't do this, you would likely find your keyboard would be
locked up and you'd have to reboot your machine to get it working again.

More Specific Details on the Program:

- A mouse is required to use the WCC program.

- There is a maximum number of 20 possible remaps in each remap mode.

- During testing of the WCC TSR it was discovered that the freeware TSR
  F3PADLK.COM would not work while WCC was active.  Thanks to the efforts of
  Ken "Stinger" Richardson, the author of F3PADLK.COM, this problem was
  corrected.  Ken also authorized ThrustMaster to distribute the corrected
  version of F3PADLK.COM along with the software that is included with the
  UPROM chip upgrade for the ThrustMaster WCS Mark I.  We all owe Ken a big
  one for this - if you happen to be in Canada and run into him buy him one
  for me.  Buzz Hoffman, ThrustMaster, Inc. - Chief Test Pilot. 8)

- You may upload any .RMP and .BAT files you create to any BBS or any online
  service such as CompuServe or Prodigy or America Online or Genie or any of
  the others so long as you do not upload the actual program files themselves,
  and that also goes for F3PADLK.COM which is the property of Ken "Stinger"
  Richardson and you should adhere to whatever rules he proposes for
  distribution of F3PADLK.COM.
  This way, owners of the ThrustMaster WCS and the ThrustMaster WCS with the
  UPROM chip can share files they have created with one another.

- If you require assistance with this program call ThrustMaster Technical
  support at 503-639-3200 (8 AM to 5 PM PST), or contact a ThrustMaster Rep
  on Prodigy (GVRR37A), CompuServe - GO FSFORUM - 76520,3325, Genie - 
  Thrust.Dude, America On Line - Thrustmaster.

- Happy ThrustMastering and Check Six.
