Documentation Overview, Audience | HP c-tree-SQL ISQL and Tools

Documentation Overview

PURPOSE OF THIS MANUAL

This manual provides reference material for the ISQL interactive SQL utility as well as the dbload, dbdump, and dbschema administrative tools provided in the c-treeSQL environment. It also includes a tutorial describing how to use the ISQL utility.

AUDIENCE

The reader of this manual should be familiar with general SQL concepts.

STRUCTURE

The manual contains the following chapters:

Chapter 1	Describes the use of Interactive SQL (ISQL) for performing ad-hoc queries
	and for report generation.

Chapter 2	Includes tutorials for getting started with ISQL.

Chapter 3	Includes reference information for ISQL statements.

Chapter 4	Describes the data load utility, dbload, which is used to load data from files
	into existing tables of a database.

Chapter 5	Describes the data unload utility, dbdump.

Chapter 6	Describes the data definition export utility, dbschema.

Appendix A	Includes full source code for tutorials.

SYNTAX DIAGRAM CONVENTIONS

Syntax diagrams appear in Courier type and use the following conventions:

UPPERCASE

Uppercase type denotes reserved words. You must include reserved words in statements, but they can be upper or lower case.

FairCom Corporation

v

Image 7

HP c-tree-SQL ISQL and Tools manual Documentation Overview, Purpose of this Manual, Audience, Structure

Contents

For use with c-treeSQL Server Isql and Tools Reference GuidePage Table of Contents Data Load Utility dbload Iii Tutorial Source Code FairCom Corporation Audience Syntax Diagram ConventionsDocumentation Overview Purpose of this Manual Isql and Tools Related Documentation Overview Introduction Isql and Tools FairCom Corporation Isql Quick TourIntroductory Tutorial Init Isql Commit Work Custmast DefineManage Isql Create Table Custmast Complete Introductory Tutorial Code DoneQuick Tour ISQLTutorial2.sql Relational Model and Indexing Tutorial Quick Tour Values Insert Into Insert IntoValues QTY Price Commit Work Complete Relational Model and Indexing Tutorial Source Code ISQLTutorial3.sql Locking Tutorial @ISQL @iSQLTutorial3.sql Isql Delete from Custmast Complete Locking Tutorial Source Code ISQLTutorial4.sql Transaction Processing Tutorial Transaction Rollback Work Complete Transaction Processing Tutorial Source Code Arguments Isql StatementsStarting Interactive SQL Syntax Connectstring PasswordStatement History Support Username Statement Summary Formatting Output of Isql QueriesIsql Statements Isql Statements for Statement History Support Display Isql Statements for Query Formatting Summary Customername Customercity Orderid Ordervalue Example 3-1 Unformatted Query Display from Isql Example 3-2 Controlling Display Width of Character Columns Formatting Column Display with the Column Statement Ordervalue Example 3-3 Customizing Format of Numeric Column DisplaysCustomername Customercity Example 3-4 Specifying Column Breaks and Values with Display Numorders Customername Example 3-6 Specifying a Query Header and Footer with Title Transaction Support Help and Table Statements Example Isql Reference1 @ Execute Syntax Description Breakspec Break Syntax Skip n ExamplesCustomername History Clear Syntax Break Column Compute Display Title ArgumentColumn Syntax Option Format formatstring ColumnnameHeading headingtext Character Description Date-Time Format Strings for the Column Statement Not Null INT Null ? Type Length ColnameChar Amount OrderinfoSysdate Compute FLDColumn Title NEW Title Variablename AVG MAX MIN SUM Count Value Define Syntax @columnname ColpositionDisplayvalue COL columnnumber Edit Syntax Related Statements Exit or Quit SyntaxExit Isql GET query.sql 10 GET Syntax Isql RUN Orderstate Lotlocation Help CommandsclausesHelp Syntax History Syntax Following example illustrates usage of the History statement Host or SH or Syntax HostcommandFrom List Syntax Isql History Quit or Exit Syntax16 RUN Syntax Quit Linesize Save Syntax18 SET Syntax Pagesize Pagesize numberlines TBL Connection databasename DefaultTransaction Isolation Level isolationlevel Isql Break on Isql Select TBL from Systables TBL Show Syntax Database Connections Is Default ?Spool Syntax Filename on Isql Spool OFF Start SyntaxArgument … Isql Spool STK on Not Null Varchar Null ? Type Length Colname Not Null INT Type Length Colname Null ? TablenameDate Double Title SyntaxLeft Center Right COL n Text Isql Clear Title Isql and Tools FairCom Corporation Introduction Data Load Utility dbload Options Dbload Command Line SyntaxCommandsfile Prerequisites for Dbload Data Load Utility dbload Data File Formats Next Record Commands FileVariable Length Records Fixed Length Records Char Short Long Float Double Define Record Statement Null For Each Statement Examples Example 4-1 Sample dbload commands files Record name redefined Compilation ErrorsPosition not specified for fixed length record Fatal Errors Isql and Tools FairCom Corporation Prerequisites for Dbdump Data Unload Utility dbdump Dbdump Command Line Syntax Short Long Float Double Data Unload Utility dbdump For Record Statement Define Record custrec of Fixed Length 37 AS Isql and Tools FairCom Corporation Schema Export Utility dbschema Username.triggername Username.procedurenameOutfile Username.tablename END Schema Export Utility dbschemaDbschema Import Begin Isql and Tools FairCom Corporation Commit Work Select * from Custmast Delete from Custmast Tutorial Source Code Money IntegerVARCHAR6 Commit Work Delete from Custmast Tutorial Source Code Imdesc VARCHAR48 Select * from orderlist Select * from orderitems Isql and Tools FairCom Corporation Index-i Symbols Index-ii FairCom Corporation Isql Index-iii FairCom Corporation Index