The ::DEBUG_CONNECTIONS table holds information about the connections that are available to the current debugger session.
Field Name |
Field Type |
Field Size |
Description |
user_id |
Integer |
4 |
Primary key of the table. It uniquely identifies the connection. |
conn_name |
CiChar |
50 |
Name of the connection. This value may be used in DEBUG commands where a connection_name value is required. The value in this column is unique to the table. The value is the same as the ::conn.name system variable. |
Status |
CiChar |
20 |
Status of this connection. Possible values for this column are: Suspended: The debuggee was suspended. The DEBUG RUN command may be issued on this debuggee to resume execution. Running (debug): The debuggee was running in debug mode and may be suspended using the DEBUG BREAK command. The execution may also suspend when a break point is encountered. Running: The connection is currently not running in debug mode. It is either not executing any statement currently or the connection is not a debuggee owned by the current debugger session. |
Type |
CiChar |
30 |
Type of this connection. Possible values are: Not in debug mode: The connection is not a debuggee. Debugging connection: The connection is a debuggee owned by the current debugger session and all query handles, when executing queries, will be running in debug mode. Debugging statements: The connection is a debuggee owned by the current debugger session but only certain query handles are being debugged. The query handles that are being debugged can be found in the ::DEBUG_STATEMENTS table. Debugged by other debugger: The connection is being debugged by other debugger. Connection is a debugger: The connection is a debugger. |
Debugger |
Integer |
4 |
A numeric representation of the connection type, values 0 – 4 repectively. |
If the current debugger session is on a database connection, the ::DEBUG_CONNECTIONS table will contain all connections to the same database. If the current debugger connection is a free connection, the ::DEBUG_CONNECTIONS table will only contain debuggees that are owned by the current debugger session.
If using Advantage Local Server, only connections in the same process will be in the table.
The debugger can retrieve the value from the conn_name column and put specified connection into debug mode if the debugger has sufficient privilege.