
When a session is created from an instrument, several session-specific 
subdirectories will be created under this (dsurvey\sessions) directory. 

For simplicity sake, assume the name used for a session is "mySession".

The following files and subdirectories will be created.

  sessions\mySession.XML : session specific descriptor file (this starts as a copy of the instrument descriptor file)
  sessions\mySession     : directory for storing session specific parameter files, results (i.e.; submitted data), etc.

Assuming you created an instrument using the Create An Instrument option on 
the dSurvey main administration page (dsurvey/admin.htm), the following files 
will be created when a session is created.

   sessions\mysession\allowedUsers.xml
   sessions\mysession\control.xml
   sessions\mysession\params.xml
   sessions\mysession\reference.xml
   sessions\mysession\describe.txt 

There may also be several sc_*.xml (scenario) and sl_*.xml (scenario list), files

See the dsurvey\instruments\read.me for details on these files.

Also, a sessions\mysession\backup subdirectory will be created.
This can be used for storing backups, and is not necessary for normal operation of dSurvey.

Note that while a session is running, several other files may be created.

These include:
  notes.txt : for storing notes written by an administrator
  joinlist.txt  : list of current participants
  saveSnapShot.xml  : a snapshot, taken by an administrator, of the current state of a session


A note on projects:

  If a session name starts with:
     $aproject_aname
  Then  "aproject" is the "project" that the "aname" session "is in".
  "Projects" are used to form a hierarchy, with sessions being general
  (not in a project), or "in a project".
  This is simply a way of simplfying display, when there are lots of sessions.

  Note that sessions can be created in projects that have the same name as the
  instrument's project, or a  different name.

Last modified 22 Feb 2011
