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

O conteúdo deste documento foi actualizado pela última vez em: 21 de Janeiro, 2015

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, 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 Configurar uma Aplicação (para Mac)
  9.2.3.2 Criar Associações de Ficheiros (para Mac)
  9.2.3.3 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.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 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc
  9.9 Estabelecer uma Ligação de Consola ao IBM i
  9.10 Tipos de Letra Adicionais
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 utilizam o IBM i 6.1, 7.1 ou 7.2 poderão adquirir o IBM i Access Client Solutions através da transferência do mesmo a partir do sítio da Web Entitled Software Support (ESS) sob 5761-SS1 ou 5770-SS1.

Os clientes podem adquirir suportes ao encomendar a função de renovação 6288 de 5761-SS1 ou 5770-SS1. 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. Estes pacotes apenas estão disponíveis a partir do sítio da Web Entitled Software Support (ESS).

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.

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:

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

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


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 6.0 ou superior, incluindo várias versões do Linux, Mac e Windows.

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

A seguinte saída de dados indica que está instalada a versão 6.0:
    java version "1.6.0_31"
O 31 neste exemplo refere-se ao nível de actualização.

A seguinte saída de dados indica que está instalada a versão 7.0:
    java version "1.7.0"

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/index.html
    http://www.oracle.com/technetwork/java/javase/index-137561.html
    http://java.com/en/download/manual.jsp
    http://support.apple.com/downloads
    http://support.apple.com/downloads/#macosandsoftware
    http://support.apple.com/downloads#Java
    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 for utilizar ligações SSL, carregue e aplique o PTF específico da edição do IBM i apropriada para o sistema:
    SI45601 - 5.4
    SI45248 - 6.1
    SI45610 - 7.1

Se for utilizar a funcionalidade da Consola 5250 ou do Painel de Controlo Virtual para um IBM i com a edição 6.1, carregue e aplique os seguintes PTFs:
    MF55543
    MF55549

Se for utilizar a funcionalidade da Consola 5250 ou do Painel de Controlo Virtual para um IBM i com a edição 6.1 com o código máquina 6.1.1, carregue e aplique os seguintes PTFs:
    MF55540
    MF55547

Se for utilizar a funcionalidade da Consola 5250 ou do Painel de Controlo Virtual para um IBM i com a edição 7.1, carregue e aplique os seguintes PTFs:
    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)

Documentation       - 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 
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

Start_Scripts       - um directório que contém scripts que pode ser utilizado para
                      iniciar o produto.
    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
Mac_Application     - um directório que contém um agrupamento de aplicações para Mac
Linux_Application   - um directório que contém um agrupamento de aplicações para Linux
Icons               - um directório que contém ficheiros que podem ser utilizados como ícones
Fonts               - directório onde será possível adicionar tipos de letra de largura fixa adicionais
                      para emulação 5250

properties          - um directório que contém informações acerca da versão do produto

5.0 Instalação

Instalar o IBM i Access Client Solutions é tão simples como descompactar o arquivo ZIP.

Determina a localização onde pretende instalar o produto. Pode ser qualquer localização onde a estação de trabalho (PC, Mac, etc) 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.

Se estiver a executar uma instalação para um único utilizador, consulte o Manual de Iniciação Rápida. Caso contrário, se estiver a executar uma instalação personalizada ou para vários utilizadores, então:

  1. copie o arquivo ZIP para a localização pretendida
  2. descompacte o arquivo ZIP através de qualquer utilitário à escolha

A instalação está concluída.

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.

Antes de actualizar a instalação:
  Guarde quaisquer alterações que tenha efectuado ao ficheiro AcsConfig.properties (ou altere o nome do mesmo).
  Caso não tenha alterado este ficheiro, não será necessário guardar o mesmo.

Para actualizar uma instalação existente, siga os passos na secção 5.0 Instalação e sobreponha os ficheiros instalados existentes.

Alguns administradores podem escolher instalar a versão actualizada numa nova localização. Se utilizou este método, assegure-se de que eliminou a instalação antiga após ter verificado a nova instalação.

Após ter instalado a versão actualizada:
  Se tiver guardado uma cópia de um ficheiro AcsConfig.properties personalizado, restaure a cópia guardada para a localização da instalação actualizada.


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. No entanto, já que há uma variedade de maneiras e localizações como/onde o java pode ser instalado, alguns dos métodos podem requerer configuração adicional. 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 7 ou 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:

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)

Os Start_Scripts foram tornados obsoletos para V1R1M4.

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 Start_Scripts.

A maioria dos sistemas operativos não baseado em Windows têm perl disponível por predefinição. O directório Start_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 Start_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 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 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
                      IP address - 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:
                      *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 a partir da interface gráfica do utilizador utilizando o Gestor de Sessões 5250
                  e, em seguida, Ficheiro->Alterar Directório...
   /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=logon    /SYSTEM=<sistema> [/USERID=<idutilizador>] [/PASSWORD=<palavra-passe>] [/C]

/USERID   - o id de utilizador que será colocado em cache
    /PASSWORD - a palavra-passe do id de utilizador a ser colocado em cache
    /C        - limpa a cache
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> Liga ou desliga a autenticação do Servidor SSL (a predefinição é
                          desligado). Esta opção é ignorada se não testar o SSL.
        /GUI=<1/0>        Ligar/desligar a comutação da interface gráfica do utilizador (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=<sistema> [/id=<id de sessão abreviado>] [/<opções>]

Este suplemento inicia um emulador 5250 com o sistema especificado.
Esta função é equivalente ao Emulador 5250 do GUI principal.
    /id=<ID de sessão abreviado>	- define o ID de sessão abreviado

As opções válidas são:
    /name=<name>                 - nome da sessão
    /wide=<1/0/true/false>       - utilizar um tamanho de ecrã largo (27x132)
    /fullscreen<1/0/true/false>  - utilizar o ecrã inteiro
    /nosave=<1/0/true/false>     - não guardar definições na saída
    /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

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.
                Podem ser especificados múltiplos ficheiros com ou sem esta palavra-chave.
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.
                Podem ser especificados múltiplos ficheiros com ou sem esta palavra-chave.
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. As restrições podem ser transportadas para outras estações de trabalho através das opções de exportação/importaçã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
    hmi1            Interface de Gestão de Hardware 1
    hmi2            Interface de Gestão de Hardware 2
    keyman          Gestão de Chaves
    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
    splf            Saída da Impressora (ficheiros em spool)
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

Como conveniência para administradores que preferem utilizar um ficheiro de registo do Windows, a opção exportreg está disponível para partilhar restrições entre estações de trabalho que tenham um SO Windows.

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]

    /<tipoficheiro>  - 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.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. Consulte a secção 9.2.3.1 Configurar uma Aplicação (para Mac).

9.2.3.1 Configurar uma Aplicação (para Mac)

Opção 1:
Para instalar o "IBM i Access Client Solutions" como uma aplicação na localização padrão da pasta Aplicações, siga as instruções no Manual de Iniciação Rápida na pasta Documentação.

Opção 2:
Para instalar o "IBM i Access Client Solutions" como uma aplicação numa localização não padrão, será necessário concluir os seguintes passos:

  1. Utilizando o Localizador, Seleccione Ir e, em seguida, Utilitários
  2. Faça duplo clique em Terminal
  3. cd <directório onde existe o ficheiro IBMiAccess_v1r1.zip>
  4. unzip IBMiAccess_v1r1.zip -d "/<caminho-pasta-destino>/IBM i Access Client Solutions.app" <caminho-pasta-destino> é a pasta onde pretende que resida a aplicação

    Nota Técnica 1: É necessário utilizar o comando unzip ou certos atributos de ficheiros serão perdidos e a aplicação não funcionará.

    Nota Técnica 2: É necessário especificar "IBM i Access Client Solutions.app" como o sub-directório abaixo do <caminho-pasta-destino> ou a aplicação não será configurada correctamente.

    Nota Técnica 3: Quando actualizar o produto com uma versão mais recente, apenas será necessário repetir este passo utilizando o arquivo ZIP actualizado.

  5. cd <caminho-pasta-destino>/Mac_Application/
    Este directório deverá conter acs_mac_app.zip
  6. unzip acs_mac_app.zip -d <caminho-pasta-destino>
  7. Modifique document.wflow para apontar para a localização de:
    <caminho-pasta-destino>/IBM i Access Client Solutions.app/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac
    document.wflow encontra-se em:
    <caminho-pasta-destino>/IBM i Access Client Solutions.app/Contents/document.wflow

    É possível navegar para lá através da utilização do Localizador da seguinte forma:

    • navegue para o <caminho-pasta-destino>
    • faça clique com o botão direito do rato no ícone do produto e seleccione "Mostrar Conteúdo do Pacote"
    • faça duplo clique na pasta Conteúdos
    • faça clique com o botão direito do rato no ficheiro document.wflow e seleccione "Abrir com" e, em seguida, "Outro..."
    • seleccione a aplicação TextEdit e Abrir
    • procure por "acslaunch_mac"
    • actualize esta linha de forma a conter o caminho correcto e inteiro para acslaunch_mac
      Por predefinição, a aplicação facultada foi configurada para apontar para:
      /Applications/IBM i Access Client Solutions.app/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac
    • certifique-se de que não altera o início:
        <string>
      nem o fim
        "$@" > /dev/null 2>&1 & </string>
      Quaisquer espaços no caminho devem ser antecedidos de \
  8. Guarde as alterações.

Após concluir a Opção 1 ou a Opção 2, é possível utilizar o agrupamento de aplicações:

9.2.3.2 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. Navegue até à localização onde guardou o agrupamento de aplicações que criou (consulte a secção 9.2.3.1 Configurar um Agrupamento de Aplicações).
  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.3 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.

Nota Técnica:
A definição da propriedade com.ibm.iaccess.DataCache=true irá reduzir o tamanho do conjunto em funcionamento e irá reduzir significativamente o tempo de arranque quando o ficheiro JAR do produto for remoto (por exemplo, partilha de rede).

   com.ibm.iaccess.DataCache=true

9.4 Outras Opções de Implementação

Se tiver vários utilizadores finais e pretende uma forma fácil de implementar este produto e quaisquer actualizações futuras, eis algumas ideias que poderá ter em conta:

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.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:
   DATAXFER  - Transferência de Dados de/para IBM i
   EMULATOR  - Emulação de Apresentação/Impressão 5250 e Gestor de Sessões 5250
   KEYMAN    - gestão de certificados de SSL
   OPCONSOLE - consola de Operações e Painel de Controlo Virtual
   RMTCMD    - Comando Remoto (disponível a partir da linha de comandos)
   SPLF      - Saída da Impressora
   HWCONSOLE - Interface de gestão de hardware
   L1CPLUGIN - Navigator for i
   HMCPROBE  - Utilitário de Sonda HMC
   
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.

Se tiver autoridade de administrador, consulte a secção 9.1.26 RESTRICT para obter uma alternativa para restringir funções.

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
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
Os tipos de ficheiros .kmp e .pmp 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 poderá ser iniciada a partir do menu do IBM i Access Client Solutions Session Manager através da selecção de Ficheiro->Importar e, em seguida, da localização dos ficheiros de Personal Communications. A conversão também poderá ser iniciada ao arrastar e largar um ficheiro .ws ou .bch na janela de Gestor de Sessão do IBM i Access Client Solutions.

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

    Ficheiro->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 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:

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

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:


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 a sessão terminal de aparecer, vai necessitar de criar um agrupamento de aplicações.
      Consulte a secção 9.2.3.1 Configurar um Agrupamento de Aplicações (para Mac). Em seguida, inicie
      o produto através do agrupamento de aplicações.


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 (Start_Scripts)
      for para iniciar o produto?
R10-1 Os scripts não são específicos de sistemas operativos e fornecem um maneira mais genérica de iniciar o produto que os ficheiros binários. R10-2 Alguns sistemas operativos requerem binários ao definir associações de ficheiros.
      Para maior conveniência, foram fornecidos binários para algumas plataformas.
A10-3 Alguns ambientes poderão ter firewalls que restringem o acesso a partes do
      IBM i Access Client Solutions. Por conveniência, foram facultados
      binários para facilitar a autorização de acesso a administradores do 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