0% found this document useful (0 votes)

3K views

SpatialNET Administration Guide

Uploaded by

a23780

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

3K views

SpatialNET Administration Guide

Uploaded by

a23780

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 69

Installation and Administration Guide

Release 6.1

1994-2013 SPATIALinfo, Pty. Limited, All Rights Reserved

Proprietary Notice
This Software and Related Documentation are proprietary to and the copyright of SPATIALinfo Pty Limited.
Suite 9 & 10
23-25 Gipps Street
Collingwood Vic 3066
Australia
A.B.N. 65 071 977 921
Restricted Rights Legend: Use, duplication or disclosure by the US Government is subject to restrictions as set forth in
FAR and DFAR concerning the use of commercial computer software, documentation and data as applicable, including
FAR 12.212 and DFAR 227.7202.
This document is provided under license from SPATIALinfo Pty Limited (SPATIALinfo). This document is, and shall
remain, the exclusive property of SPATIALinfo. Its use is governed by the terms of the applicable license agreement. Any
copying of this document, or disclosure to third parties, except as permitted in the applicable license agreement, is
expressly prohibited. The information contained in this document and software functions described are subject to
change without notice and should not be construed as a commitment by SPATIALinfo. SPATIALinfo assumes no
responsibility for any errors or omissions that may appear in this document.

Table of Contents
Overview and Requirements .................................................................................................... 7
Prerequisites ................................................................................................................................................... 7
Acronyms ........................................................................................................................................................ 7
Related documentation ................................................................................................................................... 7

The spatialNET database......................................................................................................... 8

Architecture ....................................................................................................................................................8
Oracle RDBMS releases ........................................................................................................................9
Create the database ........................................................................................................................................9
Create the database table spaces .........................................................................................................9
spatialNET Oracle user roles ............................................................................................................... 10
The spatialNET schema ...................................................................................................................... 12
Create the administrator application user ........................................................................................... 14
Define available spatial reference systems for earth-based spatial coordinates.................................. 15
Create the DBMS configuration file .................................................................................................... 16
spatialNET-supplied scripts ........................................................................................................................... 17

Install spatialNET application and associated software ............................................................. 19

Prerequisites and system requirements ......................................................................................................... 19
Install Oracle client ........................................................................................................................................ 19
Set up tnsnames.ora for new database connections ...................................................................................... 20
Verify the Oracle Connection ......................................................................................................................... 21
Install AutoCAD Map 3D ................................................................................................................................ 21
Install spatialNET .......................................................................................................................................... 21
Copy the license .ini file ................................................................................................................................. 24
Launch spatialNET ........................................................................................................................................ 24
Create a spatialNET Log File .......................................................................................................................... 25
Troubleshooting OS error 127 ........................................................................................................................ 26

Post and publish jobs ............................................................................................................. 27

Publish a job .................................................................................................................................................. 27
Post a job ...................................................................................................................................................... 28
View publish or post conflicts ............................................................................................................. 29

spatialNET Batch Queue Manager (BQM) ................................................................................ 30

Batch Queue Manager components .............................................................................................................. 30
Install Batch Queue Manager (BQM) ............................................................................................................. 31
View batch queue status ................................................................................................................................ 31
Start a queue ................................................................................................................................................. 31
Data Model.................................................................................................................................................... 33
The BATCH_QUEUE table .................................................................................................................. 33
The BATCH_QUEUE_ENTRY table ..................................................................................................... 33
Starting and stopping the BQM ..................................................................................................................... 34
Process Flow ................................................................................................................................................. 34
Security ......................................................................................................................................................... 36
Batch queue logging ...................................................................................................................................... 36

4 of 69

SPATIALinfo Inc.

The BQM as a background service ................................................................................................................. 37

Installation of the Batch Monitor ........................................................................................................ 37
Multiple copies of the Batch Monitor .................................................................................................. 38
Batch Monitor configuration ............................................................................................................... 38
The batch queue process model ......................................................................................................... 40
Batch Monitor log messages ............................................................................................................... 41
Monitor batch queue events ............................................................................................................... 41

Optimize for Oracle Spatial..................................................................................................... 44

Spatial data is object data.............................................................................................................................. 44
SDO_GEOMETRY ......................................................................................................................................... 44
Metadata configuration ................................................................................................................................. 44
USER_SDO_GEOM_METADATA ....................................................................................................... 45
SRID 45
GTYPE 45
Spatial index analysis.......................................................................................................................... 45
Oracle spatial index implementation ..................................................................................................46
Specifying spatial index table space...............................................................................................................46
Errors occurring while creating or rebuilding an index .........................................................................46
Direct storage only ........................................................................................................................................46
Maintain performance ...................................................................................................................................46
Maintain database statistics ............................................................................................................... 47
Rebuild R-tree indexes ........................................................................................................................ 47
Rebuild the spatial index ..................................................................................................................... 47
Oracle Cost Based Optimizer settings ................................................................................................. 48

The spatialNET JMS Administration Tool ................................................................................. 50

List all users ................................................................................................................................................... 51
Create a new user .......................................................................................................................................... 51
View user details............................................................................................................................................ 51
Edit user details ............................................................................................................................................. 52
Change a password ....................................................................................................................................... 53
Reset a password ........................................................................................................................................... 53
Delete a user ................................................................................................................................................. 53
User types in the security model .................................................................................................................... 53
Create a security group .................................................................................................................................. 54
Edit a security group ...................................................................................................................................... 55
Delete a security group .................................................................................................................................. 56
Delete removed entities ................................................................................................................................ 57
Remove a JMS job operations lock ................................................................................................................ 57
View information about the current selection ................................................................................................ 58
Debugging tools ............................................................................................................................................ 58
Viewing job type definitions .......................................................................................................................... 58
View user type definitions ............................................................................................................................. 59
Find and edit field Jobs .................................................................................................................................. 59
Job administration ......................................................................................................................................... 59
View all your current jobs .................................................................................................................... 59

SPATIALinfo Inc.

5 of 69

Find a job ............................................................................................................................................60

Create a new job ................................................................................................................................. 61
Edit a job62
View details for a job .......................................................................................................................... 62
Reset a job .......................................................................................................................................... 63

Troubleshooting ................................................................................................................... 64
Cannot open a job because it is already open .................................................................................................64
Database shutdown causes batch queue to lock up .......................................................................................64
Reset queue where a session has crashed ......................................................................................................64
Missing symbol xxx appears beside symbols in spatialNET views ................................................................64

Table of Figures ..................................................................................................................... 65

Appendix: use Oracle Net Configuration Assistant to set up the tnsnames.ora file....................... 67

6 of 69

SPATIALinfo Inc.

Overview and Requirements

This manual provides guidelines for installation of spatialNET 6.1. and includes descriptions of
various Administrator tasks available in the application.

Prerequisites
Users of this manual should be advanced users of Oracle Relational Database Management System
and Oracle Locator/Spatial. They also should be comfortable using basic Oracle administrative
commands and running SQL scripts.

Acronyms
Acronym
EAM
JMS
RDBMS
SDO
SQL

Description
Entity Abstraction Manager
Job Management System
Relational Database Management System
Spatial Data Object
Structured Query Language

Table 1: Acronyms

Related documentation
Document name
spatialNET release notes

System hardware and thirdparty software requirements

spatialNET Access Manager
User Manual
spatialSUITE License Manager

Description
Provides installation and configuration information specific to the
accompanying spatialNET release. Details of functional enhancements,
fixed problems and known limitations are included in the document.
Describes supported platforms and system requirements.
Describes the use and configuration of the spatialNET Access Manager for
spatialNET licensing.
Describes the installation, activation, and use of the Server Access Manager
to manage product user licenses.

Table 2: Related documentation

SPATIALinfo Inc.

7 of 69

The spatialNET database

The information listed below is necessary to complete the instructions outlined in this chapter.

Release version of Oracle RDBMS server to host spatialNET

Release version of Oracle Client installed for spatialNET workstations

Oracle System Password

Oracle User for spatialNET schema owner

The names that you plan to give to table spaces for spatialNET

spatialNET schema owner password

Directory location for database table spaces

Target Geographical Coordinate System for spatialNET schema

Architecture
spatialNET uses an Oracle client installation on the PC, with Oracle Net connecting to the Oracle
Server.

Figure 1 : Client / server relationship for Oracle Spatial / Locator driver

This client-server configuration requires installation of the following items:

The spatialNET Windows application on the client PC

The Oracle Client on the client PC (requires the Administrator or Run-Time installation. See
Install Oracle client).

Oracle Database Server on the Server

8 of 69

SPATIALinfo Inc.

Oracle RDBMS releases

The spatialNET Oracle Spatial driver has been tested with the following Oracle RDBMS releases:

Oracle 11g Release 2 Standard and Enterprise Editions

Oracle 11g Release 1 Standard and Enterprise Editions

Oracle 10g Release 2 Standard and Enterprise Editions

For up-to-date system requirements, see the document titled System Hardware and Third-party
Software Requirements.
The spatialNET database requires Oracle Locator, which is a standard component of Oracle
Standard Edition and Enterprise Edition. It does not require the Oracle Spatial option.

Create the database

This section provides instructions for configuring the Oracle RDBMS to support spatialNET. It
includes the tasks listed below.

Create the database table spaces

Create user roles

Create the admin role and admin user

Create the schema

Create the DBMS config file.

Create the database table spaces

If a spatialNET table space does not already exist, create a table space that will include spatialNET
database server objects. You can give it any name. Designate it as the default table space for the
spatialNET schema.
To create database table spaces, the system administrator must have appropriate Oracle privileges.

NOTE: A database block size of 16K or more is recommended.

Follow these steps to create a tablespace for spatialNET database server objects.
1.

Log in to SQL*Plus with the following command, replacing <sys_password> with the
password of the system user:
sqlplus system/<sys_password>

Create the following parameters for the table space:

CREA TE TAB LE SP AC E <t abl e s pac e na me>

DATA FIL E < tab le s pace fi len ame >
SIZE 20 48M
AUTO EXT END ON N EX T 10 24M
MAXS IZE UN LIM IT ED ;

SPATIALinfo Inc.

9 of 69

NOTE: Replace <table space name> with the name of the table space. Replace <table space
filename> with the complete path, filename, and extension (DBF) for the table space.
Depending on the host platform environment and disk storage configuration, it may be helpful to
create table spaces for the following object types:

non-spatial (aspatial) indexes

spatial indexes

work table space for construction of spatial indexes

materialized views or materialized view logs

external tables

For more information on database sizing, consult your Oracle documentation.

spatialNET Oracle user roles

Create user roles after creating table spaces. spatialNET identifies Object and System Grants for four
types of Oracle users. Those user types and their roles are as follows:

Read Access: spatialnet_readaccess

Write Access: spatialnet_writeaccess

Schema Owner: spatialnet_administrator

Developer: spatialnet_developer

These roles must be created only once for any database instance.
Following the Oracle recommended principle of assigning the fewest privileges necessary, table 3
identifies the object and system privileges required for the spatialNET roles.
Oracle user role and
type
spatialnet_readaccess
Query-only
spatialnet_writeaccess
Designer

Object Grants

System Grants

Privileges

SELECT

CREATE SESSION

Examine network

CREATE SESSION

Examine network
Create/cancel jobs
Add entities and change
network information.

spatialnet_administrator

spatialnet_developer

READ,WRITE ON

CREATE TABLE
CREATE
PROCEDURE
CREATE SEQUENCE
CREATE VIEW
CREATE TYPE
CREATE SYNONYM
CREATE TRIGGER
CREATE SESSION
ALTER TABLE
CREATE ANY VIEW

10 of 69

SELECT
INSERT
UPDATE
DELETE
QUOTA UNLIMITED
SELECT
INSERT
UPDATE
DELETE
QUOTA UNLIMITED

Create Schema Objects

Examine network.
Publish/post/cancel jobs.
User maintenance

SPATIALinfo Inc.

DIRECTORY
DATA_PUMP_DIR
QUOTA UNLIMITED

CREATE INDEXTYPE
CREATE
PROCEDURE
CREATE SEQUENCE
CREATE SESSION
CREATE SYNONYM
CREATE TABLE
CREATE TRIGGER
CREATE TYPE
SELECT ANY
DICTIONARY
ALTER SESSION
AUTOTRACE

Table 3: Oracle role configuration

The spatialnet_administrator role

The spatialnet_administrator role is granted to the database user (schema) where the spatialNET
server objects, tables, indexes, sequences, and procedures, are created. Other user roles are granted
object privileges as appropriate.
The commands for creating the spatialnet_administrator role are listed below

Create the spatialnet_administrator role:

crea te rol e s pa ti alne t_a dmi nis tr at or n ot ide nti fi ed ;
gran t c rea te ta bl e to sp ati aln et _a dmin ist rat or;
gran t c rea te vi ew to spa tia lne t_ ad mini str ato r;
gran t c rea te pr oc edur e t o s pat ia ln et_a dmi nis tra to r;
gran t c rea te se qu ence to sp ati al ne t_ad min ist rat or ;
gran t c rea te se ss ion to spa tia ln et _adm ini str ato r;
gran t c rea te sy no nym to spa tia ln et _adm ini str ato r;
gran t c rea te tr ig ger to spa tia ln et _adm ini str ato r;
gran t c rea te ty pe to spa tia lne t_ ad mini str ato r;
gran t r ead ,wr it e on d ire cto ry da ta _pum p_d ir to
spat ial net _ad mi ni stra tor ;

Create the spatialNET schema owner:

crea te use r < sp at ialN ET USE R> id en tifi ed by <Pa ss wo rd>
defa ult ta ble sp ac e <s pat ial NET T ab lesp ace >
temp ora ry tab le sp ace tem p
quot a u nli mit ed o n <s pat ial NET T ab lesp ace >;
gran t s pat ial ne t_ admi nis tra tor t o <spa tia lNE T U SE R> ;
alte r u ser
< sp at ialN ET USE R> de fa ult rol e
spat ial net _ad mi ni stra tor ;

NOTE: Replace < spatialNET Table space> with the default table space for the spatialNET schema.
Replace <Password> with the Oracle password for the spatialNET Oracle User.

SPATIALinfo Inc.

11 of 69

The spatialNET schema

Create a schema containing all server-side objects required to support the spatialNET client.

Follow these steps to create the spatialNET schema.

NOTE: Use the full Oracle client for the version of the Oracle server hosting spatialNET.
1.

Establish connectivity to the Oracle host.

Open a Windows command window (cmd) and navigate to the sql\oraspatial directory in
the spatialNET installation directory.
The default location is
\Program Files\SPATIALinfo\SPATIALnet\sql\oraspatial

Log in to SQL*Plus as the spatialNET schema owner using the command below:
sqlplus <spatialNET user>/<password>@<OracleService>

NOTE: Replace <spatialNET user> with the spatialNET schema owner username. Replace
<password> with the password for the spatialNET schema owner. Replace <OracleService>
with the connection string for the Oracle server hosting the SpatialNET schema. This string
is usually the tnsname entry that is configured in the tnsnames.ora file. See Set up
tnsnames.ora for new database connections.
4.

From the SQL> prompt, execute the following scripts:

@spatialfm_tables.sql
@spatialfm_indices.sql
@spatialfm_views.sql
@create_jms_views.sql
@spatialnet_eam.sql
@create_jms_tables.sql
@spatialnet_jms.sql
@create_jms_triggers.sql

Exit SQL*Plus and navigate to the sql\dictionaries directory in the spatialNET installation
directory.

@all_ess.sql
@all_reco.sql

The baseline spatialNET schema has now been created.

12 of 69

SPATIALinfo Inc.

Grant object privileges on the spatialNET schema

After the spatialNET schema has been created, you can create object grants to the spatialNET Users
Roles spatialnet_readaccess and spatialnet_writeaccess.
spatialNET Oracle objects are owned by the Oracle User which created them and already have full
access privileges.

Follow these steps to grant object privileges on the spatialNET schema.

Create roles spatialnet_readaccess and spatialnet_writeaccess if you have not already

created them.

Grant CREATE SESSION to spatialnet_readaccess and spatialnet_writeaccess.

Open a Windows command window (cmd) and navigate to the sql\oraspatial directory in
the spatialNET installation directory. The default location is:
\Program Files\SPATIALinfo\SPATIALnet\sql\oraspatial

Log in to SQL*Plus as the spatialNET schema owner using the command below:
sqlplus <spatialNET user>/<password>@<OracleService>

From the SQL> prompt, execute the following script:

@spatialfm_grant_tables.sql

Create the master spatialNET schema (optional)

Master spatialNET schemas are configured with materialized view logs. These logs enable the
replicate sites to update their data through materialized views.

Follow the instructions below to create a master schema with the appropriate logs.
1.

Log in to SQL*Plus as the spatialNET schema owner using the command below:
sqlplus <spatialNET user>/<password>@<OracleService>

From the SQL> prompt, execute the following script:

SPATIALinfo Inc.

13 of 69

@spatialfm_master.sql <Oracle schema>

NOTE: Replace <Oracle schema> with the Oracle schema that owns the spatialNET objects
on that server.

Create the replicate spatialNET schema (optional)

spatialNET objects of the replicate site are created as materialized views of the spatialNET objects of
the master.

Follow these steps to create a replicate schema.

Create an Oracle user to own the replicate schema.

Using a Database Link (DB_Link), establish connectivity between the replicate schema (on
the server hosting the replicate site) and the spatialNET owner schema (on the server
hosting the master site).

Log in to SQL*Plus as the spatialNET schema owner using the command below:
sqlplus <replicate owner>/<password>@<OracleService>
Note: Replace <replicate owner> with the username for the replicate schema owner. Replace
<password> with the password for the replicate schema owner. Replace <OracleService>
with the connection string for Oracle server hosting the replicate schema.

From the SQL> prompt, execute the following script:

@spatialfm_slave.sql <DB_LINK> <Oracle schema>

NOTE: Replace <DB_Link> with the database link that established connectivity to the
master Oracle server. Replace <Oracle schema> with the Oracle schema that owns the
spatialNET objects on that server.

Create the administrator application user

The spatialNET application has its own user and group definitions that are distinct from Oracle
database user and group definitions.
To configure the application, you must create a user admin for the application administrator.

NOTE: This user initially has an empty password. For security reasons, this password should be set
as soon as possible.

14 of 69

SPATIALinfo Inc.

Follow these steps to create the user admin for the application administrator.
1.

Open a Windows command window (cmd) and navigate to the sql\oraspatial

directory in the spatialNET installation directory.
The default location is
\Program Files\SPATIALinfo\SPATIALnet\Program
Files\SPATIALinfo\SPATIALnet\sql\oraspatial

2. Log in to SQL*Plus as the spatialNET administrator using the following command:

sqlplus <spatialNET user>/<password>@<OracleService>

NOTE: Replace <spatialNET user> with the spatialNET schema owner username. Replace
<password> with the password for the spatialNET schema owner. Replace <OracleService>
with the connection string for the Oracle server hosting the SpatialNET schema.
3. From the SQL> prompt, execute the following script:
@spatialfm_scm_init.sql

Define available spatial reference systems for earth-based spatial

coordinates
If you will be using earth-based spatial coordinate systems (as opposed to arbitrary x, y coordinates),
then you must configure the coordinate systems spatialNET can use. The systems you choose
determines both how data is stored and which systems spatialNET displays as an option to your
users.
spatialNET displays each of the coordinate systems defined in the SPATIALNET_CS_SRS table.
Follow the steps below to copy Spatial Reference Systems (SRS) definitions from the Oraclesupplied table MDSYS.CS_SRS to the spatialNET table SPATIALNET_CS_SRS.

To copy Spatial Reference Systems definitions to the SPATIALNET_CS_SRS table:

1. Navigate to the sql\dictionaries\ directory of the spatialNET installation directory.
The default location is
\Program Files\SPATIALinfo\SPATIALnet\sql\dictionaries\
2.

Copy the reco_SPATIALNET_CS_SRS.sql script and save it to a writeable location.

Open your copy of the script with a text editor, and edit it to load the coordinate systems
you want to be available.

Run the script as the spatialNET schema owner.

If the data is to be stored in a non-null SRID, update the user_sdo_geom_metadata

table to record the chosen SRID:
update user_sdo_geom_metadata set srid =<your chosen SRID>

SPATIALinfo Inc.

15 of 69

NOTE: When editing reco_SPATIALNET_CS_SRS.sql, include at least the

coordinate system that you want data to be stored in, as well as coordinate system 8307
"Longitude / Latitude (WGS 84)," which supports view at a point capability.
For example, if you want to use SRID 41003 "Conformal Projection (North America), edit
the WHERE clause to:
WHERE srid in (8307, 41003)

Create the DBMS configuration file

Before creating the configuration file, collect the following information.

The Oracle TNS name to be used to access the database

Oracle User / Password for Oracle spatialNET schema owner

To create a DBMS configuration file:

Navigate to the bin (or bin64) directory in the spatialNET installation directory. The default
location is
\Program Files\SPATIALinfo\SPATIALnet\bin

Run (double-click) the file called dbed2.exe. A window appears.

Figure 2: dbed2 utility

Enter the appropriate information in the fields, as described in table 4 below.

Field name
Description
Data dictionary
DB driver
Host
Socket
Service

16 of 69

Description
Short description to identify the spatialNET schema
spatialfm
Select OracleSpatial from the drop down list
Not enabled for OracleSpatial
Not enterable for OracleSpatial
Connection string to Oracle. TNS name of the service or IP/OracleSID

SPATIALinfo Inc.

Schema

Username

(Optional) Oracle spatialNET schema owner, which should be the same as

the username. This field is used when set up with synonyms to identify the
schema owner
Oracle spatialNET schema owner

Table 4: dbed utility fields and descriptions

Select Encrypted to encrypt the password when distributing the configuration file. If you do
not encrypt the password, then the file can be read by a regular user.

Click Save As. When prompted to choose a location, choose the dbms folder in the
spatialNET installation location. The default location is
\Program Files\SPATIALinfo\SPATIALnet\dbms

spatialNET-supplied scripts
Along with the scripts required to create the database, model-independent scripts are located in the
sql folder of the spatialNET installation folder.
The default location is:
\Program Files\SPATIALinfo\SPATIALnet\sql

Object creation scripts

Path and filename
oraspatial\spatialfm_tables.sql
oraspatial\spatialfm_views.sq
oraspatial\spatialfm_indices.sql
oraspatial\spatialfm_aspatial_indices.sql
oraspatial\spatialfm_spatial_indices.sql
oraspatial\create_jms_views.sql
oraspatial\SpatialNET_eam.sql
oraspatial\create_jms_tables.sql
oraspatial\spatialnet_jms.sql
oraspatial\create_jms_triggers.sql
oraspatial\spatialfm_scm_init.sql

Description
Creates the base tables for supporting spatialNET
Creates the necessary views on the base tables for supporting
spatialNET
Creates all indexes on tables supporting spatialNET and sets
the primary key constraints for these tables
Creates indexes for table columns that do not contain spatial
data
Creates indexes for table columns that contain spatial data
Creates views based on spatialNET tables
Creates the spatialnet_eam package
Creates special tables needed by the spatialnet_jms package
Creates the spatialnet_jms package
Creates database triggers to support between job locking of
changed entities.
Populates the SCM_USER and SCM_USER2 tables to create a
default admin user for a spatialNET installation

Table 5: Object creation scripts

spatialNET utility scripts

Path and filename

Description

oraspatial\spatialfm_master.sql

Creates materialized view logs on the schema

designated to be the master

oraspatial\spatialfm_slave.sql

Create the materialized views supporting a

spatialNET replicate schema

oraspatial\spatialfm_refresh_slave.sql

Uses an Oracle built-in procedure to refresh

materialized views in a spatialNET replicate schema

SPATIALinfo Inc.

17 of 69

oraspatial\spatialfm_drop_master.sql

Drops the materialized view logs on a spatialNET

primary schema

oraspatial\spatialfm_drop_slave.sql

Drops the materialized views supporting a

spatialNET replicate schema

oraspatial\spatialfm_drop_indices.sql

Drops indices created by the spatialnet_indices.sql

script

oraspatial\spatialfm_drop_aspatial_indices.sql

Drops non-spatial indices created by the

spatialnet_aspatial_indices.sql script

oraspatial\spatialfm_drop_spatial_indices.sql

Drops spatial indices created by the

spatialnet_spatial_indices.sql script

oraspatial\spatialfm_drop_tables.sql

Drops tables created by the spatialnet_tables.sql

script

oraspatial\spatialfm_drop_views.sql

Drops views created by the spatialnet_views.sql

script

Table 6: spatialNET utility scripts

spatialNET configuration scripts

Path and filename

Description

dictionaries\all_ess.sql

Populates certain spatialNET dictionary tables with default

values

dictionaries\all_reco.sql

Populates certain spatialNET dictionary tables with default

values

oraspatial\spatialfm_grant_tables.sql

Creates appropriate object grants on spatialNET tables to the

spatialNET Oracle user roles

Table 7: spatialNET configuration scripts

Optional scripts
Path and filename

Description

oraspatial\orasp_get_mbr.sql

Uses an Oracle procedure to calculate the minimum bounding

rectangle for an Oracle Spatial object, not taking arc curvature into
account

oraspatial\orasp_gather.sql

Uses an Oracle procedure to gather Oracle table/column optimizer

statistics. You can customize the individual tables gather
commands to suit your requirements.

oraspatial\check_null_srid_spatial_me
tadata.sql

Reports the following issues:

registered spatial tables with column name <> 'COORDINATES'
registered spatial tables without <tname>_SPIND spatial index
spatial indexes that are not R-tree indexes
spatial indexes that are invalid (failed during building)

oraspatial\check_spatial_metadata.sql

Reports the following issues:

registered spatial tables with column name <> 'COORDINATES'
registered spatial tables without <tname>_SPIND spatial index
spatial indexes that are not R-tree indexes
tables with COORINATES columns that are not registered
spatial indexes that failed during building

oraspatial\get_all_srid.sql

Lists all tables in a spatialNET schema registered in the

user_sdo_geom_metadata view

oraspatial\get_srid.sql

Reports issues with spatialNET spatial indexes.

18 of 69

SPATIALinfo Inc.

oraspatial\set_entity_status.sql

Updates the entity status column if it is null or if bits which should

be set for published rows are not set.
Sets service status for an existing table when the service status
column is newly added.

NOTE: This script sets the GDM bit in the entity

oraspatial\set_service_status.sql

status for all

newly added entities, but does not do any checking for modified
pre-existing entities.

NOTE: This script only updates the service status column when
its value is null, so it will not adversely affect any table with existing
values.
oraspatial\valgeom.sql

Performs an sdo_geom.validate_layer_with_contex() query for a

table with a spatial attribute and reports the results

Table 8: Optional scripts

Install spatialNET application and associated

software
spatialNET operates on stand-alone PCs that have a network connection to an Oracle database. The
installation process includes the tasks listed below.

Install Oracle Full Client. For up-to-date information about software versions, see the
document titled: System hardware and third-party software requirements 2Q 2012.

Set up the TNSnames.ora file

Install AutoCAD

Install spatialNET

Create a Database .ini file

Prerequisites and system requirements

For details about third-party software and client machine requirements, see the document titled
System hardware and third-party software requirements.

Install Oracle client

IMPORTANT: DO NOT INSTALL ORACLE TO THE DEFAULT LOCATION. INSTEAD,
FOLLOW THE INSTRUCTIONS BELOW TO INSTALL ORACLE TO THE ORACLE
FOLDER ON THE C: DRIVE.
To install the Oracle client:
1.

Download the Oracle client (11G R2.111.7.20 or higher) from the following location:
http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html

Choose the appropriate operating system and click See All to access the Client download
options.

SPATIALinfo Inc.

19 of 69

Download Oracle Client. (Do not download Standard Edition, Standard Edition One,
Enterprise Edition, or other special downloads).

On the C: drive, create a folder titled Oracle. Oracle will be installed in this folder so that
anyone using the machine has access to Oracle.

Launch the Oracle installer.

Select either Administrator or Run-Time for the installation type.

Select the available language and click Next..

In the Oracle Base field, enter the C:\Oracle directory created in step 4 as the installation
location.

Follow the on-screen instructions to complete the installation.

Set up tnsnames.ora for new database connections

The tnsnames.ora file is automatically created when the Oracle client is installed with an
Administrator or Run-Time installation type.
The default location for this file is:
C:\Oracle\product\11.2.0\client_1\NETWORK\ADMIN
Follow the instructions below to set up the file correctly using a text editor. If you would prefer to use
the Oracle setup assistant, see Appendix: use Oracle Net Configuration Assistant to set up the
tnsnames.ora file

To set up the tnsnames.ora file:

Open the tnsnames.ora file in plain text editor (such as Notepad or Wordpad).

The relevant part of the file is shown below. Change the BOLD text in the sample below to
match your system, and then save the file. (Contact your IT administrator to obtain this
information.)

NOTE: If the file doesnt contain the code below, then copy and paste this code into the file,
making sure to edit the parts in bold.
ORA1 1G_ SER VER NA ME =
(D ESC RIP TIO N =
(AD DRE SS_ LI ST =
( ADD RES S = (PRO TOC OL = T CP )( HOST =
123. 456 .78 .91 0) (P ORT = 1 521 ))
)
(CO NNE CT_ DA TA =
( SER VIC E_ NA ME = or a11 g)
)
)

20 of 69

SPATIALinfo Inc.

IF YOU USE WINDOWS 7: Save the file first to a writeable location and then copy it back into
the Oracle location (C:\Oracle). Windows 7 security prohibits the creation of certain file types in
certain locations.
You can also create this file using the Oracle Net Configuration Assistant. See Manually create a
TNSNames file.

Verify the Oracle Connection

To verify the Oracle connection, type the following commands into a command line:
>

Ping [server address]

Tnsping [net service name]

If this test fails, review the host name and service name in the tnsnames.ora file to ensure the Oracle
server is properly defined.

Install AutoCAD Map 3D

Install AutoCAD Map 3D according to the instructions that accompany the software. For information
about which AutoCAD version to install, see the document titled System Hardware and Third-party
Software Requirements.
Important: You must open AutoCAD Map 3D at least once before opening spatialNET for the first
time.

To prepare AutoCAD Map 3D for use with spatialNET:

Open AutoCAD Map 3D and choose the workspace settings. Map Classic is recommended.

Verify that AutoCAD Map 3D is running properly; then close the application.

Install spatialNET
After you have verified that AutoCAD is working properly on the client computer, you can install the
spatialNET application.

To install spatialNET:
1.

Obtain the spatialNET installation file from the SPATIALinfo Support Portal or from your
SPATIALinfo representative.

Copy the spatialNET executable file to the computer desktop.

Double-click the file icon to open the setup wizard.

On the Welcome page, click Next.

SPATIALinfo Inc.

21 of 69

Figure 3: The spatialNET installation Welcome page

Read the license agreement. Click I accept the agreement, and then click Next.

Figure 4: License agreement

In the User Information window, type the appropriate information and click Next.

Select the installation location in the C:\Program Files folder, as shown below, and click
Next.

22 of 69

SPATIALinfo Inc.

Figure 5: Select Destination Location

Select the components to be installed and click Next.

NOTE: The Start Menu icons for Desktop, Job Administrator and Batch Queue may not be
necessary for all users.

Figure 6: Select Components

Click Install.

SPATIALinfo Inc.

23 of 69

Figure 7: Ready to Install

10. Click Finish when the installation is complete.

Copy the license .ini file

Copy the licence.ini file and, if provided, the licence.key file to the \bin (or bin64) directory within
the spatialNET installation directory.

NOTE: The default location is:

C:\Program Files\SPATIALinfo\SPATIALnet\bin

Launch spatialNET
Warning: AutoCAD must be opened at least once before spatialNET is opened the first time.

To launch spatialNET:
1.

Double-click the spatialNET icon on the desktop, or click the Windows Start button, then
click All Programs, spatialNET, and then spatialNET.

In the Login dialog box, enter a user name and password for your database.

Select the appropriate database to open from the Database drop-down list. The drop-down
list is generated from the .ini files in the dbms directory of your spatialNET installation
directory.

24 of 69

SPATIALinfo Inc.

Figure 8: Login dialog box

Click Logon.

Click OK. When the Job Selection window appears, spatialNET has successfully connected
to your database.

Create a spatialNET Log File

By default, spatialNET displays system messages in a Command prompt window. IT administrators
can choose to have these messages written to a log file instead.
To create a log file, perform the following on each machine:
1.

Log in as the local administrator.

On the desktop, right-click My Computer; then click Properties.

From the options on the left, click Advanced System Settings.

Figure 9: My Computer Properties with Advanced system settings highlighted

From the Advanced tab, click the Environment Variables button. The Environment
Variables window appears.

Under the System Variables section, click Add (or New) to add a new variable.

SPATIALinfo Inc.

25 of 69

Figure 10: The Environment Variables window

In the Variable name field, type: DPRINT_FILENAME

In the Variable value field, type the location that you want to save the log file.

NOTE: Windows 7 will not allow you to write to C:\Program Files, so you should choose a
location outside of that directory.

Figure 11: System variables

Click OK to save the location. spatialNET logs will be stored in the location you chose.

Troubleshooting OS error 127

Figure 12: Error message

26 of 69

SPATIALinfo Inc.

The error message shown above usually appears as a result of one of the following:

Oracle Client is not installed.

A 64-bit client is installed on a 32-bit system or vice versa.

Oracle is installed in the user profile directory of the person who performed the installation.

To verify that Oracle is installed:

Bring up a Command prompt and type Path.

Review the path to see if there are any references to Oracle and the directory where it is
installed.

NOTE: Oracle should be installed in an Oracle file on the C: drive, and NOT in its default location.

Figure 13: Administrator Command Prompt path

Post and publish jobs

Publish a job to make it visible to others using the database. You can continue to make
changes to the job.

Post a job when you are finished with it. Others using the database can see your work, and
you cannot make further changes to it after it has been posted.

NOTE: Depending on he settings for your security group, you may not be able to publish or post a
job. To change security group settings, see Edit a security group.

Publish a job
To publish a job:
1.

Run spatialNET Job Administrator and log on. The JMS Administration Tool window
appears.

From the spatialNET JMS Administration Tool window, click My Jobs.

SPATIALinfo Inc.

27 of 69

Figure 14: The JMS admin tool with My jobs highlighted

Click the job that you want to publish, then click the Publish button, and then click Queue
for Publish. The job goes to the batch queue for publishing. See spatialNET Batch Queue
Operation.

Warning: Do not choose the Publish option unless you are certain that no one else is logged in to the
database. Publishing while others are logged in to the database can seriously damage the database.

Figure 15: The Queue for Publish option

Colored entities
spatialNET can display entities in different colors to help you identify whether they have been
posted, published in another job, or added or edited in the current job and not published.

Post a job
To post a job:
1.

Run spatialNET Job Administrator and log on. The JMS Administrator Tool window appears.

From the spatialNET JMS Administration Tool window, click My Jobs.

28 of 69

SPATIALinfo Inc.

Figure 16: The JMS admin tool with My jobs highlighted

Click the job that you want to publish, then click Post, and then click Queue for Post. The
job goes to the batch queue for publishing. See spatialNET Batch Queue Operation.

Warning: Do not choose the Post option unless you are certain that no one else is logged in to the
database. Posting while others are logged in to the database can seriously damage the database.

Figure 17: The Queue for Post option

NOTE: A job that has been posted to the spatial database is no longer available for editing by
spatialNET users.

View publish or post conflicts

Conflicts can arise during the Publish or Post process. For example, a conflict would occur if two
people, working in two separate jobs, edit the same entity differently and then publish their jobs.
When such a conflict occurs, the publish command stops, and a spatialNET message panel appears,
followed by the JMS Administration Results panel.

SPATIALinfo Inc.

29 of 69

Expand the items in the list to reveal the source of the conflict, then select an item and
click the appropriate button to act on it.

Button
Save
Display

Edit
Delete
Verify

Reset
Close

Description
Saves the list, in its current state of expansion, as a text file.
Shows the Details or Map View menu options.
Details opens the Details panel for the selected entity.
Map View opens a map, centered on the selected entity.
Brings up a window that allows editing of the selected entity.
Deletes the record of the operation for the current job. Delete is only available after
selecting an item under the Operations performed on job heading.
Shows the Verify Publish, Verify Post and Verify Cancel menu options.
Choose these options to test whether the current job can be successfully published,
posted or cancelled (respectively). Verification results appear as a new list item in
the JMS Administration Results panel.
Allows you to clear the Open status of the selected job.
Closes the window.

Figure 18: JMS Administration Results window description of buttons

spatialNET Batch Queue Manager (BQM)

To avoid database corruption, spatialNET requires that certain operations be performed one at a
time.
The spatialNET Batch Queue Manager (BQM) allows administrators to queue those operations
automatically, so that they run only when conflicting operations have finished.

Batch Queue Manager components

The spatialNET Batch Queue Manager is implemented as an instance of the regular spatialNET
Client software. It uses the same data dictionary, the same customization files, the same format
database connection files and so on.
Batch Queue Manager assumes that it is installed in a single directory containing a number of
subdirectories.
Customizations are expected to be in the following subdirectories:
Directory
bin (or bin64)
dbms
icon
modeler[64]
param
python/spatialnet/custom
symbol

Contents
License files
Database connection files
Icons (.ico)
Image files (.bmp, .jpg)
Native code extensions (.dll)
AutoCAD drawing templates (.dwt)
AutoCAD menu files (.mns)
Extension Scripts (.py)
AutoCAD symbols (.dwg)
Smart Text symbols (.smt)

Table 9 spatialNET directories

30 of 69

SPATIALinfo Inc.

Subject to the type of jobs to be processed by the batch queue, all of the customization files must be
present.

Install Batch Queue Manager (BQM)

To install the BQM, run the regular spatialNET installer, then copy the site-specific customization
files.

NOTE: Before upgrading spatialNET, shut down the BQM.

The regular spatialNET installer creates a desktop shortcut with the appropriate commands to
launch the BQM. This shortcut assumes that the ID of the batch queue is JMSADMIN.

NOTE: This queue is automatically created by the dictionaries\ess_BATCH_QUEUE.sql

script that is provided as part of spatialNET and run automatically when you run all_ess.sql.

View batch queue status

You can view batch queue status directly from the JMS Administration Tool window. See The
spatialNET JMS Administration tool.

To view batch queue status:

From the JMS Administration Tool window, click the Batch Queue button. The All batch
queues window appears.

Select a batch queue, click Display, and then click Details.

Figure 19: The All batch queues window's Display menu

Start a queue
You can start or stop a batch queue using the JMS Administration window. See The spatialNET JMS
Administration tool.

SPATIALinfo Inc.

31 of 69

To start or stop a batch queue:

From the JMS Administration Tool window, click the Batch Queue button. The All batch
queues window appears.

Select a batch queue and click the Control button. The Queue Control window appears.

Figure 20: The Queue Control window

Click Run Queue. (Or click Run Once to process a single job and then stop.)

Enter the appropriate details and begin the queue. A progress window appears, showing the
status of the BQM.

To stop the queue, click the Stop button on the progress window. The batch manager will stop once
the current job is finished.

NOTE: These buttons are running scripts in the bin (or bin64) directory that can be customized if
required.
Button

Script

Run Queue
Reset Queue
Run Once

batch.bat
resetbatch.bat
singlerunbatch.bat

Table 10 Queue Control buttons and the scripts they run

32 of 69

SPATIALinfo Inc.

Data Model
There are a number of database tables associated with managing the batch queues.

Figure 21: The data model

The BATCH_QUEUE table

The BATCH_QUEUE table holds the operational times when the batch queue manager is allowed to
start sub-processes.
The START_TIME and END_TIME columns are times specified as number of seconds past
midnight.

The BATCH_QUEUE_ENTRY table

The BATCH_QUEUE_ENTRY table holds an entry for each batch job submission.

The JOB_ID and USER_ID columns hold information about the submitter of the batch job.

The SHELL_COMMAND holds the operating system command to run.

The COMMAND_ARGS holds the arguments to pass to the operating system command.

WARNING: If multiple queues are created, their first eight characters in the DESCRIPTION field
must not be the same. By default, the batch queue keys use the first eight characters of the
DESCRIPTION field as entered by the user.

SPATIALinfo Inc.

33 of 69

Starting and stopping the BQM

When the BQM starts, it checks that it is the only instance of the BQM running.
If there is another instance of the BQM running, then it will stop. If no other instance is running, then
the BQM will update USER_ID, START_DATE and HOST_NAME.
If the USER_ID field is ever externally changed, the BQM terminates itself cleanly on the next
iteration through its main loop.

Process Flow
When the BQM is running, it loops around repeating the same process. The following figure is
simplified version of how the BQM operates:

Figure 22: BQM process flow

To process BATCH_QUEUE_ENTRY:
1.

Retrieve the details from the database entry.

Adjust the command (if it begins with *spatialnet") to reflect the actual installation
location of the spatialNET software on the batch server machine. This may be different to
the location it is installed on the client machine that submitted the batch request.

34 of 69

SPATIALinfo Inc.

Load the details of the requested batch operation into a number of named edit buffers.

Execute the job by invoking spatialNET BATCH_QUEUE_ENTRY.process.STEPS.

The following editbuffers are loaded:

Name

Content

queue_current_entry
queue_current_command
queue_current_arguments
queue_current_logfile

Entity reference to the BATCH_QUEUE_ENTRY being processed

Pathname of executable to launch.
Arguments to pass to executable
Pathname of logfile to collect output from the batch process

Table 11 Editbuffers related to batch job execution

If the specified executable is the regular spatialNET client (spatialnet.exe), then

queue_current_arguments will automatically have the following arguments prepended:
Name
Meaning
/batch
/root=<dir>
/dd=<filename>
/db=<filename>
/u=<username>
/L:<pathname>
/security=<token>
/nolicencewarning

Notifies the client session that it is running in batch mode and should not
display any modal dialogs, error messages, etc.
Notifies the client session of the location of the spatialNET installation.
Notifies the client session of the data dictionary to use
Notifies the client session of the database connection file to use
Notifies the client session of the user to connect as
Notifies the client session to divert all diagnostic output to the nominated
logfile
Security token
Suppress (modal) warning dialogs from the licensing engine.

Table 12 Switches passed to batch processes

The standard definition of the process.STEPS parameter is as follows:

beha vio ur pro ce ss {
para met ers {
STEP S = {
"*PR E_S TEP S",
"*EX ECU TE" ,
"*PO ST_ STE PS"
};
PRE_ STE PS = " gd m$ noop ";
EXEC UTE = "ba tc h$ run_ que ue_ ent ry "
" [q ueu e_c urr en t_ entr y]"
" [q ueu e_c urr en t_ logf ile ]"
" [q ueu e_c urr en t_ comm and ]"
" [q ueu e_c urr en t_ argu men ts] "
;
POST _ST EPS = "g dm $noo p";
}
You can install a steps hook to intercept the EXECUTE sub-step and replace it, or provide any
additional validation prior to allowing it to run.

SPATIALinfo Inc.

35 of 69

from co re. gdm i mp ort Ste pHo ok

@Ste pHo ok( "BA TC H_ QUEU E_E NTR Y", " pr oces s", "E XEC UT E" )
def myh ook (cl as sn ame, be hav iou r, s tep, st age ):
if sta ge= =0 :
.. . d o ad diti ona l t est s be fore ex ecu tin g ba tch
subp roc ess .. .
els e:
.. . d o ad diti ona l p roc es si ng a fte r s ubp ro ce ss
comp let es ...

Security
The BQM connects to the database using the username and password specified in the database
connection file.
The BQM process requires user authentication to initiate its session. That authentication can come
from one of the following methods:

If the process is started manually, then the person who started it must enter
authentication details.
If design dictionary entry ACCEPT_OSLOGIN is set to Y and the batch manager user
is the same value as the Windows login-id. In this case, the password can be left blank.
NOTE: Leaving the password blank allows all users to log in without entering a
password if their spatialNET username matches their Windows login.
If the design dictionary entry BATCH_USERNAMES (a semicolon-separated list of
usernames) contains the Windows login-id, and the batch manager user is the same
value as the Windows login-id. If so, the password can be left blank. All other users will
still have to supply their passwords.

When the sub-process is launched, the sub-process spatialNET session must be established as the
user who submitted the job, not as the batch manager user.
The batch queue manager passes a /security=<token> command-line argument along with the
other arguments to the sub-process.
This token is a time-stamped one-way hashed signature that is used by the client software to
authenticate the spatialNET user connection. The hashes are valid for approximately five minutes.
The actual database user and password (passed to Oracle) are stored in encrypted form in the
database connection file. Thus, the sub-process can establish its database connection independently
of the spatialNET user authentication.

Batch queue logging

The BQM and each sub-process keep their own unique log files. These files are stored in a directory
whose name is specified by the design dictionary entry BatchQueueLogDirectory.
If no entry is specified, then the directory named in the system environment variable TEMP is used.
The Batch Queue Managers log file is called BatchQueueXXXXX.log where XXXXX is the
database key of the corresponding BATCH_QUEUE row for the queue.

36 of 69

SPATIALinfo Inc.

The log file created for the sub-processes is called XXXXX-YYYYY.log where XXXXX is the key of
the BATCH_QUEUE row and YYYYY is the key of the BATCH_QUEUE_ENTRY row.
If a batch job fails to launch, or terminates with an error status, a message is added to the
SCM_USER_MESSAGES table, linked back to the SCM_USER row corresponding to the user that
submitted the job.

The BQM as a background service

A separate executable, called spatialNET Batch Monitor, runs as a Windows service and launches
the BQM process automatically. The Batch Monitor does not contain any regular spatialNET
components and as such is not affected by most upgrade processes.

Installation of the Batch Monitor

The Batch Monitor consists of three files, which must be stored together in the same directory.
Filename

Purpose

snbatchmon.exe
snbatchmon.ini
snbatchmon.dll

Service executable
Configuration File
Message catalog for Windows Event Viewer

Table 13 Batch Monitor components

To install the service from the command line, type snbatchmon install
You can invoke snbatchmon interactively from the Command Prompt and receive an appropriate
usage message.
c:\> snbatchmon
usage: snbatchmon.exe <keyword>
where keyword is one of the following words:

install
query
start
pause
continue
stop
delete

SPATIALinfo Inc.

Install the windows service

Show the state of the windows service
Start the windows service
Pause the windows service
Continue the windows service
Stop the windows service
Delete the windows service

37 of 69

keyword
install
query
start
pause
continue
stop

delete

Action
Registers the binary with the Windows Service Manager.
Installs the message catalog with the Windows Event Viewer.
Displays the current state of the service, including several of the control values that can be
manipulated from the Windows Services panel.
Start the service, if it is not currently running.
All configured queues will be started.
Pause the service, if it is running.
All configured queues will be notified to stop processing; the service will be pause
pending until all queues terminate, then it will become paused.
Continue the service, if it is paused.
All configured queues will be restarted.
Stop the service, if it is running.
All configured queues will be notified to stop processing; the service will be stop pending
until all queues terminate, then it will become stopped.
Deregister the binary with the Windows Service Manager.
This command leaves the message catalog registered so that existing log messages remain
readable.

Table 14 Command line keywords

Multiple copies of the Batch Monitor

If more than one copy of the Batch Monitor is installed on the same system, a warning message is
printed.
c:\spatialinfo\spatialnet\bin\> snbatchmon query
[Warning: possible mismatch of executables]
[Command executed from
c:\spatialinfo\spatialnet\bin\snbatchmon.exe]
[Service configured to use c:\spatialinfo\spatialnet\bin64\snbatchmon.exe]

Service Name:
Binary:
Username:
Service Type:
Start Type:
Error Control:
State:

spatialNET Batch Monitor (snbatchmon.exe)

c:\spatialinfo\spatialnet\bin64\snbatchmon.exe
LocalSystem
Own Process
Requires external start request
Failure is logged and system startup continues
The service has not been started.

Batch Monitor configuration

The configuration file, snbatchmon.ini,is a standard Windows .ini file containing parameters that
must be modified to match local conditions. These parameters are defined in a section called
BatchQueueMonitor and are defined as follows:
Parameter

Type

DatabaseSpecifier

String

Verbose

Integer

38 of 69

Meaning
This parameter must be specified. It is the name of the spatialNET
database specifier file. This file contains details about the Oracle
service name, user details, and so on.
If this parameter is set to non-zero value, the batch monitor will
periodically output more diagnostic information to the event log.
Defaults to 0.

SPATIALinfo Inc.

Parameter

Type

InstallationDirectory

String

Executable

String

DataDictionary

String

SpatialnetUser

String

RetryTimeLimit

Integer

LaunchTimeLimit

Integer

PollTime

Integer

IdlePollTime

Integer

Meaning
If specified, it is the name of the directory that contains the
spatialNET installation.
Defaults to the directory containing snbatchmon.exe
If specified, it is the name of the main spatialNET executable.
Defaults to spatialnet.exe
If specified, it is the name of the spatialNET data dictionary to use.
Defaults to spatialfm
If specified, it is the name of the spatialNET user to connect as. This
user must be defined in the spatialNET system.
Defaults to the Windows username that the service is run as.
If specified, it is the time limit between retries of launching the
Batch Queue Manager. If the sub-process terminates within this
time, the service will issue an appropriate event log entry, and
terminate.
Specified in seconds, defaults to 60.
If specified, it is the amount of time that the service expects the
launch process to take. If launch exceeds this time, Windows may
terminate the service.
Specified in seconds, defaults to 60.
If specified, it is the amount of time that the service waits between
polling the active queues.
The service will generate an event log entry for each queue, each
time it polls the sub-process. This entry indicates the status
information provided by the Batch Queue Manager.
Specified in seconds, defaults to 300.
Similar to PollTime, but this is the time the service waits if there are
no queues currently running.
This parameter is only used when the monitor is paused.
Specified in seconds, defaults to 1800 (30 minutes).

Table 15 Batch Monitor configuration parameters

For each configured queue, there must be a corresponding configuration section whose name starts
with the literal Queue. For example, Queue1, Queue2.
At service start time, the Service Monitor will scan the configuration and each Queue section that it
finds will result in an additional Batch Manager process being run. The parameters for each Queue
section are as follows:

Parameter

Type

Meaning

QueueName

String

SpatialnetUser

String

This parameter must be specified. It is the name of the spatialNET

batch queue for this process to run.
If specified, this parameter is the name of the spatialNET user to
connect as. This user must be defined in the spatialNET system.
Defaults to the SpatialnetUser value in the
BatchQueueMonitor section.

Table 16 Queue Configuration Parameters

NOTE: Only one process at a time can be processing in a queue, and subsequent attempts to start a
batch processor will fail with an appropriate error message.
Most cases where the Batch Queue Manager terminates are unexpected. In most cases, the error
condition that caused the crash will still apply and the relaunched process will fail immediately.

SPATIALinfo Inc.

39 of 69

To catch this case, the RetryTimeLimit parameter is used. If the time between launch attempts
is less than this limit, the batch monitor will give up on that queue. If multiple queues are being run
by the same monitor, the monitor will continue to run until all queues have failed.

The batch queue process model

The batch queue process model is as follows.

Batch Queue Monitor

Message Catalogue

Windows Event Log

Configuration

Batch Queue Monitor

(snbatchmon.exe)
Shared Memory
Segment
Batch Queue Manager
(spatialnet.exe)

Database
Spec

Database

Batch Queue Process

(spatialnet.exe)
Figure 23: The batch queue process

Steps of the process

The service (snbatchmon.exe) starts.

The service reads the configuration file and launches one or more sub-processes
(spatialnet.exe) to run as the Batch Queue Manager(s).

Each Batch Queue Manager connects independently to Oracle and processes its entries in
the BATCH_QUEUE_ENTRY table in the database.

40 of 69

SPATIALinfo Inc.

If a Batch Queue Manager process terminates prematurely for any reason, the monitor will register
an event message, and then attempt to restart the process.

NOTE: If the process terminates prematurely within the time configured by RetryTimeLimit,
then an event message is recorded and the process is not restarted.
If all queues stop, the monitor will issue an event message and enter the paused state.

Batch Monitor log messages

The Batch Monitor uses a fixed collection of log messages, each of which has an Event ID that can be
displayed in the Event Viewer.
You may choose to install Event Log Tasks to particular events to provide additional notifications in
the event of failures.
Event ID
100
101
102
103
104
105
199
200
201
300
301
302

Meaning
Monitor starting up
Monitor terminated normally
Pause request while not running
Continue request while not paused
A batch queue manager has terminated and will not be restarted (since the termination
was a result of the monitor pausing/stopping)
A batch queue manager has terminated and will be restarted (since the termination was
unexpected)
Process status message
An unexpected runtime error has occurred.
See the Event message for more information
Configuration error. See the Event message for more information
Process runaway (two launch attempts within RetryTimeLimit seconds)
Monitor stopping since no active queues remain
Monitor pausing since no active queues remain

Table 17 Event IDs

100 to 199: Information about issues that occur during operation, but do not indicate serious
problems.

200 to 299: Configuration errors, or operating system failures that cannot be recovered
from automatically.

300 to 399: Failures in the batch managers themselves.

200 through 399: Problems that may not automatically resolve themselves. These issues
should be monitored.

Monitor batch queue events

You can set up a custom view in Event Viewer to monitor issues in the batch queue.

To set up a custom view in Event Viewer:

Launch Event Viewer. (In the Windows Start button search field, type event viewer,
then click Event Viewer in the results.

SPATIALinfo Inc.

41 of 69

Figure 24: Search for Event Viewer

On the Event Viewer window, click the Action menu and select Create Custom View.

Figure 25: Create a custom view in the Even Viewer

3. In the Event Source field, type snbatchmon.exe.

42 of 69

SPATIALinfo Inc.

Enter the ID range of the events that you want to monitor. Events in the 200-399 range
should be monitored.

Figure 26: The Create Custom View window

Click OK, and then click OK again when the Save Filter window appears. The Event Viewer
window appears.

In the Actions section of the window, click Attach Task to this Event.

Figure 27: The Event Viewer with Attach Task highlighted

SPATIALinfo Inc.

43 of 69

Follow the on-screen instructions to have the Event Monitor email you when an event
occurs.

Optimize for Oracle Spatial

The introduction of spatial data to an Oracle server can have a significant impact on the
administration of the server.
This chapter provides some basic guidelines for using the Oracle Spatial database driver with
spatialNET.

Spatial data is object data

Unlike the standard data types usually found in a RDBMS, spatial data are a kind of object data called
object-relational entities with VARRAY components.
Please refer to Oracle documentation for detailed information about object-relational and Oracle
Spatial data.

SDO_GEOMETRY
The Oracle data type for spatial information is SDO_GEOMETRY. This data type is defined by the
Oracle system owner of spatial data, MDSYS. Spatial data in Oracle has the following structure:
CREA TE TYP E s do _g eome try AS OB JE CT (
SD O_G TYP E
NUMB ER
, SD O_S RID
NUMB ER
, SD O_P OIN T
SDO_ POI NT_ TYP E
, SD O_E LEM _IN FO
SDO_ ELE M_I NFO _A RR AY
, SD O_O RDI NAT ES
SDO_ ORD INA TE_ AR RA Y);
CREA TE TYP E s do _p oint _ty pe AS OB JE CT (
X NUM BER
, Y NUM BER
, Z NUM BER );
CREA TE TYP E s do _e lem_ inf o_a rra y AS VAR RAY (1 048 57 6) of
NUMB ER;
CREA TE TYP E s do _o rdin ate _ar ray A S VARR AY (10 485 76 ) of
NUMB ER;
In addition to owning the definition for spatial data, MDSYS also owns the tables and packages
which provide the support for spatial data within an Oracle Server.

NOTE: You cannot use X and Y for a direct query from Oracle Spatial. Instead, you must
reference <tablename>.coordinates.sdo_point.X and you must define a table alias for the table name
(the table alias can be the same name as the table name). For example: FROM <tablename>
<tablename>,

Metadata configuration
Each spatial attribute defined in the data dictionary and included in a table must have a spatial index.

44 of 69

SPATIALinfo Inc.

Oracle Spatial requires an entry in the metadata view USER_SDO_GEOM_METADATA. This view is
based on the MDSYS table SDO_GEOM_METADATA_TABLE.

USER_SDO_GEOM_METADATA
(
TA BLE _NA ME
CO LUM N_N AME
DI MIN FO
SR ID

VA RCHA R2( 32) ,

VA RCHA R2( 32) ,
SD O_DI M_A RRA Y,
NU MBER

);
Each table with a spatial attribute requires an entry in this view for the creation of a spatial index.

TABLE_NAME: The table to be indexed

COLUMN_NAME: The column with data type SDO_GEOMETRY
DIMINFO: The coordinates for a minimum bounding rectangle (MBR) covering the
extent of the spatial data in the table
SRID: Spatial Reference ID for the tables spatial datas coordinate system.

The scripts to create the spatialNET tables will populate this metadata view with the information to
support the creation of the required indexes.

SRID

The SRID identifies the coordinate system of the SDO objects within a table column of
type SDO_GEOMETRY.
All SDO objects in a table column must reference the same coordinate system.
The SRID is a foreign key, which must be valid, and references a Coordinate Systems
registered in the MDSYS.CS_SRS table.
To use a coordinate system, spatialNET requires a corresponding entry in the
SPATIALNET_CS_SRS table.

GTYPE
spatialNET only supports the following 2D geometries

2001
2002
2003

Point
Line
Polygon

In a table with SDO data, all geometries must be of the same type.

Spatial index analysis

The Oracle data dictionary may be queried to generate a list of spatial indexes within a spatialNET
schema:
SELECT TABLE_NAME, INDEX_NAME
FROM USER_INDEXES

SPATIALinfo Inc.

45 of 69

WHERE INDEX_TYPE = DOMAIN

The status of a DOMAIN index is set in the domidx_opstatus column of the USER_INDEXES view.
Oracle will set this value to FAILED if an exception is generated while building a spatial index.
If a spatial index has been marked as FAILED; the index must be dropped before another attempt is
made to generate the index.
For detailed information about DOMAIN type indexes, check your Oracle documentation.

Oracle spatial index implementation

Spatial indexes are structured differently from standard indexes. A spatial index is kept in a systemgenerated table, with a name like MDRT_%. These tables are also associated with a system
generated sequence with a name like MDRS_%.
Use metadata view USER_SDO_INDEX_METADATA to query which table supports a specific
spatial index.

Specifying spatial index table space

A spatial index creation command finishes with a clause PARAMETERS(' '). To specify a table
space for the spatial index, add table space=<table spacename> to the quoted parameter string. Eg.
CREA TE IND EX FL OO R_SP IND ON
FL OOR (CO ORD IN AT ES)
IN DEX TYP E I S MD SYS. SPA TIA L_I ND EX
PA RAM ETE RS( 'l ay er_g typ e=P OLY GO N tabl e s pac e=I ND X' );

NOTE: Spatial indexes may be stored in a different table space from the spatial data.

Errors occurring while creating or rebuilding an index

If an error occurs while a spatial index is being created or rebuilt, the result can leave an incomplete
index structure. Such incomplete indexes might need to be dropped before recreating the index.

TO DROP AN INDEX: use the following command: DROP INDEX <name> FORCE;
You can see details of the table spaces a spatial index uses from the user_sdo_index_metadata view

Direct storage only

Oracle Spatial only supports direct storage of geometry - no indirect link by or link up geometry is
supported. Instead, spatialNET can be configured to manage indirect polygons.

Maintain performance
Two tasks are needed to maintain database performance:

46 of 69

Maintain database statistics

SPATIALinfo Inc.

Rebuild of R-tree indexes

Maintain database statistics

You should regularly maintain the database table and index statistics, especially after substantial
changes to the data in the database. For best results, leave a mix of posted and non-posted data
when the statistics are gathered.

To maintain database statistics:

FIRST-TIME ONLY: While the database is under load, execute the following procedure:
dbms_stats.gather_system_stats
NOTE: This procedure will let the database learn about the performance of the database
server hardware. The database will then use this information when optimizing queries.

Edit orasp_gather.sql to include any column histograms you want gathered at your site.
See Optional scripts for the location of this script.

Execute the following command: exec orasp_gather.sql

This command gets statistics for tables, indexes, and a column value histogram for journal (so
the database knows looking up zero is not useful).

Rebuild R-tree indexes

Oracle R-tree indexes build a hierarchy of rectangles that surround indexed objects. The indexes
sometimes lose effectiveness as new data is added, so they should be rebuilt from time to time.

Rebuild the spatial index

To rebuild all spatial indexes, log in to the database SQL plus as the user owning the tables and
execute the following script in a directory that you have write access to:
set lin esi ze 20 0 feed bac k o ff ec ho off tr ims poo l on
page siz e 0 te rm ou t of f
spoo l x .tm p
prom pt Alt er se ss ion set SO RT_ AR EA _SIZ E=4 096 000 ;
sele ct 'al ter i nd ex ' || in dex _n am e || ' r ebu ild
para met ers ('' ' || par ame ter s | |' '' );'
from us er_ ind ex es whe re ity p_n am e = 'S PAT IAL _IN DE X'
/
spoo l o ff
set hea din g o n pa gesi ze 999 9 t er mo ut o n
@x.t mp

Parameters
When rebuilding spatial indexes, make sure to include the parameters. Neglecting to include
parameters can result in removing the constraint on geometry type.

SPATIALinfo Inc.

47 of 69

Layer_gtype: Sets a constraint on the valid geometry types for the SDO objects
indexed (either Point, Line, or Polygon).
Work_table space: Directs Oracle to use a specific table space for the working tables it
creates during the generation of a spatial index
Table space: Sets the table space to hold spatial index tables

To move a spatial index to a different table space:

Add table space=<table spacename> to the parameters string. For example:

sele ct 'al ter i nd ex ' || in dex _n am e || ' r ebu ild

para met ers ('' ' || par ame ter s | |' t able sp ace =in dx '' );'
from us er_ ind ex es whe re ity p_n am e = 'S PAT IAL _IN DE X'

Verify the geometry constant

To make sure that the geometry constraint is not set to DEFAULT:

Query the SDO_LAYER_GTYPE attribute of the USER_SDO_INDEX_METADATA

view.

Row chaining
Some SDO objects may contain a large number of coordinates, resulting in the chaining of rows. This
chaining requires multiple direct reads to retrieve a single record.

Minimum block size

Spatial Indexes can benefit from being placed on table spaces with larger block sizes. Table spaces
dedicated to spatial indexes should be created with a minimum block size of 16K.

Oracle Cost Based Optimizer settings

Oracle provides several settings to adjust the behavior of the Oracle Cost Based Optimizer (CBO).

OPTIMIZER_INDEX_CACHING
This setting allows an administrator to force the CBO to favor nested loops joins and IN-list iterators.
The higher the value of this parameter, the more likely that the optimizer will pick nested loops joins
over hash or sort-merge joins. A high value will also force the optimizer to pick indexes using IN-list
iterators over other indexes or full table scans.
Adjusting this setting is not required in Oracle 11
Default setting: 0 out of 100
Recommended setting: 0 out of 100

OPTIMIZER_INDEX_COST_ADJ
This setting allows an administrator to make the optimizer more or less prone to selecting a full table
scan over an index access path.
48 of 69

SPATIALinfo Inc.

The higher the value of this parameter, the more likely that the optimizer will choose a full table scan
over an index path.
Adjusting this setting is not required in Oracle 11
Default setting: 100 out of 100
Recommended Setting: 100 out of 100

More information about OPTIMIZER_INDEX_COST_ADJ

The default setting of 100 means that the optimizer evaluates index access paths at 100% of their
regular cost. Any other setting makes the optimizer evaluate the index access path at that
percentage of the regular cost. For example, a setting of 50 makes the index access path look half as
expensive as normal.

QUERY_REWRITE_ENABLED
This parameter enables the optimizer to query materialized views instead of using the normal views.
Allowing Oracle to rewrite queries with a spatial component can result in inefficient processing when
querying spatial data.
Default setting: FALSE
Recommended Setting: FALSE
More information about QUERY_REWRITE_ENABLED
When base tables contain large amount of data, it is time-consuming to compute aggregates or joins
between tables. Oracle Database has the capacity to answer queries using materialized views,
because materialized views contain precomputed aggregates and joins.
For spatial data, this process can slow response time, because the process must go through a series
of checks before running the query.
When it is enabled, Query Rewrite operates on queries and sub-queries in the following types of SQL
statements and sub-queries:

SELECT
CREATE TABLE AS SELECT
INSERT INTO SELECT
UNION
UNION ALL
INTERSECT
MINUS
INSERT
DELETE
UPDATE

SPATIALinfo Inc.

49 of 69

The spatialNET JMS Administration Tool

The spatialNET JMS Administration Tool manages the spatialNET batch queue, as well as spatialNET
users, jobs, and security groups.

To run the JMS Administration Tool:

Double-click the spatialNET Job Administrator icon on your desktop, or click the Start
button, then click All Programs, then spatialNET, then spatialNET Job Administrator.

Enter the appropriate information, including the database that you want to work on.

Click Login. The spatialNET JMS Administration Tool window appears.

Figure 28: The JMS Administration Tool window

After logging in, see the appropriate section below for information about using the JMS
Administration Tool.

50 of 69

SPATIALinfo Inc.

List all users

Click the Users button to see and edit spatialNET users for the database. The All users window
appears.

Figure 29: The All users window

The All users window allows you to create a new user, see details about a user, or edit or change a
user password.

Create a new user

To create a new user:
1.

From the JMS Administration tools All users window, click the New button. The User
Creation window appears.

Enter all the required information and then click the Add button.

View user details

The User Details panel displays information on the spatialNET user along with all jobs that are
assigned to that user.

To view user details:

From the JMS Administration tools All users window, click a user name and then click the
Select button. The User Details window appears, allowing you to view the details.

SPATIALinfo Inc.

51 of 69

Figure 30: User details

Edit user details

To edit user details:
1.

From the JMS Administration tools All users window, click a user name, then click Edit, and
then User. The User Modification window appears.

Figure 31: The User Modification window

Make the appropriate changes, and then click Apply to save the changes.

Click Close to close the window.

52 of 69

SPATIALinfo Inc.

Change a password
If a user knows the password, but wants to change it, then follow the procedure below. If the user
has forgotten the password, then see Reset a password.

To change a password:
1.

From the JMS Administration tools All users window, select a user name, then click Edit,
and then Password. The Edit password window appears.

Complete each field, then click OK to save the new password.

Reset a password
If a user has forgotten that password, then use the procedure below to set the password to null. If
the user knows the password and wants to change it, see Change a password.

To reset a password:
1.

From the JMS Administration tools All users window, click a user name, then click Edit, and
then click Reset Password.

Click Yes to confirm that you want to reset the password. The password is set to null.

Delete a user
The following procedure will delete a user from the spatialNET database. A user cannot be deleted if
there is a job associated with that user.

To delete a user:
1.

From the JMS Administration tools All users window, select a user name, and then click the
Delete button. The Entities being deleted window appears.

Click Confirm to confirm that you want to delete the user.

NOTE: If a job is assigned to a user, you will receive an error message. You will be able to see a list
of jobs assigned to the user, so that you can assign them to other users. Once the jobs are no longer
assigned to a user, then you can delete that user.

User types in the security model

Some spatialNET configurations support a security model containing multiple application user types,
such as Administrator, Read/Write, and Read-Only.

NOTE: An Administrator user type is not necessarily a table owner or database administrator.
You can configure spatialNET so that certain menu options appear only for certain user types. For
example, only users with spatialNET administrator status have access to all of the commands
described in this chapter.

SPATIALinfo Inc.

53 of 69

To examine the availability of menu items for each of the available user types, please consult the
Configuration Specification document that came with your spatialNET configuration.

Create a security group

To create a new security group:
1.

From the JMS Administration tools All users window, click the Security Groups button.
The All security groups window appears.

Click the New button.

Figure 32: The All security groups window

The Security Group Creation window appears.

54 of 69

SPATIALinfo Inc.

Figure 33: The Security Group Creation window

Select the appropriate options for each tab of the security group, then click Add. The new
security group is created and added to the list in the All security groups window.

Edit a security group

To edit a security group:
1.

From the JMS Administration tools All users window, click the Security Groups button.
The All security groups window appears.

Click a security group from the list, then click Edit.

Figure 34: The All security groups window

SPATIALinfo Inc.

55 of 69

Make appropriate changes to each tab the security group, then click Apply. The security
group will be updated.

Figure 35: The Security group modification window

Delete a security group

The following procedure will delete a security group. A security group cannot be deleted if there is a
user associated with it.

To delete a security group:

From the JMS Administration tools All users window, click the Security Groups button.
The All security groups window appears.

Click a security group from the list, then click Delete, and then click Confirm.

Figure 36: All security groups delete

56 of 69

SPATIALinfo Inc.

Delete removed entities

spatialNET allows entities to be removed, rather than deleted. An entity that has been removed
remains in the database for reporting purposes.
Once a job has been posted and those entities are no longer needed, you can permanently delete
them.

NOTE: You cannot choose which entities to delete. All removed entities will be deleted.
To permanently delete removed entities:
1.

On the spatialNET JMS Administration window, click the Cleanup button, and then click
Cleanup posted removed entities.

Figure 37: The JMS Administration Tool with Cleanup posted removed entities highlighted

The Cleanup of Posted Removed entities window appears.

Optional: Click All removed to see a list of the removed entities. This list can take some
time to generate.

Choose Cleanup. The removed entities will be deleted.

Figure 38: Cleanup of Posted Removed entities window

Remove a JMS job operations lock

Certain JMS administration operations create a job operations lock. That lock should be removed
automatically when the operation is finished.

SPATIALinfo Inc.

57 of 69

In the rare case that a job operations lock is not removed automatically, you can remove it yourself.
Warning: Only remove a lock when you are sure that the operation has completed. Running multiple
JMS administration operations at the same time can cause network corruption.

To remove a JMS job operations lock:

On the spatialNET JMS Administration window, click the Cleanup button, and then
click Cleanup JMS job operations lock.

Figure 39: The JMS Administration Tool window with Cleanup JMS job operations lock highlighted

View information about the current selection

You can open the Current Selection window directly from the JMS Administration window. The
functions on the Current Selection window are intended to be used while running the spatialNET
client.

To view information about the current selection:

On the spatialNET JMS Administration window, click the Debug button, and then click
Status panel. The spatialNET Current Selection window appears.

Debugging tools
There are several debugging tools available under the Debug menu on the JMS Administration Tool
window. Except for the Status option (see View information about the current selection), these
debugging tools should only be used under direction from a spatialNET support engineer.

Viewing job type definitions

The job type definitions define the different job types that a user chooses among when creating new
spatialNET job. You can view the Job definitions directly from the JMS Administration Tool window.

58 of 69

SPATIALinfo Inc.

To view job definitions:

On the spatialNET JMS Administration panel, click the Dictionaries button, and then
click Job Definitions. The Job Definitions window appears displaying a list of job
definitions.

View user type definitions

To view and user type definitions:

On the spatialNET JMS Administration panel, click the Dictionaries button, and then click
User Definitions. The User Definitions window appears.

Figure 40: The User Definitions window

Find and edit field Jobs

You can open a Find Field Job window directly from the JMS Administration Tool window. For more
information about field jobs, refer to the spatialNET User Manual.

To find field jobs:

On the spatialNET JMS Administration panel, click the Field Jobs button. The Find Field
Jobs window appears. From here, you can search for a field job.

Job administration
View all your current jobs
Click the My Jobs button from the spatialNET JMS Administration Tool panel to view a list of all jobs
currently logged to your name in the selected database.

SPATIALinfo Inc.

59 of 69

Figure 41: The All jobs window

Find a job
To find a job:
1.

Click the Find job button on the spatialNET JMS Administration window.

Type a search term in a search fields at the top of the window.

Figure 42: The Find Job window with the Description search field highlighted

60 of 69

Click the search operator button to the left of the search field, and then click the
appropriate option.

SPATIALinfo Inc.

Figure 43: The Find Job window with search operators

The list of jobs is filtered to match your search.

NOTE: The Find Job window lists up to 256 jobs at a time. To force the window to show more
matching jobs, click the Retrieve button.

Create a new job

Create a new job from the My jobs or the Find job window. The steps below use the Find Job
window.

To create a new job:

Click the Find job button on the spatialNET JMS Administration window. The My Job
window appears.

Click the New button to open the Job Creation window.

Figure 44: Job Creation window

SPATIALinfo Inc.

61 of 69

Enter all required details and click the Add button. Click on the Close button to close the
window.

Edit a job
Edit a job from the My jobs or the Find job window. The steps below use the Find job window.

To edit a job:
1.

Click the Find job button on the spatialNET JMS Administration window. The Find job
window appears.

Search for the job using the search fields at the top of the window.

Click a job in the list, then click the Edit button. The Job Modification window appears.

Figure 45: The Job Modification window

Make appropriate changes, and then click Apply to save the changes.

Click Close to close the window.

View details for a job

View details of a job from the My jobs or the Find job window. The steps below use the Find job
window.

62 of 69

SPATIALinfo Inc.

To view details for a job:

Click the Find job button on the spatialNET JMS Administration window. The Find job
window appears.

Search for the job using the search fields at the top of the window.

Click a job in the list, then click the Details button. The Job Details window appears.

Figure 46: The Job Details window

Reset a job
If a spatialNET design session crashes for any reason, the job that was open at the time will continue
to be identified as open. That job must be reset before it can be accessed again.
You can reset a job from the My jobs or the Find job window. The steps below use the Find job
window.

To reset a job:
1.

On the spatialNET JMS Administration window, click the Find job button. The Find job
window appears.

Search for the job using the search fields at the top of the window.

Click a job in the list, then click the Reset button. The job is reset and can be opened.

SPATIALinfo Inc.

63 of 69

Troubleshooting
Cannot open a job because it is already open
If a spatialNET design session crashes for any reason, the job will be still identified as open. The job
must be reset before it can be accessed again.

If the user has a Reset button available on the Job Selection window, then the user should
click that button. (An administrator can edit the users security group to enable the Reset
button. See Edit a security group.)

If the user has no Reset button, an administrator must reset the job. See: Reset a job.

Database shutdown causes batch queue to lock up

To maintain queue and database integrity, only one user can run a given batch queue at any one
time. An attempt to run a queue that is already running will generate an error message.
If a database shutdown or backup process breaks the connection between the batch queue and the
database, the queue will no longer be able to process jobs.
The spatialNET batch queue process must be shut down, reset and restarted so that job processing
can recommence.

Reset queue where a session has crashed

If a spatialNET queue crashes for any reason, the queue will be still identified as running and the job
will still be identified as open. Reset the queue.
It may also be necessary to reset the job that was open at the time of the crash.

Missing symbol xxx appears beside symbols in spatialNET

views
If the symbol specified in the dictionary for an item type is not in the symbol\smt directory of the
current installation (or in a template or the AutoCAD search path), a default symbol and message will
appear. Ensure that the dictionary entry refers to a symbol that actually exists.

64 of 69

SPATIALinfo Inc.

Table of Figures
Figure 1 : Client / server relationship for Oracle Spatial / Locator driver .............................................. 8
Figure 2: dbed2 utility...................................................................................................................... 16
Figure 3: The spatialNET installation Welcome page ....................................................................... 22
Figure 4: License agreement ........................................................................................................... 22
Figure 5: Select Destination Location .............................................................................................. 23
Figure 6: Select Components ........................................................................................................... 23
Figure 7: Ready to Install ................................................................................................................. 24
Figure 8: Login dialog box ............................................................................................................... 25
Figure 9: My Computer Properties with Advanced system settings highlighted ............................... 25
Figure 10: The Environment Variables window ................................................................................ 26
Figure 11: System variables ............................................................................................................. 26
Figure 12: Error message ................................................................................................................. 26
Figure 13: Administrator Command Prompt path .............................................................................27
Figure 14: The JMS admin tool with My jobs highlighted ................................................................. 28
Figure 15: The Queue for Publish option .......................................................................................... 28
Figure 16: The JMS admin tool with My jobs highlighted ................................................................. 29
Figure 17: The Queue for Post option............................................................................................... 29
Figure 18: JMS Administration Results window description of buttons ............................................ 30
Figure 19: The All batch queues window's Display menu ................................................................... 31
Figure 20: The Queue Control window ............................................................................................ 32
Figure 21: The data model ................................................................................................................ 33
Figure 22: BQM process flow ........................................................................................................... 34
Figure 23: The batch queue process ................................................................................................. 40
Figure 24: Search for Event Viewer .................................................................................................. 42
Figure 25: Create a custom view in the Even Viewer ........................................................................ 42
Figure 26: The Create Custom View window.................................................................................... 43
Figure 27: The Event Viewer with Attach Task highlighted .............................................................. 43
Figure 28: The JMS Administration Tool window ............................................................................. 50
Figure 29: The All users window .......................................................................................................51
Figure 30: User details ..................................................................................................................... 52
Figure 31: The User Modification window ........................................................................................ 52
Figure 32: The All security groups window ....................................................................................... 54
Figure 33: The Security Group Creation window .............................................................................. 55
Figure 34: The All security groups window ....................................................................................... 55
Figure 35: The Security group modification window ........................................................................ 56
Figure 36: All security groups delete ............................................................................................. 56
Figure 37: The JMS Administration Tool with Cleanup posted removed entities highlighted .............57
Figure 38: Cleanup of Posted Removed entities window ...................................................................57
Figure 39: The JMS Administration Tool window with Cleanup JMS job operations lock highlighted 58
Figure 40: The User Definitions window .......................................................................................... 59
Figure 41: The All jobs window ........................................................................................................ 60
Figure 42: The Find Job window with the Description search field highlighted ................................. 60
Figure 43: The Find Job window with search operators .................................................................... 61
SPATIALinfo Inc.

65 of 69

Figure 44: Job Creation window....................................................................................................... 61

Figure 45: The Job Modification window ......................................................................................... 62
Figure 46: The Job Details window .................................................................................................. 63
Figure 47: Oracle Net Configuration Assistant Welcome window..................................................... 67
Figure 48: Oracle Net Configuration Assistant second window ........................................................ 68
Figure 49: Oracle Net Configuration Assistant fourth window ......................................................... 68
Figure 50: Oracle Net Configuration Assistant sixth window ............................................................ 69
Figure 51: Oracle Net Configuration Assistant seventh window ....................................................... 69

66 of 69

SPATIALinfo Inc.

Appendix: use Oracle Net Configuration Assistant

to set up the tnsnames.ora file
During installation of the Oracle client, a tnsnames.ora file was created. To configure that file
manually, see Set up tnsnames.ora for new database connections.
If you prefer to set up the file using the Oracle Net Configuration Assistant, then follow the
instructions below.

To create a tnsnames.ora file using the Oracle Net Configuration Assistant:

Click the Windows Start button, and then click Oracle.

Click Configuration and Migration Tools and then click Net Configuration Assistant. The
Welcome window appears.

Figure 47: Oracle Net Configuration Assistant Welcome window

Select Local Net Service Name configuration, and then click Next.

SPATIALinfo Inc.

67 of 69

In the window that appears, select Add, and then click the Next button.

Figure 48: Oracle Net Configuration Assistant second window

In the Service Name field, type the global database name that was set up by the IT
administrator during the Oracle server install.

Click the Next button.

Select TCP, and then click Next.

Figure 49: Oracle Net Configuration Assistant fourth window

68 of 69

Obtain the IP address of the server from an IT administrator and enter type it in the Host
Name field. Keep the standard port number of 1521, then click Next.

SPATIALinfo Inc.

Select Yes, perform a test, and then click Next. The test will run.

Figure 50: Oracle Net Configuration Assistant sixth window

10. If the test was successful, click Next, and continue to the next step. If the test was not
successful, use the Back button to verify the data entered to this point, then make the
necessary corrections and continue to the next step.

NOTE: If the failure is caused by the user name and password, click the Change Login button
and enter the SPATIALinfo database administrator user name and password.

Figure 51: Oracle Net Configuration Assistant seventh window

11. Enter the Net Service Name created during the Oracle server installation, followed by the
server name. Example: servicename.companyname.net_fullservername

SPATIALinfo Inc.

69 of 69

12. Click Next.

13. In the final window, click Finish.

To test that the file was configured correctly:

Locate the tnsname.ora file on the computer and on the server at:
c:\oracle\product\11G\client_1\NETWORK\ADMIN

Verify that the text in the two tnsname.ora files is identical.

70 of 69

SPATIALinfo Inc.

Admin Guide
100% (1)
Admin Guide
404 pages
Light Brigade
100% (1)
Light Brigade
74 pages
8830 Hardware Installation Guide
100% (1)
8830 Hardware Installation Guide
132 pages
NDIFOR - Internship Report Draft
No ratings yet
NDIFOR - Internship Report Draft
77 pages
SSMOD-28M Ethernet User Manual English
No ratings yet
SSMOD-28M Ethernet User Manual English
108 pages
DPA5 User Manual
No ratings yet
DPA5 User Manual
67 pages
ANSYS POLYFLOW in ANSYS Workbench User's Guide
No ratings yet
ANSYS POLYFLOW in ANSYS Workbench User's Guide
54 pages
Cubase 5 Keyboard Shortcuts & Macros (Charts + How-To) PDF
80% (5)
Cubase 5 Keyboard Shortcuts & Macros (Charts + How-To) PDF
7 pages
ABR I-O Driver Manual PDF
No ratings yet
ABR I-O Driver Manual PDF
209 pages
Spatialnet: End-To-End Physical Network Inventory Management
No ratings yet
Spatialnet: End-To-End Physical Network Inventory Management
3 pages
Resume
No ratings yet
Resume
7 pages
Network Design
No ratings yet
Network Design
346 pages
FTTX Pon Exfo Guide v5 Eng
No ratings yet
FTTX Pon Exfo Guide v5 Eng
116 pages
OSP Data
No ratings yet
OSP Data
6 pages
Dense Wavelength Division Multiplexing
No ratings yet
Dense Wavelength Division Multiplexing
34 pages
Installation Guide 7 1 5
No ratings yet
Installation Guide 7 1 5
166 pages
Eclipse Packet Node INU INUe ETSI Technical Specifications June 2012
No ratings yet
Eclipse Packet Node INU INUe ETSI Technical Specifications June 2012
11 pages
FTTH Handbook - 2014 V6.0
No ratings yet
FTTH Handbook - 2014 V6.0
162 pages
SMC Draft Licensing Guideline
No ratings yet
SMC Draft Licensing Guideline
51 pages
Comparison of VSAT and Microwave Link in Afg - 23-9-13
No ratings yet
Comparison of VSAT and Microwave Link in Afg - 23-9-13
3 pages
LPS36
No ratings yet
LPS36
88 pages
LCT-XDM Um Ansi A00 6.2 en
No ratings yet
LCT-XDM Um Ansi A00 6.2 en
488 pages
Network-Design-Rules 2016 PDF
No ratings yet
Network-Design-Rules 2016 PDF
68 pages
LTE Basics
No ratings yet
LTE Basics
10 pages
Experts Guide To OTN Ebook
No ratings yet
Experts Guide To OTN Ebook
40 pages
School District of Palm Beach County
No ratings yet
School District of Palm Beach County
5 pages
Motorola Network Solutions
No ratings yet
Motorola Network Solutions
72 pages
ZXONE 8300&8500&8700 Acceptance Test Guide - R1.7
No ratings yet
ZXONE 8300&8500&8700 Acceptance Test Guide - R1.7
441 pages
Broadband FTTX Ordering Guide CO-108716
No ratings yet
Broadband FTTX Ordering Guide CO-108716
12 pages
DWDM Tutorial
No ratings yet
DWDM Tutorial
20 pages
ZXSS10 Network Design Scheme (LLD) - Template - 361048
No ratings yet
ZXSS10 Network Design Scheme (LLD) - Template - 361048
16 pages
07 Optical Power Debugging 39P
No ratings yet
07 Optical Power Debugging 39P
39 pages
DDF Krone
No ratings yet
DDF Krone
31 pages
JTLCompany Profile
No ratings yet
JTLCompany Profile
10 pages
Things To Know About Wifi6
No ratings yet
Things To Know About Wifi6
1 page
Enterprise WLAN Design Guide2
No ratings yet
Enterprise WLAN Design Guide2
320 pages
ZXSS10 SS1b Product Description
100% (2)
ZXSS10 SS1b Product Description
50 pages
Optic Fiber Network Planning
No ratings yet
Optic Fiber Network Planning
70 pages
T-REC-G.979-201611-I!!PDF-E (Submarine Cables Etc)
No ratings yet
T-REC-G.979-201611-I!!PDF-E (Submarine Cables Etc)
16 pages
Fleximrbts mr10bts Inst Opt Items
No ratings yet
Fleximrbts mr10bts Inst Opt Items
330 pages
Commosioning NSN Bts PDF
No ratings yet
Commosioning NSN Bts PDF
14 pages
7670 RSP ESE Product Engineering Information Nov07
No ratings yet
7670 RSP ESE Product Engineering Information Nov07
73 pages
Adtran - Packet Optical 2.0 - Supporting Video and Gigabit Services
No ratings yet
Adtran - Packet Optical 2.0 - Supporting Video and Gigabit Services
36 pages
Siklu EtherHaul 8010 Installation Operation and Maintenance Manual - EH8010-IO-01 - Issue8 (Nov 2020)
No ratings yet
Siklu EtherHaul 8010 Installation Operation and Maintenance Manual - EH8010-IO-01 - Issue8 (Nov 2020)
103 pages
AW10724 REV 3 Fibre Cabling Advice
No ratings yet
AW10724 REV 3 Fibre Cabling Advice
24 pages
6500 Packet-Optical Platform, R9.0, Fault Management - Alarm Clearing, Part 1 of 2, Issue 1, 323-1851-543.1
No ratings yet
6500 Packet-Optical Platform, R9.0, Fault Management - Alarm Clearing, Part 1 of 2, Issue 1, 323-1851-543.1
506 pages
Stadiums Telecom Infrastructure Guidelines
No ratings yet
Stadiums Telecom Infrastructure Guidelines
35 pages
DHSA-VSS Video Surveillance System: Training Introduction
No ratings yet
DHSA-VSS Video Surveillance System: Training Introduction
3 pages
ATP Document Indosat DWDM LBG-BTN Link Test
No ratings yet
ATP Document Indosat DWDM LBG-BTN Link Test
29 pages
Eclipse 07 03 40 Customer Release Notes
No ratings yet
Eclipse 07 03 40 Customer Release Notes
17 pages
FTTH Pat
No ratings yet
FTTH Pat
4 pages
1655amu E&o 5.0
No ratings yet
1655amu E&o 5.0
19 pages
Alcatel-Lucent 1850 TSS-3
No ratings yet
Alcatel-Lucent 1850 TSS-3
196 pages
Lorawan Protocol: Specifications, Security, and Capabilities
No ratings yet
Lorawan Protocol: Specifications, Security, and Capabilities
27 pages
5G Architecture
No ratings yet
5G Architecture
8 pages
Cisco ONS 15216 Series
No ratings yet
Cisco ONS 15216 Series
38 pages
Hit 7065 Icma
100% (1)
Hit 7065 Icma
48 pages
CCRP - IP-20N Manual
No ratings yet
CCRP - IP-20N Manual
281 pages
Ceragon Installation Method - 1.2
No ratings yet
Ceragon Installation Method - 1.2
23 pages
ECI NPT-1020 Product Note
100% (1)
ECI NPT-1020 Product Note
2 pages
Drive testing The Ultimate Step-By-Step Guide
From Everand
Drive testing The Ultimate Step-By-Step Guide
Gerardus Blokdyk
No ratings yet
DPA5 User Manual
No ratings yet
DPA5 User Manual
64 pages
DPA5 User Manual PDF
100% (1)
DPA5 User Manual PDF
61 pages
Vmware Ruby Vsphere Console Command Reference For Virtual San
No ratings yet
Vmware Ruby Vsphere Console Command Reference For Virtual San
82 pages
Service Portal User Training - V1.0
No ratings yet
Service Portal User Training - V1.0
20 pages
Mobatec Modeller Intorduction Course Tutorial I
No ratings yet
Mobatec Modeller Intorduction Course Tutorial I
10 pages
Mcafee Siem Alarms: Setting Up and Managing Alarms in Mcafee Esm 10.X
No ratings yet
Mcafee Siem Alarms: Setting Up and Managing Alarms in Mcafee Esm 10.X
28 pages
Loadrunner Test
No ratings yet
Loadrunner Test
6 pages
Configuring MD Adams 2010
No ratings yet
Configuring MD Adams 2010
92 pages
Daman Digital Card
100% (1)
Daman Digital Card
31 pages
Change List For Vista/Win7 Driver 10.0.0.67
No ratings yet
Change List For Vista/Win7 Driver 10.0.0.67
3 pages
Progress Transfer User Guide
No ratings yet
Progress Transfer User Guide
8 pages
Cloud Computing Test Bank
No ratings yet
Cloud Computing Test Bank
18 pages
7466443
No ratings yet
7466443
357 pages
Pi Atcimio 1.2.0.0
No ratings yet
Pi Atcimio 1.2.0.0
27 pages
Cruise Control Tutorial
No ratings yet
Cruise Control Tutorial
26 pages
Getting Started STAAD 2005
100% (1)
Getting Started STAAD 2005
570 pages
+64 21 441-143 - : Info@circle - Consulting - Co.nz - 29 Adventure Drive, Whitby, Wellington 5024, New Zealand WWW - Circle-Consulting - Co.nz
No ratings yet
+64 21 441-143 - : Info@circle - Consulting - Co.nz - 29 Adventure Drive, Whitby, Wellington 5024, New Zealand WWW - Circle-Consulting - Co.nz
2 pages
Day3-04.Hacking Apple Accessories To Pown IDevices - Wake Up Neo! Your Phone Got PWND ! by Mathieu GoToHack RENARD
No ratings yet
Day3-04.Hacking Apple Accessories To Pown IDevices - Wake Up Neo! Your Phone Got PWND ! by Mathieu GoToHack RENARD
54 pages
Avaya ONE-X Mobile Server 5.2 Installation Document v1: Author: Neeraj Mishra
No ratings yet
Avaya ONE-X Mobile Server 5.2 Installation Document v1: Author: Neeraj Mishra
15 pages
Mininet and Openflow Labs
No ratings yet
Mininet and Openflow Labs
14 pages
(Ebook) Borland - Internet Programming With Delphi (Marco Cantu) PDF
No ratings yet
(Ebook) Borland - Internet Programming With Delphi (Marco Cantu) PDF
14 pages
INT-L - M02 - C02 - SLM - Working With UNIX File System
No ratings yet
INT-L - M02 - C02 - SLM - Working With UNIX File System
30 pages
Installation Manual
No ratings yet
Installation Manual
31 pages
Creating tables, forms, queries
No ratings yet
Creating tables, forms, queries
2 pages
20221018
No ratings yet
20221018
380 pages
CASE STUDY - 3 Vivobarefoot Upgrades Technology Infrastructure
No ratings yet
CASE STUDY - 3 Vivobarefoot Upgrades Technology Infrastructure
3 pages
How To Install WITS Global Tariff Cuts and Trade Simulator
No ratings yet
How To Install WITS Global Tariff Cuts and Trade Simulator
10 pages
Web-ADI Template Settings For Microsoft Excel
No ratings yet
Web-ADI Template Settings For Microsoft Excel
14 pages