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

O conteúdo deste documento foi actualizado pela última vez a: 29 de Abril de 2021

0.5 Manual de Iniciação Rápida

O Manual de Iniciação Rápida contém instruções para implementar o produto que funcionam 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
  5.2 Configurar uma Localização de Actualizações Configurada
  5.3 PTFs Opcionais do IBM i
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.6.6 Compatibilidade de 5250
  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.12.5 Desempenho de IFS
  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 (5770XW1) 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 7.2 ou posterior que tenham a autorização de utilização actual podem adquirir o IBM i Access Client Solutions através das seguintes formas:

Os pacotes de aplicações opcionais para Windows e Linux encontram-se 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 ficheiro .zip do produto que poderá ser copiado e extraído para uma localização escolhida pelo utilizador. O suporte 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:
    IBM i Access Client Solutions

Para obter as informações mais recentes sobre produtos do IBM i Access Family visite:
    IBM i Access Family


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 8.0 ou superior, incluindo várias versões do Linux, Mac e Windows.
Nota: O ACS pode não conseguir localizar o Java 8 no macOS 11.0 Big Sur. Recomendamos a instalação do Java 11.

Recomendação:
Manter a versão de Java na versão mais actual garante que dispõe sempre das ú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_191"
O 191, neste exemplo, refere-se ao nível de actualização.

Seguem-se 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.
    https://adoptopenjdk.net/
    https://aws.amazon.com/corretto/
    http://openjdk.java.net/install
    http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
    http://www.oracle.com/technetwork/java/javase/downloads/index.html

Nota Técnica para Mac:
Quando instalar Java em Mac, seleccione um JDK em vez de um JRE. O JRE para Mac instala Java apenas para o navegador. Não instala Java para outras aplicações. A instalação do JDK torna o Java disponível para outras aplicações como, por exemplo, o IBM i Access Client Solutions.

3.2 Pré-requisitos (Conectividade para IBM i)

O IBM i Access Client Solutions estabelece ligação a qualquer edição do IBM i suportada.

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 (5770XW1) para utilizar a emulação 5250 e componentes de Transferência de Dados.

Se estiver a utilizar ligações SSL, carregue e aplique as seguintes PTFs do IBM i para a sua edição:
    7.2 - SI55392, SI57320, MF60333, MF60334

Se estiver a utilizar o Navigator for i, carregue e aplique as PTFs do IBM i adequadas à sua edição:
    7.2 - Grupo de PTF SF99713 nível 30 ou posterior
    7.3 - Grupo de PTF SF99722 nível 17 ou posterior


4.0 Conteúdo do Produto

Os seguintes ficheiros e directórios estão contidos no ficheiro .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 os seguintes artigos:
IBM i Access Client Solutions: Personalização e implementação facilitadas
IBM i Access Client Solutions: Resposta a perguntas de personalização e implementação
Estes artigos explicam como um administrador pode pré-personalizar a instalação para múltiplos utilizadores antes da implementação utilizando a 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 ficheiro .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 ficheiro .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 sã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, deve actualizar a instalação existente.

Para utilizadores que fazem a manutenção da respectiva instalação:

Opção 1:
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 existente.

Opção 2:
Se escolheu instalar o produto sem utilizar os scripts de instalação para extraírem os conteúdos do ficheiro .zip para a mesma localização escolhida, em seguida, 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 que poderá ser necessário guardar e restaurar o conteúdo do ficheiro AcsConfig.properties caso tenha feito alterações personalizadas ao mesmo.

Para administradores que mantenham uma versão do produto numa localização central acedida por múltiplos utilizadores:
Extraia os conteúdos da versão mais recente 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 restaurar o ficheiro AcsConfig.properties, os utilizadores terão de executar uma das seguintes opções:

Opção 1:
Caso os utilizadores estejam a executar directamente a partir da localização remota, não serão necessárias mais acções. Os utilizadores terão de reiniciar o produto para obter as novas actualizações.

Opção 2:
Execute o script de instalação da mesma forma que a instalação inicial para actualizar a instalação local.

Opção 3:
Caso tenha configurado uma Localização de Actualizações do IBM i, secção 5.2, solicite aos utilizadores que seleccionem Ajuda->procurar actualizações a partir da interface gráfica do utilizador principal. Deverá surgir um painel a informar que existe uma actualização disponível. Seleccionem Instalar Actualização. Também é possível executar esta opção a partir da linha de comandos através da utilização do suplemento INSTALLUPDATES.

Após seguir os passos adequados acima, reinicie o produto. É possível utilizar Ajuda->Acerca de a partir da interface gráfica do utilizador principal para verificar se as actualizações foram aplicadas.

5.2 Configurar uma Localização de Actualizações do IBM i

Os administradores poderão utilizar um sistema do IBM i como a respectiva localização central para executar instalações e aplicar actualizações. Independentemente de como implementar o produto inicialmente para os utilizadores, será possível utilizar uma localização central num IBM i de forma a que os utilizadores poderão aplicar uma actualização com um clique de um botão. Os passos são os seguintes:

A definição da propriedade com.ibm.iaccess.CheckUpdateSystem faz com que Ajuda->Procurar Actualizações se comporte de forma diferente. Em vez de procurar numa localização da Web externa pela disponibilidade de uma versão actualizada, é procurada a localização do IBM i acima pela existência de ficheiros do produto actualizados. É detectada uma actualização quando a marca de hora de qualquer ficheiro do produto requerido for alterada. A marca de hora é apresentada no painel Ajuda->Procurar Actualizações com uma opção para instalar a actualização.

O utilizador necessitará de credenciais válidas para o sistema especificado para com.ibm.iaccess.CheckUpdateSystem. Caso as respectivas credenciais ainda não tenham sido colocadas na memória cache a partir de uma ligação anterior para este sistema, ser-lhe-á pedido para fornecer credenciais válidas. A falha no fornecimento de credenciais válidas fará com que não sejam detectadas actualizações.

Não será pedido aos utilizadores que possuem uma Localização de Actualizações do IBM i configurada e tenham seleccionado a opção "Notificar-me quando existirem actualizações disponíveis" sob Editar->Preferências Preferences que facultem credenciais. Apenas serão notificados da existência de uma actualização disponível caso tenham estabelecido ligação com êxito a com.ibm.iaccess.CheckUpdateSystem desde a última vez que iniciaram sessão no respectivo PC.

Nota:

  1. Esta funcionalidade apenas está activa quando utilizar a versão 1.1.8.3 ou superior.
    A partir da versão 1.1.8.6, esta funcionalidade também pode ser activada a partir da interface gráfica do utilizador principal em Editar->Preferências. Consulte Sistema para verificar actualizações no separador Geral. Se o sistema for configurado pela propriedade AcsConfig.properties, será apresentado neste painel e a opção para seleccionar um sistema diferente será desactivada.
  2. Caso com.ibm.iaccess.CheckUpdatePath não esteja definida, assumir-se-á que a localização predefinida é:
            /QIBM/ProdData/Access/ACS/Base
    Nota: A IBM possui agora PTFs específicas da edição que extraem os conteúdos do ficheiro .zip do produto (IBMiAccess_v1r1.zip) para esta localização (consultar secção 5.3). Os próprios Administradores poderão extrair o ficheiro IBMiAccess_v1r1.zip para esta localização, desde que tenham em conta que, caso o PTF seja aplicado, esta localização será actualizada.
  3. O ficheiro AcsConfig.properties, juntamente com acsbundle.jar, é propagado para o PC local durante a implementação inicial, mas não é actualizado durante uma actualização do produto. Para explorar esta funcionalidade, será necessário actualizar AcsConfig.properties no PC do utilizador antes de seleccionar Ajuda->Procurar Actualizações.

Nota especial para administradores que mantêm um ficheiro AcsConfig.properties personalizado dentro de acsbundle.jar:
Esta funcionalidade descarrega o ficheiro acsbundle.jar que existe no IBM i na localização especificada. Não é executado qualquer processamento especial para manter uma versão personalizada do ficheiro AcsConfig.properties durante uma actualização. Caso tenha personalizado anteriormente o ficheiro AcsConfig.properties dentro de acsbundle.jar, será necessário certificar-se de que a nova versão de acsbundle.jar contém as personalizações pretendidas antes de disponibilizar o mesmo para descarregar.

5.3 PTFs Opcionais do IBM i

Para Administradores que pretendem manter uma localização centralizada num IBM i para os respectivos utilizadores instalarem e actualizarem o produto, existem PTFs específicos das edições que facultarão os conteúdos extraídos de IBMiAccess_v1r1.zip em:
        /QIBM/ProdData/Access/ACS/Base

As PTFs para 1.1.8.7 são:

        V7R4M0  SI76178
        V7R3M0  SI76179
        V7R2M0  SI76180
Estas PTFs serão substituídas para cada actualização de produto e normalmente estarão disponíveis dentro de 2 semanas da disponibilidade da actualização do produto.

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 utilizar um dos ficheiros binários ou scripts fornecidos 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 pode ser instalado o Java, 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.

Quando utilizar um ficheiro binário ou script conforme descrito abaixo, o ficheiro binário ou script terá de estar na mesma estrutura de directórios conforme contida no ficheiro .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 de 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)

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

Existe um directório Sample_Scripts no directório Documentation.

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 <java_path> é a localização do comando Java para JDK 8.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 da máquina Virtual Java 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.

Para configurar um sistema para estabelecer uma ligação TLS/SSL, consulte a secção Configurar Ligações Seguras.

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é seis 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 da Consola para a qual não foram introduzidas as informações correspondentes no separador de configuração da Consola, é 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 sã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 sã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.

Nota:
Para evitar ter que importar o nome de utilizador predefinido especificado no separador Ligação de uma Configuração de Sistema, coloque a seguinte propriedade no ficheiro AcsConfig.properties.

    com.ibm.iaccess.ResetDefaultUserOnImport=true

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     /GUI

    /GUI        - esta opção iniciará a GUI de Configurações do Sistema
                  É equivalente a iniciar as Configurações do Sistema a partir da GUI principal.
                  Nota: Ao definir com.ibm.iaccess.CfgActionsRestricted=true no AcsConfig.properties
                  ocultará os botões Novo/Editar/Copiar/Eliminar no painel de Configurações do Sistema.

/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 são utilizadas por serviços IBM para fornecer suporte técnico.

É 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 do módulo num ficheiro .zip que pode ser enviado para a IBM para assistência.

É 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:
                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 GUI principal
                      Ao definir com.ibm.iaccess.ResetForMaintenanceOnExit=true no AcsConfig.properties
                      chamará /killdaemon quando o Access Client Solutions terminar.
    /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 sã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.
Este 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 uma interface gráfica de utilizador 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.

Para não SSL, os seguintes serviços e portas são verificados:

    sshd            22
    telnet          23
    drda           446
    as-svrmap      449
    as-nav        2004
    as-central    8470
    as-database   8471
    as-dtaq       8472
    as-file       8473
    as-netprt     8474
    as-rmtcmd     8475
    as-signon     8476

Para SSL, os seguintes serviços e portas são verificados:

    sshd            22
    telnet-ssl     992
    ddm-ssl        448
    as-svrmap      449
    as-nav        2005
    as-central-s  9470
    as-database-s 9471
    as-dtaq-s     9472
    as-file-s     9473
    as-netprt-s   9474
    as-rmtcmd-s   9475
    as-signon-s   9476
 

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 a GUI do Gestor de Sessões 5250.

É equivalente ao Gestor de Sessões 5250 da 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 da 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 a 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 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.17 CLDownload

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

    /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
    
    As opções válidas são:
       /colheadings=<1/0> - Incluir títulos de colunas como a primeira linha. Quando especificado, os nomes das colunas serão o título.
       /usecollabels      - Utilizar etiquetas de colunas para o título.
    
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 com 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 o 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 a 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>}
                  [/noprompt=<1|0>]
                  [/immed=<0|1>]

    /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.
    /immed=<0|1>         - enviar cada comando à medida que é lido.
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 suplemento fornece a capacidade a qualquer utilizador com autoridade de administrador ou root de restringir certas funções de todos os utilizadores na estação de trabalho actual.

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

    Interfaces de Gestão de Hardware:
    hmi1            Interface de Gestão de Hardware 1
    hmi2            Interface de Gestão de Hardware 2
    asmi            Interface de Gestão de Sistemas Avançada (Advanced System Management Interface, ASMI)
    csmi            Copy Services Manager for i
    dcm             Gestor de Certificados Digitais
    dshmc           DS HMC
    hmc             Consola de Gestão de Hardware (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             Gestor de Virtualização Integrada
    specctrl        Spectrum Control
    tapemgmt1       Gestão de Bandas 1
    tapemgmt2       Gestão de Bandas 2
    are             Administration Runtime Expert
    db2webquery     Db2 Web Query
    

As funções também podem ser excluídas como um grupos através das palavras-chave:

   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,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery
  l1cplugin         l1c
  database          db2,rss,db2tools
  debugger          sysdbg

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, sql
    /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 do tipo .dttx, .dtfx, .hod, .bchx, .ws, .bch e .sql. Numa plataforma não-Windows, é 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 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.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=<sql>       - Iniciar com o SQL 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:

9.1.33 IFS

/PLUGIN=ifs /SYSTEM=<system>
O Sistema de Ficheiros Integrado fornece 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: 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 fornece 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.1.37 OSSSETUP

/PLUGIN=OSSSETUP
O OSSSETUP iniciará uma interface que lhe permitirá gerir pacotes de código aberto no IBM i.

9.1.38 INSTALLUPDATES

/PLUGIN=installupdates [Opções]

As opções válidas são:
    /noprompt         Não pedir ID de utilizador e palavra-passe
                      Nota: Quando utilizar esta opção, caso as credenciais do utilizador para o sistema remoto
                            já se encontrem na memória cache, a procura de actualizações disponíveis irá continuar normalmente.
                            Caso as credenciais do utilizador não se encontrem na memória cache, a autorização para o sistema
                            remoto será recusada e as actualizações não serão disponibilizadas.
INSTALLUPDATES irá procurar no sistema IBM i configurado por actualizações disponíveis e irá descarregar e instalar a actualização automaticamente para a instalação do PC local. Para configurar uma localização do IBM i para descarregar actualizações, consulte a secção 5.2.

9.1.39 HTTPPROXYUI

/PLUGIN=httpproxyui

HTTPPROXYUI irá iniciar uma proxy HTTP protegida que activa a conectividade de um IBM i para a Internet através do computador que executa esta proxy. O acesso à Internet será activado a partir de qualquer sessão do Terminal SSH que introduzir os comandos fornecidos pelo suplemento HTTPPROXYUI.
Nota: A sessão do Terminal SSH terá de estar em execução no mesmo computador que esta proxy.

9.1.40 Conversão de Tipos de Letra UDC

/udcnv  [/wide]

    /wide         Esta opção apenas é válida com a página de códigos 932.
                  Quando especificada, o ficheiro de imagem de tipos de letra produzir irá conter caracteres Unicode.
Invocação de exemplo:
      Start_Programs\Windows_x86-64\acslaunch_win-64.exe /udcnv
Esta opção de linha de comandos destina-se a criar um ficheiro de imagem de tipos de letra que contém Caracteres Definidos pelo Utilizador (UDC, User Defined Characters) que se encontram actualmente configurados numa estação de trabalho Windows. O ficheiro de imagem de tipos de letra será uma página de códigos ANSI baseada no locale da estação de trabalho. São suportadas as seguintes páginas de códigos ANSI:
  Página de Códigos     Plataforma                   Nome do ficheiro de imagem de tipos de letra
     932                Windows Japonês              jpn24.fnt
     949                Windows Coreano              kor24.fnt
     936                Windows Chinês Simplificado  chs24.fnt
     950                Windows Chinês Tradicional   cht24.fnt
É possível utilizar o ficheiro de imagem de tipos de letra criado com a emulação de impressora 5250 em combinação com uma Tabela de Definições de Impressora (PDT, Printer Definition Table) numa estação de trabalho Windows. O comando irá iniciar uma interface gráfica do utilizador que permitirá especificar o caminho no qual deverá colocar o ficheiro de imagem de tipos de letra criado. O ficheiro de imagem de tipos de letra tem de possuir o nome especificado acima e ser colocado na pasta Emulator\fonts que existe em:
      <Raiz de Configuração>\Emulator\fonts
Onde <Raiz de Configuração> é normalmente um caminho como:
       C:\Users\<nome_utilizador>\Documents\IBM\iAccessClient
Para localizar a Raiz de Configuração efectiva para a instalação, consulte a secção 8.1 Localização da Configuração.

Limitações:



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)
    .sql    - ficheiro SQL
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 irá criar: /usr/share/applications/IBM i Access 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 fornecido no ficheiro .zip do produto e encontra-se no mesmo directório que o ficheiro acsbundle.jar quando o ficheiro .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 sã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 ponto 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 é 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 é 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:

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 é 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 de 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.

Nota:
Para evitar ter que importar o nome de utilizador predefinido especificado no separador Ligação de uma Configuração de Sistema, coloque a seguinte propriedade no ficheiro AcsConfig.properties.

    com.ibm.iaccess.ResetDefaultUserOnImport=true

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 ficheiro .zip do produto para qualquer local no Sistema de Ficheiros Integrados (IFS) do IBM i. Por exemplo, se extraiu o ficheiro .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')                                            

Nota:
Também existem PTFs do IBM i que extrairão os conteúdos do produto pelo utilizador num IBM i. Consulte a secção 5.3 PTFs Opcionais do IBM i

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 de uma das seguintes duas propriedades no ficheiro AcsConfig.properties:

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

Ao definir com.ibm.iaccess.ExcludeComps desactivará as funções especificadas. Todas as outras funções serão activadas. Qualquer função especificada nesta propriedade não estará disponível a partir da GUI de ACS principal nem a partir da linha de comandos. As funções que podem ser especificadas nesta propriedade são listadas abaixo.

Ao definir com.ibm.iaccess.IncludeComps activará as funções especificadas. Todas as outras funções serão desactivadas. Qualquer função especificada nesta propriedade está disponível para utilização normal. As funções que podem ser especificadas nesta propriedade são listadas abaixo.

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

    Interfaces de Gestão de Hardware:
    hmi1            Interface de Gestão de Hardware 1
    hmi2            Interface de Gestão de Hardware 2
    asmi            Interface de Gestão de Sistemas Avançada (Advanced System Management Interface, ASMI)
    csmi            Copy Services Manager for i
    dcm             Gestor de Certificados Digitais
    dshmc           DS HMC
    hmc             Consola de Gestão de Hardware (HMC)
    httpadmin       Web (HTTP) Administration for i
    ivm             Gestor de Virtualização Integrada
    specctrl        Spectrum Control
    tapemgmt1       Gestão de Bandas 1
    tapemgmt2       Gestão de Bandas 2
    are             Administration Runtime Expert
    db2webquery     Db2 Web Query
    

As funções também podem ser especificadas como grupos através das seguintes palavras-chave:

   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,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery
  l1cplugin         l1c
  database          db2,rss,db2tools
  debugger          sysdbg

Normalmente estas propriedades não seriam utilizadas em conjunto. Caso sejam utilizadas em conjunto e for especificada uma função em ambas as propriedades, a função será desactivada.

Exemplo 1: Desactivará todas as funções associadas a OPCONSOLE,HWCONSOLE,L1CPLUGIN. Todas as outras funções na lista acima serão activadas.

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

Exemplo 2: Activará descarregamentos de 5250 e de transferência de dados. Todas as outras funções na lista acima serão desactivadas.

     com.ibm.iaccess.IncludeComps=5250,DOWNLOAD  

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 executar esta acção é:

    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 sã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 sã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:

...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 sã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.6.6 Compatibilidade de 5250

É possível utilizar a propriedade com.ibm.iaccess.PC5250Compatibility para alterar o comportamento predefinido para o emulador ACS. É possível definir esta propriedade no ficheiro AcsConfig.properties com os seguintes valores:

    allowNnAsFKeyHotspot      - tratar pontos activos NN (por exemplo FNN, PFNN, FPNN) como pontos activos de teclas de função.
    allowHighlightBypassField - permitir o destaque de ignorar campos com ENTFLDATR.
    allowTypingInSignPosition - permitir que '-' ou ' ' sejam codificados na posição de sinal de um campo numérico de sinal.
    allowTransformSpecialCharsOnPaste - alterar como certos caracteres são convertidos quando colar texto 
                                        de documentos externos (por exemplo, plicas curvas tornam-se plicas direitas).
Exemplo 1:
     com.ibm.iaccess.PC5250Compatibility=allowTransformSpecialCharsOnPaste
Exemplo 2: É possível especificar múltiplos valores numa lista separada por vírgulas.
     com.ibm.iaccess.PC5250Compatibility=allowNnAsFKeyHotspot,allowHighlightBypassField,allowTypingInSignPosition

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:

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 são truncados no fim. Os campos numéricos sã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 acima 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

Caso os valores especiais de %1$s %2$s ou %3$s sejam utilizados na propriedade, será possível alterar ou eliminar a colocação de library.filename e sheet#.

Os valores têm o seguinte significado:

            %1$s - library.filename    Por exemplo: qiws.qcustcdt
            %2$s - sheet#                   Por exemplo: 1
            %3$s - nome de ficheiro de destino sem extensão de ficheiro

A utilização de qualquer um destes valores especiais fornece controlo total sobre o nome da folha.

A definição da propriedade para Sheet%2$s irá produzir os nomes de folha: Sheet1, Sheet2, etc
com.ibm.iaccess.dataxfer.SheetId=Sheet%2$s

Poderá utilizar %1$s %2$s ou %3$s em qualquer combinação com outro texto.

Nota:
Uma vez que os nomes das folhas numa folha de cálculo têm de ser exclusivos, a definição da propriedade para utilizar %1$s ou %3$ sem utilizar também %2$s irá produzir um erro caso seja necessária mais do que uma folha.

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 é 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 o seleccionar 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, é 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 Knowledge Center sobre como configurar o Adaptador de LAN das Ferramentas de Serviço:

Consulte 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 o seleccionar 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, é 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 sã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, é 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 inicia 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.12.5 Desempenho de IFS

O desempenho de IFS quando apresentar o conteúdo de um directório é determinado pelos atributos de colunas seleccionados (Ver->Colunas...) e se o directório contém ligações simbólicas. Para ligações não simbólicas, existe um impacto no desempenho adicional quando seleccionar CCSID ou Owner. Para ligações simbólicas, existe um impacto no desempenho adicional para cada atributo de coluna seleccionado diferente de Icon, Name e Size (KB)

Nota: Size (KB) para ligações simbólicas não é apresentado quando procurar o directório. Seleccione Propriedades para obter o tamanho do ficheiro representado pela ligação simbólica.

Quando apresentar um directório com um grande número de entradas, poderá exceder o limite de memória predefinido da máquina Virtual de Java onde o IBM i Access Client Solutions se encontra em execução. Isto poderá fazer com que todas as janelas abertas abrandem e eventualmente parem de responder. Caso apresente directórios com um grande número de entradas, considere utilizar o filtro Incluir para limitar o número de entradas enviadas a partir do servidor. Ou inicie o produto com a opção -Xmx para aumentar a memória disponível. Por exemplo:

    java -Xmx4g -jar V:/some_location/acsbundle.jar
ou
    Start_Programs\Windows_x86-64\acslaunch_win-64.exe -Xmx4g

Os exemplos acima irão aumentar a memória da predefinição de 1 gigabyte para 4 gigabytes. Poderá ser necessário aumentar ainda mais o tamanho com base no número de entrada no directório.

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


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 8.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 8.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 8.0. Será necessário utilizar uma opção que especifica explicitamente o
      caminho para a página inicial de Java para JDK 8. 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. Q22-2 Pode haver uma disparidade de número de bits entre a aplicação de folha de cálculo que está utilizar e a máquina Virtual Java que está a executar 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:
IBM i Access Client Solutions (5733XJ1)