4.2. Play Session Command

A previously recorded session file can be played in TurboGrid. To play a session file, select Session > Play Session from the main menu or click Play Session   on the toolbar. The Play Session File dialog box is displayed.

The commands listed in the selected session file are run. Existing objects with the same name as objects defined in the session file are replaced by those in the session file.

For any file specified in a state or session file, if the file cannot be found TurboGrid will automatically search the state or session file directory for a file of the same name. If this procedure fails, the current working directory will be searched. As a result, state and session files will not have to be edited to change the path when state, session and curve files are moved from one directory to another.


Note:  While recording a session file, any preference changes made using the Options dialog box (Edit > Options) are recorded. However, after playing back the session file, the preference changes generally affect the current session only and are not reflected in the Options dialog box.



Note:  A session file cannot be played if it contains the Undo command. To run a session file that contains the Undo command, edit the session file first to remove the command.



Note:  Since the Topology Set object is now suspended by default, session and state files from version 11 or earlier may not play or load correctly. To support older session and state files, the Play Session File and Load State File dialog boxes have an option named Unsuspend TOPOLOGY SET before loading. Selecting this option causes the Topology Set object to be unsuspended before playing/loading a session/state file. When starting TurboGrid from the command line, adding the command line parameter -u causes the Topology Set object to be initially unsuspended.



Note:  Workbench journal files for TurboGrid and TurboGrid session files from 12.0/12.1 may not work with 14.0. If the recorded file does not explicitly set the topology type, the following CCL block must be added:

TOPOLOGY SET:
ATM Topology Optimizer = off
END

For Workbench journal files, this CCL block should be added immediately before the following line occurs:

> um mode=normal, object=/TOPOLOGY SET

The line above appears only in journal files that were recorded while the Topology Set object was processed (unsuspended).

For session files, this CCL block should be added to the beginning of the session file.


For information about using Workbench journaling and scripting with TurboGrid, see Using Ansys Workbench Journaling and Scripting with TurboSystem in the TurboSystem User's Guide.