risutil

for 32-Bit ApplicationsRIS Utilities Guide

August 1996

DNA111760Version 5.4

Warranties and Liabilities

All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase contract,and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification oramendment of such warranties.

The information and the software discussed in this document are subject to change without notice and should not beconsidered commitments by Intergraph Corporation. Intergraph Corporation assumes no responsibility for anyerror that may appear in this document.

The software discussed in this document is furnished under a license and may be used or copied only in accordancewith the terms of this license.

No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied byIntergraph or its affiliated companies.

TrademarksInterAct, Intergraph, and RIS are registered trademarks of Intergraph Corporation. DIALOG, InterServe, and TD1are trademarks of Intergraph Corporation. All other brands and product names are trademarks of their respectiveowners.

Copyright 1996 Intergraph CorporationAll Rights Reserved

Including software, file formats, and audiovisual displays; may be used pursuant to applicable software licenseagreement; contains confidential and proprietary information of Intergraph and/or third parties which is protectedby copyright and trade secret law and may not be provided or otherwise made available without properauthorization.

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c) (1) (ii) ofThe Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and(2) of Commercial Computer Software Restricted Rights at 48 CFR 52.227-19, as applicable.

Unpublished rights reserved under the copyright laws of the United States.

Intergraph CorporationHuntsville, Alabama 35894-0001

Table of Contents__________________________________________________________________________________________________________________________________________________

__________________________________________________________________________________________________________________________________________________Table of Contents

1. Before You Begin .................................................................................................. 1 - 3

1.1 Document Purpose ....................................................................................... 1 - 31.2 Audience ....................................................................................................... 1 - 31.3 Document Prerequisites .............................................................................. 1 - 31.4 Related Documentation ............................................................................... 1 - 31.5 Additional Information ................................................................................ 1 - 41.6 Document Conventions ................................................................................ 1 - 41.7 Using On-line Help ...................................................................................... 1 - 6

1.7.1 Parts of the Help Window ................................................................ 1 - 6

2. Getting Started ..................................................................................................... 2 - 3

2.1 Products Needed to Use the RIS Utilities ................................................... 2 - 4

3. risbatch ................................................................................................................. 3 - 3

4. risclnsr .................................................................................................................. 4 - 3

5. risdcode ................................................................................................................. 5 - 3

6. risdtype ................................................................................................................. 6 - 3

7. risgui ..................................................................................................................... 7 - 3

7.1 Exiting the risgui Utility ............................................................................. 7 - 47.2 Performing Queries in the risgui Utility ..................................................... 7 - 47.3 Options... ...................................................................................................... 7 - 67.4 Utilities... ...................................................................................................... 7 - 77.5 Restart .......................................................................................................... 7 - 77.6 Set... .............................................................................................................. 7 - 87.7 Show... .......................................................................................................... 7 - 9

8. rislod ...................................................................................................................... 8 - 3

8.1 The Log File ................................................................................................. 8 - 88.2 The Bad File ................................................................................................. 8 - 98.3 Loading Index, View, and Privilege Definitions ......................................... 8 - 108.4 Using rislod with the Interactive Interface ................................................ 8 - 108.5 Using rislod with the Command Line Interface ......................................... 8 - 178.6 BNF Representation of rislod Command Line Syntax ............................... 8 - 18

9. rismgr .................................................................................................................... 9 - 3

9.1 RIS Schema Manager .................................................................................. 9 - 59.2 Schema Definition ........................................................................................ 9 - 7

9.2.1 Displaying Schema Information ...................................................... 9 - 99.2.2 Creating Schemas ............................................................................. 9 - 11

9.2.2.1 Creating Schemas (INFORMIX) ....................................... 9 - 159.2.2.2 Creating Schemas (ORACLE) ........................................... 9 - 179.2.2.3 Creating Schemas (DB2) ................................................... 9 - 199.2.2.4 Creating Schemas (SYBASE) ............................................ 9 - 229.2.2.5 Creating Schemas (Microsoft SQL Server) ....................... 9 - 24

9.2.3 Dropping Schemas ............................................................................ 9 - 269.2.4 Granting/Revoking Access Privileges to Secure Schemas .............. 9 - 289.2.5 Obtaining Dictionary Access ............................................................ 9 - 309.2.6 Modifying Schema Passwords .......................................................... 9 - 329.2.7 Modifying Node Information ............................................................ 9 - 339.2.8 Modify DB2 Password Form ............................................................ 9 - 35

9.3 Displaying Table, View, and Index Information ......................................... 9 - 37

9.3.1 Displaying Table Information .......................................................... 9 - 399.3.2 Creating Tables ................................................................................ 9 - 409.3.3 Dropping Tables ............................................................................... 9 - 429.3.4 Appending Columns to Tables ......................................................... 9 - 439.3.5 Including Tables, Views, and Indexes ............................................. 9 - 459.3.6 Excluding Tables, Views, and Indexes ............................................ 9 - 47

9.4 Reviewing and Manipulating Schema Files ............................................... 9 - 489.5 Locating RIS Client Processes ..................................................................... 9 - 509.6 Setting Modes and Enabling Databases ..................................................... 9 - 52

10. risplbck ................................................................................................................ 10 - 3

11. risrecrd ................................................................................................................ 11 - 3

12. risunlod ............................................................................................................... 12 - 3

12.1 Using risunlod with the Interactive Interface ........................................ 12 - 712.2 Using risunlod With the Command Line Interface ................................ 12 - 1312.3 BNF Representation of risunlod Command Line Syntax ....................... 12 - 16

Appendix A: Changes to This Version of RIS .......................................................... A - 3

A.1 RDBMS Versions ............................................................................................... A - 3A.2 UNION and UNION ALL Supported ................................................................ A - 3A.3 Objects of Different Owners Within a Schema ................................................. A - 3A.4 Object Aliases ..................................................................................................... A - 4

A.5 Multi-User/Secure Schemas .............................................................................. A - 5A.6 Shared Dictionaries ........................................................................................... A - 6A.7 Dictionary Objects .............................................................................................. A - 6A.8 Dictionary Views ................................................................................................ A - 7A.9 RIS_BLOB/RIS_TEXT ....................................................................................... A - 8A.10 Interoperability ................................................................................................ A - 11A.11 Upgrade Utility ................................................................................................ A - 12A.12 Utilities ............................................................................................................. A - 12A.13 Parameters ....................................................................................................... A - 13A.14 Internationalization ......................................................................................... A - 13

Appendix B: File Formats for risunlod and rislod ................................................... B - 3

B.1 Format for Representing Schema Definitions .................................................. B - 5B.2 Format for Representing Table Definitions ...................................................... B - 6B.3 Format for Representing Insert Into Statements .......................................... B - 6B.4 Format for Representing Field Definitions ....................................................... B - 6B.5 Format for Representing Table Data ................................................................ B - 8B.6 Format for Representing Data File Specifications ........................................... B - 9B.7 Format for Representing Index, View, and Privilege Definitions .................... B - 10B.8 File Format for Data Files ................................................................................. B - 10B.9 Use of Spaces and New Line Characters .......................................................... B - 10B.10 BNF Representation of File Formats .............................................................. B - 11

Glossary ....................................................................................................................... GL - 3

Index ............................................................................................................................ IN - 3

Before You Begin 1 - 1

Before You Begin__________________________________________________________________________________________________________________________________________________

1 - 2 Before You Begin


__________________________________________________________________________________________________________________________________________________1.

Before You Begin

1.1 Document Purpose

The RIS Utilities Guide for 32-Bit Applications describes the RIS utilities.

1.2 Audience

This document was written for application users, application designers, and computersoftware specialists.

1.3 Document Prerequisites

This document assumes a basic understanding of your operating system, RDBMS software,and RIS.

1.4 Related Documentation

DNA1151 RIS Installation Guide for 32-Bit ApplicationsDNA1116 RIS SQL Users Guide for 32-Bit ApplicationsDNA1003 RIS SQL Commands Quick ReferenceDNA1119 RIS Programmers Guide for 32-Bit ApplicationsDNA1009 RIS Programmers Quick Reference

For information about SQL terms and database structure, refer to documents related tospecific relational database management systems (INFORMIX, ORACLE, DB2, SYBASE, orMicrosoft SQL Server).


1.5 Additional Information

For additional information about RIS, see the following files delivered with the RIS software.The default location for these files is the c:\Program Files\risdp directory.

README Provides product information and describes changes andadditions to the product since the last release.

product.def Lists all dependencies and related parts for the product.

MANIFEST.TXT Lists all files delivered with the product.

1.6 Document Conventions

Filenames and directory paths appear in italic typeface. However, the italic typeface isalso used for emphasis of new words or important phrases. For example:

c:\windows

Command names, menu names, tools, system prompts and messages, and keys mayappear in boldface type. For example:

File menu

OR

Press Enter

The word mouse refers to the 2-button or 3-button mouse.

The word select means to select a command by pressing the left mouse button over amenu command or by pressing the Alt key and the underlined charactersimultaneously.

The word choose means to choose a button or icon by pressing the left mouse buttonover a Toolbar button, or application icon.

The word reset means to terminate a command initiated with the mouse. Reset bypressing the right mouse button.

The word identify means to define an area or place graphic elements in a graphics file.For PCs, identify with the left mouse button.

The phrase key in generally means to enter data into a field on a dialog box. Toadvance to the next field, use the Tab key.


System key-ins, keywords, and programming code segments, appear in monospacedtype. For example:

main ( )

OR

commit

In actual usage, keywords can be in either upper or lowercase.

Words that appear in angle brackets, < >, are identifiers or names that you mustsupply, or dynamic information that can change for each error message. For example:

ERROR: Error opening the file

Phrases in square brackets, [ ], are optional phrases.

Curly braces contain several options (used in conjunction with a logical OR symbol ( | )or phrases that can be repeated (used in conjunction with [, ...]). A comma followed by aseries of three periods in square brackets ([, ...]) indicates that the last phrase containedwithin curly braces ({}), or the last item, can be repeated numerous times (separated bycommas).

For example: { } [, ...] means that numerous column names andassociated data types can be specified (separated by commas).

The logical or symbol ( | ) separates phrases or keywords within curly braces ({}) thatcan be used alone but not together.

For example: { user | database } means that either the user keyword or thedatabase keyword can be specified, but not both.

This symbol notes important information.

This symbol cautions about operations that can cause limited damage.

This symbol warns about operations that can cause severe damage.


1.7 Using On-line Help

On-line Help is an on-line reference tool accessible at any time the application is in use. Theon-line Help contains a description for each command and tool and step-by-step proceduresfor common tasks. For example, if you need to perform a certain task, search and display thetopic. You can move or resize your application and Help windows so that they are next toeach other. This lets you follow the procedures without having to search for the pages in thedocumentation.


1.7.1 Parts of the Help Window

To view the on-line Help, select Contents from the Help menu. To get more specificinformation, select one of the major topics or perform a search on a specific topic.


Use To

Contents Display a listing of the table of contents forthe on-line Help file.

Search Locate information about a certain topic thatyou enter in the Search box.

Back Take you back to the previous Help topics youhave already viewed.

History Display a sequential list of every Help topicyou have viewed during your current Windowssession.

Find Display a dialog box used to retrieve partial orfull text strings in the help file. Use theHints button for information on constructingyour search query.

> View the next topic in a series of relatedtopics. The button is dimmed when you reachthe last topic in the series.

If the graphics in the on-line Help appear distorted, check your graphics driver.If you are using an Intergraph TD1 machine, the S3 1024x768 256 color (LargeFont) distorts the graphics slightly. Changing to the (Small Font) versioncorrects the display. If you are using other drivers, check with your PC manualfor information about available graphics drivers.

Getting Started 2 - 1

Getting Started__________________________________________________________________________________________________________________________________________________

2 - 2 Getting Started

Getting Started 2 - 3

__________________________________________________________________________________________________________________________________________________2.

Getting Started The Intergraph Relational Interface System (RIS) is a generic interface to relationaldatabase management systems (RDBMSs). RIS offers simultaneous connections to RDBMSsfrom many vendors on dissimilar hardware platforms using numerous protocols. RIS makesan entire network of databases available as if there were a single, local database.

During installation, the RIS utilities path is added to the system pathenvironment variable. By default, the utilities are loaded in c:\ProgramFiles\Common Files\Intergraph\ris05.nn\bin.

RIS Utilities:

1. RIS Batch risbatch

Executes SQL statements in ASCII files.

2. RIS Clean Server risclnsr

Cleans up some of the RIS dictionary tables.

3. RIS Decode risdcode

Prints the error message for a RIS error code.

4. RIS Data Types risdtype

Instructs RIS to interpret a columns data type in a different manner.

5. RIS Interactive risgui

Interactively query databases using RIS.

6. Configure RIS Version risintop

Described in the RIS Installation Guide for 32-Bit Applications.

7. RIS Loader rislod

Transfers data from specially formatted files into new or existing schemas.

8. RIS Playback risplbck

Reads and executes files containing RIS commands generated by applications andcaptured with the risrecrd utility.

2 - 4 Getting Started

9. RIS Record risrecrd

Records all SQL statements and timing data into specially formatted files. Useful forrepeating long sequences when trying to uncover program problems.

10. RIS Unloader risunlod

Extracts data from a schema and places it into specially formatted files.

11. Upgrade Utility risupgrd

Converts a schema (dictionary and schema file) from RIS Version 4 to RIS Version 5.

2.1 Products Needed to Use the RIS Utilities

Refer to the RIS Installation Guide for 32-Bit Applications for information concerningproducts needed to use the RIS Utilities.

risbatch 3 - 1

risbatch__________________________________________________________________________________________________________________________________________________

3 - 2 risbatch

risbatch 3 - 3

__________________________________________________________________________________________________________________________________________________3.

risbatch This utility is a simple, shell-callable program providing easy access to RIS and to underlyingdatabases. The primary purpose of this utility is batch execution of SQL statements.

Any SQL statement can be specified in an input file, provided that you have the properaccess.

All SQL statements must be terminated with a semicolon (;).

The RIS_PARAMETERS environment variable is used to specify the location of theparms file.

Output is directed to stdout when the -o option is not used.

To start the risbatch utility, do one of the following:

Type risbatch in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS Batch icon:

3 - 4 risbatch

Usage______

risbatch [-?] [-V] [-i ] [-o ]

Flags______

If you do not specify any command-line arguments, or if you startthe utility by selecting its icon from the Program Manager, theutility runs interactively and prompts for the necessaryinformation.

-? Display usage information and exit.

-V Display version information and exit.

-i Specify the input file containing the RIS SQL statements. Thelocate client command prompts for the client version.

-o Specify the output file where output is stored.

Type help at the risbatch prompt to get a list of available non-SQLcommands.

Examples_________

In this example, risbatch is invoked with the input file input.sql and the output fileoutput.sql:

risbatch -i input.sql -o output.sql

Files_____

c:\Program Files\Common Files\Intergraph\ris05.nn\bin\risbatchc:\Program Files\Common Files\Intergraph\ris05.nn\parmsc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\ris.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\net.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\utl.msg

Status Returns______________

0 Normal termination.other Abnormal termination.

risclnsr 4 - 1

risclnsr__________________________________________________________________________________________________________________________________________________

4 - 2 risclnsr

risclnsr 4 - 3

__________________________________________________________________________________________________________________________________________________4.

risclnsr This interactive utility deletes all nonessential records from the RIS dictionary tables. Thisutility is provided to clean up when the server process has not been able to do so. The serverfails to clean up when it is killed or the machine is shutdown or rebooted.

Do not run this utility while the schemas to be cleaned are being accessed.

To start the risclnsr utility, do one of the following:

Type risclnsr in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS Clean Servericon:

4 - 4 risclnsr

Choose the RIS 05.nn icon from the Program Manager; then choose the RIS Interactiveicon. Choose the Utilities... button from the RIS Interactive form; then choose the RISClean Server... button from the Utilities form.

If you use another utility within RIS Interactive, you must choose the Restartbutton before RIS Interactive is aware of any RIS parameter changes, orcreating or dropping of schemas.

Usage______

risclnsr [-?] [-V] schema[.password] [user[.password]] [osuser[.password]]

The osuser[.password] option specifies the user and password for a secure schema. If theschema specified is a secure schema, risclnsr prompts for the osusername and osusernamepassword (if one exists).

Flags______

If you do not specify any command-line arguments, or if you start theutility by selecting its icon from the Program Manager, the utility runsinteractively and prompts for the necessary information.



Files_____

c:\Program Files\Common Files\Intergraph\ris05.nn\bin\risclnsrc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\ris.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\net.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\utl.msg


0 Normal termination.1 Abnormal termination.

risdcode 5 - 1

risdcode__________________________________________________________________________________________________________________________________________________

5 - 2 risdcode

risdcode 5 - 3

__________________________________________________________________________________________________________________________________________________5.

risdcode This utility prints error messages for RIS error codes.

To start the risdcode utility, do one of the following:

Type risdcode in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS Decode icon:

5 - 4 risdcode

Choose the RIS 05.nn icon from the Program Manager; then choose the RIS Interactiveicon. Choose the Utilities... button from the RIS Interactive form; then choose the RISDecode... button from the Utilities form.


Usage______

risdcode [-?] [-V] []

Flags______




Decimal, octal, or hexadecimal error code.

Examples_________

To get the error message corresponding to an error code of 100, key in one of the following:

risdcode 100 (Using decimal.)

risdcode Ox64 (Using hexadecimal.)

risdcode 0144 (Using octal.)

risdcode

You are prompted to key in the value to be decoded. In this case, key in 100.

risdcode 5 - 5

Files_____

c:\Program Files\Common Files\Intergraph\ris05.nn\bin\risdcodec:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\ris.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\net.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\utl.msg


0 Always zero.

5 - 6 risdcode

risdtype 6 - 1

risdtype__________________________________________________________________________________________________________________________________________________

6 - 2 risdtype

risdtype 6 - 3

__________________________________________________________________________________________________________________________________________________6.

risdtype This interactive utility lets you instruct RIS to interpret the data type of a column differentlyand modify the size of a RIS_BLOB/RIS_TEXT data type.

The variety of data types in database systems permits multiple mappings of database datatypes to ANSI standard data types. When a schema is created, or a table is included in aschema, RIS chooses one interpretation of a data type. This utility lets you instruct RIS tointerpret the data type of a column differently by prompting you for the schema name,username (for secure schemas), password (if one exists), table names, column names, andnew data types.

The environment variable RIS_LANGUAGE specifies the language that RIS uses for parsingand error messages. The default is English. Consult the file c:\Program Files\CommonFiles\Intergraph\ris05.nn\config\langs for other values.

To start the risdtype utility, do one of the following:

Type risdtype in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS Data Typesicon:

6 - 4 risdtype

Choose the RIS 05.nn icon from the Program Manager; then choose the RIS Interactiveicon. Choose the Utilities... button from the RIS Interactive form; then choose the RISData Types... button from the Utilities form.


Example:

c:\risdtypeEnter schema ( to exit):sch1Enter a table or view name (or ? for a list of names):>blob_table

Pos Column Name type type-string len prec scale null- - - - -

1 c1 15 ris_blob 0 null null YES

Do you wish to modify this column? >yes

0 UNSUPPORTED1 CHARACTER2 RIS_BLOB6 RIS_TEXT

Choose a data type from those listed (enter the number) >>2Current maximum ris_blob length is:0Current maximum ris_blob length is:10000Current status for nullable is YES, nulls are allowedAre null values allowed? >>yesColumn definitions modified for object sch1.blob_table:

risdtype 6 - 5

Pos Column Name type type-string len prec scale null - - - - - 1 c1 15 ris_blob 10000 null nullYES

Is this correct? >>yes

Usage______

risdtype [-?] [-V]

Flags______




Files_____

c:\Program Files\Common Files\Intergraph\ris05.nn\bin\risdtypec:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\ris.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\net.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\utl.msg



6 - 6 risdtype

risgui 7 - 1

risgui__________________________________________________________________________________________________________________________________________________

7 - 2 risgui

risgui 7 - 3

__________________________________________________________________________________________________________________________________________________7.

risgui The risgui utility lets you interactively perform RIS queries. To start the risgui utility, doone of the following:

Type risgui in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS Interactiveicon.

7 - 4 risgui

The RIS Interactive Utility form is displayed.

7.1 Exiting the risgui Utility

To exit the risgui utility, select the Cancel button.

7.2 Performing Queries in the risgui Utility

To perform a query in the risgui utility, follow these steps:

1. Select a default schema from the Default Schema field.

2. Key an SQL statement into the Query field. You must terminate the SQLstatement with a semicolon character (;). The statement can wrap across severallines.

If you need to change the entry, select the Clear button to clear theQuery field, then enter the statement again.

3. Select the Execute button. The results appear in the Results field.

If the query results do not completely fit in the Results field, the risgui utility candisplay a screenful at a time. For more information see the section Options....Select the Continue button to display the next screenful, or the Abort button tostop the query.

risgui 7 - 5

To save the query results in a file, select the Save Results... button.

History File

When you execute a query, the risgui utility saves the SQL statement in the historyfile. To determine the name of the history file, the ris utility uses the file:

1. Specified by the RIS_HISTORY_FILE environment variable.

2. ris.his in the directory specified by the HOME environment variable, if theRIS_HISTORY_FILE environment variable is not defined.

3. ris.his in the directory from which you started the risgui utility, if the HOMEenvironment variable is not defined.

When risgui saves a query in the history file, you can go back to the same query laterand execute it again or edit the SQL statement to use it as the basis for a new query.Select the Previous or Next buttons to display the queries in the history file.

Select the Search... button to perform a search in the history file.

1. Key a search term into the Search String field.

2. Select a search direction (Up or Down).

7 - 6 risgui

3. Select the Find Next button.

The risgui utility highlights the next match.

Saving and Loading Queries

To save the current query (shown in the Query field) to a file, select the Save... button.To load a previously-saved query, select the Open... button.

To save the results of the current query, select the Save Results... button.

7.3 Options...

The Options... button modifies the behavior of query results.

1. Select the Options... button.

2. To specify the behavior for query results that do not fit in the Results field, selectone of the following:

Fetch by screenful (Append) fetch one screenful of results. When youselect the Continue button, append the next screenful to the results.

Fetch by screenful (Overwrite) fetch one screenful of results. When youselect the Continue button, discard the results and get the next screenful.

Fetch all rows fetch all results without pausing.

3. Select the OK button to accept the settings or select the Cancel button to rejectthem.

risgui 7 - 7

7.4 Utilities...

The Utilities... button lets you start the other RIS utilities from within the risguiutility.

1. Select the Utilities... button.

In Windows 95, only RIS Manager... is available.

2. Select one of the following buttons to start a utility:

RIS Manager... starts the rismgr utility.

RIS Loader... starts the rislod utility.

RIS Unloader... starts the risunlod utility.

RIS Record... starts the risrecrd utility.

RIS Playback... starts the risplbck utility.

RIS Clean Server... starts the risclnsr utility.

RIS Data Types... starts the risdtype utility.

RIS Decode... starts the risdcode utility.

7.5 Restart

While you are running the RIS Interactive utility, you can run other RIS utilities;however, if you modify the RIS parameters with the other utilities, or create or drop aschema, the RIS Interactive utility is not aware of the changes.

Select the Restart button to restart risgui and make it aware of your changes. Yourselection of modes, enabled databases, and default schema is not altered.

7 - 8 risgui

7.6 Set...

The Set... button sets RIS modes and enables the databases.

1. Select the Set... button.

2. Select the modes for the risgui utility:

ANSI Mode

Verify Mode

Autocommit

Blank Strip Mode

Autorename

Refer to the RIS SQL Users Guide for more information on the RIS modes.

3. Select the databases to enable:

Informix

Ingres

Rdb

ORACLE

DB2

SYBASE

MSSQL

risgui 7 - 9

7.7 Show...

The Show... button gives you additional information about RIS on your system.

1. Select the Show... button.

2. Select one of the following buttons:

Parameters... shows the settings in your parameters file.

Transactions... shows the schemas in transaction.

7 - 10 risgui

About... shows version and copyright information.

rislod 8 - 1

rislod__________________________________________________________________________________________________________________________________________________

8 - 2 rislod

rislod 8 - 3

__________________________________________________________________________________________________________________________________________________8.

rislod

You must understand the risunlod utility before using the rislod utility.

The rislod utility permits the transfer of schema information between external ASCIIfiles and RIS schemas by loading schema information from external files into RISschemas.

rislod:

Reads schema information from the main external file and data files (if any) andrestores them in the form of RIS schemas.

Restores only user-requested schema information into RIS schemas.

Lets information about multiple schemas be stored in the same external main file.

May create two files to report the loading status: the log file reports successfulloading and the bad file reports unsuccessful loading.

The rislod and risunlod utilities are not designed for use as backup utilities. Thefollowing are some reasons for not using rislod and risunlod as backup utilities:

If a view was created in the database (not with RIS), RIS cannot unload thedefinition of the view.

If you drop a schema and then recreate the schema, and there were existing views,RIS cannot load the definition of the view because RIS lost the definition whenyou dropped the schema.

In certain cases data types are mapped slightly differently in ORACLE databases.ORACLE uses numeric data types, and RIS uses integer, smallint, real, anddouble. If you create a column of RIS data type real, it is mapped to a float(21)ORACLE data type. If you drop the schema, then recreate the schema, RIS mapsthe float(21) in ORACLE to a RIS double data type.

For these and further reasons, you should use the databases utilities to back up datacorrectly.

The environment variable RIS_LANGUAGE specifies the language that RIS uses forparsing and error messages. The default is English. Consult the file c:\ProgramFiles\Common Files\Intergraph\ris05.nn\config\langs for other values.

8 - 4 rislod

The representation of information must comply with the format defined in

the section File Formats for risunlod and rislod.

The following figure represents the functional mechanisms of rislod and shows theinput requirements and output generated.

Data for ris_blob and ris_text columns cannot be loaded; however, you canhave ris_blob and ris_text columns in a create table statement.

To start the rislod utility, do one of the following:

Type rislod in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS Loadericon:

rislod 8 - 5

Choose the RIS 05.nn icon from the Program Manager; then choose the RISInteractive icon. Choose the Utilities... button from the RIS Interactive form; thenchoose the RIS Loader... button from the Utilities form.

If you use another utility within RIS Interactive, you must choose theRestart button before RIS Interactive is aware of any RIS parameterchanges, or creating or dropping of schemas.

Usage______

rislod [-?] [-V] [-n] [-p] [-e ][-m {w|a|e}] [-i ] [-b ] [-d ][-c ] [-s ] [-f ]

Flags______




-n Set ANSI mode off. ANSI mode is on by default. Refer to the setmode statement in the RIS SQL Users Guide for 32-Bit Applicationsfor more information.

-p Preserve blanks. By default, rislod strips trailing blanks fromcharacter data. Refer to the set mode statement in the RIS SQLUsers Guide for 32-Bit Applications for more information.

-e Enable the database specified in the . All databases areenabled by default. Refer to the set enable database statement inthe RIS SQL Users Guide for 32-Bit Applications for more information.

8 - 6 rislod

-m {w|a|e} Specify the file mode for output files. The w overwrites an existing file,

the a appends to an existing file, and the e returns an error if anoutput file with the specified name exists.

-i Specify the main input ASCII file from which RIS schema informationis loaded. The default main filename is ris.dmp.

-l Specify the log file into which RIS schema status information isrecorded. The default log filename is ris.log.

-b Specify the bad file into which rejected RIS schema information isdumped. The default bad filename is ris.bad.

-d Specify the character for delimiting column values of character typewhile loading rows in a table. A single quotation mark () is the defaultdelimiter character.

-c Specify the commit interval value that informs the loader to commitafter inserting number of rows for a table. The default value is 25.

-s Specify schema and schema-related information, such as tables,indexes, views, and grants. Alternatively, you can specify thisinformation in a specification file.

-f Specify the name of the specification file for . This optioncannot be used with the -s option.

See the section Using rislod with the Command Line Interface for more detailedinformation.

Files_____

c:\Program Files\Common Files\Intergraph\ris05.nn\bin\rislodc:\Program Files\Common Files\Intergraph\ris05.nn\parmsc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\ris.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\net.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\utl.msg



rislod loads user-requested RIS schema objects (items) from external ASCII files intoRIS schemas. rislod can:

Load schema definitions

Load table definitions

Load table data

rislod 8 - 7

Load index definitions

Load view definitions

Load privilege definitions

Load multiples of above items in a single run

Load items of one schema into any other existing schema

Load table definition only without table data

Load table data into existing table

Delete records from the table before loading table data from external file

Load table data from separate data file

Commit table data insertion after specific interval

Overwrite or append the log and bad files or return error if files exist

Enhanced features of rislod include the following:

Setting the ANSI mode on/off

The ANSI mode can be turned on or off, depending upon your requirements,before starting the loading execution.

Enabling specific databases

rislod lets you enable specific databases before starting the loading execution.

Loading of any other existing schema

rislod permits information about a particular schema to be loaded into anotherexisting schema using the rislod rename capability. You do not need to edit orcorrect the external main file to use this feature.

Returning error and/or delete table records before loading

You can specify that rislod report errors while loading data into a table, if thetable already exists. You can also specify that rislod load data into existing tablesor delete data from existing tables before loading.

Committing insertion at a specific interval

To improve execution performance, rislod commits table data insertions at specificintervals, rather than committing after each table insertion. By default, tabledata insertions are committed after 25 rows are inserted.

8 - 8 rislod

Not imposing the order of information stored in the main external file

For an index, view, or privilege definition to be loaded successfully, all itsreferences must exist. rislod does not impose a strict order on the informationstored in the main file because it often postpones the loading of an index, view, orprivilege until its references are loaded.

There are three ways to interact with rislod: using the Interactive Interface, theCommand Line Interface, or the Embedded Programming Function Interface.

1. Interactive Interface. When rislod is invoked without any command linearguments, interactive prompts display. You are prompted for required inputs asthe main external file is scanned.

See the section Using rislod with the Interactive Interface for more informationabout the meanings of these prompts and the corresponding actions taken byrislod.

2. Command Line Interface. When rislod is invoked with arguments, the rislodcommand line interface activates. This interface lets you specify, in a singlecommand, the responses to various prompts that would have been generated ifrislod had been invoked interactively. Errors encountered during parsing are notreported in the log or bad file, and rislod terminates abnormally.

See the section Using rislod with the Command Line Interface for moreinformation about the syntax for constructing a rislod command and thesemantics of the command.

3. Embedded Programming Function Interface. The RIS_loader function providesthe functionality of rislod in an embedded program when you call the function andpass the appropriate structures. Refer to the RIS Programmers Guide for moreinformation.

8.1 The Log File

When rislod begins execution, it creates a log file. The default log filename is ris.log.You can specify a different name for the log file. The log file can be opened in overwriteor append mode. If rislod cannot create a log file, execution terminates.

The log file contains a detailed summary of the execution with several sections:

Section . . . Contains . . .

Header File mode for the log and bad filesInput main external filenameLog filenameBad filenameCommit interval for loading table data

rislod 8 - 9

Schema Information Schema section, containing:

Schema nameWhether the schema loaded successfully orunsuccessfullyRenamed schema name (if selected)

Table section, containing:Table nameWhether the table was created successfully orunsuccessfullyNumber of rows loaded successfullyNumber of rows loaded unsuccessfully

Index section, containing:Table nameNumber of indexes loaded successfully for this tableNumber of indexes loaded unsuccessfully for this table

View section, containing:View nameWhether the view loaded successfully orunsuccessfully

Grants Summary For each schema loaded:Schema name and table or view nameNumber of grants loaded successfully for this table orviewNumber of grants loaded unsuccessfully for this tableor view

Miscellaneous Date and time of the runTotal elapsed time

8.2 The Bad File

As it executes, rislod creates a file called the bad file. The bad file contains all schemaitem definition statements that rislod attempted to load but could not. Thesestatements could be create schema, create table, insert, table fielddefinition, create index, create view, or grant statements. The defaultname for the bad file is ris.bad, but you can specify a different name for the file.

Statements that fail to load are dumped to the bad file with appropriate error codes anderror messages. These error codes and messages are commented so the bad file can beused again, after it is edited or corrected, to load rejected schema information.

For example, if rislod cannot load a schema statement, then all the schema informationpertaining to this schema is dumped to the bad file. Or, if the create tablestatement fails, and data are to be loaded in this table, then all table data statementssuch as create table, insert, table field definition, and data statementsare dumped to the bad file. The error messages are ignored by rislod.

8 - 10 rislod

Additionally, the status of each schema item being loaded is echoed to the screen in theinteractive and command line interfaces.

The bad file can be opened in overwrite or append mode.

8.3 Loading Index, View, and Privilege Definitions

For an index to be loaded, the table it references must exist. Similarly, for a view to besuccessfully loaded, all the tables and views it references must exist. To successfullyload a privilege definition (a grant statement), the grantee, relation, and accessprivileges referenced in the statement must also exist. To take away the burden oforganizing information into a proper order for loading, rislod postpones the loading ofthe index, view, or privilege definition until its references have been loaded.

When an index definition in a schema is fetched, rislod tries to load it. If rislod receivesan error message from RIS stating that the table on which the index is created does notexist, the index definition is stored in a temporary file. After rislod has tried to loadevery statement in the schema once, it attempts to load the indexes from the temporaryfile again. The same thing happens to a view definition that could not be loaded thefirst time because its references did not exist. rislod continuously loads these views inthe temporary file until all of them have been loaded or until no more views can beloaded successfully.

When rislod fetches a privilege definition in a schema, it is broken down into severalgrant statements, one for each grantee specified. rislod tries to load each of the newgrant statements. If RIS notifies rislod that the statement could not be loaded, thegrant statement is stored in a temporary file along with the information about theschema to which it belongs. After rislod tries to load every statement in the files atleast once, rislod tries to load the grant statements in the temporary file again. rislodcontinuously loads these grant statements until either all of them have been loaded orno more grant statements can be loaded successfully. In this approach you may noticethe breakdown of a grant statement and notice that some of the grant statements areloaded at the end of a rislod session.

8.4 Using rislod with the Interactive Interface

Invoking rislod without any command line arguments displays interactive prompts.

Accepting Default Values. Most prompts have default values indicated in squarebrackets ([]). Press the ENTER key to select these default values.

Selecting Nondefault Values. To select a nondefault value choose the character inparentheses corresponding to the option you want. Key in that character andpress ENTER.

Specifying Other Information. Some prompts ask you to enter information, such asfilenames. Key in the information requested and press ENTER.

rislod 8 - 11

The following list discusses the interactive prompts in detail.

1. Set mode ansi ON(y/n) :[y] >

The default is set ANSI mode on. See the RIS SQL Users Guide for 32-BitApplications for more information.

Do one of the following:

Press ENTER to accept the default.

Select n to turn off ANSI mode.

2. Preserve blanks? (y/n) :[n] >

This prompt lets you set the blankstrip mode. By default rislod strips trailingblanks from character data.


Press ENTER to accept the default if you do not want to preserve trailingblanks.

Select y if you want to preserve trailing blanks.

3. Set mode enable databases?all(a) specific(s) :[a] >

This prompt lets you enable databases during the loading of a schema.


Press ENTER to enable all RIS-supported databases.

Select s and rislod prompts you for a database type:

Enter DBMS type (ex. informix) :[return] >

Enter the RIS-supported database type, such as informix, ingres, ororacle. This prompt repeats until you press ENTER without entering adatabase name.

4. File mode of all output files? overwrite(w) append(a) error out if exists(e) :[e] >

This prompt lets you set the file mode for log and bad files. The file mode affectsthe log and bad files only. The default is e, error out mode.


Press ENTER to accept the default; when you are prompted for the log andbad filenames, rislod prompts you to quit if the files you specify alreadyexist.

8 - 12 rislod

Select w to overwrite the existing log and bad files.

Select a to append to the existing log and bad files.

5. Main file for loading :[ris.dmp] >

This prompt lets you specify the name of the main file for loading. The defaultname for the main file is ris.dmp.


Press ENTER to accept the default filename.

Enter another filename for the main file.

6. Log file :[ris.log] >

This prompt lets you specify the name of the log file for loading. The default namefor the log file is ris.log.



Enter another filename for the log file.

If you selected e for error out mode at the prompt File mode of all output files?,and a file with the name you specify exists, the message Log File already exists isdisplayed. You are prompted:

Quit risload? (y/n):[n] >


Press ENTER to accept the default. You are again prompted to enter aname for the log file; key in a new filename.

Select y to quit rislod.

7. Bad file :[ris.bad] >

This prompt lets you specify the name of the bad file for loading. The defaultname for the bad file is ris.bad.



Enter another filename for the bad file.

rislod 8 - 13

If you selected e for error out mode at the prompt File mode of all output files?,and a file with the name you specify exists, the message Bad File already exists isdisplayed. You are prompted:

Quit risload? (y/n):[n] >


Press ENTER to accept the default. You are again prompted to enter aname for the bad file; key in a new filename.

Select y to quit rislod.

8. Enter delimitation used in the files for loading: [] >

This prompt lets you specify the delimiter to use for enclosing character values ofvariable lengths to use in the main and data files.

You cannot use the space character as a delimiter.

The files generated by risunlod use single quotation marks () fordelimitation. This feature of rislod lets you use files not prepared byrisunlod for loading as long as the other parts of the files complywith the file format used by rislod.



Enter another delimitation character.

9. Enter commit interval :[25] >

The commit interval lets you commit the insertion of rows in a table after thespecified commit interval value. The default is 25 (commit after inserting 25 rowsin a table).



Enter another commit interval.

10. Which schemas should be loaded?all(a)prompted - optionally transfer into existing schema(p) :[a] >

This prompt lets you choose between loading all the schemas or only selectedschemas from the main file. The default is a for all schemas.

8 - 14 rislod


Press ENTER to load all the schemas from the main file.

Prompts let you choose how to load tables, indexes, views, and privilegedefinitions. These prompts appear once, after the prompt for the schema, ifyou choose to load all the schemas in the main file.

Select p and rislod generates a list of schemas and prompts you beforeloading each schema. (After each schema is selected, you are prompted forhow to load tables, indexes, views, and privilege definitions for that schema.)

Load schema (y/n) :[y] >


Select y to load the specified schema. If you select p at the prompt Whichschemas should be loaded? and you select y at this prompt, you areprompted to optionally load into another existing schema:

To Transfer s items into another existing schema...Enter an existing schema name :[]


Press ENTER if you do not want to use another existing schema;rislod loads the schema into the schema name specified in the mainfile.

Enter the name of an existing schema. rislod then prompts for theusername, user password, and schema password, if necessary, for thespecified schema.

Select n if you do not want to load the specified schema.

rislod lets you rename schemas only if the prompted (p) selection wasmade at the Which schemas should be loaded? prompt.

If the schema is a secure schema, you are prompted for the databaseusername, the database username password, the operating systemusername, and the operating system username password. If theschema has a password, you are prompted for the schema password.

Passwords are not echoed to the screen.

11. Which tables should be loaded?all(a) prompted(p) none(n) :[a] >


rislod 8 - 15

Press ENTER to accept the default and load all the tables in the schema.

Select p if you want to be prompted for each table.

Select n if you do not want to load any tables.

If you select a or p at the prompt Which tables should be loaded? the followingprompt appears next:

Both definitions and data(b) definitions only(o):[b] >

This prompt lets you decide whether to load both the definitions and data of thetables in the schema or load only the definitions.


Press ENTER to accept the default and load both table definitions and data.

Select o to load table definitions only.

rislod loads either fixed or variable formatted table data.

If only the definitions exist for some or all of the tables in aschema, choosing to load both definitions and data does notcause any problem to rislod. These tables are created withoutdata in them. Similarly, if both the definitions and data existfor some or all of the tables in a schema, choosing the secondselection does not cause problems. These table data arediscarded and the string only definitions is placed in the log file.

Select n if you do not want to load any tables.

If you select b at the prompt Both definitions and data(b) definitions only(o) thefollowing prompt appears:

Continue loading into a table even though that tableexists (y/n):[n] >

When loading a table definition of a table that already exists, an errormessage is generated stating that a table/view with this name alreadyexists. Whether or not the data is loaded into the existing table depends onthe answer to this prompt.


Press ENTER to accept the default and data are not loaded into anexisting table.

Select y to load data into an existing table.

8 - 16 rislod

If y is selected for the previous prompt, the following prompt is displayed:

Clear existing data from table before loading(y/n) :[n] >


Press ENTER to accept the default and keep existing data.

Select y to delete all rows from this table before loading data from themain file.

12. Which index definitions should be loaded?all(a) prompted(p) none(n): [a] >


Press ENTER to accept the default and load all index definitions.

Select p and rislod generates a list of indexes and prompts for each indexdefinition:

Load definition (y/n):[y] >


Press ENTER to load the specified definition.

Select n if you do not want to load the index definition.

Select n and no index definitions are loaded.

13. Which views should be loaded?all(a) prompted(p) none(n):[a] >


Press ENTER to accept the default and load all views.

Select p and rislod prompts for each view:

Load view (y/n):[y]:


Press ENTER to load the specified view.

Select n and the specified view is not loaded.

Select n and no views are loaded.

rislod 8 - 17

14. Which privilege definitions should be loaded?

all(a) prompted(p) none(n):[a] >


Press ENTER to accept the default and load all privilege definitions.

Select p and rislod prompts for each table or view on which one or moreprivileges are defined:

Load access privilege on (y/n):[y]


Press ENTER to load the specified privilege definition.

Select n if you do not want to load the privilege definition.

Select n and no privilege definitions are loaded.

If you selected p at the prompt Which table should be loaded? the following promptis displayed.

Load table (y/n):[y]


Press ENTER to accept the default and load the specified table.

Select n and the specified table is not loaded.

When all the necessary information has been specified, rislod processes the schema(s)selected.

8.5 Using rislod with the Command Line Interface

The command line can be used to specify which schemas in the main file should beloaded. It can also be used to specify which information in the schemas should beloaded. The syntax for constructing a rislod command is almost the same as the syntaxfor constructing a risunlod command, except for a few additions and changes.

Examples

rislod -i \dir1\dir2\mainfile -d\" -l load.log -b load.bad-f ..\dir3\specfile -n -mw -e rdb informix -c 15

Option Specifies

8 - 18 rislod

-i Main filename. The default is ris.dmp.

-d Delimiter. The default is a single quotation mark (). The delimiter in thisexample is a double quotation mark. The backslash before the delimitercauses the shell not to interpret the double quotation mark.

-l Log filename. The default is ris.log.

-b Bad filename. The default is ris.bad.The delimiter in this example is adouble quotation mark. The back slash before the delimiter causes the shellnot to interpret the double quotation mark.

Additional options not used in the example are:

Option Specifies

-n ANSI mode off.

-e Enable databases listed after this option.

-m Set the file mode (w, a, or e) for the output files (such as log and bad files).

-c Commit interval.

rislod -s sch1.create_sch_passwd1.user_passwd1 all-s sch2 .create_sch_passwd2 .user_passwd2 new table with data all

-s sch3 clear table with data t1 t2 grant all

-s sch4 rename sch5 .sch5pass table t1 index t2 view v1grant t2 v2 sch.t3 sch.v3

rislod lets you specify up to three passwords after a schema name (schema password,osuser password, and user password). Passwords are necessary if they are not alreadystored in the main file. For schema sch2, data is loaded only into newly created tables.For schema sch3, data is loaded into tables t1 and t2 after deleting previously insertedrows even if it already exists before loading. For schema sch4 all the following itemsare loaded into existing schema sch5. No data is loaded into table t1, but indexdefinitions on table t1 and privilege definitions on table t1 and view view1 are loaded.

The specification file format is the same for both rislod and risunlod.

8.6 BNF Representation of rislod Command Line Syntax

Backus Naur form (BNF) is a method of describing the syntax of a language. It is usedhere to show the capabilities of the RIS command line interface.

The following is the BNF representation of the syntax for constructing a command line.

rislod 8 - 19

::= rislod

[-n][-e ][-m ][-i ][-b

8 - 20 rislod

The following is the BNF representation of the format for a specification file.

::= { [.] [.]}[;...]

rismgr 9 - 1

rismgr__________________________________________________________________________________________________________________________________________________

9 - 2 rismgr

rismgr 9 - 3

__________________________________________________________________________________________________________________________________________________9.

rismgr This utility creates, changes, and drops RIS schemas. You can also use it to displayinformation about existing schemas.

To start the rismgr utility, do one of the following:

Type rismgr in a Command Prompt window.

Choose the RIS 05.nn icon from Program Manager; then choose the RIS SchemaManager icon:

9 - 4 rismgr

Choose the RIS 05.nn icon from the Program Manager; then choose the RISInteractive icon. Choose the Utilities... button from the RIS Interactive form; thenchoose the RIS Manager... button from the Utilities form.

If you use another utility within RIS Interactive, you must choose theRestart button before RIS Interactive is aware of any RIS parameterchanges, or creating or dropping of schemas.

Usage______

rismgr

Files_____

c:\Program Files\Common Files\Intergraph\ris05.nn\bin\rismgrc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\forms\v5forms\*c:\Program Files\Common Files\Intergraph\ris05.nn\parmsc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\ris.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\net.msgc:\Program Files\Common Files\Intergraph\ris05.nn\config\english\messages\utl.msg



rismgr 9 - 5

__________________________________________________________________________________________________________________________________________________9.1

RIS Schema Manager The RIS Schema Manager dialog box displays a three-column list showing all theschemas known to RIS, each schema type (standard or secure), and whether theschemas associated dictionary is owned or shared. Buttons corresponding to theactions of the Schema Manager are also on the dialog box. When you choose a button,you initiate that particular action, and the associated subordinate dialog box isdisplayed. When you choose one of the schemas from the list on the RIS SchemaManager dialog box, information about that schema is displayed on the subordinatedialog box.

Operating Sequence

1. Activate the RIS Schema Manager.

The RIS Schema Manager dialog box appears.

9 - 6 rismgr

2. Choose the button from the RIS Schema Manager dialog box for the function

you want to use. The RIS Schema Manager functions are described briefly in thefollowing list. See the section listed for a complete description.

Button Name Function

Schema Definition Provides additional functions and dialog boxes fordefining schemas. See the section Schema Definition.

Data Definition Provides additional functions and dialog boxes thatmanipulate tables, views, and indexes. See the sectionDisplaying Table, View, and Index Information.

Schema File Lets you review and manipulate schema files. See thesection Reviewing and Manipulating Schema Files.

Locate Client Lets you review and specify the location of a RIS clientprocess. See the section Locating RIS Client Processes.

Set Lets you set ANSI, autocommit, autorename, blankstrip,and verify modes on or off and enable differentdatabases. See the section Setting Modes and EnablingDatabases.

3. Do one of the following:

Choose the Reset button to erase the subordinate dialog boxes.

The RIS Schema Manager rereads the RIS schemas file.

Choose the Close button to end the RIS Schema Manager session.

Choose the Help button to obtain RIS Schema Manager help.

rismgr 9 - 7

__________________________________________________________________________________________________________________________________________________9.2

Schema Definition The Schema Definition dialog box lets you initiate functions to display schemainformation, create and drop schemas, access secure schemas and dictionaries, andmodify schema passwords, node information, and DB2 passwords.

Operating Sequence

1. Choose the Schema Definition button from the RIS Schema Manager dialogbox.

The Schema Definition dialog box appears.

The dialog box has eight buttons, each letting you initiate a particular function.


Choose the button from the Schema Definition dialog box for the functionyou want to use. The Schema Definition functions are described briefly inthe following list. See the section listed for a complete description.

Button Name Function

Schema Information Displays information about a specified schema.See the section Displaying Schema Information.

Create Schema Creates schemas. See the section CreatingSchemas.

Drop Schema Drops schemas. See the section DroppingSchemas.

9 - 8 rismgr

Secure Schema Access Grants and revokes access to a secure schema.

See the section Granting/Revoking AccessPrivileges to Secure Schemas.

Dictionary Access Grants and revokes dictionary access to aschema. See the section Obtaining DictionaryAccess.

Modify Schema Password Modifies the schema password. See the sectionModifying Schema Passwords.

Modify Node Information Modifies node information. See the sectionModifying Node Information.

Modify DB2 Password Modifies the DB2 password. See the sectionModify DB2 Password Form.

Choose the Reset button to dismiss the subordinate dialog boxes.

Choose the Close button to dismiss the Schema Definition dialog box.

Choose the Help button to obtain RIS Schema Definition help.

rismgr 9 - 9

__________________________________________________________________________________________________________________________________________________9.2.1

Displaying Schema Information The Schema Information dialog box displays information about a specified schema.You can key in a schema name or select a name from the Schema Name list on the RISSchema Manager dialog box.

Operating Sequence

1. Choose the Schema Information button from the Schema Definition dialogbox.

The Schema Information dialog box appears and displays information about theselected schema (if one has been selected from the RIS Schema Manager dialogbox).

2. Do one of the following if the schema you want is not already the selected schema:

In the Schema Name box, type a schema name.

Select a schema from the Schema Name list on the RIS Schema Managerdialog box.

The schema information is displayed.

The following information is displayed:

Schema Name Displays the schema name.

9 - 10 rismgr

Schema Type Displays whether the schema is a standard or secureschema.

Network Protocol Displays the type of network protocol being used tocommunicate with the RIS data server.

Nodename or Address Displays a nodename, an Ethernet address(specified in the [lan.]address) dialog box, an Internet address, or an addressappropriate for the protocol of the machine where the RIS data server islocated.

Database Username Displays the database username.

OS Type Displays the operating system type on which the server isrunning (for example, UNIX or Windows NT).

Dictionary Owner Displays the user who owns the dictionary.

Database Type Displays the database type (for example, INFORMIX, orORACLE).

3. To dismiss the Schema Information dialog box, click Close.

rismgr 9 - 11

__________________________________________________________________________________________________________________________________________________9.2.2

Creating Schemas The Create Schema dialog box creates new RIS schemas and corresponds directly tothe RIS create schema statement. The database-specific information on the CreateSchema dialog box can be entered in three ways:

By entering the information directly in the boxes. If the schema is being createdon a database unknown to RIS, this is the only alternative.

By selecting an existing schema from the RIS Schema Manager dialog box. Thedatabase-specific information about that schema is entered into the CreateSchema dialog box. This method is particularly convenient when creatingadditional schemas on a database.

By selecting the Display Databases button. A dialog box listing all the knownRIS databases appears. Selecting one of these databases enters information aboutthat database into the Create Schema dialog box.

Operating Sequence

1. Select the Create Schema button from the Schema Definition dialog box.

The Create Schema dialog box appears.

9 - 12 rismgr

The Create Schema dialog box has two areas:

The DBMS-independent area

The DBMS-dependent area

2. Enter the appropriate values for the DBMS-independent section of the dialog box.The following list explains the DBMS-independent controls.

Schema Name Type a name for the schema you want to create.

(Schema Name) Password Enter a password for the schema. The NoEcho/Echo button causes the password to not display (No Echo) or display(Echo) when it is entered.

Schema Type Click this button to toggle between Standard and Secureschemas.

Network Protocol Select the type of network protocol to use tocommunicate with the RIS data server. Only the top (#1) protocol is used inthe create schema statement. When you select a protocol, it moves to thebottom (#4). ISO, XNS and DECNET are not currently supported.

To change the order of the Network Protocol boxes, select one NetworkProtocol box and its value is replaced with the value of the Network Protocolbox below it. The value that was originally selected is moved to the bottomof the list.

Nodename or Address Specify a nodename, an Internet address, or anaddress appropriate for the protocol of the machine where the RIS dataserver is located. Enter a value or click the Get Client Address button.

Get Client Address Click this button to enter the addresses of the clientmachine in the Nodename or Address boxes. This is useful when the RISclient and the RIS data server are on the same machine.

Database Username Type the database username.

(Database Username) Password Type a password for the databaseusername. The No Echo/Echo button causes the password to not display (NoEcho) or display (Echo) when it is entered.

Include Database Users Tables/Views Click this button to toggle betweenYes to include the database users tables and views, or No not to include thedatabase users tables and views.

OS Type From the list, select the operating system type on which the RISdata server is running.

Use Existing Dictionary Click this button to toggle between No (thedefault) and Yes. You must already have permission from the dictionaryowner to use an existing dictionary.

rismgr 9 - 13

Dictionary Owner Type a user who owns a dictionary in the particulardatabase.


Select a database type from the Database Type list. If the selecteddatabase type requires additional information, boxes to enter thatinformation are displayed when you select the database type.

The supported RDBMSs are:

INFORMIX

ORACLE

DB2

SYBASE

MSSQL

The DBMS-dependent controls for each database type areexplained in separate subsections following this section.

To display databases known to RIS, select the Display Databases button.

9 - 14 rismgr

The Databases dialog box appears. Databases known to RIS are listed onthis dialog box. Select a database from the dialog box. Controls containinginformation specific to the database selected are shown on the CreateSchema dialog box.

4. See the section specific to the type of database on which you are creating theschema for instructions on filling in the DBMS-dependent boxes.

For more information, see these sections:

Creating Schemas (INFORMIX)Creating Schemas (ORACLE)Creating Schemas (DB2)Creating Schemas (SYBASE)Creating Schemas (Microsoft SQL Server)

rismgr 9 - 15

__________________________________________________________________________________________________________________________________________________9.2.2.1

Creating Schemas (INFORMIX) When you select the INFORMIX DBMS from the Database Type list on the CreateSchema dialog box, the INFORMIX-dependent controls appear on the dialog box.

Operating Sequence

1. Enter the appropriate values for the INFORMIX-dependent controls. Thefollowing list explains these controls.

Database Name Specifies the INFORMIX database name accessible to theschema.

If the RISINFDS data server or RISINFNS net server is on a UNIX node:

For the INFORMIX Standard Engine product, the must be a fullpathname (for example, /usr2/informix/dbnam1). On UNIX systems, thefilename portion cannot be longer than ten characters because INFORMIXadds a DBS suffix to it.

For the INFORMIX OnLine Engine product, the needs only to bethe database name.

If the RISINFDS data server or RISINFNS net server is on a Windows NTnode:

For the INFORMIX Standard Engine product, the must be a fullpathname and must include the INFORMIX server name with the @separator:

9 - 16 rismgr

For the INFORMIX OnLine Engine product, the must include onlythe INFORMIX server name with the @ separator:

Database Management System Location Enter the path where theINFORMIX RDBMS software is installed.

SQLEXEC Specifies whether INFORMIX OnLine or INFORMIXStandard Engine is being used. Enter this information if both the StandardEngine and Online exist on the machine; otherwise, INFORMIX defaults toOnline. For the INFORMIX Database Management System located in$INFORMIXDIR:

If using INFORMIX OnLine Engine, enter $INFORMIXDIR/lib/sqlturbo

If using the INFORMIX Standard Engine, enter$INFORMIXDIR/lib/sqlexec

For the INFORMIX Database Management System located inc:\win32app\informix on a Windows NT node:

If using INFORMIX OnLine Engine, enter,c:\win32app\informix\bin\sqlturbo.exe

If using the INFORMIX Standard Engine, enter,c:\win32app\informix\bin\sqlexec.exe

This parameter is not used when the RIS Data server resideson a Windows NT node. If the RIS data server resides on aWindows NT node this information is obtained from theregistry.

DBTEMP Enter the path where INFORMIX will create temporary files.

TBCONFIG Enter the path of the TBCONFIG file used by INFORMIXOnLine. This file permits INFORMIX OnLine to be configured so that alarge number of tables can be used with joins. Also, table structures andlimits can be varied with this file. Refer to your INFORMIX documentationfor more information on the TBCONFIG file.

2. When complete, do one of the following:

To create the schema, click the Apply button.

To clear the dialog box, click the Reset button.

To drop previously created RIS dictionary objects (such as RIS tables, views,indexes, and schema privileges) before creating the new schema, click theForce button.

To dismiss the dialog box without creating a schema, click the Close button.

rismgr 9 - 17

__________________________________________________________________________________________________________________________________________________9.2.2.2

Creating Schemas (ORACLE) When you select the ORACLE DBMS from the Database Type list on the CreateSchema dialog box, the ORACLE-dependent controls appear on the dialog box.

Operating Sequence

1. Enter the appropriate values for the ORACLE-dependent controls. The followinglist explains these controls.

Database Name Enter the system identifier (SID) of the ORACLEdatabase. The SID should be in the correct format for ORACLE.

Database Management System Location Enter the ORACLE home path(where ORACLE is installed).

OS Username Enter a valid operating system log-in name on the servermachine.

Password Enter the operating system log-in password, if any.

For a given ORACLE SID, all schemas created using that SIDmust have the same operating system username and passwordcombination.

9 - 18 rismgr



To clear the form, click the Reset button.


To dismiss the form without creating a schema, click the Close button.

rismgr 9 - 19

__________________________________________________________________________________________________________________________________________________9.2.2.3

Creating Schemas (DB2) When you select the DB2 DBMS from the Database Type list on the Create Schemadialog box, the DB2-dependent controls appear on the dialog box.

Operating Sequence

1. Enter the appropriate values for the DB2-dependent controls. The following listexplains these controls.

Database Name Enter a DB2 database name accessible by the schema.The name is case sensitive and must have from one to eight alphanumericcharacters.

Group Name Enter the RACF group name for TCPIP protocol. The RACFgroup name is passed to the RIS Transaction Processor security exit on theIBM mainframe system for use during sign-on processing. (Optional.)


Password Enter the operating system log-in password, if any. The NoEcho/Echo button causes the password to not display (No Echo) or display(Echo) when it is entered.

For LU6.2 protocol, the Group Name box is ignored in thisversion of RIS.

TCP/IP is not supported.

9 - 20 rismgr

IBM Network Protocol From the list, select the network protocol that RISuses to access the IBM machine on which the DBMS resides. The protocol isLU6.2.

The following controls are valid for LU6.2 network protocol only:

RIS LU Name Enter the SSI local LU name, either fully qualified orlocal. This name is case sensitive.

Host LU Name Enter the SSI remote LU name, either fully qualifiedor local. This name is case sensitive.

LU62 Mode Name Enter the name the Intergraph SystemAdministrator assigned to the node that permits communication to theRIS program on an IBM machine. The mode assigns attributes to theconnection and must be predefined by the Intergraph SystemAdministrator. The mode name is defined when LU6.2 is configured.This name is case sensitive.

rismgr 9 - 21

Host Program Name Enter the name the IBM System Administrator

assigned the RIS server when it was installed on the IBM machine. Alsoenter the CES transaction name. This name is case sensitive.

2. When complete, do one of the following:





9 - 22 rismgr

__________________________________________________________________________________________________________________________________________________9.2.2.4

Creating Schemas (SYBASE) When you select the SYBASE DBMS from the Database Type list on the CreateSchema dialog box, the SYBASE-dependent controls appear on the dialog box. Youmust be granted create procedure privileges before you can create shared schemas.

Operating Sequence

1. Enter the appropriate values for the SYBASE-dependent controls. The followinglist explains these controls.

Database Name Enter the name of the database the schema accesses.

Database Management System Location Enter the path where SYBASE isinstalled. See the README.TXT file delivered with the RISSYBDS productfor more information. This information is not required for all servers.


Password Enter the operating system log-in password, if any. The NoEchoEcho button causes the password not to display (No Echo) or to display(Echo) when it is clicked.

DSQUERY Enter the database query listener. This value is the aliasgiven in the interfaces file. The default name is SYBASE. This informationis not required for all servers.

rismgr 9 - 23

IFILE Enter the name of the interfaces file for the schema. By default,RIS uses the SYBASE interfaces file named interfaces. On 32-bit operatingsystems the ifile is named sql.ini. This information is not required for allservers.






9 - 24 rismgr

__________________________________________________________________________________________________________________________________________________9.2.2.5

Creating Schemas (Microsoft SQL Server) When you select the SQL Server DBMS from the Database Type list on the CreateSchema dialog box, the SQL Server-dependent controls appear on the dialog box.

Operating Sequence

1. Enter the appropriate values for the Microsoft SQL Server-dependent controls.The following list explains these controls.

Database Name Enter the name of the database the schema accesses.

Database Management System Location Enter the path where SQLServer is installed. See the README.TXT file delivered with theRISMSFDS product for more information. This information is not requiredfor all servers.


Password Enter the operating system log-in password, if any. THe NoEcho/Echo button causes the password not to display (No Echo) or to display(Echo) when it is clicked.

DSQUERY Currently this field is not used.

IFILE Enter the name of the interfaces file for the schema. By default,RIS uses the SQL Server interfaces file named interfaces. This informationis not required for all servers.

rismgr 9 - 25


To create the schema, cli

risutil

Documents