3.2.4.4 Synchronizing Client RecordSet Changes to the Server

The RDS Transport Protocol client uses the processing sequence described in section 3.2.4.2 to populate a RecordSet. The RDS Transport Protocol client SHOULD expose a synchronize method (see section 3.3.5.5). The Synchronize method provides a method to synchronize the client cache version of data with the server. The client can group together any number of changes and apply all of those changes in one batch back to the server. The RDS Transport Protocol client MUST provide the following:

The client MUST establish a connection to the RDS Transport Protocol server, as specified in section 3.2.4.1. If the connection attempt fails, the RDS Transport Protocol client MUST notify the calling application.

Upon establishing the connection, the client MUST create a TableGram from the RecordSet (see section 3.1.1.2.3) and send the TableGram to the RDS Transport Protocol server using the rdsSynchronizeRequest message (see section 2.2.3.5).

If the server responds with an error, the RDS Transport Protocol client MUST return that error to the higher-level application. The server will respond with an rdsSynchronizeResponse (see section 2.2.3.6). The client MUST process the rdsStatusArray (see section 2.2.3.13.10) and make appropriate changes to the RecordSet (see section 3.1.1.2).