Auxílios do VisualAge Generator

EZECONCT

EZECONCT controla a unidade de trabalho do banco de dados em programas VisualAge Generator. EZECONCT permite ao programa conectar, desconectar e ativar conexões de bancos de dados.

Usos

Você pode utilizar EZECONCT como o nome de função em uma instrução de chamada da função.

A seguir a seqüência de chamada para EZECONCT:

>>-EZECONCT---(--userid--,---password--,---servername--,-------->
 
>----product--,---release--,---uow--)--;-----------------------><
 

userid
Identificador do usuário do banco de dados (item de dados CHA de 8 bytes). Consulte "Considerações sobre autorização", no documento VisualAge Generator Design Guide para obter mais informações sobre opções para especificação de um ID do usuário e senha para programas da estação de trabalho.

password
Password do banco de dados (item de dados CHA de 8 bytes).

nome do servidor
Um nome de servidor de programa de banco de dados (item de dados CHA de 18 bytes).

Para MVS, este argumento contém um dos seguintes:

Para outros sistemas, ele contém o nome do servidor de programa para as solicitações de banco de dados.

Tabela 5. Os argumento permitidos na chamada de EZECONCT

Argumentos Conexão
O nome do servidor contém RESET Reconecta a banco de dados padrão (DB2 CONNECT RESET); preenche produto e release com informações sobre o servidor
O nome do servidor não está em branco, mas não contém RESET Conecta servidor especificado (DB2 CONNECT TO); preenche produto e release com informações sobre o servidor
O nome do servidor está em branco Faz consulta quanto ao produto e nível de release do servidor (DB2 CONNECT); preenche produto e release com informações sobre o servidor

produto
Um nome de produto de banco de dados (item CHA de 8 bytes). O nome do produto de banco de dados atualmente conectado retorna a esse campo se o nome do servidor estiver em branco.

Trata-se de um argumento opcional, mas tem que ser especificado se release for especificado.

release
Um nível de release de produto de banco de dados (item CHA de 8 bytes). O nível da release do produto de banco de dados atualmente conectado é retornado nesse campo se o nome do servidor estiver em branco.

Trata-se de um argumento opcional, mas tem que ser especificado se uow for especificado.

uow
Opção de conexão da unidade de trabalho (item ou literal CHA).

R
Conexão Tipo 1, Unidade de Trabalho Remota (padrão).

Executa uma conexão de tipo 1 ao banco de dados identificado no parâmetro nome do servidor. Somente um banco de dados pode ser conectado por vez; EZECOMIT ou EZEROLLB devem ser emitidos antes da conexão a outro banco de dados. A conexão a outro banco de dados encerra uma conexão existente. Todos os cursores são fechados quando a conexão ocorre.

Se nome do servidor for RESET, um CONNECT RESET é executado. Isso resulta em uma operação de commit e uma desconexão do servidor atual.

A unidade de trabalho remota deverá ser utilizada se os gerenciadores de banco de dados estiverem nos seguintes níveis:

  • DB2 Versão 2
  • DB2/6000 Versão 1
  • DataJoiner Versão 1

Use unidade de trabalho remota sempre que o seu projeto de programa permitir. A unidade de trabalho remota é mais eficiente do que as conexões de unidade de trabalho distribuída.

Dxy
Conexão Tipo 2, Unidade de Trabalho Distribuída

Executa uma conexão de tipo 2 ao banco de dados identificado no parâmetro nome do servidor; x e y especificam ponto de sincronização de conexão e opções de desconexão automática.

Com conexões de tipo 2, múltiplas conexões podem ser feitas dentro de uma unidade de trabalho individual. A conexão a outro banco de dados não encerra conexões anteriores. Os cursores não são fechados quando outra conexão ocorre.

Os valores para x, a opção de ponto de sincronização, são os seguintes:

1
Commit de uma fase, somente um banco de dados pode ser atualizado dentro da unidade de trabalho. Use o commit de uma fase se o projeto do seu programa permitir; um commit de uma fase não possui o overhead associado com um commit de duas fases.
2
Commit de duas fases, vários bancos de dados podem ser atualizados dentro da unidade de trabalho.

Os valores para y, a opção de desconexão automática, são:

A
A desconexão é automática. A conexão é desconectada após um commit ou um retrocesso.
C
A desconexão automática é condicional. As conexões que não possuem cursores WITH HOLD abertos são desconectadas no commit ou retrocesso.
E
A desconexão deve ser explicitamente solicitada. A conexão permanece ativa após um commit ou retrocesso. Uma solicitação de desconexão deve ser emitida explicitamente pelo programa para que os recursos de conexão sejam liberados.

Especificando-se RESET para o nome do servidor equivale a uma conexão explícita ao banco de dados DB2 padrão nomeado na variável de ambiente DB2DBDFT. Se o banco de dados padrão não estiver disponível, o estado da conexão permanece inalterado.

DISC
Desconectar do banco de dados identificado em nome do servidor.

DCURRENT
Desconectar do banco de dados conectado atualmente.

DALL
Desconectar de todos os bancos de dados conectados atualmente.

SET
Definir a conexão para conexão de banco de dados inoperante.

Considerações sobre Definição para EZECONCT

Siga estas instruções de codificação para evitar erros no SQL quando utilizar EZECONCT:

Siga estas instruções para evitar erros no SQL ao executar um ambiente de teste com alguns pedidos SQL emitidos pelo dispositivo de teste e alguns pelas DLLs C++ nativas geradas chamadas locamente pelo dispositivo de teste:

Em seqüência à chamada EZECONCT,se EZEFEC estiver definido em 1, as palavras de função especial EZESQ serão definidas com valores retornados pela instrução CONNECT.

Conexões-Padrão de Bancos de Dados  Se EZECONCT não for usada, a conexão de banco de dados padrão será do Tipo 1 (unidade remota de trabalho). A especificação do nome do servidor padrão varia de acordo com o ambiente.

O dispositivo de teste verifica o seguinte para o nome do servidor nesta seqüência:

Os programas CICS para OS/2 verificam o seguinte para o nome do servidor nesta seqüência:

Os programas C++ gerados verificam o nome do servidor nesta seqüência:

Em ambientes CICS/MVS, VSE CICS e IMS, o banco de dados padrão é especificado quando o ambiente é configurado.

Em programas VM, MVS/TSO, MVS batch e VSE batch, o banco de dados padrão é especificado no JCL ou no EXEC usado para iniciar o job. Consulte o manual Execução apropriado ao caso para saber detalhes a respeito.

No OS/400, o banco de dados padrão é o banco de dados DB2/400 no sistema OS/400.

Ambientes de Destino

Ambiente Considerações de compatibilidade
VM CMS CONNECT RESET e UOW (opção de conexão da unidade de trabalho) não são suportadas.

O argumento da password é suportado.

VM batch Igual a VM CMS.
CICS para MVS/ESA Funções de conexão são suportadas pelo DB2 Versão 2 Release 3 ou superior.

O argumento da password é ignorado.

UOW (opção de conexão da unidade de trabalho) não é suportada.

MVS/TSO Igual a CICS para MVS/ESA.
MVS batch Igual a CICS para MVS/ESA.
IMS/VS Igual a CICS para MVS/ESA.
IMS BMP Igual a CICS para MVS/ESA.
CICS para VSE A conexão com outro banco de dados não é suportada. So pode ser usado um banco de dados para cada transação e esse banco de dados é associado à transação nas tabelas CICS.

CONNECT RESET não é suportada.

UOW (opção de conexão da unidade de trabalho) não é suportada.

O argumento da password é ignorado.

VSE batch A conexão com outro banco de dados requer DB2/VSE 3.4 ou superior.

CONNECT RESET não é suportada.

O argumento da password é suportado.

UOW (opção de conexão da unidade de trabalho) não é suportada.

CICS para OS/2 Quando se usa ELARTRDB_tttt ou EZERSQLDB para especificar o nome do banco de dados, o primeiro programa SQL da unidade de execução vai conectar-se ao banco de dados especificado enquanto o programa é inicializado. E depois de uma EZECONCT RESET, o programa irá imediatamente reconectar-se a esse banco de dados.

Se o banco de dados padrão DB2/2 SQL estiver sendo usado, DB2/2 fará uma conexão implícita quando a unidade de execução efetuar sua primeira instrução SQL. O mesmo se aplica depois de uma EZECONCT RESET.

Nota:Como DB2/2 está manipulando a conexão, o modo de acesso padrão especificado em EZERSQLUS não será usado. Todos os bancos de dados conectados por meio de conexão implícita são conectados em modo SHARED.

Para obter mais informações sobre conexão implícita, consulte a documentação do DB2/2.

É necessário DB2/2 Version 2.1 para suporte da password.

UOW (opção de conexão da unidade de trabalho) não é suportada.

OS/400 O argumento da password é ignorado.

UOW (opção de conexão da unidade de trabalho) não é suportada.

OS/2 (GUI) Não suportado.
Windows (GUI) Não suportado.
Java (GUI) Não suportado.
OS/2 (C++) É necessário DB2/2 Versão 2.1 ou superior para suporte da password.
AIX O argumento da password é suportado.
HP-UX O argumento da password é suportado.
CICS for AIX O argumento da password é ignorado.
Solaris Suportado.
CICS for Solaris Suportado.
Windows NT O argumento da password é suportado.
CICS para Windows NT O argumento da password é ignorado.
Dispositivo de Teste Nenhum.

Exemplo de

EZECONCT('scalia','justs4u','dojhost','goodz','4.0','D1C');


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