DATASERV (kappserv) functions


LIBRARY ROUTINE

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

LIBRARY CALL

int kpds_sync_object(
   kobject object,
   int direction)

INPUT

OUTPUT

none

RETURN VALUE

TRUE (1) if object sync'ed, FALSE (0) otherwise

DESCRIPTION

This function is used to update physical attributes of the entire data object to match those of the presentation layer, or visa-versa.

When an attribute is set via kpds_set_attribute(s) or kpds_copy_object_attr, the presentation version of the attribute is the only thing that is directly manipulated. The KPDS_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 or vice versa. The KPDS_COUPLING attribute can take on one of three values: KUNCOUPLED, KCOUPLED, or KDEMAND. If it is set to KUNCOUPLED or KDEMAND, then Polymorphic Services will not update the physical layer. If the attribute is set to KCOUPLED, then Polymorphic Services immediately updates the physical layer any time kpds_set_attribute(s) is called. If the attribute is set to KDEMAND, then this updating will only occur when kpds_sync_object is called. If the KPDS_COUPLING attribute is set to KUNCOUPLED, then this routine will simply return and an error message will be returned.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/include/kappserv/kpolymorphic.h

SEE ALSO

kappserv(3)

COPYRIGHT

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