www.gusucode.com > trading工具箱matlab源码程序 > trading/trading/@emsx/modifyRoute.m

    function r = modifyRoute(b,reqstruct,varargin)
%MODIFYROUTE Modify Bloomberg EMSX route.
%   R = MODIFYROUTE(B,REQSTRUCT) modifies a Bloomberg EMSX route and returns
%   the order sequence number, route id and status message using the default event
%   handler.
%  
%   MODIFYROUTE(B,REQSTRUCT,'useDefaultEventHandler',false) modifies a 
%   Bloomberg EMSX route.  To process events, the user must invoke a
%   custom event handler.
% 
%   MODIFYROUTE(B,REQSTRUCT,'timeOut',200) modifies a Bloomberg EMSX route 
%   and returns the order sequence number, route id and status message using the default 
%   event handler specifying a timeOut value in milliseconds for the event 
%   handler.  The default timeOut value is 500 milliseconds.
%
%   For example, 
%
%   reqStruct.EMSX_SEQUENCE = int32(335877)
%   reqStruct.EMSX_TICKER = 'XYZ';
%   reqStruct.EMSX_AMOUNT = int32(200);
%   r = modifyRoute(b,reqStruct)
%
%   returns 
%
%   r = 
%   
%       EMSX_SEQUENCE: 3335877
%       EMSX_ROUTE_ID: 1
%             MESSAGE: 'Order Modified'
%
%   modifyRoute(b,reqStruct,'useDefaultEventHandler',false)
%   b.processEvent
%
%   returns
%
%   ModifyRoute = {
%
%    EMSX_SEQUENCE = 335877
%
%    EMSX_ROUTE_ID = 1
%   
%    MESSAGE = Route Modified
%
%    }
%
%   Note that the name/value pairs can be input as a single input structure
%   containing some or all of the property fields, for example,
%
%   p.timeOut = 1000;
%   modifyRoute(b,reqStruct,p)
%
%    See also orders, createOrderAndRoute, createOrder, deleteOrder, routes.

%   Copyright 2012 The MathWorks, Inc.

%get request fields
routeFields = fieldnames(reqstruct);

%parse name/value pair settings
p.timeOut = 500;
p.useDefaultEventHandler = true;
if nargin > 2
  p = b.parsenv(varargin);
end

%build and send request
request = b.Service.createRequest('ModifyRoute');
for i = 1:length(routeFields)
  request.set(routeFields{i},reqstruct.(routeFields{i}));
end

b.Session.sendRequest(request, []);

%process events with default handler 
if p.useDefaultEventHandler
  
  r = processOrderRouteEvents(b,p.timeOut);

elseif nargout == 1
  
  r = [];
 
end