22.214.171.124 Synchronizing Client RecordSet Changes to the Server
The RDS Transport Protocol client uses the processing sequence described in section 126.96.36.199 to populate a RecordSet. The RDS Transport Protocol client SHOULD expose a synchronize method (see section 188.8.131.52). 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:
SQL command (see section 184.108.40.206.8)
SQL command parameters array (see section 220.127.116.11.7).
The client MUST establish a connection to the RDS Transport Protocol server, as specified in section 18.104.22.168. 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 22.214.171.124.3) and send the TableGram to the RDS Transport Protocol server using the rdsSynchronizeRequest message (see section 126.96.36.199).
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 188.8.131.52). The client MUST process the rdsStatusArray (see section 184.108.40.206.10) and make appropriate changes to the RecordSet (see section 220.127.116.11).