maeOpenViolationDb

maeOpenViolationDb(
t_sessionName
t_testName
t_historyName
)
=> x_dbId / nil

Description

Opens a connection to the checks and asserts database for the given maestro cellview and returns a unique ID for the connection. You can use this ID to read or modify the database and its attached waiver SQL database using other SKILL functions. You must close this connection using maeCloseViolationDb to release the connection and complete the transactions on the database.

Ensure that the history is closed before you run this function.

Arguments

t_sessionName

Name of the ADE Explorer or ADE Assembler session.

t_testName

Name of the test for which the results are to be opened.

t_historyName

Name of the history or child history.

If a run saves child histories, specify the name of the child history to open results.

You can also use this argument to open the results of a history saved for a run in the run plan.

Value Returned

x_dbId	The ID of the open database connection is returned.
`nil`	The ID of the open database connection is not returned.

Examples

Opens a database, performs a task on it, and then closes it.

let( (dbId)
     dbId = maeOpenViolationDb( "fnxSession0" "demo_top:1" "Interactive.1")
     when( dbId != -1
          maeWaiveViolation( dbId ?objectName "I19.PMO" ?objectType "instance" ?checkerName "testLib/demo_top/Constr_3" ?analysisName "tran" ?comment "waiving")

          maeCloseViolationDb(dbId)
     )

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