From 830b590e5b75bb80bbf007485260b6862443d2f8 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Mon, 15 Jul 2019 10:59:13 -0400 Subject: [PATCH 01/12] Algos now go through an orderly shutdown phase. During which they can still process child updates. --- .../orderman/orders/algo/AlgoWrapperOrder.cpp | 111 ++++++++++++++++-- .../orderman/orders/algo/AlgoWrapperOrder.h | 4 + src/lib/orderman/orders/algo/IAlgoServices.h | 7 ++ src/server/sparkd/cmds/QuickTest.cpp | 1 + 4 files changed, 114 insertions(+), 9 deletions(-) diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp index c3a483969..81142a5ce 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp @@ -16,7 +16,13 @@ namespace orderman { using namespace api::orderman; template using Map = boost::container::flat_map; -enum class AlgoWrapperOrder::Status { INACTIVE, W_ATTACH, WORKING, COMPLETED }; +enum class AlgoWrapperOrder::Status { + INACTIVE, + W_ATTACH, + WORKING, + SHUTTING_DOWN, + COMPLETED +}; class ChildTemplate { public: @@ -62,6 +68,7 @@ struct AlgoWrapperOrder::PImpl { OrderKey attach_target = null_order_key(); std::optional pending_update; + std::optional> pending_terminate; OrderStatus external_status() const { return _state.status(); } void set_external_status(OrderStatus s) { @@ -222,6 +229,7 @@ OrderOpResult AlgoWrapperOrder::on_activate(Price p, Quantity q, return {}; case Status::W_ATTACH: + case Status::SHUTTING_DOWN: case Status::WORKING: bts_assert(false); } @@ -238,6 +246,7 @@ OrderOpResult AlgoWrapperOrder::on_update(Update const &update) { me->pending_update = update; return {}; case Status::COMPLETED: + case Status::SHUTTING_DOWN: return {}; case Status::WORKING: { me->set_price_quantity(Price(update.price()), @@ -275,6 +284,7 @@ orderman::OrderOpResult AlgoWrapperOrder::on_detach() { switch (me->status) { case Status::W_ATTACH: case Status::WORKING: + case Status::SHUTTING_DOWN: for (auto &[_, c] : me->children) { (void)_; c.order.mark_detached_from_parent(); @@ -309,6 +319,7 @@ orderman::OrderOpResult AlgoWrapperOrder::on_cancel() { break; } break; + case Status::SHUTTING_DOWN: case Status::COMPLETED: break; case Status::INACTIVE: @@ -347,6 +358,10 @@ Quantity AlgoWrapperOrder::total_fills() const { return Quantity(me->state().filled_quantity()); } +bool AlgoWrapperOrder::is_shutting_down() const { + return me->status == Status::SHUTTING_DOWN; +} + void AlgoWrapperOrder::subscribe_book(SecurityKey k) { if (!is_working()) return; @@ -485,7 +500,7 @@ void AlgoWrapperOrder::detach_all_children() { } void AlgoWrapperOrder::update_fill_state(Quantity q, Price p) { - if (!is_working()) + if (!is_working() && !is_shutting_down()) return; ReportStateGuard _(*this); @@ -519,11 +534,14 @@ void AlgoWrapperOrder::cancel(std::string const &msg) { if (!is_working()) return; ReportStateGuard _(*this); - terminate(ORDER_STATUS_CANCELED, msg); + if (working_children_count() == 0) + terminate(ORDER_STATUS_CANCELED, msg); + else + shutdown(ORDER_STATUS_CANCELED, msg); } void AlgoWrapperOrder::terminate_error(std::string const &msg) { - if (!is_working() && me->status != Status::W_ATTACH) + if (!is_working() && !is_shutting_down() && me->status != Status::W_ATTACH) return; ReportStateGuard _(*this); // If we attached and an error was signaled we do not want to @@ -538,7 +556,11 @@ void AlgoWrapperOrder::complete() { if (!is_working()) return; ReportStateGuard _(*this); - terminate(ORDER_STATUS_COMPLETED); + + if (working_children_count() == 0) + terminate(ORDER_STATUS_COMPLETED); + else + shutdown(ORDER_STATUS_COMPLETED); } // -------------------------------------------------------------------------------- @@ -573,6 +595,7 @@ void AlgoWrapperOrder::on_attach_complete( break; case Status::COMPLETED: break; + case Status::SHUTTING_DOWN: case Status::INACTIVE: case Status::WORKING: bts_assert(false); @@ -587,6 +610,7 @@ void AlgoWrapperOrder::on_child_order_update( switch (me->status) { case Status::WORKING: case Status::W_ATTACH: + case Status::SHUTTING_DOWN: if (auto it = me->children.find(child_key); it != me->children.end()) { auto &child_record = it->second; switch (new_child_state.status()) { @@ -634,7 +658,29 @@ void AlgoWrapperOrder::on_child_order_update( bts_assert(false); return; } - bts_assert(false); + + if (me->status == Status::SHUTTING_DOWN) + try_complete_shutdown(); +} + +void AlgoWrapperOrder::try_complete_shutdown() { + bts_assert(me->status == Status::SHUTTING_DOWN); + bts_assert(me->children.size()); + bts_assert(me->pending_terminate.has_value()); + + if (working_children_count() == 0) { + LOG(OrderMan, Info, "AlgoOrder {} completed shutdown. Terminated", + key().value()); + auto st = me->pending_terminate.value().first; + auto msg = me->pending_terminate.value().second; + me->pending_terminate.reset(); + terminate(st, msg); + } else { + LOG(OrderMan, Info, + "AlgoOrder {} still has {} orders working. Shutdown still in " + "progress", + key().value(), working_children_count()); + } } void AlgoWrapperOrder::setup_transitions() { @@ -676,8 +722,20 @@ void AlgoWrapperOrder::setup_transitions() { // From WORKING me->transition_actions[{Status::WORKING, Status::COMPLETED}] = [this]() { cleanup(); + me->children.clear(); _transition(Status::COMPLETED); }; + me->transition_actions[{Status::WORKING, Status::SHUTTING_DOWN}] = [this]() { + cleanup(); + _transition(Status::SHUTTING_DOWN); + }; + + // From SHUTTING_DOWN + me->transition_actions[{Status::SHUTTING_DOWN, Status::COMPLETED}] = + [this]() { + me->children.clear(); + _transition(Status::COMPLETED); + }; } void AlgoWrapperOrder::check_invariants() { @@ -697,6 +755,7 @@ void AlgoWrapperOrder::check_invariants() { bts_assert(me->book_subs.empty()); bts_assert(me->children.empty()); bts_assert(!me->has_timer_sub); + bts_assert(!me->pending_terminate.has_value()); break; case Status::WORKING: @@ -704,10 +763,21 @@ void AlgoWrapperOrder::check_invariants() { bts_assert(me->security); bts_assert(me->external_status() == ORDER_STATUS_WORKING); bts_assert(!me->pending_update.has_value()); + bts_assert(!me->pending_terminate.has_value()); + break; + + case Status::SHUTTING_DOWN: + bts_assert(working_children_count()); + bts_assert(me->services); + bts_assert(me->security); + bts_assert(me->external_status() == ORDER_STATUS_WORKING); + bts_assert(!me->pending_update.has_value()); + bts_assert(me->pending_terminate.has_value()); break; case Status::COMPLETED: bts_assert(me->children.empty()); + bts_assert(!me->pending_update.has_value()); bts_assert(me->external_status() == ORDER_STATUS_CANCELED || me->external_status() == ORDER_STATUS_COMPLETED || me->external_status() == ORDER_STATUS_ERROR || @@ -715,6 +785,7 @@ void AlgoWrapperOrder::check_invariants() { bts_assert(me->book_subs.empty()); bts_assert(!me->has_timer_sub); bts_assert(!me->pending_update.has_value()); + bts_assert(!me->pending_terminate.has_value()); break; } } @@ -745,15 +816,25 @@ void AlgoWrapperOrder::terminate(api::orderman::OrderStatus st, transition(Status::COMPLETED); } +void AlgoWrapperOrder::shutdown(api::orderman::OrderStatus st, + std::string const &error) { + bts_assert(!me->pending_terminate.has_value()); + bts_assert(working_children_count()); + me->pending_terminate = std::make_pair(st, error); + LOG(OrderMan, Info, + "AlgoOrder {} is shutting down. Waiting for {} child orders to complete " + "before terminating", + key().value(), working_children_count()); + transition(Status::SHUTTING_DOWN); +} + void AlgoWrapperOrder::cleanup() { for (auto const &s : me->book_subs) { me->services->unsubscribe_from_book(s.second); me->book_subs.clear(); } - for (auto &c : me->children) { + for (auto &c : me->children) c.second.order.cancel(); - me->children.clear(); - } if (me->has_timer_sub) unsubscribe_timer(); me->pending_update.reset(); @@ -785,6 +866,16 @@ OrderKey AlgoWrapperOrder::index_and_launch_child(ChildOrder &&child, Price p, return k; } +size_t AlgoWrapperOrder::working_children_count() const { + auto working_children_count = 0; + for (auto &c : me->children) + if (!c.second.state.has_value() || + c.second.state.value().status == ChildStatus::WORKING) { + working_children_count++; + } + return working_children_count; +} + bool AlgoWrapperOrder::is_working() const { return me->status == Status::WORKING; } @@ -799,6 +890,8 @@ log::CharPtrWrapper AlgoWrapperOrder::state_name(Status st) { return {"INACTIVE"}; case Status::WORKING: return {"WORKING"}; + case Status::SHUTTING_DOWN: + return {"SHUTTING_DOWN"}; } bts_assert(false); return {""}; diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.h b/src/lib/orderman/orders/algo/AlgoWrapperOrder.h index f11a84a23..9cf34d7fe 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.h +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.h @@ -40,6 +40,7 @@ class AlgoWrapperOrder : public Order, Price price() const override; Quantity quantity() const override; Quantity total_fills() const override; + bool is_shutting_down() const override; void subscribe_book(SecurityKey) override; void unsubscribe_book(SecurityKey) override; void subscribe_child_change(OrderKey) override; @@ -75,10 +76,13 @@ class AlgoWrapperOrder : public Order, void transition(Status); void _transition(Status); void terminate(api::orderman::OrderStatus, std::string const &error = ""); + void shutdown(api::orderman::OrderStatus, std::string const &error = ""); + void try_complete_shutdown(); void cleanup(); void update_child_record(api::orderman::OrderState const &, ChildRecord *); OrderKey index_and_launch_child(ChildOrder &&, Price, Quantity, bool); bool is_working() const ; + size_t working_children_count() const; log::CharPtrWrapper state_name(Status) ; ChildStatus map_child_status(api::orderman::OrderStatus) ; bool _is_attaching(api::orderman::OrderDefinition const &) const ; diff --git a/src/lib/orderman/orders/algo/IAlgoServices.h b/src/lib/orderman/orders/algo/IAlgoServices.h index 4d9cd2f2f..5e779730f 100644 --- a/src/lib/orderman/orders/algo/IAlgoServices.h +++ b/src/lib/orderman/orders/algo/IAlgoServices.h @@ -20,6 +20,13 @@ class IAlgoServices : public IBeforeLaunchAlgoServices { // Returns the filled quantity for this algo virtual Quantity total_fills() const = 0; + // Returns wheter the algo is in the process of shutting down (due + // to a cancel, an error, or just having completed its work). When + // algo is shutting down any requests to create, update or cancel + // child orders will be ignored. + virtual bool is_shutting_down() const = 0; + + // -------------------------------------------------------------- // Event Subscriptions // -------------------------------------------------------------- diff --git a/src/server/sparkd/cmds/QuickTest.cpp b/src/server/sparkd/cmds/QuickTest.cpp index f6f86be5a..6dd5d649f 100644 --- a/src/server/sparkd/cmds/QuickTest.cpp +++ b/src/server/sparkd/cmds/QuickTest.cpp @@ -27,6 +27,7 @@ struct Proxy : public IAlgoServices { Price price() const { return Price(0); } Quantity quantity() const { return Quantity(0); } Quantity total_fills() const { return Quantity(0); } + bool is_shutting_down() const {return false;} void subscribe_book(SecurityKey){}; void unsubscribe_book(SecurityKey) {} void subscribe_child_change(OrderKey) {} From f488248abfc78eb1134ab0d3327d0e14c1a21cbc Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Mon, 15 Jul 2019 16:03:36 -0400 Subject: [PATCH 02/12] Fixed handling of child update while shutdown. --- src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp index 81142a5ce..3881e6ef4 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp @@ -651,7 +651,7 @@ void AlgoWrapperOrder::on_child_order_update( } else terminate_error( fmt::format("Unknown child order update: {}", child_key.value())); - return; + break; case Status::COMPLETED: return; case Status::INACTIVE: From 60786b105cc8f1969e19a334343103fc1afdacb1 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Mon, 15 Jul 2019 16:26:22 -0400 Subject: [PATCH 03/12] Handled terminate_error while shutting down. --- src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp index 3881e6ef4..8196e2d4c 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp @@ -549,6 +549,10 @@ void AlgoWrapperOrder::terminate_error(std::string const &msg) { // order with a good queue position that we want to preserve if (is_attaching()) me->children.erase(me->attach_target); + + // This just detected error superseeds whatever triggered the shutdown + if (is_shutting_down()) + me->pending_terminate.reset(); terminate(ORDER_STATUS_ERROR, msg); } From da6998c391d9911c19c2534fadc685f8339bdf48 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Mon, 15 Jul 2019 16:43:39 -0400 Subject: [PATCH 04/12] Do not error out when receiving an udpate from an unknown child. Because the child is presumably a detached child. --- src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp index 8196e2d4c..8a97a52eb 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp @@ -653,8 +653,9 @@ void AlgoWrapperOrder::on_child_order_update( break; } } else - terminate_error( - fmt::format("Unknown child order update: {}", child_key.value())); + LOG(OrderMan, Info, + "AlgoOrder {} received update for presumably detached order {}", + key().value(), child_key.value()); break; case Status::COMPLETED: return; From 538411353ac04416abf26a0f876b316c0bb5bb6f Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 08:48:36 -0400 Subject: [PATCH 05/12] Improved cover to hedge while shutting down. --- .../orders/algo/algo_orders/CoverAlgo.cpp | 47 ++++++++++++++----- 1 file changed, 36 insertions(+), 11 deletions(-) diff --git a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp index 783bcd960..3a31f8ddd 100644 --- a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp +++ b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp @@ -10,7 +10,7 @@ namespace orderman { using namespace api::orderman; -enum class CoverAlgo::Status { WORKING, WAITING_FOR_HEDGES, DONE }; +enum class CoverAlgo::Status { WORKING, WAITING_FOR_HEDGES, DONE, CANCELING }; const char *CoverAlgo::status_name(Status st) { switch (st) { case Status::WORKING: @@ -18,7 +18,9 @@ const char *CoverAlgo::status_name(Status st) { case Status::WAITING_FOR_HEDGES: return "WAITING_FOR_HEDGES"; case Status::DONE: - return "Done"; + return "DONE"; + case Status::CANCELING: + return "CANCELING"; } return nullptr; } @@ -124,13 +126,23 @@ void CoverAlgo::on_child_change(OrderKey k, ChildState const &st) { "CoverAlgo {}. Child is completed, waiting for hedges ", algo().order_key().value()); algo().set_ladder_visibility(false); - me->status = Status::WAITING_FOR_HEDGES; + if (me->status == Status::WORKING) + me->status = Status::WAITING_FOR_HEDGES; + else { + me->status = Status::DONE; + algo().cancel(); + } break; case ChildStatus::CANCELED: - LOG(OrderMan, Info, "CoverAlgo {}. Child was canceled, terminating", - algo().order_key().value()); - me->status = Status::DONE; - algo().terminate_error("Unexpected child cancel"); + if (me->status == Status::WORKING) { + LOG(OrderMan, Info, "CoverAlgo {}. Child was canceled, terminating", + algo().order_key().value()); + me->status = Status::DONE; + algo().terminate_error("Unexpected child cancel"); + } else if (me->status == Status::CANCELING) { + me->status = Status::DONE; + algo().cancel(); + } break; } } else { @@ -225,10 +237,23 @@ void CoverAlgo::check_terminate() { } IAlgoOrder::OnCancelResponse CoverAlgo::on_cancel() { - if (!me->cancel_hedges_on_cancel) - for (auto &k : me->hedges) - algo().detach_child(k); - return IAlgoOrder::OnCancelResponse::HONOR; + switch (me->status) { + case Status::WORKING: { + if (!me->cancel_hedges_on_cancel) + for (auto &k : me->hedges) + algo().detach_child(k); + algo().cancel_child(me->child_key); + me->status = Status::CANCELING; + return IAlgoOrder::OnCancelResponse::IGNORE; + } + case Status::CANCELING: + return IAlgoOrder::OnCancelResponse::IGNORE; + case Status::WAITING_FOR_HEDGES: + return IAlgoOrder::OnCancelResponse::HONOR; + case Status::DONE: + bts_assert(false); + return IAlgoOrder::OnCancelResponse::HONOR; + } } } // namespace orderman From 9480e76d4b5104e19713bd560b7a12e004fd3b5b Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 10:10:11 -0400 Subject: [PATCH 06/12] Cleaned up algo wrapper --- src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp index 8a97a52eb..bf0db046f 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp @@ -550,9 +550,6 @@ void AlgoWrapperOrder::terminate_error(std::string const &msg) { if (is_attaching()) me->children.erase(me->attach_target); - // This just detected error superseeds whatever triggered the shutdown - if (is_shutting_down()) - me->pending_terminate.reset(); terminate(ORDER_STATUS_ERROR, msg); } @@ -654,7 +651,8 @@ void AlgoWrapperOrder::on_child_order_update( } } else LOG(OrderMan, Info, - "AlgoOrder {} received update for presumably detached order {}", + "AlgoOrder {} received update for presumably detached order {}. " + "Ignoring it", key().value(), child_key.value()); break; case Status::COMPLETED: @@ -676,10 +674,8 @@ void AlgoWrapperOrder::try_complete_shutdown() { if (working_children_count() == 0) { LOG(OrderMan, Info, "AlgoOrder {} completed shutdown. Terminated", key().value()); - auto st = me->pending_terminate.value().first; - auto msg = me->pending_terminate.value().second; - me->pending_terminate.reset(); - terminate(st, msg); + terminate(me->pending_terminate.value().first, + me->pending_terminate.value().second); } else { LOG(OrderMan, Info, "AlgoOrder {} still has {} orders working. Shutdown still in " @@ -739,6 +735,7 @@ void AlgoWrapperOrder::setup_transitions() { me->transition_actions[{Status::SHUTTING_DOWN, Status::COMPLETED}] = [this]() { me->children.clear(); + me->pending_terminate.reset(); _transition(Status::COMPLETED); }; } @@ -776,6 +773,8 @@ void AlgoWrapperOrder::check_invariants() { bts_assert(me->services); bts_assert(me->security); bts_assert(me->external_status() == ORDER_STATUS_WORKING); + bts_assert(me->book_subs.empty()); + bts_assert(!me->has_timer_sub); bts_assert(!me->pending_update.has_value()); bts_assert(me->pending_terminate.has_value()); break; From c8e054d079225a27d96b422e6a1ac651241f6010 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 10:10:46 -0400 Subject: [PATCH 07/12] Added algo wrapper documentation. --- .../orders/algo/doc/algo_wrapper_sm.png | Bin 0 -> 40559 bytes .../orders/algo/doc/state_machine.org | 39 ++++++++++++++++++ 2 files changed, 39 insertions(+) create mode 100644 src/lib/orderman/orders/algo/doc/algo_wrapper_sm.png create mode 100644 src/lib/orderman/orders/algo/doc/state_machine.org diff --git a/src/lib/orderman/orders/algo/doc/algo_wrapper_sm.png b/src/lib/orderman/orders/algo/doc/algo_wrapper_sm.png new file mode 100644 index 0000000000000000000000000000000000000000..4e49734d63915ee84af87a6ccb854795b691fefe GIT binary patch literal 40559 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 literal 0 HcmV?d00001 diff --git a/src/lib/orderman/orders/algo/doc/state_machine.org b/src/lib/orderman/orders/algo/doc/state_machine.org new file mode 100644 index 000000000..5eaf1b7bf --- /dev/null +++ b/src/lib/orderman/orders/algo/doc/state_machine.org @@ -0,0 +1,39 @@ +#+TITLE: Algo Wrapper State Machien +#+OPTIONS: ^:nil +#+OPTIONS: H:2 +#+OPTIONS: ^:nil H:2 author:nil creator:nil timestamp:nil toc:nil +#+OPTIONS: html-postamble:nil + + +* State Machine +#+begin_src dot :file algo_wrapper_sm.png :cmdline -Kdot -Tpng +digraph G { + bgcolor="transparent"; + edge [ fontname=Helvetica, fontsize=12 ]; + + start [style=invisible]; + COMPLETED [style=filled] ; + start -> INACTIVE; + INACTIVE -> COMPLETED [label="qty=0|error"]; + INACTIVE -> W_ATTACH [label="ok & attach"]; + INACTIVE -> WORKING [label="ok & !attach"]; + W_ATTACH -> COMPLETED [label=attach_fail]; + W_ATTACH -> WORKING [label=attach_ok]; + WORKING -> COMPLETED [label="[wchild=0]cancel|complete"]; + WORKING -> COMPLETED [label=error]; + WORKING -> SHUTTING_DOWN [label="[wchild>0]cancel|complete"]; + SHUTTING_DOWN -> COMPLETED [label="wchild==0|error|on_detach"]; +} +#+END_SRC + +#+RESULTS: +[[file:algo_wrapper_sm.png]] + +* Invariants +| | attach_target | exernal_status | pending_update | pending_terminate | working_children | subs | +|---------------+---------------+--------------------------------------+----------------+-------------------+------------------+------| +| INACTIVE | | | | | | 0 | +| W_ATTACH | 1 | WORKING | | 0 | 0 | 0 | +| WORKING | | WORKING | 0 | 0 | | | +| SHUTTING_DOWN | | WORKING | 0 | 1 | >0 | 0 | +| COMPLETED | | CANCELED, COMPLETED, ERROR, REJECTED | 0 | 0 | 0 | 0 | From e80fc807e0e876b296126b05bbe88024be3b18d3 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 10:20:30 -0400 Subject: [PATCH 08/12] Moved all reporting state calls to top level event handler. Any CPU the algo order receives must originate from a top level event, its simpler to consolidate all report guards in those events, instead of chasing every call that comes out of the algo. --- .../orderman/orders/algo/AlgoWrapperOrder.cpp | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp index bf0db046f..368a25435 100644 --- a/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp +++ b/src/lib/orderman/orders/algo/AlgoWrapperOrder.cpp @@ -368,7 +368,10 @@ void AlgoWrapperOrder::subscribe_book(SecurityKey k) { bts_assert(me->book_subs.find(k) == me->book_subs.end()); me->book_subs[k] = me->services->subscribe_to_book( - k, [this, k](auto const &ev) { me->algo->on_book(k, ev.book); }); + k, [this, k](auto const &ev) { + ReportStateGuard _(*this); + me->algo->on_book(k, ev.book); + }); } void AlgoWrapperOrder::unsubscribe_book(SecurityKey k) { @@ -407,7 +410,10 @@ void AlgoWrapperOrder::subscribe_timer() { bts_assert(!me->has_timer_sub); me->has_timer_sub = true; me->services->subscribe_to_time( - [this](auto const &) { me->algo->on_timer(); }); + [this](auto const &) { + ReportStateGuard _(*this); + me->algo->on_timer(); + }); } void AlgoWrapperOrder::unsubscribe_timer() { @@ -503,7 +509,6 @@ void AlgoWrapperOrder::update_fill_state(Quantity q, Price p) { if (!is_working() && !is_shutting_down()) return; - ReportStateGuard _(*this); auto previous_qty = me->state().filled_quantity(); if (previous_qty > q.value()) { LOG(OrderMan, Error, @@ -525,15 +530,12 @@ void AlgoWrapperOrder::update_fill_state(Quantity q, Price p) { void AlgoWrapperOrder::set_ladder_visibility(bool is_visible) { if (!is_working()) return; - - ReportStateGuard _(*this); me->set_ladder_visibility(is_visible); } void AlgoWrapperOrder::cancel(std::string const &msg) { if (!is_working()) return; - ReportStateGuard _(*this); if (working_children_count() == 0) terminate(ORDER_STATUS_CANCELED, msg); else @@ -543,7 +545,6 @@ void AlgoWrapperOrder::cancel(std::string const &msg) { void AlgoWrapperOrder::terminate_error(std::string const &msg) { if (!is_working() && !is_shutting_down() && me->status != Status::W_ATTACH) return; - ReportStateGuard _(*this); // If we attached and an error was signaled we do not want to // cancel our child because that child might be a long running // order with a good queue position that we want to preserve @@ -556,8 +557,6 @@ void AlgoWrapperOrder::terminate_error(std::string const &msg) { void AlgoWrapperOrder::complete() { if (!is_working()) return; - ReportStateGuard _(*this); - if (working_children_count() == 0) terminate(ORDER_STATUS_COMPLETED); else From 481c1fd2de4b17af1c3b8b71e8144fb3ea09a3b5 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 10:29:59 -0400 Subject: [PATCH 09/12] Fixed gcc build. --- src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp index 3a31f8ddd..6117c69f1 100644 --- a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp +++ b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp @@ -254,6 +254,9 @@ IAlgoOrder::OnCancelResponse CoverAlgo::on_cancel() { bts_assert(false); return IAlgoOrder::OnCancelResponse::HONOR; } + + bts_assert(false); + return IAlgoOrder::OnCancelResponse::HONOR; } } // namespace orderman From 0af30b3cc09904ed552734022b0c8e1257346764 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 15:32:38 -0400 Subject: [PATCH 10/12] Changed cover to handle fills while canceling. --- .../orders/algo/algo_orders/CoverAlgo.cpp | 125 ++++++++++++------ .../orders/algo/algo_orders/CoverAlgo.h | 3 + 2 files changed, 85 insertions(+), 43 deletions(-) diff --git a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp index 6117c69f1..6b112a9cb 100644 --- a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp +++ b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.cpp @@ -11,19 +11,7 @@ namespace orderman { using namespace api::orderman; enum class CoverAlgo::Status { WORKING, WAITING_FOR_HEDGES, DONE, CANCELING }; -const char *CoverAlgo::status_name(Status st) { - switch (st) { - case Status::WORKING: - return "WORKING"; - case Status::WAITING_FOR_HEDGES: - return "WAITING_FOR_HEDGES"; - case Status::DONE: - return "DONE"; - case Status::CANCELING: - return "CANCELING"; - } - return nullptr; -} + struct CoverAlgo::PImpl { IAlgoServices *algo; OrderKey child_key = null_order_key(); @@ -94,8 +82,11 @@ void CoverAlgo::do_launch_attached(IAlgoServices &algo, OrderKey k, on_child_change(k, st); } -void CoverAlgo::on_child_change(OrderKey k, ChildState const &st) { - if (k == me->child_key) { +void CoverAlgo::on_covered_change(ChildState const &st) { + // First launch hedge if appropriate + switch (me->status) { + case Status::WORKING: + case Status::CANCELING: if (st.total_fills.value() > me->hedged_fills.value()) { auto hedge_qty = Quantity(st.total_fills.value() - me->hedged_fills.value()); @@ -118,6 +109,15 @@ void CoverAlgo::on_child_change(OrderKey k, ChildState const &st) { hedge_qty.value(), hedge_price.value()); } algo().update_fill_state(st.total_fills, st.last_price); + break; + case Status::WAITING_FOR_HEDGES: + case Status::DONE: + break; + } + + // Now analyze child to figure out wheter we should terminate + switch (me->status) { + case Status::WORKING: switch (st.status) { case ChildStatus::WORKING: break; @@ -126,49 +126,70 @@ void CoverAlgo::on_child_change(OrderKey k, ChildState const &st) { "CoverAlgo {}. Child is completed, waiting for hedges ", algo().order_key().value()); algo().set_ladder_visibility(false); - if (me->status == Status::WORKING) - me->status = Status::WAITING_FOR_HEDGES; - else { - me->status = Status::DONE; - algo().cancel(); - } + me->status = Status::WAITING_FOR_HEDGES; + check_terminate(); break; case ChildStatus::CANCELED: - if (me->status == Status::WORKING) { - LOG(OrderMan, Info, "CoverAlgo {}. Child was canceled, terminating", - algo().order_key().value()); - me->status = Status::DONE; - algo().terminate_error("Unexpected child cancel"); - } else if (me->status == Status::CANCELING) { - me->status = Status::DONE; - algo().cancel(); - } + LOG(OrderMan, Info, "CoverAlgo {}. Child was canceled, terminating", + algo().order_key().value()); + me->status = Status::DONE; + algo().terminate_error("Unexpected child cancel"); break; } - } else { + break; + case Status::CANCELING: switch (st.status) { case ChildStatus::WORKING: break; case ChildStatus::CANCELED: - if (me->cancel_on_external_hedge_cancel) { - LOG(OrderMan, Info, "CoverAlgo {}. Hedge was canceled, terminating", - algo().order_key().value()); - me->status = Status::DONE; - algo().terminate_error("Unexpected child cancel"); - } else - me->hedges.erase( - std::remove(me->hedges.begin(), me->hedges.end(), k), - me->hedges.end()); - break; case ChildStatus::COMPLETED: - me->hedges.erase(std::remove(me->hedges.begin(), me->hedges.end(), k), - me->hedges.end()); + LOG(OrderMan, Info, "CoverAlgo {}. Shutdown complete", + algo().order_key().value()); + me->status = Status::DONE; + algo().cancel(); break; } + break; + case Status::WAITING_FOR_HEDGES: + case Status::DONE: + break; } +} + +void CoverAlgo::on_hedge_change(OrderKey k, ChildState const &st) { + + // First adjust our hedge count or cancel if something went wrong + switch (st.status) { + case ChildStatus::WORKING: + break; + case ChildStatus::COMPLETED: + me->hedges.erase(std::remove(me->hedges.begin(), me->hedges.end(), k), + me->hedges.end()); + break; + case ChildStatus::CANCELED: + if (me->cancel_on_external_hedge_cancel) { + LOG(OrderMan, Info, "CoverAlgo {}. Hedge was canceled, terminating", + algo().order_key().value()); + me->status = Status::DONE; + algo().terminate_error("Unexpected child cancel"); + return; + } else + me->hedges.erase(std::remove(me->hedges.begin(), me->hedges.end(), k), + me->hedges.end()); + break; + } + + // Now if we are waiting for hedges to complete, bail check_terminate(); } +void CoverAlgo::on_child_change(OrderKey k, ChildState const &st) { + if (k == me->child_key) + on_covered_change(st); + else + on_hedge_change(k,st); +} + void CoverAlgo::do_update(api::orderman::Update const &update) { if (me->status == Status::WORKING) { LOG(OrderMan, Diag, "CoverAlgo order {} receiving update: {}", @@ -243,6 +264,10 @@ IAlgoOrder::OnCancelResponse CoverAlgo::on_cancel() { for (auto &k : me->hedges) algo().detach_child(k); algo().cancel_child(me->child_key); + + LOG(OrderMan, Info, + "CoverAlgo {} received cancel. Canceling child and waiting for an ack", + algo().order_key()); me->status = Status::CANCELING; return IAlgoOrder::OnCancelResponse::IGNORE; } @@ -259,5 +284,19 @@ IAlgoOrder::OnCancelResponse CoverAlgo::on_cancel() { return IAlgoOrder::OnCancelResponse::HONOR; } +const char *CoverAlgo::status_name(Status st) { + switch (st) { + case Status::WORKING: + return "WORKING"; + case Status::WAITING_FOR_HEDGES: + return "WAITING_FOR_HEDGES"; + case Status::DONE: + return "DONE"; + case Status::CANCELING: + return "CANCELING"; + } + return nullptr; +} + } // namespace orderman } // namespace bts diff --git a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.h b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.h index 24fb06cf5..86904a2fc 100644 --- a/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.h +++ b/src/lib/orderman/orders/algo/algo_orders/CoverAlgo.h @@ -31,6 +31,9 @@ private: void init_hedge_template(IBeforeLaunchAlgoServices &, api::orderman::CustomOrderDefinition const &); void check_terminate(); + + void on_hedge_change(OrderKey hedge, ChildState const&) ; + void on_covered_change(ChildState const&); const char *status_name(Status st); }; From 9def94acebbe525261fdba214c5ab608506758fa Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 15:55:28 -0400 Subject: [PATCH 11/12] Changed IB to cancel rather than error if it sees a child cancel. This allows IB to remain agnostic of wheter the child cancel was a simply a consequence of the IB itself shutting down, in which case it would be ignored. If the IB instead errorred out than that error superseeds the cancel and results in the IB reporting an error. --- src/lib/orderman/orders/algo/algo_orders/IcebergAlgo.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/lib/orderman/orders/algo/algo_orders/IcebergAlgo.cpp b/src/lib/orderman/orders/algo/algo_orders/IcebergAlgo.cpp index f93231c57..897a366ff 100644 --- a/src/lib/orderman/orders/algo/algo_orders/IcebergAlgo.cpp +++ b/src/lib/orderman/orders/algo/algo_orders/IcebergAlgo.cpp @@ -145,7 +145,7 @@ void IcebergAlgo::on_child_change(OrderKey k, ChildState const &st) { on_timer(); return; case ChildStatus::CANCELED: - algo().terminate_error("Unexpected child cancel"); + algo().cancel("Unexpected child cancel"); return; } } From 2ede69a26373060150e5653a8337277c39503994 Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 16:21:31 -0400 Subject: [PATCH 12/12] Updated release notes. --- doc/user/content/release_notes/_index.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/user/content/release_notes/_index.md b/doc/user/content/release_notes/_index.md index 6afa58f79..31ff8dc54 100644 --- a/doc/user/content/release_notes/_index.md +++ b/doc/user/content/release_notes/_index.md @@ -4,6 +4,19 @@ weight = 3 sort_by = "weight" insert_anchor_links = "right" +++ +## 2.7.0 +### User Visible Changes + - Allowed algos to process "in-flight" fills while shutting down + - Changed the cover algo to continue to hedge while shutting down +### API Changes + - Changed the API so that algos do not fully terminate until all + their children are terminated. Algos that are in the process of + shutting down in response to a complete or cancel call will still + receive child updates, which they can use to calculate and report + an accurate fill count (during this shutdown stage algos cannot + create, cancel or update children). A new method IAlgoServices + method, is_shutting_down(), can be used to determine if an algo is + shutting down. ## 2.6.1 ### User Visible Changes