Gateway tokens

A Gateway token represents a single connection to a specific Gateway daemon.

When a connection to a Gateway daemon is made, all subsequent C API calls that retrieve statistical data must include the Gateway token as a parameter.

The statistics C API handler in a Gateway daemon is restricted to five connection threads. This means that a single Gateway daemon can only deal with five connected statistics C API programs, or threads, at the same time.

A statistical C API program should avoid holding more than one connection to the same Gateway daemon at the same time.

A statistical C API program can hold multiple Gateway tokens, but can only use them on the thread that called the openGatewayConnection or openRemoteGatewayConnection to retrieve the token.

A Gateway token type (CTG_GatewayToken_t) is defined in the C language header files.