DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_destroy_location - destroy the location segment in a data object.

LIBRARY CALL

int kpds_destroy_location(
   kobject object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE if the location segment is successfully destroyed, FALSE otherwise

DESCRIPTION

This function is used to destroy the location segment contained within an object. Once the location segment has been destroyed, any data or attributes associated with the location data will be lost forever. A new location segment can be created in its place with the function kpds_create_location.

If the location segment does not exist in the specified object, it is considered to be an error.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kappserv/src/pds_location.c

SEE ALSO

kappserv(3)

COPYRIGHT

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