Back to Server Commands
CMD_SERVER_SET_SORT

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.

|Top|