DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_close - close an open data object.

LIBRARY CALL

int
kdms_close(kobject object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE on success, FALSE otherwise

DESCRIPTION

This function is called on an object when all interaction with the object is completed. In addition to freeing resources that were used to manage the object, this function also, performs any "last minute" manipulation on the file or transport that is associated with the object.

If the object was created with the kdms_reference 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/objects/library/kdataman/src/public.c

SEE ALSO

kdataman(3)

COPYRIGHT

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