<agent_handle>.run <agent_handle>.status
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<agent_handle>.run-until-job

Synopsis

<agent_handle>.run-until-job [-capture] [job-id]

Description

Run the simulation until commands that are already posted on this agent_handle object have completed, and then stop the simulation. If the simulation is not running, this command will start it.

A command posted on an agent handle is given an integer ID which is unique per handle. With the job-id argument, specify a command that must have completed before the simulation is stopped. Without argument, this command will run the simulation until all commands have completed, those which were posted on this handle before this command.

If the -capture flag was specified together with the job-id argument, then any captured output from that job will be returned from this command or printed. Note that the captured output will be discarded afterwards.

Queued commands are run sequentially, meaning that the next command will start once the previous has completed. Thus, all commands that were posted before the specified argument are guaranteed to have completed successfully.

If an error occurs, the execution is stopped and all pending commands that were posted on this handle are discarded, and the error is reported.

Notice: This command is not intended for script-branches.

Provided By

matic

See Also

<agent_handle>.wait-for-job
<agent_handle>.run <agent_handle>.status