The *month\_options* method
===========================

This method takes the same inputs as "date\_time\_options" and returns
almost the same outputs, except for where a performance list would be
returned where it only returns a list of months which contain valid
performances. The intended use is that this call is made first, with the
result being used to allow the user to select a month before selcting
their performance. This increases the speed with which a performance may
be selected by reducing the data that needs to be transferred.

Required inputs
---------------

These are the same as for "date\_time\_options" and that section may be
used as a reference.

Example input
~~~~~~~~~~~~~

.. code-block:: xml

    <month_options>
    <user_id>demo</user_id>
    <crypto_block>M_--qRfq64CDfM9Vj4JBQdRMdOJPW0xEpX1WsPqJY6Sy_X--q
    -u7vOoeQH9kWHcDhhX0y1R6--Q5LYtL2zZeBLtUFtT8k2_EW3NjhoJBWdGhx6TV
    _mcqVl1vM---Y</crypto_block>
    <event_token>MQ2JX</event_token>
    </month_options>

Output data
-----------

No crypto\_block is produced at the output, as the intent is to provie
data which will be used for a real subsequent call to
"date\_time\_options". For the most part, the output is identical to
that for "date\_time\_options" with the exception of the contents of the
elements conatined within a using\_perf\_list element. Instead of
individual performances, instead "month" elements will be output. Each
element describes a single month containing valid performances. The year
is held in "year\_number" and a numeric value for the month in
"month\_number". Textual descriptions of the name of the month in the
current language, in both short and long form, are to be found in the
"short\_month\_name" and "long\_month\_name" elements. Finally two
elements are provided to give the first and last date of the month.
These are "earliest\_date" and "latest\_date", and may be fed directly
into date\_time\_options to restrict the data it returns.

Example output
~~~~~~~~~~~~~~

.. code-block:: xml

    <month_options_result>
    <need_departure_date>no</need_departure_date>
    <using_perf_list>

    <month>
    <year_number>2004</year_number>
    <month_number>02</month_number>
    <short_month_name>Feb</short_month_name>
    <long_month_name>February</long_month_name>
    <earliest_date>20040201</earliest_date>
    <latest_date>20040229</latest_date>
    </month>

    <month>
    <year_number>2004</year_number>
    <month_number>03</month_number>
    <short_month_name>Mar</short_month_name>
    <long_month_name>March</long_month_name>
    <earliest_date>20040301</earliest_date>
    <latest_date>20040331</latest_date>
    </month>

    </using_perf_list>
    </month_options_result>

Potential failure codes
-----------------------

This call may respond with any failure codes returned by
"date\_time\_options" with the same meanings.