1. Configuración de las máquinas «clientes»:
DBSERVICE: Nombre del «gateway» para el gestor de la base de datos Oracle. Por ejemplo: «gworacle».
DBHOST: Nombre de la máquina «servidor». Por ejemplo: «unix».
DBUSER: Nombre de usuario para la base de datos que será utilizando para otorgar o revocar privilegios de acceso a la misma. Por ejemplo: «user1».
XDBTEMP: Directorio en el servidor UNIX para la creación de ficheros temporales. Por ejemplo: «/tmp».
DBPASSWD: Palabra clave («password») del usuario UNIX incluido en la variable de entorno DBUSER.
Ejemplo de entorno en máquina cliente:
[Environment oracle]
DBSERVICE=gworacle
DBHOST=nombre_host
DBUSER=user1
XDBTEMP=/tmp
DBPASSWD=clave
Este fichero indica las siguientes características:
2. Configuración del servidor:
La configuración en el servidor se realiza a través del fichero
de configuración de Oracle «gworacle.env». En este fichero
podrán definirse tanto las variables de configuración como,
opcionalmente, las variables de entorno que se indican a continuación,
siendo en este caso prioritario el valor del entorno de usuario.
IMPORTANTE: Todas las variables que se definan en el servidor tendrán que configurarse en el fichero «gworacle.env». Asimismo, las variables ORACLE_HOME, ORACLE_UID y ORACLE_ SID se pueden configurar desde un programa CTL en la máquina «cliente» mediante el método de la clase Module «putenv».
3. Variables de configuración:
ORACLE_PROC: Indica al «gateway» si el gestor de Oracle permite o no la generación de procedimientos SQL. Sus posibles valores son «ON» y «OFF», siendo el primero su valor por defecto.
ORACLE_DECIMAL: Indica el separador decimal utilizado por Oracle. Su valor por defecto es el punto decimal.
DBLONGCHAR: Esta variable indica el número máximo de caracteres que considerará MultiBase para el tipo de datos LONG de Oracle. El valor por defecto asignado a esta variable es «2.000» caracteres.
MBCOMMIT: Indica si ha de hacerse o no un «COMMIT» después de cada instrucción SQL siempre que no haya cursores «FOR UPDATE» abiertos. Los únicos valores que puede tomar son «ON» y «OFF» (por defecto «ON»).
MBLOADCOMMIT: Indica que se producirá un «COMMIT» por cada una de las filas que se inserten con la instrucción de carga de datos LOAD. Sus posibles valores son «ON», «OFF» y «n» (por defecto «OFF»). En el caso de asignar un número «n» a esta variable significará que se hará un «COMMIT» por cada «n» filas que se inserten con la instrucción LOAD.
DBSYN: Define sinónimos del nombre de la base de datos existente en Oracle. Establece la equivalencia entre el nombre de la base de datos de MultiWay con la del gestor de Oracle.
DBSERVER: Indica la versión del servidor a utilizar. Sus posibles valores son «OR60», «OR70» y «OR80» (este último es válido para las versiones 8, 9 y 10 de Oracle).
4. Variables de entorno:
ORACLE_UID: Indica el nombre del usuario
Oracle junto con su correspondiente clave de acceso («password»).
Si el nombre del usuario Oracle y su clave de acceso coinciden con
los del usuario del sistema operativo puede omitirse ORACLE_UID, ya
que por defecto se tomará éste.
ORACLE_SID: Indica el nombre de la base
de datos Oracle.
Para poder utilizar sinónimos de la base de datos habrá que
configurar la variable DBSYN tantas veces como sinónimos existan.
Si no se define ninguna de las dos variables, se considerará como
valor de ORACLE_SID el especificado en la instrucción correspondiente
de conexión a la base de datos del programa MultiBase que vaya
a dialogar con Oracle.
ORACLE_HOME: Indica el directorio donde se encuentra instalado el servidor de la base de datos Oracle (obligatoria).
Ejemplo: Contenido del fichero «gworacle.env» para funcionar en cliente-servidor:
| ORACLE_HOME=/usr/oracle | #Oracle está instalado #en /usr/oracle |
| ORACLE_SID=contabilidad | #La base de datos Oracle se #denomina "contabilidad" |
| ORACLE_UID=jose/jose123 | #Usuario y password Oracle. |
| DBSERVER=OR70 | Versión 7.0 del gestor Oracle |
| DBSYN:conta=contabilidad | #Base de datos "conta" en #MultiWay y "contabilidad" #en Oracle. |