3.2.7. Read Session Files

>readsession [filename=<filename>]

The >readsession command performs session file reading and executing.

<readsession supports the following options:

  • filename = <filename>

    Specifies the filename and path to the session file that should be read and executed. If no filename is specified, the SESSION singleton object indicates the file to use. If no SESSION singleton exists, an error is raised indicating that a filename must be specified.

3.2.7.1. readsession Command Examples

The following are example >readsession commands, and the expected results. If a SESSION singleton exists, the values of the parameters listed after the >readsession command replace the values stored in the SESSION singleton object. For this command, the filename command parameter value replaces the session filename parameter value in the SESSION singleton.

> readsession

This command reads the session file specified in the SESSION singleton, and executes its contents. If the SESSION object does not exist, an error is raised indicating that a filename must be specified.

> readsession filename = mysession.tse

This command reads and executes the contents of the mysession.tse file.