The JWaveExecute class provides client access to a JWAVE wrapper function on the server. JWaveExecute methods are used to set the name of the JWAVE wrapper, to set the parameters sent to that wrapper, to set the return parameter mode, and to retrieve data returned from the JWAVE wrapper. The execute method sends the parameters that were set (with setParam methods) to the wrapper, causes the wrapper to execute, and retrieves any returned data.

You can construct a JWaveExecute object simply by giving the JWAVE wrapper name:

JWaveExecute(String wrappername) 

This command automatically connects the JWaveExecute object to a new PV‑WAVE session. That is, a new JWaveConnection object is created automatically.

If you already have a JWaveConnection object that refers to an existing PV‑WAVE session, then you can construct a JWaveExecute object to use that same connection. For example:

JWaveExecute(JWaveConnection connection, String name) 

Usually, you use this constructor when there are several JWaveExecute objects that need to use the same PV‑WAVE session (in other words, they need to share data), or if you want to set particular attributes of the connection (such as data compression or a session pinger).

The following method creates a JWaveConnection object:

static JWaveConnection.getConnection()

or:

JWaveExecute.getConnection()

For detailed information on JWaveExecute and JWaveConnection classes, refer to the online Javadoc reference. For information on using Javadoc, see "Using the JWAVE Javadoc Reference". See also "Managing the Server Connection" for information on the JWaveConnection class.