============================================================================== 5733XJ1 IBM i Access Client Solutions Pacote de Aplicativos para Windows 1.1.0 (c) Copyright IBM Corporation 1996, 2019. Todos os direitos reservados. ============================================================================== Este documento é fornecido "no estado em que se encontra" sem garantia de nenhum tipo. A IBM renuncia a todas as garantias, sejam expressas ou implícitas, incluindo, mas não limitando, as garantias implícitas de adequação a um determinado objeto e a comercialização a respeito das informações contidas neste publicação. Fornecendo esta publicação, a IBM não garante nenhum direito sobre quaisquer patentes ou direitos autorais. =============================================================================== Este documento foi atualizado pela última vez em: 4 de novembro de 2019 ------------------------------------------------------------------- ÍNDICE ------------------------------------------------------------------- 1.0 Introdução 2.0 Local das fontes de informações 3.0 Instalação 3.1 Sistemas operacionais Windows suportados 3.2 Considerações de instalação 3.3 Fazendo upgrade a partir do IBM i Access for Windows 3.4 Executando a instalação 3.5 Ação necessária após a instalação do driver da impressora 3.6 Considerações sobre a instalação do hardware de 64 bits 3.7 Logs de instalação 4.0 Requisitos do provedor IBM.Data.DB2.iSeries .NET 5.0 Microsoft XML Parser ou Microsoft XML Core Services 6.0 Informações sobre instalação avançada 6.1 Informações sobre o produto licenciado 6.2 Arquivos de idiomas na imagem de instalação 6.3 Instalação de recursos 6.4 Opções da linha de comandos 6.5 Propriedades públicas 6.6 Gravando imagens administrativas em CD ou DVD 7.0 Informações sobre políticas 8.0 Comandos não incluídos ------------------------------------------------------------------- 1.0 Introdução ------------------------------------------------------------------- Este pacote faz parte do produto 5733XJ1 IBM i Access Client Solutions. É possível usar o IBM i Access Client Solutions para conectar a qualquer liberação suportada do IBM i. Este pacote contém funções que estão disponíveis somente nos sistemas operacionais Windows. Ele se baseia no produto 7.1 IBM i Access for Windows, mas não contém todos os recursos. Esse recursos incluídos neste pacote do IBM i Access for Windows são: .NET Data Provider ODBC OLE DB Secure Socket Layer e Gerenciamento de Certificado Kit de Ferramentas do Progamador para Cabeçalhos, Biblioteca e Documentação Driver da Impressora AFP Programas Requeridos incluindo: APIs Active X Segurança Capacidade de Manutenção Conexões Ativações NLS Tabelas de Conversão Propriedades Políticas Network Printing Subconjuntos de comandos (Consulte a seção 8.0 para ver s lista do que não está incluído.) Guia do Usuário Uso de Administração do Aplicativo para controlar o acesso à função no pacote Os seguintes recursos do IBM i Access for Windows não estão incluídos neste pacote. O pacote IBM i Access Client Solution de plataforma independente inclui uma substituição para esses recursos: Terminal 5250 e Emulação da Impressora Transferência de Dados Suplemento de Excel para Transferência de Dados Operations Console Os seguintes recursos do IBM i Access for Windows não estão incluídos neste pacote. O IBM Navigator for i inclui uma substituição para estes recursos: System i Navigator AFP Workbench Viewer Recebimento de Comando Remoto não incluído. A substituição é para uso dos Serviços de Desktop Remoto da Microsoft. Toolbox para Java também não está incluído. Use o seguinte website para fazer download das informações: http://www-03.ibm.com/systems/i/software/toolbox/index.html Outros recursos do IBM i Access for Windows não incluídos neste pacote são: Driver da Impressora SCS Ferramentas do Programador Java para Plug-in do System i Navigator Atualização de Diretório Suporte de Formato de Arquivo Lotus 123 Nível de Serviço de Verificação Como o conteúdo deste pacote também é fornecido com o 7.1 IBM i Access for Windows, a documentação e a versão geralmente refletem o 7.1 IBM i Access for Windows no Guia do Usuário, no Kit de Ferramentas do Programador, no texto da ajuda e nas mensagens, mas são aplicáveis também ao IBM i Access Client Solutions - Pacote de Aplicativos para Windows. ------------------------------------------------------------------- 2.0 Local de Fontes de Informações ------------------------------------------------------------------- - As mudanças feitas no IBM i Access Client Solutions, incluindo sistemas operacionais suportados, atualizações, restrições, problemas conhecidos significativos, novas informações e mais serão publicadas no website do produto IBM i Access: http://www-03.ibm.com/systems/power/software/i/access/index.html - O Guia do Usuário que é instalado com este pacote contém informações sobre como usar o produto, algumas dicas e técnicas, mensagens e informações para resolução de problemas. - Referências técnicas para o provedor OLE DB e o Provedor de Dados .NET são instaladas quando o recurso de Títulos, Bibliotecas e Documentação for instalado. É possível localizar as referências técnicas na pasta Kit de Ferramentas do Programador. - O Centro de Informações do IBM i fornece uma coleção de tópicos criados para profissionais do IBM i que precisam de acesso às informações técnicas: http://publib.boulder.ibm.com/eserver/ibmi.html - No momento desta publicação, o Centro de Informações do IBM i não inclui tópicos sobre o IBM i Access Client Solutions. Entretanto, a maioria das informações contidas no IBM i Access for Windows é aplicável a este pacote do IBM i Access Client Solutions, incluindo tópicos de instalação, administração e programação: http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzahg%2Frzahgicca2.htm - O IBM i developerWorks contém artigos, tutoriais e recursos técnicos para usuários do IBM i: https://www.ibm.com/developerworks/ibmi - O website do IBM i oferece as notícias mais recentes sobre o IBM i, bem como informações sobre o produto, uma biblioteca de referência, roteiros de educação e mais: http://www-03.ibm.com/systems/i/ ------------------------------------------------------------------- 3.0 Informações de Instalação ------------------------------------------------------------------- 3.1 Sistemas Operacionais Windows Suportados --------------------------------------- Este pacote pode ser instalado nos seguintes sistemas operacionais Microsoft Windows: - Windows Server 2019 Standard, Windows Server 2019 Datacenter - Windows Server 2016 Standard, Windows Server 2016 Datacenter - Windows 10 Pro, Windows 10 Enterprise - Windows 8.1 Pro, Windows 8.1 Enterprise, Windows Server 2012 R2 - Windows Server 2008 e Windows Server 2008 R2 Standard Enterprise (32-bit e 64bit) - Windows 7 Professional, Enterprise e Ultimate (32-bit e 64-bit) As seguintes restrições se aplicam: a) Home editions não são suportadas. b) Você deve usar os níveis de service pack do Windows que a Microsoft suporta. c) O suporte será descontinuado na data em que a Microsoft o descartar. d) A instalação não é suportada em hardware Itanium. e) Use hardware Microsoft Windows e recomendações de memória. Inclua um adicional de 256 MB de memória para funções do IBM i Access Client Solution. f) O produto não pode ser instalado quando estiver atualizando para um sistema operacional Windows diferente. Siga estas etapas: 1. Salve os dados de configuração. Desinstale o produto. 3. Faça o upgrade do sistema operacional Windows. 4. Instale o produto. 5. Restaure os dados de configuração. 3.2 Considerações de Instalação -------------------------------------------------- - São necessários autoridade e privilégios administrativos para executar a instalação. - Apenas instalações por máquina são suportadas. Instalações por usuário não são suportadas. - O Windows Installer 4.5 é necessário. Este componente de software Microsoft é instalado durante a instalação se ele já não estiver presente no sistema. É possível instalar esse componente antes da instalação fazendo o download dele pelo website da Microsoft: http://www.microsoft.com/DownLoads/details.aspx?familyid=5A58B56F-60B6-4412-95B9-54D056D6F9F4 3.3 Fazendo upgrade a partir do IBM i Access for Windows ------------------------------------------- - Atualizar a partir do IBM i Access for Windows não é suportado. Deve-se remover o IBM i Access for Windows antes de instalar esse pacote. - Consulte a Seção 1.0 para obter a lista de recursos que não estão inclusos. Se desejar continuar usando os recursos no IBM i Access for Windows não incluídos neste pacote, não instale este pacote e continue a usar o service pack do 7.1 IBM i Access for Windows mais recente. - Quando o IBM i Access for Windows for desinstalado, a configuração do sistema existente será excluída. Para preservar a configuração do sistema existente, é necessário salvar a configuração antes de desinstalar o IBM i Access for Windows e, em seguida, restaurar a configuração após a instalação do Pacote de aplicativos do Windows do IBM i Access Client Solutions ter sido instalado. Aqui estão as etapas detalhadas para salvar e restaurar a configuração: 1. Use o comando CWBBACK para fazer backup da configuração do IBM i Access for Windows. cwbback /u Por exemplo: cwbback C:\Users\IBM_ADMIN\Backup\IAWIN_CONFIG.RS /u Neste exemplo, presume-se que a pasta C:\Users\IBM_ADMIN\Backup já existe. O comando acima criará dois arquivos nessa pasta: IAWIN_CONFIG.RS IAWIN_CONFIG.ts Certifique-se de que esses dois arquivos tenham sido criados antes de ir para a próxima etapa. NOTA: Caso os dois arquivos acima não tenham sido criados, a configuração não foi salva. Tente executar o comando como um administrador elevado. Uma maneira de fazer isso é iniciando um prompt de comandos, conforme a seguir: Iniciar->Todos os programas->Acessórios->Prompt de comandos Mas, em vez de clicar com o botão esquerdo no Prompt de comandos, use o botão direito e selecione a opção para "Executar como administrador". Execute o comando cwbback mostrado acima, utilizando esse prompt de comandos. Certifique-se de que os dois arquivos acima tenham sido criados antes de ir para a próxima etapa. Desinstale o IBM i Access for Windows. 3. Reinicialize. 4. Instale o Pacote de aplicativos do Windows do IBM i Access Client Solutions. 5. Reinicialize. 6. Use o comando CWBREST para restaurar a configuração que foi salva com o comando CWBBACK. cwbrest /c Por exemplo: cwbrest C:\Users\IBM_ADMIN\Backup\IAWIN_CONFIG.RS /c Caso tenha sido necessário seguir as instruções da NOTA na etapa 1, também será preciso executar o comando cwbrest a partir do prompt de comandos de um administrador elevado. - Há algumas maneiras pelas quais é possível verificar a configuração do Windows antes e depois das etapas acima: 1. Verifique o registro do Windows. As configurações do sistema são armazenadas em: HKEY_CURRENT_USER\Software\IBM\Client Access Express\CurrentVersion\Environments\My Connections Para visualizar o conteúdo do registro do Windows nesse local, insira este comando: reg query "HKCU\Software\IBM\Client Access Express\CurrentVersion\Environments\My Connections" Caso o ambiente tenha um nome diferente do padrão "My Connections", faça a substituição adequada no caminho acima. 2. Caso você tenha a versão do IBM i Access Client Solutions independente de plataforma no mesmo PC, no painel principal da GUI é possível selecionar: Arquivo->Copiar conexões O lado direito mostrará "IBM i Access (Windows)". Esta é a configuração usada para o IBM i Access for Windows e para o Pacote de aplicativos do Windows do IBM i Access Client Solutions. 3.4 Executando a instalação ----------------------- - Execute setup.exe na imagem de instalação para iniciar a instalação. (O comando cwblaunch.exe não é fornecido com este produto). NOTA: A chamada direta de arquivos do Microsoft Installer (MSI) não é recomendada porque setup.exe usa setup.ini para obter uma lista de opções de linha de comandos a serem usadas e para atualizar a versão do Windows Installer, se necessário. - Recomenda-se utilizar o valor padrão de destino. Entretanto, se você alterar a pasta: a) Não selecione o diretório-raiz de uma unidade. b) Não selecione um diretório que já contenha arquivos não relacionados a este produto. c) Não selecione uma unidade de rede. A instalação em uma unidade de rede não é suportada. 3.5 Ação Necessária Após a Instalação do Driver de Impressora --------------------------------------------------- Se você instalar o driver de impressora APF, deverá executar uma ação antes de usar o driver da impressora. Isso é necessário porque o driver da impressora não pode ser incluído ou atualizado automaticamente durante a instalação, uma vez que o driver da impressora não é assinado digitalmente pela Microsoft. Durante a instalação, os arquivos do driver da impressora são copiados para um subdiretório chamado CWBAFP no caminho de destino que é escolhido. Supondo que você esteja instalando no caminho de destino padrão, o caminho seria: c:\Program Files\IBM\Client Access\diretório CWBAFP Use as orientações da Microsoft em seu texto de ajuda para incluir ou atualizar o driver da impressora. Quando solicitado, especifique o caminho para CWBAFP. Se estiver instalando em um PC que tenha feito upgrade do produto IBM i Access for Windows sobre várias liberações, algumas informações antigas podem possivelmente ser exibidas ao configurar o driver da impressora. Para remover as informações obsoletas de arquivos .inf, faça o seguinte depois de concluir a instalação: a) Abra uma janela de prompt de comandos. b) Altere o diretório para o diretório de instalação. O diretório de instalação padrão é c:\Program Files\IBM\Client Access. c) Digite "cwbrminf" e pressione Enter. 3.6 Considerações de Instalação de Hardware de 64 Bits ----------------------------------------------- Quando instalado em um sistema operacional Windows de 64 bits suportado: - Tanto a versão de 32 bits quanto a versão de 64 bits são instaladas para ODBC, OLE DB, ActiveX e Secure Sockets Layer (SSL). - O provedor .NET do IBM i Access for Windows executa de aplicativos de 32 e de 64 bits, dependendo do aplicativo que chama o provedor. - Apenas a versão do Driver da Impressora AFP é instalada. A versão de 64 bits é instalada em sistemas de 64 bits e a versão de 32 bits é instalada nos sistemas de 32 bits. 3.7 Logs de Instalação --------------------- Dois logs são criados durante a instalação. Um dos logs é específico para XJ1 e contém as informações de ação customizadas do produto. Este log é chamado "xe1instlog.txt" e é criado sempre no diretório temporário do usuário. O outro log é o log do Microsoft MSI que contém informações sobre eventos, sequências e propriedades do MSI. Por padrão, este log é chamado "xe1instlogmsi.txt" e é criado no diretório temporário do usuário. Você pode alterar esse log editando o setup.ini na imagem de instalação. Acesse a palavra-chave [Startup], localize e edite esta entrada CmdLine=/l*vx "%temp%\xj1instlogmsi.txt" - Para evitar a criação do log, remova a entrada - Para alterar o local e o nome do log, altere o caminho e o nome do arquivo - Para alterar o conteúdo do log, altere o /l* para opção(ões) diferente(s), conforme descrito pelas Opções da Linha de Comandos do MSDN Windows Installer da Microsoft neste local http://msdn.microsoft.com/default.aspx As informações da linha de comandos padrão em setup.ini podem ser sobrescritas iniciando setup.exe no prompt de comandos com as opções da linha de comandos. ------------------------------------------------------------------- 4.0 Requisitos do Provedor .NET do IBM.Data.DB2.iSeries ------------------------------------------------------------------- - O Provedor .NET do IBM i Access para Windows (IBM.Data.DB2.iSeries) requer que o Microsoft .NET Framework Versão 2.0 ou mais recente esteja instalado em seu sistema. A maioria dos PCs que executam sistemas operacionais Microsoft suportados já tem o .NET Framework necessário instalado. O .NET Framework pode ser transferido por download do seguinte website da Microsoft: http://www.microsoft.com/net - Para evitar interromper aplicativos .NET que foram gravados na interface do provedor .NET do Access for Windows 5.3 ou 5.4, os pedidos de tempo de execução para a versão 10.0.0.0 do provedor .NET devem ser redirecionados para a versão 12.0.0.0. Consulte o tópico "Mudanças Incompatíveis da 5.3 e 5.4" na Referência Técnica do Provedor .NET do IBM DB2 for i para obter instruções sobre como usar um arquivo app.config, web.config ou machine.config e para obter informações sobre como selecionar um compilador adequado para redirecionar aplicativos existentes. Como alternativa, o aplicativo pode ser recompilado usando um compilador mais recente para direcionar a versão 12.0.0.0 do provedor .NET incluída no release 7.1 do IBM i Access for Windows. - Para obter informações completas e uma lista de mudanças incompatíveis, instale o recurso Títulos, Bibliotecas e Documentação e, em seguida, exiba a Referência Técnica do Provedor .NET. ------------------------------------------------------------------- 5.0 Microsoft XML Parser ou Microsoft XML Core Services ------------------------------------------------------------------- Ao usar os objetos de automação do IBM i Access for Windows Data Transfer ActiveX para transferir arquivos para e do formato XML do Microsoft Excel (suportados pelo Excel 2003 e Excel XP), um software adicional deverá ser instalado em seu PC. Esse recurso requer que o Microsoft XML Parser 3.0 ou acima, também conhecido como Microsoft XML Core Services, esteja instalado em seu computador pessoal. O XML Parser está incluído em muitos produtos Microsoft. Para determinar se o suporte ao XML Parser está instalado em seu PC, consulte o artigo 278674 do Microsoft KB. Este artigo pode ser localizado no Web site da Microsoft em: http://support.microsoft.com/kb/278674 Se o Microsoft XML Parser 3.0 ou mais recente não for localizado, será necessário acessar a Microsoft na Web para obter instruções sobre como fazer download e instalar o XML Parser antes de usar o suporte XML na Transferência de Dados. Consulte o artigo 324460 do Microsoft KB para obter informações sobre como instalar o XML Parser. Este artigo pode ser localizado em: http://support.microsoft.com/kb/324460 ------------------------------------------------------------------- 6.0 Informações de Instalação Avançada ------------------------------------------------------------------- É possível usar a maioria das informações sobre como modificar o nível da interface com o usuário,usando parâmetros da linha de comandos, controlando outros métodos de comportamento e implementação no tópico "Configurando o PC" no Centro de Informações do IBM i para IBM i Access for Windows. As diferenças são descritas nesta seção. 6.1 Informações do Produto Licenciado ---------------------------------- 5733XJ1 não é compactado como um Produto Licenciado a ser instalado no sistema operacional do IBM i. Ele está disponível apenas como mídia de PC. É possível copiá-lo para o IBM i no local disponível para seus usuários, se você desejar. 6.2 Arquivos de Idioma na Imagem de Instalação -------------------------------------------- Os arquivos de instalação de idioma não são mais separados em diretórios MRI29xx diferentes na imagem de instalação. Em vez disso, há arquivos CAB separados para cada idioma. Não é possível remover esses arquivos CAB da imagem. 6.3 Recursos de Instalação -------------------- Alguns recursos de instalação do IBM i Access for Windows dependem que outros recursos de instalação sejam instalados. Essa restrição não é aplicável a este pacote. Os seguintes recursos de instalação precisam ser instalados: req (Programas Necessários) langacs, amri2924 (Inglês) Todos os outros recursos de instalação são instalados por padrão, mas é possível alterar a configuração. Os idiomas são agora recursos de instalação, exatamente como Programas Necessários, ODBC etc. Como os idiomas são recursos de instalação, é possível controlar quais idiomas são instalados usando os mesmos métodos usados para controlar qualquer recurso de instalação. Os nomes dos recursos de instalação para os idiomas são amri29xx. 6.4 Opções da Linha de Comandos ------------------------ As opções da linha de comandos padrão são especificadas no arquivo setup.ini incluído na imagem de instalação. Essas opções serão ignoradas se você chamar setup.exe a partir da linha de comandos com quaisquer opções especificadas. Se você estiver usando uma conversão na linha de comandos, os valores da linhas de comandos em setup.ini serão ignorados, pois a conversão é uma opção. Você precisará incluir outras opções na linha de comandos, tais como informações de criação de log. Consulte a Seção 3.7 Logs de Instalação para obter informações adicionais. 6.5 Propriedades Públicas --------------------- Algumas das propriedades públicas do IBM i Access for Windows são aplicáveis a este pacote. O uso tem algumas mudanças a partir do uso do IBM i Access for Windows, conforme descrito aqui: CWBINSTALLTYPE Essa propriedade é usada apenas em uma instalação pela primeira vez. Os únicos valores são Típico e Customizado. O padrão é Típico. Exemplo: setup /vCWBINSTALLTYPE=Typical CWBPRIMARYLANG O idioma principal padrão é o código de idioma do seu PC. Essa propriedade permite especificar um idioma principal diferente. O valor a ser usado é MRI29xx. Exemplo: setup /vCWBPRIMARYLANG=MRI2989 CWBUPGSSLFILES O uso dessa propriedade é igual ao IBM i Access for Windows. Ela permite fazer upgrade dos arquivos SSL durante um upgrade. Se os arquivos de configuração para SSL estiverem localizados em seu PC de destino, os arquivos serão atualizados com os certificados mais recentes. Os valores são Sim e Não. O padrão é Sim. Exemplo: setup /vCWBUPGSSLFILES=NO As propriedades comuns do Windows Installer listadas no tópico Centro de Informações do IBM i Access for Windows permanecem aplicáveis: ADDLOCAL, REMOVE, INSTALLDIR, TARGETDIR. Há uma restrição no uso da propriedade REBOOT Windows Installer com o IBM i Access for Windows. Essa restrição não é aplicável a este pacote. 6.6 Gravando Imagens Administrativas no CD ou DVD ---------------------------------------------- Devido a problemas de como alguns softwares de gravação de CD e DVD tratam nomes de arquivos longos, a gravação de uma imagem administrativa em um CD ou DVD não é recomendada. Se você tiver problemas ao instalar a partir de um CD ou DVD que contenha uma imagem administrativa do IBM i Access para Windows, copie a imagem para um diretório na unidade de disco rígido local e execute setup.exe a partir da cópia local. ------------------------------------------------------------------- 7.0 Informações de Política ------------------------------------------------------------------- O mesmo arquivo de política é usado para este pacote e para o IBM i Access for Windows. Isso significa que algumas dessas políticas não são aplicáveis quando usadas para este pacote, uma vez que algumas das funções do IBM i Access for Windows não existem neste pacote. ------------------------------------------------------------------- 8.0 Comandos ------------------------------------------------------------------- Os comandos no IBM i Access for Windows que não estão incluídos neste pacote: cwbdsk.exe cwbemcup.exe cwbinplg.exe cwbin5250.exe cwbunins.exe cwblaunch.exe cwblog.exe cwbsvd.exe cwbtf.exe cwbuisxe.exe cwbunnav.exe cwbunrse.exe cwb3uic.exe lstsplf.exe rmtcmd.exe rfrompcb.exe rtopcb.exe rxferpcb.exe srvview.exe strapp.exe [FIM DO DOCUMENTO]