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()

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.