Chapter 21. Matlab Reference Manual

In this appendix, we describe all of the NetSolve calls that can be invoked from within Matlab. In the case of an error, all of these calls will print very simple and explicit error messages. The user should refer to Chapter 24 for a list of all possible NetSolve error messages.

>> netsolve

Prints to the screen the list of all problems that are available in the NetSolve system.

>> netsolve('<problem name>')

Prints all information available from Matlab about a specific problem.

>> netsolve('?')

Prints the list of all the agents and servers in the NetSolve system, that is, the NetSolve system containing the host whose name is in the environment variable NETSOLVE_AGENT.

>> [ ... ] = netsolve('<problem name>', ...)

Sends a blocking request to NetSolve. The left-hand side contains the output arguments. The right-hand side contains the problem name and the input arguments. The arguments are listed according to the problem description. Upon completion of this call, the output arguments contain the result of the computation.

>> [r] = netsolve_nb('send','<problem name>', ...)

Sends a non-blocking request to NetSolve. The right-hand side contains the keyword send, the problem name, and the list of input arguments. These arguments are listed according to the problem description. The left-hand side will contain a request handler upon completion of the call.

>> [ ... ] = netsolve_nb('wait',r)

Waits for a request's completion. The right-hand side contains the keyword wait and the request handler. The left-hand side contains the output arguments. These arguments are listed according to the problem description. Upon completion of this call, the output arguments contain the result of the computation.

>> [ status ] = netsolve_nb('probe',r)

Probes for a request completion. The right-hand side contains the keyword probe and the request handler. The left-hand side contains the output arguments. These arguments are listed according to the problem description. The right-hand side contains the keyword probe and the request handler. Upon completion of this call, the output arguments contain the result of the computation.

>> netsolve_nb('status')

Prints out the list of all the pending requests. This list contains estimated time of completion, the computational servers handling the requests and the current status. The status can be COMPLETED or RUNNING.

>> netsolve_err

Returns the error code of the most recently called NetSolve function.

>> netsolve_errmsg(e)

Returns a string containing the error message that corresponds to the error code passed as the argument.