/**////    <summary>
        ///    Purchase shares of a specific stock.        
        /// <param name='accountID'>The accountID number</param>
        ///    <param name='txID'>The transaction ID</param>
        ///    <param name='ticker'>The ticker symbol to be purchased</param>
        ///    <param name='shares'>Amount of shares</param>
        ///    <param name='sharePrice'>The share price</param>
        ///    <param name='commission'>The buy commission</param>
        ///    <returns>BrokerStatus enum value</returns>
        /// </summary>

        public BrokerStatus Buy( int accountID, int txID, string ticker, int shares, decimal sharePrice, decimal commission )
        {
            Debug.Assert( sproc == null );

            try    {
                BrokerStatus status;
            
                // Initialize order info

                Order order;

                order.AccountID  = accountID;
                order.TxID       = txID;
                order.Ticker     = ticker;
                order.Shares     = shares;
                order.SharePrice = sharePrice;
                order.Commission = commission;

                // Debit account balance

                decimal debitAmt = ( decimal )order.Shares * order.SharePrice + order.Commission;
                GAM gam = new GAM();

                if ( gam.DebitAccountBalance( order.AccountID, debitAmt  ) == 0 )
                {
                    status = BrokerStatus.InsufficientFunds;
                    ContextUtil.SetAbort();
                }
                else
                {
                      // Create parameter array

                    SqlParameter[] parameters =
                    {
                        new SqlParameter( "@TxID",       SqlDbType.Int,   4 ), // 0
                        new SqlParameter( "@AccountID",  SqlDbType.Int,   4 ), // 1
                        new SqlParameter( "@Ticker",     SqlDbType.NChar, 6 ), // 2
                        new SqlParameter( "@Shares",     SqlDbType.Int,   4 ), // 3
                        new SqlParameter( "@SharePrice", SqlDbType.Money, 8 ), // 4
                        new SqlParameter( "@Commission", SqlDbType.Money, 8 ), // 5
                    };

                    // Set parameter values and directions

                    parameters[ 0 ].Value = order.TxID;
                    parameters[ 1 ].Value = order.AccountID;
                    parameters[ 2 ].Value = order.Ticker;
                    parameters[ 3 ].Value = order.Shares;
                    parameters[ 4 ].Value = order.SharePrice;
                    parameters[ 5 ].Value = order.Commission;

                    // Run the stored procedure

                    sproc = new StoredProcedure( "Broker_Buy", parameters );
                    int error = sproc.Run();
                    Debug.Assert( error == 0 );

                    status = BrokerStatus.Success;
                    ContextUtil.SetComplete();
                }
                return status;
            }
            catch
            {
                ContextUtil.SetAbort();
                throw;
            }
        }