After allocating a context structure, a Client-Library application can call cs_config to set CS-Library properties for the context structure.
Context properties define aspects of an application’s behavior at the context level. firstapp.c calls cs_config to set the CS_MESSAGE_CB property. This property defines a CS-Library message callback routine. An application needs to set this property if it will be handling CS-Library errors using the callback method. For more information, see Chapter 4, “Handling Errors and Messages.”
You may need to code your application to set other CS-Library context properties as well. Besides CS_MESSAGE_CB, applications most commonly set the following properties with cs_config:
CS_LOC_PROP – describes localization information for the context. An application must set this property if a context requires localization information that differs from the localization information that is available in the operating system environment. For example, if an application that is running in a German environment requires a French context, it can call cs_config to set the CS_LOC_PROP property.
CS_EXTERNAL_CONFIG – specifies whether ct_init will read default application property settings from the OCS runtime configuration file. See “External configuration” for more information.
CS_APP_NAME – specifies a name for the application. If external configuration is enabled (CS_EXTERNAL_CONFIG is CS_TRUE), then the application name specifies a section of the configuration file from which to read settings. CS_APP_NAME is also inherited by allocated CS_CONNECTION structures.
For more information about CS-Library properties, see cs_config in the Open Client and Open Server Common Libraries Reference Manual.
