sa_conn_properties system procedure

Reports connection property information.

Syntax
sa_conn_properties( [ connidparm ] )
Arguments
  • connidparm   Use this optional INTEGER parameter to specify the ID number of a connection.

Result set
Column name Data type Description
Number INTEGER The ID number of the connection.
PropNum INTEGER The connection property number.
PropName VARCHAR(255) The connection property name.
PropDescription VARCHAR(255) The connection property description.
Value LONG VARCHAR The connection property value.
Remarks

Returns the connection ID as Number, and the PropNum, PropName, PropDescription, and Value for each available connection property. Values are returned for all connection properties, database option settings related to connections, and statistics related to connections. Valid properties with NULL values are also returned.

If no connidparm is supplied, properties for all connections to the current database are returned. If connidparm is less than zero, option values for the current connection are returned.

Permissions

None

Side effects

None

See also
Examples

The following example uses the sa_conn_properties system procedure to return a result set summarizing connection property information for all connections.

CALL sa_conn_properties( );
Number PropNum PropName ...
79 37 CacheHits ...
79 38 CacheRead ...
... ... ... ...

This example uses the sa_conn_properties system procedure to return a list of all connections, in decreasing order by CPU time*:

SELECT Number AS connection_number,
    CONNECTION_PROPERTY ( 'Name', Number ) AS connection_name,
    CONNECTION_PROPERTY ( 'Userid', Number ) AS user_id,
  CAST ( Value AS NUMERIC ( 30, 2 ) ) AS approx_cpu_time
  FROM sa_conn_properties()
  WHERE PropName = 'ApproximateCPUTime'
  ORDER BY approx_cpu_time DESC;

*Example courtesy of Breck Carter, RisingRoad Professional Services ([external link] http://www.risingroad.com).