The c8-services.xml configuration file contains preferences related to interfacing Sybase CEP with other systems.
Database Servers:
Oracle Database Servers (natively, or via ODBC).
Other database servers (for example, MySQL, PostgresSQL, and SQLServer) via ODBC.
RPC servers.
Sybase CEP Server treats an external data source (or data destination) as a "service". For each service, the c8-services.xml file must contain a unique "service name", along with the information required to access that service (for example, username, password, and so on). The Sybase CEP Installation Guide describes how to configure your c8-services.xml file with the service name and most other information needed to access remote database servers and RPC servers.
The Sybase CEP Installation Guide does not describe configuration preferences for the HTTP plugin and the SOAP plugin, either of which can be used to call remote procedures on RPC servers. Those HTTP plugin and SOAP plugin configuration preferences are described here.
The generic HTTP plugin expects the following configuration preferences in the c8-services.xml file:
|
HttpURI |
Required |
This is the HTTP URI to which the request should be sent. For example: http://localhost/cgi-bin/getStock-Price.cgi |
|
HttpTimeout |
Optional |
Specifies the HTTP connection timeout, either an integer specifying the number of seconds or in the following format: [D day[s]][ ][HH hour[s]][ ][MM minute[s]][ ][SS[.FF] second[s]] For example, "3 minutes 12.5 seconds". The default value is 30 seconds. |
|
HttpKeepAlive |
Optional |
TRUE or FALSE, indicating whether to use keep-alive connections. The default value is FALSE. |
|
HttpEnableRedirects |
Optional |
TRUE or FALSE, indicating whether to follow redirects. The default value is TRUE. |
|
HttpEnableLogging |
Optional |
TRUE or FALSE, indicating whether to log arguments and return values for all plugin calls. The default value is FALSE. |
|
HttpEnableDebugging |
Optional |
TRUE or FALSE, indicating whether to print debug information from the plugin (for example, request/response dumps). The default value is FALSE. |
|
HttpRequestHeaders |
Optional |
Specifies extra HTTP request headers. Multiple headers must be separated with the 2-character sequence Carriage Return and Line Feed (represented as "\r\n below). For example, Accept: text/xml\r\n SOAPAction:"TempConvert#f2c" |
The generic SOAP plugin expects the following configuration preferences in the c8-services.xml file:
|
SoapUri |
Required |
Indicates the URI of the SOAP resource. |
|
SoapMethod |
Required |
Specifies the name of the SOAP method to call, For example, GetStockPrice . |
|
SoapAction |
Optional |
Indicates the SOAPAction HTTP header. The default value is <SoapURI>#<SoapMethod>. |
|
SoapVersion |
Optional |
Indicates the version of SOAP in use, either 1.1 or 1.2. |
|
SoapMethodNamespace |
Optional |
Indicates the namespace to use for the method node. Defaults to the same value as SoapUri. If you set this to the empty string, then the method node is written without a namespace. |
|
SoapValuesNamespace |
Optional |
Indicates the namespace to use for the values node. Defaults to the same value as SoapMethodNamespace. If you set this to the empty string, the values node is written without a namespace. |
|
SoapEncodingStyle |
Optional |
"Document" (the default) or "Rpc", Specifies the encoding style for the SOAP request and response, either defaults to "document" or "Rpc". |
|
SoapXsdNamespace |
Optional |
Specifies the xsd namespace URI. The default value is http://www.w3.org/2001/XMLSchema. Old SOAP servers may require the old version, which is: http://www.w3.org/1999/XMLSchema |
|
SoapXsiNamespace |
Optional |
Specifies the xsi namespace URI. The default value is http://www.w3.org/2001/XMLSchema-instance However, old SOAP servers might require the old version, which is: http://www.w3.org/1999/XMLSchema-instance |
|
SoapDotNet20Compat |
Optional |
TRUE or FALSE, indicating whether .NET3 compatibility mode should be enabled. .NET3 compatibility mode causes timestamps to be generated without time zones. The default value is FALSE. |
|
SoapTimestampFormat |
Optional |
Specifies the timestamp string serialization format, for example: YYYY-MM-DDTHH24:MI:SS.FFZTZH:TZM The default value is the default SOAP format, which requires the "T" before the hour and the "Z" before the time zone information. These extra characters are compatible with the Sybase CEP format; Sybase CEP treats them as literals.) |
The remote service entry can be configured for a number of additional settings, as described in the Sybase CEP Installation Guide section titled "Setting Optional Preferences for Services".
To learn the syntax of RPC and Database statements and subqueries, refer to Sybase CEP CCL Reference Guide .