kdms_sync - synchronize physical and presentation layers of a data object.
LIBRARY CALL
int
kdms_sync(
kobject object,
char *segment,
int direction)
INPUT
object - data object to be resynchronized.
segment - segment re-synchronize. If this is
set to KDMS_OBJECT, then all segments
are re-synchronized.
direction - the desired direction of the synchronization.
the legal values are KPRES2PHYS, which
indicates that the physical layer will be
updated to correspond to the presentation
layer; and KPHYS2PRES, which indicates
that the presentation layer will be updated
to correspond to the physical layer.
OUTPUT
none
RETURN VALUE
TRUE on success, FALSE otherwise
DESCRIPTION
This function is used to update physical
attributes of a data object to match those
of the presentation layer, or visa-versa.
When an attribute is set via kdms_set_attribute(s)
or kdms_copy_attribute(s) calls, the presentation
version of the attribute is the only thing
that is directly manipulated. The KDMS_COUPLING
attribute is used at that time to determine if
the physical attribute should be updated to
correspond to its value at the presentation
level. The KDMS_COUPLING attribute can take
on one of three values: KUNCOUPLED, KCOUPLED, or
KDEMAND. If it is set to KUNCOUPLED or KDEMAND,
then Data Services will not update the physical
layer. If the attribute is set to KCOUPLED, then
data services immediately updates the physical
layer. If the attribute is set to KDEMAND,
then this updating will only occur when kdms_sync
is called. If the KDMS_COUPLING attribute is
set to KUNCOUPLED, then this routine will simply
return, without issuing an error message.
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.