int
kdms_copy_segment_data(
kobject sobject,
char *segment,
kobject dobject,
char *dsegment)
The first argument to this function is the source object. The third argument is the destination object. The second argument to this function determines which data segment will be copied. If this argument is NULL, then this instructs the kdms_copy_data function to copy the data for all segments to the destination object.
If a segment that is being copied already exists in the destination object, then the segment data is removed and replaced by the source's segment data. In this event, the physical attributes of the original data in the destination object will remain unchanged. The data will be automatically translated to fit the physical attributes that are already present.
If the destination object does not contain a segment that exists on the source object and that is being copied with this function, then the said segment will be created. In this event, the physical attributes that describe the new segment will be used to initialize the presentation attributes for the destination object.
Data Services attempts to minimize the number of attributes that are copied with the data, as there another function for that purpose (kdms_copy_attributes). However, as mentioned above, there are cases when it is necessary to copy certain attributes that are critical to the interpretation of the data. However, this should only occur when the destination does not have the segment or segments being copied.
none
none
$DATASERV/objects/library/kdataman/src/public.c