CHAPTER 14: COMMERCIAL SOFTWARE
back to the Computing Guide Contents



A variety of commercial and public domain software packages are available within the MMM computing environment. This chapter provides a brief description of each package, and information on where and how to access it. This chapter is not intended to provide all the necessary information to use these packages; detailed documentation exists elsewhere. This chapter will direct you to the appropriate documentation for each program. The following software packages and information are included:

14.1 FrameMaker


14.1.1 Overview

FrameMaker is a powerful and sophisticated publishing tool that integrates word processing, equations, graphics, page layout, and book building. This software is available on the DEC OSF/1, Sun and SGI workstations, as well as the personal computers used by the administrative staff, and runs only in a window environment. Documentation can be borrowed from the administrative person within each section.

14.1.2 Setting up Your Account

To set up your workstation account to use FrameMaker, enter
        cd /usr/local/frame



        ./fmusersetup
This startup script will edit your .login and .profile files. You must log completely off the workstation and back on before these changes will take effect.

14.1.3 Execution

Once you are set up to use FrameMaker, as described above, you can access the program by entering
        maker
If you execute the maker command and get the error message, file not found, add the following to your PATH environment variable in your .login and .cshrc files:
        /usr/local/frame/bin

14.1.4 Templates

FrameMaker contains several templates for reports, viewgraphs, newsletters, outlines, books, and letters and memos. These are located in the subdirectory, /usr/local/frame/fmtemplates. They can be accessed while in FrameMaker by clicking the NEW box on the main menu. In addition, a few MMM templates have been created, which are listed below.
Template Name   Description



fax             MMM fax cover sheet

letterhead      Letter form with MMM letterhead 

                (same letterhead as in the TeX MMM letter template)



memohead        Memo form with MMM memohead 

                (same as MMM memohead in MMM memo template)

doorbig.frame   Template for making the large-sized MMM 

                office-door signs with staff name and room number 

doorsmall.frame Template for making the small-sized MMM 

                cubicle signs with staff name and room number
All the above templates are located in/usr/local/frame/fmtemplates/LettersMemos except doorbig.frame and doorsmall.frame, which are located in /usr/local/frame/fmtemplates/misc

Hardcopy References

Learning FrameMaker
Using FrameMaker
FrameMaker Reference
Using FrameMath
New Features in FrameMaker
FrameMaker Shortcuts


Return to top of page

14.2 TeX


14.2.1 Overview

TeX is a public-domain electronic typesetting, page-layout program that is especially well suited to writing highly technical documents that include mathematical equations. The TeX commands used for processing a document are embedded in the document itself. Information for processing a TeX file in the MMM environment can be found in Chapter 4, Processing TeX Files. In addition, a list of Adobe PostScript fonts available in TeX and how to incorporate them into your document can be found in Appendix F. For information on printing TeX files in landscape mode, see the printer section 4.5.2.

14.2.2 Macros and Templates

All frequently-used TeX macros exist in a central directory and are accessible by all users. The directory that contains these macros is /usr/common/teTeX/tex/plain/misc. By default, when you use the \input command in your document, TeX looks in your current directory and then this directory for the referenced file. In addition to macros, this directory also contains some of the more widely used templates that have been written locally.

In general, a brief description of what a particular macro does is included at the beginning of the macro file. To access a macro, add the following line in your TeX document:

        \input filename
If you want to use one of the templates, first copy it to your directory and then edit it to fit your specific needs.

List of TeX Macros

Following is a list of MMM TeX macros; some of them are referenced by the templates listed on the following page.
Filename                Description 



lettersetup             Macro for letterform.tex template 



letsetup2sig.tex        Modification of the lettersetup.tex macro 

                        to allow for two signatures on a letter

memosetup               Macro for memoform.tex

outline.tex             Macro for setting up an outline 

symbols.tex             Contains frequently used symbols 

ref.tex                 Macro for formatting bibliographic references 



decimal.tex             Macro for lining up numbers in tables

hopenote.tex            Left-justified footnote macro

dubcol.tex              Double column macro

journals.tex            Various macros for journal abbreviations 

chappage.tex            For numbering chapters. First page has the 

                        number at the bottom of the page. Subsequent pages 

                        have the number on upper left or right corner.

amsmacro.tex            Formats manuscript in AMS journal style.

dblcolins.tex           Allows floating figure inserts in 

                        double-column mode. 

letterspace.tex         Allows you to alter default spacing between letters. 

fakesc.tex              Allows you to simulate lower case caps when not available. 

newitem.tex             This macro functions like the item command; 

                        however, it allows you to put a "word" as the first 

                        input parameter and still have the margins justified. 



raggedright.tex         This macro modifies the hyphenation used when 

                        using unjustified margins.

fpmacros. tex           Macros for generating papers in preprint format
The two macro files symbols.tex and journals.tex contain several macros for frequently-used symbols and journal abbreviations for insertion into manuscripts and bibliographies, respectively.

List of TeX Templates

These templates each contain a skeleton outline, which you can tailor to your specific needs. Templates are located in /usr/common/teTeX/texmf/tex/plain/misc
Filename        Description 



letterform      MMM letter format

letform2sig.tex Modification to allow two signatures in 

                the standard letterform.tex 

memoform        MMM memo format 

cv.tex          Curriculum Vitae (resume) format 

ams_model.tex   Format for camera-ready two-column AMS paper



tabs.tex        Sample for setting up a settabs table



jourform.tex    Template for AMS manuscripts 

amstest.tex     Sample AMS paper

pptempl.tex     Template for preprint format

pptest.tex      Sample of preprint format

14.2.3 Including Postscript Plots in TeX

It is quite simple to include postscript graphics plots in your TeX or Latex output. First, add the following line near the beginning of your TeX file.
        \include epsf (tex)



        \input epsf (latex)
This includes the macro needed to interpret the subsequent commands.

From an NCAR Graphics metacode file, you must produce a postscript file. Each individual plot must reside in its own file. For a metacode file containing several plots, use idt to select a frame and use the save function to put it to its own file. You may save as many frames by this method as you want, each in a separate file. To convert this to postscript, use ctrans. For example, to convert the metacode file, plot1.gmeta to postscript, use the command

        ctrans -d ps.mono plot1.gmeta > plot1.ps
When using TeX's plotting capability, you can specify the size you want. If not specified, the plot will be printed in its "natural" size, usually a full page. You can specify either the x dimension or y dimension you desire, and the espf routine will scale the other dimension proportionately, using the following commands.
        \epsfxsize=<dimen>
        \epsfysize=<dimen>
For example, \epsfxsize=3.0truein requests a size in the x dimension of 3.0 inches. The y size will be scaled accordingly (for example, to 3.0 inches for a square plot). Note that these sizes are approximate; the actual plotted graphics seem to print somewhat larger. You must also specify the size before each plot you include; the size is reset each time.

To get the postscript graphics file, use the command, \epsffile. You can use the \centerline command to center the plot on the page. For example, the set of commands,

\centerline{ \epsfxsize=3.0truein \epsffile{/users/joanne/tex/plot1.ps}} 

(Tex)



\centerline{ \epsfxsize=3.0truein \epsffile{/users/joanne/latex/plot1.ps} 

(Latex)
will fetch the designated graphics file, scale it to about 3 inches, and center it on the page at the current position in the text. TeX will include a fair amount of white space above and below the plot, but you can reduce that if desired by the use of a negative vskip.

The graphics do not show up on the TeX preview facility. The proper spaces are included, but the plots do not appear in them. 


Hardcopy References

A User's Guide for TeX 
The Definitive TeX Index for NCAR Scientists
The TeXBook


Return to top of page

14.3 Meeting Maker


14.3.1 Overview

The organization-wide calendaring software at NCAR/UCAR is Meeting Maker. The server is installed in the Desktop System and Networking group within Finance and Administration. DSN maintains a Meeting Maker web site at http://www.fin.ucar.edu/it/dsn/calendar.htm.

The product is cross-platform (UNIX, PC, Mac), has a web client, and supports PalmOS PDAs.

The native client is available for Windows, Macintosh, Solaris, and HP-UX systems. The web client is used for other platforms such as Digital UNIX, Irix, and Linux.

If you schedule a lot of meetings or wish to keep your calendar on-line, then you may want to use this software.

The full documentation set is available online http://www.mmm.ucar.edu/computing/doc/soft/soft.html


14.3.2 Requesting an Account

Send an "assist" request to request a meeting maker account. Once your account is established, your username will be the first part of your ucar.edu email address. For example, if your UCAR email address is jtanner@ucar.edu, then your Meeting Maker username is jtanner. Initially you'll have no password.


14.3.3 Using the Native Client Version

The native client version is available for Windows, Macintosh, Solaris, and HP-UX systems.

On the Windows systems, here are the initial steps you'll need to take before using the software.

  1. Install the Software:

    Submit an "assist" request to have the software installed on your system, or see the instructions on installing the software below.

  2. Start the Application:

    The Meeting Maker application will be in your Start --> Programs menu or on your desktop. Double-click the icon or select the application from the menu to start it.

  3. Configure the Server:

    When the login screen appears, click on "Select" next to TimeZone
    Select USA Mountain and click on OK.

    Now click on "Select" next to Server.
    Make sure the "Protocol" is set to "IP" (using the pull-down menu)

    Click on "Configure" and type in the IP number of the server which is 128.117.13.12
    Click on "OK"

    Under the "Select Server" column, select "UCAR-MM7"
    Click on "Select"

  4. Sign In:

    Your Username is the first part of your UCAR email address.

    Initially, you have no password.

    After you enter your username and password, click on "Sign In"

For the Sun Solaris systems, the software is already installed, but here are the initial steps that you'll need to take before using the software.

  1. Set up Printing:

    There is a file that you need to copy to your home directory to set up the printing. Enter the following:

    
    cd ~
    
    cp /usr/local/mm/xprinter/Xpdefaults .Xpdefaults
    
    

    Also, you'll need to edit your .cshrc file and add the following lines:
    
    setenv MMHOME /usr/local/mm
    
    setenv XPPATH ${MMHOME}/xprinter
    
    
  2. Start the Application by typing
    
    mmxp &
    
    
    or
    
    /usr/local/bin/mmxp &
    
    
  3. Configure the Server:

    When the login screen appears, click on "Select" next to TimeZone.
    Select USA Mountain and click on OK.

    Click on "Select" next to Server.
    Make sure the "Protocol" is set to "IP" (using the pull-down menu)

    Click on "Configure" and type in the IP number of the server which is 128.117.13.12
    Click on "OK"

    Under the "Select Server" column, select "UCAR-MM7"
    Click on "Select"

  4. Sign In:

    Your Username is the first part of your UCAR email address.

    Initially, you have no password.

    After you enter your username and password, click on "Sign In"

  5. Set the Default Printer:

    Under the "File" menu, select "Print Setup..."
    Click on "Options"
    Use the pull-down menu to select a printer under "Printer Name"
    Click on "OK"
    Then click on "Apply"

For more information on how to use the software, please see the UCAR Customized Meeting Maker Documentation:
New User Training for the Native Client(.pdf)


14.3.4 Using the Web Client version

Open a web browser such as netscape and go to the following URL:

http://www.fin.ucar.edu/calendar/

Click on the text "meetingmaker java client" to access Meeting Maker.

The first time you attempt to login you will be asked to grant three Java security privledges. Click in the box "Remember this Decision" and click the "Grant" button. Do this for all three privleges.

After you have completed granting privleges on your first login, the Meeting Maker sign in dialog box appears. Enter your username and password.

Your Username is the first part of your UCAR email address and initially you have no password.

After you enter your username and password, click on "Sign In".

The web client does not give you full functionality. Therefore, the native client is available on the Sun system and on 2 PC's within the division, juneberry (located on the 2nd floor in a cubicle behind peach) and kapok (located in a cubicle outside Rich Rotunno's office). You can use the native client to grant proxy to your calendar and create contact lists. Please see the previous section for information on how to use the native client version.

Testing has shown us that the first time you log into the server with the web client it may be slow. Please be patient with it and let it run. It's been known to take up to 6 minutes with the first login. Any subsequent logins have been considerably faster.

For more information on how to use the software, please see the UCAR Customized Meeting Maker Documentation:
New User Training for the Web Client(.pdf)


14.3.5 Accessing Meeting Maker from a Home PC or Mac

The meeting maker server exists on an exposed host and can be accessed from inside or outside the UCAR network. For example, you can access Meeting Maker when you're connected through the NCAR RAS or an ISP.

To install Meeting Maker on a PC or Mac, do the following:

  1. Print the Instructions:

    Go to the following URL:

    http://www.fin.ucar.edu/it/dsn/mm/userdocs.htm

    The installation instructions are listed for installing the software on a machine in the office or at home/dialup. Select the appropriate scenario and platform. Print out these instructions. Please read the instructions before attempting the installation.

  2. Download the Software:

    On your home computer, connect to the NCAR RAS or to an ISP, open your web browser and go to the address:

    http://www.fin.ucar.edu/it/dsn/mm/download.htm

    Now, download the Meeting Maker client by selecting the appropriate client software. If you have a Windows system, select the "Windows Client Meeting Maker Software".

  3. Install the Software:

    Follow the instructions (that you printed out in Step 1) to install the software.


14.3.6 Meeting Maker Frequently Asked Questions

The meeting maker Frequently Asked Questions list is located at:

http://www.fin.ucar.edu/it/dsn/mm/faq.htm


14.3.7 Meeting Maker and Palm Pilots

Meeting Maker can be setup to synchronize with your PalmOS PDA. Information can be found at the following URL:

http://www.fin.ucar.edu/it/dsn/mm/mm702.htm

and in the Frequently Asked Questions:

http://www.fin.ucar.edu/it/dsn/mm/faq.htm



Return to top of page

14.4 StarOffice

14.4.1 Overview

StarOffice is from Sun Microsystems and is similar to Microsoft Office. StarOffice is installed on the Sun & Linux platforms. It is also available for the Windows 2000/XP systems. StarOffice contains the following products:

StarWriter      word processor similar to Microsoft Word

StarCalc        spreadsheet package similar to Microsoft Excel

StarPresent     presentation software  similar to Microsoft Powerpoint

In addition, it has other packages such as a drawing package and an html editor. These packages can open Microsoft documents and you can use the Save As command to save them in Microsoft formats. Files can also be converted to html format using the export command.

When using StarOffice, there is on-line help under the Help menu. Documentation is also available on our Software Documentation web page.

14.4.2 StarOffice Setup for Windows systems

StarOffice is deployed through Group Policy on the Windows systems. In order to get the software installed, please submit an assist request.

14.4.3 StarOffice Setup for Linux and Solaris systems.

To use these packages, you will need to execute the following command.
/usr/local/staroffice6.0/setup
This will start the installation program and prompt you for information.

  1. The first screen displayed is the Welcome screen. Click Next.
  2. The README file will be displayed, click Next.
  3. The Software License Agreement screen is displayed, click on Accept.
  4. If you have used a previous version of StarOffice, the next screen will allow you to import and personal data from a previous installation. If you have installed a previous version select Import Personal Data and enter the directory where you've previously installed StarOffice (i.e. /users/jtanner/office52). It should detect this information for you.

    If you didn't install a previous version, you will not see this screen.

  5. If you did not import personal data in the previous screen, then you'll be prompted for your user information, enter this information.
  6. The next screen let's you select the installation type, select Workstation Installation and click on Next.
  7. It will prompt you for the installation directory, the default should be an staroffice6.0 directory in your home directory (i.e. /users/jtanner/staroffice6.0).
  8. If that directory doesn't exist, it will prompt you to creat it. Click on Yes.
  9. At the next screen, click on Install
  10. The next screen prompt you for Java setup. This install requires 38.5 MB of free space in your home directory. You can keep the default and select Next without installation Java. If you want Java support, click on Install and the Java Runtime Environment will be installed in /user/username/staroffice6.0/program/jre1.3.1_02 directory.
  11. You'll be prompted that the installation could not find files to install the Adabas database. We do not have this software, so click OK. This error messages is unimportant.
  12. The next screen will inform you that you'll need to restart KDE (on a Linux system) or the workspace manager (on a Solaris system). The easiest way to do this is to exit and log back in when the installation has completed.
  13. Now that you've entered all the information, click on Complete and the installation will install some files and you're done.
  14. Log off your computer and log back in again.

Printer Setup

cd /users/username/staroffice6.0
spadmin

This will bring up a GUI window

- Select New Printer
- Add printer should be selected -> Next
- Scroll through printers and select Xerox Phaser 5400 PS -> Next
- It will ask for a command to use enter either of the following
   
  xprint -dprintername (This will bring up GUI window when you print.)

- Select Next
- Choose a name for your printer (i.e., peach, cherry, banana, fig)
- You can optionally choose whether you want the printer to be your 
  default printer
                                
To run StarOffice enter


/users/USERNAME/staroffice6.0/soffice

where USERNAME should be your login name. You can also put the path in your PATH variable in the .cshrc file.


setenv PATH $PATH":/users/USERNAME/staroffice6.0"

If you are on a Sun system and running the CDE environment, an icon will appear on your main bar at the bottom of the screen. You can start staroffice by clicking on that icon. If you're on a Linux system and running the KDE environment, click on the K menu, Staroffice should appear in there. You can select it from there. This software is also available on the Windows 2000/XP systems. If you would like it installed, submit an assist request.

14.4.4 Removing StarOffice

If you wish to remove StarOffice from your home directory on a Linux or Solaris system. Run the setup program again:
/usr/local/staroffice6.0/setup

You will be given an option to remove the software. If you wish to remove StarOffice from a Windows system, submit an assist request



Return to top of page

14.5 Other Software

This section covers some other software packages available in MMM, both word processors and spreadsheets.

14.5.1 Other Word Processors

WordPerfect

WordPerfect is a word processing software package. It is available on some of the personal computers used by the Administration Staff, and was obtained for compatibility with other groups. To run the WordPerfect program, select the Word Perfect icon.
        wp

Microsoft Word

Microsoft Word is a word processing software package. It is available on the personal computers used by the Administration Staff,and also on personal computers in the general access areas. It was obtained for compatibility with other groups. To run the Microsoft Word program, select the Microsoft Word icon.

14.5.2 Spreadsheets

Excel

Excel is a spreadsheet program that runs under the Microsoft Windows environment. It has a number of tools for manipulating data and presenting information visually in the forms of charts and graphs. This software is available on the personal computer in the administrative offices and in general access areas.

14.5.3 Numerical Recipes Software

The Numerical Recipes software consists of the computer programs that appear in the "Numerical Recipes" series of books published by Cambridge University Press. These programs are available in C, ANSI C, and FORTRAN on all three of the primary hardware platforms, DEC Ultrix, Sun, and SGI.

Source Code

The Numerical Recipes source code is located in the following directories.
        /usr/local/numrec/recipes_c-kr/recipes

        /usr/local/numrec/recipes_c-ansi/recipes

        /usr/local/numrec/recipes_f/recipes

Libraries

The associated libraries are
        /usr/local/lib/librecipes_ckr.a

        /usr/local/lib/librecipes_c.a

        /usr/local/lib/librecipes_f

Hardcopy References

WordPerfect Workbook 
Excel User's Guide, Volumes 1 and 2


Return to top of page

Copyright © UCAR 1998 - Disclaimer - mmminfo@ncar.ucar.edu
Last Modified: 1 December 2002