## 5733XJ1 IBM i Access Client Solutions - Iniciação

## O conteúdo deste documento foi actualizado pela última vez em: 8 de Janeiro de 2018

### 0.5 Manual de Iniciação Rápida

O Manual de Iniciação Rápida contém instruções para implementar o produto que funcionarão para a maioria dos utilizadores que executem Windows, Mac ou Linux. Para instalar este produto para um único utilizador, ou para um PC de múltiplos utilizadores, consulte o Manual de Iniciação Rápida na pasta Documentation.

Detalhes adicionais sobre o produto, outras opções de implementação e personalização do produto encontram-se incluídos no resto deste documento.

### Conteúdo:

0.5 Manual de Iniciação Rápida
1.0 Introdução
2.0 Funcionalidades
3.0 Pré-requisitos
4.0 Conteúdo do Produto
5.0 Instalação
5.1 Actualizar uma Instalação Existente
6.0 Permissões de Ficheiros
6.1 Permissões de Ficheiros (Linux, Mac, AIX)
6.2 Permissões de Ficheiros (Windows)
7.0 Iniciar o Produto
7.1 Iniciar o Produto
7.2 Iniciar o Produto (utilizando um script)
7.3 Iniciar o Produto (utilizando a linha de comandos)
8.0 Configuração
8.1 Localização da Configuração
9.0 Tópicos Avançados
9.1 Mais Opções da linha de comandos
9.2 Associações de Ficheiros
9.2.1 Associações de Ficheiros (para Windows)
9.2.1.1 Alterar Ícone (para Atalho do Windows)
9.2.2 Configurar um Ícone do Ambiente de Trabalho (para Linux)
9.2.2.1 Associações de Ficheiros (para Linux)
9.2.3 Associações de Ficheiros (para Mac)
9.2.3.1 Criar Associações de Ficheiros (para Mac)
9.2.3.2 Alterar Ícone (para Mac)
9.3 Alterar a Localização da Configuração
9.4 Outras Opções de Implementação
9.4.1 Importar automaticamente definições de configuração
9.4.2 Implementação Nativa do IBM i
9.5 Pacotes Personalizados
9.6 Migrar do IBM i Access para Windows
9.6.1 Migrar Configurações do Sistema
9.6.2 Migrar Emulação 5250
9.6.3 Migrar Ficheiros de Pedidos de Transferência de Dados Guardados
9.6.4 EHLLAPI
9.6.5 Kerberos
9.7 Gestão de Chaves
9.8 Transferência de Dados
9.8.1 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc
9.8.2 Suporte de Transferência de Dados para Truncamento de Caracteres e Sobrecarregamentos Numéricos
9.8.3 Nome da Folha de Transferência de Dados
9.9 Estabelecer uma Ligação de Consola ao IBM i
9.10 Tipos de Letra Adicionais
9.11 Utilizar Credenciais a partir de um ficheiro netrc
9.12 Sistema de Ficheiros Integrados (IFS)
9.12.1 IFS, QFileSvr.400 e Segurança
9.12.2 Autoridade de IFS
9.12.3 Limitações de IFS
9.12.4 IFS e ASP Independentes
9.13 Terminal Secure Shell (SSH)
9.13.1 Pré-requisitos do Terminal de SSH
10.0 Diagnósticos de Assistência
11.0 Perguntas Mais Frequentes (FAQ, Frequently Asked Questions)
12.0 Histórico de Actualizações

### 1.0 Introdução

O IBM i Access Client Solutions é o membro mais recente da família de produtos IBM i Access. Fornece uma interface independente de plataforma baseada em Java que executa na maioria dos sistemas operativos que suportam Java incluindo Linux, Mac e Windows. O IBM i Access Client Solutions consolida as tarefas mais comuns para gerir o seu sistema IBM i numa localização simplificada.

O IBM i Access Client Solutions utiliza os mesmos servidores de sistemas centrais IBM i que os outros produtos IBM i Access Family e requer a mesma licença IBM i Access Family (XW1) para utilizar a emulação 5250 e componentes de Transferência de Dados.

Também se encontram disponíveis dois pacotes opcionais que incluem middleware para utilizar e desenvolver aplicações cliente para Windows e Linux.
IBM i Access Client Solutions - Pacote de Aplicações do Windows
IBM i Access Client Solutions - Pacote de Aplicações de Linux

Os clientes que utilizem o IBM i 7.1 ou versões posteriores que tenham a autorização de utilização actual podem adquirir o IBM i Access Client Solutions através das seguintes formas:

- Descarregar o pacote base do IBM i Access Client Solutions.
- Descarregar o pacote base e os pacotes de aplicação opcionais para Windows e Linux a partir do sítio da Web Entitled Software Support (ESS) sob 5761-SS1 ou 5770-SS1.

Os pacotes de aplicações opcionais para Windows e Linux só estão disponíveis a partir do sítio da Web Entitled Software Support (ESS).

Os clientes podem adquirir suportes ao encomendar a função de renovação 6288 de 5761-SS1 ou 5770-SS1. O suporte físico contém uma versão executável do produto que permite ao utilizador executar o produto directamente a partir do CD. O suporte físico também inclui um arquivo ZIP do produto que poderá ser copiado e extraído para uma localização à preferência do cliente. O suportes físico para o IBM i Access Client Solutions não contém os Pacotes de Aplicações do Windows e Linux opcionais.

Para obter informações adicionais visite:
http://www.ibm.com/systems/power/software/i/access/solutions.html

Para obter as informações mais recentes sobre produtos do IBM i Access Family visite:
http://www.ibm.com/systems/i/software/access/caann.html

### 2.0 Funcionalidades

As funcionalidades do IBM i Access Client Solutions incluem:

- um emulador de terminal 5250 com todas as funcionalidades baseado no IBM Rational Host-on-Demand. Para além de todos os componentes de apresentação 5250 habituais durante a utilização do IBM i Access for Windows, alguns dos componentes adicionais são:
  - suporte de tabulação que permite que múltiplas sessões partilhem uma única área de visualização
  - suporte de utilização do botão de deslocamento do rato que permite um deslocamento intuitivo entre páginas
  - comutação entre idiomas que pode ser efectuada sem ser necessário reiniciar a estação de trabalho
  - sessões de visualização em simultâneo com páginas de código de sistema central diferentes que permitem idiomas diferentes em sessões de emulador diferentes
- Emulação de impressora
- um Gestor de Sessões 5250 modelado pelo IBM Personal Communications Session Manager que poderá ser utilizado para gerir todas as sessões de emulador 5250
- Transferência de Dados que faculta a capacidade de transferir dados de/para a base de dados do IBM i de/para vários tipos de ficheiros na estação de trabalho, como por folha de cálculo OpenDocument (*.ods), Livro do Excel (*.xlsx) e outros formatos de ficheiro
- a Saída da Impressora faculta uma interface que permite visualizar ficheiros nas filas de saída do IBM i e também faculta a capacidade de descarregar estes ficheiros para o sistema de cliente.
- um Painel de Controlo Virtual com uma interface gráfica para o painel de operações do IBM i
- emulação 5250 para consolas LAN, HMC e FSM
- consolidação para configurações da interface de gestão de hardware incluindo ASMI, IVM e HMC
- capacidade de iniciar para o IBM Navigator for i utilizando o navegador predefinido
- Componentes de bases de dados como Executar Scripts SQL e Centro de Desempenho de SQL.

O Pacote de Aplicações do Windows opcional inclui:

- conectividade ao Db2 for i utilizando ODBC, .Net e OLE DB
- Toolkit de programação para aceder a objectos do sistema IBM i
- suporte para ligações TLS/SSL
- controlador de impressora AFP

O pacote de Aplicações do Linux opcional inclui:

- um controlador de ODBC para aceder ao Db2 for i e suporta tipos de dados de 64 bits completos.

### 3.0 Pré-requisitos

### 3.1 Pré-requisitos (estação de trabalho)

O IBM i Access Client Solutions irá ser executado na maioria dos sistemas operativos que suportam Java 8.0 ou superior, incluindo várias versões do Linux, Mac e Windows.

Recomendação:
Manter a versão de Java na versão mais actual irá garantir de que possuí sempre as últimas correcções de segurança.

Uma forma de verificar a versão de Java instalado no sistema é abrir um pedido de confirmação onde seja possível introduzir um comando (Linha de Comandos, Interface, Terminal, etc) e, em seguida, escrever o comando:
java -version

O seguinte resultado indica que a versão 8.0 está instalada:
java version "1.8.0_65"
O 65, neste exemplo, refere-se ao nível de actualização.

Aqui estão alguns sítios da Web de fornecedores Java. Certifique-se de que está a executar com a versão mais actualizada de Java da sua plataforma.
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
http://www.oracle.com/technetwork/java/javase/downloads/index.html
http://openjdk.java.net/install

### 3.2 Pré-requisitos (Conectividade para IBM i)

O IBM i Access Client Solutions irá estabelecer ligação ao IBM i edições 5.4 e superiores. As seguintes funcionalidades requerem o IBM i edição 6.1 ou superior:
Navigator for i
Consola 5250
Painel de Controlo Virtual

Se estiver a utilizar ligações SSL, carregue e aplique o PTF do IBM i para a respectiva edição:
7.1 - SI45610, SI55204, SI55389, SI57332, MF60335
7.2 - SI55392, SI57320, MF60333, MF60334

Se estiver a utilizar o Navigator for i, carregue e aplique o PTF do IBM i para a respectiva edição:
7.1 - Grupo de PTF SF99368 nível 37 ou posterior
7.2 - Grupo de PTF SF99713 nível 12 ou posterior

Se estiver a utilizar a Consola 5250 ou o Painel de Controlo Virtual, carregue e aplique o PTF apropriado para a respectiva edição:
6.1 - MF55543, MF55549
6.1.1 - MF55540, MF55547
7.1 - MF55485, MF55538

### 4.0 Conteúdo do Produto

Os seguintes ficheiros e directórios estão contidos no arquivo ZIP do produto:

    acsbundle.jar       - um ficheiro JAR executável do produto
    AcsConfig.properties- ficheiro que contém definições de configuração (também existe
                          dentro de acsbundle.jar)

    Mac_Application     - um directório que contém o script de instalação para Mac

    Linux_Application   - um directório que contém os scripts de instalação para Linux

    Windows_Application - um directório que contém os scripts de instalação para Windows

    Start_Programs      - directório que contém ficheiros binários específicos da plataforma que podem ser utilizados para iniciar o produto.
        Linux_i386-32
        Linux_x86-64
        Mac_i386-32_x86-64
        Windows_i386-32
        Windows_x86-64

    Documentação        - directório que contém documentação
        QuickStartGuide - informações sobre a iniciação
        GettingStarted  - informações detalhadas sobre o produto
    Licença             - um directório que contém termos e condições para a utilização
    Avisos              - um directório que contém avisos e informações
    Propriedades        - um directório que contém informações acerca da versão do produto
    Sample_Scripts      - um directório que contém scripts de exemplo que podem ser utilizados para
                          iniciar o produto se os ficheiros binários em Start_Programs
                          não funcionarem.
        Linux_Mac_Other - um directório de scripts perl para iniciar o produto de qualquer plataforma onde perl está disponível.
        Windows         - um directório que contém um JScript para iniciar no Windows
    Ícone               - um directório que contém ficheiros que podem ser utilizados como ícones
    Tipos de letra      - directório onde será possível adicionar tipos de letra de largura fixa adicionais
                          para emulação 5250

### 5.0 Instalação

A criação de pacotes do IBM i Access Client Solutions fornece várias opções de instalação, a partir de uma instalação única de utilizador muito simples, para a maioria das instalações de múltiplos utilizadores avançadas.

Os scripts de instalação foram fornecidos nas pastas Mac_Application, Linux_Application e Windows_Application (consulte a secção 4.0 Conteúdos do Produto) podem ser utilizados para uma grande variedade de opções de instalação.

Para uma instalação única de utilizador em Mac, Linux e Windows, ou para uma instalação de múltiplos utilizadores num Windows PC, consulte o Manual de Iniciação Rápida. O Manual de Iniciação Rápida explica como podem ser utilizados os scripts de instalação disponibilizados para efectuar estes tipos de instalações simples.

Se for um administrador a planear a implementação para diversos utilizadores, deverá ler o artigo IBM i Access Client Solutions: Personalização e implementação facilitadas. O artigo explica como um administrador pode pré-personalizar a instalação para múltiplos utilizadores após a implementação através da opção /AdminConfig suportada pelos scripts de instalação.

Para administradores que pretendam automatizar a instalação no modo silencioso, utilize o parâmetro /AdminConfig para pré-configurar a instalação. Em seguida, utilize o parâmetro /Q durante a instalação actual. Por exemplo:

        Windows_Application\install_acs_64.js /AdminConfig
        Windows_Application\install_acs_64.js /Q

Para além das opções anteriores, também pode ter a opção de desempacotar apenas o arquivo Zip para qualquer localização à sua escolha. Pode ser qualquer localização onde a estação de trabalho tem autoridade de leitura para aceder aos ficheiros. Isto inclui a unidade de disco rígido, uma unidade de rede remota (partilhada) ou suporte portátil tal como um CD ou unidade Flash USB. O desempacotamento do arquivo Zip conclui a instalação.

Nota Técnica:
Alguns utilitários de arquivo não preservam todos os atributos dos ficheiros guardados. Por exemplo, nas plataformas Mac e Linux, o comando unzip é geralmente uma escolha melhor do que o comando jar. Para obter informações adicionais, consulte a secção 6.0 Permissões de Ficheiros.

### 5.1 Actualizar uma Instalação Existente

As melhorias e correcções serão disponibilizadas numa base periódica. Estas actualizações são fornecidas como uma instalação de produto completa. Quando estas actualizações estão disponíveis, vai necessitar de actualizar a sua instalação existente.

Para actualizar uma instalação existente que tenha instalada através dos scripts de instalação, extraia os conteúdos de uma versão mais recente do produto. Invoque o script de instalação a partir desta nova versão da mesma forma que o fez durante a instalação inicial. Isto irá actualizar os ficheiros do produto sem alterar a configuração dos utilizadores existentes.

Para administradores que mantenham uma versão do produto numa localização central acedida por múltiplos utilizadores, poderá extrair os conteúdos da nova versão sobre a versão existente. Se efectuou alterações personalizadas ao ficheiro AcsConfig.properties, deverá guardar o ficheiro AcsConfig.properties antes de extrair os conteúdos da nova versão do produto para uma versão existente. Após extrair os conteúdos da nova versão do produto e de ter restaurado o ficheiro AcsConfig.properties, os respectivos utilizadores podem executar o script de instalação da mesma forma que a instalação inicial para actualizar as respectivas instalações.

Se escolheu instalar o produto sem utilizar os scripts de instalação para extraírem os conteúdos do arquivo Zip para a mesma localização escolhida, então, para actualizar o produto, será necessário extrair os conteúdos da nova versão do produto para a versão existente. Tenha em conta de que será necessário guardar e restaurar os conteúdos do ficheiro AcsConfig.properties se efectuou alterações personalizadas ao mesmo.

### 6.0 Permissões de Ficheiros

A Secção 7.0 Iniciar o Produto descreve várias formas diferentes de iniciar o IBM i Access Client Solutions. Se for utilizar um dos ficheiros binários ou scripts facultados para iniciar o produto, necessitará de se certificar de que as suas permissões do ficheiro têm a permissão de execução activada. As permissões de ficheiro atribuídas ao descompactar o ficheiro de arquivo .ZIP são determinadas por vários factores incluindo o sistema operativo, o utilitário de arquivamento utilizado para descompactar o arquivo .ZIP, a autoridade do utilizador, etc.

Caso tenha dificuldades em utilizar um dos ficheiros binários ou scripts facultados, verifique as permissões do ficheiro. As seguintes secções descrevem alguns métodos para verificar as permissões do ficheiro.

### 6.1 Permissões de Ficheiros (Linux, Mac, AIX)

Para sistemas operativos semelhantes ao Unix, é possível utilizar o seguinte comando a partir de um pedido de confirmação de interface ou terminal para verificar as permissões de um ficheiro:

        ls -l <ficheiro>

Para alterar as permissões de um ficheiro, é possível utilizar o seguinte comando:

        chmod <permissão> <ficheiro>

Por exemplo,
para adicionar permissão de leitura e execução para todos:

        chmod a+rx <ficheiro>

para facultar a permissão de leitura/escrita/execução ao proprietário do ficheiro e apenas leitura/execução para todos os outros:

        chmod 755 <ficheiro>

Ajuda adicional para os comandos ls e chmod está disponível na Internet.

### 6.2 Permissões de Ficheiros (Windows)

Para o Windows, enquanto visualiza o ficheiro através do explorador do Windows, faça clique com o botão direito do rato no ficheiro e seleccione propriedades. O separador de segurança contém as permissões do ficheiro. Certifique-se de que tem permissão de Leitura e Execução.

Em versões recentes do Windows, pode também utilizar o comando icacls para ver e alterar a permissão de um ficheiro.

### 7.0 Iniciar o Produto

Existem várias formas de iniciar o IBM i Access Client Solutions. Se utilizou os scripts de instalação para instalar o produto, a forma mais fácil para iniciar o produto é encontrada no Manual de Iniciação Rápida.

Se o produto não foi instalado através dos scripts de instalação, o resto desta secção irá descrever formas alternativas sobre como iniciar o produto. Uma vez que existe uma grande variedade de formas e de localizações onde/como Java pode ser instalado, alguns dos métodos poderão requerer configurações adicionais. Se um dos métodos abaixo não funcionar, tente um método diferente. Em alguns casos, são dadas instruções adicionais. Também poderá considerar a secção 11.0 Perguntas Mais Frequentes (FAQ, Frequently Asked Questions) útil.

Quando utilizar um ficheiro binário ou script conforme descrito abaixo, o ficheiro binário ou script tem de estar na estrutura de directório contida no arquivo zip. Por conveniência, também pode copiar/mover o(s) ficheiro(s) binário(s) e/ou scripts para a(s) sua(s) plataforma(s) para o mesmo directório onde existe acsbundle.jar.

### 7.1 Iniciar o Produto

Para iniciar o produto a partir de um visualizador de ficheiros (por exemplo o Explorador do Windows, Mac OS X Finder, etc) utilizando um ficheiro binário específico para a plataforma, localize o sub-directório em Start_Programs que identifica o sistema operativo e arquitectura de hardware.

Localize o ficheiro binário que o sistema operativo reconhece. Depois faça duplo clique para iniciar o produto. Pode também iniciar o produto com este ficheiro binário com uma Linha de comandos, terminal ou interface.

Se obter o seguinte erro:
"Erro ao carregar o módulo de Java."
As soluções IBM i Access Client não conseguiram localizar uma instalação java numa localização que reconhece. Poderá tentar um dos seguintes métodos nas secções:
7.1.1 Iniciar o Produto - Opções Adicionais
7.2 Iniciar o Produto (utilizando um script)
7.3 Iniciar o Produto (utilizando a linha de comandos)

Nota Técnica para Mac:
Caso seja pedido para instalar um "Java 6 SE runtime", não será necessário instalar o Java 6. Instale o Java 8 e, em seguida, tente iniciar o produto novamente. Se estiver a utilizar acslaunch_mac para iniciar o produto e continuar a receber pedidos para instalar "tempo de execução de SE de Java 6", aceda a Utilitários e inicie uma sessão de Terminal. Execute os seguintes comandos e, em seguida, tente iniciar o produto de novo:

        sudo mkdir -p /System/Library/Java/JavaVirtualMachines/1.6.0.jdk
        sudo mkdir -p /System/Library/Java/Support/Deploy.bundle

### 7.1.1 Iniciar o Produto - Opções Adicionais

Também poderá tentar um dos seguintes métodos quando tentar utilizar o ficheiro binário para a plataforma. Estes métodos permitem-lhe identificar qual o Ambiente de Tempo de Execução Java (JRE, Java Runtime Environment) que deve ser utilizado para iniciar o produto. Consulte a secção 7.1.2 Localizar o Caminho Inicial de Java para obter informações sobre como localizar o caminho inicial de Java na estação de trabalho. Estes métodos adicionais apenas são suportados em plataformas de Linux e Windows:

- Defina a variável do ambiente JAVA_HOME para o caminho inicial de Java (OU)
- Utilize a opção -vm no comando binário para especificar o caminho principal de java. Especifique -h no comando binário para obter ajuda adicional (OU)
- Copie uma estrutura de directórios de Ambiente de Tempo de Execução Java (JRE, Java Runtime Environment) para o mesmo directório que o ficheiro binário que está a tentar utilizar.

### 7.1.2 Localizar o Caminho Principal de Java

É possível iniciar o produto através de um dos seguintes métodos na secção:
7.2 Iniciar o Produto (utilizando um script) (OU)
7.3 Iniciar o Produto (utilizando a linha de comandos)
e, em seguida, é possível determinar o caminho inicial de Java na estação de trabalho a partir da interface gráfica do utilizador principal do IBM i Access Client Solutions. Na barra de menus, seleccione
Ajuda->Sobre
O caminho java.home é apresentado neste painel.

A propriedade java.home contém a localização do caminho principal de java para a sua estação de trabalho. Este é o caminho que vai necessitar de especificar quando definir a variável do ambiente JAVA_HOME ou quando utilizar a opção -vm no comando.

### 7.1.2.1 Localizar o Caminho Inicial de Java (no Windows)

Em plataformas do Windows, procure por java.exe. O binário java está normalmente localizado ou numa gaveta ou num subdirectório jre/bin abaixo do caminho principal de Java. O caminho principal Java pode ser utilizado ao definir ou a variável do ambiente JAVA_HOME ou ao utilizar a opção -vm no comando.

### 7.1.2.2 Localizar o Caminho Inicial de Java (em Linux)

Em Linux é possível utilizar o comando "which":

        which java

Isto facultar-lhe-á um caminho para o comando de Java ou uma ligação simbólica para o mesmo.

Resolve quaisquer ligações simbólicas até obter, finalmente, o ficheiro binário em si para o comando java. É possível processar ligações simbólicas através do comando ls com a opção -l:

        ls -l <ficheiro>

O binário java está normalmente localizado ou numa gaveta ou num subdirectório jre/bin abaixo do caminho principal de Java. O caminho principal Java pode ser utilizado ao definir ou a variável do ambiente JAVA_HOME ou ao utilizar a opção -vm no comando.

### 7.2 Iniciar o Produto (utilizando um script)

A iniciar em v1r1m5, o directório Start_Scripts teve o nome alterado para Sample_Scripts e foi colocado no directório Documentation (Documentação).

A forma preferencial para iniciar o produto é através da utilização de um ficheiro binário especifico para a plataforma disponível em Start_Programs. Os scripts em Sample_Scripts devem ser apenas utilizados se o binário especifico para a plataforma não funcionar.

Para iniciar o produto a partir de um navegador de sistemas de ficheiros (por exemplo o Explorador do Windows, Mac OS X Finder, etc) utilizando um dos scripts facultados, localize o script compatível com o sistema operativo no sub-directório Sample_Scripts.

A maioria dos sistemas operativos não baseado em Windows têm perl disponível por predefinição. O directório Sample_Scripts/Linux_Mac_Other contém um script perl (com três extensões de nome de ficheiros diferentes) que podem ser utilizados para iniciar o produto em qualquer plataforma onde o perl está disponível. Seleccione o ficheiro que tem uma extensão do nome do ficheiro que o sistema operativo vai reconhecer como um script perl.

Sistemas operativos baseados em Windows têm JScript disponível por predefinição. O directório Sample_Script/Windows contém um JScript que pode ser utilizado para iniciar o produto em sistemas operativos Windows.

Utilizando um método especifico de plataforma para procurar o sistema de ficheiros (ex. Explorador do Windows, Mac OS X Finder, etc), localize o script que o seu sistema operativo reconhece. Depois, faça duplo clique para iniciar o produto. Pode também iniciar o produto com este script com uma Linha de comandos, terminal ou interface.

### 7.3 Iniciar o Produto (utilizando a linha de comandos)

Também é possível iniciar o produto a partir da linha de comandos de qualquer sítio onde seja possível introduzir um comando (Linha de Comandos, Terminal, Interface, etc)

        java -Xmx1024m -jar <caminho>/acsbundle.jar

onde <caminho> é a localização do ficheiro JAR executável do produto
Por exemplo:

        java -Xmx1024m -jar V:/some_location/acsbundle.jar

ou

        <caminho_java>java -jar V:/some_location/acsbundle.jar

onde <caminho_java> é a localização do comando Java para JDK 6.0 ou superior.

Consulte a secção 7.1.2 Localizar o Caminho Inicial de Java para determinar o caminho completo para o comando Java.

Também pode utilizar qualquer um dos programas ou scripts a partir da linha de comandos. Por exemplo:

        /Product/Location/Start_Programs/Linux_x86-64/acslaunch_linux-64
        /Product/Location/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac
        C:\Product\Location\Start_Programs\Windows_x86-64\acslaunch_win-64.exe

Nota Técnica:
Na maioria das plataformas, o espaço de pilha de Java Virtual Machine tem como predefinição um tamanho máximo demasiado pequeno para utilizar múltiplas funções dentro do produto IBM i Access Client Solutions. Um tamanho da pilha máximo de um GB (-Xmx1024m) é o tamanho mínimo recomendado. Especificar tamanhos menores do que um GB ou utilizar o tamanho da pilha predefinido pode produzir uma OutOfMemoryException.

### 8.0 Configuração

Adicione uma configuração do sistema para cada sistema do IBM i que pretende utilizar ou gerir. Para adicionar a configuração do sistema, seleccione Configuração do sistema das tarefas Gestão. Depois, seleccione Novo. No separador Geral, introduza o nome do sistema. Para iniciar, o nome do sistema é tudo o que é necessário para executar tarefas Gerais.

Quando tiver concluído, seleccione OK para guardar a informação que inseriu neste sistema ou seleccione Guardar/Novo se tem sistemas adicionais que pretende adicionar às configurações.

Pode adicionar novos sistemas à sua configuração ou actualizar configurações existentes utilizando os separadores Geral, Ligação ou Consola a qualquer altura.

Para tarefas de Consola, são requeridas configurações adicionais. Configurações de consola são associadas automaticamente com o Nome do Sistema que introduziu no separador Geral. Para introduzir a configuração da consola para um sistema, seleccione Configurações de sistema das tarefas de Gestão. Seleccione Novo ou editar. Depois, seleccione o separador Consola. A tarefa Consola 5250 requer uma consola LAN ou uma consola HMC configurada. Caso não tenha uma consola de LAN ou HMC configurada, consulte a secção 9.9 Estabelecer uma Ligação de Consola ao IBM i.

A tarefa Interface de Gestão de Hardware requer uma interface de gestão de hardware configurada. Pode introduzir até duas configurações de interface de gestão de hardware.

Quando tiver concluído, seleccione Fechar no painel de Configurações do Sistema.

Utilizando a caixa de lista pendente do Sistema no painel principal do IBM i Access Client Solutions, seleccione um Sistema. Todas as tarefas de Consola associam automaticamente o Sistema seleccionado (introduzido no separador Geral) à configuração da consola (introduzida no separador Consola).

Pode, agora, seleccionar um tarefa para o sistema seleccionado. Se seleccionar uma tarefa de Consola que não possui a informação correspondente introduzida no separador de configuração Consola, será apresentada uma mensagem de erro.

### 8.1 Localização da Configuração

Por predefinição, cada utilizador terá a sua localização exclusiva para a respectiva configuração. O directório raiz de configuração é determinado de uma maneira dependente da plataforma. Os directórios de configuração serão criados durante o arranque inicial. Para visualizar onde se encontra o directório da configuração:
Inicie o produto (consulte a secção 7.0 Iniciar o Produto)
Editar->Preferências
Seleccione o separador Definições Locais
Raiz de Configuração

A localização da configuração não pode ser alterada enquanto o produto está a executar. Para alterar a localização da configuração, consulte a secção 9.3 Alterar a Localização da Configuração

### 9.0 Tópicos Avançados

### 9.1 Mais Opções da linha de comandos

Muitas das funções disponíveis a partir da interface gráfica do utilizador principal também se encontram disponíveis a partir da linha de comandos. Estas funções poderão ser invocadas através do fornecimento dos parâmetros apropriados a qualquer uma das opções da linha de comandos demonstradas na:
secção 7.3 Iniciar o Produto (utilizando a linha de comandos)

Por exemplo:

        Start_Programs\Windows_x86-64\acslaunch_win-64.exe parm1 parm2 ...

Apenas os parâmetros adicionais serão apresentados nas seguintes secções:

### 9.1.1 Cópia de Segurança

    /PLUGIN=backup  [/file=<nomeficheiro>]
        <nomeficheiro> é o nome do ficheiro a ser criado

Isto guardará a configuração actual para o ficheiro especificado. O ficheiro resultante pode ser utilizado como entrada para a opção de linha de comandos Restaurar na mesma ou em diferentes estações de trabalho (independentemente do sistema operativo).

A localização da configuração a ser guardada é determinada pela propriedade:

        com.ibm.iaccess.AcsBaseDirectory

...que se encontra no ficheiro AcsConfig.properties.

Esta função é equivalente a Ficheiro->Exportar Configuração a partir da interface gráfica do utilizador principal.

### 9.1.2 Restaurar

    /PLUGIN=restore /file=<nomeficheiro>
        <nomeficheiro> é a localização do ficheiro criado pela Cópia de Segurança

Vai restaurar uma configuração guardada do ficheiro especificado. Qualquer configuração existente que não esteja no ficheiro especificado perder-se-á.

A localização da configuração restaurada é determinada pela propriedade:

        com.ibm.iaccess.AcsBaseDirectory

...que se encontra no ficheiro AcsConfig.properties.

Esta função é equivalente a Ficheiro->Importar Configuração a partir da interface gráfica do utilizador principal.

### 9.1.3 Certdl

    /PLUGIN=certdl  /SYSTEM=<sistema>

Descarrega uma entidade certificadora (CA, certificate authority) do sistema IBM i especificado e armazena-a no arquivo fidedigno local do utilizador. É algo obrigatório para a autenticação do servidor com SS.L

### 9.1.4 Cfg

    /PLUGIN=cfg     /LIST

    /LIST     - lista os sistemas configurados com as respectivas opções de ligação

    /PLUGIN=cfg     /SYSTEM=<sistema> [/ipaddr=<frequência>] [/userid=<idutilizador>]
                                     [/ssl=<comutador>]
                                     [/5250path=<caminho>]
                                     [/del]  [/r]

        /SYSTEM     - nome do sistema
        /ipaddr     - quando uma ligação é solicitada, este valor determina se
                      irá ocorrer uma procura do endereço de IP. As frequências válidas
                      são:
                          ALWAYS - procurar o endereço de IP para cada ligação
                          HOURLY, DAILY, WEEKLY - procurar o endereço de IP se a quantidade de
                              tempo tiver decorrido desde a última procura
                         Endereço de IP - se um endereço de IP for especificado, a frequência
                              da procura é assumida como sendo NEVER
        /userid     - ID de utilizador para um utilizador
                      também poderá ser definido para os seguintes valores:
                          *SHARE        - pede uma vez as credenciais de início de sessão que
                                          que serão partilhadas por sistemas que utilizam esta opção.
                          *PROMPTALWAYS - perguntar pelo menos uma vez para cada ligação
          *KERBEROS     - utilize o nome primário de Kerberos, sem pedir informações    /ssl        - comutador é 0 para desligar o modo SSL ou 1 para o ligar
        /5250path   - caminho para os perfis de emulação 5250
                      O /5250path poderá ser definido por Ficheiro->Alterar Directório... de
    Gestor de sessões 5250   /del elimina configuração existente    /r   substitui a configuração existente

Isto permite várias opções de configuração a serem definidas a partir da linha de comandos. Estas opções podem também ser definidas a partir do GUI principal utilizando Configurações do sistema.

### 9.1.5 Cópia de Memória

    /PLUGIN=dump  [/<opções>]

Pede a todos os processos em execução no produto para fazer cópia da memória das respectivas sessões. Estas informações serão utilizadas por serviços IBM para fornecer ajuda técnica.

É possível aceder aos registos criados a partir da interface gráfica do utilizador principal através de:
Editar->Preferências
Separador Definições Locais
Directório Cópias de Memória

Caso não sejam especificadas opções, esta função é equivalente à seguinte função da interface gráfica do utilizador principal:
Ferramentas->Criar Registos de Serviço

As opções válidas são:

        /heapdump - executa o procedimento acima mencionado e ainda uma cópia de memória da pilha JVM

### 9.1.6 Medic

    /PLUGIN=medic

Empacota os registos existentes e cópias de memória da sessão num ficheiro ZIP que pode ser enviado para a IBM para serviço.

É possível aceder ao ficheiro ZIP resultante a partir da interface gráfica do utilizador principal através de:
Editar-Preferências
Separador Definições Locais
Directório Service
Esta função é equivalente a Ferramentas->Registos de Serviço do Pacote a partir da interface gráfica do utilizador principal.

### 9.1.7 Registo

    /PLUGIN=log  /LEVEL=<Nível>
                    <Nível> é um dos seguintes níveis de registo de suporte:
                    OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST

Este suplemento permite ao utilizador comutar o nível de registo a partir da linha de comandos.

Também é possível definir o nível de registo a partir da interface gráfica do utilizador principal através de:
Editar->Preferências
Separador Geral
Nível de Registo

### 9.1.8 Iniciar Sessão

    /PLUGIN=início de sessão    /SYSTEM=<sistema> [/USERID=<IDutilizador>] [/PASSWORD=<palavra-passe>] [/AUTH] [/C] [/GUI=<1|0>]

        /SYSTEM   - nome do sistema
        /USERID   - ID do utilizador
        /PASSWORD - palavra-passe associada ao ID do utilizador
        /AUTH     - tenta ligar-se ao sistema com credenciais de início de sessão especificadas
                    e apenas as coloca em cache em caso de êxito
        /C        - limpa a cache
        /GUI      - se pode, ou não, ser utilizada uma interface gráfica do utilizador

Este comando vai colocar na cache a palavra-passe e o ID de utilizador que podem ser utilizados para impedir o pedido de palavra-passe.

### 9.1.9 props

    /PLUGIN=props

Abre o mesmo painel da interface gráfica do utilizador que Editar->Preferências da interface gráfica do utilizador principal.

### 9.1.10 Maint

    /PLUGIN=maint [/<opções>]

    As opções válidas são:
        /killdaemon     - termina módulos daemon.
                          O mesmo que Ferramentas->Repor para Manutenção a partir da interface gráfica do utilizador principal
        /clearpwcaches  - limpa todas as palavras-passe em cache
        /clearjarcache  - limpa a cache do ficheiro JAR do produto
        /clearlogs      - limpa o Directório Registos em Editar->Preferências
                          Separador Definições Locais a partir da interface gráfica do utilizador principal
        /cleardumps     - limpa o Directório Cópias de Memória em Editar->Preferências
                          Separador Definições Locais a partir da interface gráfica do utilizador principal
        /clearsvcdir    - limpa o Directório Serviço em Editar->Preferências
                          Separador Definições Locais a partir da interface gráfica do utilizador principal
        /clearsettings  - limpa todas as definições para o utilizador actual

Caso não sejam especificadas opções, não serão efectuadas quaisquer acções.

### 9.1.11 Ping

    /PLUGIN=ping /SYSTEM=<sistema> [</opções>]
        As opções incluem:
            /SSL=<1|0>        Ligar ou desligar SSL
            /ACCEPTALLCERTS=<1|0> Adicionar ou não automaticamente todos os
                              certificados de SSL ao conjunto fidedigno (quando utilizar SSL).
            /SERVERAUTH=<1|0> Ligar ou desligar a autenticação do Servidor SSL (a predefinição é
                              desligado). Esta opção é ignorada se não testar o SSL.
            /GUI=<1|0>        Alternar a janela GUI entre ligada/desligada (a predefinição é desligado caso seja iniciada
                              a partir da linha de comandos)
            /PORTS=<port1,port2> Uma lista separada por vírgulas de portas a testar. Poderão ser
                    números ou nomes de serviços (por exemplo /PORTS=as-signon,as-sts). Caso não seja
                    especificada, é testado um conjunto predefinido de portas.
                    Especificar .CONSOLE irá verificar uma lista de portas específicas da consola.

            /TIMEOUT=<segundos>   Especifique um valor de tempo de espera, em segundos.

O suplemento verifica a conectividade ao IBM i estabelecendo uma ligação à porta adequada. Se está a verificar uma ligação SSL, há uma tentativa de (protocolo de) reconhecimento SSL. Se for iniciado a partir de um GUI principal ou invocado com /GUI=1, este suplemento mostra um diálogo. Se iniciado de uma linha de comandos sem /GUI=1, o resultado é enviado para a consola.

Por predefinição, os seguintes serviços estão marcados:
as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda,
as-signon

Esta função pode ser iniciada a partir da interface gráfica do utilizador principal através de:
Configurações do Sistema
seleccione um sistema e, em seguida, Editar
Separador Geral
Verificar Ligação

### 9.1.12 Sm

    /PLUGIN=sm

Este suplemento inicia o GUI gestor de sessões 5250.

É equivalente ao Gestor de sessões 5250 do GUI principal.

### 9.1.13 5250

    /PLUGIN=5250 /SYSTEM=<system> [/<opções>]

    Este suplemento inicia um emulador 5250 com o sistema especificado.
    Esta função é equivalente ao Emulador 5250 do GUI principal.
    As opções válidas são:
        /id=<A-Z>                    - ID de sessão curta
        /name=<name>                 - nome da sessão
        /wsid=<identifier>           - id da estação de trabalho
        /wide=<1|0|true|false>       - utilize um tamanho de ecrã largo (27x132)
        /fullscreen<1|0|true|false>  - utilize o ecrã completo
        /nosave=<1|0|true|false>     - não guardar definições ao sair
        /prompt=<1|0|true|false>     - forçar o diálogo de configuração a aparecer
        /port=<port>                 - número de porta
        /ssl=<1|0|true|false>        - ligar através da utilização de secure sockets
        /sso=<1|0|true|false>        - ignorar ecrã de início de sessão
        /kerberos                    - Utilizar kerberos
        /width=<width>               - largura inicial da janela do emulador
        /height=<height>             - altura inicial da janela do emulador
        /xpos=<xpos>                 - posição da coordenada X inicial do canto superior esquerdo
                                       da janela do emulador
        /ypos=<ypos>                 - posição da coordenada Y inicial do canto superior esquerdo
                                       da janela do emulador
        /watermark                   - apresentar o nome do sistema como marca d'água no ecrã
        /watermark=<text>            - apresentar o texto facultado como marca d'água no ecrã

### 9.1.14 DTGui

    /PLUGIN=dtgui

    Este suplemento inicia o GUI principal para a Transferência de Dados.
    Esta função é equivalente à Transferência de Dados a partir do GUI principal.

### 9.1.15 Descarregar

    /PLUGIN=download [/userid=<idutilizador>] <filename> [<nomeficheiro> <nomeficheiro> ...]

        /userid   - ID de utilizador a utilizar aquando da ligação ao sistema de destino
        <filename>- ficheiro com a extensão .dtfx criado a partir de um descarregamento
                    da Transferência de Dados anterior.

O suplemento permite ao utilizador executar um descarregamento de Transferência de Dados guardado anteriormente.

A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados.

### 9.1.16 Carregar

    /PLUGIN=upload   [/userid=<idutilizador>] <filename> [<nomeficheiro> <nomeficheiro> ...]

        /userid   - ID de utilizador a utilizar aquando da ligação ao sistema de destino
        <filename>- ficheiro com a extensão .dttx criado a partir de um carregamento
                    da Transferência de Dados anterior.

O suplemento permite ao utilizador executar um carregamento de Transferência de Dados guardado anteriormente.

A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados.

### 9.1.17 CLDownload

    /PLUGIN=cldownload /system=<sistema>
                              [/userid=<idutilizador>]
                              {/hostfile=<biblioteca/nomeficheiro> | /sql="statement"}
                              {/clientfile=<caminho><nomeficheiro>.<extensão> | /display}

        /userid   - ID de utilizador a utilizar aquando da ligação ao sistema de destino
        /hostfile   - Biblioteca e ficheiro de origem no sistema IBM i para o descarregamento
                      por exemplo /hostfile=QIWS/QCUSTCDT
        /sql        - especificar uma instrução SQL
                      por exemplo /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
        /clientfile - Localização do ficheiro de destino para o descarregamento
                      O formato deste ficheiro será determinado pela extensão
                      especificada (por exemplo, .csv .ods .xlsx .xlsx)
                      Se a extensão do ficheiro não for especificada ou for de um tipo
                      não suportado, os dados serão formatados como um ficheiro .csv
        /display    - escrever a saída de dados para o terminal

O suplemento permite ao utilizador executar uma simples transferência de um ficheiro inteiro a partir da linha de comandos.

### 9.1.18 Consola

    /PLUGIN=console /SYSTEM=<sistema>

Este suplemento inicia uma consola 5250 para o sistema especificado.

Esta função é equivalente a uma Consola 5250 a partir do GUI principal.

### 9.1.19 VCP

    /PLUGIN=vcp /SYSTEM=<sistema>

Este suplemento inicia um Painel de Controlo Virtual para o sistema especificado.

Esta função é equivalente a um Painel de Controlo Virtual a partir do GUI principal.

### 9.1.20 L1C

    /PLUGIN=l1c /SYSTEM=<sistema>

Este suplemento inicia um navegador para o IBM Navigator for i utilizando sistema especificado e a porta 2001.

Esta função é equivalente ao Navigator for i a partir do GUI principal.

### 9.1.21 SPLF

    /PLUGIN=splf /SYSTEM=<sistema>

Este suplemento apresenta o GUI da Saída da Impressora para visualizar e transferir ficheiros em spool a partir do IBM i.

Esta função é equivalente à Saída da Impressora a partir do GUI principal.

### 9.1.22 KEYMAN

    /PLUGIN=keyman

Este suplemento apresenta a ferramenta Gestão de Chaves.

Esta função é equivalente a Ferramentas->Gestão de Chaves a partir da interface gráfica do utilizador principal.

### 9.1.23 RMTCMD

    /PLUGIN=rmtcmd /SYSTEM=<sistema>
                      {/CMD="<comando CL>" | file=<nome_ficheiro>}
                      [/ignorefailure=<1|0>]

        /cmd="<comando CL>"  - um comando a executar. Utilize plicas para evitar espaços da
                               quebra do comando.
        /file=<nome_ficheiro>    - especifique um ficheiro de entrada com vários comandos. Os comandos
                               deverão ser apresentados um por linha sem plicas.
        /noprompt=<1|0>      - ao especificar um ficheiro de entrada, ignore os resultados e
                               quaisquer pedidos de confirmação antes de prosseguir.

Este suplemento envia comando(s) CL para o sistema especificado.

Esta função apenas está disponível a partir da linha de comandos.

### 9.1.24 PWCHANGE

    /PLUGIN=pwchange /SYSTEMS=<sistema,sistema,sistema,...>

Este suplemento altera a palavra-passe nos sistemas especificados. Pede um ID de utilizador, palavra-passe nova e palavra-passe antiga ao utilizador.

Também é possível utilizar esta função a partir da interface gráfica do utilizador principal através da selecção do separador Palavras-Passe a partir de Editar->Preferências

### 9.1.25 MIGRATE

    /PLUGIN=migrate /<opção> /SYSTEM=<sistema>

    <sistema> poderá ser definido para um nome de sistema ou definido para *ALL para indicar todos os sistemas.

    As opções válidas são:
        /IMPORT - Copiar uma (ou todas) a(s) configuração(ões) do sistema da configuração do Windows
                  já existente para o IBM i Access Client Solutions.
        /EXPORT - Copiar uma (ou todas) a(s) configuração(ões) do sistema para a configuração do Windows
                  já existente a partir do IBM i Access Client Solutions.
        /DELETE - Eliminar uma (ou todas) a(s) configuração(ões) do sistema da configuração do Windows já existente.

Este suplemento faculta a capacidade de copiar configurações do sistema alternadamente entre o IBM i Access Client Solutions e a configuração do Windows já existente, suportada pelo IBM i Access for Windows.

Também é possível utilizar esta função a partir da interface gráfica do utilizador principal através da selecção de Ficheiro->Copiar Ligações

### 9.1.26 RESTRICT

Nota: Este suplemento apenas está disponível para utilizadores com autoridade de administrador ou root.

    /PLUGIN=restrict /<opções>

    As opções válidas são:
         /restrict=<func1,func2,func3>   Restringe as funções facultadas nesta
                                         estação de trabalho.
         /unrestrict=<func1,func2,func3> Permite as funções facultadas nesta
                                         estação de trabalho.
         /list                           Lista se as funções têm permissão ou se são
                                         restringidas nesta estação de trabalho.
         /export=<ficheiro>                  Exportar restrições para o ficheiro denominado com
                                         uma extensão de ficheiro .acsr.
         /import=<ficheiro>.acsr             Importar restrições de um ficheiro com
                                         uma extensão de ficheiro .acsr.
         /exportreg=<ficheiro>               Exportar um ficheiro de registo do Windows (ficheiro .reg).

Este plug-in fornece a capacidade para qualquer utilizar com autoridade de administrador ou root restringir certas funções de todos os utilizadores na estação de trabalho actual.

       Função           Descrição
        cfg             Configurações do Sistema
        sm              Gestor de Sessões 5250
        5250            Emulador 5250
        vcp             Painel de Controlo Virtual
        console         Consola 5250
        consoleprobe    Procurar configurações de consola na rede local
        hmcprobe        Procurar uma HMC por partições
        hmi1            Interface de Gestão de Hardware 1
        hmi2            Interface de Gestão de Hardware 2
        keyman          Gestão de certificados SSL/TLS
        dtgui           Interface gráfica do utilizador da Transferência de Dados
        upload          Carregamentos em lotes da Transferência de Dados
        download        Descarregamentos em lotes da Transferência de Dados
        cldownload      Descarregamentos em lotes da Transferência de Dados
        l1c             IBM Navigator for i (Consola de Nível 1)
        rmtcmd          Comando remoto (disponível a partir da linha de comandos)
        splf            Saída da Impressora (ficheiros em spool)
        ifs             Sistema de Ficheiros Integrados
        db2             Esquemas
        rss             Executar Scripts de SQL
        db2tools        Centro de Desempenho de SQL
        sysdbg          IBM i System Debugger
        checkupdates    Verificar se existem actualizações disponíveis
        ssh             Secure Shell

Funções que também podem ser excluídas através da utilização de palavras-chave de grupos:

       Grupo             Funções
      dataxfer          dtgui,upload,download,cldownload
      emulator          sm,5250
      keyman            keyman
      opconsole         console,vcp,consoleprobe,hmcprobe
      rmtcmd            rmtcmd
      splf              splf
      ifs               ifs
      hwconsole         hmi1,hmi2
      l1cplugin         l1c
      database          db2,rss,db2tools
      debugger          sysdbg
      checkupdates      checkupdates

A capacidade para restringir funções também está disponível para um administrador ou utilizador com autoridade root a partir da GUI principal.
Editar->Preferências
Separador Restrições

Para uma forma mais fácil para restringir funções em múltiplas estações de trabalho, consulte a secção 9.5 Pacotes Personalizados.

### 9.1.27 RESTRICTVIEW

    /PLUGIN=restrictview

Lista as funções que estão actualmente restringidas nesta estação de trabalho.

### 9.1.28 FILEASSOC

    /PLUGIN=fileassoc [<tipoficheiro> <tipoficheiro> ...] [/c]

        <filetype>   - os tipos de ficheiro válidos são:  dttx, dtfx, hod, bchx, ws, bch
        /c           - limpa a associação de ficheiro para os tipos de ficheiro especificados

Numa plataforma Windows, isto define as associações de ficheiros para ficheiros de tipo .dttx, .dtfx, .hod, .bchx, .ws e .bch. Numa plataforma não-Windows, será apresentada uma mensagem de erro.

Esta função é equivalente a Ferramentas->Associações de Ficheiros a partir da interface gráfica do utilizador principal.

### 9.1.29 DTBATCH

    /PLUGIN=dtbatch [/userid=<idutilizador>] <filename> [<nomeficheiro> <nomeficheiro> ...]

        /userid   - ID de utilizador a utilizar aquando da ligação ao sistema de destino
        <nomeficheiro>- ficheiro com a extensão .dtfx ou .dttx criado a partir de um
                    descarregamento ou carregamento da Transferência de dados anterior.
                    Podem ser especificados múltiplos ficheiros com ou sem esta palavra-chave.

O plug-in permite ao utilizador executar um pedido de Transferência de Dados guardado anteriormente.

A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados.

### 9.1.30 PM5250

    /PLUGIN=pm5250 [/input=<ficheiro> ... /output=<directório>] [/verbose] [/gui]

        /input    - Ficheiros a migrar.  Os ficheiros têm de ser ficheiros 5250 com
                    uma extensão de .ws, .bch, .kmp, .pmp ou .bar.
        /output   - localização onde os ficheiros migrados serão armazenados.
        /verbose  - apresenta resultados de ficheiros migrados.
        /gui      - inicia a interface de utilizador para migrar ficheiros 5250.

O suplemento permite que o utilizador migre ficheiros do emulador do IBM i Access for Windows Personal Communications para o emulador do IBM i Access Client Solutions. Alguns ficheiros convertidos terão uma nova extensão de ficheiro. Consulte a secção 9.6.2 Migrar Emulação 5250.

### 9.1.31 RSS

    /PLUGIN=rss /SYSTEM=<system> /DATABASE=<database> [/FILE=<file>] [/SQL=<file>] [/AUTORUN=<0,1>]

        /FILE=<filename> - Abre o ficheiro especificado
        /SQL=<filename>  - Abre o ficheiro especificado
        /AUTORUN=<1,0>   - Executa o script automaticamente

O suplemento permite ao utilizador executar instruções de SQL e comandos de CL.

### 9.1.32 DB2TOOLS

    /PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<database> [Options]

    As opções válidas são:
        /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                        - Acção a executar:
                          A opção LIST pode ser utilizada com o argumento LISTNAME e apresenta o
                          Centro de Desempenho de SQL com a lista especificada.
                          A opção ANALYZE analisa o conjunto de dados de desempenho facultado.
                          A opção STATEMENTS mostra as instruções para a cache de plano de SQL ou
                          o dado conjunto de dados de desempenho.
                          A opção COMPARE compara o(s) dado(s) conjunto(s) de dados de desempenho.
        /NAME=<name>    - O nome do conjunto de dados de desempenho
        /TABLE=<name>   - O nome da tabela que contém os dados de desempenho
        /SCHEMA=<name>  - O nome do esquema da tabela que contém dados de desempenho
        /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE>
                        - A lista inicial a apresentar no Centro de Desempenho de SQL.

O suplemento do Centro de Desempenho de SQL faculta um conjunto de ferramentas para ajudar a optimizar o SQL nas aplicações da base de dados:

- Analisar - Fornece uma vista resumida dos dados de desempenho recolhidos que servem como um ponto de lançamento para uma análise mais profunda ao utilizar navegação de pesquisa detalhada.
- Comparar - Veja uma comparação de resumo de duas, ou mais, recolhas de dados de desempenho e, em seguida, escolha duas para uma comparação de instruções mais profunda.
- Mostrar Instruções - Trabalhe com instruções de SQL na Cache de Plano de SQL ou numa recolha de dados de desempenho.
- Visual Explain - Crie uma representação gráfica do plano de execução da instrução para ver exactamente como as instruções de SQL funcionam.
- Cache de Plano de SQL - Faça a gestão das definições da Cache de Plano de SQL do sistema.

### 9.1.33 IFS

    /PLUGIN=ifs /SYSTEM=<system>

O Sistema de Ficheiros Integrado faculta uma interface para procurar o sistema de ficheiros integrado do IBM i e trabalhar com os objectos no sistema de ficheiros integrado das seguintes maneiras:

- Copiar objectos entre o sistema cliente e o IBM i
- Copiar objectos com o sistema de ficheiros integrado num IBM i ou para o sistema de ficheiros integrado em outro IBM i
- Enviar objectos para outro IBM i (ou vários)
- Criar novas pastas (directórios, bibliotecas e pasta)
- Eliminar objectos
- Mudar o nome dos objectos
- Visualizar propriedades dos objectos

Consulte a secção 9.12 Sistema de Ficheiros Integrado (IFS, Integrated File System) para obter os requisitos e limitações ao utilizar este suplemento.

### 9.1.34 DB2

    /PLUGIN=DB2 /SYSTEM=<system>

Este suplemento faculta uma interface para gerir as bases de dados Db2 for i no IBM i.

### 9.1.35 CHECKUPDATES

    /PLUGIN=checkupdates

O suplemento faculta uma interface para verificar se existem actualizações disponíveis.

### 9.1.36 SSH

    /PLUGIN=SSH /SYSTEM=<system>

O Terminal SSH iniciará um cliente SSH já instalado (emulador de terminal) no seu PC para o sistema de ficheiros integrado do IBM i.

### 9.2 Associações de Ficheiros

Alguns ficheiros de configuração criados pelo IBM i Access Client Solutions são suportados a partir da linha de comandos quando são facultados como o primeiro e único parâmetro. Quando estes ficheiros com extensões do nome do ficheiro especificas são fornecidas como o primeiro parâmetro, o IBM i Access Client Solutions vai associar o ficheiro com a função a ser invocada e fornecer o ficheiro como entrada a essa função.

As seguintes extensões têm suporte de associação de ficheiros:

        .dttx   - pedido de carregamento da Transferência de Dados
        .dtfx   - pedido de descarregamento da Transferência de Dados
        .hod    - perfil da sessão do emulador 5250
        .bchx   - perfil de emulação de sessões múltiplas
        .ws     - perfil da sessão do emulador 5250 (Personal Communications)
        .bch    - perfil de emulação de sessões múltiplas (Personal Communications)

Exemplos da linha de comandos:

        acslaunch_xxx dt_download_file.dtfx - executa a operação de descarregamento guardada
        acslaunch_xxx dt_upload_file.dttx   - executa a operação de carregamento guardada
        acslaunch_xxx system_lp13ut20.hod   - inicia uma sessão 5250 para o sistema

...onde acslaunch_xxx é a sintaxe da linha de comandos para iniciar o produto. Consulte a secção 7.3 Iniciar o Produto (utilizando a linha de comandos).

Estas associações de ficheiro de linha de comandos suportadas permitem ao utilizado configurar manualmente associações de ficheiros específicos do sistema operativo (OS, operating system). Uma vez que associações de ficheiros são dependentes de plataformas, os passos necessários dependem do OS.

A razão pela qual pode considerar estabelecer associações de ficheiros para o OS é para ter a capacidade de fazer duplo clique num ficheiro (de um dos tipos de ficheiro suportados supracitados) para iniciar a função designada.

As secções seguintes fornecem alguns exemplos sobre estabelecer associações de ficheiros para alguns sistemas operativos.

### 9.2.1 Associações de Ficheiros (para Windows)

1. A partir da barra de menus da interface gráfica do utilizador principal, seleccione Ferramentas->Associações de Ficheiros...
2. Seleccione os tipos de ficheiros para os quais pretende criar associações de ficheiros.
3. Seleccione OK

A função apropriada do IBM i Access Client Solution vai executar quando fizer duplo clique nos ficheiros deste tipo.

### 9.2.1.1 Alterar Ícone (para Atalho do Windows)

1. Localize o atalho criado anteriormente para o ficheiro binário apropriado para a arquitectura de hardware (acslaunch_win-32.exe OU acslaunch_win-64.exe)
2. Faça clique com o botão direito do rato e seleccione Propriedades
3. Seleccione o separador Atalho
4. Faça clique no botão Alterar Ícone...
5. Seleccione o ícone a utilizar para este atalho
6. Seleccione OK
7. Seleccione OK

### 9.2.2 Configurar um Ícone do Ambiente de Trabalho (para Linux)

Siga os passos no Manual de Iniciação Rápida para Linux. Isto irá instalar a aplicação para /opt/ibm/iAccessClientSolutions. Também criará: /usr/share/applications/IBM i Accesss Client Solutions.desktop

Para criar um ícone para o produto no ambiente de trabalho, copie o ficheiro .desktop referido acima para a pasta Desktop. Poderá ser necessário ajustar as permissões de ficheiro no ambiente de trabalho de forma a ser executável.

### 9.2.2.1 Associações de Ficheiros (para Linux)

Os passos requeridos para configurar associações de ficheiros dependerão na distribuição do Linux e no ambiente de trabalho que estão a ser utilizados. Regra geral, os passos requeridos vão ser semelhantes aos passos listados acima utilizados pelo Windows.

1. Localize um ficheiro que pretende associar que contém uma extensão suportada (por exemplo .hod, .bchx, .dtfx ou .dttx)
2. Faça clique com o botão direito do rato no ficheiro. Procure opções ou propriedades que lhe permitam associar um programa a um ficheiro.
3. Associe o ficheiro e/ou a respectiva extensão com o ficheiro binário ou script de início apropriado do IBM i Access Client Solutions.

### 9.2.3 Associações de Ficheiros (para Mac)

Para poder utilizar Associações de Ficheiros num Mac, o tipo de ficheiro tem de estar associado a uma aplicação. Siga os passos no Manual de Iniciação Rápida para Mac para que o IBM i Access Client Solutions seja uma aplicação instalada.

### 9.2.3.1 Criar Associações de Ficheiros (para Mac)

1. Utilize o Localizador para localizar um ficheiro que pretende associar que contém uma extensão suportada (por exemplo .hod, .bchx, .dtfx ou .dttx)
2. Seleccione o ficheiro e, em seguida, Ficheiro->Obter Informações
3. Sob a opção "Abrir com:" seleccione Outro
4. Procure a localização da aplicação IBM i Access Client Solutions.
5. Seleccione a aplicação.
6. Marque a caixa para Abrir Sempre Com. Seleccione Adicionar.
7. Em "Abrir com:" seleccione Alterar Todos. Seleccione continuar para qualquer diálogo.

A função apropriada do IBM i Access Client Solution vai executar quando fizer duplo clique nos ficheiros deste tipo.

### 9.2.3.2 Alterar Ícone (para Mac)

Utilize a aplicação Pré-Visualização para localizar a pasta Ícones dentro do directório do produto e utilize o Localizador para substituir o ícone em Obter Informações.

1. Em Pré-Visualização, seleccione Ficheiro->Abrir
2. Localize o directório Ícones do produto
3. Seleccione o ficheiro que contém o Ícone e, em seguida, Abrir
4. Seleccione Editar->Seleccionar Todos
5. Seleccione Editar->Copiar
6. A partir do Localizador, localize o ficheiro .hod, .bchx, .dtfx ou .dttx cujo ícone irá ser alterado.
   Caso o ficheiro já se encontre no ambiente de trabalho, faça clique no mesmo para o seleccionar. Caso contrário, Seleccione Ir->Ir Para Pasta e, em seguida, introduza o caminho para o ficheiro e, em seguida, Ir.
   Faça clique no ficheiro para seleccionar o mesmo.
7. Ficheiro->Obter Informações
8. Faça clique no ícone no topo de Obter Informações
9. Editar->Colar

### 9.3 Alterar a Localização da Configuração

Por predefinição, cada utilizador terá a sua localização exclusiva para a respectiva configuração. É possível alterar a localização da configuração através da definição da propriedade:
com.ibm.iaccess.AcsBaseDirectory
Esta propriedade existe dentro do ficheiro AcsConfig.properties.

O ficheiro AcsConfig.properties existe em duas localizações quando o produto é enviado. Encontra-se no ficheiro acsbundle.jar. Por conveniência, é também facultado no ficheiro de arquivo zip do produto e estará no mesmo directório que o ficheiro acsbundle.jar quando o arquivo zip for descompactado.

Durante o iniciar, o produto apenas vai utilizar o primeiro ficheiro AcsConfig.properties que localizar. Primeiro verifica o directório onde se encontra o ficheiro acsbundle.jar. Caso AcsConfig.properties não seja localizado no mesmo directório que o ficheiro acsbundle.jar, utilizará o ficheiro AcsConfig.properties dentro do ficheiro acsbundle.jar.

Pode seleccionar por actualizar AcsConfig.properties em acsbundle.jar com um caminho de configuração personalizado. Se o fizer, certifique-se de que o directório onde se encontra o acsbundle.jar não contém um ficheiro AcsConfig.properties, caso contrário este será utilizado. Isto faculta a flexibilidade de poder distribuir a localização da configuração com o ficheiro acsbundle.jar enquanto faculta também a flexibilidade para o substituir.

São facultadas palavras-chave especiais que podem ser utilizadas quando definir o caminho da configuração. Quando as palavras-chave são utilizadas no caminho especificado, as palavras-chave serão substituídas pelo texto ou caminho que definem. Apenas uma palavra-chave pode ser utilizada no caminho de configuração. As palavras-chave especiais e respectivos significados são:

    	{USER} - O ID do utilizador actual. Esta palavra-chave poderá situar-se em qualquer lado no caminho

As seguintes palavras-chave apenas poderão situar-se no início do caminho especificado:

    	{PRODUCTDIR} - o caminho para o mesmo directório que acsbundle.jar
    	{TEMPDIR}    - o caminho para um directório temporário específico da plataforma
    	{ROOT}       - o caminho para a raiz do sistema de ficheiros
    	{HOME}       - o caminho para o directório inicial do utilizador
    	{DEFAULT}    - o caminho predefinido que o produto utilizaria normalmente

Nota Técnica:
Não recomendamos a partilha de uma configuração entre vários utilizadores. Por exemplo, se X fosse uma unidade de rede partilhada, a seguinte definição poderia provocar resultados imprevisíveis:

        com.ibm.iaccess.AcsBaseDirectory=X:/Shared_Network_drive/config_directory

Existem vários problemas com a partilha deste caminho de configuração por vários utilizadores:

1. Ocorrerão resultados imprevisíveis caso vários utilizadores utilizem a configuração em simultâneo.
2. Este exemplo assume que cada utilizador tem a unidade X mapeada para a mesma localização.
3. Utilizar uma unidade de rede na configuração não funcionaria a partir de um cliente Linux ou Mac. Utilizar as palavras-chave facultadas, como nos exemplos abaixo, irá funcionar em Windows, Linux e Mac.

Quando se partilha um caminho de configuração entre múltiplos utilizadores, deve ser utilizada a palavra-chave {USER} para evitar colisões com outros utilizadores. Será substituída pelo ID de utilizador do utilizador actual.

Quando definir o caminho de configuração, utilize uma barra ('/') em vez de uma barra invertida ('\') como separador de directórios. Isto irá funcionar em todos os sistemas operativos, incluindo o Windows.

Eis algumas configurações exemplo recomendadas:

Exemplo 1 - configuração local para o utilizador actual (predefinição):

        com.ibm.iaccess.AcsBaseDirectory=

Quando AcsBaseDirectory não está definido, a configuração tem por predefinição um caminho dependente da plataforma para o utilizador. Esta é a definição para o IBM i Access Client Solutions.

Exemplo 2 - configuração remota (ou local) exclusiva para cada utilizador:

        com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/

A configuração será remota ou local com base na localização de {ROOT}.

Exemplo 3 - configuração remota (ou local) exclusiva para cada utilizador:

        com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/

A configuração será remota ou local com base na localização de {PRODUCTDIR}.

Exemplo 4 - configuração local num suporte portátil (como uma unidade USB):

        com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory

Uma vez que o caminho para o suporte portátil irá variar dependendo do sistema onde está a ser utilizado, esta definição permite que a configuração seja relativa aos ficheiros do produto. Neste exemplo, a palavra-chave {USER} não foi especificada intencionalmente para que a configuração na unidade USB fosse utilizada pelo utilizador da unidade USB, independentemente do ID de utilizador.

### 9.4 Outras Opções de Implementação

Aqui podem ser encontradas outras opções de implementação que poderá querer ter em conta:

- Implemente o produto numa única localização onde poderá ser acedido por vários utilizadores.
- Se tiver um servidor da Web, poderá ter em conta a utilização do Web Start. Consulte http://java.com/en/download/faq/java_webstart.xml
- Importe automaticamente definições de configuração. Consulte a secção 9.4.1
- Implemente de forma nativa no IBM i. Consulte a secção 9.4.2

### 9.4.1 Importar automaticamente definições de configuração

É possível utilizar as seguintes propriedades no ficheiro AcsConfig.properties para definir automaticamente uma configuração para novos utilizadores ou para actualizar uma configuração para utilizadores existentes:

       com.ibm.iaccess.autoimport
       com.ibm.iaccess.autoimport.version

Seguem-se os passos necessários:

1. Crie a configuração que pretende propagar para um ou mais utilizadores.
2. Exporte a configuração para um ficheiro através de Ficheiro->Exportar Configuração a partir da interface gráfica do utilizador principal ou utilize a opção da linha de comandos na secção 9.1.1 Cópia de Segurança.
3. Mova o ficheiro de configuração para a localização pretendida. Existem várias opções disponíveis descritas posteriormente.
4. Defina a propriedade com.ibm.iaccess.autoimport no ficheiro AcsConfig.properties para o caminho do ficheiro de configuração.
5. Defina a propriedade com.ibm.iaccess.autoimport.version para um valor inteiro que representa a versão do ficheiro de configuração.

Funciona da seguinte forma:
A configuração guardada referenciada pela propriedade com.ibm.iaccess.autoimport será importada automaticamente quando o valor inteiro da propriedade com.ibm.iaccess.autoimport.version não corresponder ao último valor importado. Para além de facultar uma forma de definir uma configuração inicial e facultar actualizações a uma configuração existente, isto também faculta uma forma de retroceder uma configuração para uma configuração anterior. A configuração será actualizada sempre que houver uma disparidade entre o valor inteiro da propriedade versão com a última versão que foi importada. Porém, enquanto uma configuração importada pode alterar a configuração para um sistema existente na configuração do utilizador, um sistema nunca será eliminado da configuração do utilizador.

É possível especificar o caminho para a propriedade com.ibm.iaccess.autoimport como um caminho absoluto, um URL ou com palavras-chave definidas na secção 9.3. Por exemplo:

        com.ibm.iaccess.autoimport=C:/acs_bak.zip

        com.ibm.iaccess.autoimport=file///C:/acs_bak.zip

        com.ibm.iaccess.autoimport=http://your.company.com/path/file/acs_bak.zip

        com.ibm.iaccess.autoimport=ftp://your.company.com/path/file/acs_bak.zip

        com.ibm.iaccess.autoimport={PRODUCTDIR}/acs_bak.zip

É facultada flexibilidade adicional ao permitir que o ficheiro de configuração seja distribuído dentro de acsbundle.jar ou no mesmo directório que acsbundle.jar. Para qualquer um dos casos, defina com.ibm.iaccess.autoimport com o nome do ficheiro sem um caminho precedente:

        com.ibm.iaccess.autoimport=acs_bak.zip

Um valor especial de * é permitido para com.ibm.iaccess.autoimport.version:

        com.ibm.iaccess.autoimport.version=*

Isto irá importar sempre a configuração independentemente de qualquer versão anterior.

### 9.4.2 Implementações Nativas do IBM i

Alguns dos suplementos de linha de comandos que não requerem uma interface gráfica do utilizador podem ser utilizados de forma nativa no IBM i. Por exemplo, pode utilizar a Transferência de Dados para extrair as bases de dados para um tipo de ficheiro de folha de cálculo directamente no IBM i sem ser necessário descarregar dados para o PC.

Para o executar, pode extrair o arquivo Zip do produto para qualquer local no Sistema de Ficheiros Integrados (IFS) do IBM i. Por exemplo, se extraiu o arquivo Zip do produto para:

     /home/AccessClientSolutions

E ainda tiver um pedido de descarregamento de Transferência de Dados guardado anteriormente que exista em:

     /some_path/qcustcdt.dtfx

Pode executar o seguinte comando no IBM i:

    QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /some_path/qcustcdt.dtfx')

### 9.5 Pacotes Personalizados

O IBM i Access Client Solutions faculta aos administradores do sistema a capacidade de restringir a utilização de funções específicas através da definição da seguinte propriedade no ficheiro AcsConfig.properties:

        com.ibm.iaccess.ExcludeComps=<função, função,...>

As palavras-chave de funções que poderão ser especificadas são:

       Função           Descrição
        cfg             Configurações do Sistema
        sm              Gestor de Sessões 5250
        5250            Emulador 5250
        vcp             Painel de Controlo Virtual
        console         Consola 5250
        consoleprobe    Procurar configurações de consola na rede local
        hmcprobe        Procurar uma HMC por partições
        hmi1            Interface de Gestão de Hardware 1
        hmi2            Interface de Gestão de Hardware 2
        keyman          Gestão de certificados SSL/TLS
        dtgui           Interface gráfica do utilizador da Transferência de Dados
        upload          Carregamentos em lotes da Transferência de Dados
        download        Descarregamentos em lotes da Transferência de Dados
        cldownload      Descarregamentos em lotes da Transferência de Dados
        l1c             IBM Navigator for i (Consola de Nível 1)
        rmtcmd          Comando remoto (disponível a partir da linha de comandos)
        splf            Saída da Impressora (ficheiros em spool)
        ifs             Sistema de Ficheiros Integrados
        db2             Esquemas
        rss             Executar Scripts de SQL
        db2tools        Centro de Desempenho de SQL
        sysdbg          IBM i System Debugger
        checkupdates    Verificar se existem actualizações disponíveis
        ssh             Secure Shell

Funções que também podem ser excluídas através da utilização de palavras-chave de grupos:

       Grupo             Funções
      dataxfer          dtgui,upload,download,cldownload
      emulator          sm,5250
      keyman            keyman
      opconsole         console,vcp,consoleprobe,hmcprobe
      rmtcmd            rmtcmd
      splf              splf
      ifs               ifs
      hwconsole         hmi1,hmi2
      l1cplugin         l1c
      database          db2,rss,db2tools
      debugger          sysdbg

O administrador do sistema pode escolher restringir o acesso a funções específicas actualizando o ficheiro AcsConfig.properties. Restringir o acesso irá remover a função do GUI principal e desactivar a sua utilização a partir da linha de comandos.

Um exemplo de como restringir funções seria adicionar a seguinte linha ao ficheiro AcsConfig.properties:

        com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN

Caso o administrador do sistema pretenda actualizar o ficheiro AcsConfig.properties dentro de acsbundle.jar antes de o implementar para os respectivos utilizadores, um exemplo de como o fazer é:

        jar uvf acsbundle.jar AcsConfig.properties

Consulte a secção 9.3 Alterar a Localização da Configuração para obter informações adicionais sobre a forma como o IBM i Access Client Solutions determina que ficheiro AcsConfig.properties utilizar.

### 9.6 Migrar do IBM i Access for Windows

Os ficheiros de configuração do IBM i Access Client Solutions não são compatíveis com as funções correspondentes no IBM i Access for Windows. O IBM i Access Client Solutions faculta um caminho de migração para vários itens chave, como é mencionado nas secções seguintes.

### 9.6.1 Migrar Configurações do Sistema

A função Copiar Ligações disponível a partir do menu da interface gráfica do utilizador principal em Ficheiro->Copiar Ligações faculta uma interface para copiar configurações do sistema entre o IBM i Access Client Solutions e a configuração do Windows já existente suportada pelo IBM i Access for Windows. Para obter informações adicionais, consulte a ajuda para o painel principal de Copiar Ligações.As configurações do sistema também podem ser migradas utilizando a linha de comandos. Consulte a secção 9.1.25 MIGRATE para obter informações adicionais.

### 9.6.2 Migrar Emulação 5250

É possível converter os ficheiros de emulação 5250 utilizados pelo emulador IBM i Access for Windows Personal Communications através da utilização do Gestor de Sessões 5250 no IBM i Access Client Solutions. É possível converter os seguintes tipos de ficheiros a partir de Personal Communications:

       .ws   - perfil do emulador
       .bch  - ficheiro de comandos do emulador
       .kmp  - ficheiro de personalização do teclado
       .pmp  - ficheiros de sobreposição
       .bar  - ficheiros de barra de menus

Os ficheiros serão convertidos para:

       .hod  - perfil do emulador
       .bchx - ficheiro de comandos do emulador
       .kmp  - ficheiro de personalização do teclado
       .pmp  - ficheiros de sobreposição
       .bar  - ficheiros de barra de menus

Os tipos de ficheiros .kmp, .pmp e .bar são utilizados por ambos os produtos. Contudo, os formatos não são compatíveis. Os ficheiros convertidos serão criados num caminho específico do IBM i Access Client Solutions.

A conversão destes ficheiros pode ser iniciada a partir do menu do IBM i Access Client Solutions Session Manager ao:

- seleccionar Ficheiro->Importar e, em seguida, localizar os ficheiros de Personal Communications.
- arrastar e largar o ficheiro para a janela do IBM i Access Client Solutions Session Manager.

...ou a partir da linha de comandos através do suplemento PM5250. Consulte a secção 9.1.30 PM5250

Está disponível um utilitário de conversão de macros. A partir do Gestor de Sessões:

        Ferramentas->Converter Macro...

Nota Técnica:
O utilitário de conversão de macros poderá não conseguir converter um macro de PC5250 se o macro for um macro personalizado que contém mais do que apenas batimentos de teclas registados.

### 9.6.3 Migrar Ficheiros de Pedidos de Transferência de Dados Guardados

A Transferência de Dados no IBM i Access Client Solutions faculta um assistente para converter ficheiros de pedidos de Transferência de Dados guardados criados pelo IBM i Access for Windows.

É possível converter os seguintes tipos de ficheiros a partir do IBM i Access for Windows:

       .dtf - transferência de dados do IBM i
       .dtt - transferência de dados para o IBM i

Os ficheiros serão convertidos para:

       .dtfx - transferência de dados do IBM i
       .dttx - transferência de dados para o IBM i

O assistente de migração da Transferência de Dados não migra ficheiros .fdf. O novo tipo de ficheiro requerido pelo IBM i Access Client Solutions é do tipo .fdfx e pode ser gerado durante um descarregamento ou ao utilizar o Assistente de Criar Ficheiro.

O assistente de migração da Transferência de dados está disponível a partir do menu principal da Transferência de Dados através da selecção de Acções->Migração da Transferência de Dados

### 9.6.4 EHLLAPI

Para aplicações de 5250 que exploram EHLLAPI quando acedem ao emulador Personal Communications enviado com o IBM i Access for Windows, consulte o seguinte artigo KB para obter informações sobre a utilização de EHLLAPI com o IBM i Access Client Solutions:

        http://www-01.ibm.com/support/docview.wss?uid=nas8N1010639

### 9.6.5 Kerberos

O IBM i Access Client Solutions tem suporte para kerberos. Para utilizar kerberos quando ligar a um sistema:

1. Abra as Configurações do Sistema a partir da interface gráfica do utilizador principal
2. Seleccione Nova ou Editar uma configuração do sistema existente
3. No separador Ligação, seleccione
   "Utilizar autenticação kerberos; não pedir"

Configurar um ambiente kerberos está fora do alcance deste documento.

### 9.7 Gestão de Chaves

A gestão de certificados para ligações SSL (Secure Socket Layer) está disponível a partir da interface gráfica do utilizador principal através da selecção de Ferramentas->Gestão de Chaves. Algumas tarefas na Base de Dados de Chaves requerem a frase-passe de integridade do arquivo de chaves.

### 9.8 Transferência de Dados

### 9.8.1 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc

Para além de suportar descarregamentos para um Ficheiro, a Transferência de Dados também suporta descarregamentos para uma folha de cálculo activa para a folha de cálculo do Excel da Microsoft ou a folha de cálculo do Calc de OpenOffice. Para descarregar para uma folha de cálculo activa, o painel principal do GUI da Transferência de Dados faculta a opção para seleccionar um Dispositivo de Saída. Por predefinição, o Dispositivo de Saída é Ficheiro. Caso a plataforma suporte interacção com a folha de cálculo do Excel e/ou Calc, poderão ser seleccionadas opções adicionais para uma Folha de Cálculo do Excel Activa e uma Folha de Cálculo de Calc Activa a partir da caixa de lista pendente Dispositivo de Saída.

Restrições:

- É requerida uma versão mínima do OpenOffice 3.4.1 no Windows.
- É requerida uma versão mínima do OpenOffice 4.2.1 em Linux e Mac e tem de estar instalada na localização predefinida.
- O IBM i Access Client Solutions a executar em Linx ou Mac apenas suporta interacções com o OpenOffice.
  O IBM i Access Client Solutions a executar em Windows suporta a interacção com o Microsoft Excel ou OpenOffice Calc.
- O número de bits do OpenOffice tem de corresponder ao número de bit do IBM i Access Client Solutions.
  Explicação: OpenOffice está disponível em versões de 32bit e 64bit. Ambas as versões conseguem executar num PC de 64 bits. Ao interagir com uma folha de cálculo do OpenOffice, o número de bits do OpenOffice e do IBM i Access Client Solutions tem de ser o mesmo ou não será possível a Transferência de Dados interagir com a folha de cálculo. O número de bits do IBM i Access Client Solutions é determinado pela JVM (Java Virtual Machine) na qual está em execução. Onde houver uma disparidade do número de bits entre o OpenOffice e a JVM em execução no IBM i Access Client Solutions e seleccionar uma folha de cálculo activa para o Dispositivo de Saída, será apresentado um erro semelhante a "A Folha de Cálculo Activa não foi localizada". Se estiver a executar num PC de 64 bits, poderá iniciar o IBM i Access Client Solutions utilizando o lançador binário de 32 bits ou de 64 bits específico para a sua plataforma. Para que o suporte da folha de cálculo activa funcione, inicie o IBM i Access Client Solutions ao utilizar o binário específico da plataforma que corresponde ao número de bits da aplicação do OpenOffice que está a ser utilizada.
  Uma vez que Mac apenas suporta JVM de 64 bits, tem de instalar a versão de 64 bits do OpenOffice para poder utilizar o suporte de folhas de cálculo activas em Mac.

### 9.8.2 Suporte de Transferência de Dados para Truncamento de Caracteres e Sobrecarregamentos Numéricos

Durante um pedido de carregamento de Transferência de Dados, se um campo de caracteres ou numérico exceder o tamanho definido do campo, o pedido de carregamento irá terminar.

Para permitir que os campos de caracteres sejam truncados a partir do fim, defina a seguinte propriedade no ficheiro AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Para permitir que os campos numéricos sejam definidos para os respectivos valores máximo e mínimo quando o campo numérico fornecido exceder o limite definido, defina a seguinte propriedade no ficheiro AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Quando estas propriedades são definidas para true, o pedido de carregamento irá continuar sem fornecer qualquer indicação de que ocorreu um truncamento ou um sobrecarregamento. Os campos de caracteres serão truncados no fim. Os campos numéricos serão definidos para o respectivo valor máximo para sobrecarregamentos e para o respectivo valor mínimo para ultrapassagem de capacidade por defeito.

Em alternativa, as propriedades anteriores podem ser definidas a partir da linha de comandos como outras propriedades java da seguinte forma:
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

### 9.8.3 Nome da Folha de Transferência de Dados

Durante as transferências, é gerado um nome de folha com base no nome do ficheiro e da biblioteca de origem do IBM i com o apêndice >Folha#" em que # é substituído pelo número de folha apropriado. Por exemplo:
qiws.qcustcdt>Folha1

Para substituir a porção do ficheiro e da biblioteca do nome da folha, poderá especificar a seguinte propriedade:
com.ibm.iaccess.dataxfer.SheetId=your_string
Isto irá gerar:
a_sua_cadeia>Folha1

### 9.9 Estabelecer uma Ligação de Consola ao IBM i

Para executar funções administrativas no IBM i, é necessária uma consola 5250. O IBM i Access Client Solutions suporta configurações de consolas LAN e HMC.

Caso saiba o nome do sistema central de Serviço ou o endereço de IP do Serviço para o IBM i ou o nome do sistema central ou endereço de IP para a consola HMC, é possível configurar as informações da consola dentro do IBM i Access Client Solutions através dos seguintes passos:

1. Inicie o IBM i Access Client Solutions no PC.
2. No painel principal, faça clique em Configurações do Sistema.
3. Faça clique no botão Novo para introduzir uma nova configuração ou no botão Editar para actualizar uma configuração existente.
4. Seleccione o separador Consola.
5. Introduza as informações apropriadas para o tipo de consola.

Para um IBM i onde a configuração da consola ainda não existe (por exemplo um novo sistema acabado de ser entregue à empresa), um endereço de IP para uma ligação à consola será atribuído automaticamente no intervalo de 169.254.62.0 - 169.254.62.63 durante o IPL. Para estes casos, os seguintes passos ajudarão a estabelecer uma ligação à consola através do IBM i Access Client Solutions:

1. Desactive a conectividade sem fios do PC. Os seguintes passos requerem a porta ethernet com fios.
2. Passe um cabo ethernet entre o PC e a porta T1 do IBM i.
3. Inicie o IBM i Access Client Solutions no PC.
4. No painel principal, faça clique em Configurações do Sistema.
5. A partir de Configurações do Sistema, faça clique no botão Localizar Consola...
6. A partir do painel Localizador do IBM i, faça clique no botão Pesquisar.
7. Se a sequência de IPL no IBM i tiver progredido o suficiente para que o endereço de IP automático seja atribuído, o endereço de IP deverá ser apresentado no painel de Pesquisa.
8. Faça clique no endereço de IP apresentado para seleccionar o mesmo e, em seguida, faça clique no botão Consola para ligar uma consola 5250.
9. Aparecerá um painel a pedir credenciais das Ferramentas de Serviço.
10. Ao introduzir credenciais válidas, será apresentada uma consola 5250.
11. A consola poderá ser utilizada para iniciar tarefas de instalação e configuração iniciais.

Quando estiver pronto para adicionar o sistema IBM i ao resto da infra-estrutura de rede, existem informações adicionais no IBM InfoCenter sobre como configurar o Adaptador de LAN das Ferramentas de Serviço:

    http://pic.dhe.ibm.com/infocenter/iseries/v7r1m0/topic/rzamh/rzamhsrvtoolsrvr4dstdst.htm

Consulte a secção "Configurar o servidor das ferramentas de serviço para DST"

Para sistemas IBM i que já têm uma configuração de consola LAN e já pertencem à infra-estrutura de rede, é possível utilizar os seguintes passos para localizar configurações de consola existentes:

1. Inicie o IBM i Access Client Solutions no PC.
2. No painel principal, faça clique em Configurações do Sistema.
3. A partir de Configurações do Sistema, faça clique no botão Localizar Consola...
4. No painel Localizador do IBM i, actualize o campo Próximo para um endereço de IP no intervalo que pretende pesquisar.
5. Faça clique no botão Pesquisar para localizar consolas LAN no intervalo especificado.
6. Faça clique no endereço de IP apresentado para seleccionar o mesmo e, em seguida, faça clique no botão Consola para ligar uma consola 5250.
7. Aparecerá um painel a pedir credenciais das Ferramentas de Serviço.
8. Ao introduzir credenciais válidas, será apresentada uma consola 5250.

### 9.10 Tipos de Letra Adicionais

É possível adicionar tipos de letra adicionais ao directório Tipos de Letra para emulação 5250.

Para facultar localizações alternativas e/ou múltiplas para tipos de letra adicionais, defina a propriedade com.ibm.iaccess.Fonts localizada no ficheiro AcsConfig.properties.

O directório Tipos de Letra predefinido poderá ser substituído através da definição da propriedade com.ibm.iaccess.Fonts para:

1. um <caminho> que é um directório que contém tipos de letra
2. um <caminho>/<nomeficheiro> de um ficheiro de tipo de letra específico (por exemplo .ttf)
3. um URL para um ficheiro de tipo de letra
4. uma lista delimitada por ponto e vírgula de qualquer um dos exemplos mencionados acima

Nota:
O <caminho> poderá ser um caminho absoluto ou um caminho relativo a iniciar a partir da localização de acsbundle.jar. Apenas serão reconhecidos pela emulação 5250 tipos de letra de largura fixa.

Exemplo 1 (predefinição):

         com.ibm.iaccess.Fonts=Fonts

Exemplo 2:

         com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts

### 9.11 Utilizar Credenciais a partir de um ficheiro netrc

Para permitir a utilização de um ficheiro .netrc (Linux e Mac) ou de um ficheiro _netrc (Windows), aceda à interface gráfica do utilizador principal do IBM i Access Client Solutions e, a partir da barra de menus, seleccione
Editar->Preferências
Separador Geral
Marque a caixa: Ler ficheiro netrc para obter informações de início de sessão
Faça clique no botão Aplicar
Reinicie o IBM i Access Client Solutions

O formato padrão de um ficheiro netrc é:

         máquina <sistema> login <id-utilizador> password <palavra-passe>

O ficheiro netrc tem de ser armazenado no directório inicial do utilizador e o nome do sistema e o ID de utilizador têm de corresponder às Configurações de Sistema. A partir do IBM i Access Client Solutions:
Seleccione Configurações de Sistema
Seleccione e, em seguida, Edite o sistema
Separador Ligações
Seleccione Utilizar nome de utilizador predefinido para pedir uma vez por cada sistema
Preencha o ID de utilizador para o Nome de utilizador predefinido
Seleccione OK

Quando o nome do sistema e o Nome de utilizador predefinido corresponderem aos conteúdos do ficheiro netrc, irá ser criada uma ligação ao sistema, utilizando a palavra-passe do ficheiro netrc sem pedir o utilizador.

### 9.12 Sistema de Ficheiros Integrados (IFS)

### 9.12.1 IFS, QFileSvr.400 e Segurança

O Suporte de Sistema de Ficheiros Integrados utiliza o sistema de ficheiros QFileSvr.400 para copiar ou enviar objectos de uma partição do IBM i para outra. Isto significa que o perfil de utilizador e a palavra-passe em ambas as partições precisam corresponder, e as partições têm de ter o mesmo valor de sistema ao nível da palavra-passe (QPWDLVL). Se utilizar a autenticação de Kerberos, ambas as partições têm de ter o Serviço de Autenticação de Rede e o Mapeamento de Identidade Empresarial (EIM, Enterprise Identity Mapping) configurados. Para obter mais detalhes, consulte o tópico "Segurança e autoridade de objectos no sistema de ficheiros QFileSvr.400" no IBM i Knowledge Center.

As ligações para outras do IBM i efectuadas pelo sistema de ficheiros QFileSvr.400 não são seguras. Caso seja necessária uma ligação segura quando copiar ou enviar objectos de uma partição do IBM i para outra, a configuração para a partição tem de ser configurada para utilizar SSL e as Configurações de Sistema têm de ter a opção "Utilizar SSL para a ligação" seleccionada para essa partição e tem de ser definida a seguinte propriedade no ficheiro AcsConfig.properties:
com.ibm.iaccess.ifs.transferMechanism=ACS
Em alternativa, a propriedade pode ser definida a partir da linha de comandos como outras propriedades java da seguinte forma:
-Dcom.ibm.iaccess.ifs.transferMechanism=ACS

### 9.12.2 Autoridade de IFS

O suporte do Sistema de Ficheiros Integrado requer autoridade para utilizar os seguintes comandos CL:

        CPY
        CPYFRMSTMF
        CPYTOSTMF
        CRTDIR
        CRTLIB
        CRTSAVF
        RMVDIR
        RST
        SAV
        SETASPGRP

Se o utilizador não utilizar estes comandos CL, as acções de Copiar (Copy), Colar (Paste), Enviar (Send), Eliminar (Delete) e de Nova Pasta (New Folder) irão falhar.

### 9.12.3 Limitações de IFS

O suporte de Sistema de Ficheiros Integrado não permite acções para objectos que tenham caminhos que sejam iniciados com /QFileSvr.400, /QNTC ou /QOPT. Se o caminho do directório actual ou qualquer caminho de objecto seleccionado sejam iniciado com /QFileSvr.400, /QNTC ou /QOPT, todos os itens no menu Acções serão desactivados e não será apresentado um menu contextual.

### 9.12.4 IFS e ASP Independentes

O suporte do Sistema de Ficheiros Integrados não permite a acção Copiar (Copy), Colar (Paste) ou Enviar (Send) quando o caminho de origem ou de destino do objecto está localizado numa ASP independente.

### 9.13 Terminal Secure Shell (SSH)

Para plataformas onde existe uma Secure Shell por predefinição ou onde foi instalada, a funcionalidade de Terminal de SSH aparecerá na interface gráfica do utilizador principal do IBM i Access Client Solutions. O Terminal de SSH iniciará um emulador de terminal para o sistema de ficheiros integrado do IBM i.

A maioria dos sistemas Mac, Linux e outros sistemas derivados de UNIX já possuem uma Secure Shell por predefinição. Para estas plataformas, assume-se que existe um cliente de OpenSSH e que está localizado em /usr/bin/ssh. Os utilizadores de Windows necessitarão de instalar uma das Secure Shells disponíveis para Windows.

Secure Shells suportadas pelo IBM i Access Client Solutions:

Linux: Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
Mac: Terminal, iTerm2
Windows: cygwin, PuTTY, bash
cygwin necessita que o pacote de openssh seja instalado
bash está disponível como parte do subsistema Linux para Windows

Se existirem múltiplas aplicações de SSH instaladas, pode utilizar a propriedade com.ibm.iaccess.PreferredSSHClient para definir o cliente de SSH preferido.

Exemplos de Linux:
com.ibm.iaccess.PreferredSSHClient=XterminalEmulator
com.ibm.iaccess.PreferredSSHClient=MateTerminal
com.ibm.iaccess.PreferredSSHClient=Terminator
com.ibm.iaccess.PreferredSSHClient=GnomeTerminal
com.ibm.iaccess.PreferredSSHClient=Konsole
com.ibm.iaccess.PreferredSSHClient=Xfce4

Exemplos de Mac:
com.ibm.iaccess.PreferredSSHClient=iTerm2

Exemplos de Windows:
com.ibm.iaccess.PreferredSSHClient=Cygwin
com.ibm.iaccess.PreferredSSHClient=Putty
com.ibm.iaccess.PreferredSSHClient=Bash

Para os casos em que o cliente de SSH não está instalado na localização standard, pode utilizar a propriedade com.ibm.iaccess.PreferredSSHClient para disponibilizar o caminho completamente qualificado para o cliente de SSH instalado.

com.ibm.iaccess.PreferredSSHClient=C:\PuTTY\putty.exe

Quando caminho completamente qualificado é disponibilizado, também pode necessitar de definir com.ibm.iaccess.SSHClientOpt para disponibilizar todos os argumentos necessários. Por exemplo, para desactivar avisos se não utilizar o reencaminhamento X11:

com.ibm.iaccess.SSHClientOpts=-x

### 9.13.1 Pré-requisitos do Terminal de SSH

Instalar 5733-SC1 IBM Portable Utilities for i no IBM i.
Inicie o Daemon de Secure Shell através do comando:
STRTCPSVR *SSHD

Se receber um erro de ligação no cliente SSH iniciado (por exemplo, "ligação recusada"), ou se surgir uma janela, mas desaparecer imediatamente, pode necessitar de iniciar o daemon de SSH com o comando acima indicado.

### 10.0 Diagnósticos de Assistência

Se encontrar um problema que requer a assistência da IBM, o técnico IBM poderá direccioná-lo para uma ou ambas as seguintes soluções:

A partir da interface gráfica do utilizador principal do IBM i Access Client Solutions:

- seleccione Ferramentas->Criar Registos de Serviço
  Isto executa a mesma função que a opção da linha de comandos na secção 9.1.5 Cópia de Memória. Esta função deve normalmente ser feita imediatamente após a falha. Dependendo do problema, o seu técnico IBM pode instruí-lo a fazê-lo múltiplas vezes.
- seleccione Ferramentas->Registos de Serviço do Pacote
  Isto executa a mesma função que a opção da linha de comandos na secção 9.1.6 Medic. Esta função recolhe detalhes sobre o ambiente da estação de trabalho e empacota os registos de serviço num arquivo .ZIP que pode ser enviado à IBM.

### 11.0 Perguntas Mais Frequentes (FAQ, Frequently Asked Questions)

    Q1    Quando tento iniciar o IBM i Access Client Solutions obtenho o seguinte
          erro:
                 não é possível carregar classe: java.lang.UnsupportedClassVersionError
    A1-1  É necessário utilizar JDK 6.0 ou superior. Consulte a secção 3.0 Pré-requisitos

    Q2    Quando tento iniciar o script utilizando um dos ficheiros binários facultados ou
          scripts a partir de uma sessão de interface ou terminal, obtenho o seguinte erro:
             Permissão recusada
    A2-1  Verifique as permissões de ficheiro do ficheiro para garantir que tem permissão
          de execução. Consulte a secção 6.0 Permissões de Ficheiros.

    P3    Quando faço duplo clique num dos ficheiros fornecidos para iniciar o produto, não acontece nada.
    A3-1  O Java poderá não estar instalado. Consulte a secção 3.0 Pré-requisitos
    A3-2  O ficheiro que está a utilizar para iniciar o produto poderá não ter permissão
          de execução. Consulte a secção 6.0 Permissões de Ficheiros.
    A3-3  Poderão existir problemas com o ambiente. Para visualizar que erros poderão estar a
          ocorrer, tente executar o ficheiro facultado a partir de uma linha de comandos.
          Consulte a secção 7.3 Iniciar o Produto (utilizando a linha de comandos).

    P4    Pretendo utilizar um dos ficheiros binários para iniciar o produto, mas obtenho o seguinte erro:  "Erro ao carregar o módulo Java."
    R4-1  O binário não conseguia localizar o directório inicial da instalação java.
          Verifique se Java está instalado. Consulte a secção 3.0 Pré-requisitos.
    A4-2  A secção 7.1.1 Iniciar o Produto - Opções Adicionais
          contém métodos adicionais para iniciar o produto utilizando um ficheiro binário.

    P5    Depois de definir a variável do ambiente JAVA_HOME, o ficheiro binário que utilizo para iniciar o produto funciona a partir de uma linha de comandos, mas não funciona quando eu faço duplo clique no ficheiro.
    A5-1  A variável do ambiente JAVA_HOME poderá não ser visível a partir do gestor de ficheiros
          que está a utilizar quando faz duplo clique no ficheiro. A definição de variáveis
          do ambiente varia através de sistemas operativos, bem como a respectiva visibilidade.
          Tente definir a variável do ambiente JAVA_HOME como uma variável do ambiente
          do sistema para o sistema operativo. O sistema operativo poderá referir-se a
          variáveis do ambiente do sistema como variáveis do ambiente globais.
          Após definir a variável do ambiente JAVA_HOME, feche e reabra o gestor de ficheiros e tente fazer duplo clique sobre o ficheiro binário novamente.
    Q6    Quando faço duplo-clique num dos ficheiros facultados para iniciar o produto, um
          editor de texto apresenta o ficheiro.
    R6-1  Assegure-se de que está a utilizar um script que tem uma extensão do nome do ficheiro que o seu sistema operativo reconhece.
    R6-2  Experimente um dos outros scripts.
    R6-3  Altere o programa que abre o ficheiro.
    A6-4  Verifique as permissões do ficheiro para garantir que tem permissão
          de execução. Consulte a secção 6.0 Permissões de Ficheiros.

    P7    Quando faço duplo clique em um dos ficheiros fornecidos para iniciar o produto, perguntam-me qual o programa que deve ser utilizado para abrir o ficheiro.
    R7-1  Assegure-se de que está a utilizar um script que tem uma extensão do nome do ficheiro que o seu sistema operativo reconhece.
    A7-2  Defina o programa que abre o ficheiro para algo compatível com o ficheiro
          binário ou script que está a utilizar. Por exemplo, Terminal (em Mac).
    A7-3  Verifique as permissões de ficheiro do ficheiro para garantir que tem permissão
          de execução. Consulte a secção 6.0 Permissões de Ficheiros.

    P8    Quando inicio o IBM i Access Client Solutions num Mac a partir do Localizador, aparece uma sessão terminal e esta não desaparece mesmo após terminar o
          IBM i Access Client Solutions.
    R8-1  Para eliminar o aparecimento da sessão terminal, utilize os scripts de instalação
          para Mac no Manual de Iniciação Rápida.

    P9    Qual é a melhor maneira de iniciar o produto?
    A9-1  É possível iniciar o produto com qualquer um dos três métodos na secção
          7.0 Iniciar o Produto utilizando os binários, scripts ou a
          linha de comandos. Qualquer método que funcione no ambiente é aceitável.

    P10   Por que razão existem tanto ficheiros binários (Start_Programs) e scripts
          (Sample_Scripts) para iniciar o produto?
    R10-1 Os scripts não são específicos de sistemas operativos e fornecem uma maneira mais genérica de
          iniciar o produto quando os ficheiros binários específicos para a plataforma não funcionam.
    R10-2 Alguns sistemas operativos requerem binários ao definir associações de ficheiros.
          Para a maioria dos casos, os ficheiros binários devem ser utilizados para iniciar o produto.
    A10-3 Alguns ambientes poderão ter firewalls que restringem o acesso a partes do
          IBM i Access Client Solutions.  A utilização dos ficheiros binários para iniciar o
          produto facilitam o processo de autorização de acesso para os administradores de sistema.

    Q11   Após instalar JDK 6.0 (ou superior), continuo a obter o seguinte
          erro:
          não é possível carregar classe: java.lang.UnsupportedClassVersionError
    A11-1 A versão predefinida de Java a ser utilizada na estação de trabalho é anterior a
          JDK 6.0. Será necessário utilizar uma opção que especifica explicitamente o
          caminho para o início de Java para JDK 6. Consulte a secção 7.1.2 Localizar o Caminho Inicial de
          Java. Utilize o caminho inicial de Java para um dos métodos descritos em
          qualquer uma das seguintes secções:
          7.1.1 Iniciar o Produto - Opções Adicionais

          7.3 Iniciar o Produto (utilizando a linha de comandos)

    P12   Não consigo importar ficheiros de mapeamento de teclado personalizados (.kmp) a partir das minhas sessões de emulador 5250 do Windows.
    A12-1 Na versão inicial do IBM i Access Client Solutions que ficou
          disponível em Julho de 2012, a importação de ficheiros .kmp a partir de perfis de sessão
          do emulador 5250 do Windows (.ws) não era suportada. Desde a versão que
          foi disponibilizada em Outubro de 2012, a importação de ficheiros .kmp a partir de perfis
          de sessão 5250 (.ws) é agora suportada.

    Q13   A personalização do teclado para o emulador 5250 é muito diferente do que
          era no Windows. Têm alguma sugestão?
    A13-1 A definição do teclado está dividida em categorias. A partir de uma sessão do emulador:
          Faça clique em Editar > Preferências > Teclado ou faça clique no botão Redefinição na
             barra de ferramentas.
    Faça clique sobre o separador Atribuição de Tecla.
          Seleccione uma Categoria. As definições de teclas predefinidas aparecerão sob as
             categorias "Funções do Sistema Central" e "Comandos de Menu".
          Seleccione a função que pretende atribuir.
    Faça clique sobre Atribuir uma Tecla.
          No teclado, prima a tecla (ou combinação de teclas) que pretende atribuir a esta função.
    A13-2 Para obter ajuda sobre definições de teclas personalizadas:
          Faça clique em Editar > Preferências > Teclado ou faça clique no botão Redefinição na
          barra de ferramentas. Seleccione o botão Ajuda.

    P14   Quando tento iniciar o produto no Mac OS X 10.8 Mountain Lion, obtenho uma mensagem de diálogo que indica que a aplicação não está assinada.
    A14-1 Esta é uma política de segurança imposta por predefinição a começar com o Mac OS X
          10.8 Mountain Lion. Consulte a seguinte página da Web para obter informações sobre como permitir que
          a aplicação seja executada:
          http://macperformanceguide.com/MountainLion-application-signing.html

    P15   Sou um utilizador do IBM i Access for Windows, posso migrar as minhas configurações do sistema para o IBM i Access Client Solutions?
    A15-1 Consulte a secção 9.6.1 Migrar Configurações de Sistema.

    P16   Sou um utilizador do IBM i Access for Windows, posso migrar os meus perfis de emulação para o IBM i Access Client Solutions?
    A16-1 Consulte a secção 9.6.2 Migrar Emulação 5250

    P17   Sou um utilizador do IBM i Access for Windows, posso migrar os meus ficheiros de pedidos de Transferência de Dados para o IBM i Access Client Solutions?
    A17-1 Consulte a secção 9.6.3 Migrar Ficheiros de pedidos de Transferência de Dados Guardados.

    P18   O EHLLAPI funciona com o IBM i Access Client Solutions?
    A18-1 Consulte a secção 9.6.4 EHLLAPI

    P19   O kerberos funciona com o IBM i Access Client Solutions?
    A19-1 Consulte a secção 9.6.5 Kerberos

    P20   Sou um administrador de sistema e gostaria de ocultar certas funções dos meus utilizadores.
    A20-1 Consulte a secção 9.5 Pacotes Personalizados

    P21   Quando selecciona um ícone de ajuda num painel, não é apresentado nenhum texto.
    A21-1 O texto de ajuda é apresentado normalmente no navegador do ambiente de trabalho. Nalguns casos,
          o ambiente de trabalho poderá não ter um navegador ou poderá não estar correctamente configurado.
    A21-2 Para apresentar o texto de ajuda sem utilizar o navegador do ambiente de trabalho, defina a
          seguinte propriedade no ficheiro AcsConfig.properties:
             com.ibm.iaccess.javaAwtDesktopAllowed=false
          Em alternativa, é possível definir a propriedade a partir da linha de comandos como
          outras propriedades java conforme se segue:
             -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false

    Q22   Ao utilizar a Transferência de Dados, selecciono um dispositivo de Saída de "Folha de Cálculo
          de Excel Activa" ou "Folha de Cálculo de Calc Activa" e obtenho o seguinte erro:
             "A Folha de Cálculo Activa não foi localizada"
    Q22-1 Não existe uma folha de cálculo activa. Abra uma folha de cálculo nova ou existente
          e tente o pedido de novo.
    R22-2 Pode haver uma disparidade de número de bits entre a aplicação de folha de cálculo que está a utilizar e a JVM (Java Virtual Machine) que executa o IBM i Access Client Solutions.
          Consulte a secção 9.8 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc

    P23   Ao utilizar a Transferência de Dados num Mac, não vejo nenhuma opção no dispositivo de saída para interagir com uma folha de cálculo activa.
    Q23-1 A Transferência de Dados não consegue interagir com folhas de cálculo activas em Mac devido
          à disparidade de número de bits entre a aplicação OpenOffice e a JVM
          que executa o IBM i Access Client Solutions. Para obter detalhes adicionais, consulte a secção
          9.8 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc.

    P24   Ao utilizar a Transferência de Dados, selecciono um dispositivo de saída de "Folha de Cálculo de Calc Activa" e não aparece nada na caixa Nome.
    R24-1 Isto é normal para novas folhas de cálculo de Calc que nunca foram guardadas. A Transferência de Dados conseguirá actualizar na mesma a folha de cálculo com dados descarregados.

### 12.0 Histórico de Actualizações

Consulte a seguinte página da Web:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html