Jolt 1.2 Developer's Guide

When allocating a VIEW, your application specifies a buffer type of VIEW and a subtype that matches the name of the view (the name that appears
in the view description file). Since the NonStop
TM
TUXEDO run-time system can determine the space needed based on the structure size, your
application need not provide a buffer length. The run-time system can also automatically take care of things, like computing how much data to send
in a request or response, and handle encoding and decoding when the message transfers between different machine types.
The following examples show the use of the VIEW buffer type with a Jolt client and its server-side application. The example consists of three parts:
The simpview.java Jolt client that contains the code used to connect to NonStop
TM
TUXEDO and uses the VIEW buffer type●
The simpview.v16 file that contains the NonStop
TM
TUXEDO VIEW field definitions●
The simpview.c code sample containing the server side C code for handling the input from the Jolt client.●
The Jolt client treats a null character in a VIEW buffer string format as an end-of-line character and truncates any part of the string that follows the
null.
simpview.java Client Code
Example 6-7 illustrates how Jolt works with a service whose buffer type is VIEW. The client code is identical to the code used for accessing an
FML service.
The code in the following listing does not catch any exceptions. Since all Jolt exceptions are derived from java.lang.RunTimeException, the Java
Virtual Machine (VM) will catch these exceptions if the application does not. (A well-written application would catch these exceptions, and take
appropriate actions.)
Before running Example 6-7, you need to add the VIEW service to the SIMPAPP package using the Jolt Repository Editor and write the simpview.c
NonStop
TM
TUXEDO application. This service takes the data from the client VIEW buffer, creates a new buffer and passes it back to the client as a
new VIEW buffer. The following example assumes that a session object was already instantiated.
Example 6-7. simpview.java Source Code