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

O conteúdo deste documento foi atualizado pela última vez em: 8 de janeiro de 2018

0.5 QuickStartGuide

O QuickStartGuide contém instruções para implementar o produto que funcionará para a maioria dos usuários que estão executando Windows, Mac ou Linux. Para instalar esse produto para um único usuário ou para um PC multiusuário, veja o QuickStartGuide na pasta Documentação.

Detalhes adicionais sobre o produto, outras opções de implementação e customização do produto estão incluídas no restante deste documento.

Conteúdo:

0.5 QuickStartGuide
1.0 Introdução
2.0 Recursos
3.0 Pré-requisitos
4.0 Conteúdo do Produto
5.0 Instalação
  5.1 Atualizando uma Instalação Existente
6.0 Permissões de Arquivo
  6.1 Permissões de Arquivo (Linux, Mac, AIX)
  6.2 Permissões de Arquivo (Windows)
7.0 Iniciando o Produto
  7.1 Iniciando o Produto
  7.2 Iniciando o Produto (usando um script)
  7.3 Iniciando o Produto (usando a linha de comandos)
8.0 Configuração
  8.1 Local da Configuração
9.0 Tópicos Avançados
  9.1 Mais Opções de Linha de Comandos
  9.2 Associações de Arquivo
  9.2.1 Associações de Arquivo (para Windows)
  9.2.1.1 Ícone de Mudança (para Atalho do Windows)
  9.2.2 Configurando um Ícone de Desktop (para Linux)
  9.2.2.1 Associações de Arquivo (para Linux)
  9.2.3 Associações de Arquivo (para Mac)
  9.2.3.1 Criar associações de arquivo (para Mac)
  9.2.3.2 Ícone de mudança (para Mac)
  9.3 Alterando o Local da Configuração
  9.4 Outras Opções de Implementação
  9.4.1 Importar as definições de configuração automaticamente
  9.4.2 Implementação nativa do IBM i
  9.5 Pacotes Customizados
  9.6 Migrando do IBM i Access for Windows
  9.6.1 Migrando Configurações do Sistema
  9.6.2 Migrando a Emulação 5250
  9.6.3 Migrando Arquivo de Solicitação de Transferência de Dados Salvos
  9.6.4 EHLLAPI
  9.6.5 Kerberos
  9.7 Gerenciamento de Chaves
  9.8 Transferência de dados
  9.8.1 Suporte de transferência de dados para planilhas Excel e Calc
  9.8.2 Suporte de transferência de dados para truncamento de caractere e estouro numérico
  9.8.3 Nome da folha de transferência de dados
  9.9 Estabelecendo uma Conexão do Console para IBM i
  9.10 Fontes Adicionais
  9.11 Usando credenciais de um arquivo netrc
  9.12 Sistema de arquivos integrado (IFS)
  9.12.1 IFS, QFileSvr.400 e segurança
  9.12.2 Autoridade do IFS
  9.12.3 Limitações do IFS
  9.12.4 IFS e ASPs independentes
  9.13 Terminal de shell seguro (SSH)
  9.13.1 Pré-requisitos do terminal SSH
10.0 Diagnóstico de Serviço
11.0 Perguntas Mais Frequentes (FAQ)
12.0 Histórico de Atualizações



1.0 Introdução

O IBM i Access Client Solutions é o mais novo membro da família de produtos IBM i Access. Ele fornece uma interface independente de plataforma baseada em Java que é executada na maioria dos sistemas operacionais que suportam Java, incluindo Linux, Mac e Windows. O IBM i Access Client Solutions consolida as tarefas mais comumente usadas para gerenciar o IBM i em um local simplificado.

O IBM i Access Client Solutions usa os mesmos servidores host IBM i que os outros produtos IBM i Access Family e requer a mesma licença do IBM i Access Family (XW1) para usar a emulação 5250 e os recursos de Transferência de Dados.

Também estão disponíveis dois pacotes opcionais que incluem middleware para uso e desenvolvimento de aplicativos clientes para Windows e Linux:
    IBM i Access Client Solutions - Pacote de Aplicativos Windows
    IBM i Access Client Solutions - Pacote de Aplicativos Linux

Clientes que usam o IBM i 7.1 ou mais recente que possuem a autorização atual podem adquirir o IBM i Access Client Solutions por um dos dois métodos a seguir:

Esses pacotes de aplicativo opcionais do Windows e Linux estão disponíveis somente no website Entitled Software Support (ESS).

Os clientes podem adquirir a mídia solicitando o 5761-SS1 ou 5770-SS1 recurso de atualização 6288. A mídia física contém uma versão executável do produto que permite executar o produto diretamente do CD. A mídia física também inclui um archive ZIP do produto que pode ser copiado e extraído para um local de sua opção. A mídia física para o IBM i Access Client Solutions não contém os Pacotes de Aplicativos Windows e Linux opcionais.

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

Para obter as informações mais recentes sobre os produtos da Família IBM i Access, visite:
    http://www.ibm.com/systems/i/software/access/caann.html


2.0 Recursos

Recursos do IBM i Access Client Solutions incluem:

O Pacote de Aplicativo Windows opcional inclui:

O Pacote de Aplicativos Linux opcional inclui:


3.0 Pré-requisitos

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

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

Recomendação:
Manter sua versão de Java na versão mais atual fará com que você tenha todas as correções e correções de segurança mais recentes.

Uma maneira de verificar a versão de Java instalada em seu sistema é colocar um prompt onde um comando pode ser digitado (Prompt de Comandos, Shell, Terminal, etc.) e, em seguida, digitar o comando:
    java -version

A saída a seguir indica que a versão 8.0 está instalada:
    java version "1.8.0_65"
O 65 nesse exemplo refere-se ao nível de atualização.

Aqui estão alguns websites de provedores Java. Certifique-se de que você esteja executando com a versão mais atualizada de Java para sua plataforma.
    http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
    http://www.oracle.com/technetwork/java/javase/downloads/index.html
    http://openjdk.java.net/install

3.2 Pré-requisitos (Conectividade com o IBM i)

O IBM i Access Client Solutions se conectará ao IBM i liberações 5.4 e acima. Os recursos a seguir requerem o IBM i liberação 6.1 ou acima:
    Navigator for i
    Console 5250
    Painel do Controle Virtual

Se você for usar conexões SSL, carregue e aplique as PTFs apropriadas do IBM i de sua liberação:
    7.1 - SI45610, SI55204, SI55389, SI57332, MF60335
    7.2 - SI55392, SI57320, MF60333, MF60334

Se você for usar o Navigator for i, carregue e aplique as PTFs apropriadas do IBM i de sua liberação:
    7.1 - PTF de grupo SF99368 nível 37 ou superior
    7.2 - PTF de grupo SF99713 nível 12 ou superior

Se você for usar o Console 5250 ou o Painel de controle virtual, carregue e aplique as PTFs apropriadas de sua liberação:
    6.1    - MF55543, MF55549
    6.1.1 - MF55540, MF55547
    7.1    - MF55485, MF55538


4.0 Conteúdo do Produto

Os arquivos e diretórios a seguir estão contidos no archive zip do produto:


acsbundle.jar       - um arquivo jar executável do produto
AcsConfig.properties- arquivo contendo as definições de configuração (também existe
                      dentro de acsbundle.jar)

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

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

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

Start_Programs      - diretório contendo arquivos binários específicos da
                      plataforma que podem ser usados para iniciar o produto.
    Linux_i386-32
    Linux_x86-64
    Mac_i386-32_x86-64
    Windows_i386-32
    Windows_x86-64

Documentação        - diretório contendo a documentação
  QuickStartGuide - informações sobre como começar
  GettingStarted  - informações detalhadas sobre o produto
  Licença             - diretório contendo termos e condições para uso
  Avisos              - diretório contendo avisos e informações
  properties          - diretório que contém informações de versão de produto
  Sample_Scripts    - diretório que contém scripts de amostra que podem ser usados para
                      iniciar o produto se os arquivos binários em Start_Programs
                      não funcionarem.
    Linux_Mac_Other - diretório de scripts Perl para iniciar o produto
                      em qualquer plataforma na qual o Perl esteja disponível.
    Windows         - diretório contendo um JScript para início no Windows

Ícones              - diretório que contém arquivos que podem ser usados como ícones

Fontes              - diretório no qual fontes monoespaçadas adicionais podem ser 
                      incluídas para emulação 5250


5.0 Instalação

O empacotamento do IBM i Access Client Solutions fornece várias opções de instalação, da instalação de usuário único muito simples até as instalações multiusuário mais avançadas.

Foram fornecidos scripts de instalação nas pastas Mac_Application, Linux_Application e Windows_Application (veja a seção 4.0 Conteúdo do produto), que podem ser usados para uma variedade de opções de instalação.

Para uma instalação de usuário único no Mac, Linux e Windows ou uma instalação multiusuário em um PC Windows, veja o QuickStartGuide. O QuickStartGuide explica como usar os scripts de instalação fornecidos para executar esses tipos de instalações simples.

Se você for um administrador que planeja realizar a implementação para vários usuários, é provável que queira ler o artigo IBM i Access Client Solutions: customização e implementação fáceis. O artigo explica como um administrador pode customizar previamente a instalação para múltiplos usuários antes de implementar usando a opção /AdminConfig suportada pelos scripts de instalação.

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

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

Além das opções acima, você também tem a opção de simplesmente descompactar o archive zip em qualquer localização de sua escolha. Pode ser qualquer local em que a estação de trabalho tenha autoridade de leitura para acessar os arquivos. Isso inclui a unidade de disco rígido local, uma unidade de rede remota (compartilhada) ou mídia móvel, como um CD ou unidade flash USB. A descompactação do archive zip conclui a instalação.

Nota Técnica:
Alguns utilitários de archive não preservam todos os atributos de arquivo salvo. Por exemplo, em plataformas Mac e Linux, o comando unzip geralmente é uma melhor opção que o comando jar. Para obter informações adicionais, veja a seção 6.0 Permissões de Arquivo.

5.1 Atualizando uma Instalação Existente

Aprimoramentos e correções serão disponibilizados periodicamente. Essas atualizações são fornecidas como uma instalação completa do produto. Quando essas atualizações estiverem disponíveis, será necessário atualizar a instalação existente.

Para atualizar uma instalação existente que foi instalada usando os scripts de instalação, extraia o conteúdo de uma versão mais recente do produto. Chame o script de instalação a partir dessa nova versão da mesma maneira feita durante a instalação inicial. Isso atualizará os arquivos do produto sem mudar a configuração existente dos usuários.

Para administradores que mantêm uma versão do produto em um local central acessado por múltiplos usuários, é possível extrair o conteúdo da versão mais recente sobre a versão existente. Se você tiver feito mudanças customizadas no arquivo AcsConfig.properties, você desejará salvar AcsConfig.properties antes de extrair o conteúdo da nova versão do produto sobre uma versão existente. Depois de ter extraído o conteúdo da nova versão do produto e ter restaurado AcsConfig.properties, seus usuários poderão executar o script de instalação da mesma maneira que a instalação inicial para atualizar a instalação.

Se você optou por instalar o produto sem usar os scripts de instalação, extraindo o conteúdo do archive zip em alguma localização de sua escolha, então, para atualizar o produto, será necessário extrair o conteúdo da versão mais recente do produto sobre a versão existente. Lembre-se de que poderá ser necessário salvar e restaurar o conteúdo de AcsConfig.properties se você tiver feito mudanças customizadas nele.


6.0 Permissões de Arquivo

A Seção 7.0 Iniciando o Produto descreve diferentes maneiras de iniciar o IBM i Access Client Solutions. Se você estiver usando um dos arquivos binários ou scripts fornecidos para iniciar o produto, será necessário certificar-se de que suas permissões de arquivos tenham a permissão de execução ativada. As permissões de arquivo designadas ao descompactar o archive zip são determinadas por vários fatores, incluindo o sistema operacional, o utilitário archive usado para descompactar o archive zip, a autoridade do usuário, etc.

Se você tiver problemas ao usar um dos scripts ou arquivos binários fornecidos, verifique as permissões de arquivo. As seções a seguir descrevem alguns métodos para verificar as permissões de arquivo.

6.1 Permissões de Arquivo (Linux, Mac, AIX)

Para sistemas operacionais semelhantes ao Unix, é possível usar o comando a seguir a partir de um prompt de shell ou de terminal para verificar as permissões de um arquivo:

    ls -l <file>   			

Para alterar as permissões de um arquivo, é possível usar o comando a seguir:

    chmod <permission> <file>	

Por exemplo,
para incluir e executar a permissão para todos:
    chmod a+rx <file>
para fornecer ao proprietário do arquivo as permissões de leitura/gravação/execução e apenas de leitura/execução para todos os outros:
    chmod 755 <file>

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

6.2 Permissões de Arquivo (Windows)

Para Windows, ao visualizar o arquivo usando o Windows Explorer, clique com o botão direito do mouse no arquivo e selecione as propriedades. A guia de segurança deve conter as permissões de arquivo. Certifique-se de ter a permissão de Leitura e Execução.

Em versões recentes do Windows, você também pode usar o comando icacls para visualizar e alterar a permissão de um arquivo.


7.0 Iniciando o Produto

Há diversas maneiras de iniciar o IBM i Access Client Solutions. Se você usou os scripts de instalação para instalar o produto, a maneira mais fácil de iniciar o produto encontra-se no QuickStartGuide.

Se o produto não foi instalado usando os scripts de instalação, o restante desta seção descreverá maneiras alternativas para iniciar o produto. Como há uma variedade de maneiras e localizações de como/onde o java pode ser instalado, alguns dos métodos podem requerer configuração adicional. Se um dos métodos abaixo não funcionar, tente um método diferente. Em alguns casos, uma orientação adicional é fornecida. Você também pode julgar a seção 11.0 Perguntas Mais Frequentes (FAQ) útil.

Quando você estiver usando um arquivo binário ou script conforme descrito abaixo, o arquivo binário ou script deverá estar na estrutura de diretório contida no archive ZIP. Para sua comodidade, você também pode copiar/mover o(s) arquivo(s) binário(s) e/ou scripts para sua(s) plataforma(s) para o mesmo diretório em que o acsbundle.jar existe.

7.1 Iniciando o Produto

Para iniciar o produto a partir de um visualizador de arquivos (por exemplo, Windows Explorer, Mac OS X Finder, etc.) usando um arquivo binário específico de plataforma, localize o subdiretório em Start_Programs que identifica seu sistema operacional e arquitetura de hardware.

Localize o arquivo binário que seu sistema operacional reconhece. Em seguida, dê um clique duplo nele para iniciar o produto. É possível também iniciar o produto com este arquivo binário a partir de um Prompt de Comandos, Terminal ou Shell.

Se você obtiver o erro a seguir:
    "Erro ao carregar o módulo Java."
O IBM i Access Client Solutions não pôde localizar uma instalação java em um local que ele reconhece. Você pode tentar um dos métodos a seguir nas seções:
    7.1.1 Iniciando o Produto - Opções Adicionais
    7.2 Iniciando o Produto (usando um script)
    7.3 Iniciando o Produto (usando a linha de comandos)

Nota Técnica para Mac:
Se você for solicitado a instalar um "tempo de execução Java 6 SE", não será necessário instalar o Java 6. Instale o Java 8 e, em seguida, tente iniciar o produto novamente. Se você estiver usando acslaunch_mac para iniciar o produto e você continuar a ser solicitado a instalar o "tempo de execução Java SE 6 ", então, acesse Utilitários e inicie uma sessão de Terminal. Execute os comandos a seguir e, em seguida, tente iniciar o produto novamente:

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

7.1.1 Iniciando o Produto - Opções Adicionais

Você também pode tentar um dos métodos a seguir ao tentar usar o arquivo binário para sua plataforma. Esses métodos permitem identificar qual Java Runtime Environment (JRE) deve ser usado para iniciar o produto. Veja a seção 7.1.2 Localizando o Caminho Inicial Java para saber como localizar o caminho inicial Java em sua estação de trabalho. Estes métodos adicionais são suportados apenas na plataformas Linux e Windows:

7.1.2 Localizando o Caminho Inicial Java

Se você puder iniciar o produto usando um dos métodos na seção:
    7.2 Iniciando o Produto (usando um script) (OU)
    7.3 Iniciando o Produto (usando a linha de comandos)
em seguida, é possível determinar o caminho inicial java em sua estação de trabalho a partir da GUI principal do IBM i Access Client Solutions. Na barra de menus, selecione
    Ajuda->Sobre
    O caminho java.home é exibido neste painel.

A propriedade java.home contém o local do caminho inicial java para a estação de trabalho. Este é o caminho que você precisará especificar ao configurar a variável de ambiente JAVA_HOME ou ao usar a opção -vm no comando.

7.1.2.1 Localizando o Caminho Inicial Java (no Windows)

Nas plataformas Windows, procure java.exe. O binário java está, normalmente, localizado em um compartimento ou subdiretório jre/compartimento abaixo do caminho inicial Java. O caminho inicial Java pode ser usado ao configurar a variável de ambiente JAVA_HOME ou ao usar a opção -vm no comando.

7.1.2.2 Localizando o Caminho Inicial Java (no Linux)

No Linux, é possível usar o comando "which":

    which java
Isso dará a você um caminho para o comando java ou um link simbólico para ele.

Resolva todos os links simbólicos até você, finalmente, chegar ao arquivo binário real para o comando java. É possível resolver os links simbólicos usando o comando ls com a opção -l:

    ls -l <file>
O binário java está, normalmente, localizado em um compartimento ou subdiretório jre/compartimento abaixo do caminho inicial Java. O caminho inicial Java pode ser usado ao configurar a variável de ambiente JAVA_HOME ou ao usar a opção -vm no comando.

7.2 Iniciando o Produto (usando um script)

A partir da v1r1m5, o diretório Start_Scripts foi renomeado para Sample_Scripts e colocado no diretório Documentação.

A maneira preferencial de iniciar o produto é usando um arquivo binário específico da plataforma, disponível em Start_Programs. Os scripts em Sample_Scripts só deverão ser usados se o binário específico da plataforma não funcionar.

Para iniciar o produto a partir de um navegador do sistema de arquivos (por exemplo, Windows Explorer, Mac OS X Finder, etc.) usando um dos scripts fornecidos, localize o script no subdiretório Sample_Scripts que seja compatível com seu sistema operacional.

A maioria dos sistemas operacionais não baseados em Windows tem Perl disponível por padrão. O diretório Sample_Scripts/Linux_Mac_Other contém um script perl (com três extensões de arquivo diferentes) que pode ser usado para iniciar o produto em qualquer plataforma em que perl esteja disponível. Selecione o arquivo que tenha uma extensão de arquivo que o sistema operacional reconheça como um script perl.

Os sistemas operacionais baseados em Windows têm JScript disponível por padrão. O diretório Sample_Script/Windows contém um JScript que pode ser usado para iniciar o produto em sistemas operacionais Windows.

Usando um método específico da plataforma para procurar o sistema de arquivos (por exemplo, Windows Explorer, Mac OS X Finder, etc.), localize o script que o sistema operacional reconhece. Em seguida, dê um clique duplo nele para iniciar o produto. É possível também iniciar o produto com este script a partir de um Prompt de Comandos, Terminal ou Shell.

7.3 Iniciando o Produto (usando a linha de comandos)

Também é possível iniciar o produto a partir da linha de comandos de qualquer lugar em que seja possível inserir um comando (Prompt de Comandos, Terminal, Shell, etc)

    java -Xmx1024m -jar <path>/acsbundle.jar
em que <path> é o local do arquivo jar executável do produto

Por exemplo:
    java -Xmx1024m -jar V:/some_location/acsbundle.jar
ou
    <java_path>java -jar V:/some_location/acsbundle.jar
em que <java_path> é o local do comando java para o JDK 6.0 ou superior.

Veja a seção 7.1.2 Localizando o Caminho Inicial Java para determinar o caminho completo para o comando java.

Você também pode usar 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 heap da Java Virtual Machine é padronizado para um tamanho máximo que é muito pequeno para utilizar diversas funções no produto IBM i Access Client Solutions. Um tamanho de heap máximo de um gigabyte (-Xmx1024m) é o tamanho mínimo recomendado. Especificar tamanhos menores que um gigabyte ou usar o tamanho de heap padrão pode produzir uma OutOfMemoryException.


8.0 Configuração

Inclua uma configuração do sistema para cada sistema IBM i que você deseja usar ou gerenciar. Para incluir uma configuração do sistema, selecione Configurações do Sistema das tarefas de Gerenciamento. Em seguida, selecione Novo. Na guia Geral, insira o nome do sistema. Para começar, o nome do sistema é tudo o que é necessário para executar as tarefas Gerais.

Quando tiver concluído, selecione OK para salvar as informações digitadas para este sistema ou selecione Salvar/Novo se tiver sistemas adicionais que você gostaria de incluir na configuração.

Você pode incluir novos sistemas em sua configuração ou atualizar as configurações existentes usando as guias Geral, Conexão ou Console a qualquer momento.

Para as tarefas Console, é requerida uma configuração adicional. As configurações do Console são automaticamente associadas ao nome do sistema digitado na guia Geral. Para digitar a configuração do console para um sistema, selecione Configurações do Sistema das tarefas de Gerenciamento. Selecione Novo ou Editar. Em seguida, selecione a guia Console. A tarefa do Console 5250 requer um console LAN configurado ou um console HMC configurado. Se você não tiver uma LAN ou console do HMC configurado, veja a seção 9.9 Estabelecendo uma Conexão do Console para o IBM i.

A tarefa do Hardware Management Interface requer uma interface de gerenciamento de hardware configurada. Você pode digitar até duas configurações de interface de gerenciamento de hardware.

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

Usando a caixa suspensa Sistema no painel principal do IBM i Access Client Solutions, selecione um Sistema. Todas as tarefas do Console associam automaticamente o Sistema selecionado (digitado na guia Geral) à configuração do console (digitada na guia Console).

Agora, você pode selecionar uma tarefa para o sistema selecionado. Se você selecionar uma tarefa do Console que não tenha as informações correspondentes digitadas na guia de configuração do Console, será exibida uma mensagem de erro.

8.1 Local da Configuração

Por padrão, cada usuário terá seu próprio local exclusivo para sua configuração. O diretório-raiz de configuração é determinado de uma maneira dependente da plataforma. Os diretórios de configuração serão criados durante a primeira inicialização. Para ver onde está o diretório de configuração:
      Inicie o produto (veja a seção 7.0 Iniciando o Produto)
    Editar->Preferências
    Selecione a guia Configurações Locais
    Raiz de Configuração

O local de configuração não pode ser alterado enquanto o produto está em execução. Para alterar o local da configuração, veja a seção 9.3 Alterando o Local da Configuração


9.0 Tópicos Avançados

9.1 Mais Opções de Linha de Comandos

Muitas das funções que estão disponíveis a partir da GUI principal também estão disponíveis a partir da linha de comandos. Essas funções podem ser chamadas ao fornecer os parâmetros apropriados para qualquer uma das opções da linha de comandos mostradas na:
seção 7.3 Iniciando o Produto (usando a linha de comandos)

Por exemplo:

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

Apenas os parâmetros adicionais serão mostrados nas seções a seguir:

9.1.1 Backup

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

Isso salvará a configuração atual para o arquivo especificado. O arquivo resultante pode ser usado como entrada para a opção da linha de comandos Restaurar na mesma estação de trabalho ou em uma estação de trabalho diferente (independentemente do sistema operacional).

O local para a configuração ser salva é determinado pela propriedade:

    com.ibm.iaccess.AcsBaseDirectory
...que está localizado no arquivo AcsConfig.properties.

Esta função é equivalente a Arquivo->Exportar configuração da GUI principal.

9.1.2 Restore

/PLUGIN=restore /file=<filename>
    <filename> é o local do arquivo criado pelo Backup
Isso irá restaurar uma configuração salva do arquivo especificado. Toda configuração existente que não esteja no arquivo especificado será perdida.

O local da configuração restaurada é determinado pela propriedade:

    com.ibm.iaccess.AcsBaseDirectory
...que está localizado no arquivo AcsConfig.properties.

Esta função é equivalente a Arquivo->Importar configuração da GUI principal.

9.1.3 Certdl

/PLUGIN=certdl  /SYSTEM=<system>
Faz download de uma autoridade de certificação (CA) do sistema IBM i especificado e a armazena no armazenamento de confiança local do usuário. Isso é requerido para autenticação de servidor com SSL.

9.1.4 Cfg

/PLUGIN=cfg     /LIST

    /LIST     - lista os sistemas configurados com suas opções de conexão


/PLUGIN=cfg     /SYSTEM=<system> [/ipaddr=<frequency>] [/userid=<userid>]
                                 [/ssl=<switch>]
                                 [/5250path=<path>]
                                 [/del]  [/r]

    /SYSTEM     - nome do sistema
    /ipaddr     - quando uma conexão é solicitada, este valor determina se
                  a consulta do endereço IP irá ou não ocorrer. Frequências válidas
                  são:
                      ALWAYS - consultar endereço IP para cada conexão
                      HOURLY, DAILY, WEEKLY - consultar endereço IP se a quantia de
                          tempo decorreu desde a última consulta
                      endereço IP - se um endereço IP é especificado, a frequência de
                          consulta é assumida como NEVER
    /userid     - id do usuário para um usuário
                  também pode ser configurado para os valores a seguir:
                      *SHARE        - solicita uma vez credenciais de logon que
                                      serão compartilhadas por sistemas que usam essa opção
                      *PROMPTALWAYS - solicita pelo menos uma vez para cada conexão
                      *KERBEROS     - utilizar nome do proprietário Kerberos, sem solicitar informações
    /ssl        - o comutador é 0 para desativar o SSL, ou 1 para ativá-lo
    /5250path   - caminho para os perfis de emulação 5250
                  O /5250path pode ser configurado por Arquivo->Mudar diretório... do
                  Gerenciador de Sessões 5250
    /del exclui a configuração existente
    /r   substitui a configuração existente
Isso permite que várias opções de configuração sejam configuradas a partir da linha de comandos. Essas opções também podem ser configuradas a partir da GUI principal usando Configurações do Sistema.

9.1.5 Dump

/PLUGIN=dump  [/<options>]
Solicita que todos os processos em execução no produto executem dump em seus encadeamentos. Essas informações serão usadas pelo serviço IBM para fornecer suporte ao problema.

Os logs gerados podem ser acessados a partir da GUI principal por:
    Editar->Preferências
    Guia Configurações Locais
    Diretório de Dumps

Se nenhuma opção for especificada, esta função será equivalente à função a seguir a partir da GUI principal:
    Ferramentas->Gerar Logs de Serviço

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

    /heapdump - executa o indicado acima mais um dump do heap JVM

9.1.6 Medic

/PLUGIN=medic
Compacta os logs e os dumps de encadeamento existentes em um arquivo zip que pode ser enviado para a IBM para obter assistência.

O arquivo zip resultante pode ser acessado a partir da GUI principal por:
    Editar-Preferências
    Guia Configurações Locais
    Diretório de Serviço
Esta função é equivalente a Ferramentas->Logs de Serviço do Pacote a partir da GUI.

9.1.7 Log

/PLUGIN=log  /LEVEL=<Level>
                <Level> é um dos níveis de criação de log de suporte a seguir:
                OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST
Este plug-in permite que o usuário alterne seu nível de log a partir da linha de comandos.

O nível de criação de log também pode ser configurado a partir da GUI principalmente por:
    Editar->Preferências
    Guia Geral
    Nível de criação de log

9.1.8 Logon

/PLUGIN=logon    /SYSTEM=<system> [/USERID=<userid>] [/PASSWORD=<password>] [/AUTH] [/C] [/GUI=<1|0>]

    /SYSTEM   - nome do sistema
    /USERID   - ID do usuário
    /PASSWORD - senha associada ao ID do usuário
    /AUTH     - tenta conectar-se ao sistema com credenciais de logon especificadas
                e armazena-as em cache apenas no caso de êxito
    /C        - limpa o cache
    /GUI      - se é possível ou não usar uma interface gráfica com o usuário
Este comando armazenará em cache o ID do usuário e a senha que podem ser usados para evitar a solicitação de senha.

9.1.9 props

/PLUGIN=props
Apresenta o mesmo painel da GUI como Editar->Preferência a partir da GUI principal.

9.1.10 Maint

/PLUGIN=maint [/<options>]

As opções válidas são:
    /killdaemon     - termina encadeamentos do daemon.
                      O mesmo que Ferramentas->Reconfigurar para Manutenção a partir da GUI
    /clearpwcaches  - limpa todas as senhas armazenadas em cache
    /clearjarcache  - limpa o cache do jar do produto
    /clearlogs      - limpa o Diretório de Logs em Editar->Preferências
                      Guia Configurações Locais na GUI principal
    /cleardumps     - limpa o Diretório de Dumps em Editar->Preferências
                      Guia Configurações Locais na GUI principal
    /clearsvcdir    - limpa o Diretório de Serviço em Editar->Preferências
                      Guia Configurações Locais na GUI principal
    /clearsettings  - limpa todas as configurações para o usuário atual
Se nenhuma opção for especificada, nenhuma ação será executada.

9.1.11 Ping

/PLUGIN=ping /SYSTEM=<system> [</options>]
    As opções incluem:
        /SSL=<1|0> Ativar ou desativar SSL
        /ACCEPTALLCERTS=<1|0> Se incluir automaticamente ou não todos os SSL
                          incluídos no conjunto confiável (ao usar SSL).
        /SERVERAUTH=<1|0> Ativar ou desativar a autenticação de servidor SSL (o padrão é
                          é desativado). Esta opção é desconsiderada se não estiver testando o SSL.
        /GUI=<1|0> Alternar a ativação/desativação da janela da GUI (o padrão é desativado se ativado
                          da linha de comandos)
        /PORTS=<port1,port2> Uma lista separada por vírgulas de portas a testar. Ela pode
                ser números ou nomes de serviço (por exemplo, /PORTS=as-signon,as-sts). Se não
                especificado, um conjunto padrão de portas é testado.
                Especificar .CONSOLE verificará uma lista de opções específicas do console.

        /TIMEOUT=<seconds>   Especificar um valor de tempo limite, em segundos.
Este plug-in verifica a conectividade com o IBM i abrindo uma conexão com a porta apropriada. Se estiver verificando uma conexão SSL, um handshake SSL será tentado. Se for ativado a partir da GUI principal ou chamado com /GUI=1, este plug-in exibirá um diálogo. Se ativado a partir da linha de comandos sem /GUI=1, a saída será enviada para o console.

Por padrão, os serviços a seguir são verificados:
    as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda,
    as-signon

Esta função pode ser ativada a partir da GUI principal por:
    Configurações do Sistema
    selecione um sistema e, em seguida, Editar
    Guia Geral
    Verificar Conexão

9.1.12 Sm

/PLUGIN=sm
Este plug-in inicia a GUI do Gerenciador de Sessões 5250.

Este é equivalente ao Gerenciador de Sessões 5250 da GUI principal.

9.1.13 5250

/PLUGIN=5250 /SYSTEM=<system> [/<options>]

Este plug-in inicia um emulador 5250 para 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 curto
    /name=<name>                 - nome da sessão
    /wsid=<identifier>           - ID da estação de trabalho
    /wide=<1|0|true|false>       - usar um tamanho de tela amplo (27x132)
    /fullscreen<1|0|true|false>  - usar a tela inteira
    /nosave=<1|0|true|false>     - não salvar as configurações ao sair
    /prompt=<1|0|true|false>     - forçar o aparecimento do diálogo de configuração
    /port=<port>                 - número da porta
    /ssl=<1|0|true|false>        - conectar usando soquetes seguros
    /sso=<1|0|true|false>        - tela de conexão de bypass
    /kerberos                    - Usar 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 de emulador
    /ypos=<ypos>                 - posição da coordenada Y inicial do canto superior esquerdo
                                   superior esquerdo da janela de emulador
    /watermark                   - exibir nome do sistema como marca d'água na tela
    /watermark=<text>            - exibir texto fornecido como marca d'água na tela
    

9.1.14 DTGui

/PLUGIN=dtgui

Este plug-in inicia a GUI principal para Transferência de Dados.

Esta função é equivalente à Transferência de Dados da GUI principal.

9.1.15 Download

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

    /userid   - id do usuário a usar ao conectar-se ao sistema de destino
    <filename>- arquivo com a extensão .dtfx que foi criado a partir de um
                download de Transferência de Dados anterior.
Este plug-in permite que o usuário execute um download de Transferência de Dados salvo anteriormente.

A Transferência de Dados também está disponível a partir da GUI principal selecionando Transferência de Dados.

9.1.16 Upload

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

    /userid   - id do usuário a usar ao conectar-se ao sistema de destino
    <filename>- arquivo com a extensão .dttx que foi criado a partir de um
                upload de Transferência de Dados anterior.
O plug-in permite que o usuário execute um upload de Transferência de Dados salvo anteriormente.

A Transferência de Dados também está disponível a partir da GUI principal selecionando Transferência de Dados.

9.1.17 CLDownload

/PLUGIN=cldownload /system=<system>
                          [/userid=<userid>]
                          {/hostfile=<library/filename> | /sql="statement"}
                          {/clientfile=<path><filename>.<extension> | /display}

    /userid   - id do usuário a usar ao conectar-se ao sistema de destino
    /hostfile   - Biblioteca e arquivo de origem no sistema IBM i para o download
                  por exemplo, /hostfile=QIWS/QCUSTCDT
    /sql        - especificar uma instrução SQL
                  por exemplo, /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT"
    /clientfile - Local do arquivo de destino para o download.
                  O formato deste arquivo será determinado pela extensão especificada
                  (por exemplo, .csv .ods .xlsx .xlsx)
                  Se a extensão do arquivo não for especificada ou for de um tipo
                  não suportado, os dados serão formatados como um arquivo .csv
    /display    - gravar a saída no terminal
O plug-in permite que o usuário execute um download simples de um arquivo inteiro a partir da linha de comandos.

9.1.18 Console

/PLUGIN=console /SYSTEM=<system>
Este plug-in inicia um console 5250 para o sistema especificado.

Esta função é equivalente ao console 5250 da GUI principal.

9.1.19 VCP

/PLUGIN=vcp /SYSTEM=<system>
Este plug-in inicia um Painel de Controle Virtual para o sistema especificado.

Esta função é equivalente ao Painel de Controle Virtual da GUI principal.

9.1.20 L1C

/PLUGIN=l1c /SYSTEM=<system>
Este plug-in ativa um navegador para o IBM Navigator for i usando o sistema especificado e a porta 2001.

Esta função é equivalente à Navigator for i da GUI principal.

9.1.21 SPLF

/PLUGIN=splf /SYSTEM=<system>
Este plug-in exibe a GUI da Saída de Impressora para visualização e download de arquivos de spool do IBM i.

Esta função é equivalente à Saída de Impressora da GUI principal.

9.1.22 KEYMAN

/PLUGIN=keyman
Este plug-in exibe a ferramenta de gerenciamento de chaves.

Esta função é equivalente a Ferramentas->Gerenciamento de Chaves a partir da GUI.

9.1.23 RMTCMD

/PLUGIN=rmtcmd /SYSTEM=<system>
                  {/CMD="<CL command>" | file=<file_name>}
                  [/ignorefailure=<1|0>]

    /cmd="<CL command>"  - um comando a executar. Use aspas para evitar que espaços
                           quebrem o comando.
    /file=<file_name>    - especificar um arquivo de entrada com diversos comandos. Os
                           comandos devem ser um por linha, sem aspas.
    /noprompt=<1|0>      - ao especificar um arquivo de entrada, ignore os resultados e
                           quaisquer prompts antes de continuar.
Este plugin envia comando(s) CL para o sistema especificado.

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

9.1.24 PWCHANGE

/PLUGIN=pwchange /SYSTEMS=<system,system,system,...>
Este plug-in altera a senha nos sistemas especificados. Ele solicita ao usuário um ID do usuário, senhas antigas e novas.

Esta função também pode ser usada a partir da GUI principal ao selecionar a guia Senhas a partir de Editar->Preferências

9.1.25 MIGRATE

/PLUGIN=migrate /<option> /SYSTEM=<system>

<system> pode ser configurado para um nome de sistema ou configurado para *ALL
para indicar todos os sistemas.

As opções válidas são:
    /IMPORT - Copiar uma (ou todas) as configurações do sistema a partir da configuração
              do Windows legada para o IBM i Access Client Solutions.
    /EXPORT - Copiar uma (ou todas) as configurações do sistema para a configuração do Windows
              legada a partir do IBM i Access Client Solutions.
    /DELETE - Excluir uma (ou todas) as configurações do sistema da configuração do Windows legada.
Este plug-in permite copiar configurações do sistema em dois sentidos entre o IBM i Access Client Solutions e a configuração do Windows legada suportada pelo IBM i Access for Windows.

Esta função também pode ser usada a partir da GUI principal ao selecionar Arquivo->Copiar Conexões

9.1.26 RESTRICT

Nota: este plugin está diposnível somente para usuário com autoridade raiz ou de administrador.
/PLUGIN=restrict /<options>

 As opções válidas são:
     /restrict=<func1,func2,func3>   Restringe as funções determinadas nesta
                                     estação de trabalho.
     /unrestrict=<func1,func2,func3> Permite as funções determinadas nesta
                                     estação de trabalho.
     /list                           Lista se as funções são permitidas ou
                                     restringidas nesta estação de trabalho.
     /export=<file>                  Exportar restrições para o arquivo nomeado com
                                     uma extensão de arquivo .acsr.
     /import=<file>.acsr             Importar as restrições de um arquivo com
                                     uma extensão de arquivo .acsr.
     /exportreg=<file>               Exportar um arquivo de registro do Windows (arquivo .reg).

Este plug-in fornece a capacidade para qualquer pessoa com autoridade de administrador ou raiz restringir determinadas funções de todos os usuários na estação de trabalho atual.

   Função             Descrição
    cfg             Configurações do Sistema
    sm              Gerenciador de Sessões 5250
    5250            Emulador 5250
    vcp             Painel de Controle Virtual
    console         Console 5250
    consoleprobe    Procurar a rede local para configurações do console
    hmcprobe        Procurar partições em um HMC
    hmi1            Interface de Gerenciamento de Hardware 1
    hmi2            Interface de Gerenciamento de Hardware 2
    keyman          Gerenciamento de certificado SSL/TLS
    dtgui           Interface gráfica com o usuário de Transferência de Dados
    upload          Uploads em lote de Transferência de Dados
    download        Downloads em lote de Transferência de Dados
    cldownload      Downloads em lote de Transferência de Dados
    l1c             IBM Navigator for i (Console do Nível 1)
    rmtcmd          Comando remoto (disponível a partir da linha de comandos)
    splf            Saída de Impressora (arquivos de spool)
    ifs             Sistema de arquivos integrado
    db2             Esquemas
    rss             Executar Scripts SQL
    db2tools        Centro de desempenho SQL
    sysdbg          Depurador de sistema IBM i
    checkupdates    Verificar atualizações disponíveis
    ssh             Shell seguro

Também é possível excluir funções usando palavras-chave de grupo:

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

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

Para obter uma maneira fácil de restringir funções em múltiplas estações de trabalho, veja a seção 9.5 Pacotes customizados.

9.1.27 RESTRICTVIEW

/PLUGIN=restrictview
Lista as funções que estão atualmente restritas nesta estação de trabalho.

9.1.28 FILEASSOC

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

    <filetype> - os tipos de arquivos válidos são: dttx, dtfx, hod, bchx, ws, bch
    /c           - limpar a associação do arquivo para os tipos de arquivos especificados
Em uma plataforma Windows, isto configura as associações de arquivo para arquivos do tipo .dttx, .dtfx, .hod, .bchx, .ws e .bch. Em uma plataforma não Windows, uma mensagem de erro será exibida.

Esta função é equivalente a Ferramentas->Associações de Arquivo a partir da GUI principal.

9.1.29 DTBATCH

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

    /userid   - id do usuário a usar ao conectar-se ao sistema de destino
    <filename>- arquivo com a extensão .dtfx ou .dttx que foi criada a partir de um
                download ou upload de Transferência de Dados anterior.
                Vários arquivos podem ser especificados com ou sem esta palavra-chave.
O plug-in permite que o usuário execute uma solicitação de transferência de dados anteriormente salva.

A Transferência de Dados também está disponível a partir da GUI principal selecionando Transferência de Dados.

9.1.30 PM5250

/PLUGIN=pm5250 [/input=<file> ...  /output=<directory>] [/verbose] [/gui]

    /input    - Arquivos a serem migrados. Devem ser arquivos 5250 com
                uma extensão de .ws, .bch, .kmp, .pmp ou .bar.
    /output   - localização no qual os arquivos migrados serão armazenados.
    /verbose  - exibe resultados de arquivos migrados.
    /gui      - iniciar a interface com o usuário para migrar arquivos 5250.
O plug-in permite que o usuário migre arquivos do emulador do IBM i Access for Windows Personal Communications para o emulador do IBM i Access Client Solutions. Alguns arquivos convertidos terão uma nova extensão de arquivo. Veja a seção 9.6.2 Migrando a emulação 5250.

9.1.31 RSS

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

    /FILE=<filename> - Abra o arquivo especificado
    /SQL=<filename> - Abra o arquivo especificado
    /AUTORUN=<1,0>   - Execute automaticamente o script
O plug-in permite que o usuário execute instruções SQL e comandos CL.

9.1.32 DB2TOOLS

/PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<database> [Opções]

As opções válidas são:
    /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE>
                    - Ação para executar:
                      A opção LIST pode ser usada com o argumento LISTNAME e exibe o
                      Centro de desempenho SQL com a lista especificada.
                      A opção ANALYZE analisa o conjunto de dados de desempenho fornecido.
                      A opção STATEMENTS mostra as instruções para o Cache de plano SQL ou
                      o conjunto de dados de desempenho fornecido.
                      A opção COMPARE compara os conjuntos de dados de desempenho fornecidos.
    /NAME=<name> - O nome do conjunto de dados de desempenho
    /TABLE=<name> - O nome da tabela que contém 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 ser exibida no Centro de desempenho SQL.
O plug-in do Centro de desempenho SQL fornece um conjunto de ferramentas para ajudá-lo a otimizar o SQL em seus aplicativos de banco de dados:

9.1.33 IFS

/PLUGIN=ifs /SYSTEM=<system>
O Integrated File System fornece uma interface para procurar o sistema de arquivos integrado do IBM i e para trabalhar com objetos no sistema de arquivos integrado das maneiras a seguir: Consulte a seção 9.12 Integrated File System (IFS) para obter os requisitos e as limitações ao usar esse plug-in.

9.1.34 DB2

/PLUGIN=DB2 /SYSTEM=<system>
O plug-in fornece uma interface para gerenciar os bancos de dados Db2 for i no IBM i.

9.1.35 CHECKUPDATES

/PLUGIN=checkupdates
O plug-in fornece uma interface para verificar se há atualizações disponíveis.

9.1.36 SSH

/PLUGIN=SSH /SYSTEM=<system>
O Terminal SSH lançará um cliente SSH já instalado (emulador de terminal) em seu PC para o sistema de arquivos integrado do IBM i.

9.2 Associações de Arquivo

Alguns arquivos de configuração gerados pelo IBM i Access Client Solutions são suportados a partir da linha de comandos quando são fornecidos como o primeiro e único parâmetro. Quando esses arquivos com extensões de arquivo específicas são fornecidos como o primeiro parâmetro, o IBM i Access Client Solutions associa o arquivo à função a ser chamada e fornece o arquivo como entrada para essa função.

As extensões a seguir possuem suporte de associação de arquivo:

    .dttx   - solicitação de upload de Transferência de Dados
    .dtfx   - solicitação de download de Transferência de Dados
    .hod    - perfil da sessão de emulador 5250
    .bchx   - perfil de emulação de sessões múltiplas
    .ws     - perfil de sessão de emulador 5250 (Personal Communications)
    .bch    - perfil de emulação de sessões múltiplas (Personal Communications)
Exemplos de linha de comandos:
    acslaunch_xxx dt_download_file.dtfx - executa a operação de download salva
    acslaunch_xxx dt_upload_file.dttx   - executa a operação de upload salva
    acslaunch_xxx system_lp13ut20.hod   - inicia uma sessão 5250 para o sistema
...em que acslaunch_xxx é a sintaxe da linha de comandos usada para iniciar o produto. Veja a seção 7.3 Iniciando o Produto (usando a linha de comandos).

Estas associações de arquivos da linha de comandos suportados permitem que o usuário configure manualmente as associações de arquivos específicas do sistema operacional (S.O.). Como as associações de arquivos são dependentes da plataforma, as etapas requeridas dependem do S.O.

O motivo pelo qual você pode querer considerar a configuração de associações de arquivos para seu S.O. é que você tem a capacidade de clicar duas vezes em um arquivo (de um dos tipos de arquivos suportados acima) para iniciar a função designada.

As seções a seguir fornecem alguns exemplos de configuração de associações de arquivos para alguns sistemas operacionais.

9.2.1 Associações de Arquivo (para Windows)

  1. A partir da barra de menus da GUI principal, selecione Ferramentas->Associações de Arquivo...
  2. Selecione os tipos de arquivos para os quais você deseja criar associações de arquivo.
  3. Selecione OK

A função apropriada do IBM i Access Client Solution será executada quando você der um clique duplo nos arquivos com este tipo.

9.2.1.1 Ícone de Mudança (para Atalho do Windows)

  1. Localize o atalho criado anteriormente para o arquivo binário apropriado para sua arquitetura de hardware (acslaunch_win-32.exe OU acslaunch_win-64.exe)
  2. Clique com o botão direito do mouse e selecione Propriedades
  3. Selecione a guia Atalho
  4. Clique no botão Ícone de Mudança...
  5. Selecione o ícone a ser usado para este atalho
  6. Selecione OK
  7. Selecione OK

9.2.2 Configurando um Ícone Desktop (para Linux)

Siga as etapas no QuickStartGuide para Linux. Isso instalará o aplicativo em /opt/ibm/iAccessClientSolutions. Isto também criará: /usr/share/applications/IBM i Accesss Client Solutions.desktop

Para criar um ícone para o produto em seu desktop, copie o arquivo .desktop acima para sua pasta Desktop. Pode ser necessário ajustar as permissões de arquivo em seu desktop para que ele seja executável.

9.2.2.1 Associações de Arquivo (para Linux)

As etapas requeridas para configurar associações de arquivo dependerão da distribuição Linux e do ambiente de área de trabalho sendo usado. No geral, as etapas requeridas serão semelhantes às etapas acima usadas para Windows.

  1. Localize um arquivo que deseja associar que contém uma extensão suportada (por exemplo, .hod, .bchx, .dtfx ou .dttx)
  2. Clique com o botão direito do mouse no arquivo. Procure opções ou propriedades que permitam que você associe um programa ao arquivo.
  3. Associe o arquivo e/ou sua extensão com o arquivo binário ou script de ativação do IBM i Access Client Solutions apropriado.

9.2.3 Associações de Arquivo (para Mac)

Para usar Associações de Arquivo em um Mac, o tipo de arquivo deve ser associado com um aplicativo. Siga as etapas no QuickStartGuide para Mac para que o IBM i Access Client Solutions seja um aplicativo instalado.

9.2.3.1 Criar associações de arquivo (para Mac)

  1. Use o Localizador para localizar um arquivo que deseja associar que contém uma extensão suportada (por exemplo, .hod, .bchx, .dtfx ou .dttx)
  2. Selecione o arquivo e, em seguida, Arquivo->Obter Informações
  3. Sob "Abrir com:" selecione a opção Outro
  4. Procure a localização do aplicativo IBM i Access Client Solutions.
  5. Selecione o aplicativo.
  6. Marque a caixa para Sempre Abrir Com. Selecione Incluir.
  7. De volta para "Abrir com:" selecione Alterar Tudo. Selecione continuar para qualquer diálogo.

A função apropriada do IBM i Access Client Solution será executada quando você der um clique duplo nos arquivos com este tipo.

9.2.3.2 Ícone de mudança (para Mac)

Use o aplicativo Visualização para localizar a pasta Ícones no diretório do produto e use o Localizador para substituir o ícone em Obter Informações.

  1. Na Visualização, selecione Arquivo->Abrir
  2. Localize o diretório Ícones do produto
  3. Selecione o arquivo que contém o Ícone e, em seguida, Abrir
  4. Selecione Editar->Selecionar Tudo
  5. Selecione Editar->Copiar
  6. No Localizador, localize o arquivo .hod, .bchx, .dtfx ou .dttx cujo ícone deve ser alterado.
    Se o arquivo já estiver em sua área de trabalho, clique nele para selecioná-lo. Caso contrário, Selecione Acessar->Acessar Pasta e, em seguida, insira o caminho para o arquivo e, em seguida, Acessar.
    Clique no arquivo para selecioná-lo.
  7. Arquivo->Obter Informações
  8. Clique no ícone na parte superior de Obter Informações
  9. Editar->Colar

9.3 Alterando o Local da Configuração

Por padrão, cada usuário terá seu próprio local exclusivo para sua configuração. O local da configuração pode ser alterado ao configurar a propriedade:
    com.ibm.iaccess.AcsBaseDirectory
Essa propriedade existe dentro do arquivo AcsConfig.properties.

O arquivo AcsConfig.properties existe em dois locais quando o produto é enviado. Ele está contido no arquivo acsbundle.jar. Para sua comodidade, ele também é fornecido no archive ZIP do produto e fica no mesmo diretório que o arquivo acsbundle.jar onde o archive ZIP é descompactado.

Durante a inicialização, o produto usará apenas o primeiro arquivo AcsConfig.properties que encontrar. Primeiro ele verifica o diretório onde o arquivo acsbundle.jar existe. Se o AcsConfig.properties não for localizado no mesmo diretório que o arquivo acsbundle.jar, ele usará o arquivo AcsConfig.properties dentro do arquivo acsbundle.jar.

Você pode optar por atualizar AcsConfig.properties em acsbundle.jar com um caminho de configuração customizada. Se fizer isso, certifique-se de que o diretório onde existe o acsbundle.jar não contenha nenhum arquivo AcsConfig.properties, ou ele será usado. Isso fornece flexibilidade para poder distribuir o local da configuração com o arquivo acsbundle.jar enquanto também fornece flexibilidade para substituí-lo.

São fornecidas palavras-chave especiais que podem ser usadas durante a definição do caminho de configuração. Quando palavras-chave são usadas no caminho especificado, elas são substituídas pelo texto ou caminho que definem. Apenas uma palavra-chave pode ser usada no caminho de configuração. As palavras-chave especiais e seus significados são:

	{USER} - O id do usuário atual. Esta palavra-chave pode estar em qualquer lugar no caminho

As palavras-chave a seguir podem estar apenas no início do caminho especificado:

	{PRODUCTDIR} - o caminho para o mesmo diretório como acsbundle.jar
	{TEMPDIR}    - o caminho para um diretório temporário específico da plataforma
	{ROOT}       - o caminho para a raiz do sistema de arquivos
	{HOME}       - o caminho para o diretório inicial do usuário
	{DEFAULT}    - o caminho padrão que o produto normalmente usaria

Nota Técnica:
Não recomendamos compartilhar uma configuração entre diversos usuários. Por exemplo, se X era uma unidade de rede compartilhada, a configuração a seguir pode causar resultados imprevisíveis:

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

Há diversos problemas com diversos usuários compartilhando este caminho de configuração:

  1. Ocorrerão resultados imprevisíveis se diversos usuários usarem a configuração simultaneamente.
  2. Este exemplo considera que cada usuário tem a unidade X mapeada para o mesmo local.
  3. Usar uma unidade de rede na configuração não funcionaria a partir de um cliente Linux ou Mac. Usar as palavras-chave fornecidas, como nos exemplos abaixo, funcionará no Windows, Linux e Mac.

Ao compartilhar um caminho de configuração entre diversos usuários, a palavra-chave {USER} deve ser usada para evitar colisões com outros usuários. Ela será substituída pelo ID do usuário do usuário atual.

Ao configurar o caminho de configuração, use uma barra ('/') em vez de uma barra invertida ('\') como o separador de diretório. Isto funcionará em todos os sistemas operacionais, incluindo o Windows.

A seguir estão algumas configurações de amostra recomendadas:

Exemplo 1 – configuração local para o usuário atual (padrão):

    com.ibm.iaccess.AcsBaseDirectory=
Quando AcsBaseDirectory não estiver configurado, a configuração é padronizada para um caminho dependente da plataforma para o usuário. Esta é a configuração padrão para o IBM i Access Client Solutions.

Exemplo 2 – configuração remota (ou local) exclusiva para cada usuário:

    com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/
A configuração será remota ou local com base no local de {ROOT}.

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

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/
A configuração será remota ou local com base no local de {PRODUCTDIR}.

Exemplo 4 – configuração local na mídia portátil (como unidade USB):

    com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory
Como o caminho para a mídia portátil variará dependendo do sistema onde ela está sendo usada, esta configuração permite que a configuração seja relativa para os arquivos do produto. Neste exemplo, a palavra-chave {USER} foi intencionalmente não especificada para que a configuração na unidade USB fosse usada pelo usuário da unidade USB, independentemente do ID do usuário.

9.4 Outras Opções de Implementação

Aqui estão algumas outras opções de implementação que você pode querer considerar:

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

As propriedades a seguir podem ser usadas no arquivo AcsConfig.properties para definir automaticamente uma configuração para novos usuários ou atualizar uma configuração para usuários existentes:

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

Aqui estão as etapas necessárias:

  1. Crie a configuração desejada para propagar para um ou mais usuários.
  2. Exporte a configuração para um arquivo usando Arquivo->Exportar Configuração na GUI principal ou use a opção de linha de comandos na seção 9.1.1 Backup.
  3. Mova o arquivo de configuração para o local desejado. Há várias opções disponíveis descritas posteriormente.
  4. Configure a propriedade com.ibm.iaccess.autoimport no AcsConfig.properties para o caminho do arquivo de configuração.
  5. Configure o com.ibm.iaccess.autoimport.version para um valor de número inteiro que representa a versão do arquivo de configuração.

Aqui está como isto funciona:
A configuração salva referenciada pela propriedade com.ibm.iaccess.autoimport será importada automaticamente quando o valor de número inteiro da propriedade com.ibm.iaccess.autoimport.version é incompatível com o último valor que foi importado. Além de fornecer uma maneira de fazer uma configuração inicial e de fornecer atualizações para uma configuração existente, isso também oferece uma maneira de se ter compatibilidade com versões anteriores de uma configuração. A configuração será atualizada cada vez que houver uma incompatibilidade entre o valor de número inteiro da propriedade da versão e a última versão que foi importada. Porém, embora uma configuração importada possa mudar a configuração de um sistema existente na configuração do usuário, um sistema nunca será excluído da configuração do usuário.

O caminho para a propriedade com.ibm.iaccess.autoimport pode ser especificado como um caminho absoluto, uma URL ou com as palavras-chave definidas na seçã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

Flexibilidade adicional é fornecida, permitindo que o arquivo de configuração seja distribuído dentro de acsbundle.jar ou no mesmo diretório que acsbundle.jar. Em qualquer caso, configure com.ibm.iaccess.autoimport com o nome do arquivo 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 sempre importará a configuração, independentemente de qualquer versão anterior.

9.4.2 Implementações nativas do IBM i

Alguns dos plug-ins da linha de comandos que não requerem uma GUI podem ser usados nativamente no IBM i. Por exemplo, é possível usar a Transferência de dados para extrair dados de seu banco de dados para um tipo de arquivo de planilha diretamente no IBM i sem fazer download dos dados para o PC.

Para fazer isso, é possível extrair o archive zip do produto em qualquer local no Sistema de arquivos integrado (IFS) do IBM i. Por exemplo, se você extraiu o archive zip do produto em:

 /home/AccessClientSolutions 
E tiver uma solicitação de download de Transferência de dados salva anteriormente existente em:
 /some_path/qcustcdt.dtfx 
Será possível executar o comando a seguir no IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /plugin=dtbatch /some_path/qcustcdt.dtfx')                                            

9.5 Pacotes Customizados

O IBM i Access Client Solutions fornece aos administradores do sistema a capacidade de restringir o uso de funções específicas ao configurar a seguinte propriedade no arquivo AcsConfig.properties:

    com.ibm.iaccess.ExcludeComps=<function, function,...>
As palavras-chave da função que podem ser especificadas são:

   Função             Descrição
    cfg             Configurações do Sistema
    sm              Gerenciador de Sessões 5250
    5250            Emulador 5250
    vcp             Painel de Controle Virtual
    console         Console 5250
    consoleprobe    Procurar a rede local para configurações do console
    hmcprobe        Procurar partições em um HMC
    hmi1            Interface de Gerenciamento de Hardware 1
    hmi2            Interface de Gerenciamento de Hardware 2
    keyman          Gerenciamento de certificado SSL/TLS
    dtgui           Interface gráfica com o usuário de Transferência de Dados
    upload          Uploads em lote de Transferência de Dados
    download        Downloads em lote de Transferência de Dados
    cldownload      Downloads em lote de Transferência de Dados
    l1c             IBM Navigator for i (Console do Nível 1)
    rmtcmd          Comando remoto (disponível a partir da linha de comandos)
    splf            Saída de Impressora (arquivos de spool)
    ifs             Sistema de arquivos integrado
    db2             Esquemas
    rss             Executar Scripts SQL
    db2tools        Centro de desempenho SQL
    sysdbg          Depurador de sistema IBM i
    checkupdates    Verificar atualizações disponíveis
    ssh             Shell seguro

Também é possível excluir funções usando palavras-chave de grupo:


   Grupo              Funções
  dataxfer          dtgui,upload,download,cldownload
  emulator          sm,5250
  keyman            keyman
  opconsole         console,vcp,consoleprobe,hmcprobe
  rmtcmd            rmtcmd
  splf              splf
  ifs               ifs    
  hwconsole         hmi1,hmi2
  l1cplugin         l1c
  database          db2,rss,db2tools
  debugger          sysdbg
    
O administrador do sistema pode optar por restringir o acesso a funções específicas, atualizando o arquivo AcsConfig.properties. A restrição de acesso removerá a função da GUI principal e desativará seu uso a partir da linha de comandos.

Um exemplo de como restringir funções seria incluir a seguinte linha no arquivo AcsConfig.properties:

    com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN
Se o administrador do sistema gostaria de atualizar o arquivo AcsConfig.properties dentro do acsbundle.jar antes de implementá-lo em seus usuários, um exemplo de como fazer isso é:
    jar uvf acsbundle.jar AcsConfig.properties
Consulte a seção 9.3 Alterando o Local de Configuração para obter informações adicionais sobre como o IBM i Access Client Solutions determina qual arquivo AcsConfig.properties usar.

9.6 Migrando a partir do IBM i Access for Windows

Os arquivos 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 fornece um caminho de migração para diversos itens importantes, conforme discutido nas seções seguintes.

9.6.1 Migrando Configurações do Sistema

A função Copiar Conexões disponível a partir do menu da GUI principal em Arquivo->Copiar Conexões fornece uma interface para copiar configurações do sistema entre o IBM i Access Client Solutions e a configuração do Windows legada suportada pelo IBM i Access for Windows. Para obter informações adicionais, consulte a ajuda para o painel principal de Copiar Conexões. As configurações do sistema também podem ser migradas usando a linha de comandos. Veja a seção 1.9.2025 MIGRAR para obter informações adicionais.

9.6.2 Migrando a Emulação 5250

Os arquivos de emulação 5250 usado pelo emulador do IBM i Access for Windows Personal Communications pode ser convertido usando o Gerenciador de Sessões 5250 no IBM i Access Client Solutions. Os tipos de arquivos a seguir podem ser convertidos a partir do Personal Communications:

   .ws   - perfil do emulador
   .bch  - arquivo em lote do emulador
   .kmp  - arquivo de customização do teclado
   .pmp  - arquivos de teclado instantâneo
   .bar  - arquivos da barra de menus
Os arquivos serão convertidos para:
   .hod  - perfil do emulador
   .bchx - arquivo em lote do emulador
   .kmp  - arquivo de customização do teclado
   .pmp  - arquivos de teclado instantâneo
   .bar  - arquivos da barra de menus
Os tipos de arquivos .kmp, .pmp e .bar são usados por ambos os produtos. No entanto, os formatos não são compatíveis. Os arquivos convertidos serão criados em um caminho específico do IBM i Access Client Solutions.

A conversão desses arquivos pode ser iniciada a partir do menu Gerenciador de sessões do IBM i Access Client Solutions:

...ou a partir da linha de comandos usando o plug-in PM5250. Veja a seção 9.1.30 PM5250.

Um utilitário de conversão de macro está disponível. A partir do Gerenciador de Sessões:

    Ferramentas->Converter macro...
Nota Técnica:
O utilitário de conversão de macro pode não ser capaz de converter uma macro do PC5250 se a macro for uma macro customizada que contém mais do que apenas os pressionamentos de tecla registrados.

9.6.3 Migrando Arquivo de Solicitação de Transferência de Dados Salvos

A Transferência de Dados no IBM i Access Client Solutions fornece um assistente para converter arquivos de solicitação de Transferência de Dados salvos que foram gerados pelo IBM i Access for Windows.

Os tipos de arquivos a seguir podem ser convertidos a partir do IBM i Access for Windows:

   .dtf - transferência de dados a partir do IBM i
   .dtt - transferência de dados para o IBM i
Os arquivos serão convertidos para:
   .dtfx - transferência de dados a partir do IBM i
   .dttx - transferência de dados para o IBM i
O assistente de migração de Transferência de Dados não migra arquivos .fdf. O novo tipo de arquivo necessário ao IBM i Access Client Solutions é do tipo .fdfx e pode ser gerado durante um download ou usando o Assistente Criar Arquivo.

O assistente de migração de Transferência de Dados está disponível a partir do menu principal de Transferência de Dados ao selecionar Ações-> Migração de Transferência de Dados

9.6.4 EHLLAPI

Para aplicativos 5250 que alavancam aplicativos EHLLAPI ao acessar o emulador do Personal Communications fornecido com o IBM i Access for Windows, consulte o seguinte artigo do KB para obter informações sobre como usar 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 possui suporte para o Kerberos. Para usar o kerberos ao conectar a um sistema:

  1. Traga as Configurações do Sistema a partir da GUI principal
  2. Selecione Novo ou Editar em uma configuração do sistema existente
  3. Na guia Conexão, selecione
    "Usar autenticação do kerberos; não solicitar"
Configurar um ambiente do Kerberos está além do escopo deste documento.

9.7 Gerenciamento de Chaves

O gerenciamento de certificados para conexões do Secure Socket Layer (SSL) está disponível na GUI principal ao selecionar Ferramentas->Gerenciamento de Chaves. Algumas tarefas no Banco de Dados de Chave requerem o passphrase de integridade de keystore.

9.8 Transferência de dados

9.8.1 Suporte de transferência de dados para Planilhas Excel e Calc

Além de suportar downloads para um Arquivo, a Transferência de Dados também suporta downloads para uma planilha ativa para uma planilha Excel da Microsoft ou de Cálculo do OpenOffice. Para fazer o download para uma planilha ativa, o painel da GUI de Transferência de Dados fornece a opção de selecionar um Dispositivo de Saída. Por padrão, o Dispositivo de Saída é Arquivo. Se sua plataforma suportar a interação com a planilha Excel e/ou Calc, opções adicionais para uma Planilha Ativa Excel e uma Planilha Ativa Calc podem ser selecionadas da caixa suspensa Dispositivo de Saída.

Restrições:

9.8.2 Suporte de transferência de dados para truncamento de caractere e estouro numérico

Durante uma solicitação de upload de Transferência de dados, se um caractere ou campo numérico exceder o tamanho definido do campo, a solicitação de upload será finalizada.

Para permitir que os campos de caracteres sejam truncadas do final, configure a propriedade a seguir no arquivo AcsConfig.properties:
    com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true

Para permitir que os campos numéricos sejam configurados com seus valores máximos positivos ou negativos quando o campo numérico fornecido exceder o limite definido, configure a propriedade a seguir no arquivo AcsConfig.properties:
    com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true

Quando essas propriedades estiverem configuradas como true, a solicitação de upload continuará sem fornecer nenhuma indicação de que o truncamento ou o estouro ocorreu. Os campos de caracteres serão truncados no final. Os campos numéricos serão configurados com seus valores máximos de estouro e seus valores mínimos de estouro negativo.

Como alternativa, as propriedades acima podem ser configuradas a partir da linha de comandos como outras propriedades Java, como a seguir:
    -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 os downloads, um nome de folha é gerado com base no nome da biblioteca de origem do IBM i e do arquivo com ">Sheet#" anexado, em que # é substituído pelo número de folha apropriado. Por exemplo:
    qiws.qcustcdt>Sheet1

Para substituir a parte de biblioteca e de arquivo do nome da folha, é possível especificar a propriedade a seguir:
    com.ibm.iaccess.dataxfer.SheetId=your_string
Isso irá gerar:
    your_string>Sheet1

9.9 Estabelecendo uma Conexão do Console para o IBM i

Para executar funções administrativas no IBM i, um console 5250 é necessário. O IBM i Access Client Solutions suporta configurações de console LAN e HMC.

Se você souber o nome do host do Servidor ou o endereço IP do Serviço para seu IBM i ou o nome do host ou endereço IP para seu console HMC, é possível configurar as informações do console no IBM i Access Client Solutions usando as etapas a seguir:

  1. Inicie o IBM i Access Client Solutions em seu PC.
  2. No painel principal, clique em Configurações do Sistema.
  3. Clique no botão Novo para inserir uma nova configuração ou no botão Editar para atualizar uma configuração existente
  4. Selecione a guia Console
  5. Insira as informações apropriadas para seu tipo de console.

Para um IBM i em que a configuração do console não existe ainda (ex. um novo sistema recém-entregue ao seu negócio), um endereço IP para uma conexão de console será designada automaticamente no intervalo de 169.254.62.0 - 169.254.62.63 durante o IPL. Para estes casos, as etapas a seguir ajudarão a estabelecer uma conexão de console usando o IBM i Access Client Solutions:

  1. Desative a conectividade wireless do seu PC. As etapas a seguir requerem a porta Ethernet com fio.
  2. Execute um cabo ethernet entre seu PC e a porta T1 do IBM i.
  3. Inicie o IBM i Access Client Solutions em seu PC.
  4. No painel principal, clique em Configurações do Sistema.
  5. Nas Configurações do Sistema, clique no botão Localizar Console...
  6. A partir do painel Localizador do IBM i, clique no botão Procurar.
  7. Se a sequência IPL no IBM i tiver progredido o suficiente para que o endereço IP automático seja um designado, o endereço IP deverá ser exibido no painel de Procura.
  8. Clique no endereço IP exibido para selecioná-lo, em seguida, clique no botão Console para conectar um console 5250.
  9. Aparecerá um painel solicitando as credenciais de Ferramentas de Serviço.
  10. Ao inserir as credenciais válidas, um console 5250 será exibido.
  11. O console pode ser usado para manipular tarefas iniciais de instalação e configuração.

Quando você está pronto para incluir o sistema IBM i no resto de sua infraestrutura de rede, há informações adicionais no IBM InfoCenter para como configurar o Adaptador LAN das Ferramentas do Serviço:

http://pic.dhe.ibm.com/infocenter/iseries/v7r1m0/topic/rzamh/rzamhsrvtoolsrvr4dstdst.htm
Veja a seção "Configurando o servidor de ferramentas de serviço para DST"

Para sistemas IBM i que já têm uma configuração de console LAN e já estão em sua infraestrutura de rede, as etapas a seguir poderão ser usadas para localizar configurações de console existentes:

  1. Inicie o IBM i Access Client Solutions em seu PC.
  2. No painel principal, clique em Configurações do Sistema.
  3. Nas Configurações do Sistema, clique no botão Localizar Console...
  4. No painel do Localizador do IBM i, atualize o campo Próximo para um endereço IP no intervalo que você deseja procurar.
  5. Clique no botão Procurar para localizar consoles LAN no intervalo especificado.
  6. Clique no endereço IP exibido para selecioná-lo, em seguida, clique no botão Console para conectar um console 5250.
  7. Aparecerá um painel solicitando as credenciais de Ferramentas de Serviço.
  8. Ao inserir as credenciais válidas, um console 5250 será exibido.

9.10 Fontes Adicionais

Fontes adicionais para a emulação 5250 podem ser incluídas no diretório Fontes.

Para fornecer alternativas e/ou vários locais para fontes adicionais, configure a propriedade com.ibm.iaccess.Fonts localizada no arquivo AcsConfig.properties.

O diretório Fontes padrão pode ser substituído ao configurar a propriedade com.ibm.iaccess.Fonts para um:

  1. <path> que é um diretório que contém fontes
  2. <path>/<filename> de um arquivo de fonte específico (por exemplo, .ttf)
  3. URL para um arquivo de fonte
  4. uma lista delimitada por ponto e vírgula qualquer um dos itens acima

Nota:
O <path> pode ser um caminho absoluto ou um caminho relativo a partir do local de acsbundle.jar. Apenas fontes monoespaçadas serão reconhecidas pela emulação 5250.

Exemplo 1 (padrão):

     com.ibm.iaccess.Fonts=Fonts	
Exemplo 2:
     com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts

9.11 Usando credenciais de um arquivo netrc

Para permitir o uso de um arquivo .netrc (Linux e Mac) ou de um arquivo _netrc (Windows), acesse a GUI principal do IBM i Access Client Solutions e, na barra de menus, selecione
    Editar->Preferências
    Guia Geral
    Marque a caixa: Ler o arquivo netrc para obter informações de login
    Clique no botão Aplicar
    Reinicie o IBM i Access Client Solutions

O formato padrão de um arquivo netrc é:

     machine <system> login <user-id> password <password>

O arquivo netrc deve ser armazenado no diretório inicial do usuário e o nome do sistema e o ID do usuário devem corresponder a Configurações do sistema. No IBM i Access Client Solutions:
    Selecione Configurações do sistema
    Selecione e, em seguida, Edite o sistema
    Guia Conexões
    Selecione Usar nome de usuário padrão para solicitar uma vez para cada sistema
    Preencha o ID de usuário para: Nome do usuário padrão
    Selecione OK

Quando o nome do sistema e Nome do usuário padrão corresponderem ao conteúdo do arquivo netrc, uma conexão com o sistema será feita usando a senha do arquivo netrc sem solicitar o usuário.

9.12 Sistema de arquivos integrado (IFS)

9.12.1 IFS, QFileSvr.400 e segurança

O Suporte de sistema de arquivos integrado usa o sistema de arquivos QFileSvr.400 para copiar ou enviar objetos de uma partição do IBM i para outra. Isso significa que o perfil do usuário e a senha em ambas as partições devem corresponder e as partições devem ter o mesmo valor do sistema de nível de senha (QPWDLVL). Se estiver usando a autenticação Kerberos, ambas as partições deverão ter o Serviço de autenticação de rede e o Enterprise Identity Mapping (EIM) configurados. Para obter mais detalhes, veja o tópico "Autoridade de segurança e de objeto no sistema de arquivos QFileSvr.400" no Knowledge center do IBM i.

As conexões com outras partições do IBM i feitas pelo sistema de arquivos QFileSvr.400 não são seguras. Se uma conexão segura for necessária ao copiar ou enviar objetos de uma partição do IBM i para outra, a configuração para a partição deverá ser configurada para usar SSL, Configurações do sistema deverá ter a opção "Usar SSL para conexão" selecionada para essa partição e a propriedade a seguir deverá ser configurada no arquivo AcsConfig.properties:
    com.ibm.iaccess.ifs.transferMechanism=ACS
Como alternativa, a propriedade pode ser configurada a partir da linha de comandos como outras propriedades Java, como a seguir:
    -Dcom.ibm.iaccess.ifs.transferMechanism=ACS

9.12.2 Autoridade do IFS

O suporte de Sistema de arquivos integrado requer autoridade para usar os comandos CL a seguir:

    CPY
    CPYFRMSTMF
    CPYTOSTMF
    CRTDIR
    CRTLIB
    CRTSAVF
    RMVDIR
    RST
    SAV
    SETASPGRP
 

Se o usuário não puder usar esses comandos CL, as ações Copiar, Colar, Enviar, Excluir e Nova Pasta falharão.

9.12.3 Limitações do IFS

O suporte de Sistema de arquivos integrado não permite ações para objetos que possuem caminhos iniciados com /QFileSvr.400, /QNTC ou /QOPT. Se o caminho do diretório atual ou qualquer caminho de objeto selecionado iniciar com /QFileSvr.400, /QNTC ou /QOPT, todos os itens no menu Ações serão desativados e um menu de contexto não será exibido.

9.12.4 IFS e ASPs independentes

O suporte de Sistema de arquivos integrado não permite a ação Copiar, Colar ou Enviar quando o objeto de origem ou o caminho de destino está localizado em um ASP independente.

9.13 Terminal de shell seguro (SSH)

Para plataformas em que um shell seguro existe por padrão ou foi instalado, o recurso Terminal SSH aparecerá na GUI principal do IBM i Access Client Solutions. O Terminal SSH lançará um emulador de terminal para o sistema de arquivos integrado do IBM i.

A maioria dos sistemas Mac, Linux e outros sistemas derivados do UNIX já tem um shell seguro por padrão. Para essas plataformas, assume-se que o cliente OpenSSH existe e está localizado em /usr/bin/ssh. Os usuários do Windows precisarão instalar um dos shells seguros disponíveis para Windows.

Shells seguros suportados pelo IBM i Access Client Solutions:

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

Se houver vários aplicativos SSH instalados, será possível usar a propriedade com.ibm.iaccess.PreferredSSHClient para configurar o cliente SSH preferencial.

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

Mac examples:
         com.ibm.iaccess.PreferredSSHClient=iTerm2

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

Para casos em que o cliente SSH não está instalado no local padrão, será possível usar a propriedade com.ibm.iaccess.PreferredSSHClient para fornecer o caminho completo para o cliente SSH instalado.

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

Quando o caminho completo é fornecido, também poderá ser necessário definir a propriedade com.ibm.iaccess.SSHClientOpt para fornecer todos os argumentos necessários. Por exemplo, para desativar avisos se você não usar o encaminhamento X11:

         com.ibm.iaccess.SSHClientOpts=-x

9.13.1 Pré-requisitos de terminal SSH

Instale o 5733-SC1 IBM Portable Utilities for i no IBM i.
Inicie o Daemon de shell seguro usando o comando:
         STRTCPSVR *SSHD

Se você receber um erro de conexão no cliente SSH ativado (por exemplo, "conexão recusada") ou se perceber que uma janela aparece e, imediatamente, desaparece, poderá ser necessário iniciar o daemon SSH com o comando acima.


10.0 Diagnósticos de Serviço

Se você encontrar um problema que exija assistência da IBM, seu representante de serviço IBM poderá orientá-lo a executar uma ou ambas as ações a seguir:

Na GUI principal do IBM i Access Client Solutions:


11.0 Perguntas Mais Frequentes (FAQ)

P1    Quando eu tento iniciar o IBM i Access Client Solutions, obtenho o erro
      erro a seguir:
             a classe não pode ser carregada: java.lang.UnsupportedClassVersionError
R1-1  É necessário usar o JDK 6.0 ou superior.  Veja a seção 3.0 Pré-requisitos

P2    Quando tento iniciar o produto usando um dos arquivos binários fornecidos ou
      scripts de um shell ou sessão do terminal, obtenho o erro a seguir:
         Permissão negada
R2-1  Verifique as permissões do arquivo do arquivo para certificar-se de ter a permissão
      de execução. Veja a seção 6.0 Permissões de Arquivo.

P3    Quando dou um clique duplo em um dos arquivos fornecidos para iniciar o produto,
      nada acontece.
R3-1  O Java pode não estar instalado. Veja a seção 3.0 Pré-requisitos
R3-2  O arquivo que você está usando para iniciar o produto pode não ter a permissão
      de execução. Veja a seção 6.0 Permissões de Arquivo.
R3-3  Pode haver problemas com seu ambiente. Para ver quais erros podem estar
      ocorrendo, tente executar o arquivo fornecido a partir de uma linha de comandos.
      Veja a seção 7.3 Iniciando o Produto (usando a linha de comandos).

P4    Eu gostaria de usar um dos arquivos binários para iniciar o produto, mas recebo
      o seguinte erro: "Erro ao carregar o módulo Java."
R4-1  O binário não conseguiu localizar o diretório inicial da instalação Java.
      Verifique se o java está instalado. Veja a seção 3.0 Pré-requisitos.
A4-2  A seção 7.1.1 Iniciando o Produto - Opções Adicionais
      contém métodos adicionais para iniciar o produto usando um arquivo binário.

P5    Depois que configuro a variável de ambiente JAVA_HOME, o arquivo binário que uso para
      iniciar o produto funciona a partir de uma linha de comandos, mas não funciona quando
      dou um clique duplo no arquivo.
A5-1  A variável de ambiente JAVA_HOME pode não estar visível a partir do gerenciador de arquivos
      que você está usando ao clicar duas vezes no arquivo. Configurar as variáveis
      de ambiente varia entre os sistemas operacionais, assim como sua visibilidade.
      Tente configurar a variável de ambiente JAVA_HOME como uma variável de ambiente
      do sistema para seu sistema operacional. Seu sistema operacional pode fazer referência
      às variáveis de ambiente do sistema como variáveis de ambiente globais.
      Depois de configurar a variável de ambiente JAVA_HOME, feche e abra novamente o
      gerenciador de arquivos e tente dar um clique duplo no arquivo binário novamente.

Q6    Quando dou um clique duplo em um dos arquivos fornecidos para iniciar o produto, um
      editor de texto exibe o arquivo.
R6-1  Certifique-se de estar usando um script que tenha uma extensão de arquivo que
      seu sistema operacional reconheça.
R6-2  Tente um dos outros scripts.
R6-3  Altere o programa que abre o arquivo.
R6-4  Verifique as permissões do arquivo para certificar de ter a permissão
      a permissão.   Veja a seção 6.0 Permissões do Arquivo.

P7    Quando dou um clique duplo em um dos arquivos fornecidos para iniciar o produto,
      é solicitado que eu informe qual programa deve ser usado para abrir o arquivo.
R7-1  Certifique-se de estar usando um script que tenha uma extensão de arquivo que
      seu sistema operacional reconheça.
R7-2  Configure o programa que abre o arquivo para algo compatível com o arquivo binário
      ou script que você está usando. Por exemplo, Terminal (no Mac).
R7-3  Verifique as permissões do arquivo do arquivo para certificar-se de executar
      a permissão.   Veja a seção 6.0 Permissões do Arquivo.

P8    Quando inicio o IBM i Access Client Solutions em um Mac a partir do Localizador, uma
      sessão de terminal aparece como pop-up e não desaparece mesmo após o encerramento do
      IBM i Access Client Solutions.
A8-1  Para eliminar a ação de pop-up da sessão de terminal, use os scripts de instalação
      para Mac no QuickStartGuide.

P9    Qual é a melhor maneira de iniciar o produto?
R9-1  Pode ser necessário iniciar o produto com qualquer um dos três métodos na seção
      7.0 Iniciando o Produto usando binários, scripts ou a
      linha de comandos. Qualquer método que funcione em seu ambiente é aceitável.

Q10   Por que há arquivos binários (Start_Programs) e scripts
      (Sample_Scripts) para iniciar o produto?
A10-1 Os scripts não são específicos do sistema operacional e fornecem uma maneira
      mais genérica de iniciar o produto quando o arquivo binário específico da plataforma não funciona.
R10-2 Alguns sistemas operacionais requerem binários ao definir associações de arquivos.
      Para a maioria dos casos, os arquivos binários devem ser usados para iniciar o produto.
R10-3 Alguns ambientes podem ter firewalls que restringem acesso a partes do
      IBM i Access Client Solutions. Usar um dos arquivos binários para iniciar o
      produto facilitará para os administradores de sistema autorizarem o acesso.

P11   Após instalar o JDK 6.0 (ou superior), ainda estou obtendo o
      erro a seguir:
      a classe não pode ser carregada: java.lang.UnsupportedClassVersionError
R11-1 A versão padrão do java sendo usado em sua estação de trabalho é anterior ao
      JDK 6.0. Será necessário usar uma opção que especifica explicitamente o
      caminho para o início Java para JDK 6. Veja a seção 7.1.2 Localizando o
      Caminho Inicial Java. Use o caminho inicial Java para um dos métodos descritos em
      uma das seções a seguir:
      7.1.1 Iniciando o Produto - Opções Adicionais
7.3 Iniciando o Produto (usando a linha de comandos)
P12 Não consigo importar arquivos de mapeamento do teclado customizados (.kmp) das minhas sessões de emulador do Windows 5250. R12-1 Na versão inicial do IBM i Access Client Solutions que se tornou disponível em julho de 2012, a importação de arquivo .kmp a partir de perfis de sessão do emulador 5250 Windows (.ws) não era suportada. A partir da versão que se tornou disponível em outubro de 2012, a importação de arquivo .kmp dos perfis de sessão 5250 (.ws) agora é suportada. P13 A customização do teclado para o emulador 5250 é bastante diferente do que era no Windows. Você tem alguma sugestão? R13-1 O mapeamento de teclado é dividido em categorias. A partir de uma sessão do emulador: Clique em Editar > Preferência > Teclado ou clique no botão Remapear na barra de ferramentas. Clique na guia Designações de Teclas. Selecione uma Categoria. Os mapeamentos de chave padrão aparecerão sob as categorias "Funções do Host" e os "Comandos de Menu". Selecione a função que deseja designar. Clique em Designar uma Tecla. No teclado, pressione a tecla (ou combinação de teclas) que deseja designar a esta função. R13-2 Para obter ajuda sobre mapeamentos de chave customizados: Clique em Editar > Preferência > Teclado ou clique no botão Remapear na barra de ferramentas. Selecione o botão Ajuda. P14 Quando tento iniciar o produto no Mac OS X 10.8 Mountain Lion, recebo uma mensagem pop-up indicando que o aplicativo não é assinado. R14-1 Esta é uma política de segurança imposta pelo padrão, iniciando com o Mac OS X 10.8 Mountain Lion. Veja a página da web a seguir para saber como ativar o aplicativo para execução: http://macperformanceguide.com/MountainLion-application-signing.html P15 Sou um usuário do IBM i Access for Windows, posso migrar minhas configurações do sistema para o IBM i Access Client Solutions? R15-1 Veja a seção 9.6.1 Migrando Configurações do Sistema. P16 Sou um usuário do IBM i Access for Windows, posso migrar meus perfis de emulação para o IBM i Access Client Solutions? R16-1 Veja a seção 9.6.2 Migrando a Emulação 5250 P17 Sou um usuário do IBM i Access for Windows, posso migrar meus arquivos de solicitação de Transferência de Dados para o IBM i Access Client Solutions? R17-1 Veja a seção 9.6.3 Migrando Arquivos de Solicitação de Transferência de Dados Salvas. P18 O EHLLAPI funciona com o IBM i Access Client Solutions? R18-1 Veja a seção 9.6.4 EHLLAPI P19 O kerberos funciona com o IBM i Access Client Solutions? R19-1 Veja a seção 9.6.5 Kerberos P20 Sou um administrador do sistema e quero ocultar algumas funções de meus usuários. R20-1 Veja a seção 9.5 Pacotes Customizados P21 Quando seleciono um ícone de ajuda em um painel, nenhum texto é exibido. R21-1 O texto de ajuda normalmente é exibido no navegador do desktop. Em alguns casos, o desktop pode não ter um navegador ou pode não ter sido configurado corretamente. R21-2 Para exibir o texto de ajuda sem usar o navegador do desktop, configure a propriedade a seguir no arquivo AcsConfig.properties: com.ibm.iaccess.javaAwtDesktopAllowed=false Alternativamente, a propriedade pode ser configurada a partir da linha de comandos como outras propriedades java, conforme a seguir: -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false P22 Ao usar a Transferência de Dados, seleciono um dispositivo de Saída da "Planilha Excel Ativa" ou da "Planilha de Cálculo Ativa" e obtenho o erro a seguir: "A Planilha Ativa não foi localizada" P22-1 Não há nenhuma planilha ativa. Abra uma planilha nova ou existente e tente a solicitação novamente. P22-2 Pode haver uma incompatibilidade de bit entre o aplicativo de planilha que você está usando e a Java Virtual Machine executando o IBM i Access Client Solutions. Veja a seção 9.8 Suporte de Transferência de Dados para Planilhas Excel e Calc P23 Ao usar a Transferência de Dados em um Mac, não vejo quaisquer opções no Dispositivo de saída para interagir com uma planilha ativa. Q23-1 A Transferência de Dados não é capaz de interagir com planilhas ativas em Mac devido à incompatibilidade de bit entre o aplicativo OpenOffice e a JVM executando o IBM i Access Client Solutions. Para obter detalhes adicionais, veja a seção 9.8 Suporte de Transferência de Dados para Planilhas Excel e Calc. Q24 Ao usar a Transferência de Dados, seleciono um Dispositivo de saída de "Planilha Ativa Calc" e nada aparece na caixa Nome. P24-1 Isso é normal para novas planilhas Calc que nunca foram salvas. DataTransfer ainda poderá atualizar a planilha com dados transferidos por download.

12.0 Histórico de Atualizações

Veja a página da web a seguir:
http://www-03.ibm.com/systems/power/software/i/access/solutions.html