TITLE:    The Add-In Support Disk and Upgrade Packages
PRODUCT:  123 3.1
DATE:     25-Oct-1990

PROBLEM:

Where can customers upgrading to 123 3.1 from 123 2.2 and 123 3.0 find
information concerning the Add-In Support Disk included in the 123 3.1 upgrade
package?  How is the Add-In Support Disk installed and what are the Add-In
Library files used for?

SOLUTION:

Upgraders can find information concerning the Add-In Support Disk in a letter
on Lotus stationary which is included in the upgrade package.  The letter
begins "Dear 1-2-3 Upgrader", and the second page of this letter is titled:
"1-2-3 Release 3.1 Usage Notes".  These usage notes contain information about
the Add-In library.  This information can be found in Appendix 6 of the 123 3.1
Reference Manual in non-upgrade packages of 123 3.1.

Installing the Add-In Library Files:

1. Insert the Add-In Support Disk in Drive A (or the appropriate drive
   depending on the media size).

2. Enter: A: and press RETURN to make drive A current.

3. Enter: LINSTALL and press RETURN.

   Linstall will prompt for the name of the 123 3.1 program directory,
   offering C:\123R3 as the default choice.  Either press RETURN to accept the
   default or if necessary, edit the path and directory name and then press
   RETURN.

4. Linstall will prompt the customer to specify the name of the directory to
   store the sample add-in files, and offers C:\123R3\ADDINS as the default.
   Either press RETURN to accept the default choice or enter another path and
   name and then press RETURN.  Linstall will create the directory if it does
   not exist.

5. After Linstall transfers the add-in files and displays the message
   "Installation Successful", press RETURN to exit Linstall and return to the
   operating system prompt.

Installing the Add-In Library Files installs two sample add-ins.  Before they
can be used, the add-in files must be loaded into memory.  To load the add-in
files:

1. Start 123 3.1.
2. Press ADDIN (ALT-F10).
3. Select load.
4. Specify the add-in to load into memory.
5. It is not necessary to assign a function key to the sample add-ins.
6. Select Quit to return to READY mode.

The two Sample add-ins are a sample @function called XDEGRESS.PLC and a sample
macro command XALERT.PLC.

The add-in file XDEGRESS.PLC defines the @function @DEGREES, which converts
degrees from Fahrenheit to Celsius or from Celsius to Fahrenheit.  The syntax
is:

@DEGREES(Degrees,Conversion)

Degrees is the number of degrees to convert, and Conversion is a literal string
either:

     "ftoc"       (To convert Fahrenheit to Celsius)
     "ctof"       (To convert Celsius to Fahrenheit)

            Example:  @DEGREES(32,"ftoc")

The add-in file XALERT.PLC defines a macro command {ALERT}, which beeps and
displays a warning box.  The syntax for the {ALERT} command is:

{ALERT string1,string2,string3,string4} where string1-string4 are four lines of
text in the box.  Each string appears on a separate line, centered within the
box.

             Example:

            {ALERT "The Number You Enter","Must Be Between 1 and 10","Please
             Try Again", "Thanks!"}

Note to Lotus Customer Support Specialists:

If upgrade customers report that they were unable to find the appropriate
documentation for the add-ins included on the Add-In Support Disk, please enter
a 123 3.1 Call Tracking CSR in the Lotus Notes database.

(C) 1990 Lotus Development Corporation.  All rights reserved.
