WIMS-D Library Updating Under DOS on PC

1. Background
=============
The task of updating the library includes the following steps:
Set the subdirectories and download the files.
Prepare program executable code.
Generate the cross sections for all materials with NJOY.
Update the library using WILLIE.
Run the benchmark test cases.


2. Download the files
=====================
If necessary, create the following subdirectories on the default "WLUP"
directory:
- programs
- inputs
- wimslib
- work
- dosmat

Download DCKSPL.FOR, FOR.SRC and BAT.SRC to the programs subdirectory.
Compile and link DCKSPL.FOR and run it on FOR.SRC and BAT.SRC given the
corresponding file names and the extensions FOR and BAT respectively. Input
instructions for DCKSPL are included as comment on the FORTRAN source file.
Prepare the executables for all WLUP codes on the programs subdirectory.
Note that readme.for and readme.bat are just readme text files.
Revise and set up the SETWLUP.BAT procedure according to your computer.
FORTRAN codes and BATCH procedure are heavily commented for the users.

Download DOP.SRC, NJI.SRC, REF.SRC, WGX.SRC, WIN.SRC, WLI.SRC to the inputs
subdirectory. Split NJI.SRC and WLI.SRC using DCKSPL. Extensions NJI and WLI
should be used respectively.
Download MISCINP.ZIP to the inputs subdirectory and unzip the file.

Download DOSMAT.ZIP to the dosmat subdirectory and unzip the file. If you want
to generate all dosimetry files from new evaluated data read carefully the
file readmedm.txt on dosmat subdirectory and check the wlupdosm.bat on the
programs subdirectory. It is not usually the case and unzipping DOSMAT.ZIP is
enough for WIMS library updating.


3. Additional requirements
===========================
The selected evaluated nuclear data libraries should be assembled and copied
on to the input subdirectory. Further, the original WIMS-86 library in
ASCII form should be copied as Wdn29.asc on the wimslib subdirectory.

Versions of the codes NJOY-99 and WIMSD5B should be available, including
the WLUP updates.


4. Updating the library
=======================
Copy the batch procedure RUNALL.BAT to your work directory. Read the comment
part and execute it with the appropriate input parameters.This procedure
allows either partial update runs or a complete library update (see comments
in the source). By specifying the source evaluated library name (e.g. "jef22",
"endfb6", etc.) a complete library update is performed automatically,
including the execution of the test cases. The updated library and the results
summary file are copied to the \wlup\wimslib\ directory. Comments included on
RUNALL.BAT are given below:
-----------------------------------------------------------------------------

       NJOY PROCESSING FOR WLUP
       ------------------------

       Processing option [lbl] : %1
       Processing name   [nme] : %2
       Processing eaf    [eaf] : %3
       Processing groups [ngr] : %4

Version:
V 2001/01 Upgrade related to JENDL-3.2 (C.S.Gil)
V 2001/06 Include fiss.yield and lumped fission product data.
V         Extensions for 172-group library preparation.
V 2001/09 Extension for updating dosimetry reactions (D.L.Aldama)
V 2001/11 Add "IAEA" to the library list (A.Trkov)
V 2002/04 Add supplementary benchmarks.
V         Split individual WIMS inputs from a merged file to the
V         local directory.
V 2002/08 Simplify testing for 69/172 group cases (A.Trkov).
V 2003/05 Print parameters from command line to output.

Description:
A complete update of the WIMS-D library is performed. If the source
library is specified as the first parameter, the final WIMS-D library
files are saved to the "wimslib" directory and benchmark test cases
are executed.

Instructions:
1. Run the WLUP settings procedure SETWLUP.
2. Copy the "runall.bat" batch file to the local directory.
3. Run "runall" with optional parameters.
   The first parameter may be used to select the processing step.
   The second parameter options depend on the processing step,
   selected with the first parameter.
   For the list of settings and options see "Usage" below.

In case of input errors print user instructions

 Usage: Runall [lbl] [nme] [eaf] [ngr]
        lbl - option label to identify the processing step (default all)
        nme - specific NJOY input to be generated (default all),
              applicable only with "njoyinp" option, OR
            - library name for which the full update is requested,
              applicable with the "library", the "bnchmrk" option.
              and the "dosmat" option
        eaf - INTER output filename (default: "eaf97" with implied
              extension ".int"), with the "library" option  OR
            - Number of energy groups (ngr) with the "dosmat" option
        ngr - number of groups for the WIMS-D library (default: 69,
              valid entries: 69 or 172), applicable with the "library"
              option only (see below).

        List of valid labels [lbl]:
            library  - Perform a full library update (execute all options
                       below) for the library defined with the
                       "nme" parameter.
            njoyinp  - Generate NJOY inputs.
                       The additional parameter "nme" (when specified)
                       implies the name of the nuclide to be processed as
                       appears in the master input file (case sensitive).
                       It must match the name in the comment preceeding
                       actual input commands and is of the form:
                       "-- Ssaaax" where "Ss" is the chemical symbol
                       (use underscore on the second place for single
                       character symbols), "aaa" is three-digit mass
                       number (left-padded with zeroes, if necessary)
                       and "x" is the type designator (s for
                       structural materials, g, m or h for general
                       materials, etc.).
                     NOTE: Make sure that the following files are present
                     from a previous run or by copying manually to the
                     working directory:
                         Tape20
                         Tape30
                         WLUPNJI.INP
            primmat  - Primary reactor materials.
                     NOTE: same as for the "njoyinp" option.
            fisprod  - Fission products.
                     NOTE: same as for the "njoyinp" option.
            majactn  - Remaining major Actinides.
                     NOTE: same as for the "njoyinp" option.
            minactn  - Minor Actinides.
                     NOTE: same as for the "njoyinp" option.
            absorbr  - Absorber materials.
                     NOTE: same as for the "njoyinp" option.
            structr  - Structural materials.
                     NOTE: same as for the "njoyinp" option.
            modertr  - Other moderators.
                     NOTE: same as for the "njoyinp" option.
            varmatr  - Various other materials.
                     NOTE: same as for the "njoyinp" option.
            fisspct  - Mix fission spectrum contributions.
                     NOTE: the following processed files must
                     be available:
                         U_235g.XSP
                         U_238g.XSP
                         Pu239g.XSP
            wimslib  - Update the library.
                     NOTE: the following files must be available:
                         WLUPWLI.INP input for WILLIE.
                         WDN29.ASC   source WIMS-D library to be updated.
                         pfp4902.xsw pseudo fission product cross
                                     sections file.
            dosmat  - Update a WIMSD Library with the dosimetry material
                      files availables on the "wlupd" directory
                    Parameters:
                    "nme" defines the name of the library:
                          "nme".lib    for the 69-group library or
                          "nme"gx.lib  for the 172-group library.
                          When updating the dosimetry materials it is
                          assumed that the formatted library with the
                          above defined name is available in the "wimslib"
                          directory.
                    "eaf" not used (dummby parameter, must be present)
                    "ngr" number of energy groups (69 or 172).
            bnchmrk  - Run all benchmark test cases for the library
                       defined by the "nme" parameter.
                     NOTE: the binary library defined by the
                       "nme" parameter must be available in the
                       "wimslib" directory.

        Examples of "nme" parameter used with the "library" option
        defining library names for a full library update:
            endfb6   - ENDF/B-VI             brond2   - BROND-2.2
            jef22    - JEF-2.2               jeff3t   - JEFF-3T
            jendl3   - JENDL-3.2             iaea     - WLUP selection
            cendl2   - CENLDL-2.2
        NOTE: for a 172-group library the "gx" string
              is appended to the name automatically.


5. Examples
===========

runall library iaea   eaf99 69   >iaea.log
runall library endfb6 eaf99 172  >endfb6172.log
runall bnchmrk iaea   eaf99 69

Zipped WIMS libraries generated from different evaluated nuclear data
files, are available on the CD-ROM and WLUP webpage. The iaea and the
iaeagx files contain the 69- and 172-group recommended libraries. Libraries
can be converted to WIMS binary format using the code WILLIE.