An application calls ct_con_props to set, retrieve, or clear connection structure properties.
Connection properties define various aspects of a connection’s behavior. For example:
The CS_USERNAME property defines the user name that a connection will use when logging in to a server.
The CS_APPNAME property specifies the application name that appears in Adaptive Server’s sysprocess table after the connection is opened.
The CS_PACKETSIZE property defines the Tabular Data Stream™ (TDS) packet size, which determines the size of network packets that the application will send and receive over this connection.
When a connection structure is allocated, it picks up some default property values from its parent context. For example, if the CS_APPNAME property is set at the context level, all connection structures allocated from that context inherit the application name. Other properties that do not exist at the context level, such as CS_PACKETSIZE, default to standard Client-Library values.
For a complete list of connection properties, see the ct_con_props reference page in the Open Client Client-Library/C Reference Manual.