DATASERV (kappserv) functions
LIBRARY ROUTINE
kpds_close_object - close an open data object.
LIBRARY CALL
int kpds_close_object(
kobject object)
INPUT
- object - the object to be closed.
OUTPUT
none
RETURN VALUE
TRUE (1) if object is closed successfully, FALSE (0) otherwise
DESCRIPTION
This function is called on an object when all
interaction with the object is complete. In addition
to freeing resources that were used to manage the
object, this function also writes any component of
the data set that has not yet been written and may
alter index order and datatype of the data to that is
supported by the file format.
If the object was created with the
kpds_reference_object function call, or if another
object was created as a reference of the one being
closed, then the object might be sharing some of its
resources with other objects. If this is the case,
then those shared resources will not be freed, but
rather they will be disassociated from the object
being closed. Thus, closing an object does not
affect any other object.
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.