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.
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--)--;-----------------------><
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 |
Trata-se de um argumento opcional, mas tem que ser especificado se release for especificado.
Trata-se de um argumento opcional, mas tem que ser especificado se uow for especificado.
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:
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.
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:
Os valores para y, a opção de desconexão automática, são:
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.
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.
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.
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. |
EZECONCT('scalia','justs4u','dojhost','goodz','4.0','D1C');