This directory contains nine directories with DONLP2 executables for

   Intel/WIN32                       : mswin
   Intel/Linux                       : linux
   MacOS X                           : macosx
   Free BSD                          : freebsd
   PowerPC under AIX4.3              : powerpc
   IBM under AIX3.2                  : rs6k
   HP PA2.0 under HPUX 10.20         : hp
   SGI under IRIX-6.* (32/64 bit)    : sgi
   Sun (Solaris 2.*/SunOS 5.*)       : solaris
   Solaris on Intel x86              : solaris_i86pc
   DEC Alpha under DEC-Unix 4.0      : alpha
   DEC Alpha under Linux             : alphalinux

These executables work together with the respective AMPL student binaries
"ampl" from ftp://ftp.netlib.org/ampl/student/ 
In these the maximum number of variables and constraints
is limited to 300. This means that the total number of bounds and general
constraints is <= 300 for DONLP2.

The directory 
                      models
 
contains AMPL models for some well known nonlinear optimization problems. They
may be used as examples how to code a model in AMPL. 

To use ampl with donlp2 one may proceed in two ways:
Either one writes the sequence of ampl-commands in a file and invokes
      ampl [options] <name>.mod,

with prior exporting of the environment variable   
   export OPTIONS_IN=filename ;  (ksh)
or
   setenv options donlp2_options "<....your desired settings>" (csh)

or one invokes 
   ampl
and then types commands interactively. 

In order to use DONLP2 with ampl the options to be set are

option solver donlp2;
option donlp2_options "<.....your desired settings>";

donlp2_options are the following:

maxfwd   max vars in fwd automatic differentiation of common exprs (default 5)
tau0     sum of constraint violations allowed during iteration (default 1.d0)
del0     initially an inequality g is binding if g/max{1,||grad g||}<=del0 (defa
ult 1.d0)
epsx     required precision in primal solution (default 0.00001)
maxit    iteration limit (<= 4000)
nreset   allowed number of successive steps with insignificant changes in x or f
intakt   write iteration protocol also to stdout =0 off (default) =1 on
silent   write results and messages on special events to file *.pro and *.mes (d
efault =1: no)
outlev   composed from 4 bits:
         bit 1 ="0" means no output , "1" one line per step,
         bit 2 ="1" short iteration protocol
         bit 3 ="1" detailed iteration protocol (primal and dual sol's, stepsize
s etc.)
         bit 4 ="1" print also gradients and hessian estimate
prou     unit number for output protocol
meu      unit number for special events messages protocol
wantsol  solution report without -AMPL: 4 bit integer namely sum of
                1 ==> write .sol file
                2 ==> print primal variable values
                4 ==> print dual variable values
                8 ==> do not print solution message

For example, one may set
option donlp2_options "tau0=0.1 del0=0.1 silent=0 outlev=4 wantsol=7";

                ----------------------------------

Test example:  As an example the file weapon.mod from the models directory
was modified to the one stored in the directory test and the commands

     ampl
     model weapon.mod

were executed. As a result the ouput in weapon.out was printed to the
screen and the two files   XtmpXat1.MES  XtmpXat1.PRO  were generated.

                ----------------------------------

The entire set of problems in the directory models was run with the
exported option of intakt=1. The output is in the directory results.

                ----------------------------------

Further details about the use of DONLP2 with AMPL can be found in the
enclosed file donlp2_ampl.ps.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++