DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_sync - synchronize physical and presentation layers of a data object.

LIBRARY CALL

int
kdms_sync(
   kobject object,
   char   *segment,
   int     direction)

INPUT

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.