USING FRAME PRODUCTS WITH THE SILICON GRAPHICS MAGIC DESKTOP
-------------------------------------------------------------


The $FMHOME/fminit/samplehome/sgidt directory contains files that
support the Silicon Graphics Magic Desktop. Use these files to
integrate Frame products with the Magic Desktop. 


SETTING UP FRAME PRODUCTS FOR THE MAGIC DESKTOP
-----------------------------------------------

The $FMHOME and $FM_FLS_HOST variables must be set before you 
start the Magic Desktop. To set them automatically each time
you log in, define these environment variables in your .login or
.cshrc file.

$FMHOME and $FM_FLS_HOST are defined for you when you install
Frame products and set up licenses. For more information, see
"Installing Frame Products."


RUNNING fmsgimagic
------------------

To integrate Frame products with the Magic Desktop, run the
fmsgimagic script.  This script sets up the Magic Desktop to
recognize Frame product applications and files and to display
the appropriate icons for them. 

To run the fmsgimagic script:

1. Log in as root.
   
   You might need to ask your system administrator for the root
   password. 

2. Change to the Magic Desktop support directory. Type the
   following command:

   cd $FMHOME/fminit/samplehome/sgidt

3. To run the script, type the following command: 

   fmsgimagic


WORKING WITH FRAME PRODUCTS ON THE MAGIC DESKTOP
------------------------------------------------

Once you set up the Magic Desktop to work with Frame products, 
you can:

- Double-click on a Frame product application icon to start 
  the product

- Double-click on a Frame product document icon to start the
  product and display that file

- Use the Magic Desktop pop-up menu to print a document

- Drag and drop files into Frame product icons


MORE ABOUT DESKTOP ICONS
------------------------

Desktop icons are different from window icons.  Desktop icons
represent the files on disk, whereas window icons represent closed 
windows.

Silicon Graphics desktop icons appear to be three-dimensional. Icons 
for applications lie flat horizontally to give the impression of a top 
of a table where work is performed.  Icons for data files (such as 
FrameMaker documents) typically stand vertically, like books on a
bookshelf. 

When you click an icon, a yellow highlight shows that it is selected.
If you double-click an icon, the system gives you access to whatever
that icon represents. For example, double-clicking a directory icon
opens the directory. Double-clicking an application icon starts that 
application. Double-clicking a data file icon starts the application
that can display the contents of the file and opens the file.


FRAME PRODUCT ICONS AND MAGIC CARPETS
-------------------------------------

In general, while an application is not running, a "magic carpet" 
appears under its icon. When the application is running, the magic 
carpet flies into a vertical position. 


The magic carpet position does not change when you start a Frame
product. It always appears beneath the Frame product icon. (The
nonstandard magic carpet position is caused by the fact that
Frame products use a script to start; the Magic Desktop only
supports updating the magic carpet for executable program files.)


FOR MORE INFORMATION
--------------------

To learn more about the Magic Desktop, choose On-line Books from the
Help menu in the Toolchest, or type the following command in a shell
window:

insight

Then read "Indigo Magic Desktop Integration Guide."

