Skip Headers
Oracle® Database Administrator's Reference
10g Release 2 (10.2) for UNIX-Based Operating Systems

Part Number B15658-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
Go to next page
Next
View PDF

7   SQL*Loader and PL/SQL Demonstrations

This chapter describes how to build and run the SQL*Loader and PL/SQL demonstration programs available with Oracle Database. It contains the following sections:


Note:

To use the demonstrations described in this chapter, you must install the Oracle Database Examples included on the Oracle Database 10g Companion CD.

You must also unlock the SCOTT account and set the password before creating the demonstrations.


7.1 SQL*Loader Demonstrations

Run the ulcase.sh file to run the SQL*Loader demonstrations. To run an individual demonstration, read the information contained in the file to determine how to run it.

7.2 PL/SQL Demonstrations

PL/SQL includes a number of demonstration programs. You must build database objects and load sample data before using these programs. To build the objects and load the sample data:

  1. Change directory to the PL/SQL demonstrations directory:

    $ cd $ORACLE_HOME/plsql/demo
    
    
  2. Start SQL*Plus, and connect as SCOTT/TIGER:

    $ sqlplus SCOTT/TIGER
    
    
  3. Run the following commands to build the objects and load the sample data:

    SQL> @exampbld.sql
    SQL> @examplod.sql
    
    

    Note:

    Build the demonstrations as any Oracle user with sufficient privileges. Run the demonstrations as the same Oracle user.

PL/SQL Kernel Demonstrations

The following PL/SQL kernel demonstrations are available with the software:

To compile and run the exampn.sql or samplen.sql PL/SQL kernel demonstrations:

  1. Start SQL*Plus, and connect as SCOTT/TIGER:

    $ cd $ORACLE_HOME/plsql/demo
    $ sqlplus SCOTT/TIGER
    
    
  2. Run a command similar to the following to run a demonstration, where demo_name is the name of the demonstration:

    SQL> @demo_name
    
    

To run the extproc.sql demonstration:

  1. If required, add an entry for external procedures to the tnsnames.ora file, similar to the following:

    EXTPROC_CONNECTION_DATA =
       (DESCRIPTION =
           (ADDRESS_LIST = 
              (ADDRESS=(PROTOCOL = IPC)( KEY = EXTPROC))
           )
           (CONNECT_DATA = 
              (SID = PLSExtProc)
           )
        )
    
    
  2. If required, add an entry for external procedures to the listener.ora file, similar to the following:


    Note:

    The value that you specify for SID_NAME in the listener.ora file must match the value that you specify for SID in the tnsnames.ora file.

    • On HP-UX, Linux, Solaris, and Tru64 UNIX:

      SID_LIST_LISTENER = 
        (SID_LIST = 
           (SID_DESC=
              (SID_NAME=PLSExtProc)
              (ORACLE_HOME=oracle_home_path)
              (ENVS=EXTPROC_DLLS=oracle_home_path/plsql/demo/extproc.so,
                 LD_LIBRARY_PATH=oracle_home_path/plsql/demo)
              (PROGRAM=extproc)
            )
          )
      
      
    • On AIX:

      SID_LIST_LISTENER = 
        (SID_LIST = 
           (SID_DESC=
              (SID_NAME=PLSExtProc)
              (ORACLE_HOME=oracle_home_path)
              (ENVS=EXTPROC_DLLS=oracle_home_path/plsql/demo/extproc.so,
                 LIBPATH=oracle_home_path/plsql/demo)
              (PROGRAM=extproc)
            )
          )
      
      
    • On Mac OS X:

      SID_LIST_LISTENER = 
        (SID_LIST = 
           (SID_DESC=
              (SID_NAME=PLSExtProc)
              (ORACLE_HOME=oracle_home_path)
              (ENVS=EXTPROC_DLLS=oracle_home_path/plsql/demo/extproc.dylib,
                 DYLD_LIBRARY_PATH=oracle_home_path/plsql/demo)
              (PROGRAM=extproc)
            )
          )
      
      
  3. Change directory to $ORACLE_HOME/plsql/demo.

  4. Run the following command to create the extproc.so shared library, build the required database objects, and load the sample data:


    Note:

    On Mac OS X systems, use the shared library name extproc.dylib in the following examples.

    $ make -f demo_plsql.mk extproc.so exampbld examplod
    
    

    Alternatively, if you have already built the database objects and loaded the sample data, then run the following command:

    $ make -f demo_plsql.mk extproc.so
    
    
  5. From SQL*Plus, run the following commands:

    SQL> CONNECT SYSTEM/SYSTEM_password
    SQL> GRANT CREATE LIBRARY TO SCOTT;
    SQL> CONNECT SCOTT/TIGER
    SQL> CREATE OR REPLACE LIBRARY demolib IS
      2  'oracle_home_path/plsql/demo/extproc.so';
      3  /
    
    
  6. To start the demonstration, run the following command:

    SQL> @extproc
    

PL/SQL Precompiler Demonstrations


Note:

The make commands shown in this section build the required database objects and load the sample data in the SCOTT schema.

The following precompiler demonstrations are available:

To build the PL/SQL precompiler demonstrations, set the library path environment variable to include the $ORACLE_HOME/lib directory, and run the following commands:

$ cd $ORACLE_HOME/plsql/demo
$ make -f demo_plsql.mk demos

To build a single demonstration, run its name as the argument in the make command. For example, to build the examp9 demonstration, run the following command:

$ make -f demo_plsql.mk examp9

To start the examp9 demonstration, run the following command:

$ ./examp9

7.3 Calling 32-Bit External Procedures from PL/SQL


Note:

This section applies to AIX, HP-UX, Solaris SPARC, and zSeries Linux.

The 64-bit external procedure executable (extproc) and the 32-bit external procedure executable (extproc32) are installed in the $ORACLE_HOME/bin directory. By default, the extproc executable is enabled to run 64-bit external procedures on AIX, HP-UX, Solaris SPARC, and zSeries Linux systems. To enable 32-bit external procedures:

  1. Set the value of the PROGRAM parameter in the listener.ora file as follows:

    (PROGRAM=extproc32)
    
    
  2. Include the $ORACLE_HOME/lib32 directory in one of the following environment variables, depending on your platform:

    Platform Environment Variable
    AIX LIBPATH
    HP-UX SHLIB_PATH
    zSeries Linux and Solaris LD_LIBRARY_PATH

  3. Restart the listener.


    Note:

    You can configure a listener to run either 32-bit or 64-bit external procedures, but not both at the same time. However, you can configure two listeners if you have to support both 32-bit and 64-bit external procedures.