User:Jcreer/SMS:TABS Troubleshooting for SMS 13.1

From XMS Wiki
< User:JcreerThis is the approved revision of this page, as well as being the most recent.
Jump to navigationJump to search

The TABS (GFGEN, RMA2, and RMA4) model executables are public domain models, but their source code and distribution are controlled by the US Army Corps of Engineers. When USACE compiled these models in the past, an expiration date was built in to the executables. The latest expiration date was November 2020. Versions of SMS that use these older executables will not run successfully.

With the release of SMS 13.1, newer TABS executables were added that do not have an expiration date.

When the latest models were released, there was a change to how these models receive information from the command line. There are a few options for resolving this issue:

  1. Use SMS 13.1 or later. The issue has been addressed in 13.1.6.
  2. If using a version of SMS prior to SMS 13.1, download the latest version of SMS to obtain the TABS model executables. Then run TABS interactively or use a custom batch file as described below.

Interactive Mode

Running the TABS model interactively requires exporting the TABS files from SMS then using the DOS prompt to run TABS outside of SMS.

When running GFGEN/RMA2 from a DOS prompt, type "?" after starting the programs to see a list of keyword commands. Then type in the individual file names as indicated.

Using a Batch File

Below is an example of creating a batch file using the St Mary tutorial.

GFGEN batch file example for the St Mary tutorial project "stmary_ready_gf.run".

GEOMETRY_INP stmary_ready.geo
GEOMETRY_FPL stmary_ready.otl
GEOMETRY_BIN stmary_ready.bin

RMA2 batch file example for the St Mary tutorial project "stmary_ready_rm.run".

R2_BC         stmary_ready.bc
R2_FRL        stmary_ready.ot2
GEOMETRY_BIN  stmary_ready.bin
R2_SOL        stmary_ready.sol

The batch files for the St Mary tutorial project would then look like the following:

  • For "gfgen.bat":
"C:\program files\sms 13.1 64-bit\mesa\models\TABS\gfgenv456.exe" < "stmary_ready_gf.run"
  • For "rma2.bat"
"C:\program files\sms 13.1 64-bit\mesa\models\TABS\rma2v458.exe" < "stmary_ready_rm.run"