DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_create - create a temporary data object.

LIBRARY CALL

kobject
kdms_create(void)

INPUT

none

OUTPUT

none

RETURN VALUE

kobject on success, KOBJECT_INVALID upon failure

DESCRIPTION

kdms_create is used to instantiate a data object (kobject) when it will only be used for temporary storage of information. If you are intending to process an object that already exists as a file or transport (input), or you are planning on saving the kobject to a file or transport (output), then the appropriate routines to use are kdms_input, kdms_output, or kdms_open.

This function creates an instance of a data object that will have associated with it a temporary transport that will be used for buffering large amounts of data. This temporary transport will be automatically removed when the process terminates. There is no way to rename the temporary file or replace the temporary file with a permanent one.

The kdms_create function call creates what is essentially a "blank" object. That is, the object will initially have no segments, and almost all global attributes will be initialized to default values. If a default is not appropriate, then the attribute will be uninitialized. The default values for attributes are described in Chapter 5 of Program Services Volume 2. of the Khoros 2.0 Manual.

An object that is created with this function call behaves similarly to an output object that is created with the kdms_output function call. Thus, it is necessary to create each segment that is desired and initialize attributes such as size and datatype prior to using the 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.