The -query argument specifies that the boolean value FALSE is returned when the file is not found instead of raising an error.
The optional error-msg argument adds this string to the default error message shown when the file is not found. It also suppresses the backtrace normally shown when an error is raised.
If filename starts with %simics%, the rest of the path is looked up first in the Simics project, and then in all configured Simics packages. For more information on the %simics% or %script% path markers, see the Simics User's Guide.