Documentation Changes

In the section on obtaining a license, the Installation Guide now includes information on how to obtain a license from the SAP Service Marketplace (SMP).

The section on the RAP adapter shows you how to stop the RAP adapter when it is running in the background. The Adapters Guide incorrectly states that you can stop it by entering kill -11 processID in the command line.

The correct command is:

kill -15 processID

When you create a duplicate named window or stream in the Visual Editor, then save your file and switch to the Text Editor, a third duplicate of the original stream or window is created. You can see this third duplicate only when you switch back to the Visual Editor.

Studio returns an error when a project refers to a schema from an imported file but the project compiles without errors.

Refresh the file by closing the project. Alternatively, create the files in the opposite order.

The Studio Users Guide incorrectly indicates that the correct format for entering a tooltip comment is:

//**InsertTooltipCommentHere*/ 

The correct format is:

/**InsertTooltipCommentHere*/

Delta streams are allowed key transformation only when performing aggregation, join, or flex operations. Because a delta stream does not maintain state, you cannot define a delta stream on a window where the keys differ.

This guide documents the argName argument of the CREATE LIBRARY statement as required:

CREATE LIBRARY libraryName LANGUAGE {C|JAVA} FROM fileName(
returnType funcName (argType argName,...);
...);

This is an optional argument, and should be documented as [argName]:

CREATE LIBRARY libraryName LANGUAGE {C|JAVA} FROM fileName(
returnType funcName (argType [argName],...);
...);

There are undocumented restrictions on user name and password credentials for the interactive mode of the esp_cluster_admin tool. Credentials may contain alpha numeric characters but must always start with an alphabetic character. For example, password 12345678 is invalid, whereas P12345678 is valid.

References to the "port number used by your Event Stream Processor installation" are referring to the port number of your cluster cache.

The guide should state:

In general terms, the return code from a Publish call indicates whether or not the row was successfully transmitted. Any error that occurs during processing on the Event Stream Processor (such as a duplicate insert) will not get returned. The precise meaning of the return code from a Publish call depends on the access mode and the choice of synchronous or asynchronous transmission.

When using callback or select access mode, the return only indicates whether or not the SDK was able to queue the data. The indication of whether or not the data was actually written to the socket will be returned by the appropriate event. The callback and select access modes do not currently support synchronous publishing.

When using direct access mode, the type of transmission used determines what the return from the Publish call indicates. If publishing in asynchronous mode, the return only indicates that the SDK has written the data to the socket. If publishing in synchronous mode, the return from the Publish call indicates the response code the Event Stream Processor sent.

In no case will errors that occur during processing (such as a duplicate insert) be returned by a Publish call.

There are undocumented restrictions on user name and password credentials for the interactive mode of the esp_cluster_admin tool. Credentials may contain alpha numeric characters but must always start with an alphabetic character. The document also provides an invalid sample password of 1234.

The command-line help for esp_convert, esp_upload, and esp_subscribe mention options -1 and -2, which are no longer supported and should not be used. These options have been removed from the documentation.