<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html xmlns:mml = "http://www.w3.org/1998/Math/MathML" lang = "en"><head><meta charset = "UTF-8"/><meta name = "copyright" content = "(C) Copyright 2020"/><meta name = "DC.rights.owner" content = "(C) Copyright 2020"/><meta name = "DC.type" content = "concept"/><meta name = "abstract" content = "The complete program is controlled by a system of variables. To allow user and model-specific variations, the necessary variables are loaded from several configuration files."/><meta name = "description" content = "The complete program is controlled by a system of variables. To allow user and model-specific variations, the necessary variables are loaded from several configuration files."/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-c-usr-control-configuration"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>Configuration</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-c-usr-control-configuration">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>Configuration</h1></td></tr><tr><td class = "DocHeader4" colspan = "2"/></tr><tr><td class = "DocHeader3" colspan = "2"><table class = "DocThemeIntro" id = "table12"><tr><td class = "Intro1Only"><p class = "header"><p class = "abstract">
<span class = "shortdesc">
The complete program is controlled by a system of variables. To allow user
and model-specific variations, the necessary variables are loaded from several
configuration files.
</span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-c-usr-control-configuration__tso-c-user-control-ways-of-configuration" id = "toc_rg" title = "">Ways to Configure <span class = "ph">Tosca Structure</span></a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-user-control-configuration-hierarchy" id = "toc_rg" title = "">Configuration Hierarchy</a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-user-control-configuration-files" id = "toc_rg" title = "">Configuration Files</a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf" id = "toc_rg" title = "">Static Configuration</a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-usr-control-tp-config-ConfSect" id = "toc_rg" title = "">DRIVER-Command</a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar" id = "toc_rg" title = "">Environment Variables</a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-user-control-configuration-remarks" id = "toc_rg" title = "">Remarks</a></li><li><a href = "#tso-c-usr-control-configuration__tso-c-user-control-configuration-uncpath" id = "toc_rg" title = "">UNC Paths</a></li></ul>
</p></td></tr></table></td></tr></table>





<div class = "body conbody">
<div class = "section" id = "tso-c-usr-control-configuration__tso-c-user-control-ways-of-configuration"><h2 class = "title sectiontitle">Ways to Configure <span class = "ph">Tosca Structure</span></h2>

<p>There are several ways to configure <span class = "ph">Tosca Structure</span>.
Options can be set in a file called <code class = "ph codeph">tosca.cfg</code>, in the <code class = "ph codeph">DRIVER</code> command section of a parameter file or directly on the command line of
<code class = "ph codeph">tosca</code>.
Multiple versions of <code class = "ph codeph">tosca.cfg</code> can contribute to the final configuration. The default (system-wide) settings can be found in
<code class = "ph codeph"><span class = "ph">&lt;install_dir&gt;/&lt;os&gt;</span>/SMATsoResources/config/tosca.cfg</code>.
If <span class = "ph">Tosca Structure</span> finds files named <code class = "ph codeph">tosca.cfg</code>
in the user's root directory or in the input directory, the included settings are loaded in the order presented below. The underlying concept is that more general (global)
settings can always be overwritten by local ones.</p>

</div>



<div class = "section" id = "tso-c-usr-control-configuration__tso-c-user-control-configuration-hierarchy"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Configuration Hierarchy</h2>

<p>The configuration files are loaded in the following sequence:</p>

<table class = "table"><caption/><colgroup><col/></colgroup><tbody class = "tbody">
<tr class = "row">
<td class = "entry">
<br/><img class = "image" src = "../TsoUserImages/usr_control_102.png" width = "700"/><br/>
</td>
</tr>
</tbody></table>

</div>


<div class = "section" id = "tso-c-usr-control-configuration__tso-c-user-control-configuration-files"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Configuration Files</h2>

<p>The control script does not explicitly require a configuration file.
There are several configuration steps, none of which is mandatory.</p>
<p>
<ol class = "ol">
<li class = "li">Static configuration with .cfg files located on the hard-drive</li>
<li class = "li">DRIVER command in the parameter file</li>
<li class = "li">Environment variables</li>
<li class = "li">Command line</li>
</ol>
</p>
<p>The system will search and execute configuration files first, then the
<a class = "xref" href = "../TsoCmdMap/tso-m-cmd-driver-sb.htm#tso-m-cmd-driver-sb" title = "The DRIVER commands are used to set and overwrite a subset of the SIMULIA Tosca Structure 2023 configuration parameters. Different configuration files (installation, user-defined) can be overridden for the specific job where the command is found.">DRIVER-command</a>, etc.
Any of the steps can be omitted or appear more than once.</p>
<p>The configuration file and <a class = "xref" href = "../TsoCmdMap/tso-m-cmd-driver-sb.htm#tso-m-cmd-driver-sb" title = "The DRIVER commands are used to set and overwrite a subset of the SIMULIA Tosca Structure 2023 configuration parameters. Different configuration files (installation, user-defined) can be overridden for the specific job where the command is found.">DRIVER-command</a>
share the same syntax.</p>

</div>


<div class = "section" id = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Static Configuration</h2>

<p>The system will search for static configuration files in the
following directories, and execute the file if it exists.</p>

<table class = "table"><caption/><colgroup><col style = "width:50%"/><col style = "width:50%"/></colgroup><thead class = "thead">
<tr class = "row">
<th class = "entry" id = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__1"><span class = "ph">Linux</span></th>
<th class = "entry" id = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__2"><span class = "ph">Windows</span></th>
</tr>
</thead><tbody class = "tbody">
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__1">${tosca}/SMATsoResources/tosca.cfg</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__2">%tosca%\SMATsoResources\tosca.cfg</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__1">${tosca}/linux_a64/SMATsoResources/tosca.cfg</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__2">%tosca%\win_b64\SMATsoResources\tosca.cfg</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__1">${CATInstallPath}/SMATsoResources/tosca.cfg</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__2">%CATInstallPath%\SMATsoResources\tosca.cfg</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__1">${HOME}/tosca.cfg</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__2">%HOME%\tosca.cfg</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__1">&lt;Input_dir&gt;/tosca.cfg</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-staticConf__entry__2">&lt;Input_dir&gt;\tosca.cfg</td>
</tr>
</tbody></table>

<p>where:</p>
<p>
<ul class = "ul">
<li class = "li"><code class = "ph codeph">&lt;Input_dir&gt;</code> - the directory where the job is started from (where the
            parameter file is located).</li>
<li class = "li"><code class = "ph codeph">CATInstallPath</code> might consist of more than one
directory. The list is unfolded so every entry is a separate search
directory.</li>
</ul>
</p>
</div>

<div class = "section" id = "tso-c-usr-control-configuration__tso-c-usr-control-tp-config-ConfSect"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">DRIVER-Command</h2>

<p>Refer to the <a class = "xref" href = "../TsoCmdMap/tso-m-cmd-driver-sb.htm#tso-m-cmd-driver-sb" title = "The DRIVER commands are used to set and overwrite a subset of the SIMULIA Tosca Structure 2023 configuration parameters. Different configuration files (installation, user-defined) can be overridden for the specific job where the command is found.">DRIVER-command</a>
documentation for a detailed description of its features.</p>
</div>


<div class = "section" id = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Environment Variables</h2>

<p><span class = "ph">Tosca Structure</span> 
uses and sets several environment variables during the optimization.
Some can be configured by the user (either in the installation process,
directly using standard operating system procedures or with <span class = "ph">Tosca Structure</span> configuration files). Internal
variables cannot (should not) be set or changed manually.</p>
<p>Most of the variables have a value of either 0 or 1, meaning whether
it is ON or OFF. To enable the feature it controls set it to 1
(ON), to disable - either omit the definition of the variable, or set it to 0 (OFF).</p>

<table class = "table"><caption/><colgroup><col style = "width:28.57142857142857%"/><col style = "width:42.857142857142854%"/><col style = "width:28.57142857142857%"/></colgroup><thead class = "thead">
<tr class = "row">
<th class = "entry" id = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">Environment variable</th>
<th class = "entry" id = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">Set by default</th>
<th class = "entry" id = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3">Usage</th>
</tr>
</thead><tbody class = "tbody">
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_ABAQUS_PATH=&lt;path_to_exe&gt;</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p><span class = "ph">Abaqus</span> path. 
                         The same variable is used with <span class = "ph">Tosca Structure</span>. It is
                         equivalent to $fe_solver_exe.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_ANSYS_PATH=&lt;path_to_exe&gt;</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p><span class = "ph">ANSYS®</span> path. 
                         The same variable is used with <span class = "ph">Tosca Structure</span>. It is
                         equivalent to $fe_solver_exe.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_MSCNASTRAN_PATH=&lt;path_to_exe&gt;</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p><span class = "ph">MSC Nastran®</span> path. 
                         The same variable is used with <span class = "ph">Tosca Structure</span>. It is equivalent to $fe_solver_exe.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_FESAFE_PATH=&lt;path_to_exe&gt;</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p><span class = "ph">fe-safe</span>
                         path. The same variable is used with <span class = "ph">Tosca Structure</span>. It is equivalent to $life_solver_exe.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">ABA_NO_SITE_JOB_COMPLETION=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">YES</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used to skip some post completion check from <span class = "ph">Abaqus</span>,
                         which makes the <span class = "ph">Abaqus</span> run faster.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">ABA_TOSCA_PROTOTYPE=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">YES</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used to activate specific features in <span class = "ph">Abaqus</span> 
                         to make it possible to work with the 
						 <span class = "ph">Tosca Python</span> driver.</p>
                      <div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">Set internally by the driver. Relevant only for simultaneous mode.</span></div>
</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">ABA_TOSCA_OVERLAY=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">YES</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Abaqus</span>
                         to overwrite the ODB file with each design cycle, instead of appending frames to a single file.</p> 
                      <div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">Set internally by the driver. Relevant only for simultaneous mode.</span></div>
</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">ABA_TOSCA_STALL=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Abaqus</span> to be held in-memory while
                         running the <span class = "ph">Tosca</span> optimization module.</p>
                      <div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">Set internally by the driver. Relevant only for simultaneous mode.</span></div>
</td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">ABA_TOSCA_JOB_STALL=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">YES</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Abaqus</span> 
                         to be held in-memory while running the <span class = "ph">Tosca</span> 
	                     optimization module. Allows more than one instance.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">ABA_ALLOW_NFORC=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">YES</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Abaqus</span>
                         to allow writing of internal forces for connector elements.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_POST_REPORT=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Tosca Python</span> 
                         Driver to enable/disable the <span class = "ph">Tosca Structure.report</span> 
	                     postprocessing tool at the end of the job.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_POST_SMOOTH=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Tosca Python</span>
                         Driver to enable/disable the <span class = "ph">Tosca Structure.smooth</span> 
                         postprocessing tool at the end of the job.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_POST_ONF2SIM=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Tosca Python</span>
                         Driver to enable/disable the Onf2Sim post-processing tool at the end of the job.</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_ABAQUS_DIAGNOSTICS=1</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used by <span class = "ph">Tosca Python</span> Driver
                         to enable archiving of solver diagnostic files (SAVE.msg, SAVE.dat, and SAVE.sta).</p></td>
</tr>
<tr class = "row">
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__1">SMA_TSO_ABAQUS_DIAGNOSTICS=2</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__2">NO</td>
<td class = "entry" headers = "tso-c-usr-control-configuration__tso-c-user-control-tr-config-envvar__entry__3"><p>Used to append the stderr output stream from the solver to TOSCA.OUT.</p></td>
</tr>
</tbody></table>
</div>


<div class = "section" id = "tso-c-usr-control-configuration__tso-c-user-control-configuration-remarks"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Remarks</h2>

<ul class = "ul">
<li class = "li">All options configurable through the <code class = "ph codeph">DRIVER</code> commands are also configurable in <code class = "ph codeph">tosca.cfg</code> files, see
<a class = "xref" href = "../TsoCmdMap/tso-r-cmd-driver-cfgDriverProp.htm#tso-r-cmd-driver-cfgDriverProp" title = "This section provides a reference of all possible driver-statement properties that are configurable through the DRIVER command.">Configurable Driver commands</a>
for details.</li>
<li class = "li">Settings can always be overwritten by an equal assignment on a configuration down the line of the execution order.</li>
<li class = "li">The syntax for <code class = "ph codeph">tosca.cfg</code> files and any <code class = "ph codeph">DRIVER</code> command is python
<span class = "ph">3.7.1</span>.</li>
</ul>
</div>


<div class = "section" id = "tso-c-usr-control-configuration__tso-c-user-control-configuration-uncpath"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">UNC Paths</h2>

<p>Whenever you must provide a path in one of the configuration files, you might use UNC paths. But be careful to use forward slashes "<code class = "ph codeph">/</code>" instead of backward slashes.
Example:
<pre class = "codeblock">
<code class = "ph codeph">
//server_resource/folder/executable
</code>
</pre>
</p>
</div>

</div>


</td></tr></table><script type = "text/javascript" src = "../DSDocUI_Bottom34.js">/* */</script></body>
</html>
