IBM Visualization Data Explorer Programmer's Reference

17.7 Execution Control

These routines allow an application program to control the execution of an instance of Data Explorer (represented by *conn).

DXLError DXLEndExecution(DXLConnection *conn)

Terminates execution of a program running in Data Explorer. Returns OK or ERROR.

DXLError DXLEndExecuteOnChange(DXLConnection *conn)

Takes Data Explorer out of Execute on Change mode, but does not terminate the current execution.

DXLError DXLExecuteOnChange(DXLConnection *conn)

Puts Data Explorer into execute-on-change mode: the main macro reexecutes each time any of its inputs or referenced global variables changes value. Returns OK or ERROR.

DXLError DXLEndExecuteOnChange(DXLConnection *conn);

ends execute-on-change mode.

DXLError DXLExecuteOnce(DXLConnection *conn)

Initiates a single execution of the macro called main. Returns OK or ERROR.

DXLError DXLGetExecutionStatus(DXLConnection *conn, int *state)

Gets the execution status of Data Explorer. The parameter state is returned with a nonzero value if the executive is currently executing.

DXLError DXLSequencerCtl(DXLConnection *conn, DXLSequencerCtlEnum action)

Causes the specified action to occur. Valid arguments for action are:

SeqLoopOff
SeqLoopOn
SeqPalindromeOff
SeqPalindromeOn
SeqPause
SeqPlayBackward
SeqPlayForward
SeqStep
SeqStop

DXLError DXLSync(DXLConnection *conn)

Sends a message to the server and does not return until an acknowledgment is received. (This is a one-time synchronization. Compare with DXLSetSynchronization in 17.5 , "Initialization and Exit".

DXLError uiDXLSyncExecutive(DXLConnection *conn)

Sends a message through the user interface to the executive and does not return until the executive has acknowledged the message.

DXLError uiDXLSetRenderMode(DXLConnection *conn, char *title, int rmode)

lets you set the rendering mode of a window specified by title. The title of the window (accessible through the Image Name option in the Options pull-down menu of the Image window, the title parameter of the Image tool, or the where parameter of the Display module. rmode must be either 0 (for software) or 1 (for hardware).

DXLError uiDXLResetServer()

effectively does a "reset server". That is, it flushes the Data Explorer software cache.

DXLError exDXLExecuteOnceNamed(DXLConnection *conn, char *name);

DXLError exDXLExecuteOnceNamedWithArgs(DXLConnection *conn, char *name, . ..);

DXLError exDXLExecuteOnceNamedWithArgsV(DXLConnection *conn, char *name, char **args);

DXLError exDXLExecuteOnChangeNamed(DXLConnection *conn, char *name);

DXLError exDXLExecuteOnChangeNamedWithArgs(DXLConnection *conn, char *name, ...);

DXLError exDXLExecuteOnChangeNamedWithArgsV(DXLConnection *conn, char *name , char **args);

These routines, used ONLY when the application is connected directly to the Data Explorer executive, allow the application to execute macros by name. The application can cause the named macro to be executed once or to be executed whenever a macro global input changes (such as when a value is sent to a DXLInput or DXLInputNamed module). The macro may be given a NULL-terminated list of arguments (the ...WithArgs form) or a NULL-terminated vector of arguments (the ...WithArgsV form).

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]