IBM i Access para Windows: Administração

(1)

IBM i

IBM i Access para Windows: Administração

7.1

(2)

(3)

IBM i

IBM i Access para Windows: Administração

7.1

(4)

Nota

Antes de utilizar essas informações e o produto suportado por elas, leia as informações em “Avisos”, na página 155.

Esta edição aplica-se ao IBM i 7.1 do IBM i Access para Windows 5770-XE1 e a todos os releases e modificações subsequentes, até que seja indicado de outra forma em novas edições. Esta versão não é executada em todos os

| |

(5)

Índice

IBM i Access para Windows:

Administração . . . 1

O que Há de Novo no IBM i 7.1 . . . 1 Arquivo PDF para IBM i Access para Windows: Administração . . . 2 Ambientes de Rede do IBM i Access para Windows . 2 Microsoft Windows Terminal Server . . . 3 Usar o IBM i Access para Windows em um

Ambiente de Três Camadas . . . 3 Incluir Configuração TCP/IP em Todos os

Usuários . . . 6 Definir Local de Arquivos do PC5250 para Todos os Usuários . . . 7 Perfis de Usuário para PCs com Vários Usuários . 8 Administração do ODBC . . . 8 Visão Geral do Driver ODBC do IBM i Access . . 8 Configurar o sistema para o driver ODBC do IBM i Access . . . 10 Segurança de ODBC do IBM i Access para

Windows . . . 12 Resolução de Problemas do ODBC . . . 15

Administração do Servidor Host . . . 28 Identificar Servidores Host do IBM i e Programas Associados. . . 29 Usar Servidores Host do IBM i . . . 40 Utilizar Programas de Saída do Servidor . . . 66 Administração do IBM i NetServer . . . 104 Restringir Usuários com Políticas e Administração de Aplicativo . . . 104

Visão Geral de Políticas do IBM i Access para Windows . . . 105 Tipos e Escopos de Políticas . . . 106 Configurar o Sistema para Utilizar Políticas . . 107 Lista de Políticas do IBM i Access para

Windows . . . 110 Administração do SSL (Secure Sockets Layer) . . 152

Apêndice. Avisos. . . 155

Informações sobre a Interface de Programação . . 157 Marcas Registradas . . . 157 Termos e Condições . . . 157

(6)

(7)

IBM i Access para Windows: Administração

Use este tópico para administrar o IBM®i Access para Windows®em seu ambiente de cliente/servidor.

Estas informações assumem que você esteja familiarizado com o IBM i Access para Windows e tenha instalado-o em seu sistema.

Escolha entre os seguintes tópicos de administração para obter informações adicionais necessárias sobre o IBM i Access para Windows:

Nota: Utilizando os exemplos de código, você concorda com os termos do “Informações sobre o Código de Licença e Renúncia” na página 153.

Informações relacionadas

Introdução ao IBM i Access para Windows Instalação e Configuração

Programação para o IBM i Access para Windows

O que Há de Novo no IBM i 7.1

Novas funções de administração do IBM i Access para Windows estão disponíveis para este release. Com a instalação do IBM i 7.1, é possível gerenciar seu ambiente por meio das novas funções do IBM i Access para Windows que foram incluídas nos provedores de banco de dados e por meio de outros aprimoramentos do produto. Isso inclui:

v _{Os arquivos de ajuda do IBM i Access para Windows foram convertidos em formato de ajuda html.} Não é mais necessário um download separado em sistemas operacionais Windows Vista e mais recentes para exibir a ajuda

v _{Emulação de Exibição PC5250 e de Impressora atualizada com base no Personal Communications 5250,} versão 6.0.

v _{Consulte a coleta de tópico Programação do IBM i Access para Windows para obter uma lista de novas} funções que estão disponíveis ao usar os provedores de dados .NET, OLE DB e ODBC

Nota:

O Centro de Informações do IBM i (www.ibm.com/systems/i/infocenter) permanece a origem primária para conceitos básicos, referência e informações de tarefas do produto IBM i Access para Windows. A página inicial do IBM i Access pode conter detalhes sobre aprimoramentos que não estão documentados em outros locais.

Outras Informações

Depois de instalar o IBM i Access para Windows, use este caminho a partir da pasta do IBM i Access para Windows para acessar o Guia do Usuário: Iniciar → Programas → IBM i Access para Windows →

Guia do Usuário.

As APIs de Banco de Dados C/C++ (APIs SQL otimizadas) não estão mais sendo aprimoradas ou suportadas. Consulte o Kit de Ferramentas do Programador para obter outras tecnologias que você pode usar para acesso de banco de dados.

Os sistemas operacionais Windows 2000 e Windows Server 2000 não são suportados com o produto IBM i Access para Windows 7.1.

| |

(8)

O suporte para processadores Itanium®de 64 bits foi removido.

Como Saber o Que É Novo ou o Que Foi Alterado

Para ajudar a ver onde as alterações técnicas foram feitas, estas informações utilizam: v _{A imagem} _{marca onde começam as informações novas ou alteradas.}

v _{A imagem} _{marca onde terminam as informações novas ou alteradas.}

Nos arquivos PDF, você poderá ver barras de revisão (|) na margem esquerda das informações novas ou alteradas.

Para localizar outras informações sobre o que há de novo ou foi alterado neste release, consulte o Memorando para Usuários.

Programação .NET Programação OLE DB

Novidades do System i Navigator na V6R1

Arquivo PDF para IBM i Access para Windows: Administração

É possível visualizar e imprimir um arquivo PDF destas informações.

Para visualizar ou fazer download da versão PDF deste documento, selecione Administrar IBM i Access para Windows (aproximadamente 550 KB).

Salvando Arquivos PDF

Para salvar um PDF em sua estação de trabalho para exibição ou impressão:

1. Em seu navegador, clique com o botão direito do mouse no PDF (clique com o botão direito no link anterior).

2. Clique em Salvar Destino Como se estiver utilizando o Internet Explorer. Clique em Salvar Link

Comose estiver utilizando o Netscape Communicator. 3. Navegue até o diretório no qual deseja salvar o PDF. 4. Clique em Salvar.

Fazendo Download do Adobe

®

Acrobat Reader

É necessário o Adobe Acrobat Reader para visualizar ou imprimir esses PDFs. É possível fazer download de uma cópia a partir do Web site da Adobe (www.adobe.com/products/acrobat/readstep.html) .

Ambientes de Rede do IBM i Access para Windows

Administre vários usuários de PC e torne os serviços do sistema disponíveis em diferentes ambientes de rede.

Este tópico identifica alguns dos ambientes de rede nos quais o IBM i Access para Windows pode operar. É possível disponibilizar serviços do IBM i para seus clientes usando o IBM i Access para Windows em um ambiente de três camadas, ou instalando-o sobre uma versão do sistema operacional Windows que fornece suporte para logon remoto usando o Terminal Services. É possível administrar um PC que tenha vários usuários designados a ele.

Escolha entre os tópicos abaixo para obter informações sobre vários métodos fornecidos para usuários |

(9)

típica direta entre um PC e um sistema operacional, no entanto, o uso do ambiente do Microsoft® Windows Terminal Server Edition (TSE) ou o uso do IBM i Access para Windows em um ambiente de três camadas permite tirar vantagem de outros ambientes de rede.

Escolha também entre os tópicos abaixo para administrar PCs com vários usuários usando o IBM i Access para Windows.

Microsoft Windows Terminal Server

Usar recursos do Microsoft Windows Terminal Server com o IBM i Access para Windows.

Microsoft Windows Terminal Server é um recurso que permite a execução de sessões do cliente múltiplas e simultâneas em um único servidor Windows. Ele permite conexões de várias plataformas cliente, incluindo não apenas Windows, mas estações de rede, UNIX®_{, Linux}®_{, DOS, OS/2 e outras. Instalando o}

IBM i Access para Windows em um servidor Windows que fornece este recurso, estações de trabalho que não possuem o IBM i Access para Windows instalado podem acessar serviços do IBM i.

Nota: Configure Quando verificar o nível de serviço como Nunca na guia Serviço das Propriedades do IBM i Access para Windows ao executar o Terminal Services.

Para obter informações sobre instalação, suporte, problemas conhecidos e soluções ao usar o IBM i Access para Windows com um Microsoft Windows Terminal Server, consulte o APAR II11373.

Para obter mais informações sobre o Terminal Services em um servidor Windows, consulte a documentação ou o Web site da Microsoft.

APAR II11373

Usar o IBM i Access para Windows em um Ambiente de Três Camadas

Uma ampla variedade de estações de trabalho do cliente podem acessar serviços do IBM i por meio de funções do IBM i Access para Windows quando o produto é instalado na camada intermediária de um ambiente de três camadas.

Além disso, ambientes de três camadas apresentam diversas outras vantagens:

v _{Integração aprimorada entre diversos clientes e aplicativos de servidor:}_{múltiplos aplicativos de} usuário final em execução em vários clientes podem se comunicar com múltiplos aplicativos em um servidor Windows simultaneamente. Cada aplicativo no servidor Windows também pode,

simultaneamente, se comunicar com múltiplos bancos de dados.

v _{Gerenciamento de transação aperfeiçoado utilizando o MTS (Microsoft Transaction Server):}

ambientes de três camadas permitem transações mais complexas, algumas das quais podem depender umas das outras para sua própria conclusão com êxito. (Para que cada transação seja concluída, todas deverão ser concluídas com êxito.)

v _{Importando dados do IBM i para páginas da Web, usando o Microsoft Internet Information Server}

(IIS):o IIS pode usar Active Server Pages para atualizar dinamicamente páginas da Web com dados do DB2 para IBM i.

Todos os ambientes de três camadas separam os componentes e os aplicativos em três camadas. As três camadas podem residir em PCs, ou terminais, separados e se comunicam por uma rede. Geralmente, as três terão as seguintes características:

Camada do Cliente

Essa camada contém a interface e os aplicativos que permitem que os usuários finais manipulem os dados. Por exemplo, isso pode envolver um navegador da Web em execução em uma estação de rede ou |

(10)

um aplicativo integrado e personalizado utilizando um componente remoto. Esta camada não usa o cliente IBM i Access para Windows.

Camada Intermediária

Essa camada contém a lógica de negócio ou aplicativo. Em ambientes do IBM i Access para Windows, esta camada deve consistir em um servidor Windows que executa um script Microsoft Active Server Pages ou um componente remoto.

Esta camada usa o Microsoft Internet Information Server (IIS) e pode, opcionalmente, usar Serviços de Componente ou o Microsoft Transaction Server para transações distribuídas. O script usa o provedor ADO.NET, o provedor OLE DB ou o driver ODBC incluídos com o IBM i Access para Windows. Estes clientes comunicam-se com a camada de banco de dados para obter os dados do banco de dados DB2 para IBM i.

Consulte os tópicos a seguir para obter mais informações sobre a camada intermediária: v _{Utilizar o MTS (Microsoft Transaction Server).}

v _{Acessar Serviços do IBM i a partir da Camada Intermediária}

Camada do Banco de Dados

Esta camada geralmente consiste em um banco de dados DB2 para IBM i. Seus aplicativos podem acessar este e vários serviços do IBM i por meio de programas do servidor host ou de programas IBM i

personalizados pelo cliente.

Utilizando Suporte de Transações Distribuídas

O cliente IBM i Access para Windows suporta o Microsoft Transaction Server (MTS) e o modelo de Serviços de Componente, com o driver ODBC do IBM i Access, o provedor OLE DB do IBMDASQL e o provedor .NET do DB2 para IBM i.

MTS

MTS é um modelo de programação da Microsoft baseado em componente e um ambiente de tempo de execução para desenvolvimento, implementação e gerenciamento de aplicativos servidor de Internet. Em muitos ambientes de três camadas, o Active Server Pages (ASP) chama componentes MTS para acessar bancos de dados, aplicativos de mainframe e filas de mensagem. Usado com o IBM i Access para Windows em execução na camada intermediária de um ambiente de três camadas, os componentes do MTS gerenciam transações entre aplicativos clientes, componentes do IBM i Access para Windows e os bancos de dados envolvidos nas transações.

O MTS utiliza o MSDTC (Microsoft Distributed Transaction Coordinator) para gerenciar as transações que se estendem por múltiplos DBMS (Database Management Systems) e assegurar a integridade da

confirmação de duas fases ao tratar transações cujas implementações dependem de sucesso mútuo. Nos modelos mais novos de servidor Windows, o MTS foi substituído pelo modelo de Serviços de Componente. Os provedores ODBC, OLE DB e .NET do IBM i Access para Windows suportam o modelo de Serviços de Componente da mesma maneira que suportam o MTS.

Notas de implementação

v _{Se o MSDTC não puder carregar o driver ODBC do IBM i Access, o SQLSetConnectAttr(} SQL_ATTR_ENLIST_IN_DTC ) falhará com o código de razão 2 (XaRmCreate com falha).

v _{Se estiver usando SSL ou qualquer outro valor configurável no diálogo Conexões → Propriedades no} IBM i Navigator, o nome de conexão de sistema no System i Navigator deverá corresponder ao nome de conexão especificado no PC cliente gerenciado pelo MTS. O MSDTC usa os mesmos nomes de |

| |

(11)

conexão que os PCs clientes ODBC do IBM i Access para Windows gerenciados pelo MTS para conectar-se ao banco de dados DB2 para i. Para alterar as propriedades das conexões MSDTC, você deve alterar o registro de conta do sistema.

Uma maneira de fazer isso seria utilizar o IRC (Incoming Remote Command) em combinação com o utilitário CWBENV:

1. Execute o CWBENV em um PC cliente para extrair as informações de configuração para um ambiente.

2. Copie o arquivo resultante no MSDTC PC.

3. Inicie o serviço Comando Remoto do IBM i Access para Windows e certifique-se de que ele esteja configurado para execução no contexto do Sistema Local.

4. Utilizando o comando RUNRMTCMD de uma sessão PC5250, envie um comando CWBENV para o MSDTC PC para importar o ambiente.

Consulte o Guia do Usuário no grupo de programas do IBM i Access para Windows para obter informações adicionais sobre estas funções.

Para obter mais informações sobre o MTS ou o modelo de Serviços de Componente, consulte o Web site da Microsoft.

Web Site do Microsoft MTS

Acessar Serviços do IBM i a partir da Camada Intermediária

Existem várias maneiras de fornecer aos seus componentes de camada intermediária acesso a serviços do IBM i.

Nota: Os componentes da camada intermediária não podem ter interface com o usuário; portanto, se o sistema solicitar informações de conexão, os aplicativos de três camadas poderão parecer

interrompidos. Para evitar isso, os desenvolvedores devem utilizar um novo objeto do sistema para especificar as informações de conexão necessárias (ID do usuário e senha). O valor do modo de aviso para esse objeto deve ser nunca avisar.

Provedor de Dados .NET do IBM i Access para Windows

O Provedor .NET do DB2 para IBM i oferece o melhor desempenho para acessar o banco de dados do sistema para programadores que gravam aplicativos usando o .NET Data Access Framework da

Microsoft. Nesta documentação, Provedor Gerenciado é usado de forma intercambiável com o Provedor

.NET do DB2 para IBM ie o provedor de dados do IBM.Data.DB2.iSeries. Independentemente do nome referido, você poderá aproveitar as vantagens do conjunto completo de tipos de dados .NET e da

funcionalidade SQL que facilitam aos aplicativos trabalhar com dados armazenados com segurança nos bancos de dados do sistema.

Consulte a programação .NET para obter mais informações.

Provedores OLE DB do IBM i Access para Windows

A maioria dos aplicativos e componentes usam os provedores OLE DB do IBM i Access para Windows por meio de ActiveX Data Objects (ADO). Aqui estão os quatro benefícios principais da implementação dessa técnica:

v _{Permite que os desenvolvedores façam apenas modificações secundárias em uma única interface e} técnica de programação a fim de acessar programas, comandos, consultas SQL, procedimentos armazenados e arquivos lógicos e físicos.

v _{Ele suporta a conversão de dados automática entre os tipos de dados do DB2 para i e do PC.}

v _{Permite evitar o código extra associado ao SQL fornecendo suporte para acesso de arquivo em nível de} registro.

(12)

v _{É relativamente fácil de implementar e desenvolver aplicativos. Esse método em geral é a tecnologia} mais simples para o desenvolvimento de aplicativos de três camadas.

Consulte a programação OLE DB para obter mais informações.

Driver ODBC do IBM i Access para Windows

Além disso, você pode acessar o driver ODBC do IBM i Access por meio do ADO ou do Remote Data Services (RDS), usando o provedor OLE DB para ODBC da Microsoft (MSDASQL).

Para obter mais informações sobre como acessar o ODBC por meio do ADO, consulte Escolhendo uma Interface para Acessar o Driver ODBC.

Para obter outras informações sobre o driver ODBC do IBM i Access, consulte a programação do ODBC.

Nota: O provedor OLE DB do IBM i Access para Windows e várias funções no driver ODBC do IBM i Access requerem o MDAC versão 2.5 ou mais recente.

Objetos de Automação ActiveX

O cliente IBM i Access para Windows fornece uma biblioteca de objetos de automação ActiveX que podem ser usados por seus desenvolvedores para desenvolvimento de camada intermediária. Esses objetos fornecem acesso a:

v _{Filas de dados do IBM i}

v _{Chamadas de comandos remotos e programa distribuído} v _{Objetos de administração}

v _{Objetos do IBM i}

v _{Acesso de Transferência de Dados a tabelas de banco de dados do DB2 para i}

Em alguns casos, objetos ActiveX fornecem maior versatilidade e funcionalidade do que o ADO, mas exigem programação um pouco mais complexa.

Nota: O cliente IBM i Access para Windows inclui a biblioteca de automação do cliente Windows 95/NT (o produto XD1). Esses objetos de automação, incluindo o banco de dados, não suportam o uso em um ambiente de três camadas.

APIs C/C++ Express

As APIs do IBM i Access para Windows fornecem acesso rápido, de baixo nível a servidores host do IBM i. Entretanto, o uso dessas APIs requer desenvolvedores experientes em C/C++. Especificamente, os desenvolvedores devem estar familiarizados com APIs e tipos de dados C, assim como devem levar em conta as questões de segurança de encadeamento ao criar seus componentes.

Provedor .NET do IBM i Access para Windows Provedor OLE DB do IBM i Access para Windows Escolhendo uma Interface para Acessar o Driver ODBC ODBC do IBM i Access

Incluir Configuração TCP/IP em Todos os Usuários

Use o comando CWBCFG, a partir de um prompt de comandos ou de Iniciar → Executar, para configurar conexões do IBM i para todos os usuários definidos em um PC.

(13)

O uso desse comando também inclui informações de configuração no perfil padrão do usuário do Windows, que é o perfil utilizado ao criar perfis adicionais do usuário.

Você também pode utilizar CWBCFG para incluir ou alterar o local que o emulador PC5250 utiliza quando ele abre ou criar arquivos. CWBCFG pode alterar a definição de local para todos os usuários do PC. Finalmente, você pode utilizar CWBCFG para ativar ou desativar o Modo FIPS para todos os usuários do PC.

Para obter informações adicionais sobre o CWBCFG ou Modo FIPS, consulte o Guia do Usuário on-line do IBM i Access para Windows.

Definir Local de Arquivos do PC5250 para Todos os Usuários

O local padrão do IBM i Access para Windows, que o emulador PC5250 usa para armazenar e procurar arquivos, possui autoridades de uso e gravação compartilhadas por todos os usuários de um PC. O local padrão é:

%ALLUSERSPROFILE%\IBM\Client Access\emulator\private, em que ALLUSERSPROFILE é o nome de uma variável de ambiente. O IBM i Access para Windows define esta variável de ambiente para conter o caminho que é comum e gravável por todos os aplicativos e usuários do PC.

Este local padrão é alterado por cada usuário autorizado da guia PC5250 de Propriedades do IBM i Access para Windows. Para alterar esse local padrão para todos os usuários ao mesmo tempo, o administrador utiliza o comando CWBCFG em um prompt de comandos, especificando a opção /pc5250path.

Migração de arquivos na V6R1

A partir da V6R1M0, o local do arquivo padrão do IBM i Access para Windows e opções para o local de arquivos do PC5250 foram alterados para o seguinte:

v _{O caminho %ALLUSERSPROFILE%\IBM\Client Access\emulator\private substitui o local (caminho de} instalação do IBM i Access para Windows)\emulator\private.

v _{O caminho (Meus Dados do Aplicativo)\IBM\Client Access\emulator\private substitui o local (Meus} Documentos)\IBM\Client Access\emulator\private.

Para cada um dos itens acima, a migração do local do arquivo do PC5250 e seu conteúdo ocorre para cada usuário do PC, no primeiro logon desse usuário após uma instalação da V6R1M0 ou mais recente do produto IBM i Access para Windows. O caminho de arquivos PC5250 é alterado e, se não copiados ainda, todos os arquivos do local antigo serão copiados no novo local. Um arquivo de log, cwbemcpy.log, é gravado no novo local para indicar que os arquivos foram copiados e listar qualquer erro durante a cópia. Todos os atalhos de ícone, configurados para ativar uma sessão PC5250 especificando o caminho antigo, são alterados manualmente.

Notas:

v _{Toda conta de usuário criada após CWBCFG ser executado utiliza o local padrão definido pelo} CWBCFG.

v _{Somente Administradores podem utilizar o CWBCFG.}

v _{Exceto conforme identificado anteriormente, o CWBCFG não move nenhum arquivo do local} antigo para o novo. Os arquivos devem ser movidos manualmente, se desejado.

Para obter informações adicionais sobre CWBCFG, consulte o Guia do Usuário on-line do IBM i Access para Windows. | | | | | | |

(14)

Perfis de Usuário para PCs com Vários Usuários

É possível administrar PCs com vários usuários do IBM i Access para Windows. Esse tipo de

administração está disponível como uma função dos sistemas operacionais Windows por meio do uso de perfis de roaming e obrigatório.

Nota: Para obter a documentação sobre como implementar esses métodos de administração de vários usuários em sua rede, consulte as ofertas da Microsoft para o sistema operacional Windows que você está utilizando.

Perfis de Usuário Móvel

Perfis de usuário móvel são perfis de usuário do Windows que podem percorrer os PCs. As alterações de configuração vão com o usuário. Os perfis de usuário móvel geralmente residem em um servidor

Windows. Cada usuário móvel tem um diretório no servidor Windows especificado pelo caminho do perfil de usuário nas configurações de perfis de usuário. Esse diretório contém informações de registro, bem como informações do desktop e do menu iniciar para cada usuário.

Perfis de Usuário Obrigatório

Perfis de usuário obrigatório são perfis de usuário que um administrador do sistema configura para que sejam utilizados por usuários de PCs em qualquer PC Windows. Esses usuários normalmente não deverão modificar suas configurações. Perfis de usuário obrigatório podem existir em um PC ou podem percorrer PCs.

Administração do ODBC

O IBM i Access para Windows inclui um driver ODBC que permite o acesso conveniente de seus aplicativos a bancos de dados DB2 para IBM i em sua rede. Esse tópico fornece uma visão geral do ODBC, instruções para configurar o driver e um guia de resolução de problemas.

Nota: Para obter informações e considerações ao trabalhar com APIs do ODBC, consulte a programação ODBC.

ODBC (Open Database Connectivity) é um padrão Microsoft para fornecer acesso aos bancos de dados. Ele possui um conjunto bem definido de APIs (application programming interfaces) que utilizam o SLQ (Structured Query Language) para acessar bancos de dados.

Para obter ajuda na integração do suporte ODBC aos seus aplicativos, consulte a programação ODBC do IBM i Access para Windows, onde você pode obter informações sobre os seguintes subtópicos:

v _{Lista de APIs do ODBC}

v _{Implementação de APIs do ODBC} v _{Exemplos de Programação}

v _{Desempenho do ODBC}

ODBC do IBM i Access System i Access para Linux

Consulte este tópico sobre instalação e uso do IBM ODBC Driver para Linux para acessar o banco de dados do System i. O IBM System i ODBC Driver para Linux não faz parte do System i Access para Windows. Ele é um produto separado utilizado somente com o sistema operacional Linux.

Visão Geral do Driver ODBC do IBM i Access

(15)

O driver ODBC do IBM i Access é uma coleta de interfaces de programação de aplicativos (APIs) para acessar informações do banco de dados usando a Linguagem de Consulta Estruturada (SQL). Usar o driver ODBC do IBM i Access permite que aplicativos acessem diferentes bancos de dados usando o mesmo código de origem e manipulem dados no formato mais conveniente para esses aplicativos. O ODBC fornece a um desenvolvedor de aplicativos um modelo relativamente simples para a criação de aplicativos ou componentes portáteis que devem lidar com múltiplos DBMSs.

A arquitetura ODBC envolve um aplicativo, um gerenciador de driver, um driver ODBC e uma origem de dados. O IBM i Access fornece um driver ODBC de 32 bits e de 64 bits. O driver ODBC de 64 bits é instalado automaticamente com o de 32 bits ao ser executado em uma versão de 64 bits do Windows. Os aplicativos ODBC executados em versões de 64 bits do Windows utilizarão automaticamente o driver ODBC apropriado, dependendo da versão de bit na qual o aplicativo foi compilado. Por exemplo, o driver de 64 bits só pode ser utilizado por um aplicativo de 64 bits.

Para que um aplicativo utilize o ODBC, você deve configurar uma origem de dados. Você pode utilizar o Administrador do ODBC para configurar uma origem de dados. Existem duas versões do Administrador do ODBC, de 32 bits e de 64 bits, que podem ser acessadas a partir da pasta do IBM i Access para

Windows. Ao utilizar o Administrador do ODBC, você tem a opção de configurar três tipos de origens de dados: Usuário, Sistema e Arquivo. Para obter informações adicionais sobre como as origens de dados estão configuradas, consulte Suporte ODBC de 64 Bits, no Guia do Usuário do IBM i Access para Windows.

Aplicativo.Executa processamento e chama funções do ODBC para executar instruções SQL.

Gerenciador de driver.Processa chamadas de função do ODBC e redireciona os pedidos ao driver.

Driver.Processa chamadas de função do ODBC, submete pedidos SQL a uma origem de dados específica e retorna os resultados ao aplicativo.

Origem de dados.Para utilizar uma origem de dados, você terá de criar um DSN (Data Source Name). Um DSN contém informações sobre como acessar o DBMS. Você pode especificar qualquer um dos seguintes DSNs:

v _{DSN do Usuário:}_{Essas origens de dados são locais para um computador e só podem estar disponíveis} ao usuário que as criou. Essas informações são armazenadas no registro.

v _{DSN do Sistema:}_{Essas origens de dados são locais para um computador, e não dedicadas a um} usuário. O sistema, ou qualquer usuário que tenha privilégios, pode utilizar uma origem de dados configurada com um DSN do sistema. Essas informações são armazenadas no registro.

Nota: Em um PC com processador de 64 bits, a parte do sistema do registro é dividida em partes de 32 bits e 64 bits. Os DSNs do sistema configurados utilizando o Administrador do ODBC de 32 bits só estão disponíveis para aplicativos de 32 bits. Além disso, DSNs do Sistema configurados utilizando o Administrador do ODBC de 64 bits só estão disponíveis para aplicativos de 64 bits.

(16)

v _{DSN de Arquivo:}_{Essas são origens de dados baseadas em arquivo que podem ser compartilhadas} entre todos os usuários que tenham os mesmos drivers instalados, para que possam acessar o banco de dados. Essas origens de dados não precisam ser dedicadas a um usuário ou locais para um

computador.

Para obter mais informações sobre ODBC, consulte o Web site da Microsoft.

Tarefas relacionadas

“Especificar a Origem de Dados ODBC” na página 11

Você deve especificar a origem de dados ODBC do IBM i Access para seu aplicativo acessar e manipular dados.

Configurar o sistema para o driver ODBC do IBM i Access

Apresenta os procedimentos para configurar seu ambiente para suportar o driver ODBC. Par obter ajuda ao configurar o driver ODBC, inicie o programa de administração ODBC a partir do grupo de programas do IBM i Access para Windows e consulte a ajuda on-line.

O driver ODBC do IBM i Access é um driver compatível com o ODBC versão 3.5. O driver exige o MDAC (Microsoft Data Access Components) versão 1.5 ou superior. Os aplicativos que utilizam o Microsoft ADO (ActiveX Data Objects) deverão ter o MDAC versão 2.1 ou superior instalado. Os tempos de execução para MDAC versões 2.1 e mais recente fornecem funções adicionais para aplicativos que usam o ADO, o provedor OLE DB para ODBC da Microsoft e o ODBC do IBM i Access para Windows para acessar dados do DB2 para IBM i. Se um aplicativo utiliza suporte de pool de conexão ou do MTS (Microsoft Transaction Server), é recomendável que a versão mais recente do MDAC seja instalada. É possível fazer download do MDAC a partir do seguinte Web site da Microsoft: http://

msdn.microsoft.com/data/aa937729.aspx.

Consulte o tópico Origem de Dados ODBC para configurar o driver ODBC. Conclua sua configuração seguindo as etapas identificadas pelo tópico, incluindo o sistema local no diretório RDB.

O uso de ASPs independentes por meio do ODBC é opcional. Consulte ASPs independentes para obter mais informações sobre como configurar esse suporte.

Para obter ajuda ao configurar opções para uma origem de dados específica, inicie o Administrador ODBC a partir do grupo de programas do IBM i Access para Windows, selecione a origem de dados a ser configurada e consulte a ajuda on-line.

MDAC

Incluindo o Sistema Local no Diretório RDB

Para usar o Provedor de Dados ODBC, OLE DB ou .NET do IBM i Access, o nome do sistema local deve aparecer no diretório do RDB.

Para incluir o sistema local no diretório RDB:

1. No prompt de comandos, execute o comando CL ADDRDBDIRE (Incluir Entrada de Diretório de Banco de Dados Relacional).

2. Quando a tela ADDRDBDIRE solicitar os valores, digite o nome do sistema como o parâmetro Banco de Dados Relacional.

3. Digite *LOCAL como o parâmetro Local Remoto.

Pode haver etapas adicionais para definir o nome do banco de dados (RDB), se a versão do sistema for V5R2 ou mais recente e o aplicativo acessar dados em ASPs independentes. O nome do RDB corresponde |

(17)

a um espaço de nomes que consiste no ASP do sistema e em quaisquer ASPs de usuário ou no grupo ASP vinculado associado ao ASP do sistema. Para obter mais informações sobre ASPs independentes, consulte Gerenciamento de Disco.

Nota: O ODBC permite o uso de nomes completos no formato [nome do catálogo].[nome do esquema].identificador (por exemplo, em que o identificador é o nome de uma tabela, uma visualização ou um procedimento). Na implementação de SQL do DB2 para IBM i, isto corresponde a [nome do RDB].[nome de coleta].identificador.

Gerenciamento de Disco

Especificar a Origem de Dados ODBC

Para especificar a origem de dados:

1. Inicie o programa Administração do ODBC a partir do grupo de programas do IBM i Access para Windows.

2. Selecione a guia apropriada para o tipo de origem de dados. Consulte Visão Geral do Driver ODBC do IBM i Access para obter informações adicionais.

3. Selecione uma origem de dados existente na lista ou selecione Incluir para criar uma nova. Se você estiver utilizando uma origem de dados existente, clique em Configurar e prossiga para a etapa 5. 4. Selecione o driver ODBC do IBM i Access para sua origem de dados e clique em Concluir.

Nota: Você poderá notar o nome Client Access ODBC Driver (32-bit) na lista de drivers. Esse nome é listado para que as origens de dados criadas com os releases anteriores do Client Access continuem a funcionar. Ambos os nomes apontam para o mesmo driver ODBC. Você pode utilizar qualquer um dos dois nomes; contudo, nos releases futuros, o nome Client Access ODBC Driver (32-bit) será removido.

5. Especifique as opções desejadas usando o diálogo de configuração do ODBC do IBM i Access para Windows. Para obter uma descrição dos controles, consulte a ajuda on-line da origem de dados utilizando a tecla F1 ou o botão Ajuda.

Nota: O nome da origem de dados pode incluir até 32 caracteres, deve começar com um caractere alfabético e não pode incluir os seguintes caracteres:

Caracteres Não Permitidos para Origem de Dados Colchete de abertura ([) Ponto de interrogação (?) Colchete de fechamento (]) Asterisco (*)

Chave de abertura ({) Sinal de igual (=) Chave de fechamento (}) Ponto de exclamação (!) Parêntese de abertura ( ) Sinal de arroba (@) Parêntese de fechamento ( ) Ponto-e-vírgula (;)

(18)

Conceitos relacionados

“Visão Geral do Driver ODBC do IBM i Access” na página 8

Fornece uma descrição geral do ODBC e como você pode usá-lo com o IBM i Access para Windows.

“Utilizar ASPs Independentes por Meio do ODBC”

Localize etapas a serem usadas ao conectar-se a um ASP independente por meio do ODBC do IBM i Access.

Utilizar ASPs Independentes por Meio do ODBC

Localize etapas a serem usadas ao conectar-se a um ASP independente por meio do ODBC do IBM i Access.

Para utilizar ASPs independentes por meio do ODBC, configure o DSN do ODBC e faça o seguinte: 1. Selecione a guia Servidor.

2. Clique em "Substituir Banco de Dados Padrão pelo Seguinte:".

3. Especifique o Nome do RDB que corresponde ao ASP Independente ao qual conectar-se.

4. Se nenhum nome do RDB for especificado, o nome padrão será determinado a partir da descrição da tarefa do perfil do usuário que está estabelecendo a conexão ODBC. Por padrão, o driver utiliza a definição do perfil do usuário que está estabelecendo a conexão ODBC.

Para obter mais informações sobre ASPs independentes, consulte tópicos do conteúdo Gerenciamento de Disco.

“Especificar a Origem de Dados ODBC” na página 11

Segurança de ODBC do IBM i Access para Windows

Realça algumas considerações de segurança ao trabalhar com o ODBC do IBM i Access e fornece referências para instruções de segurança mais detalhadas.

As informações a seguir não têm o objetivo de ser um guia abrangente para estratégias de segurança na plataforma IBM i ou com o IBM i Access para Windows. Elas apenas fornecem uma visão geral de estratégias de segurança que impactam usuários do IBM i Access para Windows e de ODBC. Para obter informações mais detalhadas, consulte o IBM Security - Reference.

Referência de Segurança

Estratégias Comuns do ODBC Que Não São Seguras

Evite algumas técnicas de segurança comuns de ODBC do IBM i Access para assegurar que seu ambiente esteja seguro.

Às vezes, os administradores do sistema tentam proteger o acesso aos dados, em vez de proteger os próprios dados. Isso é extremamente arriscado, visto exigir que os administradores entendam TODOS os métodos pelos quais os usuários podem acessar os dados. Algumas técnicas comuns de segurança do ODBC a serem evitadas são:

(19)

Segurança da Linha de Comandos

Isso pode ser útil para uma interface baseada em caracteres ou para aplicativos baseados em emulação 5250. Entretanto, esse método supõe que se você impedir que os usuários digitem comandos em uma sessão de emulação 5250, eles só poderão acessar dados por meio dos programas e dos menus que o administrador do sistema fornecer a eles. Portanto, a segurança da linha de comandos nunca é realmente segura. O uso de políticas do IBM i Access para Windows e da Administração do Aplicativo melhora a segurança e o uso de autoridade em nível de objeto serve para melhorá-la ainda mais.

Possivelmente, as políticas do IBM i Access para Windows podem restringir o acesso de ODBC a uma origem de dados específica que pode ser somente leitura. A Administração de Aplicativo no System i Navigator pode evitar o acesso do ODBC.

Para obter informações adicionais, consulte o IBM Security - Reference.

Programas de Saída do Usuário

Um programa de saída do usuário permite ao administrador do sistema proteger um programa de servidor host fornecido pela IBM. O driver ODBC do IBM i Access usa o servidor host do Banco de Dados: pontos de saída QIBM_QZDA_INIT; QIBM_QZDA_NDBx e QIBM_QZDA_SQLx. Alguns drivers ODBC e métodos de acesso a dados do IBM i Access para Windows (como OLE DB) podem usar outros servidores host.

Diários

Muitas vezes, são utilizados diários com aplicativos cliente/servidor para fornecer controle de

confirmação. Os diários contêm informações detalhadas sobre cada atualização feita em um arquivo que está sendo registrado no diário. As informações do diário podem ser formatadas e consultadas para retornar informações específicas, incluindo:

v _{Os perfis de usuário que atualizaram o arquivo} v _{Os registros que foram atualizados}

v _{O tipo de atualização}

Diários também permitem entradas definidas pelo usuário. Quando utilizado com um programa de saída do usuário ou um acionador, isso oferece um método de código extra relativamente baixo de manutenção de auditorias definidas pelo usuário. Para obter informações adicionais, consulte Backup e Recuperação.

Restrições de DSN (Data Source Name)

O driver ODBC do IBM i Access suporta uma configuração de DSN para conceder acesso somente leitura ao banco de dados. O driver ODBC do IBM i Access suporta uma configuração de origem de dados somente leitura e de chamada de leitura. Embora não sejas seguras, essas definições podem auxiliar na prevenção de operações de exclusão e atualização inadvertidas.

Referência de Segurança Backup and recovery

Estratégias de Segurança de Programa ODBC

(20)

Restringindo Acesso de Programa ao Banco de Dados

Administradores de sistema muitas vezes precisam limitar o acesso a arquivos específicos, a um

determinado programa ou a conjuntos de programas. Um programador utilizando a interface baseada em caracteres definiria as restrições utilizando a autoridade adotada pelo programa. Um método semelhante pode ser utilizado com o ODBC.

Procedimentos armazenados permitem aos programadores de ODBC implementar a autoridade adotada pelo programa. O programador pode não querer que os usuários manipulem arquivos de banco de dados utilizando aplicativos de desktop, como o Microsoft Access ou o Lotus 1-2-3. Em vez disso, o

programador pode querer limitar as atualizações do banco de dados somente ao aplicativo do

programador. Para implementar isso, o acesso do usuário ao banco de dados deve ser restringido com a segurança de nível de objeto ou com programas de saída do usuário. O aplicativo deve ser escrito para enviar pedidos de dados ao procedimento armazenado e ter o procedimento armazenado para atualizar o banco de dados.

Restringir Utilização de CPU pelo Usuário

O ODBC facilitou muito a acessibilidade de dados do DB2 para i. Um impacto negativo tem sido que os usuários podem criar acidentalmente um número muito grande de consultas à CPU sem perceber isso. O ODBC é executado em uma prioridade de tarefa interativa e isso pode afetar gravemente o desempenho do sistema. O sistema suporta um controlador de consultas. O ODBC pode chamar o controlador de consultas (por exemplo, pelo aplicativo de PC) em uma chamada de procedimento armazenado. Ou as APIs do ODBC podem chamar o controlador por meio do parâmetro de tempo limite de consulta. Além disso, um programa de saída do usuário pode forçar o controlador de consultas na tarefa do ODBC. O tempo limite é especificado no parâmetro QRYTIMLMT do comando CL CHGQRYA. O arquivo de opções de consulta (QAQQINI) também pode ser utilizado para definir o valor.

O manual SQL Reference contém informações adicionais. Visualize uma versão on-line em HTML do manual, ou imprima uma versão PDF, a partir do DB2 para i SQL Reference.

Consulte também a administração do servidor host para obter mais informações.

Logs de Auditoria (Monitorando a Segurança)

Vários logs podem ser utilizados para monitorar a segurança. QHST, o Log de Histórico, contém

mensagens relacionadas às alterações de segurança feitas no sistema. Para monitoramento detalhado das funções relacionadas à segurança, QAUDJRN pode ser ativado. O valor *SECURITY registra as seguintes funções:

v _{Alterações na autoridade do objeto.}

v _{Operações de criação, alteração, exclusão, exibição e restauração de perfis do usuário.} v _{Alterações na propriedade do objeto.}

v _{Alterações nos programas (CHGPGM) que adotam o perfil do proprietário.} v _{Alterações nos valores do sistema e nos atributos de rede.}

v _{Alterações no roteamento de subsistema.}

v _{Quando a senha QSECOFR é redefinida para o valor enviado pelo DST.}

v _{Quando a senha do responsável pela segurança do DST precisa ser padronizada.} v _{Alterações no atributo de auditoria de um objeto.}

(21)

“Administração do Servidor Host” na página 28

Identificar e usar e gerenciar de forma eficiente servidores host do IBM i Access para Windows.

Referência de SQL do DB2 para i Referência de Segurança

Informações Relacionadas sobre Segurança do ODBC

Localizar informações adicionais sobre segurança de ODBC do IBM i Acesss.

Escolha entre os links relacionados para obter informações detalhadas sobre tópicos específicos.

Você também pode entrar em contato com o suporte técnico do IBM i ou procurar a página da Web de suporte técnico em www.ibm.com/systems/support/i/ para obter informações adicionais.

Referência de Segurança Backup and recovery

Referência de SQL do DB2 para i

Resolução de Problemas do ODBC

Ajuda a resolver algumas das dificuldades mais comumente encontradas com o IBM i Access para Windows e o ODBC. Além disso, identifica várias ferramentas que podem ajudar a remover gargalos de desempenho. Reveja essas informações antes de entrar em contato com o suporte técnico.

Para obter ajuda na integração do suporte ODBC aos seus aplicativos, consulte a programação ODBC do IBM i Access para Windows, onde você pode obter informações sobre os seguintes subtópicos:

v _{Lista de APIs do ODBC}

v _{Implementação de APIs do ODBC} v _{Exemplos de Programação}

v _{Desempenho do ODBC}

Os tópicos a seguir fornecem diretrizes gerais para localizar e resolver erros do ODBC do IBM i Access para Windows:

Programação ODBC

Ferramentas de Diagnóstico e Desempenho do ODBC

Usar ferramentas para ajudar a diagnosticar problemas do ODBC do IBM i Access.

Escolha dentre o seguinte para obter informações sobre ferramentas de diagnóstico e desempenho do lado do servidor ou cliente do ODBC:

(22)

“Verificando o Status do Servidor” na página 20

Use o comando CWBPING do IBM i Access para Windows. “Reunir Informações para o IBM Support” na página 27

A equipe do Suporte IBM pode oferecer um serviço melhor se você tiver algumas informações

disponíveis quando abrir um registro do problema no Suporte IBM para resolução de problemas do IBM i Access para Windows.

Ferramentas de Diagnóstico e Desempenho do ODBC do Lado Cliente:

Use ferramentas do lado do cliente para ajudar a diagnosticar problemas do ODBC do IBM i. A tabela a seguir contém as ferramentas de diagnóstico e desempenho do ODBC no lado cliente:

Ferramenta do Cliente Descrição Rastreio do ODBC

(SQL.LOG)

O Administrador do ODBC da Microsoft fornece seu próprio utilitário de rastreio para rastrear as chamadas de API do ODBC dos aplicativos.

Consulte Coletando um Rastreio do ODBC (SQL.LOG) para obter mais informações. Utilitários de rastreio do

ODBC

Há outros utilitários de rastreio do ODBC disponíveis que podem ser mais robustos que o Rastreio do ODBC (SQL.LOG). Esses utilitários de varejo podem fornecer rastreio detalhado de entrada e ponto de saída das chamadas de API do ODBC. Os dois utilitários de rastreio são Trace Tools (Dr. DeeBee) e SST Trace Plus (Systems Software Technology).

CWBPING Para utilizar o CWBPING, digite cwbping (o nome do sistema ou o endereço IP) em um prompt de comandos. Por exemplo: cwbping testsys1 ou cwbping 127.127.127.1 CWBPING responde com uma lista de servidores e seus status. Execute CWBPING sem nenhum parâmetro para obter ajuda com o uso do CWBPING. Para obter mais informações sobre o CWBPING, consulte Verificando o Status do Servidor.

CWBCOTRC Para utilizar o CWBCOTRC, digite CWBCOTRC ON em um prompt de comandos localizado no diretório \Arquivos de programas\IBM\Client Access. Após ativar o rastreio, você pode iniciar o aplicativo. Digitar CWBCOTRC OFF interrompe o rastreio. CWBCOTRC reúne informações sobre dados que estão sendo transmitidos para e do servidor. Execute CWBCOTRC sem nenhum parâmetro para obter ajuda com o uso do CWBCOTRC.

Rastreio detalhado O rastreio de detalhes reúne informações rastreadas pelos componentes do IBM i Access para Windows que estão em uso. As informações do ODBC que podem ser encontradas nesse rastreio incluem pontos de entrada no driver, informações sobre a tarefa de pré-inicialização, o nome do pacote em uso e condições especiais de erro. Para obter mais informações, consulte Reunir um Rastreio Detalhado.

Ferramentas de Diagnóstico e Desempenho do ODBC do Lado do Servidor:

Use ferramentas do lado do servidor para ajudar a diagnosticar problemas do ODBC do IBM i Access. As tabelas a seguir contêm ferramentas de diagnóstico e desempenho do ODBC do lado do servidor:

(23)

Ferramentas do Lado do Servidor

Ferramenta do Servidor Descrição

Rastreio de comunicação O recurso de rastreio de comunicação rastreará e formatará qualquer tipo de comunicação que tenha uma descrição de linha (token ring e Ethernet).

Essa é uma ferramenta para isolar muitos problemas. Também é útil para diagnosticar onde um retardo de desempenho está ocorrendo. Utilize os campos timestamp e eye-catcher para medir quanto tempo leva para processar um pedido.

Rastreios de tarefas O rastreio de tarefas pode ajudar a isolar muitos problemas de host e de desempenho. Uma tarefa de serviço deve ser iniciada antes na tarefa a ser rastreada. Localize o nome completo da tarefa do ODBC. Em qualquer sessão de emulação 5250, inicie uma tarefa de serviço nessa tarefa QZDASOINIT utilizando o comando STRSRVJOB. Em seguida, escolha um dos dois rastreios, dependendo das informações necessárias: Rastrear tarefa

Rastreia as chamadas internas feitas pelo servidor host. Execute o comando TRCJOB *ON.

Rastreio de depuração

Utilizado para rever o desempenho do aplicativo e determinar a causa de um problema específico.

O comando STRDBG é executado contra uma tarefa de serviço ativa. Esse comando registra as decisões tomadas pelo Otimizador de consulta no log de tarefa da sessão de depuração. Por exemplo, ele registra tempos de consulta estimados, caminhos de acesso utilizados e erros do cursor.

Uma maneira fácil de ativar o STRDBG é configurar o DSN do ODBC que você está utilizando por meio do Administrador do ODBC, selecionando a opção Ativar o Comando STRDBG (Iniciar Depuração)na guia Diagnóstico. Como alternativa, você pode executar o seguinte comando:

STRDBG UPDPROD(*YES)

O log da tarefa do ODBC pode registrar todos os erros que ocorrem para o banco de dados IBM i. Quando a tarefa estiver no modo de depuração, o log de tarefa conterá também informações relacionadas a desempenho.

Ferramentas de desempenho O toolkit de desempenho fornece relatórios e utilitários que podem ser utilizados para criar uma análise detalhada do desempenho do aplicativo. O toolkit fornece

informações sobre utilização da CPU e da cabeça do disco, paginação de memória e muito mais. Embora o sistema operacional de base inclua capacidade para coletar dados de desempenho, você precisará do programa licenciado separadamente Performance Tools/400para analisar os resultados.

Você também poderá utilizar as ferramentas Database Monitor e Visual Explain. Consulte a Ajuda on-line do System i Navigator para obter mais informações. Log de tarefa QZDASOINIT Para receber suporte satisfatório, gerar, localizar e recuperar o log de tarefa

QZDASOINIT. O log de tarefa pode conter mensagens que ajudam a determinar e resolver os erros retornados pelo ODBC.

Uma maneira fácil de acessar o log de tarefa é configurar o DSN do ODBC que você está utilizando por meio do Administrador do ODBC, selecionando a opção Imprimir Log de Tarefa na Desconexãona guia Diagnóstico. Para localizar o log de tarefa, abra uma sessão de emulação PC5250 e execute o comando WRKSPLF. Especifique o perfil do usuário do IBM i que foi usado na conexão ODBC como o parâmetro do usuário para o comando WRKSPLF.

QAQQINI (Arquivo de Opções de Consulta)

É possível definir a biblioteca para Arquivo de Opções de Consulta, configurando o DSN do ODBC que você está utilizando por meio do Administrador do ODBC e selecionando a guia Diagnóstico. Digite o nome da biblioteca que deseja utilizar na caixa Biblioteca de Arquivo de Opções de Consulta.

(24)

Coletando um Rastreio do ODBC (SQL.LOG):

Etapas para coletar chamadas da API ODBC do IBM i Access Siga estas etapas para coletar um SQL.LOG:

1. Inicie o Administrador de Origem de Dados do ODBC. 2. Selecione a guia Rastreio.

3. Selecione o botão Iniciar Rastreio Agora. 4. Selecione Aplicar ou OK.

5. Recrie o erro.

6. Retorne para Administrador do ODBC. 7. Selecione a guia Rastreio.

8. Selecione o botão Parar Rastreio Agora.

9. O rastreio pode ser visualizado no local que você inicialmente especificou na caixa Caminho de

Arquivo de Log.

Nota: Esse procedimento se aplica quando você está utilizando o MDAC versão 2.5. Se você estiver utilizando uma versão diferente do MDAC, poderá precisar seguir etapas diferentes.

Reunir um Rastreio Detalhado:

Os itens do ODBC que são úteis nesse rastreio incluem pontos de entrada no driver, informações sobre a tarefa de pré-inicialização, o nome do pacote em uso e condições especiais de erro.

Nota: Há etapas que precisam ser concluídas antes de obter um rastreio detalhado para o MTS (Microsoft Transaction Server). Conclua as etapas para reunir um rastreio detalhado para o MTS (Microsoft Transaction Server) antes de concluir as etapas a seguir.

1. No menu Iniciar, escolha Programas → IBM i Access para Windows → Propriedades do IBM i Access

para Windows.

2. Clique na guia Ferramentas de Diagnóstico.

3. Clique no botão Iniciar Ferramentas de Diagnóstico.

4. Clique em OK. Na área de notificação da barra de tarefas, aparece um ícone semelhante a um computador contendo um ponto vermelho.

5. Clique com o botão direito do mouse no ícone e escolha Iniciar Todos os Diagnósticos. 6. Recrie o problema.

7. Clique com o botão direito do mouse no ícone e selecione Rastreio Detalhado → Parar. 8. Clique com o botão direito do mouse no ícone e selecione Rastreio Detalhado → Exibir. 9. No menu Arquivo, selecione Salvar Como.

10. Digite um nome e clique no botão Salvar.

Reunir um rastreio detalhado para um MTS (Microsoft Transaction Server):

Identificar etapas para reunir um rastreio do IBM i Access para Windows MTS.

1. Certifique-se de que tenha o Comando Remoto de Entrada (IRC), um recurso opcional do IBM i Access para Windows, instalado na máquina que tem o MTS e o Microsoft Distributed Transaction Coordinator (MSDTC).

2. Certifique-se de que o IRC esteja em execução na mesma conta em que o MSDTC está em execução. Verifique-o em em Iniciar/Configurações/Painel de Controle/Serviços.

3. Em um prompt de comandos, execute REXEC dragonfire CWBLOG START/DETAILTRACE. Substitua "dragonfire" pelo nome do PC.

| |

(25)

4. O IRC solicitará um ID de usuário e uma senha. Digite um ID de usuário com autoridade de administrador.

5. Conclua as etapas para reunir um rastreio detalhado.

Mensagens de Erro de ODBC do IBM i Access

Quando ocorre um erro, o driver ODBC do IBM i Access retorna o SQLSTATE (um código de erro de ODBC) e uma mensagem de erro. O driver obtém essas informações dos erros detectados por ele e dos erros retornados pelo DBMS.

Para erros que ocorrem na origem de dados, o Driver ODBC do IBM i Access mapeia o erro nativo retornado para o SQLSTATE apropriado. Quando o driver ODBC do IBM i Access e o Microsoft Driver Manager detectam um erro, eles geram o SQLSTATE apropriado. O driver ODBC do IBM i Access retorna uma mensagem de erro com base na mensagem retornada pelo DBMS.

Para erros que ocorrem no driver ODBC do IBM i Access ou no Microsoft Driver Manager, o driver ODBC do IBM i Access retorna uma mensagem de erro com base no texto associado ao SQLSTATE.

Formato da Mensagem de Error

As mensagens de erro têm o seguinte formato:

[fornecedor][componente-ODBC][origem-de-dados] mensagem-de-erro

Os prefixos entre colchetes ([]) identificam a origem do erro. A tabela a seguir mostra os valores destes prefixos retornados pelo driver ODBC do IBM i Access.

Quando o erro ocorre na origem de dados, os prefixos [fornecedor] e [componente-ODBC] identificam o fornecedor e o nome do componente ODBC que recebeu o erro da origem de dados.

Origem do Erro Valor Gerenciador de Driver [Microsoft]

[Gerenciador de driver ODBC] [N/D]

Driver ODBC do IBM i

Access [IBM

(R)

]

[Driver ODBC do IBM i Access] N/D

Mensagens do NLS [IBM]

[Driver ODBC do IBM i Access] Coluna #:

Número da mensagem de erro do NLS Texto da mensagem de erro do NLS Camada de Comunicação [IBM]

[Driver ODBC do IBM i Access]

Link de comunicação failure.Comm RC=xxxx - (texto da mensagem) Em que xxxx é o número do erro em formato decimal, não hexadecimal. O texto da mensagem descrevendo a natureza do erro aparece com o número do erro.

Nota: Para obter informações adicionais sobre IDs de mensagem de erro, consulte os códigos de retorno do IBM i Access ou o Guia do Usuário on-line do IBM i Access para Windows.

DB2 para i [IBM]

[Driver ODBC do IBM i Access] [DB2]

Mensagem de erro do servidor

| | | | | | | | | | | | | |

(26)

Visualizando o Texto da Mensagem de Erro do DB2 para i:

Para erros que começam com: Utilize este comando CL

SQL DSPMSGD RANGE(SQLxxxx) MSGF(QSQLMSG)

IWS ou PWS DSPMSGD RANGE(ZZZxxxx) MSGF(QIWS/QIWSMSG) em que ZZZ é IWS ou PWS

Consulte os erros comuns do ODBC para obter ajuda com outras mensagens de erro do ODBC. É possível procurar e visualizar mensagens de erro de NLS ou de comunicação no tópico da ajuda de mensagens de Serviço, de Erro e de Rastreio no Guia do Usuário on-line do IBM i Access para Windows.

“Erros Comuns do ODBC” na página 22

Localizar e resolver erros do ODBC do IBM i Access.

Códigos de Retorno do IBM i Access

Resolução de Problemas de Conexão do IBM i

Cada conexão ODBC comunica-se com um programa de banco de dados do IBM i. Esse programa é referido como programa do servidor host.

O nome do programa do Servidor de Banco de Dados utilizado com o TCP/IP é QZDASOINIT. Normalmente, ele está localizado no subsistema QUSRWRK; contudo, pode ser configurado de maneira diferente pelo administrador do sistema.

Em condições normais, o programa é chamado de modo transparente, e o usuário não precisa executar uma ação, a não ser para verificar se os subsistemas e os protocolos de comunicação adequados estão sendo executados. Consulte Administração do Servidor Host para obter detalhes sobre administração de tarefas do servidor host.

A indicação mais comum de uma falha de conexão é uma mensagem de erro do driver ODBC mencionando uma falha de link de comunicação.

Se o ODBC não puder conectar-se ao host do IBM i, execute as seguintes tarefas de resolução de problemas:

Verificando o Status do Servidor:

Use o comando CWBPING do IBM i Access para Windows.

O produto IBM i Access para Windows tem um comando especial para verificar o status de servidores host:

CWBPING systemname

em que systemname é o nome do sistema.

O comando deverá retornar algo semelhante ao seguinte:

Para cancelar o pedido CWBPING, pressione CTRL-C ou CTRL=BREAK I - Verificando a conexão com o sistema MEUSISTEMA...

(27)

I - Conectado com êxito ao aplicativo do servidor: Impressão de Rede I - Conectado com êxito ao aplicativo do servidor: Acesso a Dados I - Conectado com êxito ao aplicativo do servidor: Filas de Dados I - Conectado com êxito ao aplicativo do servidor: Comando Remoto I - Conectado com êxito ao aplicativo do servidor: Segurança I - Conectado com êxito ao aplicativo do servidor: DDM I - Conectado com êxito ao aplicativo do servidor: Telnet

I - Conectado com êxito ao aplicativo do servidor: Central de Gerenciamento I - Conexão verificada com o sistema MEUSISTEMA

“Ferramentas de Diagnóstico e Desempenho do ODBC” na página 15

Usar ferramentas para ajudar a diagnosticar problemas do ODBC do IBM i Access.

Verificando se os sistemas estão ativos:

As tarefas (QZDASOINIT) do ODBC do IBM i Access conectadas por TCP/IP (QZDASOINIT) serão executadas no subsistema QUSRWRK. Verifique se esse subsistema está em execução.

O subsistema QSERVER pode precisar ser iniciado manualmente. Para fazer isso, simplesmente emita o seguinte comando:

STRSBS QSERVER

Para que o subsistema seja iniciado automaticamente no IPL, modifique o procedimento de Inicialização IPL (o padrão é QSYS/QSTRUP) para incluir o comando STRSBS QSERVER.

Além do subsistema QSERVER, o subsistema QSYSWRK e QUSRWRK devem estar em execução.

Verificando se as Tarefas de Pré-inicialização Estão em Execução:

A IBM envia os subsistemas QSERVER/QUSRWRK para utilizar tarefas de pré-inicialização para aprimorar o desempenho na inicialização de tarefas. Se não estiverem ativas, estas tarefas de pré-inicialização poderão impactar uma conexão do IBM i.

Quando as tarefas de pré-inicialização são configuradas no subsistema, a tarefa DEVE estar ativa para conexão. A tarefa de pré-inicialização utilizada para uma conexão TCP/IP é:

v _{QZDASOINIT - Programa do Servidor}

v _{QZDASSINIT - Programa do servidor usado ao usar SSL}

Para verificar se uma tarefa de pré-inicialização está sendo executada, utilize um dos seguintes:

WRKACTJOB SBS(QUSRWRK)

WRKACTJOB SBS('subsistema-definido-pelo-usuário')

A tarefa de pré-inicialização apropriada deve estar ativa:

Tarefa Usuário Tipo

---Status---QZDASOINIT QUSER PJ ATIVO (conexão de soquete)

Tarefas de pré-inicialização não são exibidas em WRKACTJOB a menos que uma conexão já esteja ativa. Você deve utilizar F14 - Incluir a partir do painel WRKACTJOB.

Considerações Adicionais sobre TCP/IP:

Use NETSTAT, STRTCP e STRHOSTSVR para verificar e iniciar funções do TCP/IP ao resolver problemas de uma conexão do IBM i.

Verifique se o TCP/IP é iniciado com o seguinte comando: |

(28)

NETSTAT *CNN

Nota: Para verificar se o TCP/IP foi iniciado com o System i Navigator, você já deve ter configurado seu servidor com TCP/IP, depois, faça o seguinte:

1. No System i Navigator, selecione o servidor → Rede.

2. Clique com o botão direito do mouse em Configuração TCP/IP e selecione Utilitários. 3. Selecione Executar Ping.

4. Especifique o nome do host ou o endereço TCP/IP e clique em Executar Ping Agora. Utilize o comando STRTCP para iniciar o protocolo desejado se ele não estiver em execução. Verifique se os daemons necessários estão em execução navegando nas informações retornadas do comando NETSTAT *CNN:

Endereço Porta Porta

Remoto Remota Local Tempo Inat Estado * * as-cent > 000:09:31 Listen * * as-signon 000:09:41 Listen * * as-svrmap 002:57:45 Listen * * as-data > 002:57:45 Listen

Utilize o comando STRHOSTSVR SERVER(*ALL) para iniciá-los, se necessário.

v _{Verifique se QZDASRVSD, o daemon de soquete do servidor host do banco de dados, está em} execução no subsistema QSERVER.

– as-database deverá estar no estado Listen

– WRKJOB QZDASRVSD deverá ser utilizado para verificar o log de tarefa do daemon em busca de alguma mensagem de erro.

v _{Verifique se o daemon de soquete QZSOSMAPD está em execução no subsistema QSYSWRK.} – as-svrmap deverá estar no estado Listen conforme mostrado pelo NETSTAT *CNN.

– WRKJOB QZSOSMAPD deverá ser utilizado para verificar o log de tarefa do daemon em busca de alguma mensagem de erro.

O PC localiza a porta utilizada pelo servidor de banco de dados conectando-se à porta do mapeador do servidor. Ele recupera a porta utilizada por as-database. Em seguida, ele se conecta à porta apropriada que está sendo monitorado pelo daemon do servidor de banco de dados, QZDASRVSD. O daemon do servidor estabelecerá a conexão do cliente com uma tarefa de pré-inicialização QZDASOINIT no

QUSRWRK. Se essa for a primeira conexão feita com o servidor a partir desse PC, dois outros servidores serão utilizados: servidor central para licença e servidor de conexão para validação de ID de

usuário/senha.

Para obter mais informações sobre como verificar se o TCP/IP é iniciado, consulte Problemas Gerais de TCP/IP.

Configurar o Servidor com o TCP/IP Problemas Gerais de TCP/IP

Erros Comuns do ODBC

Localizar e resolver erros do ODBC do IBM i Access.

Os tópicos a seguir fornecem diretrizes gerais para localizar e resolver erros comuns do ODBC do IBM i Access para Windows:

(29)

“Mensagens de Erro de ODBC do IBM i Access” na página 19

Quando ocorre um erro, o driver ODBC do IBM i Access retorna o SQLSTATE (um código de erro de ODBC) e uma mensagem de erro. O driver obtém essas informações dos erros detectados por ele e dos erros retornados pelo DBMS.

Erros de SQL:

Lista de erros comuns do ODBC do IBM i Access de SQL encontrados por aplicativos

Nota: Para obter mais informações sobre erros de SQL, consulte mensagens e códigos de SQL.

Mensagens e Códigos SQL

SQL0104 - O token &1 não era válido. Tokens válidos: &2:

Mensagem de Sintaxe de SQL ODBC do IBM i Access Inválida Causa provável:

v _{O aplicativo gerou uma instrução SQL com sintaxe incorreta. Para obter ajuda com determinação de} problemas, utilize a ferramenta de rastreio do ODBC, fornecida com o Administração do ODBC, para examinar o SQL.LOG.

v _{Consulte SQL0114 - Banco de dados relacional &1 diferente do servidor &2 atual se "*" for o token.} v _{A instrução SQL está utilizando um literal que excede o limite de tamanho de 32 K. Considere o uso de}

um marcador de parâmetro em vez de um literal. Isso reduz o tamanho da instrução ao mesmo tempo permitindo transmitir o valor de tamanho de campo máximo dos dados.

v _{O aplicativo está utilizando sintaxe incorreta para junção externa esquerda. Alguns aplicativos são} padronizados para uma sintaxe de junção externa esquerda de propriedade *= na cláusula WHERE (PowerBuilder 3.0 & 4.0, Crystal Reports). Verifique com o fornecedor do aplicativo. A maioria fornece uma definição ini ou um valor de configuração para utilizar a sintaxe de junção externa esquerda do ODBC.

“SQL0114 - Banco de dados relacional &1 diferente do servidor &2 atual” na página 24 Atualizar a Entrada de Diretório do Banco de Dados Relacional ODBC do IBM i Access.

SQL0113 - Nome &1 não permitido.:

Atualizar o Diretório do Banco de Dados Relacional ODBC do IBM i Access Causa provável:

É provável que o nome do sistema não esteja no Diretório de Banco de Dados Relacional. Execute o comando Incluir Entrada de Diretório de Banco de Dados Relacional:

ADDRDBDIRE RDB(SYSNAME) RMTLOCNAME(*LOCAL)

No exemplo anterior, SYSNAME é o nome do Local Padrão do sistema (conforme especificado no comando DSPNETA).

Outra causa comum para esse erro é um ponto (.) em um nome de tabela ou de biblioteca. Embora o ponto seja válido em convenções de nomenclatura de arquivos do IBM i, o nome deve ser colocado entre aspas duplas para ser usado em uma instrução SQL. Uma alternativa prática poderia ser criar um arquivo lógico sobre o arquivo físico desejado, utilizando a sintaxe da nomenclatura SQL. Outra possível solução seria criar um Alias SQL sobre o arquivo desejado e, em seguida, acessar o arquivo indiretamente pelo alias.

(30)

SQL0114 - Banco de dados relacional &1 diferente do servidor &2 atual:

Atualizar a Entrada de Diretório do Banco de Dados Relacional ODBC do IBM i Access. Causa provável:

É provável que o nome do sistema não esteja no Diretório de Banco de Dados Remoto. Execute o comando Incluir Entrada de Diretório de Banco de Dados Relacional:

ADDRDBDIRE RDB(SYSNAME) RMTLOCNAME(*LOCAL)

Nesse exemplo anterior, SYSNAME é o nome do Local Padrão do sistema (conforme especificado no comando DSPNETA).

Outra causa comum para esse erro é um ponto (.) em um nome de tabela ou de biblioteca. Embora válido em convenções de nomenclatura, para utilizá-lo em uma instrução SQL, coloque o nome entre aspas duplas. Uma alternativa prática poderia ser criar um arquivo lógico sobre o arquivo físico desejado, utilizando a sintaxe da nomenclatura SQL.

“SQL0104 - O token &1 não era válido. Tokens válidos: &2” na página 23 Mensagem de Sintaxe de SQL ODBC do IBM i Access Inválida

SQL0204 - MYSYSCONF não localizado:

Para ODBC do IBM i Access: Tabela opcional no servidor. Causa provável:

Em geral, somente os logs das tarefas que utilizam o Microsoft Jet Engine (aplicativos Microsoft ACCESS ou Microsoft Visual Basic) contêm essa mensagem. O MS Jet Engine sempre verifica uma tabela opcional no servidor que se chama MYSYSCONF. Os aplicativos ignoram esse aviso. Para obter informações adicionais, consulte o white paper do Microsoft Jet Database Engine Connectivity ou entre em contato com a Microsoft.

SQL0208 - Coluna ORDER BY não está na tabela de resultados:

Para ODBC do IBM i Access: Problema com a cláusula ORDER BY Causa provável:

O driver ODBC do IBM i Access relata "Y" para a propriedade SQL_ORDER_BY_COLUMNS_IN_SELECT (ODBC 2.0). Uma cadeia de caracteres "Y" implica em que as colunas na cláusula ORDER BY devem estar na lista de seleção. Alguns aplicativos comuns de relatório de desktop ignoram ou não verificam esse valor e tentam utilizar uma ordem por campo que não está na lista de seleção.

SQL0900 - O processo aplicativo não está em um estado conectado:

Atualizar a Entrada de Diretório do Banco de Dados Relacional ODBC do IBM i Access. Causa provável:

É provável que o nome do sistema não esteja no Diretório de Banco de Dados Remoto. Execute o comando Incluir Entrada de Diretório de Banco de Dados Relacional: