Opens a Spatial+ object file.
Syntax
01 PIPHANDLE PIC S9(9) BINARY.
01 OBJFILENAME PIC X(12).
01 SPFLAGS PIC S9(9) BINARY.
01 POLYHANDLE PIC S9(9) BINARY.
01 SPRETCODE PIC S9(9) BINARY.
*
CALL ‘SPOFOP'
USING PIPHANDLE, OBJFILENAME, SPFLAGS, POLYHANDLE, SPRETCODE.
Arguments
PIPHANDLE The handle returned by SPINIT for the current instance of Spatial+. Input.
OBJFILENAME The DDNAME of the file to be opened. Input.
SPFLAGS Flag settings, as listed below. Input.
| PIP-OPEN-HUGE-CACHE | This sets the largest cache for Spatial+ (100 MBs) and should be used when calling SPOFFCT a large number of times. |
| PIP-OPEN-LARGE-CACHE | This sets a large cache for Spatial+ (20 MBs) and should be used when calling SPOFFCT a large number of times. |
| PIP-OPEN-MEDIUM-CACHE | This sets a moderate cache (5 MBs) for Spatial+ and should be used when calling SPOFFCT with a small amount of available memory. |
| PIP-OPEN-NO-CACHE | This sets no cache for Spatial+ and should be used when accessing single objects using SPOFFREC or SPOFFNM. |
POLYHANDLE The handle of the opened object file. Output.
Return Values
PIP-OK
PIP-ERROR
SPINIT.
Prerequisites
Alternates
None.
Notes
This procedure opens a Spatial+ object file for use. The PIPHANDLE parameter contains a handle that is passed to all other SPO* procedures.
If the POLYHANDLE returns a zero value the application failed to open the object file.