DATASERV (kdataman) functions


LIBRARY ROUTINE

kdms_set_segment - assign information to a segment directly

LIBRARY CALL

int
kdms_set_segment(
   kobject object,
   char   *segment,
   int     dimension,
   int    *size,
   int    *order,
   int     datatype,
   kaddr   data)

INPUT

OUTPUT

none

RETURN VALUE

TRUE if successful, FALSE otherwise

DESCRIPTION

This function is used to directly assign information to a data segment. This should only be done inside of file format glue routines, in their input routine. The characteristics are assigned directly to the new segment. The segment will be created if it does not yet exist.

The data argument is optional, as the data retrieval can either be defered until it is needed, or, if the large data set function locate_segment() is defined for that format, the large data set management will be handle all reading.

Be careful when using this routine, as its misuse can easily corrupt a data object.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kdataman/src/segment.c

SEE ALSO

kdataman(3)

COPYRIGHT

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