Product Documentation
Virtuoso ADE SKILL Reference
Product Version IC23.1, November 2023

maeOpenSetup

maeOpenSetup(
t_libName
t_cellName
t_viewName
[ ?application t_applicationName ]
[ ?histName t_historyName ]
[ ?mode t_mode ]
)
=> t_sessionName / nil

Description

Loads the given cellview and restores the setup details from the specified history. If no history name is specified, the active setup is loaded. If the specified view is already opened in the current Virtuoso session, it is not opened again. However, if the view is already open in some other Virtuoso session, it is opened in read mode in the current session. If the given cellview does not exist, the function creates a new cellview with the same name.

If you make changes after opening a setup, it is recommended to use the maeSaveSetup function to save those changes.

Arguments

t_libName

Name of the library.

t_cellName

Name of the cell.

t_viewName

Name of the view.

?application t_applicationName

Specifies whether to open the setup in ADE Assembler.

Set this argument to Assembler when you need to open a single test environment in ADE Assembler to use the features specific to this product.

This argument is not required to open a test in ADE Explorer.

?histName t_historyName

Name of the history to be restored. If not given, the active setup is loaded.

?mode t_mode

Mode in which the maestro view is to be opened

  • a: Opens the maestro view in append mode. This is the default.
  • r: Opens the maestro view in read mode.
You cannot create a new view in read mode. If you are creating a new view, set this argument to "a".

Value Returned

t_sessionName

The setup is successfully loaded

nil

The setup is not loaded.

Examples

Loads the active setup of solutions/amptest/maestro in append mode.

maeOpenSetup("solutions" "amptest" "maestro")

Loads the active setup of solutions/amptest/maestro in append mode in ADE Assembler.

maeOpenSetup("solutions" "amptest" "maestro" ?application "Assembler")

Loads the setup of the history Interactive.5 for solutions/amptest/maestro in append mode.

maeOpenSetup("solutions" "amptest" "maestro" ?histName "Interactive.5")

Loads the setup of Interactive.5 history for solutions/amptest/maestro in read-only mode.

maeOpenSetup("solutions" "amptest" "maestro" ?histname "Interactive.5" ?mode "r")

Related Topics

maeSaveSetup


Return to top
 ⠀
X