Notas del release

37.1 db2ArchiveLog (nueva API)

db2ArchiveLog

Cierra y trunca el archivo de anotaciones cronológicas activo para una base de datos recuperable. Si la salida de usuario está habilitada, emite una petición de archivado.

Autorización

Uno de los siguientes:

Conexión necesaria

Esta API establece automáticamente una conexión con la base de datos especificada. Si ya hay una conexión con la base de datos especificada, la API devolverá un error.

Archivo de inclusión de API

db2ApiDf.h

Sintaxis de API C 



/* Archivo: db2ApiDf.h */
/* API:  Archivar anotación cronológica activa */
SQL_API_RC SQL_API_FN
   db2ArchiveLog (
      db2Uint32 version,
      void *pDB2ArchiveLogStruct,
      struct sqlca * pSqlca);
 
typedef struct
{
   char                *piDatabaseAlias;
   char                *piUserName;
   char                *piPassword;
   db2Uint16           iAllNodeFlag;
   db2Uint16           iNumNodes;
   SQL_PDB_NODE_TYPE   *piNodeList;  
   db2Uint32           iOptions;
} db2ArchiveLogStruct

Sintaxis de API genérica 



/* Archivo: db2ApiDf.h */
/* API:  Archivar anotación cronológica activa */
SQL_API_RC SQL_API_FN
   db2gArchiveLog (
      db2Uint32 version,
      void *pDB2ArchiveLogStruct,
      struct sqlca * pSqlca);
 
typedef struct
{
   db2Uint32           iAliasLen;
   db2Uint32           iUserNameLen;
   db2Uint32           iPasswordLen;
   char                *piDatabaseAlias;
   char                *piUserName;
   char                *piPassword;
   db2Uint16           iAllNodeFlag;
   db2Uint16           iNumNodes;
   SQL_PDB_NODE_TYPE   *piNodeList;  
   db2Uint32           iOptions;
} db2ArchiveLogStruct

Parámetros de API

version
Entrada. Especifica la versión y el nivel de release de la variable que se pasa como segundo parámetro, pDB2ArchiveLogStruct.

pDB2ArchiveLogStruct
Entrada. Puntero hacia la estructura db2ArchiveLogStruct.

pSqlca
Salida. Puntero hacia la estructura sqlca.

iAliasLen
Entrada. Entero no firmado de 4 bytes que representa la longitud en bytes del alias de base de datos.

iUserNameLen
Entero no firmado de 4 bytes que representa la longitud en bytes del nombre de usuario. Establézcalo en cero si no se utiliza nombre de usuario.

iPasswordLen
Entrada. Entero no firmado de 4 bytes que representa la longitud en bytes de la contraseña. Establézcalo en cero si no se utiliza contraseña.

piDatabaseAlias
Entrada. Serie que contiene el alias de base de datos (tal como se ha catalogado en el directorio de bases de datos del sistema) de la base de datos para la que deberá archivarse la anotación cronológica activa.

piUserName
Entrada. Serie que contiene el nombre de usuario que se utilizará al intentar realizar una conexión.

piPassword
Entrada. Serie que contiene la contraseña que se utilizará al intentar realizar una conexión.

iAllNodeFlag
Sólo MPP. Entrada. Distintivo que indica si la operación se debe aplicar a todos los nodos listados en el archivo db2nodes.cfg. Los valores válidos son:

DB2ARCHIVELOG_NODE_LIST
Aplicar a los nodos de una lista de nodos que se pasa en piNodeList.

DB2ARCHIVELOG_ALL_NODES
Aplicar a todos los nodos. piNodeList debe ser NULL. Este es el valor por omisión.

DB2ARCHIVELOG_ALL_EXCEPT
Aplicar a todos los nodos excepto aquellos de la lista de nodos que se ha pasado en piNodeList.

iNumNodes
Sólo MPP. Entrada. Especifica el número de nodos del conjunto piNodeList.

piNodeList
Sólo MPP. Entrada. Puntero hacia un conjunto de números de nodo a los que se aplicará la operación archive log.

iOptions
Entrada. Reservado para su utilización en el futuro.

[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]