defineDatabaseAlias()

La función del sistema SysLib.defineDatabaseAlias crea un alias que puede utilizarse para establecer una conexión nueva con una base de datos a la que el código ya está conectado. Una vez establecido, el alias puede utilizarse en cualquiera de estas funciones:

El alias también puede utilizarse en el campo connectionName de una variable de tipo ReportData.

  SysLib.defineDatabaseAlias(
    alias STRING in,
    baseDatos STRING in)
alias
Un literal de serie o una variable que actúa como alias de la conexión identificada en el segundo parámetro. El alias no es sensible a las mayúsculas/minúsculas.
base de datos
Un nombre de base de datos especificado en SysLib.connect o VGLib.connectionService. Utilice un literal o variable de un tipo de carácter.

Si no especifica una conexión, la función afecta a la conexión actual.

Ejemplos:
  // Conectar con una base de datos con el alias "alias", 
  // que se convierte en la conexión actual.
  defineDatabaseAlias( "alias", "database" );
  connect( "alias", "user", "pwd" );

  // Hacer dos conexiones con la misma base de datos.
  String db = "database";
  defineDatabaseAlias( "alias1", db );
  defineDatabaseAlias( "alias2", db );
  connect( "alias1", "user", "pwd" );
  connect( "alias2", "user", "pwd" );

  // Otra forma de hacer dos conexiones 
  // con la misma base de datos.
  defineDatabaseAlias( "alias", "database" );
  connect( "alias", "user", "pwd" );
  connect( "database", "user", "pwd" );

  // Una alias definido pero no usado. El segundo 
  // connect() no crea una conexión nueva.
  defineDatabaseAlias( "alias", "database" );
  connect( "database", "user", "pwd" );
  connect( "database", "user", "pwd" );

  // Utilización de alias (no sensible a mayús./minús.)
  // al desconectar.   
  defineDatabaseAlias( "alias", "database" );
  connect( "aLiAs", "user", "pwd" );
  disconnect( "ALIAS" );

  // La llamada a disconnect siguiente falla porque 
  // la conexión se llama "alias" no "database".
  defineDatabaseAlias( "alias", "database" );
  connect( "alias", "user", "pwd" );
  disconnect( "database" );

  // Un alias puede cambiar. Después de la llamada siguiente 
  // "alias" hace referencia a "firstDatabase" 
  defineDatabaseAlias( "alias", "firstDatabase" );

  // Después de la llamada siguiente 
  // "alias" hace referencia a "secondDatabase".  
  defineDatabaseAlias( "alias", "secondDatabase" );

  // La última llamada habría fallado 
  // si hubiera una conexión con "alias".

Conceptos relacionados
Diagrama de sintaxis para funciones EGL
Soporte de SQL

Consulta relacionada
beginDatabaseTransaction()connect()
disconnect()
setCurrentDatabase()
connectionService()

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.