DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_output - open an input object for writing

LIBRARY CALL

kobject kdms_output(
   char *name)

INPUT

OUTPUT

none

RETURN VALUE

a kobject on success, KOBJECT_INVALID on failure.

DESCRIPTION

This function is a simplified interface to the kdms_open function. It differs in that it assumes that the object is write-only and its transport has permenance. If a permanent file is not desired (i.e. the object is going to be used as temporary storage, and will not be used by any other process) then the kdms_create function call should be used instead.

The argument to this function is the transport or file name. This argument indicates the name of the transport that is associated with the object. The transport name can be any legal khoros transport description. While this will usually be a regular UNIX file name, it is also possible to specify such things as shared memory pointers, memory map pointers, sockets, streams, and even transports on other machines. For more information on the syntax of a Khoros transport name, refer to the online man page for the Khoros function kopen. For more information, see kdms_open.

This function is equivalent to:

kdms_open(name, KOBJ_WRITE)

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/include/kdataman/kdataman.h

SEE ALSO

kdataman(3)

COPYRIGHT

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