This page will look better in a graphical browser that supports web standards, but is accessible to any browser or internet device.

-->

Installing JSim under Microsoft Windows

Windows 2000 and Windows XP:

  1. Download a copy of the latest public release ( 1.6.81 ) or the latest beta release ( 1.6.83 ) of the JSim zip archive for Windows.
    • Internet Explorer(IE) users have sometimes noted that JSim download hang for several minutes at 99% complete. This appears to be a bug in IE. Our experience is that, if the user is patient, the download completes successfully after about five minutes.
    • Due to IE's continual problems with security and conformance with WWW standards, we recommend using browsers such as Firefox or Opera instead of IE.
  2. Unpack the .zip file using the ZIP utility of your choice in a directory of your choice.
  3. Inside that directory, in the sub-directory win32\bin are three executable batch files:

    jsim.bat : the JSim GUI application;

    jsbatch.bat : the JSim text-based batch application.

    jsreg.bat : add JSim settings to the Windows registry (for 1.6.26 and later, see below)

    You may wish to make an short-cut to jsim.bat on your Desktop, or other convenient location. jsbatch.bat is useful only from the Windows command prompt.

  4. Note that NSR has tested JSim only on Windows XP, although it should work on Windows 2000 as well.
  5. Most users do not require the command-line utility jsbatch.bat, which requires some additional setup. If you do, do the following (familiarity with .bat files and the DOS command line is assumed): Modify the PATH environment variable to include the directory containing jsim.bat and jsbatch.bat. Also, modify the JSIMHOME definition in jsbatch.bat to the the device:directory you have chosen for your JSim installation.
  6. See advanced administration for additional information, as needed.

Windows 95 and Windows 98

NSR does not officially support JSim under Windows 95 or Windows 98, and cannot accept bug reports on these platforms. Nevertheless, it has been reported to us that users can achieve some JSim functionality on these platforms with the following modifications to the jsim.bat and jsbatch.bat scripts:

  1. Right-click on the file icon, and then click Edit.
  2. Replace the line

    if not defined JSIMHOME set JSIMHOME=..\..

    by the line

    if "%JSIMHOME%"=="" set JSIMHOME=..\..

  3. In the line starting with set PATH=, replace %PATH% by "%PATH%"
  4. In the last line, replace %* by %1 %2 %3 %4 %5 %6 %6 %8 %9
  5. From the File menu, select Save, then Exit.
  6. Right-click the file icon, and then click Properties.
  7. Click the Memory tab.
  8. In the Initial environment box, type 4096.
  9. Click OK.

Note that the number of command line switches is limited to a maximum of 9.

If you wish to use jsreg.bat (details below), you must make some modifications:

  1. The reg.exe version is the distribution does not work for Windows 98. The one that should be used is on a CD called Windows 98 Resource Kit, sales of which have been discontinued. Good luck!
  2. Replace %~d0%~p0\..\.. by the absolute path to the installation directory (the one enclosing the win32 directory). This syntax is not supported by Windows 98.

Using jsreg.bat

jsreg.bat adds settings to the Windows Registry that allows you to open .proj, .mod, .tac and .jsml files within JSim by double-clicking on their icons in Windows Explorer. These settings can cause problems for other programs in your system if they expect to open files with those same extensions. Conversely, the opening of files with those extensions within JSim can be impaired by other programs. This regrettable situation is unavoidable given the design of Windows, and is made worse by Microsoft refusing to give information to developers (outside of Redmond) as to how exactly the registry works. Therefore, you may need to muck with your registry a bit manually to get things just right. jsreg.bat is written so you can examine what is being done, and modify it if you are so inclined. If you relocate JSim on your system, rerunning jsreg.bat will repoint the registry appropriately.

jsreg.bat is a new feature for release 1.6.26. It was not available in earlier releases. At this time, it has only been tested under Windows 2000. Users with Registry expertise on other Windows variants are invited to contact the JSim team with required modifications for those platforms.

[This page was last modified 04Mar08, 3:27 pm.]

Model development and archiving support at physiome.org provided by the following grants: NIH/NHLBI T15 HL88516-01 Modeling for Heart, Lung and Blood: From Cell to Organ, 4/1/07-3/31/11; NSF BES-0506477 Adaptive Multi-Scale Model Simulation, 8/15/05-7/31/08; NIH/NHLBI R01 HL073598 Core 3: 3D Imaging and Computer Modeling of the Respiratory Tract, 9/1/04-8/31/09; as well as prior support from NIH/NCRR P41 RR01243 Simulation Resource in Circulatory Mass Transport and Exchange, 12/1/1980-11/30/01 and NIH/NIBIB R01 EB001973 JSim: A Simulation Analysis Platform, 3/1/02-2/28/07.