axlGetToolSession

axlGetToolSession(
t_sessionName
t_testName
[ ?history x_history ]
) 
=> g_sessionID / nil

Description

ADE Explorer or ADE Assembler internally maintains a unique in-memory identifier for each active test. This function returns that unique identifier for the specified test.

You can use the session identifier to directly modify variables for a test in the session. For example, you can modify the temperature value for a test.

Arguments

t_sessionName	Name of the ADE session.
t_testName	Name of the test.
?history x_history
	ID of the history. Use this argument when you want to work on the given history run of the test. This history must be opened before using this function. If the specified history is not open, axlGetToolSession returns nil. To open a history, use axlViewHistoryResults.

Value Returned

g_sessionID	Returns a unique in-memory ID.
nil	Unsuccessful operation.

Examples

Adds a model library file and section for a test in an ADE Assembler session. The script gets access to the test session identifier, testsess, by using the axlGetToolSession function. It further uses testsess to remove all the model library selections for that test and adds new model file sections.

session=axlGetWindowSession()
=> "session1"
x_mainSDB=axlGetMainSetupDB(session)
=> 1001
t1= axlGetTests(x_mainSDB)
=> (1015 
("AC" "TRAN")
)
testsess=axlGetToolSession(session "AC")
=> sevSession1
testsess=asiGetSession(testsess)
=> stdobj@0x19827c6c
asiAddModelLibSelection(testsess "models/spectre/gpdk045/gpdk045.scs" "NN")
=> t

Uses the history for a particular test to get access to the unique identifier for a test in that history. You can use this identifier to further work with the OASIS session.

axlsession=axlGetWindowSession( hiGetCurrentWindow()) 
=> "session0"
testnames = (cadr (axlGetTests (axlGetMainSetupDB axlsession)))
=> ("ACGainBW" "PSR" "SlewRate" "CMRR" "Offset")
x_mainSDB=axlGetMainSetupDB(axlsession)
=> 2808
historyNames = (axlGetHistory x_mainSDB)
=> (2852 
("Interactive.1" "Interactive.2" "Interactive.3" "Interactive.4" "Interactive.5")

)
firsthistory = axlGetHistoryEntry(x_mainSDB caadr(historyNames))
=> 2853
(axlGetToolSession(axlsession (car testnames) ?history firsthistory)
=> sevSession1

Return to top