9iclient-insadmin-92040-134471

8/7/2019 9iclient-insadmin-92040-134471

1/44

Oracle9iClient

Installation and Administration Guide Release 2 (9.2.0.4.0) forStratus Contiuum 600 and 1200 Series

December 2003


2/44

Oracle9i Client Installation and Configuration Guid e, Release 2 (9.2.0.4.0) for Stratus Contiuu m 600 and 1200

Series

Copyright 2001, 2003, Oracle. All rights reserved.

Contribu ting Au thors: Caroline Johnston , Sharad Lal, Tom Ma llory, Binoy Suku mara n

The Programs (which include both the software and documentation) contain proprietary information; they

are provid ed u nd er a license agreement containing restrictions on use and d isclosure and are also protectedby copyright, paten t, and other intellectual and ind ustrial prop erty laws. Reverse engineering, disassembly,or decomp ilation of the Program s, except to the extent requ ired to obtain interoperability with otherindep enden tly created software or as specified by law, is prohibited.

The information contained in this docu ment is subject to change withou t notice. If you find an y problem s inthe documentation, please report them to us in writing. This document is not warranted to be error-free.Except as may be expressly perm itted in your license agreement for these Programs, no part of these

Program s may be reprodu ced or transmitted in any form or by any m eans, electronic or mechanical, for anypurpose.

If the Program s are delivered to the United States Governm ent or anyon e licensing or using th e Programs onbehalf of the United States Governm ent, the following notice is app licable:

U.S. GOVERNMENT RIGHTS Program s, software, databa ses, and related do cumen tation and technical datadelivered to U.S. Governm ent custom ers are "comm ercial compu ter software" or "comm ercial technical data"pu rsuan t to the applicable Federal Acquisition Regulation an d agency-specific supplem ental regulations. As

such, use, dup lication, disclosure, modification, and ad aptation of the Program s, includin g docum entation

and technical data, shall be subject to the licensing restrictions set forth in the app licable Oracle licenseagreemen t, and, to the extent ap plicable, the ad ditional righ ts set forth in FAR 52.227-19, Comm ercialComp uter Software--Restricted Rights (June 1987). Oracle Corp oration, 500 Oracle Parkw ay, Redw ood City,

CA 94065

The Programs are n ot intend ed for u se in any nu clear, aviation, mass transit, medical, or other inherently

dan gerous ap plications. It shall be the licensee's responsibility to take all ap prop riate fail-safe, backup,redu nda ncy and oth er measures to ensure the safe use of such app lications if the Program s are used for suchpurposes, and we disclaim liability for any damages caused by such use of the Programs.

Oracle is a registered tradem ark of Oracle Corporation and / or its affiliates. Other nam es may be trademar ksof their respective owners.

The Programs m ay prov ide links to Web sites and access to content, prod ucts, and services from th irdparties. Oracle is not responsible for the availability of, or any conten t prov ided on, third-p arty Web sites.You bear all risks associated w ith the u se of such content. If you choose to pu rchase any p rodu cts or services

from a third par ty, the relationship is directly between you an d th e third p arty. Oracle is not respon sible for:(a) the quality of third-party p rodu cts or services; or (b) fulfilling any of the term s of the agreement w ith thethird party, including delivery of products or services and warranty obligations related to purchased

prod ucts or services. Oracle is not responsible for any loss or d ama ge of any sort that you may incu r fromdealing with any third party.


3/44

iii

Contents

Send Us Your Comments ....................................................................................................................... vii

Preface ................................................................................................................................................................. ix

1 Pre-Installation Requirements

Hardware Requirements ......................................................................................................................... 1-1Disk Space Requirements ....................................................................................................................... 1-2

Operating S ystem Requirements .......................................................................................................... 1-2

Product-Specific Requirements ............................................................................................................. 1-2

Precom pilers and Tools ..................................................................................................................... 1-2

Netw ork and System Man agem ent Prod ucts ................................................................................ 1-3

Character Sets ............................................................................................................................................ 1-3

Oracle9i NCH AR Datatyp es ............................................................................................................ 1-3

AL24UTFFSS Character Set ............................................................................................................. 1-3

2 Installation

Installation Instructions .......................................................................................................................... 2-1

Addition al Information ........................................................................................................................... 2-2

Relink ing Infor mation ....................................................................................................................... 2-2

3 Post-Installation

Configuration Tasks to Perform as the root User............................................................................... 3-1

Configuration Tasks to Perform as the oracle User ........................................................................... 3-2

Additional Oracle Product Installation and Configuration ............................................................. 3-3

Con figuring Oracle Precom pilers .................................................................................................... 3-3

4 Administering SQL*PlusAdmin istering Command-Line SQL*Plus .......................................................................................... 4-1

Usin g Setup Files ................................................................................................................................ 4-1

Usin g the Site Profile File........................................................................................................... 4-1

Usin g the User Profile File ......................................................................................................... 4-1

Usin g the PRODUCT_USER_PROFILE Table ............................................................................... 4-2

Usin g EMP and DEPT Tables ........................................................................................................... 4-2

Creatin g Dem onstration Tables Man ually .............................................................................. 4-2


4/44

iv

Delet ing Dem onstration Tables ................................................................................................ 4-2

SQL*Plu s Command-Line H elp ....................................................................................................... 4-3

Installing the SQL*Plus Command-Line Help............................................................................... 4-3

Removin g the SQL*Plu s Com mand-Line Help ............................................................................. 4-3

Using Command-Line SQL*Plus .......................................................................................................... 4-4

Usin g a System Editor from SQL*Plu s............................................................................................ 4-4

Running Op erating System Com mand s from SQL*Plus ............................................................. 4-4Interrupting SQL*Plu s ....................................................................................................................... 4-5

Usin g the SPOOL Com mand ............................................................................................................ 4-5

SQL*Plus Restriction s ............................................................................................................................. 4-5

Resizing Window s ............................................................................................................................. 4-5

Retu rn Cod es ...................................................................................................................................... 4-5

Hiding Your Passw ord ...................................................................................................................... 4-5

5 Using Oracle Precompilers and the Oracle Call Interface

Overview of Oracle Precompilers ......................................................................................................... 5-1

Precom piler Files ................................................................................................................................ 5-1

Precom piler README Files ............................................................................................................. 5-2

Issues Com mon to All Precom pilers ............................................................................................... 5-2

Up percase to Lowercase Con ver sion ....................................................................................... 5-2

Vend or Debugger Progr am s ..................................................................................................... 5-2

Value of IRECLEN and ORECLEN .......................................................................................... 5-2

Static Linkin g ...................................................................................................................................... 5-2

Pro*C Precompiler.................................................................................................................................... 5-2

Known Issue with Pro*C ................................................................................................................... 5-2

Pro*C Demonstration Prog ram s ...................................................................................................... 5-3

Pro*C User Program .......................................................................................................................... 5-3

Pro*COBOL Precompilers ...................................................................................................................... 5-4Known Issue with Pro*COBOL........................................................................................................ 5-4

Oracle Call Interface ............................................................................................................................... 5-5

OCI Demonstration Programs.......................................................................................................... 5-5

OCI User Program s ............................................................................................................................ 5-5

Custom Make Files ................................................................................................................................... 5-5

Using Signal Handlers ............................................................................................................................ 5-6

6 Configuring Oracle Net Services

Location of Oracle Net Services Configuration Files ........................................................................ 6-1

Oracle Protocol Su pport .......................................................................................................................... 6-2

TCP/ IP Protocol Sup port .................................................................................................................. 6-2

A Oracle9iComponents

Oracle9i Client Components ................................................................................................................. A-1

Runtime Edition ................................................................................................................................ A-1

Ad minist rator Edition ...................................................................................................................... A-1


5/44

v

Product Descriptions .............................................................................................................................. A-1

Index


6/44

vi


7/44

vii

Send Us Your Comments

Oracle9iClient Installation and Configuration Guide, Release 2 (9.2.0.4.0) for Stra-tus Contiuum 600 and 1200 Series

Oracle welcomes your comments and suggestions on the quality and usefulness of this

pu blication. Your inp ut is an imp ortant p art of the information u sed for revision.

Did you find any errors?

Is the informa tion clearly presented ?

Do you n eed m ore inform ation? If so, where?

Are the examples correct? Do you need m ore examples?

What features did you like most about this manu al?

If you find an y errors or have any oth er suggestions for imp rovemen t, please ind icate

the title and part n um ber of the documentation and th e chapter, section, and page

nu mber (if available). You can send commen ts to us in the following w ays:

Postal service:

Oracle Corporation

Oracle9i Documentation

500 Oracle Parkway

Redw ood Shores, CA 94065

USA

If you w ould like a reply, please give your n ame, add ress, telephone num ber, and

electronic mail ad d ress (optional).

If you h ave prob lems with th e software, please contact you r local Oracle Sup port

Services.


8/44

viii


9/44

ix

Preface

This guide and th e Oracle9i Administrators Reference Release 2 (9.2.0.1.0) for UNIX

Systems prov ide instructions for installing and configuring O racle9i Client release 2

(9.2.0.4.0) on Stratus Continu um systems.

AudienceThis documen t is intend ed for anyone responsible for installing Or acle9i Client release

2 (9.2.0.4.0) on UNIX systems.

Documentation AccessibilityOur goal is to make Oracle produ cts, services, and supp orting documentation

accessible, with good usab ility, to the d isabled commu nity. To that end, ou r

docum entation includes features that m ake information available to users of assistive

technology. This docum entation is available in HTML forma t, and contains m arku p to

facilitate access by the d isabled comm un ity. Stand ards will continu e to evolve over

time, and Oracle is actively engaged with other market-leading technology vendors to

add ress techn ical obstacles so that ou r d ocumen tation can be accessible to all of our

customers. For ad ditional inform ation, visit the Oracle Accessibility Program Web siteat

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation JAWS, a Windows screen reader,

may n ot always correctly read the code examp les in this docum ent. The conven tions

for w riting code requ ire that closing braces should app ear on an otherwise empty line;

how ever, JAWS may not a lways read a line of text that consists solely of a bracket or

brace.

Accessibility of Links to External Web Sites in Documentation This docum entation

may contain links to Web sites of other comp anies or organizations that Oracle does

not own or control. Oracle neither evaluates nor makes any representations regardingthe accessibility of these Web sites.

Typographic ConventionsThe following typographic conventions are used in this guide:


10/44

x

Command SyntaxUNIX command syntax appears in monospace font and assumes the use of theBour ne shell. The "$" character at the beginning of UNIX command examples is thedefault UNIX command promp t. Do not enter it as part of the command .

Related DocumentationIf you are unfamiliar with the concepts or terminology associated with relational

database man agement systems, then refer to Oracle9i Database Concepts before

beginning your installation. Use the Installation Checklist in Append ix C to ensure

that you have the required information and that you have completed th e necessary

pre-installation steps for a su ccessful installation.

Information on system ad ministration and tuning for a p roduction database system is

provided in these documents:

Oracle9i Database Administrators Guide

Oracle9i Net Services Administrators Guide

Oracle9i Database Performance Guide and Reference

Information on up grading from a previous version of the Oracle Server is provided in

Oracle9i Database Migration.

Information on installing Or acle Workflow is provided in th e Oracle Workflow Server

Installation Notes an d Oracle Workflow Client Installation N otes (Release 2.6.2).

Convention Description

monospace Monospace type ind icates UNIX comm ands, d irectory nam es,usernam es, pathnam es, and filenam es.

italics Italic type indicates a variable, including variable portions offilenames. It is also used for emphasis and for book titles.

UPPERCA SE Up percase let ters in dica te Str uctu red Qu er y Lan gu age (SQL)reserved word s, initialization para meters, and environm entvariables.

This string indicates a newline character.

Convention Description

backslash \ A backslash indicates a command that is too long to fit on a single line.Enter the line as displayed (with a backslash) or enter it on a single linewithout a backslash:

dd if=/ dev/ rdsk/ c0t1d0s6 of=/ dev/ rst0 bs=10b \

count=10000

braces { } Braces in dicate requ ired item s: .DEFINE {macro1}

br ackets [ ] Br ackets in dicate op tion al item s: cvtcrt termname [outfile]

ellipses ... Ellipses indica te an arb it rary number of s imilar items:CHKVAL fieldname value1 value2 ... valueN

italics Italic type indicates a variable. Substitute a value for the variable:library_name

vertical line | A vertical line indicates a choice within braces or brackets:SIZE filesize [K|M]


11/44

xi

Oracle Services and SupportThe Oracle corporate Web page is located at:

http://www.oracle.com

Oracle offers a w ide range of services from th is Web site to help facilitate corporate

system solutions, includ ing Oracle Education courses, Oracle Consu lting serv ices, and

Oracle Supp ort Services. In ad dition, Oracle provides free trial software, up dates onOracle products and services, and technical brochures and data sheets.

Oracle Support Services

Technical Supp ort registration and worldw ide contact information is available at:

http://www.oracle.com/support

At the Oracle supp ort site, temp lates are available to help you prep are information

abou t your p roblem before you call so that you m ay be helped more qu ickly. You m ust

also provide you r CSI (Customer Sup port Id entifier) or SAC (Sup por t Access Code)

nu mber if app licable or complete contact deta ils, includ ing any special project

information.

OracleMetaLink

OracleMetaLinkis an Oracle Web service that prov ides technical informa tion. Members

of OracleMetaLinkcan search for updates, alerts, patches, and other information about

prod ucts, releases, and op erating system s, or set preferences to be notified

autom atically of new information. OracleMetaLinkoffers a variety of services to assist

in setting up and adm inistrating Oracle prod ucts, includ ing procedures, scripts,

commen tary, and tu ning an d configuration best-practices bulletins. In ad dition, it

offers forums for inform ation sharing am ong Oracle customers, and d irect

commu nication with Oracle Supp ort Services. OracleMetaLinkis available to Prod uct

Sup port Cu stomers at no extra cost. Sign up for free membership for this service at:

http://www.oracle.com/support/metalink

Use your CSI or SAC num ber to register.

Products and Documentation

For U.S.A. customers, Oracle Store is at:

http://oraclestore.oracle.com

Links to Stores in other coun tries are provided at this site.

Product documentation is available at:

http://docs.oracle.com

Customer Service

Global Custom er Service contacts are listed at:

http://www.oracle.com/support/

Education and Training

Training information and worldwide schedules are available at:

http://www.oracle.com/education/
http://www.oracle.com/http://www.oracle.com/supporthttp://www.oracle.com/support/metalinkhttp://oraclestore.oracle.com/http://docs.oracle.com/http://www.oracle.com/support/http://www.oracle.com/education/http://www.oracle.com/education/http://www.oracle.com/support/http://docs.oracle.com/http://oraclestore.oracle.com/http://www.oracle.com/support/metalinkhttp://www.oracle.com/supporthttp://www.oracle.com/


12/44

xii

Oracle Technology Network

Register with the Oracle Technology N etwor k (OTN) at:

http://otn.oracle.com/

OTN delivers technical papers, code samples, product documentation, an Oracle

on-line comm un ity and self-service developer sup port. It also offers the Oracle key

developer prod ucts to enable rapid d evelopm ent and deployment of app lications builton Oracle technology.
http://otn.oracle.com/http://otn.oracle.com/


13/44

Pre-Installation Requirements 1-1

1Pre-Installation Requirements

This chap ter describes pre-installation steps required for an Oracle9i Client release 2

(9.2.0.4.0) software installation. Verify th at your system meets th e ha rdw are, d isk

space, operating system, and other requ irements for installing the Oracle9i Client

release 2 (9.2.0.4.0).

This chap ter includes the following sections:

Hard ware Requirements

Disk Space Requiremen ts

Operating System Requirements

Product-Specific Requiremen ts

Character Sets

Hardware RequirementsTo insta ll the Oracle9i Client release 2 (9.2.0.4.0) included with this release, your

system m ust m eet the minimum hardw are requirements listed in th e following table:

Random Access Memory

To determine the am ount of random access memory installed on your system, enter

the following command :

analyze_systemdump_mtquit

Hardware Requirements

Memory A minimum of 256 MB is required to install Oracle9i Client

Sw ap sp ace Disk sp ace equ al to th e system s p hysical m em ory, or 1GB,whichever is greater

Tape drive A DDS or DLT tape drive

CPU Stratus Continuum Series module with HP-PA8x00 class CPU

Network adapter Ethernet adapter

Free d isk b locks At least 100,000 free d isk b locks on the installa tion d isk for thebase insta llation, and 350,000 free d isk blocks if all thedemonstration and sample programs are built.


14/44

Disk Space Requirements

1-2 Installation and Configuration Guide

Swap Space

To d etermine the amou nt of swap space currently configured in your system, enter the

command:

display_paging_usage

Disk Space RequirementsThe disk space requirements for the Oracle9i client softw are is 2.0 GB.

Operating System RequirementsThis section lists the Oracle9i operating system requirements.

Operating system version:

Stratu s VOS 14.6.1 ag or later.

S115 Stream s TCP.

S579 Open software.

S877 and S878 GNU tools and library. This software is requ ired to be installed for

Oracle supp ort pu rposes. The u ser is not required to use this software to bu ild

their applications, but it is required to u se the Oracle make files.

S456 ANSI C comp iler and S031 C runtim e library, if the C p recompiler or OCI

interface will be used .

S020 COBOL comp iler and S021 COBOL runtim e library, if the COBOL

precompiler will be used.

S279 POSIX library, if the C or COBOL precomp ilers, or the O CI interface w ill be

used.

Operating system p atches:

None.

Use the following command to determine the current op erating system version:

uname -a

Product-Specific RequirementsThis section prov ides prod uct-specific system configuration requ irements. Make these

additional system configuration changes to use the optional Oracle products.

Precompilers and Tools

Table 11 lists the restrictions and requiremen ts for precompilers and tools.

Note: This is an app roximate value that m ight vary slightly at

installation time.


15/44

Character Sets

Pre-Installation Requirements 1-3

Network and System Management Products

All network prod ucts require the und erlying software an d operating system libraries

for the supp orted network. The network software mu st be installed and runn ing prior

to installing the Oracle Net prod ucts.

Character SetsThis section p rovides information on restrictions and u pd ates to character sets.

Oracle9iNCHAR Datatypes

Oracle9i Client release 2 (9.2.0.4.0) limits th e SQL NCH AR da tatypes to th e Un icode

character set encoding (UTF8 and AL16UTF16). Alternative this release no longer

sup ports character sets su ch as the fixed-wid th Asian char acter set JA16SJISFIXED in

Oracle8i.

To migrate existing NCHA R, NVARCHAR, and N CLOB columns, export an d imp ortNCHAR columns, complete the following steps:

1. Export all SQL NCH AR column s from Oracle8i.

2. Drop the SQL NCH AR columns.

3. Migrate the database to Oracle9i.

4. Import the SQL NCH AR colum ns in to Oracle9i.

AL24UTFFSS Character Set

Oracle9i Client release 2 (9.2.0.4.0) does not sup por t the Un icode character set

AL24UTFFSS introd uced in Or acle7. This character set is based on th e Unicode

stand ard 1.1, wh ich is now obsolete.

Oracle9i Client r elease 2 (9.2.0.4.0) supp orts th e Un icode da tabase character sets

AL32UTF8 and UTF8. These database character sets include the Un icode

enhancements based on the Unicode standard 3.0.

To migrate th e existing AL24UTFFSS database, up grad e you r database character set to

UTF8 before up grad ing to Oracle9i. Oracle recomm end s that you use the Cha racter Set

Scanner for data an alysis before attemp ting to migrate you r existing database

character set.

Table 11 Precompilers and Tools Restrictions and Requirements

Product Name Platform Restrictions and Requirements

Pro*C/ C++,9.2.0.4.0

Continuum 600 and1200 Series

S456 VOS stand ard C comp iler

S031 C Runtim e

Pro*COBOL,

1.8.77

Continuum 600 and

1200 Series

S020 COBOL comp iler

S021 COBOL Runtime

Pro*COBOL,9.2.0.4.0

Continuum 600 and1200 Series

S020 COBOL comp iler

S021 COBOL Runtime

See Also: Your operating system an d third-party vendor

networking p roduct d ocumentation for more information on

network and system management produ cts.


16/44

Character Sets



17/44

Installation 2-1

2Installation

This chap ter describes how to install Oracle9i Client release 2 (9.2.0.4.0) prod ucts on

your system . Review and comp lete the tasks listed in Chap ter 1, "Pre-Installation

Requirements" before beginn ing the installation. This chap ter contains the following

sections:

Installation Instructions

Additional Information

Installation InstructionsThe following instru ctions describe how to install Oracle9i Client release 2 (9.2.0.4.0)

on the system.

1. Insert the Oracle9i Client r elease 2 (9.2.0.4.0) distribution tape into a tape dr ive on

the module.

2. Log in to the mod ule using an account with the ap propriate access to create the

Oracle9i directory structure in the app ropriate d irectory. For examp le, to install

Oracle9i on the master d isk in the system d irectory, log in u sing an accoun t in the

SysAdmin group. You mu st log in with the -privileged option no matter whataccoun t is used to log in.

3. Create the Oracle home d irectory. Oracle9i can be installed on an y disk or

directory. For exam ple, to install Oracle9i on the m aster disk in a system directory

named Oracle9i, use the following command :

create_dir (master_disk) >system>Oracle9i

4. Change to the directory that was created in step 3. For examp le, if using the

Oracle9i directory, then enter the following command :

change_current_dir (master_disk)>system>Oracle9i

5. Attach a p ort to the tape d rive using the attach_port comman d. For examp le, if

the port is t, and d rive name is #mt1.0, then enter the following comm and:

attach_port t #mt1.0

6. Mount the tape for read-only access using the m ount_tape command . For

example, if the port is t, then enter the following command :

mount_tape t -access_rights readonly

A system prom pt m ay app ear asking if the tape is correct.


18/44



7. Extract th e Or acle9i distribution into the current directory using the restore

comman d. For examp le, if the port is t, then enter the following comm and :

restore t -restore_acls

If the system prom pts "What tape is to be used?", then enter the volum e id show n

in the output from the moun t_tape command in step 6.

This step m ay take 45 minu tes or more to comp lete. No error m essages should begenerated du ring the process.

8. Detach the tape port to un load the tape. For example, if the port is t, then enterthe following command :

detach_port t

9. Create a link as follows, if it does not a lready exist:

link (master_disk)>system>gnu_library>bin (master_disk)>bin

This link allow s the Oracle make files to invok e the bash shell as /bin/sh.

10. Add th e Oracle execution (binary) directory to the comm and library paths. For

example, the following command adds the Oracle execution directory to thelibrary p ath:

add_library_path command (master_disk)>system>Oracle9i>bin

You m ay wan t to make this a d efault library path for the modu le.

Additional InformationThe following informa tion is specific for Stratu s Contiu um 600 and 1200 Series

installations of Oracle9i:

Any references in the Oracle documen tation to the make command must besubstituted w ith the gmake command.

Some Oracle header files contain n ames th at are longer th an the 32-character VOS

limit. This can cause the binder to report missing sym bols due to truncated n ames.

The head er file $ORACLE_HOME/vos/long_name_xlate_table.h has beensup plied to correct the problem. Includ e the file in the ANSI C comp ilation w ith

the -include compiler d irective.

The source file and ANSI options m ay not occur after the -includeheaderfile specification.

Relinking Information

The following relinking information is sp ecific for Stratus Con tiuum 600 and 1200

Series installations of Oracle9i:

Before re-linking any Oracle utilities, the VOS object library path s m ust include a t

least the following ob ject libraries in the order show n:

(current_dir)

Note: You m ust u se the Oracle make files to re-link any of the

Oracle9i Client binaries and demonstrations. This requires you be in

bash.


19/44


Installation 2-3

(master_disk)>system>stcp>object_library(master_disk)>system>stcp>object_library>common(master_disk)>system>stcp>object_library>sbsd(master_disk)>system>stcp>object_library>socket(master_disk)>system>posix_object_library>sysv(master_disk)>system>c_object_library>(master_disk)>system>object_library>

To relink SQL*Plus, u se the following command :

bashcd $ORACLE_HOME/sqlplus/libgmake -f ins_sqlplus.mk install

To relink tn sping, use the following command s:

bashcd $ORACLE_HOME/network/libgmake -f ins_net_client.mk install

To relink th e precomp ilers, use the following com man ds:

bashcd $ORACLE_HOME/precomp/lib

For P ro*C:

gmake -f ins_precomp.mk relink EXECNAME=proc

For Pro*COBOL:

gmake -f ins_precomp.mk relink EXENAME=procob

For Pro*COBOL 18:

gmake -f ins_precomp.mk relink EXENAME=procob18


20/44




21/44

Post-Installation 3-1

3Post-Installation

After comp leting installation, you mu st perform certain post-installation steps and

configur e the Or acle9i da tabase. This chapter d escribes the required steps as well as

some optional ones.

Configuration Tasks to Perform a s the root User

Configuration Tasks to Perform as the oracle User

Additional Oracle Product Installation and Configuration

Configuration Tasks to Perform as the root UserLog in as the root user an d verify database file secur ity. To preven t un auth orizedaccess to secure data, you mu st protect you r files. The file privileges and

recomm ended ownership are as follows: The oracleaccoun t shou ld have read , write, and execute p rivileges for all files

and directories in the Oracle9i installation.

No u ser other than the oracle user should have write access on any files ordirectories in th e Oracle9i installation.

Table 31 sum mar izes the directory and file permissions for different typ es of files.

Note: This chap ter describes basic configuration only. See the

Oracle9i A dministrators Reference Release 2 (9.2.0.4.0) for UN IX

Systems and the produ ct adm inistration and tuning gu ides for more

sophisticated configuration and tuning information.

Note: These permissions are the default values and should not be

changed.

Table 31 Access Permissions on Oracle Directories and Files

Directories/Files Permissions Comments

$ORACLE_HOME/bin/ 755

rwxr-xr-x

The oracle user should have read, write andexecute p rivileges and all users should haveread and execute privileges to this directory.

All other executables 755

rwxr-xr-x

The oracle user should have read, write andexecute p rivileges and all users should haveread and execute privileges to this directory.


22/44

Configuration Tasks to Perform as the oracle User


Configuration Tasks to Perform as the oracle UserPerform the following task as the oracle user:

Set the following environm ent variables in the.profile or.login file of the oracleuser before using Oracle9i produ cts. The settings that you u se here should correspond

to the settings used d ur ing installation as described in "Set Environment Variables" on

page 2-36. The syntax for setting en vironm ent variables is as follows:

For the Bourne or Korn shell:

variable_name=value; export variable_name

For the VOS command line:

set variable_name=value

Table 32 describes the Environm ent Variable Settings.

$ORACLE_HOME/lib/ 755

rwxr-xr-x

The oracle user should have read, write andexecute p rivileges and all other users shou ldhave read and execute p rivileges to thisdirectory.

All files under$ORACLE_HOME/lib/ 644rw-r--r--

The oracle user should have read, write andexecute p rivileges and the oth er users shou ldhave read-only privileges to these files.

Produ ct subdirectories such as$ORACLE_HOME/sqlplusor$ORACLE_HOME/rdbms

751

rwxr-x--x

The oracle user and ORAINVENTORYgroup have restr icted access to log files.Theother u sers have execute pr ivileges.

Files in$ORACLE_HOME/sqlplusor$ORACLE_HOME/rdbms

644

rw-r--r--

The oracle user should have read and writeprivileges and the other users shou ld haveread-only privileges to these files.

$ORACLE_HOME/network/trace

777

rwxrwxrwx

or

730

rwx-wx---

The oracle user and members of theORAINVENTORY group h ave access to trace

files when 730 is used in the prod uctionenvironment. 777 allows broad access to viewand create trace files during d evelopment.

All files und er prod uct admindirectories, like$ORACLE_HOME/rdbms/admin and$ORACLE_HOME/sqlplus/admin

644

-rw-r--r--

SQL scripts shou ld typ ically be run as the SYSuser.

Caution: Do not d efine environment variables with nam es that

are identical to those u sed for Oracle processes such as CKPT, PMON,and DBWR.

Table 31 (Cont.) Access Permissions on Oracle Directories and Files

Directories/Files Permissions Comments
http://../originals/pre.pdfhttp://../originals/pre.pdfhttp://../originals/pre.pdfhttp://../originals/pre.pdfhttp://../originals/pre.pdfhttp://../originals/pre.pdf


23/44


Post-Installation 3-3

Additional Oracle Product Installation and ConfigurationThis section p rovides ad ditional information on configur ing Oracle Precomp ilers.

Configuring Oracle PrecompilersAll precompiler configuration files are located in the

$ORACLE_HOME/precomp/admin directory. Table 33 describes the Or aclePrecompilers.

Table 32 Environment Variable Settings

Environment Variable Recommended Setting

O RACLE_H OME Set t he O RACLE_H OME var iab le. The O RA CLE_H OMEvariable must be set before an Ora cle utility or user app licationcan be used. The d irectory referenced by the variable mu st bePOSIX forma t. For examp le, if Oracle9i is installed in

(master_disk)>system>Oracle9i, then enter thefollowing command :

ORACLE_HOME=/system/Oracle9i

The following is also an acceptable command:

ORACLE_HOME=/%my_system#m1_d01/system/Oracle9i

However, the following is not acceptable:

ORACLE_HOME/%system#disk>system>Oracle9i

PATH Verify (master_disk)>system>gnu_library>bin is inthe default command library p ath list. If it is not, then itshou ld be ad ded to the list. This is required for Oraclesupport.

See Also:Chapter 2, "Pre-Installation Requirements" for moreinformation on other PATH requirements.

TN S_ADMIN TN S_ADMIN sp ecifies th e d irectory con tain in g th e Or acle N etServices configuration files.

Oracle Net Services configuration files are typ ically, but notalways located in the $ORACLE_HOME/admin/networkdirectory. Depending on the file, Oracle Net uses a differentsearch ord er to locate the file.

The search ord er for the sqlnet.ora and ldap.ora files is asfollows:

1. The directory specified by the TNS_ADMIN environmentvariable, if set

2. The $ORACLE_HOME/admin/networkdirectory

TWO_TASK Set the TWO_TASK variable to the defau lt con nect id en tifier touse in the connect string. The default connect identifier doesnot need to be specified in the connect string. For example, ifthe TWO_TASK environm ent va riable is set to sales, you canconnect to a d atabase using the CONNECTusername/passwordcommand rather than the CONNECTusername/password@sales command.

See Also:Oracle9i Net Services Administrators Reference andOracle9i Administ rators Reference Release 2 (9.2.0.4.0) for UNIXSystems for m ore information on connect identifiers.
http://../originals/pre.pdfhttp://../originals/pre.pdf


24/44



Note: You cannot use Oracle Precomp ilers independen tly of

Oracle9i to convert embedded PL/ SQL.

Table 33 Oracle Precompilers

Precompilers Configuration Files See Also

Pro*C/ C++ pcscfg.cfg

This file installs withou tcontent and can beconfigured w ith any texteditor according to thesite-specific requirements.

Programmers Gu ide to t he Pro*C/C++Precompilerfor more information onconfiguring th e pcscfg.cfg file.

Pro*COBOL pcbcfg.cfg

This file installs withou tcontent and can beconfigured w ith any texteditor according to thesite-specific requirements.

Pro*COBOL Programmers Guide formore information on configuring thepcbcfg.cfg file.

Pro*COBOL18 pcccob.cfgThis file installs withou tcontent and can beconfigured w ith any texteditor according to thesite-specific requirements.

Pro*COBOL Programmers Guide formore information on configuring thepcccob.cfg file.


25/44

Administering SQL*Plus 4-1

4Administering SQL*Plus

This chap ter describes how to use and ad minister SQL*Plus on Oracle9i Client. It

contains the following sections:

Ad ministering Comm and -Line SQL*Plus

Using Com man d-Line SQL*Plus

SQL*Plus Restr ictions

Administering Command-Line SQL*PlusThis section describes how to administer comm and -line SQL*Plus. In the examp les in

this section, SQL*Plus u ses the valu e of the ORACLE_HO ME environm ent va riable

wh erever a question mark (?) appears.

This section includes the following top ics:

Using Setup Files

Using the PRODUCT_USER_PROFILE Table

Using EMP and DEPT Tables

SQL*Plus Com man d-Line Help

Installing the SQL*Plus Com man d-Line Help

Removing th e SQL*Plus Com man d-Line Help

Using Setup Files

When you start SQL*Plus, it executes the glogin.sql site profile set-up file and thenexecutes th e login.sql user profile set-up file.

Using the Site Profile File

The globa l site profile file is $ORACLE_HOME/sqlplus/admin/glogin.sql . If a siteprofile already exists at this location, it is overw ritten w hen you install SQL*Plus. If

SQL*Plus is removed, the site profile file is deleted.

Using the User Profile File

The user profile file is login.sql. SQL*Plus looks for this file in the cur rent d irectory,and then in the d irectories you sp ecify using th e SQLPATH environm ent var iable. Set

See Also: SQL*Plus Users Guide and Reference for more

information on and SQL*Plus.


26/44

Administering Command-Line SQL*Plus


this env ironmen t var iable to a colon-separated list of d irectories. SQL*Plus searches

these d irectories for the login.sql file in the order they are listed.

The options set in the login.sql file override those set in the glogin.sql file.

Using the PRODUCT_USER_PROFILE TableOracle9i prov ides the PRODU CT_USER_PROFILE table that you can use to d isable the

SQL and SQL*Plus comm and s that you specify.

To create th e PRODUCT_USER_PROFILE table, run the $ORACLE_HOME/sqlplus/admin/pupbld.sql script in the SYSTEM schema :

$ORACLE_HOME/sqlplus/admin/pupbld.sql

For example, enter the following commands, where SYSTEM_PASSWORDis the

password of the SYSTEM user:

$ sqlplus SYSTEM/SYSTEM_PASSWORD

SQL> @?/sqlplus/admin/pupbld.sql

You can also recreate the PRODUCT_USER_PROFILE table manu ally in th e SYSTEM

schema u sing the $ORACLE_HOME/bin/pupbld shell script. This script prom pts forthe SYSTEM passw ord. If you n eed to ru n the pupbld script w ithout interaction, setthe SYSTEM_PASS environm ent variable to the SYSTEM u sernam e and passw ord . For

example, enter the following command wh ere SYSTEM_PASSWORDis the password of

the SYSTEM user:

$ SYSTEM_PASS=SYSTEM/SYSTEM_PASSWORD; export SYSTEM_PASS

Using EMP and DEPT Tables

This section describes how to m anu ally create and delete the EMP and DEPTdem onstration tables.

Creating Demonstration Tables Manually

Use the $ORACLE_HOME/sqlplus/demo/demobld.sql SQL script to create theEMP and DEPT dem onstration tab les. In SQL*Plus, you can u se any usernam e to run

the demobld.sql script to create the demonstration tables in a schem a. For examp le,enter:

$ sqlplus SCOTT/TIGERSQL> @?/sqlplus/demo/demobld.sql

You can also use th e $ORACLE_HOME/bin/demobld shell script to run the

demobld.sql script, as follows:

$ demobld SCOTT TIGER

Deleting Demonstration Tables

Use the $ORACLE_HOME/sqlplus/demo/demodrop.sql script to d rop the EMPand DEPT dem onstrat ion tables. In SQL*Plus, you can use any username to d rop the

dem onstration tables from the user s schem a. For example, enter:

$ sqlplus SCOTT/TIGER

See Also: SQL*Plus Users Guide and Reference for more information

on p rofile files.


27/44

Administering Command-Line SQL*Plus


SQL> @?/sqlplus/demo/demodrop.sql

You can also u se the $ORACLE_HOME/bin/demodrop shell script to run th edemodrop.sql script, as follows:

$ demodrop SCOTT TIGER

SQL*Plus Command-Line HelpThis section describes how to install and remove th e SQL*Plus comm and -line help .

Installing the SQL*Plus Command-Line Help

There are three ways to install the SQL*Plus comm and -line help:

Perform an installation that installs a starter da tabase.

When you copy a starter d atabase with p re-built datafiles as part of an installation,

SQL*Plus automatically installs the SQL*Plus command-line help in the SYSTEMschema.

Install the comm and -line help m anu ally in the SYSTEM schem a using th e

$ORACLE_HOME/bin/helpins shell script.

The helpins script p romp ts for the SYSTEM password . If you need to run thisscript without interaction, set the SYSTEM_PASS environm ent variable to th e

SYSTEM usern ame and p assword . For examp le, enter the following comman d

where SYSTEM_PASSWORDis the p assword of the SYSTEM user:

$ SYSTEM_PASS=SYSTEM/SYSTEM_PASSWORD; export SYSTEM_PASS

Install the comm and -line help m anu ally in the SYSTEM schem a using th e

$ORACLE_HOME/sqlplus/admin/help/helpbld.sql script.For examp le, enter the following comm ands, w here SYSTEM_PASSWORDis the

password of the SYSTEM user:

$ sqlplus SYSTEM/SYSTEM_PASSWORDSQL> @?/sqlplus/admin/help/helpbld.sql ?/sqlplus/admin/help helpus.sql

Removing the SQL*Plus Command-Line Help

To ma nually drop the SQL*Plus comm and -line help tables from the SYSTEM schema,

run the $ORACLE_HOME/sqlplus/admin/help/helpdrop.sql script. Forexample, enter the following commands, where SYSTEM_PASSWORDis the password

of the SYSTEM u ser:

$ sqlplus SYSTEM/SYSTEM_PASSWORDSQL> @?/sqlplus/admin/help/helpdrop.sql

See Also: SQL*Plus Users Guide and Reference for more information

on the SQL*Plus comm and -line help.

Note: Both th e helpins shell script and th e helpbld.sql scriptdrop existing command -line help tables before creating new t ables.


28/44

Using Command-Line SQL*Plus


Using Command-Line SQL*PlusThis section d escribes how to use com mand -line SQL*Plus. It includ es the following

topics:

Using a System Editor from SQL*Plus

Running Operating System Commands from SQL*Plus

Interrup ting SQL*Plus

Using the SPOOL Comman d

Using a System Editor from SQL*PlusIf you en ter an ED or EDIT comman d at th e SQL*Plus p romp t, the system starts an

opera ting system editor, such as ed,emacs,ned, or vi. The PATH variable mu stinclude the directory wh ere the editor executable is located.

When you star t the editor, the cur rent SQL buffer is placed in the ed itor. When you exit

the ed itor, the changed SQL buffer is return ed to SQL*Plus.

You can specify which ed itor start s by defining th e SQL*Plus _EDITOR variable. You

can define this variable in the glogin.sql site profile, the login.sql user p rofile,or d efine it during the SQL*Plus session. For examp le, to set the d efault editor to vi,enter:

SQL> DEFINE _EDITOR=vi

If you d o not set the_EDITOR variable, the value of either the EDITOR or the VISUAL

environm ent variable is used. If both environm ent variables are set, the value of the

EDITOR variable is used. When _EDITOR, EDITOR, and VISUAL are not specified,

the default editor is ed.

If you start the ed itor, SQL*Plus u ses the afiedt.buf temp orary file to pass text tothe ed itor. You can use the SET EDITFILE comm and to specify a d ifferent filename. For

example, enter:

SQL> SET EDITFILE /tmp/myfile.sql

SQL*Plus d oes not d elete the temp orary file.

Running Operating System Commands from SQL*PlusUsing the H OST comm and or an exclamation mar k (!) as the first character after the

SQL*Plus p romp t causes subsequen t characters to be passed to a sub-shell. The SHELL

environment variable sets the shell used to execute operating system commands. The

default shell is the Bour ne shell (/bin/sh). If the shell cannot be executed , an errormessage is displayed.

To return to SQL*Plus, enter the exit command.

For examp le, to execute one comm and , enter:

SQL>! command

In the p receding examp le, commandrepresents the operating system comm and that

you w ant to execute.

To execute m ultiple oper ating system comman ds from SQL*Plus, enter the HO ST or !

command then p ress Return. SQL*Plus returns you to the operating system p rompt.


29/44

SQL*Plus Restrictions


Interrupting SQL*Plus

While runn ing SQL*Plus, you can stop the scrolling record d isplay and terminate a

SQL statement by p ressing Ctr l+c.

Using the SPOOL CommandThe default file extension of files generated by t he SPOOL comm and is .

lst. To

change th is extension, specify a spool file containing a per iod (.). For example, enter:

SQL> SPOOL query.txt

SQL*Plus RestrictionsThis section describes SQL*Plus restrictions. It includes the following topics:

Resizing Windows

Return Cod es

Hid ing Your Passw ord

Resizing WindowsThe default values for the SQL*Plus LINESIZE and PAGESIZE system var iables do not

automatically adjust for window size.

Return CodesUNIX return codes u se only one byte, which is not enou gh sp ace to return an O racle

error code. The range for a return code is 0 to 255.

Hiding Your Password

If you set the SYSTEM_PASS environm ent va riable to the usern ame an d passw ord of

the SYSTEM u ser, the ou tpu t from th e ps command might display this information. Toprevent u nauth orized access, enter the SYSTEM password only wh en prom pted by

SQL*Plus.

If you wan t to au tomatically ru n a script, consider using an authentication m ethod

that does not require you to store a passw ord, for examp le, externally authenticated

logins to Or acle9i. If you h ave a low security environment, you m ight consider u sing

UNIX pipes in script files to pa ss a p assword to SQL*Plus, for example:

$ echo SYSTEM_PASSWORD | sqlplus SYSTEM @MYSCRIPT

Alternatively, enter the following lines at the comm and prom pt:

$ sqlplus


30/44

SQL*Plus Restrictions



31/44

Using Oracle Precompilers and the Oracle Call Interface 5-1

5Using Oracle Precompilers and the OracleCall Interface

This chap ter d escribes Oracle Precompilers and the Oracle Call Interface. It contains

the following sections:

Overview of Oracle Precompilers

Pro*C Precompiler Pro*COBOL Precompilers

Oracle Call Interface

Custom Make Files

Using Signal Handlers

Overview of Oracle PrecompilersOracle precompilers are app lication-developm ent tools used to combine SQL

statements for an Oracle d atabase with p rograms w ritten in a h igh-level language.

Oracle precompilers are comp atible w ith AN SI SQL and are used to d evelop open,

customized app lications that run with O racle9i or any other AN SI SQL database

management system.

To bu ild any of the precomp iler sam ples (C or COBOL) using t he Or acle make files, do

the following:

1. Verify TWO_TASK is set to the server name.

2. Verify the account scott/ tiger exists and th e demo tables are installed on the server

to wh ich you will connect.

3. Run the following comman ds to setup the database:

cd $ORACLE_HOME/precomp/demo/sqlsqlplus scott/tiger @calldemo.sql

sqlplus scott/tiger @sample11.sqlsqlplus scott/tiger @cv_demo.sql

Precompiler FilesConfiguration files for the Oracle precompilers are located in the $ORACLE_HOME/precomp/admin directory. The nam e of the configuration file for thePro*C/ C++ precompiler is pcscfg.cfg.

The executable file for the p recompiler is proc.


32/44

Pro*C Precompiler


Precompiler README Files

Table 51 lists the location of the precompiler README files. The README files

describe changes mad e to the precomp iler since the last release.

Issues Common to All Precompilers

The following issues are comm on to all precomp ilers.

Uppercase to Lowercase Conversion

In languages other th an C, the compiler converts an up percase function or

subp rogram nam e to lowercase. This can cause a No such user exists error

message. If you receive this error message, verify that th e function or subp rogramnam e in you r op tion file matches th e case used in th e IAPXTB table.

Vendor Debugger Programs

Precomp ilers and vendor-supp lied d ebuggers can be incompatible. Oracle does n ot

guarantee that a program run u sing a debugger w ill perform the same w ay wh en it is

run w ithout the debugger.

Value of IRECLEN and ORECLEN

The IRECLEN and ORECLEN param eters do not h ave maximum values.

Static LinkingYou can statically link Oracle libraries w ith p recompiler and OCI applications. With

static linking, the libraries and objects of the w hole application are linked together into

a single executable program.

Pro*C PrecompilerBefore you use the Pro*C/ C++ precomp iler, verify that the correct version of the

operating system compiler is properly installed.

Known Issue with Pro*C

The following is a know n issue and its workaround :

Issue:

char_map gives extra control character on Stratus.

Workaround:

Set char_map to CHARZ or STRING. CHARZ is the d efault in Oracle9i.

Table 51 Location of Precompiler README Files

Precompiler README File

Pro*C/ C++ release 9.2.0.4.0 $ORACLE_HOME/precomp/doc/proc2/readme.doc

Pro*COBOL release 9.2.0.4.0 $ORACLE_HOME/precomp/doc/procob2/readme.doc

Pro*COBOL release 1.8.77.0.0 $ORACLE_HOME/precomp/doc/pro1x/readme.txt


33/44

Pro*C Precompiler


Pro*C Demonstration Programs

Demonstration p rograms are provided to show the features of the Pro*C/ C++

precomp iler. There are three types of dem onstration p rogram s: C, C++, and Object

programs. Object programs d emonstrate the new Oracle9i Object features. All of the

demon stration p rograms are located in the $ORACLE_HOME/precomp/demo/procdirectory.

The programs assum e that the d emonstration tables created by the $ORACLE_HOME/sqlplus/demo/demobld.sql script exist in the SCOTT schema w ith thepassw ord TIGER.

Use the demo_proc.mk make file, located in the $ORACLE_HOME/precomp/demo/proc/ directory, to create the dem onstration p rogram s. Forexample, to precomp ile, compile, and link the sample1 dem onstration program, enterthe following command :

bashcd $ORACLE_HOME/precomp/demo/procgmake -f demo_proc.mk samples

To create all of the C d emon stration p rogram s for Pro*C, enter:

$ gmake -f demo_proc.mk samples

To create all of the Object demon stration p rogram s for Pro*C, enter:

$ gmake -f demo_proc.mk object_samples

Some demonstration programs require you to run a SQL script, located in the

$ORACLE_HOME/precomp/demo/sql directory. If you do not ru n the script, amessage displays requesting you to run it. To build a d emonstration program and run

the correspond ing SQL script, include the make macro argum ent RUNSQL=run on thecomman d line. For examp le, to create the calldemo demonstration program and runthe required $ORACLE_HOME/precomp/demo/sql/calldemo.sql script, enter:

$ gmake -f demo_proc.mk calldemo RUNSQL=run

To create all of the Object dem onstration p rogram s and ru n all correspon ding requ ired

SQL scripts, en ter:

$ gmake -f demo_proc.mk object_samples RUNSQL=run

Pro*C User Program

You can use the $ORACLE_HOME/precomp/demo/proc/demo_proc.mk make file tocreate user programs. The syntax for creating a program with the demo_proc.mkmake file is:

$ gmake -f demo_proc.mk target OBJS="objfile1objfile2 ..." EXE=exename

In the preceding example:

target is the make file target that you want to use

objfilen is the object file to link the p rogram

exename is the executab le program

For examp le, to create the program myprog from the Pro*C source file myprog.pc,enter one of the following command s, depend ing on the source and th e type of

executab le you wan t to create.


34/44

Pro*COBOL Precompilers


For C source, dynamically linked w ith the client sha red library, enter:

$ gmake -f demo_proc.mk build OBJS=myprog.o EXE=myprog

For C sou rce, statically linked , enter:

$ gmake -f demo_proc.mk build_static OBJS=myprog.o EXE=myprog

To bu ild the Pro*C examp les in th e native VOS environmen t, do the following:1. Copy $ORACLE_HOME/vos/build_proc_demos.cm to $ORACLE_

HOME/precomp/demo/proc.

2. Copy the file $ORACLE_HOME/vos/c_precomp_template.bind to$ORACLE_HOME/vos/c_precomp.bind .

3. Edit $ORACLE_HOME/vos/c_precomp.bind replacing the occurrences ofMASTER_DISK and ORACLE_HOME accord ing to the in structions in the file.

4. Change the current directory to ORACLE_HOME/ precomp/ demo/ proc.

5. Ensure ORACLE_HOME and TWO_TASK are set correctly.

6. Ensure ORACLE_HO ME/ bin is in the comm and library paths.

7. Ensure the account scott/ tiger exists and the d emo tables are installed on the

server.

8. Run build_proc_demos.cm. This will install the SQL*Plus scripts,pre-compile, comp ile, and bind all the available Pro*C samp les.

Pro*COBOL PrecompilersTo bu ild the Pro*COBOL examp les using th e Oracle make files, do the following:

1. Copy the file $ORACLE_HOME/vos/cobol_precomp_template.bind to$ORACLE_HOME/vos/cobol_precomp.bind .

2. Edit $ORACLE_HOME/vos/cobol_precomp.bind replacing the occurrences ofMASTER_DISK and ORACLE_HOME according to the instru ctions in the file.

For Pro*COBOL 18:

bashcd $ORACLE_HOME/precomp/demo/procobgmake -f demon_procob18.mk samples

For Pro*COBOL (Pro*COBOL 2):

bashcd $ORACLE_HOME/procomp/demo/procob2gmake -f demo_procob.mk samples.

Known Issue with Pro*COBOL

The following is a know n issue and its workaround :

Issue

Datatyp e S9(N)binary d oes not wor k for small integers.

Workaround:

Use either COMP or integer.


35/44


36/44



you m odify the prov ided make file, or if you choose to use a custom-wr itten make file,

the following restrictions app ly:

Do not m odify the ord er of the Oracle libraries. Oracle libraries are includ ed on the

link line m ore than on ce so that all of the symbols are resolved du ring linking.

The order of the Or acle libraries is essential for the following reasons:

Oracle libraries are m utu ally referential. Fun ctions in library A call fun ctions

in library B, and functions in library B call functions in library A.

The Stratus VOS linkers are tw o-pass linkers.

If you ad d your ow n library to the link line, add it to the beginning or to the end of

the link line. Do not p lace user libraries between the Oracle libraries.

If you choose to use a make utility such as nmake or GNU make, be aware of howmacro and suffix processing d iffers from the make utility prov ided w ith the

platform. Oracle make files are tested and are supp orted w ith the make utility foryour p latform.

Oracle library nam es and the contents of Oracle libraries are subject to change

between releases. Always use the demo_product.mk make file that ship s with

the current release as a guid e to determine th e required libraries.

Using Signal HandlersOracle9i uses signals for two-task comm un ication. Signals are installed in a u ser

process wh en you connect to the database and are removed wh en you d isconnect.

Table 52 describes the signals that Ora cle9i uses for two-task communication.

The listed signals affect all precomp iler ap plications. You can have m ore than one

signa l handle for SIGINT. For SIGINT, use osnsui() and osncui() to register anddelete signa l-catching routines.

You can also install as many signal hand lers as you want for other signals. If you are

not connected tothe Or acle process, you can h ave mu ltiple signal handlers.

Examp le 51 shows how to set up a signal routine and a catching routine.

Example 51 Signal Routine and Catching Routine

/* user side interrupt set */word osnsui( /*_ word *handlp, void (*astp), char * ctx, _*/)/*** osnsui: Operating System dependent Network Set User-side Interrupt. Add an** interrupt handling procedure astp. Whenever a user interrupt(such as a ^C)** occurs, call astp with argument ctx. Put in *handlp handle for this** handler so that it may be cleared with osncui. Note that there may be many** handlers; each should be cleared using osncui. An error code is returned if

Table 52 Signals for Two-Task Communication

Signal Description

SIGINT Two-task drivers use SIGINT to detect user interrupt requests. The Oracleprocess does not catch SIGINT; the u ser p rocess catches it.

SIGIO Oracle Net protocols use SIGIO to indicate incoming networking events.

SIGURG Oracle Net TCP/ IP drivers use SIGURG to send out-of-band breaks from theuser process to the Or acle p rocess.


37/44



** an error occurs.*/

/* user side interrupt clear */word osncui( /*_ word handle _*/ );/*** osncui: Operating System dependent Clear User-side Interrupt. Clear the** specified handler. The argument is the handle obtained from osnsui. An error** code is returned if an error occurs.*/

Examp le 52 shows h ow to use th e osnsui() and the osncui() routines in an ap plication

program.

Example 52 osnsui() and osncui() Routine Template

/*** User interrupt handler template.*/void sig_handler(){...}

main(argc, argv)int arc;char **argv;{

int handle, err;...

/* set up my user interrupt handler */

if (err = osnsui(&handle, sig_handler, (char *) 0))

{ /* if the return value is non-zero, an error has occurredTake appropriate action for the error. */

...}

...

/* clear my interrupt handler */

if (err = osncui(handle)){

/* if the return value is non-zero, an error has occurredTake appropriate action for the error. */

...}...

}


38/44




39/44

Configuring Oracle Net Services 6-1

6Configuring Oracle Net Services

This chap ter describes how to configure Oracle Net Services on Stratus system s. It

contains the following sections:

Location of O racle Net Services Configuration Files

Oracle Protocol Sup por t

Location of Oracle Net Services Configuration FilesOracle Net Services configura tion files are typ ically, but not always, located in the

$ORACLE_HOME/network/admin directory. Depend ing on the file, Oracle Net uses adifferent search ord er to locate the file.

The search ord er for the sqlnet.ora an d ldap.ora files is as follows:

1. The directory specified by th e TNS_ADMIN environm ent var iable, if set

2. The $ORACLE_HOME/network/admin directory

The search ord er for the cman.ora, listener.ora, and tnsnames.ora files is asfollows:

1. The directory specified by th e TNS_ADMIN environm ent var iable, if set

2. The /etc directory.

3. The $ORACLE_HOME/network/admin directory

For some system-level configuration files, users m ay have a corresponding user-level

configur ation file (stored in the u sers home d irectory). The settings in the u ser-level

file override the settings in the system-level file. The following table lists the

system-level configuration files and the correspon ding user-level configuration files:

Sample Configuration Files

The $ORACLE_HOME/network/admin/samples directory contains samp les of thecman.ora, listener.ora, names.ora, sqlnet.ora, and tnsnames.oraconfigur ation files.

See Also: Oracle9i Net Services Administrators Guide for moreinformation on Oracle networking.

System-Level Configuration File User-Level Configuration File

sqlnet.ora $HOME/.sqlnet.ora

tnsnames.ora $HOME/.tnsnames.ora


40/44

Oracle Protocol Support


Oracle Protocol SupportOracle protocol sup por t is a compon ent of Oracle Net. It includ es TCP/ IP protocol

support.

The TCP/ IP protocol supp ort has an add ress specification that is used in O racle Net

Services configuration files and in the DISPATCHER initialization par ameter in the

initsid.ora file. The following section describes the address specifications for eachof the protocol supports.

TCP/IP Protocol SupportTCP/ IP is the standard commu nication protocol used for client/ server

commun ication over a netw ork. The TCP/ IP protocol supp ort enables commu nication

between client p rograms and the Oracle9i server, whether th ey are installed on the

same or d ifferent systems. If the TCP/ IP protocol is installed on your system, the

TCP/ IP protocol sup port is installed and linked to all client tools and to Oracle9i.

The TCP/ IP protocol supp ort requires an add ress specification in the followingformat:

(ADDRESS =(PROTOCOL=TCP)(HOST=hostname)(PORT=port)

)

The following tab le describes the param eters used in this add ress specification:

The following show s a samp le TCP/ IP protocol add ress:

(ADDRESS=(PROTOCOL=TCP)(HOST=MADRID)(PORT=1521)

)

See Also: Oracle9i Net Services Administrators Guide for more

information on Oracle protocol support.

Parameter Description

P ROTOCOL Th e p rotocol su pp or t to be u sed . Th e valu e is TCP. It is n ot ca sesensitive.

HOST The host name or the host IP address.

PORT The TCP/ IP port. Specify the port as either a number or the aliasname mapp ed to the port in the /STCPservices file. Oraclerecommends a value of 1521.


41/44

Oracle9i Components A-1

AOracle9iComponents

This app endix describes the prod ucts included with Oracle9i:

Oracle9i Client Comp onents

Product Descriptions

Oracle9iClient ComponentsThe following sections provide inform ation on th e Oracle9i Client components.

Runtime EditionThe following alphabetically lists the compon ents available with each insta llation typ e

of the Oracle9i Client Run time top-level comp onent. Refer to the release notes for you r

platform for updates on component availability.

SQL*Plus

Oracle Net

Administrator EditionOracle9i Client Ad ministrator includes the comp onent s in the Oracle9i Client Runtim e,

and the following compon ents. Refer to the release notes for your p latform for upd ates

on comp onent availability.


Oracle Net, includ ing Oracle Protocol Supp ort

Pro*C/ C++ 9.2.0.4.0

Pro*COBOL 1.8.77

Pro*COBOL 9.2.0.4.0

Product DescriptionsThe following table, Table A1, provides d escriptions and release num bers for

prod ucts available for installation. Some p rodu cts described are au tomatically

installed with other p rodu cts. Refer to the release notes for you r platform for up da tes

on comp onent availability.


42/44

Product Descriptions

A-2 Installation and Configuration Guide

Table A1 Product Descriptions

Product Release DescriptionFor moreinformation, see...

Oracle CallInterface

9.2.0.4.0 Oracle Call Interface is an Application ProgrammingInterface (API) for accessing an Oracle databasefrom a C or C++ program.

Oracle Call InterfaceProgrammers Guide

Oracle N et Services 9.2.0.4.0 Oracle Net Services provides products that enableclient connections to databases across a network. Aclient-side application sends a request to Oracle NetServices to be tran sported across the network to theserver.

Oracle Net Services installs TCP/ IP and Nam edPipes.

Oracle NetAdministrators Guide

Pro*C/C++ 9.2.0.4.0 Pro*C/ C++ takes SQL statements embedded in Cand C++ programs and converts them to standard Ccode. When you precompile this code, the result is aC or C++ program that you can compile and use tobuild ap plications that access an Oracle database.

Note: This produ ct requires a separate license as a

part of Oracle Programmer.

Pro*C/C++PrecompilerProgrammers Guide

Pro*COBOL 1.8.77

9.2.0.4.0

Pro*COBOL takes SQL statements embedded in aCOBOL program an d converts them to stand ardCOBOL code. When you precompile this code, theresult is a COBOL program you can comp ile and useto build app lications that access an Oracle database.

Note: This produ ct requires a separate license as apart of Oracle Programmer.

Pro*COBOLPrecompilerProgrammers Guide

SQL*Plus 9.2.0.4.0 SQL*Plus is a command line interface that enablesyou to use SQL and PL/ SQL database languageswith an Oracle database.

SQL*Plus Users

Guide and Reference

TCP/IP ProtocolSupport

9.2.0.4.0 TCP/ IP Protocol Suppor tenables client/ serverconversation over a network using TCP/ IP and

Oracle Net. This combination of Oracle productsenables an Oracle application on a client tocommun icate with remote Oracle databases throughTCP/ IP (if the Oracle database is running on a h ostsystem that supports network comm unication usingTCP/ IP).

Oracle NetAdministrators Guide


43/44

Index-1

Index

A

administering command line SQL, 4-1

C

C

Pro*C/ C++, 5-2

catching routine, 5-6

exam ple, 5-6

configuration files

Oracle Net , 6-1

Oracle Net Services, 6-1

precompiler, 5-1

D

debugger programs, 5-2

demonstration programs

oracle call interface, 5-5

Pro*C/ C++, 5-3

dem onstration tables

creating manually, 4-2

delet ing, 4-2

directories

permissions , 3-1

documentation

on administration and tuning, 0-x

on migrating and upgrading from p revious

release, 0-x

r elated , 0-x

E

environment va riables

TNS_ADMIN, 6-1

F

files

login fi les, 3-2

permissions , 3-1

p rofile, 3-2

G

glogin.sql file, 4-1

I

initialization files, 3-2

installation

Oracle Internet Directory, 0-x

Oracle Workflow, 0-x

post-installation tasks, 3-1

pre-installation tasks, 1-1

installation types

with Oracle9i Clien t, A-1

interrupting SQL*Plus, 4-5

ireclen , 5-2

L

login fi les, 3-2

login.sql file, 4-1

M

multiple signal handlers, 5-6

O

OCI. See Oracle Call Interface


d efin ed , A-2

installation types available with

oracle call interface, 5-5

demonstrat ion programs, 5-5

Oracle Net Client

installation types available with, A-1

Oracle Net configuration files, 6-1

Oracle Net Services

d efin ed , A-2

protocol support , 6-2

protocols, 6-2

Oracle Net Services configuration files, 6-1

oracle precomp iler and OCI linking and makefiles

custom makefi les, 5-5

Oracle Precompilers, post-installation tasks, 3-3

Oracle Protocol Support, A-1

oracle user

post-installation tasks, 3-2

Oracle9i Client top-level component, installation

types available with, A-1

oreclen , 5-2


44/44

9iclient-insadmin-92040-134471

Documents

Transcript of 9iclient-insadmin-92040-134471