Walkthrough to Install and Operate the Hydrologic Evaluation of Landfill Performance
(HELP) Model v3.07
HELP v3.07 is a DOS executable program, meaning it does not run in a Windows or iOS
environment. The 16-bit program will not natively work with 64-bit systems (i.e., most Windows
7 and more recent systems). Therefore, a 3rd party emulator is required. This walkthrough will
describe how to use a DOS emulator to install the HELP model. HELP v3.07 will run natively on
32-bit systems, through the Windows Command line. For 32-bit systems, unzip the program and
double-click INSTALL.exe, following the walkthrough from Step 7. To check if your PC is 32
or 64-bit, navigate to the Start menu (may be a Windows icon), Click Computer, Click System
Properties (or similar). A window with your Windows Edition and System Information will
appear. System type will display either 32 or 64-bit Operating System.
If you have difficulties with installation of HELP, contact Thabet Tolaymat for troubleshooting:
tolavmat.thabet@epa.gov
Updates will be posted to:
https://www.epa.gov/land-research/hvdrologic-evaluation-landfill-performance-help-model
Instructions for software installation begin on the following page.
Instructions to load HELP after a successful installation begin on page 10.
Last updated: June 16, 2017
-------
Installing the HELP software
Step Image
Comments
No image
Download a copy of HELP v3.07 from
EPA's HELP model webpage. It is an
executable (.exe) in the form of a zip
folder (.zip).
No image
To operate HELP on a 64-bit system,
you must first download and install a
DOS emulator. Search "DOS
emulator" in your preferred search
engine and download the software of
your choosing. EPA cannot
recommend specific software. This
walkthrough uses the DOS emulator
DOSBox v0.74.
j ~ Computer ~ Local Disk (C:) ~ Users ~ Max ~ Downloads ~
I Open ~ Share with ~
* Name
] zHELP3P
. Misfits-Static Age
, LF Methane Emissions Paper
egroup
puter
:al Disk (C:)
ampbellsci
)B Mount
IELP3
itel
ogs
Jew Folder
erfLogs
rogram Files
Isers
Vindows
movable Disk
Open
Open in new window
Extract All...
7-Zip
Move to Dropbox
Open with.,.
Share with
Restore previous versions
Send to
Cut
Copy
Create shortcut
Delete
Rename
Properties
Navigate to your Downloads folder or
wherever the zipped HELP folder is
located.
The file is called: zHELP3P.zip
HELP v3.07 Walkthrough Revision 1
Page 2 of 13
-------
Step Image
Comments
Extract Compressed (Zipped) Folders
Select a Destination and Extract Files
Files will be extracted to this folder:
C:\HELP
m Show extracted files when complete
[ Extract | | Ca
Computer ~ Local Disk (C:) ~ HELP
j] Open
Organize ~
Favorites
H Desktop
£ Downloads
% Recent Places
Dropbox
Libraries
j Documents
Music
|g| Pictures
0 Videos
Homegroup
|flP Computer
Local Disk (C;)
mm Removable Disk (D:)
New folder
Name
I 111 zhelnln—
Open
Run as administrator
Troubleshoot compatibility
7-Zip
Restore previous v
Send to
Cut
Copy
Create shortcut
Delete
Rename
Properties
Right-click and Extract All.
For convenience, we are saving to the
C: drive in a new folder called
"HELP".
File path is C:\HELP\
NOTE: Some computers may have
administrator privileges that prevent
saving directly to the C: drive or other
locations. Find a suitable location for
these files.
Click Extract.
Navigate to C:\HELP
Right click on the Executable file
zhelp3p.
Right-click and Extract the files from
the EXE. Clicking Open on the EXE
in a 64-bit system will result in an
error message.
The HELP folder will populate with
several executables, folders, and
zipped folders.
§| Open
Computer ~ Local Disk (C:) ~ HELP I
P Computer
& Local Disk (CO
s Removable Disk (D:)
X EXAMPLES
Jj H3DOCPDF
Jy H3USEPDF
D INSTALL.BIN
A 3 INSTALL
Q IN STALL.FIL
S3 PKUNZIP
Q README,307
JUSOURCE
jj TAPE3A
[ | r TAPE3N
SI TESTMATH
Jy USER
JH USER87
J£ USERNO
Slzhelp3p
Date mod
11/1/1997
12/12/199
12/12/199
11/1/1997
11/1/1997
12/30/199
2/1/1993
11/1/1997
11/1/1997
8/24/1995
2/2/1998
4/10/1995
11/1/1997
11/1/1997
11/1/1997
10/31/201
Find the INSTALL executable.
Drag and drop INSTALL to the DOS
emulator desktop shortcut.
The emulator will be used to install
HELP files.
ITELP v3.07 Walkthrough Revision 1
Page 3 of 13
-------
Step Image
Comments
We will now go through the prompts
to install HELP.
There are many files which are
required for proper operation. Pay
careful attention to the prompts.
Generally, you will want to Type "y"
for yes. Starting with the first prompt:
Do you want to continue installation?
Typey
|U DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: INSTALL
1 cm I
For convenience, use the suggested
directory.
NOTE: This does not install files or
programs to C:\HELP3.
It will install to wherever in the C: drive
you have the INSTALL file.
In our case it is:
C:\HELP\HELP3
In your case it may be embedded within
several folders, e.g., C:\...\...\HELP3
Another NOTE: It is important to keep
track of where these files and folders are
located. To run the software later, you
will need to type the file path into the
user interface. It will not let you browse
for the folder (like most modern
programs do).
Press Enter
Uersion 3.07 1 November 1997
Install to drive C: in directory SHELP3
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
HELP v3.07 Walkthrough Revision 1
Page 4 of 13
-------
Step
mage
Comments
^ DOSBox 0.74, Cpu speed: BOOO cycles. Frameskip 0, Program: INSTALL J
I Typey
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Redaction Engin
Cincinnatij Ohio
:ering Laboratory
45Z68
10
Typey
Do you want to install the version that
requires a math coprocessor?
(The version requiring a math coprocessor
runs more than 10 times faster and uses
more precision in its computations than the
•version not requiring a math coprocessor.)
Enter Y for yes or N for no.
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45Z68
11
12
The test should be successful.
If not, there may be an issue with the
downloading process and the model
may not operate properly.
For installation troubleshooting,
contact Thabet Tolaymat:
tolaymat.thabet@epa.gov
If the test was successful,
Typey
If the test was not successful,
Type n
Was the test successful? If so, enter Y. _
If a 4001 error uas produced, enter N and the
no math coprocessor version will be installed.
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
HELP v3.07 Walkthrough Revision 1
Page 5 of 13
-------
Step
mage
Comments
13
^ DOSBox 0.74. Cpu speed: 3000 cycles, Frameskip 0, Program: PKUNZI^^B
Several files will then be inflated/
PKUNZIP (R) FAST! Extract Utility Uersion Z.04g 02-01-93
Copr. 1989-1993 PKWARE Inc. All Rights Reserved. Shareware Uersion
PKUNZIP Reg. U.S. Pat. and Tm. Off.
unzipped.
¦ 80486 CPU detected.
¦ EMS version 4.00 detected.
¦ XMS version 3.00 detected.
Searching ZIP: CvUSER.ZIP
Inflating: C:/HELP3/LIST.C0M
Inflating: C:/HELP3/H3L0G0.EXE
Inflating: C:/HELP3/CLIMHELP.HLP
Inflating: C:/HELP3/USE2TAGS.HLP
Inflating: C:/HELP3/CLIMTAGS.HLP
Inflating: C:/HELP3/MAINTAGS.HLP
Inflating: C:/HELP3/S01LTAGS.HLP
Inflating: C:/HELP3/USE1TAGS.HLP
Inflating: C:/HELP3/USE2HELP.HLP
Inflating: C:/HELP3/S0ILHELP.HLP
Inflating: C:/HELP3/USE1HELP.HLP
Press any key
14
DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: INSTALL^B
Although this information is optional,
we feel it is best to install default data.
¦¦¦¦¦
Do you want to install default
historical precipitation data?
(optional)
Enter Y for yes or N for no. _
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
Typey
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
15
§j| DOSBox 0.74, Cpu speed: 3000 cydes, Frameskip 0, Program: INSTALLS
Generations ago, people did hard math
by hand with pen and paper.
Do you want to install default
historical precipitation data?
(optional)
Do you want to install it on the hard disk?
Enter Y for yes or N for no.
Today, we can install vast quantities
of data on hard drives.
Typey
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
16
IHI DOSBox 0.74. Cpu speed: 3000 cycles, Frameskip 0, Program: INSTALL
Decades ago, computers used multiple
disks to perform computing tasks.
Programs were measured in kilobytes.
Please insert disk 2.
miaiHC |
Press the [Enter] key to continue._
Developed by
Environmental Laboratory
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
When was the last time you saw a
floppy disk?
All of the required files are contained
within the zip file.
Press Enter
HELP v3.07 Walkthrough Revision 1
Page 6 of 13
-------
In our case it is:
C :\HELP\HELP3\EXAMPLES
18
I DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0. Program: INSTALL!
Please insert disk 2.
Press the [Enter] key to continue._
Developed by
Env i r oilmen ta 1 Laboratory
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
Press Enter and let the credits roll...
19
Do you want to install the HELP Model source code?
(optional)
Enter Y for yes or N for no.
If yes, the files will be installed on your hard disk
in a subdirectory called C:\HELP3\S0URCE.
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
Typey
20
Please insert disk 2.
Press the [Enter! key to continue.
Developed by
Environmental Laboratory
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
Press Enter
HELP v3.07 Walkthrough Revision 1
Page 7 of 13
-------
Step
mage
21
Do you want to install the user guide and
engineering documentation? (optional)
Enter Y for yes or N for no.
If yes, the reports will be installed as
PDF files in subdirectory C:\HELP3SD0C.
Use Adobe Acrobat 3.0 Reader
to view and print the files.
| USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
22
Please insert disk 2.
Press the [Enter! key to continue
Developed by
Environments1 Laboratory
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
for
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
Comments
The User's Manual and Engineering
Documentation are now available
separately here:
https://nepis.epa.gov
The web documents are identical to
the installed copies.
Type y or n
Press Enter
23
| D0S8ox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: INSTALL J
Please insert disk 3.
Press the [Enter] key to continue.
Developed by
Environmental Laboratory
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
USEPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 45268
Press Enter
| DOSBox 0.74, Cpu speed; 3000 cycles, Frameskip 0, Program: 1NSTALLJ
•nlogic Evaluation of Landfill
Installation completed.
Type HELP3 at the DOS prompt
in C:\HELP3 subdirectory
to start the program.
Press [Enter] to end.
Uicksburg, Mississippi 39180-6199
Congratulations! You have mastered
the latest in 1980s technology
We can now run HELP.
Press Enter
To operate HELP immediately: The
emulator has the HELP directory
already mounted.
Type HELP3 in the command line.
HELP v3.07 Walkthrough Revision 1
Page 8 of 13
-------
Step Image Comments
25
fp DOSBox 0.74, Cpu speed: 3000 cycles, Frameskip 0, Program: HSLOGC^^B""
The image to the left should be
displayed.
Press any key to continue operation of
the HELP model.
1
Hydrologic Evaluation of Landfill Performance
-[ELF
Uersion 3.07 1 November 1997
Developed by
Env i ronmenta1 Laboratory
USAE Waterways Experiment Station
Uicksburg, Mississippi 39180-6199
If you close the emulator, your session
will end and HELP will close.
for
USEPA Risk Reduction Engineering Laboratory
Follow the instructions on the
following page to load HELP.
Press any key to continue...
HELP v3.07 Walkthrough Revision 1
Page 9 of 13
-------
Once HELP is installed you will
line. We will mount the C: drive
navigate to and run the program.
To am HELP after it is installed
use a DOS emulator to start the program using the command
(or whichever drive your folder is located in). Then we will
on your computer:
Step Image
:. C:\Desktop\HELP\HELP307
File Edit View Tools Help
Comments
Organize w Include in library »
Share with • New folder
k Favorite*
¦ Desktop
Name
Date modified
Type
HELP3
6/15/201711:08 AM
File folder
£ Downloads
% EXAMPtES-ZIP
13/1/1997 2:08 AM
WinZip File
Recent Places
H3DOCPDF21P
12/12/1997 2:48 PM
WinZip File
4 OneDrive - Environmental Prote
5. H3USEP0F.2P
12/12/1997 2*7 PM
WinZip File
References
_ 1NSTALL.BIN
110/1997 2.00 AM
BIN File
i. CHI-Analytical Data
§3 INSTAU.EXE
11/1/1997 2O0 AM
Application
i- Temporary HELP output dumps
INSTAU.F1L
12/30/1997 5:18 PM
FILFUe
S3 PKUN3P.EXE
2.1/1993 204 AM
Application
"jt Libraries
READMEJ07
11/1/1997 2.-00 AM
307 File
[3 Documents
5. S0URCE21P
11/1/1997 200 AM
WinZip Fil« !
t£* Music
% TAPE3A.2P
8/24/1995 309 PM
WinZip File
1„ Pictures
% TAPE3N.ZIP
2/2/19981:57 PM
WinZip File
¦Videos
S3 TESTMATH.EXE
4/10/199512:00 PM
Application
^.USERZIP
11/1/1997200 AM
WmZip File
Computer
X USERS7-ZIP
U/1/19S7 2.00 AM
WinZip File
OSDisk (C:)
X. USERNO.ZIP
11/1/1997 2O0 AM
WinZip File
First, navigate in Windows Explorer
(the folder system) to your HELP files.
In this example, the directory is on the
Desktop in a HELP parent folder >
HELP307 > HELP3 subfolder
Look to the left, if you see zip folders
and a HELP3 folder, you need to go
into that HELP3 folder.
Double-click the HELP3 folder.
» HELP ~ HELP307 » HELP3 »
-I'rll s<«.
File Edit View Tools Help
Organize » ^ Open Include in library »
Share with »
New folder
,r Favorites
*
Name
Date modified
Type
K Desktop
i, ANCHORAGE
6/15/201711:08 AM
File folder
4 Downloads
Jt BIGRAIN
3/6/2017137 PM
File folder
Recent Places
fa DOC
11/10/2016113 PM
File folder
OneOrive - Environmental Prote
,. EXAMPLES
12/29/201611:58 -
file folder
References
, FOURLAYER
3/13/20171003 AM
file folder
.. CHL-Analytkal Data
i MIN1LF
3/13/2017 £49 PM
File folder |
J
. Temporary HELP output dumps
RCRA
3/7/2017 2:39 PM
File folder
j, SANDIEGO
6/15/20171101 AM
File folder
Libraries
E
SOURCE
11/10/2016 U 3 PM
Ftte folder
[jJ Documents
. SPOKANE
6/14/201711:13 AM
Frte folder
Music
J, TRIALS
12/29/20161202 _
File folder
jltaj Pictures
ID ASaPREC.EXE
11/10/20161.12 PM
Application
9 Videos
0 ASC1SRAD.EXE
11/10/2016102 PM
Application
K2 ASCTTEMP.EXE
11/10/20161:12 PM
Application
'? Computer
gj CANPREC.EXE
11/10/20161:12 PM
Application
fa OSDisk IC.l
SH CANSRAD.FXf
11/10/7016 lil? PM
Aoollciiticn
Look for a SOURCE folder. Now we
are in the right location. This folder
(HELP3) is the folder we will point to
(mount) in the DOS emulator.
Note: You will not see all the other
folders. Those are created by the user.
The EXAMPLE folder has the example
files from the installation which may
be helpful.
DOC contains the user manual and
engineering document.
j* i. C:\Users mmmm . esktcp\HElP\HELP307\HELP3
le Edit View Took Help
rganize ~ ^ Open Include in library » Share with *
Name
if Favorites
¦ Desktop
£ Downloads
Recent Places
4 OneDrive - Environmental Prote
References
. CHL-Analytical Data
Temporary HELP output dumps
9 Libraries
0 Documents
Music
ife1 Pictures
9 Videos
!• Computer
OSDisk (C:)
fa ANCHORAGE
.. 6IGRAIN
J. DOC
EXAMPLES
fa FOURLAYER
j. M1N1LF
ik RCRA
fa SANOIEGO
, SOURCE
. SPOKANE
TRIALS
E3 ASQPREC.EXE
E ASGSRAD.EXE
£3 ASOTEMP.EXE
It! CANPREC.EXE
^ CANSRAD.EXE
Date modified
6/15/201711.-08 Af/
3/6/20171-37 PM
11/10/2016103 PV
12-/29/201611:58 ...
3/13/201710KJ3 Afc
3/13/2017 2:49 PM
3/7/2017 239 PM
6/15/20171101 M/
11/10/2016103 PM
6/14/20171103 AK-
12/29/201612.-02...
11/10/2016102 PM
11/10/2016102 PM
11/10/2016102 PM
11/10/20161:12 PM
11/10/2016 1:12 PM
Note the file path of this location by
clicking in the Explorer bar
(highlighted).
You will want to write it down as there
is not a simple way to copy/paste to the
emulator.
Note the EPA username has been
censored for security purposes.
HELP v3.07 Walkthrough Revision 1
Page 10 of 13
-------
Comments
Open your preferred DOS emulator.
The command line will read a virtual
drive (Z:\> or similar).
We will mount directly to the HELP
folder where all the HELP working
files are and where your data will be
saved.
In this example HELP is located on the
C: drive so we will mount the C: drive.
| DOSBox 0.74, Cpu speed- 3000 cycles. Frameslcip 0, Program; DOSBOX
Welcome to DOSBox SET BLASTER-A220 17 D1 H5 Tb
;:\>mount C: C:\users\desktop\help\lielp307\help3s
)irectory C:\users\desktop\help\help307\help3 doesn't exist.
?:\>mount C: C:\users\MHMvdesktop\help\help307shelp3
)riue C is mounted as local directory C:\users\^^^rtSMesktop\helpShel
To Activate the keymapper ctrl-Fl.
For more information read the README file in the DOSBox directc
KAUE FUN!
The DOSBox Team http://wuu.dosbox.com
Z:\>SET BLASTER=AZZ0 17 D1 H5 T6
Z:\>mo«nt C: C:\users\desktop\help\help307\help3\
Directory C:\usersSdesktopShclp\help307shelp3 doesn't exist.
Z:\>mount C: C ;SusersS^MMtiiMesktopShelpShelp30?Nhelp3
Drive C is mounted as local directory C:\users\riHBrtiKdesktop\h
Type:
Mount C: C:\[enter your file path here]
You cannot paste, so write carefully.
Press Enter.
If successful, the emulator will tell you
the C: drive has been mounted.
If the directory is incorrect, the
emulator will notify you. Look to the
left for an example.
We've mounted the C: drive directly to
the HELPS folder but the directory will
still be pointing to the Z: drive
Type: C:
Press Enter
The directory will now be pointing to
the C: drive.
IMPORTANT: The emulator displays
C:\ but really the drive is directly
pointing to the file path you specified.
So whenever you see C:\ in later in the
HELP program it is really to the
HELP3 folder.
HELP v3.07 Walkthrough Revision 1
Page 11 of 13
-------
Step Image
Comments
Q§j DOS8ox0.74, Cpu speed; 3000 cycles, Frames kip 0. Program: DOSBOX
;:\>help
If you want a list of all supported commands type help /all
=« short list of the most often used commands:
CD IR > Directory Uieu.
CCD > Displays/changes the current directory.
CCLS > Clear screen.
CCOPY > Copy files.
CDEL > Removes one or more files.
(EXIT > Exit from the shell.
CMD > Hake Directory.
CRD > Remove Directory.
CREH > Renames one or more files.
CTYPE > Display the contents of a text-file.
CUER > View and set the reported DOS version.
3 DOSBex 0.74, Cpu ipteA 3500 cydu, Framukip 0.. Program: H31060
•logic Evaluation <
0m Let's load the program.
You may be tempted to type HELP.
But that will give you the help menu
for the Emulator (of course).
With the C:\> directory mounted
Type HELP3
Press Enter
HELP is now loaded and ready for use!
HELP
UcrsJon 3.07 1 November 139?
Deue loped by
Environmental Laboratory
U8«E UtteruuiK E*|ir;rimrrnl. Stat.inn
Uicksbnr-g, Mississippi DOlOQ-klOO
US EPA Risk Reduction Engineering Laboratory
Cincinnati, Ohio 1'j2CfG
Press any key to continue...
One last quick note about functionality:
We recommend creating a new folder
for each HELP simulation in Windows
Explorer before you create new files in
HELP.
When you go to save the files in HELP,
because you mounted the C:\ drive
directly to the HELP3 folder, you don't
need to reenter the whole file path. Just
the new folder name.
C:\SANDffiGO in HELP
is really
d:\nsers\3esktop\...YHKI I' IIKI l'
-------
Step Image
Comments
10
| DOSBoxO.74, Cpu speed: 3000 cycles, Frameskip 0, Program: WEATHER
WEATHER DATA - FILE SAUING
SAUE
Y/N DIRECTORY—
5 C:\SandiegoS
Y C:\sandiego\
Y C:\sandiego\
I = II a II
PRECIPITATION Q C:\Sandiego\
TEMPERATURE Y C:Ssand iegoS
SOLAR RADIATION Y C:\sandiego\
EUAPOTRANSPIRATION Y C:\sandiego\
I
Enter names for files in uhich the weather data are to be sa«jed.
Fl=Info FZ=Help
F4 = List Files on Specified Directory
le PgDn=Proceed
¦ HELP307 ~ HELP3 I
File Edit View Tools Help
Include in library » Share with w
Favorites
¦ Desktop
£ Downloads
'Ml Recent Places
& OneDrive - Environmental Prote
l^i References
CHL-Analytical Data
Temporary HELP output du
@ DATA4.D4
® DATA7.D7
0 DATA10.D10
@ DATA11.D11
@ DATA13.D13
gj SAN10YR.OUT
Date modified
6/13/201711:55 Ah
6/13/201711:55 AN
6/13/2017 10:38 AN
6/13/201711:55 Ah
6/13/201711:55 AN
6/13/201711:58 Ah
Also, the print functionality within
HELP is not recommended for printing
the output files.
Locate the output file (*.OUT) and
open with your preferred text editor for
printing or saving as PDF.
You may want to resize the text for it
to display properly.
Questions can be directed to:
tolaymat.thabet@epa. gov
Happy HELPing!
HELP v3.07 Walkthrough Revision 1 Page 13 of 13
------- |