Sedna LogoBackground Top
 
Home  |  Getting Started  |  Documentation  |  Demo  |  Download  |  Support 

3.3 Session Options

Since version 3.0 of the Sedna Client-Server protocol it is possible to set session options.

There are a number of session options. Session options can be set at any moment during the session except the period when session is in a query evaluation phase (executing or passing result data to a client).

To set one or more options client must send se_SetSessionOptions message. If options were set successfully server sends se_SetSessionOptionsOk message to the client. Otherwise server sends se_ErrorResponse to the client.

To reset options to their default values client must send se_ResetSessionOptions. If options were reset successfully server sends se_ResetSessionOptionsOk message to the client. Otherwise server sends se_ErrorResponse to the client.

The possible instructions from client are:

  • se_SetSessionOptions. The body contains any number of pairs: option id followed by option value. Option id is int, option value is string.
  • se_ResetSessionOptions. Does not contain a body.

The possible instructions from the server are:

  • se_SetSessionOptionsOk. Does not contain a body.
  • se_ResetSessionOptionsOk. Does not contain a body.
  • se_ErrorResponse. Body contains info.

Possible option ids:

  • SEDNA_DEBUG_OFF – turns off query debug mode. Query debug mode is off be default. (See ”Debug features” section of the Sedna Programmer’s Guide for details.) This option does not contain a value (there must be a string of zero length in a message body);
  • SEDNA_DEBUG_ON – turns on query debug mode. This option does not contain a value (there must be a string of zero length in a message body).