Gets header information from a Spatial+ object file.
Syntax
01 SPHANDLE PIC S9(9) BINARY.
01 OBJFILENAME PIC X(12).
01 OBJFILEHEADER.
02 USERDATA PIC X(256).
02 MAXHEAPSIZE PIC S9(9) BINARY.
02 MAXPOINTCOUNT PIC S9(9) BINARY.
02 MAXPOLYGONCOUNTPIC S9(9) BINARY.
02 XMIN PIC S9(9) BINARY.
02 YMIN PIC S9(9) BINARY.
02 XMAX PIC S9(9) BINARY.
02 YMAX PIC S9(9) BINARY.
02 COORDSYS PIC S9(9) BINARY.
02 FLAGS PIC S9(9) BINARY.
02 NUMPOINTS PIC S9(9) BINARY.
02 NUMLINES PIC S9(9) BINARY.
02 NUMREGIONS PIC S9(9) BINARY.
02 FILLR PIC X(5).
01 SPRETCODE PIC S9(9) BINARY.
*
CALL ‘SPOFQRY'
USING SPHANDLE, OBJFILENAME, OBFILEHEADER, SPRETCODE.
Arguments
SPHANDLE The handle returned by SPINIT for the current instance of Spatial+. Input.
OBJECTFILENAME The DD name of the object file to open. Input.
OBJECTFILEHEADER The structure to be filled with the header information.
Output.
Return Values
PIP-OK
PIP-ERROR
SPINIT.
Prerequisites
Alternates
None.
Notes
Fills the structure PIP-OBJECT-FILE-INFO-STRUCT with the file description information. The structure is as follows:
01 PIP-OBJECT-FILE-INFO-STRUCT.
05 POFI-USER-DATA PIC X(256)
05 POFI-HEAP-SIZE PIC S9(9) BINARY.
05 POFI-MAX-POINT-COUNT PIC S9(9) BINARY.
05 POFI-MAX-POLY-COUNT PIC S9(9) BINARY.
05 POFI-XMIN PIC S9(9) BINARY.
05 POFI-YMIN PIC S9(9) BINARY.
05 POFI-XMAX PIC S9(9) BINARY.
05 POFI-YMAX PIC S9(9) BINARY.
05 POFI-COORDSYS PIC S9(9) BINARY.
05 POFI-FLAGS PIC S9(9) BINARY.
05 POFI-NUM-POINTS PIC S9(9) BINARY.
05 POFI-NUM-LINES PIC S9(9) BINARY.
05 POFI-NUM-REGIONS PIC S9(9) BINARY.
05 POFI-RESERVED OCCURS 5 TIMES.
10 FILLER PIC S9(9) BINARY.
| Parameter | Explanation |
| USER-DATA | Data set by user-determined string. |
| HEAP-SIZE | Size of largest object (without buffer information). |
| MAX-POINT-COUNT | Number of points in largest object. Max points = 50000000. |
| MAX-POLYGON-COUNT | Maximum number of polygons in a single object. Max polygons = 16383. |
| XMIN | Geographic extent of the file. |
| YMIN | Geographic extent of the file. |
| XMAX | Geographic extent of the file. |
| YMAX | Geographic extent of the file. |
| COORDSYS |
This parameter is used to indicate which type of coordinates the points and responses will be given in. There are two possible settings: PIP-COORDS-USER—Coordinates are user defined, and Euclidean distances are returned in user units. PIP-COORDS-LL—Coordinates are in millionths of degrees, and distances are returned in feet. |
| Parameter | Explanation |
| FLAGS |
This is any combination of the following flags added together: PIP-IMPORT-BUFFERS creates buffer information in the file (and roughly triples the file's size). PIP-IMPORT-COMPRESS stores compressed information, but significantly slows processing speed. This parameter is recommended when batch speed is not an issue, such as in a real- time, interactive application. |
| NUM-POINTS | Number of point objects in the file. |
| NUM-LINES | Number of line objects in the file. |
| NUM-REGIONS | Number of region objects in the file. |
| RESERVED | Reserved for future use. |