axlGetEnabledGlobalVarPerTest

axlGetEnabledGlobalVarPerTest( 
x_hsdb
t_varName
t_test 
) 
=> t / nil 

Description

Returns the status of a global variable for the given test. When a global variable is overridden for a test, this function returns nil, which implies that the value of the global variable will not be considered for the test. Instead, the test will use a local value set for that variable.

For example, in the figure shown below, the function will return nil for IREF because the global variable is not enabled or used for the test.

The function does not determine whether point sweeps or variables are enabled for simulation runs. Use the following functions for such cases:

• Use axlGetAllVarsDisabled to find if the variables are enabled for the simulation run. This function returns the status of the Global Variables check box in the Data View pane.
• Use axlGetAllSweepsEnabled to find if the sweep points are enabled for the simulation run. This function returns the status of the Point Sweep check box in the Run Summary pane.
• Use axlGetEnabled to find if a specific variable is enabled.

Arguments

x_hsdb	Handle to the main setup database.
t_varName	Name of the global variable.
t_test	Name of the test.

Value Returned

t	The global variable is enabled for the given test.
nil	Unsuccessful operation.

Examples

The following example returns the status of the global variables VDD and IREF for the test ACGainBW when the setup is as shown in the example figure shown above:

s1 = axlGetWindowSession(hiGetCurrentWindow())
x_mainSDB=axlGetMainSetupDB(s1)
=> 1001
axlGetEnabledGlobalVarPerTest(x_mainSDB "VDD" "ACGainBW")
=>t
axlGetEnabledGlobalVarPerTest(x_mainSDB "IREF" "ACGainBW")
=> nil

Related Topics

axlSetDesignVariablePerTest

Working with Tests

Return to top