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).
|