Chapter 22. C Reference Manual

We describe here all of the possible calls to NetSolve from C. All of these calls return a NetSolve code status. The list of the possible code status is given in Chapter 24.

status = netsl("<problem name()>()", ...)

Sends a blocking request to NetSolve. netsl() takes as argument the name of the problem and the list of arguments in the calling sequence. See the section called What is the Calling Sequence? in Chapter 5 for a discussion about this calling sequence. It returns the NetSolve status code (integer status). If the call is successful, the result of the computation is stored in the output arguments. The output arguments are specified in the calling sequence.

status = netslnb("<problem name()>()", ...)

Sends a nonblocking request to NetSolve. netslnb() takes as argument the name of the problem, and the list of arguments in the calling sequence. See the section called What is the Calling Sequence? in Chapter 5 for a discussion about this calling sequence. It returns the NetSolve status code (integer status). If the call is successful, status contains the request handler.

status = netslwt(<request handler>)

Waits for a request completion. netslwt() takes as argument a request handler (an integer). If the call is successful, the result of the computation is stored in the output arguments. The output arguments are specified in the calling sequence during the call to netslnb().

status = netslpr(<request handler>)

Probes for a request completion. netslpr() takes as argument a request handler (an integer). If the call is successful, the result of the computation is stored in the output arguments. The output arguments are specified in the calling sequence during the call to netslnb().

netslerr(<error code>)

Displays an explicit error message given a NetSolve error code.

netslmajor("<major>")

Sets the way the user has stored her matrices (row- or column-wise). The argument can be "col" or "row". It is case-insensitive and in fact only the first character is used by NetSolve.