Tempest™ DCS Toolkit Version 5.0 DECODES
Total Page:16
File Type:pdf, Size:1020Kb
Tempest™ DCS Toolkit Version 5.0 DECODES (Device Conversion and Delivery System) Reference Manual Document Revision 1.0 September, 2011 Copyright 2011 Sutron Corporation Sutron Corporation, ILEX Division 22400 Davis Drive Sterling, VA 20164 Tel: (703) 406-2800 Email: [email protected] Table of Contents Contents 1. INTRODUCTION TO DCS TOOLKIT / DECODES RELEASE ................................................. 1 1.1 INTRODUCTION TO DECODES ......................................................................................................... 1 1.2 WHAT’S NEW? .................................................................................................................................. 3 1.2.1 DCS Toolkit 5.0 ...................................................................................................................... 3 1.2.2 DCS Toolkit 4.9 ...................................................................................................................... 3 1.2.3 DCS Toolkit 4.6 ...................................................................................................................... 3 1.2.4 DCS Toolkit 4.5 ...................................................................................................................... 3 1.2.5 New for DECODES 7.5 .......................................................................................................... 3 1.2.6 New for DECODES 7.4 .......................................................................................................... 3 1.2.7 New Features for DECODES 7.3 ........................................................................................... 3 1.2.8 New Features for DECODES 7.1 ........................................................................................... 4 1.2.9 New Features for DECODES 6.5 ........................................................................................... 4 1.2.10 New Features for DECODES 6.4 ...................................................................................... 4 1.2.11 New Features for DECODES 6.3 ...................................................................................... 4 1.2.12 New Features for DECODES 6.2 ...................................................................................... 4 1.2.13 New Features for DECODES 6.1 ...................................................................................... 4 1.2.14 New Features for DECODES 6.0 ...................................................................................... 5 2. DECODES THEORY OF OPERATIONS ....................................................................................... 7 2.1 DECODES SOFTWARE CONPONENTS ............................................................................................... 8 2.2 DECODES DATABASE ARCHITECTURE ........................................................................................... 8 2.2.1 Setup Information ................................................................................................................... 8 2.2.2 Properties ............................................................................................................................. 12 2.2.3 Decoding, Formatting, and Converting Specifications ........................................................ 13 2.2.4 Sites & Site Names ................................................................................................................ 13 2.2.5 Platform Information ............................................................................................................ 14 2.2.6 Presentation and Unit Conversion ....................................................................................... 16 2.2.7 Routing Specification Information ........................................................................................ 17 3. CONFIGURING DECODES ........................................................................................................... 19 3.1 THE “DECODES.PROPERTIES” FILE .................................................................................................. 19 3.1.1 Surrogate Keys Generated by SQL Database ....................................................................... 21 3.1.2 Date Formats in SQL Database............................................................................................ 21 3.2 SQL DATABASE FORMAT CHANGES ............................................................................................... 22 4. MAINTAINING THE DECODES DATABASE ............................................................................ 23 4.1 INITIALIZING YOUR EDITABLE DECODES DATABASE .................................................................. 23 4.1.1 Standard XML Setup Files .................................................................................................... 23 4.1.2 Importing Data from EMIT or Pre-Release-5 DECODES ................................................... 24 4.1.3 Importing XML Data from Other DECODES Sites .............................................................. 25 4.2 INTERACTIVELY EDITING THE DATABASE ....................................................................................... 25 4.3 UPDATING THE INSTALLED DATABASE ........................................................................................... 26 4.4 EXPORTING PLATFORMS TO XML FILES ......................................................................................... 27 4.5 EXPORTING THE ENTIRE DATABASE ............................................................................................... 28 4.6 OTHER DATABASE UTILITIES .......................................................................................................... 28 4.6.1 Creating the Platform Cross-Reference File ........................................................................ 28 4.6.2 Creating LRGS-Style Network List Files .............................................................................. 29 5. THE DECODES DATABASE EDITOR ........................................................................................ 30 5.1 GUI ORGANIZATION ....................................................................................................................... 31 5.1.1 List Panels in General .......................................................................................................... 31 5.1.2 Edit Panels in General.......................................................................................................... 31 5.1.3 Exiting the Editor .................................................................................................................. 31 5.2 THE PLATFORM EDIT PANEL ........................................................................................................... 33 5.2.1 Platform Sensors ................................................................................................................... 33 5.2.2 Transport Media ................................................................................................................... 34 5.3 THE SITE EDIT PANEL ..................................................................................................................... 35 5.4 THE PLATFORM-CONFIG EDIT PANEL ............................................................................................. 37 5.4.1 The Decoding Script Edit Dialog .......................................................................................... 39 5.5 THE EQUIPMENT-MODEL EDIT PANEL ............................................................................................ 42 5.6 THE PRESENTATION GROUP EDIT PANEL ........................................................................................ 43 5.6.1 Using a Presentation Group as a Sensor Filter .................................................................... 44 5.7 THE DATA SOURCE EDIT PANEL ..................................................................................................... 45 5.8 THE NETWORK LIST EDIT PANEL .................................................................................................... 47 5.9 THE ROUTING SPECIFICATION EDIT PANEL ..................................................................................... 48 5.10 IMPORT XML FILES ................................................................................................................... 49 5.11 EXPORT RECORDS TO AN XML FILE .......................................................................................... 50 5.12 INSTALL RECORDS TO YOUR PRODUCTION DATABASE .............................................................. 52 5.12.1 Automatic Installation when You Change Records .......................................................... 52 5.12.2 Manual Installation to the Production Database. ............................................................ 53 6. THE DECODES FORMAT LANGUAGE ..................................................................................... 54 6.1 EXECUTION OF FORMAT STATEMENTS BY A ROUTING SPEC ........................................................... 54 6.2 STEPPING THROUGH THE SCRIPT AND THE DATA ............................................................................ 54 6.3 FORMAT OPERATION OVERVIEW .................................................................................................... 55 6.4 SKIPPING AND POSITIONING OPERATIONS ....................................................................................... 57 6.5