Notas sobre o Release
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:
- sysadm
- sysctrl
- sysmaint
- dbadm
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 ]