engOpen (Fortran)

StartMATLABengine session

expand all in page

Fortran Syntax

#include "engine.h" mwPointer engOpen(startcmd) character*(*) startcmd

Description

engOpenstarts a MATLAB^®process for using MATLAB as a computational engine.

WindowsPlatforms

engOpenlaunches MATLAB without a desktop. The function opens a COM channel to MATLAB. The MATLAB software you registered during installation starts. If you did not register during installation, then seeRegister MATLAB as a COM Server.

UNIXPlatforms

On UNIX^®systems,engOpen:

Creates two pipes.
Forks a new process. Sets up the pipes to passstdinandstdoutfrom MATLAB (parent) software to two file descriptors in the engine program (child).
Executes a command to run MATLAB software (rshfor remote execution).

Input Arguments

expand all

`startcmd`— MATLAB startup command
`character()`|`NULL`

MATLAB startup command, specified ascharacter*(*).

On Windows^®systems, thestartcmdstring must beNULL.

On UNIX systems:

IfstartcmdisNULLor the empty string, thenengOpenstarts a MATLAB process on the current host using the commandmatlab. Ifstartcmdis ahostname, thenengOpenstarts a MATLAB process on the designated host by embedding the specifiedhostnamestring into the larger string:
```
"rsh hostname \"/bin/csh -c 'setenv DISPLAY\ hostname:0; matlab'\""
```
Ifstartcmdis any other string (has white space in it, or nonalphanumeric characters), then MATLAB executes the string literally.