DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_copy_segment_data - copy data from one data object to another.

LIBRARY CALL

int
kdms_copy_segment_data(
   kobject sobject,
   char   *segment,
   kobject dobject,
   char   *dsegment)

INPUT

OUTPUT

RETURN VALUE

TRUE on success, FALSE otherwise

DESCRIPTION

This function copies data associated with one segment or all segments from a source object to a destination output object.

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.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kdataman/src/public.c

SEE ALSO

kdataman(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.