SYSTEM versus MODEL(SYSTEM)

Tekla Structures 2026 - 2018
Environment
Not environment-specific
Question:

Can you explain what exactly is the difference in editing XS_FIRM value in Advanced Option dialog box and use SYSTEM vs. MODEL(SYSTEM)?

Answer:

MODEL(SYSTEM) = model-specific value that is stored to options.ini in model folder. Value can be same as in system level or it can be different. Selecting this option makes sure that when you need to send your multi-user or single-user model to a different user or organization, the value is delivered with the model. In model sharing this type of advanced option work differently, each sharing user can have different value, because this is set only locally and not transferred to other sharing users in write out or in read in. See example of this in the following article: Model sharing and firm folder

SYSTEM= value is read from system-level ini files, such as from teklastructures.ini, env_xx.ini, role_xx.ini. Note that the value is not written to options.ini, options_model.db, or options_drawing.db files in model folder, which means that the value is not delivered with the model if you need to send it to another user in another organization.

Following example explains how it works if I have added a setting XS_FIRM=C:\COMPANY_STUFF\ into role_all.ini.

  • When I open my model, the type is SYSTEM and the value is C:\COMPANY_STUFF\ meaning that system value is read from role_all.ini.

  • When I change the type from SYSTEM to MODEL(SYSTEM) and save & reopen the model, the system value (XS_FIRM=C:\COMPANY_STUFF\) is written to options.ini in model folder.

  • When I type in C:\temp\ as a value, the type remains as MODEL(SYSTEM). When I save & reopen the model, this model-specific value  XS_FIRM=C:\temp\ is written to options.ini in model folder.

  • When I have the type as MODEL(SYSTEM) and the value C:\temp\ and then I change type to SYSTEM, save & reopen the model, the XS_FIRM setting is totally removed from options.ini in model folder. So I can revert to using the system-level value C:\COMPANY_STUFF\.

Was this helpful?
Submit