A P P E N D I X A |
Adapting the WMA Test Emulator |
This appendix describes how to adapt the emulator side of the Java Device Test Suite Wireless Messaging API (WMA) tests to your test device. This adaptation is required to run Cell Broadcast Short Message Service (CBS) tests.
The appendix consists of these sections:
Some of the WMA tests are network tests (see Writing Network Tests). These tests have two parts. The device part exercises WMA interfaces on the test device. The emulator part coordinates with the device-resident part, sending, receiving, and analyzing test messages as needed.
For CBS tests, the emulator part is called a CBS Server. It is called to send a valid CBS message to the test device.
CODE EXAMPLE A-1 shows the CBSServer interface.
TABLE A-1 specifies the semantics of a CBSServer implementation.
Deploying the Implementation |
1. Compile the implementation.
The following shows one simple way to compile. Other ways might also be valid.
2. Put the compiled files into a JAR file.
% jar cvf CBSImplJar CBSImplClass
You can use more than one JAR file.
3. Use the administrator edition of the harness to create a section containing the WMA test pack.
The online help describes how to create and configure a template.
4. Connect the test device to the harness host.
The Java Device Test Suite Tester’s Guide describes how to connect test devices and how to launch and use the harness.
6. Open the Configuration Editor and go to the WMA section created in Step 3, and select the WMA test pack.
7. Answer the corresponding questions to set the following properties for the CBS Server of the WMA test pack in the template.
a. Set ServerImplJarLocation to the absolute path name of the JAR file or files created in Step 2.
Where the ServerImplJarLocation property value contains more than one JAR file path, the paths must be semicolon separated.
b. Set CBSServerImpl to the full class name (including package name) of the CBSServer implementation class.
8. In the harness, open the Test Server Monitor to see diagnostic messages from the WMA test emulator.