<html>
  <head>
    <meta http-equiv='Content-Type' content='text/html; charset=UTF-8'>
    <title>Service Documentation</title>
  </head>
  <body>
    <h1>VenueServer</h1>
    A venue server maintains the following internal state:
    <ul>
      <li>List of venues</li>
      <li>List of administrator DNs</li>
      <li>List of per-venue services:
        <ul>
          <li>Persistent storage</li>
          <li>Multicast address allocation</li>
        </ul>
      </li>
    </ul>
    <h2>Operation <b>GetEntryVenue()</b>
    </h2>
      Returns the Venue Description for the default venue that a client 
      of this venue server should visit.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td><i>Returned value</i></td>
          <td>VenueDescription</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>GetVenueList()</b>
    </h2>
      Return the list of venue descriptions for all venues 
      hosted by this server.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td><i>Returned value</i></td>
          <td>VenueDescriptionSequence</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>CreateVenue()</b>
    </h2>
      Create a new and unpopulated venue. Return the service handle
      to this venue.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td><i>Returned value</i></td>
          <td>URIType</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>AddAdministrator(operatorDN)</b>
    </h2>
      Add the given DN to the list of administrators for this venue server.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td>operatorDN</td>
          <td>string</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>RemoveAdministrator(operatorDN)</b>
    </h2>
      Remove the given DN from the list of administrators for 
      this venue server.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td>operatorDN</td>
          <td>string</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>AddService(service)</b>
    </h2>
      Add the given service to the list of venue server-based
      services.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td>service</td>
          <td>ServiceDescription</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>RemoveService(service)</b>
    </h2>
      Remove the given service from the list of venue server-based
      services.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td>service</td>
          <td>ServiceDescription</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>ModifyService(service)</b>
    </h2>
      Modify the given service. Ivan - what exactly does this mean?
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td>service</td>
          <td>ServiceDescription</td>
          <td></td>
        </tr>
      </table>
    </p>
    <h2>Operation <b>RegisterServer(registryURL)</b>
    </h2>
      Register this venue server with a (more) global server
      registry.
    <p>
      <table border='1'>
        <tr>
          <th>Argument</th>
          <th>Type</th>
          <th>Documentation</th>
        </tr>
        <tr>
          <td>registryURL</td>
          <td>URIType</td>
          <td></td>
        </tr>
      </table>
    </p>
  </body>
</html>