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
- object - object in which to create the location segment.
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.