MATLAB^®

engOpenSingleUse (C) - Start 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. On Microsoft Windows systems, the startcmd string must be NULL.
dcom: Reserved for future use; must be NULL.
retstatus: Return status; possible cause of failure.

Returns

Microsoft Windows Operating Systems Only

A pointer to an engine handle or NULL if the open fails.

UNIX^[1] Operating Systems

This routine is not supported on UNIX systems and simply returns.

Description

This routine allows you to start multiple MATLAB processes for the purpose of using MATLAB software 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 a COM channel to MATLAB. This starts the MATLAB software 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 a engine server. engOpenSingleUse differs from engOpen, which allows multiple users to use the same engine server.

See Introducing MATLAB COM Integration for additional details.

^[1]UNIX is a registered trademark of The Open Group in the United States and other countries.

engOpen (C and Fortran)

engOutputBuffer (C and Fortran)