Equinox Online Help - Language Reference - A to Z

Home

ConnectionID

Applies to
SyntaxConnectionId
Action[Function] Returns the client/ server connection identifier for the current client
ScopeUsable anywhere
Notes

This function returns a unique number, identifying the connection between the current Equinox client and the Equinox server. Normally, messages are directed to users based on their user name, but this connection number may be used instead with the advantage that it differentiates between stations that have logged in under the same name.

Note that this number is not a logical entity, but defines a connection slot. This means that if user logs out, the connection number may be reallocated to another user logging in. If this happens, messages sent to the first user's connection number will be received by the second user. To avoid this, stations should normally be identified by login names rather than connection numbers.

CategoryClient - Server
See Also FirstAttachedUser, IsNetwork, IsUserAttached, IsUserGroupAttached, NextAttachedUser, RemoveAttachedUser
Example

The following example sends a message to the sender of the last message retrieved, informing them of the current user's connection id.

QueueMessage, "My connection is "&ConnectionId, ToSender