DATASERV (kappserv) functions


LIBRARY ROUTINE

kpds_create_location - create a location segment within a data object.

LIBRARY CALL

int kpds_create_location(
   kobject object)

INPUT

OUTPUT

none

RETURN VALUE

TRUE if the location segment was successfully created, FALSE otherwise

DESCRIPTION

This function is used to create a location segment within a specified data object. The size of the location segment will be initialized to match any the sizes shared with any other polymorphic segments.

Either uniform, rectilinear, or curvilinear location grids can be created. The attribute KPDS_LOCATION_GRID should be set to the desired grid type of either KUNIFORM, KRECTILINEAR, or KCURVILINEAR, before calling kpds_create_location(). By default, if the grid attribute is not set, curvilinear location will be created.

It is considered an error to create a location segment if the object already contains one.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DATASERV/objects/library/kappserv/src/pds_location.c

SEE ALSO

kappserv(3)

COPYRIGHT

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