From 538411353ac04416abf26a0f876b316c0bb5bb6f Mon Sep 17 00:00:00 2001 From: Pedro Pinto Date: Tue, 16 Jul 2019 08:48:36 -0400 Subject: [PATCH 1/5] 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 2/5] 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 3/5] 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 4/5] 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 5/5] 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