engOpenSingleUse (MATLAB Application Program Interface)

Start a MATLAB engine session for single, nonshared use

C Syntax

#include "engine.h"
Engine *engOpenSingleUse(const char *startcmd, void *dcom, 
      int *retstatus);

Arguments

startcmd

String to start MATLAB process.

dcom
Reserved for future use; must be NULL.

retstatus
Return status; possible cause of failure.

Note: On Windows, the startcmd string must be NULL.

Description

(Windows) This routine allows you to start multiple MATLAB processes for the purpose of using MATLAB as a computational engine. engOpenSingleUse starts a MATLAB process, establishes a connection, and returns a unique engine identifier, or NULL if the open fails. engOpenSingleUse starts a new MATLAB process each time it is called.

engOpenSingleUse opens an ActiveX channel to MATLAB. This starts the MATLAB that was registered during installation. If you did not register during installation, on the command line you can enter the command:

matlab /regserver

engOpenSingleUse allows single-use instances of an ActiveX MATLAB engine server. engOpenSingleUse differs from engOpen, which allows multiple users to use the same ActiveX MATLAB engine server.

See "MATLAB ActiveX Integration" in the Application Program Interface Guide for additional details.

(UNIX) This routine is not supported and simply returns.

[ Previous | Help Desk | Next ]