Skip to content

Commit

Permalink
moved deferred response, add links to ref material
Browse files Browse the repository at this point in the history
  • Loading branch information
sshanks-kx committed Jun 26, 2024
1 parent ed44845 commit 1e6772e
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 @@ -387,7 +387,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 @@ -454,6 +454,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 @@ -473,7 +474,6 @@ nav:
- Using .z: 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 1e6772e

Please sign in to comment.