Skip to content

Commit

Permalink
Merge pull request #314 from sshanks-kx/defer
Browse files Browse the repository at this point in the history
moved deferred response, add links to ref material
  • Loading branch information
natalietanner authored Jun 28, 2024
2 parents 5f554fb + 1e6772e commit ea50b79
Show file tree
Hide file tree
Showing 4 changed files with 7 additions and 4 deletions.
2 changes: 1 addition & 1 deletion docs/architecture/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,7 +149,7 @@ Can connect both the real-time and historical data to allow users to query acros

Return sensible errors when queries fail.

Use the deferred-response feature (V3.6) to avoid additional coding on the side of connecting non-kdb+ processes.
Use the [deferred-response]((../basics/internal.md#-30x-deferred-response) feature (V3.6) to avoid additional coding on the side of connecting non-kdb+ processes.

[Load-management](../kb/load-balancing.md): round-robin might not be the best option for your system.
Consider other options specific to your APIs and load.
Expand Down
5 changes: 4 additions & 1 deletion docs/kb/deferred-response.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Deferred response – Knowledge Base – kdb+ and q documentation
description: Ideally, for concurrency, all messaging would be async. However, sync messaging is a convenient paradigm for client apps. Hence -30!x was added as a feature in V3.6, allowing processing of a sync message to be ‘suspended’ to allow other messages to be processed prior to sending a response message.
description: Ideally, for concurrency, all messaging would be async. However, sync messaging is a convenient paradigm for client apps. Hence [-30!x](../basics/internal.md#-30x-deferred-response) was added as a feature in V3.6, allowing processing of a sync message to be ‘suspended’ to allow other messages to be processed prior to sending a response message.
author: Charles Skelton
keywords: async, concurrency, deferred, kdb+_, q, response, sync
---
Expand Down Expand Up @@ -64,5 +64,8 @@ callback:{[clientHandle;result]

:fontawesome-regular-hand-point-right:
Basics: [Internal `-30!x`](../basics/internal.md#-30x-deferred-response)
:fontawesome-regular-hand-point-right:
Blog: [Deferred Response](https://kx.com/blog/kdb-q-insights-deferred-response/)
<br>
[Namespace `.z`](../ref/dotz.md)

2 changes: 1 addition & 1 deletion docs/wp/ipc/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -377,7 +377,7 @@ q)h"a"

!!! tip "Deferred response"

[Deferred reponse](../../kb/deferred-response.md) with `-30!` allows a server to defer the response to a synchronous query, allowing other messages to be processed before responding. This is useful where synchronous messaging is necessary on the client side.
[Deferred reponse](../../kb/deferred-response.md) with [`-30!`](../../basics/internal.md#-30x-deferred-response) allows a server to defer the response to a synchronous query, allowing other messages to be processed before responding. This is useful where synchronous messaging is necessary on the client side.

An example implementation of deferred sync message handling is discussed in the blog [kdb+/q Insights: Deferred Response](https://kx.com/blog/kdb-q-insights-deferred-response/).

Expand Down
2 changes: 1 addition & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -456,6 +456,7 @@ nav:
- Overview: basics/ipc.md
- Callbacks: kb/callbacks.md
- Listening port: basics/listening-port.md
- Deferred response: kb/deferred-response.md
- Named pipes: kb/named-pipes.md
- Serialization examples: kb/serialization.md
- Server calling client: kb/server-calling-client.md
Expand All @@ -474,7 +475,6 @@ nav:
- Monitor & control execution: kb/using-dotz.md
- Coding:
- Data visualization (WP): wp/data-visualization/index.md
- Deferred response: kb/deferred-response.md
- Geospatial indexing: kb/geospatial.md
- Linear programming: kb/lp.md
- Multithreaded input: kb/multithreaded-input.md
Expand Down

0 comments on commit ea50b79

Please sign in to comment.