--------------------------------------------------------------------------------
NOTE:  This sample is an extended version of the Level1QuoteRequestSample.  
       In addition to the operations found in the Level1QuoteRequestSample, this
       sample performs the following:
       
          - retrieves the qualifiers.tab file from the ICE Data Services network
          - handles more data fields
          - displays the parsed qualifier information when applicable
       
       The output of this sample is best viewed in an application like Excel.
       This can be achieved by using the -disp OFF option and output redirection
       to file.  See the -disp option below for details.
--------------------------------------------------------------------------------

USAGE:

   Windows
   -------
      java -cp .;JStandardSamples.jar;lib/* QuoteManager.QualifiersParsingSample.Main
                [-h <host> -conn <connectionType>] -u <username> -p <password> 
                [-m <mode> -s <symbols> -limit <timeLimit> -disp <display>]
   Linux
   ------
      java -cp .:JStandardSamples.jar:lib/* QuoteManager.QualifiersParsingSample.Main
                [-h <host> -conn <connectionType>] -u <username> -p <password> 
                [-m <mode> -s <symbols> -limit <timeLimit> -disp <display>]

where

   Arg   Value                  Description
   ---   -----                  -----------
   -h    <host>                 Specifies the address to use to connect to the ICE Data 
                                Services etwork.  
                                
                                For example: cm*.dataservices.theice.com

   -conn <connectionType>       Specifies the type of connection to use with the ICE Data Services
                                network.  Valid values include:
                                
                                   0 - SOCKTYPE_LEGACY    Uses a non TLS connection.
                                   1 - SOCKTYPE_TLS       Uses a secure/encrypted socket connection.
                                   2 - SOCKTYPE_TLS_PLUS  Not yet implemented; reserved for future support.
                                
   -u    <username>  (required) The username for the account entitled to receive data from 
                                ICE Data Services. If you do not have one, please contact 
                                your ICE Data Services representative.

   -p    <password>  (required) The password for the account entitled to receive data from 
                                ICE Data Services. If you do not have one, please contact 
                                your ICE Data Services representative.

   -m    <mode>                 Identifies the type of request to make.  The following 
                                modes may be specified:

                                   - snapshot
                                     A "snapshot" request will provide all of the fields 
                                     associated with a given instrument.
                                     Snapshot requests provide the most current data for an
                                     instrument at the time of the request, but and do not 
                                     provide additional updates.
                                     
                                   - subscribe
                                     The "subscribe" request provides streaming updates of 
                                     all the fields for the requested instrument.

   -s    <symbols>              The symbol, or symbols, to use for making the Level 1  
                                request. A single instrument may be entered, or a comma 
                                separated list of symbols. Symbols that include a space must
                                be enclosed in quotes. For example:

                                    -s "CL #F"

                                Multiple symbols must be separated by commas with no spaces.
                                If one of the symbols contains a space, the entire list must
                                be enclosed in quotes.  Here are two examples:
   
                                    -s  IBM,GE,WFM
 
                                    -s  "IBM,CL #F,WFM"

   -limit <timeLimit>           The duration this sample will run before exiting.
                                Time duration applies to subscribe requests only.
                                Syntax for setting the time duration is: 
                                          
                                   HH:MM:SS
                                             
                                Setting the limit to 0 or 00:00:00 indicates to run
                                continuously without end; sample application must be
                                forcibly stopped.
                                          
    -disp <display>             Controls the formatting and output to the console window.
                                Valid values include:
                                                     
                                   - ON    Output displays within the console window and
                                           is formatted for readability.
                                           
                                   - OFF   Suppresses most output from display within the
                                           console window.  Output is formatted as comma-
                                           separated values and intended for redirection to
                                           a file.
                                
                                This option is best used in combination with the -limit option.
                                                                
                                Usage Example:
                                
                                java -cp .;JStandardSamples.jar;lib/* QuoteManager.QualifiersParsingSample.Main \
                                -h host -u user -p pwd -m subscribe -s ICE -limit 00:05:10 -disp off > detailedoutput.csv
                              
Note:  If you do not enter a value for <host>, <mode>, or <symbols> the values listed in the
       QualifiersParsingSample.properties file will be used.  <username> and <password> must
       be entered at the command line.