3.2.4.1.2.1 Client Performance Monitoring

The following blocks are sent from the client to the server in the rgbAuxIn parameter auxiliary buffer on the EcDoConnectEx method to support client performance monitoring. Each of these auxiliary blocks MUST be preceded by a properly formatted AUX_HEADER structure. The client can fill reserved fields in these blocks with any value when writing the stream (2).

Auxiliary block structure

Description

AUX_PERF_CLIENTINFO

(section 2.2.2.2.4)

Sent to the server as diagnostic information about the client for more robust reporting of networking issues.<32> The client MUST assign a unique client identifier for each AUX_PERF_CLIENTINFO block sent to the server. The client identifier is also used in other performance blocks to identify which client to associate the performance data with.

AUX_PERF_PROCESSINFO

(section 2.2.2.2.6)

Sent to the server as diagnostic information about the client process for more robust reporting of networking issues. The client MUST assign a unique process identifier for each AUX_PERF_PROCESSINFO auxiliary block structure sent to the server. The process identifier is also used in other performance blocks to identify which client process to associate the performance data with.

AUX_PERF_SESSIONINFO

(section 2.2.2.2.2)

Sent to the server as diagnostic information about the client session for more robust reporting of networking issues. The client MUST assign a unique session identifier for each AUX_PERF_SESSIONINFO or AUX_PERF_SESSIONINFO_V2 auxiliary block structure sent to the server. The session identifier is also used in other performance blocks to identify which client session to associate the performance data with.

It is recommended that the AUX_PERF_SESSIONINFO_V2 auxiliary block structure be used instead of this block structure. A server still supports this older session information auxiliary block.

This block can also be passed in the EcDoRpcExt2 method auxiliary input buffer (section 3.1.4.2.1.1.3).

AUX_PERF_SESSIONINFO_V2

(section 2.2.2.2.3)

Sent to the server as diagnostic information about the client session for more robust reporting of networking issues. The client MUST assign a unique session identifier for each AUX_PERF_SESSIONINFO_V2 or AUX_PERF_SESSIONINFO auxiliary block structure sent to the server. The session identifier is also used in other performance blocks to identify which client session to associate the performance data with.

This block can also be passed in the EcDoRpcExt2 method auxiliary input buffer.

AUX_CLIENT_CONNECTION_INFO

(section 2.2.2.2.21)

Sent to the server as information about the client connection to be logged by the server.<33>

AUX_PROTOCOL_DEVICE_IDENTIFICATION

(section 2.2.2.2.23)

Sent to the server as diagnostic information by any device or system operating between the client and the server.