simRunNetAndSimWithArgs

simRunNetAndSimWithArgs( 
t_libName | nil
t_cellName | nil
t_viewName | nil
t_simulatorName | nil
g_doNetlist
g_doSimulation
g_runBackground
x_jobPriority
) 
=> t / nil 

Description

Starts an analysis job in either foreground or background mode.

The simulation environment must be initialized before the simRunNetAndSim function is called. Specifically, you must call the simInitEnv or simInitEnvWithArgs function before calling simRunNetAndSim. The simRunDir global variable specifies the current run directory. It is set when the simulation environment is initialized.

Arguments

t_libName	The name of the library containing the top-level cellview of the design to be analyzed.
t_cellName	The cell name of the top-level cellview of the design to be analyzed.
t_viewName	The view name of the top-level cellview of the design to be analyzed.
t_simulatorName
	The name of the simulator that runs the analysis.
g_doNetlist	Boolean value, which if set to t, the netlist for the design is generated.
g_doSimulation	Boolean value, which if set to t, the design is simulated. The simulator and the name translation functions are invoked. This invokes the same steps and functions as the sim function.
g_runBackground
	Boolean value, which if set to t, the background process invokes the bin/si program to perform the simulation.
x_jobPriority	Priority of the background job (0 to 20). This is the UNIX priority that invokes the process; therefore, the lower the number, the higher the priority.

The t_libName, t_cellName, t_viewName, and t_simulatorName arguments overwrite the corresponding simulation environment variables. Specifying these arguments redefines the global environment and changes the values in the simulation run directory. If you want to use the current global environment, use nil as the value for these parameters. The arguments are processed according to the following rules:

• If t_libName is not nil, assign it to the simLibName environment variable.
• If t_simulatorName is not nil, assign it to the simSimulator environment variable.
• If t_cellName or t_viewName are not nil, assign them to the simCellName and simViewName environment variables, respectively.

Therefore, the t_libName argument must not be nil if the t_cellName and/or t_viewName arguments are used (not nil).

Value Returned

t	The background process was successfully invoked. If the analysis is run in the foreground, t is returned if the analysis completed. A return value of t does not necessarily mean that the analysis was completed successfully.
nil	The background process or foreground analysis failed.

Examples

simRunNetAndSimWithArgs( "myLib" "fast_mux"
"schematic" "spice" t t t 10)
   simRunNetAndSimWithArgs( nil nil nil nil
   t t t 10)

Related Topics

OSS Functions

Return to top