VASResult shore_vas::appendObj( const lrid_t &obj, const vec_t &data ); VASResult shore_vas::appendObj( const lrid_t &obj, const vec_t &data, ObjectOffset newtstart );
The argument data is a gather vector that identifies the data in the caller's address space that is to be appended to the object. There is a run-time-defined limit to the size of this vector; the size is limited by the size of the TCP socket buffers used by the server and the client, when the server is remote. It is limited by the amount of shared memory allocated for communication with the server, when the server is local. If these limits are not acceptable, use the method updateObj instead.
The vectors may be empty.
AppendObj can change the location of the TEXT portion of the object. If the argument newtstart is given, it indicates the new location of the beginning of the TEXT attribute.
An exclusive lock is acquired before the append occurs.
All these methods are available on both the server and clients.
All forms of appendObj must be called when a transaction is active.
A complete list of errors is in errors(svas).