GUI Server File

When you start System Coupling in GUI Server mode — whether started from the GUI or from the command line with the --guiserver argument — it writes a System Coupling GUI Server file (sycGui.srv) is written to its working directory.

System Coupling writes the server port and host information to the GUI Server file in the following format, where "12345" is the server port and "0.0.0.0" is the host information. This information is used to connect/reconnect an instance of the System Coupling GUI to the running solution.

Figure 46: Example GUI Server file


guiserver=12345@0.0.0.0 


An instance of System Coupling started in GUI Server mode can be connected to only one GUI at a time. The GUI Server file remains in the working directory while System Coupling is running there, preventing additional instances of the System Coupling GUI from connecting with the active coupling session.

When System Coupling exits, whether naturally (for example, due to solve or script completion or because of an Abort or Interrupt operation) or unnaturally (for example, as the result of a handled exception), the GUI Server file is removed from the working directory.


Important:  The GUI Server file should not be removed manually unless System Coupling was terminated unexpectedly and cleanup is required. For details on handling this scenario, see Known Issues and Limitations.