Notas sobre o Release

37.1 db2ArchiveLog (nova API)

db2ArchiveLog

Fecha e trunca o arquivo de log ativo de um banco de dados recuperável. Se a saída do usuário estiver ativada, emite um pedido de archive.

Autorização

Um dos seguintes:

Conexão Requerida

Essa API estabelece automaticamente uma conexão com o banco de dados especificado. Se já existir uma conexão com o banco de dados especificado, a API retorna um erro.

Arquivo de Inclusão da API

db2ApiDf.h

Sintaxe da API C 



/* Arquivo: db2ApiDf.h */
/* API:  Archive Active Log */
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

Sintaxe da API Genérica 



/* Arquivo: db2ApiDf.h */
/* API:  Archive Active Log */
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 da API

versão
Entrada. Especifica a versão e o nível do release da variável transmitida como segundo parâmetro, pDB2ArchiveLogStruct.

pDB2ArchiveLogStruct
Entrada. Um indicador para a estrutura db2ArchiveLogStruct.

pSqlca
Saída. Um indicador para a estrutura sqlca.

iAliasLen
Entrada. Um número inteiro de 4 bytes não sinalizado, representando o comprimento em bytes do alias do banco de dados.

iUserNameLen
Um número inteiro de 4 bytes não sinalizado, representando o comprimento em bytes do nome do usuário. Definido como zero se não for utilizado um nome do usuário.

iPasswordLen
Entrada. Um número inteiro de 4 bytes não sinalizado, representando o comprimento em bytes da senha. Definido como zero se não for utilizada senha.

piDatabaseAlias
Entrada. Uma cadeia contendo o alias do banco de dados (conforme catalogado no diretório do banco de dados do sistema) para o qual o log ativo deve ser arquivado.

piUserName
Entrada. Uma cadeia contendo o nome do usuário a ser utilizado ao tentar uma conexão.

piPassword
Entrada. Uma cadeia que contém a senha a ser utilizada durante uma tentativa de conexão.

iAllNodeFlag
Somente MPP. Entrada. Sinalizador indicando se a operação deve se aplicar a todos os nós listados no arquivo db2nodes.cfg. Os valores válidos são:

DB2ARCHIVELOG_NODE_LIST
Aplica-se aos nós em uma lista de nós que é transmitida em piNodeList.

DB2ARCHIVELOG_ALL_NODES
Aplicado em todos os nós. piNodeList deve ser NULO. Esse é o valor padrão.

DB2ARCHIVELOG_ALL_EXCEPT
Aplica-se a todos os nós, exceto na lista de nós passada em piNodeList.

iNumNodes
Somente MPP. Entrada. Especifica o número de nós na matriz piNodeList.

piNodeList
Somente MPP. Entrada. Um ponteiro para uma matriz de números de nós contra o qual aplica-se a operação de log do archive.

iOptions
Entrada. Reservado para uso futuro.

[ Início da Página | Página Anterior | Próxima Página | Índice | Índice Remissivo ]