******************************************************************
**                                                              **
**               IBM-PC Installation of DISLIN                  **
**                                                              **
**  Contents:  1.)  Introduction                                **
**             2.)  Installation of DISLIN                      **
**             3.)  Getting a DISLIN License                    **
**                                                              **
**  Date   :   15.04.2003                                       **
**  Version:   8.1  /  Windows, Portland PGF77, PGF90           **
**                                                              **
**  Author :   Helmut Michels, Tel.: +49 5556 979 334           ** 
**             MPI fuer Aeronomie, Max-Planck-Str. 2,           **
**             D-37191 Katlenburg-Lindau, Germany               **
**             E-mail: michels@linmpi.mpg.de                    **
******************************************************************


1.)  Introduction

     This file describes the  installation  of the  data  plotting
     software DISLIN on IBM-PCs  for  the operating system Windows
     9x/NT/2000/XP  and the  Portland Group  compilers  pgf77  and 
     pgf90.

2.)  Installation of DISLIN

     The DISLIN version for the Portland Group compilers pgf77 and
     pgf90 is  distributed  in the  zipped file  dl_81_pg.zip.  An 
     utility for unpacking the DISLIN files is available  from the
     same location where you have downloaded dl_81_pg.zip, or from
     the DISLIN CD-ROM. 

     To install DISLIN, make the following steps:

  a) Create a temporary directory and copy the files dl_81_pg.zip
     and unzip.exe to it:

     for example:   md  c:\temp
                    cd  c:\temp
                    copy e:\dislin\windows\unzip.exe    *.*
                    copy e:\dislin\windows\dl_81_pg.zip *.*

  b) Extract the DISLIN files with the command:

                    unzip -o dl_81_pg  

  c) Run the setup program with the command

                    setup

     -  Choose OK

     -  Give the Installation Directory where  DISLIN  should be in-
        stalled. The default directory is C:\DISLIN.

  d) Reconfigure the System

     Add the DISLIN\WIN directory to the PATH environment in the
     file AUTOEXEC.BAT

     for example:  PATH C:\BIN;C:\PGI\BIN;C:\DISLIN\WIN

     Add the DISLIN environment variable DISLIN to the autoexec.bat
     file:

     for example:  SET DISLIN=c:\dislin   

  e) Now you can compile,  link and run the example programs in the
     DISLIN subdirectory examples with the commands

                 DLINK   -a  exa_f77      (for pgf77)
                 F90LINK -a  exa_f90      (for pgf90)
     and
                 DLINK   -a  map_f77      (for pgf77)
                 F90LINK -a  map_f90      (for pgf90)

     Notes:

      - The file DISLIN.MOD contains interfaces for all DISLIN 
        routines.  It must be used in all DISLIN Fortran 90 programs
        and subroutines with the USE statement.
        You can use the -I switch of the pgf90 compiler for compiling
        programs (see F90LINK.BAT).

      - F90LINK uses the DISLIN libraries DISPGF90.LIB and DISDLL.LIB
        for linking. DLINK uses the DISLIN libraries DISPGF77.LIB and
        DISDLL.LIB.


3.) Getting a DISLIN License

   You can install and check DISLIN for 10 days.  Once this date passes,
   DISLIN must be licensed. See the file 'DISLIN.INF' for licenses and 
   prices. 

   To get a license number, you have to run the program  'license'
   in the DISLIN\win directory:

   license

   The program will create the file 'license.lis'. Send it via E-mail
   to
                   michels@linmpi.mpg.de

   to receive a valid license number. After that, you will be contacted
   by  Garching Innovation  that manages the payment of DISLIN licenses
   (see the file 'DISLIN.INF'). 

