Preface ixHow to Use This Manual ix
Server-Side Developers x
Client-Side Developers x
System Managers and Webmasters x
What's in this Manual xi
Technical Support xii
FAX and E-mail Inquiries xiii
Electronic Services xiv
JWAVE System Introduction 1The Client Side 7
The Server Side 9
The JWAVE Manager 10
PV-WAVE Sessions 11
JWAVE Wrappers 11
PV-WAVE Applications 11
A Simple Example 12
The Client Java Application 12
The JWAVE Wrapper Function 15
Running the Application 17
Sample Output 18
Summary 18
The Generic JWAVE Applet 19Simple Applet Example 19
The HTML Code 20
The JWAVE Wrapper Function 22
Example Summary 22
Using JavaScript to Control the Applet 22
The HTML File with JavaScript 23
The JWAVE Wrapper 26
Running the Applet Demonstrations 28
Summary 30
JWAVE Client Development 31JWAVE Client Overview 31
The JWaveExecute Class 32
Passing Parameters from the Client 33
Getting Data Back from the Server 35
Casting Returned Data 35
The Exception Classes 38
Managing the Server Connection 38
Compressing Data 38
Ending a JWAVE Session 39
Using Multiple Clients 39
Using Ping Methods 39
Example: Passing an Array 40
A Note About Data Proxies 42
Using the JWAVE Javadoc Reference 42
Summary 43
JWAVE Graphics 45Returning Graphics to the Client 45
The JWaveView Class 45
Sample Code 46
Example: Displaying a Simple 2D Plot 47
Resizing Graphics 51
Coordinate System Transformations 51
Demonstration Programs 52
Summary 52
JWAVE Server Development 53JWAVE Server Overview 53
Writing JWAVE Wrapper Functions 54
Example: Simple JWAVE Wrapper 54
Wrapper Functions Must Be Compiled 56
Using GETPARAM to Unpack Parameters 56
What Do You Want To Unpack? 57
Unpacking Values 57
Unpacking Command Strings 59
Building a PV-WAVE EXECUTE Command 61
Unpacking Color Data 62
Returning Multiple Results to the Client 62
Returning Graphical Data to the Client 63
Example: A Typical JWAVE Wrapper 64
Unpacking the Parameters 66
Unpacking Color Information with GET_NAMED_COLOR 69
The RETURN Statement 69
You Can Only Retrieve Parameters Once 70
Error Handling 70
Using the MESSAGE Procedure 70
Trapping Errors 70
Using the Expect Keywords 71
Testing Wrapper Functions 72
Testing a Numerical Program 72
Testing a Graphics Program 73
Summary 74
Managing Data 75What is a JWAVE Data Proxy 76
Instantiating a JWaveDataProxy Object 77
Other Ways to Instantiate a JWaveDataProxy Object 77
The Efficiency of Using Data Proxies 78
Inefficient System: The Data Makes Two Round Trips 78
Efficient System: No Round Trips 79
Setting the Return Parameter Mode 80
Example: Using Data Proxies 80
Data Proxies Are Controlled by the Client 84
How Long is Proxy Data Stored on the Server 85
Summary 85
Using JWAVE Beans 87Using JWAVE Beans with the BeanBox 87
Building a JWAVE Bean 92
Deciding What the Bean Will Do 93
Adding Properties to the Bean 93
Handling Data 95
Telling a Bean Environment How to Use Your Bean 100
Building a Customizer for the Bean 109
Adding Serializability to the Bean 111
JWAVE Server Configuration 113Installation Overview 113
Client-Side after JWAVE Installation 114
Server-Side after JWAVE Installation 114
Additional Software Requirements 115
Running and Testing the JWAVE Server 115
Setting Up the JWAVE Server 118
Using the JWAVE Manager 118
JWAVE Server Options 120
Configuring the JWAVE Manager 122
Using the JWAVE Configuration Tool 124
Installing the JWAVE Manager as a Service on Windows NT 134
Testing the JWAVE Server Installation 137
Scalar Data Test 138
Array Data Test 138
Return Mode Test 138
View Test 138
Running JWAVE Demonstrations 139
Setting Up for JWAVE Client Development 139
JWAVE Wrapper API A-1DMCopyData Procedure A-1
DMDataExists Function A-2
DMEnumerateData Function A-3
DMGetData Function A-4
DMInit Procedure A-5
DMRemoveData Procedure A-5
DMRenameData Procedure A-6
DMRestore Procedure A-7
DMSave Procedure A-8
DMStoreData Procedure A-9
GETPARAM Function A-10
GET_NAMED_COLOR Function A-16
UPDATE_LOG Procedure A-21
WRAPPER_TEST_EXECUTE Procedure A-22
WRAPPER_TEST_GETRETURN Function A-23
WRAPPER_TEST_INIT Procedure A-24
WRAPPER_TEST_RETURN_INFO Procedure A-26
WRAPPER_TEST_SETCOLOR Procedure A-27
WRAPPER_TEST_SETPARAM Procedure A-28
JWAVE Convenience Wrappers B-1JWAVE_BAR3D Function B-2
JWAVE_CONTOUR Function B-3
JWAVE_HISTOGRAM Function B-6
JWAVE_LOADCT Procedure B-8
JWAVE_PIE Function B-10
JWAVE_PLOT Function B-12
JWAVE_SURFACE Function B-15
Keyword and Named Color Parameters C-1Using These Parameters C-1
Keyword Parameters C-2
Named Color Parameters C-18
Named ColorSet Parameters C-19
HTTP Configuration File D-1General Parameters D-2
Directory Mapping D-2
Mime Types Mapping D-3
JWAVE Bean Tools Reference E-1JWAVE Bar3d Tool E-2
JWAVE Contour Tool E-3
JWAVE Generic Tool E-6
JWAVE Histogram Tool E-7
JWAVE Pie Tool E-8
JWAVE Plot Tool E-10
JWAVE Surface Tool E-13
Glossary F-1
