/tasm

Turbo Assembler 5: Borland.

Primary LanguageAssembly

/*************************************************************************/
                           TSM_INST.TXT
                        TURBO ASSEMBLER 5.0

This file contains details on how to install the TASM 5.0 package.

--------------------------------------------------------------------
                        TABLE OF CONTENTS

SECTION 1     System Requirements  -   Full Installation

SECTION 2     Installing TASM 5.0
              A)   Pre-Installation Notes
                   1)   Backup Disks
                   2)   Disk Compressions
                   4)   Network Installation
              B)   Where to install
              C)   Installation Instructions
              D)   After Installation

SECTION 3     Minimum and Selected Installation Options


SECTION 4     Troubleshooting - Install Issues
              A)   Data Integrity or Bad Section Errors
              B)   Disk Full or Insufficient Disk Space
                   Errors
              C)   GP Fault or Unhandled Exception Errors

SECTION 5     Troubleshooting - Run Time Problems
              A)   Out of Memory Errors
              B)   GP Fault or Unhandled Exception Errors
              C)   Turbo Debugger for Windows

SECTION 6     Icons in the TASM Group Window
              A)   Creating a Program Group Window for TASM
              B)   List of Icons and Executable Files

SECTION 7     Using TASM from Windows

SECTION 8     How to Get A Technical Information Document
              A)   From TechFax
              B)   From Bulletin Boards

SECTION 9     Boot Clean
--------------------------------------------------------------------

SEARCH INSTRUCTIONS:  To go directly to a specific
section, use your editor's search utility and search on
"SECTION -#-" replacing the # with the appropriate section
number.


SECTION -1-  SYSTEM REQUIREMENTS
================================
Before installing TASM please review the minimum
system requirements listed below:

System requirements for a generic full installation
(both 16- and 32-bit installation):
   8 MB system memory  (req. to run Win32)
   Intel 386 or higher
   DOS 5.01 or later
   Windows 3.1 or later (to access Turbo Assembler help file)
   Windows '95 or Windows NT (for targeting those environments)
   Approximately 10 MB hard disk space
   3.5" High Density Disk Drive

Generally, you should use a host environment with a capability that is
equal to or greater than capability of the system you plan to target.
For example, if you are building 32-bit applications for Windows 95 or
Windows NT, you should use TD32 in a Win32 environment.

NOTE: On a compressed hard disk the installation process
might need additional hard disk space. If you are using
a disk compression utility, refer to Section 2, part A.


SECTION -2-  INSTALLING TASM 5.0
================================

A) Pre-Installation Notes
-------------------------
1) Backup Disks
   If you wish to make backup copies of your original disks
   use the DOS DISKCOPY command. You must use the same disk
   size and media (density) when you make your backup set of
   disks. Attempting to copy from 3.5" to 5.25" will cause
   the install program to fail. If you have a bad disk
   contact Borland's Disk Replacement line at (800) 621-3132.

2) Disk Compression
   If you are using a disk compression utility (such as
   Stacker[tm], DoubleSpace[tm], XtraDrive[tm],
   SuperStor[tm], etc.) the estimated available hard disk
   space reported might not be sufficient to install the
   product. During installation, TASM 5.0 copies compressed
   files onto your hard disk. Disk compression utilities
   report available hard disk space assuming that the files
   copied onto the disk can be compressed. Since the files
   that are copied by the installation program are already
   compressed, the disk compression utility cannot compress
   them any further. To solve this, you might need to free
   additional hard disk space for the installation.

3) Network Installation
   If you are installing TASM 5.0 on a network, you may wish
   to consult Technical Information Document number 1738. For
   information on how to receive this document, refer to
   Section 10.


B) Where to Install:
--------------------
This product is designed to be used as a standalone product or in
conjunction with Delphi 2.0 or Borland C++ 5.0.  It can also be used
with Borland/Turbo C++ 4.x, Borland Pascal 7 or Delphi 1.0.  If you are
using Turbo Assembler 5.0 in conjunction with any of these Borland
compilers, you can install Turbo Assembler atop the same directory
heirarchy as your other Borland Tools.

If you use Turbo Assembler 5.0 with any other Borland development tools or
versions, then it is best to install Turbo Assembler to a unique
directory, such as c:\tasm.  Both tool sets should be referenced in your
dos path with the most recent version being first in the path.  For custom
configuration requirements, please contact Technical Support.


C) Installation Instructions:
-----------------------------
1. Boot Clean
   It is highly recommended that you boot clean before
   installing TASM 5.0. Booting your system with a clean
   configuration will eliminate any potential software
   conflicts that might arise during installation. Refer to
   Section 10 for instructions on how to boot clean.

2. Insert the TASM 5.0 installation disk into drive A or B.

3. From the DOS prompt type A:INSTALL (or B:INSTALL)
   and press <ENTER>. Do not install from a Windows DOS prompt.

4. Select installation options from the install menu. See
   Section 3 for more details on the installation instructions.

5. Choose START INSTALLATION to begin installation. If problems
   occur during installation, note any error messages and refer to
   Section 5.


D) After Installation:
----------------------
1. After the install has completed, the README file appears.
   The README file contains important information about
   configuring and using TASM 5.0, including late changes
   which might have occurred after the manuals were printed.

2. Modify your CONFIG.SYS so that files and buffers are set
   to at least 40. For example:

	FILES=40
	BUFFERS=40

   Also modify your AUTOEXEC.BAT file by adding to your path
   statement the TASM 5.0 bin directory. For example:

	PATH C:\TASM\BIN;C:\;C:\DOS;C:\WINDOWS

3. If you are installing Delphi 1.0, or Borland C++ 4.x AFTER
   Turbo Assembler 5.0 has been installed, you will have to manually
   change the system settings that allow these products to coexist:

   In your system.ini file, check your [386Enh] section for multiple
   entries for the device TDDEBUG.386.  Remove duplicate entries of
   TDDEBUG.386 so that only the version from this product is loaded.
   On disk, you may also want to rename or remove the BP7 or BC4.x
   versions of TDDEBUG.386 and TDWINTH.DLL to avoid their accidental
   loading.  You must restart Windows after making changes to system.ini.


4. Changes to SYSTEM.INI file:
   Presuming you have installed Turbo Assembler and Tools to "c:\tasm",
   The install program makes these changes to the SYSTEM.INI file:

   1) Adds "device=c:\tasm\bin\windpmi.386" to support our 32-bit tools.
   2) Adds "device=c:\tasm\bin\tddebug.386" to support our debugger.


5. Configuring the Windows NT command prompt:
   To run 16-bit protected-mode programs (tlink) under an NT command
   prompt you need to add the following line to CONFIG.NT:

      ntcmdprompt

    Under the default NT command-line prompt, DOS COMMAND.COM is run
    after returning from a TSR (such as RTM.EXE which bcc and tlink load).
    Adding the above line will cause the original NT CMD.EXE to be run.


SECTION -3-  MINIMUM AND SELECTIVE INSTALLATION OPTIONS
=======================================================
This section outlines the minimum and selective install
options available for TASM 5.0.

There are some files that are common to more than one option.
For example, MAKE.EXE will be installed if either the 16-bit or
the 32-bit command line tools are installed. { Common to 16-bit
and 32-bit tools is [2360K] of files ; Common to the TDWIN and
TDWIN32 options is [504K] of files } Those common files are
included in all the following estimates.

16-bit command line tools        [3085K]
    Install the 16-bit tools (TASM, TLINK).
    (Minimum installation option)

32-bit command line tools        [3163K]
    Install the 32-bit tools (TASM32, TLINK32).

Turbo Debugger for DOS           [1041K]
    Install Turbo Debugger for DOS.
    (Minimum installation option)

Turbo Debugger for Windows       [1533K]
    Install Turbo Debugger for Windows and associated Debugger
    tools (TDWINI setup, wremote).

Turbo Debugger for Win32         [1502K]
    Install Turbo Debugger for Win32 programs.

Examples                         [580K]
    Install Borland TASM examples.

Documentation Files              [6K]
    Install documentation files.



SECTION -4-  TROUBLESHOOTING - INSTALL PROBLEMS
===============================================
This section explains a few common errors encountered during
installation. System configuration and software conflicts
might cause the installation process to fail. If the
installation fails, follow the instructions in Section 10
on how to boot clean. This will eliminate any possible
software conflicts. If booting clean doesn't solve the
problem, or you encounter a problem not mentioned here,
contact Borland Technical Support.

With any of the following installation errors there are
several common steps that can be taken to enable the
installation to complete.

   - Make sure your system meets the minimum requirements.
     Refer to Section 1 for a list of the minimum
     installation requirements.

   - Boot your system with a clean configuration. Refer to
     Section 10 for instructions on how to boot clean.

   - Install the product from your local hard drive. Sometimes
     a timing error between the hard drive and a disk drive will
     generate an error from the TASM install. Installing from
     the hard drive can solve this problem. (Especially in
     conjunction with a clean boot)

     1) Copy the contents of all the diskettes to a temporary
        directory on your hard drive. The following is an example
        of the command:

		COPY *.* c:\temp

        If you should get an error during the copying process see
        below for information on how to get a replacement disk set.

     2) Change directories to the temp directory and then type
        install. For example:

	CD c:\temp
	INSTALL


A) Data Integrity or Bad Sector on Disk Errors
----------------------------------------------
If you receive either one of these error messages, you
need to get a replacement disk set. Contact Borland's
Disk Replacement Line at (800-621-3132).


B) Disk Full or Insufficient Disk Space Errors
----------------------------------------------
You could also get this error if there is insufficient
hard disk space available to install TASM 5.0.

   - If you are using disk compression read Section -2-
     part A) on reported available disk space when using
     disk compression.


C) GP Fault/Unhandled Exception
-------------------------------
GP Fault or Unhandled Exception errors can occur for a
variety of reasons. Possible reasons for these errors are
explained in Technical Information Document number 649.
Refer to Section 9 for instructions on how to obtain
this document.

   - Turn off Disk Caching and Video/Shadow RAM in CMOS.
     Refer to the documentation for your computer.


SECTION -5-  TROUBLESHOOTING - RUN TIME PROBLEMS
================================================
This section describes common errors encountered when
trying to use tools included in TASM 5.0. System configuration
and software conflicts might cause one of the tools to fail.
If a tool fails, you should boot your system clean to eliminate
any possible software conflicts. Refer to Section 10 for
instructions on how to boot clean. If booting clean does not
solve the problem or you encounter a problem not mentioned here,
contact Borland Technical Support.


A) Out of Memory
----------------
If you are using command-line tools and are getting
"Out of Memory" errors you might have exhausted your
extended (or XMS) memory pool. This is especially true if
you only have 2MB available extended RAM and do not have
a memory manager that provides virtual memory. If you are
experiencing this, please consult the TASM readme file that
can be found in the TASM directory, under the section General,
Out of Memory. This information can also be found in the
Technical Information Document number 1737. For information
on how to receive this document, refer to Section 9.


B) GP Fault/Unhandled Exception/System Hang
-------------------------------------------
GP Fault or Unhandled Exception errors can occur for a
variety of reasons including: not enough memory
available, not enough hard disk space available,
conflicts with optimizations set in the CMOS, and
software conflicts. Technical Information Document
numbers 649 and 1328 address these issues. Refer to
Section 9 for information on how to obtain these files.


C) Turbo Debugger for Windows
-----------------------------
If you experience any strange behavior from the Turbo
Debugger, such as a garbled screen or a system hang upon
execution or exit:

   1)  Make sure that you have the latest Windows drivers
       for your video card.

   2)  Run TDWINI and test a different DLL to resolve a
       possible compatibility problem with your specific
       card.

   3)  Check README.TXT for additional information.

   4)  If you are still experiencing difficulties your
       problem might not be related to the video mode. At
       this point contact Borland Technical Support via
       phone or online help. Refer to Section 10 for more
       information about online options and procedures.


SECTION -6-  ICONS IN THE TASM GROUP WINDOW
===========================================

A) Creating a Program Group Window for TASM 5.0.
------------------------------------------------
If the Borland C++ Program Group Window didn't appear
after installation you can create one by choosing one of
the following options:

   - Generate icons by running the groups.exe:
     From within Windows, choose File|Run, and type:

	   c:\windows\groups.exe groups.b$$

     If nothing appears to happen, it is possible that the
     data file (groups.b$$) was not created properly.

   - Manually creating the icons. Load Windows, choose
     File|New|Program Group, and click on OK. Type the
     name you want for the program group window in the
     "Description:" text box, such as Borland TASM 5.0. Leave
     "Group File" line blank. Click OK. A new Window appears.
     Choose File|New|Program Item to create icons for the
     Windows programs and click OK. Select one of the
     Windows executable programs to create an icon for, such
     as TDW.EXE (you can also use the Browse button). Type
     the name of that executable program in the Description
     text box. Type the full path name to the executable in
     the Command Line text box. Typing a path name for the
     working directory is optional. The default is the
     WINDOWS directory. Click OK. The icon appears in
     the active program group window. Repeat these steps
     for executable program you want to use.


B) List of Icons and Executable Files
-------------------------------------
The following table contains a list of executable files that
each icon calls, as well as the name of the icon for that
executable, if there is one:

    TASM.HLP=F:\TASM\BIN, Tasm Reference, HELP.ICO
    TDW.EXE=F:\TASM\BIN, Turbo Debugger for Windows, TDW.ICO
    TDWINST.EXE=F:\TASM\BIN, TDW Configuration, TDWINST.ICO
    WREMOTE.EXE=F:\TASM\BIN, Remote Debugging
    WRSETUP.EXE=F:\TASM\BIN, Remote Setup
    TD.PIF=F:\TASM\BIN, Turbo Debugger for DOS, TDDOS.ICO
    TDINST.EXE=F:\TASM\BIN, TD Configuration, TDOSINST.ICO
    TD32.EXE=F:\TASM\BIN, Turbo Debugger for Win32, TD32.ICO
    TD32INST.EXE=F:\TASM\BIN, TD32 Configuration, TD32INST.ICO
    TDWINI.EXE=F:\TASM\BIN, TD Video Configuration


SECTION -7-  USING TASM FROM WINDOWS
====================================
The TASM installation creates a TASM 5.0 group in the Windows
Program Manager. However, the installation program does not
create Windows PIF files to run any of the command line tools.

TASM.EXE and all other 16-bit executable tools can be run through
a regular Windows DOS box.

To run TASM32 from a Windows DOS box, you need to use an icon
created with a PIF file. You can use the PIF file B32TOOLS.PIF
(located in the TASM\BIN directory) to run the 32-bit tools
from a Windows DOS box. This PIF file references COMMAND.COM.
When you double click the icon, a DOS box activates, and you
can run TASM32.EXE and TLINK32.EXE from it.


SECTION -8-  HOW TO GET A TECHNICAL INFORMATION DOCUMENT
========================================================
Technical Information Documents contain tips, techniques,
and enhanced information on using Borland development tools,
and information on commonly asked programming questions.
Such documents often include programming examples. These
documents can be accessed via modem or fax. Technical
files which contain binary modules, such as patches for
released Borland products, are normally available only from
those services that can be accessed by modem. Documents can
be accessed from the following sources:


A) Fax the document from Borland's TechFax Service
--------------------------------------------------
Call (800) 822-4269 from a touch-tone phone. When
prompted, enter your FAX number, then enter the document
number you want to receive. The document will be faxed to
you shortly.

Here is a list of common Technical Information Documents:

      * 3       General Catalog of All Documents Available
      * 649     General Protection Faults
      * 1171    Problem Report Form
      * 1010    Installing and Configuring BC++
      * 806     Network Installations
      * 738     Memory Corruption
      * 1561    Clean Boot


B) Download the document from
-----------------------------
   -The Borland Download Bulletin Board Service (DLBBS)
    (408) 431-5096, protocol 8N1
   -The Borland Automated Online Service (OAS)
    (408) 431-5250, protocol 8N1
   -The Borland-supported FTP site on Internet
    ftp.cica.indiana.edu, IP address [129.79.20.27]
   -Borland-supported forums on CompuServe, Genie, BIX.
	For CIS type:
	   go BCPPWIN
             or
	   go BCPPDOS
	and choose library 2

	For BIX type: join Borland

	For GENIE type: Borland

   Below are steps to download a Technical Information
   Document from the Borland DLBBS.

   For proper display, your communication software should
   provide ANSI terminal support. Most packages provide
   VT-100 terminal emulation, which is fine for the DLBBS.
   If you're using a Windows based package, select a screen
   font (such as: Terminal) that includes extended ASCII
   characters.

   Once connected, you'll be prompted to enter your first
   and last name and a password. If you haven't used the
   service before, you'll be asked to verify your name and
   then answer a few questions. The menu-driven system
   guides you through the various product and file
   areas. You'll always receive a list of options when you
   are prompted to make any choice.


   MANEUVERING THE MAIN MENU
   - - - - - - - - - - - - -
   First join the C++ Conference. The Main Menu shows the
   product whose files you can access. At the Main menu,
   type "F" to select the Files menu.


   DOWNLOADING FILES
   - - - - - - - - -
   Once you know the name of the file you want to download,
   type "D" for download at the File menu. When prompted,
   type the full name of the file or files. All Technical
   Information Documents have the form "TI#.ZIP". Replace
   the # with the appropriate document number. For example,
   to download Technical Information Document number 649,
   the full name of the file is TI649.ZIP. If you do not
   know the protocol or download keys to press, refer to
   your telecommunications manual.


   WORKING WITH DOWNLOADED FILES
   - - - - - - - - - - - - - - -
   Most of the files on the Download BBS are stored and
   transferred in an archived (compressed) format and need
   to be unarchived before they can be used. If you don't
   have the unarchiving utility PKUNZIP v.204G or newer,
   download PKZ204G.EXE from the DLBBS and execute it.
   You'll receive PKUNZIP and PKZIP utilities. To unarchive
   the file, type the name of an unarchive utility
   (UNPACK, UNZIP or PKUNZIP) and then the name of the
   archived file. For example:

	PKUNZIP TI649.ZIP


SECTION -9-  BOOT CLEAN
========================
This section describes the process of "booting clean" on
IBM PC's and compatible computers with DOS and/or windows.
This document assumes you have MS-DOS version 5.00 or higher.
"Booting Clean" is the process of booting without loading
device drivers and TSRs. Device drivers such as mouse
drivers, network drivers, TSRs, etc. can cause memory
conflicts.

These device drivers and TSRs are usually loaded in two
files (AUTOEXEC.BAT and CONFIG.SYS typically located on
the root directory of your hard disk). The safest
method of booting clean is to create a "bootable" floppy
disk in drive A:. See the "Making a Boot Disk" section
below.

If you are using a program that runs under Microsoft
Windows, then you might need to make changes to some Windows
configuration files in order to ensure a "clean system
configuration" under Windows. The two files you will need
to examine are WIN.INI and SYSTEM.INI. These files are
located in the WINDOWS subdirectory on your hard disk. The
changes that you will need to make to these files (if any)
are outlined below.


Making a Boot Disk
- - - - - - - - - -
In order to make a bootable floppy disk, follow the
instructions below. NOTE: These instructions assume that
your hard disk is C: and your DOS and WINDOWS subdirectories
appear on this disk. (Most cases):

     1) Place a blank disk in drive A:
     2) type  format a: /s (format the disk)

At this point you now have a bootable floppy disk. Using
EDIT, ensure your AUTOEXEC.BAT and CONFIG.SYS look like
one of the configuration choices below.

Your "clean" system configuration should be exactly like
one of the choices below except replace "<Insert REQUIRED
drivers here>" with any required drivers. The ONLY
required drivers are, for example, disk compression and/or
hard disk access drivers. This does not include mouse
drivers and disk caching utilities such as SmartDrive.


Clean Configuration DOS 5.0 and DOS 6.x running Windows
-------------------------------------------------------
   1) Insert your "bootable floppy" in drive A.
   2) Type "EDIT A:\CONFIG.SYS"
   3) Type in the following:

          <Insert REQUIRED drivers here>
          DEVICE=C:\DOS\HIMEM.SYS
          FILES=40
          BUFFERS=40

   4) Exit the editor (Alt-F, then X, then Y).
   5) Type "EDIT A:\AUTOEXEC.BAT"
   6) Type in the following:

          <Insert REQUIRED drivers here>
          PATH=C:\WINDOWS;C:\DOS;C:\BC4\BIN
          PROMPT $P$G

   7) Exit the editor (Alt-F, then X, then Y).
   8) Type "CD \WINDOWS:
   9) Type "COPY WIN.INI WIN.BAK"
  10) Type "COPY SYSTEM.INI SYSTEM.BAK"
  11) Type "EDIT WIN.INI"
  12) Make sure that the "load=" and "run=" lines in your
      WIN.INI file match the following lines:

          [windows]
          spooler=yes
          load=
          run=
          Beep=yes

  13) Exit the editor (Alt-F, then X, then Y).
  14) Type "EDIT system.ini"
  15) Ensure that your "shell=" line in your SYSTEM.INI file
       matches the following:

          [boot]
          shell=progman.exe

  16) Exit the editor (Alt-F, then X, then Y).
  17) Make sure your "Bootable floppy" is in drive A: and
      reboot your computer.

/**************************** END OF FILE ********************************/

�