<h1>Introduction</h1>

<p>The intention of this guide is to get you using the VSWAP test suite as quickly as
possible. <br>
<br>
VSWAP is implemented as a set of files containing WAP origin content which resides on the
same server as this guide, so there are no downloads or compilations to execute. It
automatically executes sequences of tests to verify correct interoperability between WAP
gateways and client devices (either simulated or over the air). There are three major
steps to each test session: 

<ol>
  <li>Use a standard HTML browser to create and manage your tests on the VSWAP test suite
    origin server; </li>
  <li>Connect a WAP client via a WAP gateway into the same origin server to run the tests; </li>
  <li>Refresh the standard HTML browser on the VSWAP origin server to review or record your
    results </li>
</ol>

<h1>Your VSWAP Account</h1>

<p>You will need a username and password for the test suite. You can easily <b>Create a
New Account</b> from the VSWAP start page. </p>

<h1>Logging-in</h1>

<p>Each time you use the test system, you will be required to log in using your username
and password. Many clients remember authentication tokens for some indeterminate period of
time (e.g. for the life of the session). If your client is one of these, you may be asked
for a username and password only when you enter the system. For other implementations, you
may be asked more often. </p>

<h1>Creating a Test Session</h1>

<p>Test session <b>creation</b> can only be executed from your <b>HTML browser</b>. When
you select the <b>Manage Test Sessions</b> option of the main menu, you will be taken to
the <b>Test Session Management Menu for Account &lt;username&gt;</b>. From here you can: 

<ul>
  <li>Create a new custom <strong>Application </strong>test session. </li>
  <li>Create a new custom <strong>Protocol </strong>test session. </li>
</ul>

<p>When you create an <strong>Application </strong>test session this will take you to the <b>Customize
Test Session (session options)</b> page. From here: 

<ul>
  <li>Select the options and enter details applicable to your device and then click the <b>Finish</b>
    button. </li>
  <li>This will return to <b>Test Session Management Menu for Account &lt;username&gt;</b>,
    where a new test session will be found in the Session table </li>
  <li>Test ID's are numbered from 0001. You can also provide an arbitrary description for your
    test session. </li>
</ul>

<p>Once the test session is created, you can <a href?#MANAGESESSION?>manage the session,</a>
<a href="#REVIEWRESULTS">review
test results</a> and examine the test source for each test case in the session. You can
also <a
href="#EXECUTESESSION">execute
the test session</a> from a WML client. </p>

<p>When you create a <strong>Protocol </strong>test<strong> </strong>session, this will
take you to the <strong>Create Custom Protocol test session page</strong>. From here: 

<ul>
  <li>Select the options and enter details applicable&nbsp; to your device. </li>
  <li>Remember to enter a valid Gateway IP address and Client IP address/address ranges and
    click on the <strong>Create Session </strong>button. </li>
</ul>

<div>

<h1><strong>Passive Testing</strong></h1>

<p>For the Passive tests to execute, a log of protocol traffic needs to be
generated.&nbsp; For each <strong>Passive</strong> <strong>Protocol Test Session</strong>
created, an associated Application level Test Session is also created.&nbsp;</p>

<p>The Application level Test Session is comprised of <strong>WML, WMLScript</strong> and <strong>WMLScriptLib</strong>
automatic tests.&nbsp; To <strong>execute</strong> the Passive Protocol Test Session the <strong>Application
level Test Session</strong> must be executed first via your WAP Client. To execute a
Passive Protocol Test Session, you should click on the <strong>&quot;review&quot; </strong>option
in the main menu page.&nbsp;Then select a test to execute by clicking on the <strong>&quot;Execute
Test&quot;</strong> link.&nbsp; </p>

<p>VSWAP will then communicate with the Active Relay to start listening for traffic.&nbsp;
Once the Active Relay is setup and listening a page of instructions will be returned
indicating what actions you should take to execute the Application level Test Session that
will generate protocol traffic.&nbsp; Once the Application level Test Session has
completed a page will be returned to the WAP Client informing you that the session has
finished.&nbsp; VSWAP will then communicate again with the Active Relay to execute all the
tests in the test session that have a status of <strong>FAILED</strong> or <strong>INCONCLUSIVE</strong>
from the starting test. If the Automatic Application level Test Session fails on a
particular test then the link <strong>&quot;set the starting test&quot;</strong> can be
used to set the starting test of the Automatic Application level Test Session.&nbsp;You
should set the starting test to be after the test that is failling (the test that is
italized will indicate where the test session has got to).&nbsp; Once you have set the
starting test you should then go back to the WAP Client and re-execute the Application
level Test Session.&nbsp; The Acitve Relay will still be listening for traffic and will
just append to the Protocol log it already has.</p>

<h1><strong>Active Testing</strong></h1>

<p>To execute an <strong>Active Protocol Test Session</strong>, you should
click on the <strong>&quot;review&quot;</strong> option in the main menu page. Then select
a test to execute by clicking on the <strong>&quot;Execute Test&quot;</strong> link. Each
Active test requires 2 parts to execute, a pre-amble or setup stage whereby the WAP client
is brought to a known state ready for the test to begin, and an execution stage which is
when the actual test will occur. Once you have selected the <strong>&quot;Execute
Test&quot;</strong> link VSWAP will communicate with the Active Relay to being listening
for traffic. A page of instructions will be returned to the HTML browser which you should
follow to bring the WAP Client to a known pre-testing state. Once the WAP Client is in the
known pre-testing state you should press the <strong>&quot;Proceed to Test&quot;</strong>
button which will begin execution of the test, a page of instructions will be returned to
the HTML browser which you should follow to execute the Test.When the test has completed
you can move to the next test by selecting the <strong>&quot;Proceed to Next Test&quot;</strong>
link which will move you to the next <strong>Active test</strong> in the list of Active
Tests.</p>

<p>You can skip a particular Active Test by pressing the <strong>&quot;Skip Test&quot;</strong>
button at any time, this will cause a result of <strong>INCONCLUSIVE</strong> to be
recorded in the Test Session for that particular test, you will then be moved to the next
test in the list.</p>

<h1><strong>Protocol Testing Failures</strong></h1>

<p>It should be noted that if a Test result has been recorded as <strong>&quot;FAILED&quot;</strong>
then even if the test has a result of <strong>&quot;INCONCLUSIVE&quot;</strong> on the
next iteration it will <strong>NOT</strong> change the status. This is because <strong>&quot;INCONCLUSIVE</strong>&quot;
means that the particular PDU sequence that was looked for was not seen, which means that
the test was not executed fully.</p>

<h1><a name="MANAGESESSION">Managing your Test Sessions</a></h1>

<p>Test sessions can only be <b>managed</b> using your <b>HTML browser</b>. If you select
the <b>manage</b> option for a test session, you will be presented with a screen from
which you can choose to change the session description, delete the test session, clear the
results of the test session, or copy the test session (all tests or tests not passed) to a
new, blank test session. In a Protocol test session, there is an additional option to
Set/Modify the Gateway IP Address.</p>

<h1>Preparing a Test Session for execution</h1>

<p><strong>Application Test Session:</strong></p>

<p>Test session execution can only be <b>prepared</b> using your <b>HTML browser</b>. To
prepare a test session for execution, select the <b>review</b> option for the test session
you wish to test. This will take you to the <b>Summary of Test Session</b> page. Select
the <b>Set as Starting test</b> link next to the test from which point you wish your test
session to begin execution. (Note: if you do not select a starting test then execution
will begin with the first test in the test list) Test execution will automatically
sequence through the tests in the order they are listed in the summary table. <br>
<br>
Once test execution has commenced or completed you can view the test results by refreshing
the <b>Summary of Test Session</b> page. You can also scroll down the page to view the <b>Test
Session Configuration</b> and view the customised test session options used to create the
session. <br>
<br>
You can skip individual tests and re-execute those later, or re-execute individual tests
that failed (e.g. after repairing the implementation). </p>

<p><strong>Protocol Test Session:</strong></p>

<p>To prepare a test session for execution, select the <strong>review</strong> option for
the test sesion you wish to test. This will take you to the <strong>Summary of Test
Session</strong> page. Select the <strong>Execute Test</strong> link next to the test from
which point you wish your test session to begin execution.</p>

<p>&nbsp;</p>

<h1><a name="EXECUTESESSION">Executing your Tests</a></h1>

<p>Before running your test session, you must log in to the same origin server, but from a
<b>WAP client</b>, connected via a <b>WAP gateway</b>. 

<ul>
  <li><b>To test a WAP client</b>, you will need to know how to access a WAP gateway which you
    can rely on. </li>
  <li><b>To test a WAP gateway</b>, you will need access to a real or simulated WAP client
    which you can rely on. </li>
</ul>

<p>First enter the URL of the origin server test suite index page on the client device.
The WAP Test Suite home page should appear, displaying the version number. To execute a
test or begin an automatic test run, you select the <b>Run tests</b> link and a list of
test sessions is displayed. Select the test session which has been prepared for execution
and this will commence execution of the test run. Remember some tests will require manual
intervention in order to complete. </p>

<h1><a name="REVIEWRESULTS">Reviewing Test Results</a></h1>

<p>Once you have completed execution of one or more test sessions, you can review the
results via your <b>HTML browser</b> by refreshing the Summary of Test Session page. When
reviewing results, you have the following options: 

<ul>
  <li>You can review a summary of the results for a specific test session by refreshing the
    Summary of test session page. </li>
  <li>You can see the detailed results for a specific test session by selecting the view log
    info. </li>
</ul>

<p>Test results are posted as follows: 

<ul>
  <li>Total Test Count </li>
  <li>Number of Passed Tests </li>
  <li>Number of Failed Tests </li>
  <li>Number of Untested Tests/Number of Inconclusive Tests (Protocol sessions only) </li>
</ul>

<h1>Summary</h1>

<p>The Test System is designed for ease of use. While there are more options than those
described above, these are sufficient for getting started. There is nothing you could do
that would crash the system, so feel free to experiment with other options as you get
familiar with it. <br>
<br>
<br>
</p>

