# IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

## 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).

[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

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

[IBM Home Page | Order | Search | Contact IBM | Legal ]