Command: CMD_SERVER_SET_SORT Destination: SD_SERVER Destination Channel: n/a
Description
This command is used by clients to set the server's data message
sorting behavior. During normal operation, blocks of messages are
transferred from each channel. If multiple messages are retrieved
from channels during a cycle, the resulting stream of data
messages to the client may not be chronologically sorted.
By enabling server sorting with this command, a minimal sort is
performed by the server before blocks of messages are sent to the
client. A maximum of sixteen messages per block will be
sorted.
Server sorting behavior can be set on a per client basis. Each
client requiring message sorting must enable it.
NOTE: Enabling sorting WILL impact maximum throughput from
Gryphon due to the extra CPU time required to perform the sort.
Command data format
Sort mode : 1 byte.
Sort mode = 0: No sorting performed (default).
Sort mode = 1: Blocks of up to 16 messages sorted.
Response data format
None (no response data).
Response return codes
RESP_OK Execution of the command was successful. RESP_UNKNOWN An unknown error occurred.