O QuickStartGuide contém instruções para implementação do produto e que funcionam para a maioria dos usuários que executam 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.
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 do IBM i Access Family e requer a mesma licença do IBM i Access Family (5770XW1) para usar os recursos de emulação 5250 e 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
Os clientes que usam o IBM i 7.2 ou mais recente e que possuem autorização atual podem adquirir o IBM i Access Client Solutions usando um dos dois métodos a seguir:
Os pacotes de aplicativos opcionais do Windows e do Linux estão disponíveis no website do 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 arquivo .zip do produto, que pode ser copiado e extraído para um local de sua escolha. 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:
Soluções IBM i Access Client
Para obter as informações mais recentes sobre os produtos da Família IBM i Access, visite:
Família IBM i Access
Recursos do IBM i Access Client Solutions incluem:
O Pacote de Aplicativo Windows opcional inclui:
O Pacote de Aplicativos Linux opcional inclui:
O IBM i Access Client Solutions pode ser executado na maioria dos sistemas operacionais que suportam o Java 8.0 ou superior, incluindo várias versões do Linux, Mac e Windows.
Observação: o ACS pode não conseguir localizar o Java 8 no macOS 11.0 Big Sur. Recomendamos a instalação do Java 11.
Recomendação:
Ao manter atualizada sua versão do Java é possível assegurar o acesso a todas as 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_191"
Neste exemplo, 191 refere-se ao nível de atualização.
Estes são alguns websites de provedores Java. Certifique-se de que você esteja executando com a
versão mais atualizada de Java para sua plataforma.
https://adoptopenjdk.net/
https://aws.amazon.com/corretto/
http://openjdk.java.net/install
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Nota técnica para Mac:
Ao instalar o Java no Mac, selecione um JDK ao invés de um JRE. O JRE para Mac instala o Java apenas para o navegador.
Ele não instala o Java para outros aplicativos. A instalação do JDK disponibiliza o Java para outros aplicativos, como o IBM i Access Client Solutions.
O IBM i Access Client Solutions se conecta a qualquer liberação suportada do IBM i.
O IBM i Access Client Solutions usa os mesmos servidores host IBM i que os outros produtos do IBM i Access Family e requer a mesma licença do IBM i Access Family (5770XW1) para usar os recursos de emulação 5250 e de Transferência de dados.
Caso utilize conexões SSL, carregue e aplique as seguintes PTFs do IBM i para sua liberação:
7.2 - SI55392, SI57320, MF60333, MF60334
Caso utilize o Navigator for i, carregue e aplique as seguintes PTFs do IBM i para sua liberação:
7.2 - PTF de grupo de nível SF99713 30 ou superior
7.3 - PTF de grupo de nível SF99722 17 ou superior
Os arquivos e diretórios a seguir estão contidos no arquivo .zip:
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
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 implementar isso em vários usuários, leia os seguintes artigos:
IBM i Access Client Solutions: customização e implementação fáceis
IBM i Access Client Solutions: respostas para as perguntas sobre customização e implementação
Estes artigos explicam como um administrador pode pré-customizar a instalação de vários usuários antes da implementação, 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, também é possível optar por simplesmente descompactar o arquivo .zip em qualquer local 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 arquivo .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.
Periodicamente, são disponibilizados aprimoramentos e correções. 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 usuários que mantêm sua própria instalação:
Opção 1:
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 alterar a configuração existente.
Opção 2:
Caso tenha optado por instalar o produto sem usar os scripts de instalação, extraindo o conteúdo do arquivo .zip em algum local de sua escolha, 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 que talvez seja necessário salvar e restaurar o conteúdo de AcsConfig.properties, caso tenha feito mudanças customizadas nesse local.
Para administradores que mantêm uma versão do produto em um local central acessado por vários usuários:
Extraia o conteúdo da versão mais recente sobre a versão existente.
Caso tenha feito mudanças customizadas no arquivo AcsConfig.properties, você deve salvar AcsConfig.properties antes de extrair o conteúdo da nova versão do produto sobre uma versão existente. Após a extração do conteúdo da nova versão do produto e da restauração de AcsConfig.properties, os usuários precisarão executar uma das seguintes opções:
Opção 1:
Caso os usuários estejam executando diretamente a partir do local remoto, não será necessária nenhuma ação adicional. Basta solicitar que reiniciem o produto, para que as novas atualizações entrem em vigor.
Opção 2:
Executar o script de instalação como foi executado inicialmente, para atualizar a instalação local.
Opção 3:
Caso tenha sido configurado um Local de atualização do IBM i, seção 5.2, solicite aos usuários que selecione Ajuda -> Verificar atualizações a partir da GUI principal.
Deve ser exibido um painel informando que há uma atualização disponível. Solicite que selecionem Instalar atualização. Essa opção também pode ser executada a partir da linha de comandos, usando o plug-in INSTALLUPDATES.
Depois de executar as etapas corretas acima, reinicie o produto. É possível usar a opção Ajuda -> Sobre da GUI principal para verificar se as atualizações foram aplicadas.
Os administradores podem usar um sistema IBM i como o local central para a execução de instalações e a aplicação de atualizações. Independentemente de como o produto for implementado inicialmente para os usuários, é possível usar um local central em um sistema IBM i para que os usuários possam aplicar atualizações pressionando apenas um botão. Aqui estão as etapas:
com.ibm.iaccess.CheckUpdateSystem=system_name (veja a Nota 1 abaixo) com.ibm.iaccess.CheckUpdatePath=/path_where_zip_was_extracted (veja a Nota 2 abaixo)
A configuração da propriedade com.ibm.iaccess.CheckUpdateSystem altera o comportamento da opção Ajuda -> Verificar atualizações. Em vez de procurar uma versão atualizada disponível em algum local externo da web, a busca por arquivos de produtos atualizados será feita no local do IBM i definido acima. As atualizações serão detectadas quando houver mudança no registro de data e hora de qualquer arquivo de produto necessário. O registro de data e hora será exibido na área de janela Ajuda -> Verificar atualizações, com uma opção para a instalação da atualização.
O usuário precisará de credenciais válidas para o sistema especificado para com.ibm.iaccess.CheckUpdateSystem. Caso as credenciais ainda não tenham sido armazenadas em cache, a partir de uma conexão anterior feita com este sistema, o usuário será solicitado a fornecer credenciais válidas. Caso não sejam fornecidas credenciais válidas, as atualizações não serão detectadas.
Os usuários que possuem um Local de atualização do IBM i configurado e selecionaram a opção "Notificar quando houver atualizações disponíveis" em Editar -> Preferências, não serão solicitados a fornecer credenciais. Um usuário só será notificado sobre uma atualização disponível caso tenha estabelecido uma conexão bem-sucedida com com.ibm.iaccess.CheckUpdateSystem desde seu último login no PC.
Nota:
Nota especial para administradores que mantêm um arquivo AcsConfig.properties customizado em acsbundle.jar:
Este recurso faz download do arquivo acsbundle.jar que existe no IBM i no local especificado. Não é feito nenhum processamento especial para manter uma versão customizada do arquivo AcsConfig.properties durante uma atualização. Se, anteriormente, você tiver customizado o arquivo AcsConfig.properties dentro de acsbundle.jar, precisará verificar se a nova versão de acsbundle.jar contém as customizações desejadas antes de disponibilizá-lo para download.
Para Administradores que desejam manter um local centralizado em um sistema IBM i para que seus usuários instalem e atualizem o produto, há PTFs específicos para as liberações e que fornecem o conteúdo extraído de IBMiAccess_v1r1.zip em:
/QIBM/ProdData/Access/ACS/Base
As PTFs para 1.1.8.7 são:
V7R4M0 SI76178 V7R3M0 SI76179 V7R2M0 SI76180Essas PTFs são substituídas a cada atualização do produto e, normalmente, ficam disponíveis dentro de duas semanas após a disponibilização da atualização do produto.
A Seção 7.0 Iniciando o Produto descreve diferentes maneiras de iniciar o IBM i Access Client Solutions. Caso utilize um dos arquivos binários ou scripts fornecidos para iniciar o produto, é 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 arquivo .zip são determinadas por vários fatores, incluindo o sistema operacional, o utilitário de archive usado para descompactar o arquivo .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.
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>
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.
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.
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 o Java pode ser instalado de diversas maneiras e em vários locais, alguns dos métodos podem exigir configurações adicionais. Se um dos métodos abaixo não funcionar, tente um método diferente. Em alguns casos, uma orientação adicional é fornecida.
Ao usar um arquivo binário ou script, conforme descrito abaixo, é necessário que o arquivo binário ou script esteja na mesma estrutura de diretório contida no arquivo .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.
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."
As soluções do IBM i Access Client não puderam encontrar uma instalação Java em um local reconhecido. 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)
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:
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)
então é possível determinar o caminho inicial Java na 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.
Nas plataformas Windows, procure java.exe. Normalmente, o binário Java está localizado em um subdiretório bin ou jre/bin 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.
No Linux, é possível usar o comando "which":
which javaIsso 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>Normalmente, o binário Java está localizado em um subdiretório bin ou jre/bin 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.
Há um diretório Sample_Scripts no diretório de 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.
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.jarem que <path> é o local do arquivo jar executável do produto
java -Xmx1024m -jar V:/some_location/acsbundle.jarou
<java_path>java -jar V:/some_location/acsbundle.jarem que <java_path> é o local do comando Java para o JDK 8.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 com um tamanho máximo considerado muito pequeno para usar as diversas funções contidas 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.
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.
Para configurar um sistema para fazer uma conexão TLS/SSL, consulte Configurando conexões seguras.
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. É possível digitar até seis 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. Caso você selecione uma tarefa do Console cujas informações correspondentes não estejam inseridas na guia de configuração do Console, uma mensagem de erro será exibida.
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
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:
/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.
/PLUGIN=restore /file=<filename> <filename> é o local do arquivo criado pelo BackupIsso irá restaurar uma configuração salva do arquivo especificado. Qualquer configuração existente que não esteja contida 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.
Nota:
Para evitar a importação do nome de usuário padrão especificado na guia Conexão de uma Configuração do sistema, coloque a propriedade a seguir no arquivo AcsConfig.properties.
com.ibm.iaccess.ResetDefaultUserOnImport=true
/PLUGIN=certdl /SYSTEM=<system>Faz o download de uma autoridade de certificação (CA) do sistema IBM i especificado e a armazena no armazenamento confiável local do usuário. Isso é requerido para autenticação de servidor com SSL.
/PLUGIN=cfg /GUI /GUI - esta opção iniciará a GUI de Configurações do sistema Isso equivale a ativar as Configurações do sistema a partir da GUI principal. Nota: a configuração de com.ibm.iaccess.CfgActionsRestricted=true em AcsConfig.properties ocultará os botões Novo/Editar/Copiar/Excluir no painel Configurações do sistema. /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 existenteIsso 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.
/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 oferecer suporte para a resolução de problemas.
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
/PLUGIN=medicEmpacota os logs e dumps de encadeamento existentes em um arquivo .zip que pode ser enviado para a IBM para atendimento.
O arquivo .zip resultante pode ser acessado a partir da GUI principal, em:
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.
/PLUGIN=log /LEVEL=<Level> <Level> é um dos seguintes: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINESTEste plug-in permite que o usuário alterne seu nível de criação 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
/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árioEste comando armazenará em cache o ID do usuário e a senha, o que pode ser usado para evitar a solicitação da senha.
/PLUGIN=propsApresenta o mesmo painel da GUI como Editar->Preferência a partir da GUI principal.
/PLUGIN=maint [/<options>] As opções válidas são: /killdaemon - termina encadeamentos do daemon. Equivale a Ferramentas->Reconfigurar para Manutenção a partir da GUI principal. A configuração de com.ibm.iaccess.ResetForMaintenanceOnExit=true em AcsConfig.properties chamará/finalizará o daemon quando o Access Client Solutions for encerrado. /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 atualCaso não sejam especificadas opções, nenhuma ação será executada.
/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 adequada. Se estiver verificando uma conexão SSL, um handshake SSL será tentado. Caso seja ativado a partir da GUI principal ou chamado com /GUI=1, este plug-in exibirá uma caixa de diálogo. Se ativado a partir da linha de comandos sem /GUI=1, a saída será enviada para o console.
Para diferentes do SSL, os seguintes serviços e portas são verificados:
sshd 22 telnet 23 drda 446 as-svrmap 449 as-nav 2004 as-central 8470 as-database 8471 as-dtaq 8472 as-file 8473 as-netprt 8474 as-rmtcmd 8475 as-signon 8476
Para SSL, os seguintes serviços e portas são verificados:
sshd 22 telnet-ssl 992 ddm-ssl 448 as-svrmap 449 as-nav 2005 as-central-s 9470 as-database-s 9471 as-dtaq-s 9472 as-file-s 9473 as-netprt-s 9474 as-rmtcmd-s 9475 as-signon-s 9476
Esta função pode ser ativada a partir da GUI principal por:
Configurações do Sistema
selecione um sistema e, em seguida, Editar
Guia Geral
Verificar Conexão
/PLUGIN=smEste plug-in inicia a GUI do Gerenciador de sessões 5250.
Este é equivalente ao Gerenciador de Sessões 5250 da GUI principal.
/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
/PLUGIN=dtgui Este plug-in inicia a GUI principal para a Transferência de dados. Esta função é equivalente à Transferência de Dados da GUI principal.
/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.O plug-in permite que o usuário execute um download de Transferência de dados que foi salvo anteriormente.
A Transferência de Dados também está disponível a partir da GUI principal selecionando Transferência de Dados.
/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 que foi salvo anteriormente.
A Transferência de Dados também está disponível a partir da GUI principal selecionando Transferência de Dados.
/PLUGIN=cldownload /system=<system> [/userid=<userid>] {/hostfile=<library/filename> | /sql="statement"} {/clientfile=<path><filename>.<extension> | /display} [/<options>] /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 As opções válidas são: /colheadings=<1/0> - incluir títulos de coluna como a primeira linha. Quando especificado, os nomes das colunas serão o título. /usecollabels usar rótulos de colunas para o título.O plug-in permite que o usuário execute um download simples de um arquivo inteiro a partir da linha de comandos.
/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.
/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.
/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.
/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.
/PLUGIN=keymanEste plug-in exibe a ferramenta de Gerenciamento de chaves.
Esta função é equivalente a Ferramentas->Gerenciamento de Chaves a partir da GUI.
/PLUGIN=rmtcmd /SYSTEM=<system> {/CMD="<CL command>" | file=<file_name>} [/noprompt=<1|0>] [/immed=<0|1>] /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. /immed=<0|1> - enviar cada comando conforme é lido.Este plug-in envia comando(s) CL para o sistema especificado.
Esta função está disponível apenas a partir da linha de comandos.
/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
/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 anterior 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 a cópia bidirecional de configurações do sistema entre o IBM i Access Client Solutions e a configuração anterior do Windows 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
/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 permite que qualquer pessoa com autoridade de administrador ou raiz restrinja determinadas funções de todos os usuários na estação de trabalho atual.
Função Descrição 5250 Emulador 5250 cfg Configurações do Sistema checkupdates Verificar atualizações disponíveis cldownload Downloads da linha de comandos de Transferência de dados console Console 5250 consoleprobe Procurar a rede local para configurações do console db2 Esquemas db2tools Centro de desempenho SQL download Downloads da linha de comandos de Transferência de dados dtgui Interface gráfica com o usuário de Transferência de Dados hmcprobe Procurar partições em um HMC ifs Sistema de arquivos integrado installupdates Instalar atualizações a partir de um local configurado do IBM i keyman Gerenciamento de certificado SSL/TLS l1c IBM Navigator for i (Console do Nível 1) osssetup Gerenciamento de pacote de software livre restrictview Restringir a visualização de funções atualmente restritas rmtcmd Comando remoto (disponível a partir da linha de comandos) rss Executar Scripts SQL sm Gerenciador de Sessões 5250 splf Saída de Impressora (arquivos de spool) ssh Shell seguro sysdbg Depurador de sistema IBM i upload Uploads da linha de comandos de Transferência de dados vcp Painel de Controle Virtual Interfaces de gerenciamento de hardware: hmi1 Interface de Gerenciamento de Hardware 1 hmi2 Interface de Gerenciamento de Hardware 2 asmi Advanced System Management Interface (ASMI) csmi Copy Services Manager for i dcm Digital Certificate Manager dshmc DS HMC hmc Hardware Management Console (HMC) httpadmin Web (HTTP) Administration for i ivm Integrated Virtualization Manager specctrl Spectrum Control tapemgmt1 Gerenciamento de fita 1 tapemgmt2 Gerenciamento de fita 2 are Administration Runtime Expert db2webquery Db2 Web Query
As funções também podem ser excluídas como um grupo, usando palavras-chave:
Grupo Funções dataxfer dtgui,upload,download,cldownload emulator sm,5250 keyman keyman opconsole console,vcp,consoleprobe,hmcprobe rmtcmd rmtcmd splf splf ifs ifs hwconsole hmi1,hmi2,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery l1cplugin l1c database db2,rss,db2tools debugger sysdbgA 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.
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.
/PLUGIN=restrictviewLista as funções que estão atualmente restritas nesta estação de trabalho.
/PLUGIN=fileassoc [<filetype> <filetype> ...] [/c] <filetype> - os tipos de arquivo válidos são: dttx, dtfx, hod, bchx, ws, bch, sql /c - limpar a associação do arquivo para os tipos de arquivos especificadosEm uma plataforma Windows, isto configura as associações para arquivos do tipo type .dttx, .dtfx, .hod, .bchx, .ws, .bch e .sql. Em uma plataforma não Windows, será exibida uma mensagem de erro.
Esta função é equivalente a Ferramentas->Associações de Arquivo a partir da GUI principal.
/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 salva anteriormente.
A Transferência de Dados também está disponível a partir da GUI principal selecionando Transferência de Dados.
/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.
/PLUGIN=rss /SYSTEM=<system> /DATABASE=<database> [/FILE=<file>] [/SQL=<file>] [/AUTORUN=<0,1>] /FILE=<filename> - Abra o arquivo especificado /SQL=<sql> - Iniciar com o SQL especificado /AUTORUN=<1,0> - Execute automaticamente o scriptO plug-in permite que o usuário execute instruções SQL e comandos CL.
/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 SQL Performance Center fornece um conjunto de ferramentas que ajudam a otimizar o SQL nos aplicativos de banco de dados:
/PLUGIN=ifs /SYSTEM=<system>O Sistema de arquivos integrado fornece uma interface que permite navegar no Sistema de arquivos integrado do IBM i e trabalhar com objetos nele contidos das seguintes maneiras:
/PLUGIN=DB2 /SYSTEM=<system>O plug-in fornece uma interface para o gerenciamento dos bancos de dados DB2 for i no IBM i.
/PLUGIN=checkupdatesO plug-in fornece uma interface que permite verificar as atualizações disponíveis.
/PLUGIN=SSH /SYSTEM=<system>O terminal de SSH ativará um cliente SSH já instalado (emulador de terminal) no PC para o Sistema de arquivos integrado do IBM i.
/PLUGIN=OSSSETUPOSSSETUP ativará uma interface que permitirá que você gerencie pacotes de software livre no IBM i.i.
/PLUGIN=installupdates [Options] As opções válidas são: /noprompt Não solicitar ID e senha do usuário Nota: ao usar essa opção, caso as credenciais do usuário para o sistema remoto já estejam armazenadas em cache, a verificação de atualizações disponíveis continuará normalmente. Se as credenciais do usuário não estiverem armazenadas em cache, a autorização para o sistema remoto será negada e as atualizações não ficarão disponíveis.INSTALLUPDATES verificará o sistema IBM i configurado em busca de atualizações disponíveis e automaticamente fará o download e instalará a atualização na instalação do PC local. Para configurar um local do IBM i para o download de atualizações, consulte a seção 5.2.
/PLUGIN=httpproxyuiHTTPPROXYUI ativará um proxy HTTP seguro, que permite a conectividade de um IBM i com a Internet, por meio do computador que executa esse proxy. O acesso à Internet será ativado a partir de qualquer Terminal de SSH que insira os comandos fornecidos pelo plug-in HTTPPROXYUI.
/udcnv [/wide] /wide Esta opção é válida apenas com a página de código 932. Quando especificada, o arquivo de imagem de fonte produzido conterá caracteres Unicode.Chamada de exemplo:
Start_Programs\Windows_x86-64\acslaunch_win-64.exe /udcnvEsta opção da linha de comandos gera um arquivo de imagem de fonte que contém caracteres UDC (User Defined Characters) que atualmente estão configurados em uma estação de trabalho do Windows. O arquivo de imagem de fonte gerado será uma página de códigos ANSI baseada no código de idioma da estação de trabalho. As seguintes páginas de códigos ANSI são suportadas:
Pág. de código Plataforma Nome do arquivo de imagem de fonte 932 Windows em japonês jpn24.fnt 949 Windows em coreano kor24.fnt 936 Windows em chinês simplificado chs24.fnt 950 Windows em chinês tradicional cht24.fntO arquivo de imagem de fonte gerado pode ser usado com a emulação de impressora 5250 em conjunto com uma PDT (Printer Definition Table) em uma estação de trabalho Windows. O comando iniciará uma GUI na qual será possível especificar o caminho em que o arquivo de imagem de fonte gerado deve ser colocado. O arquivo de imagem de fonte gerado precisa ter o nome especificado acima e ser colocado na pasta Emulator\fonts, existente em:
<Configuration Root>\Emulator\fontsEm que <Configuration Root> normalmente é um caminho como:
C:\Users\<user_name>\Documents\IBM\iAccessClientPara encontrar a Raiz de configuração real de sua instalação, veja a seção 8.1 Local de configuração.
Limitações:
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) .sql - arquivo SQLExemplos 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.
A função apropriada do IBM i Access Client Solution será executada quando você der um clique duplo nos arquivos com este tipo.
Siga as etapas no QuickStartGuide para Linux. Isso instalará o aplicativo em /opt/ibm/iAccessClientSolutions. Ele também criará: /usr/share/applications/IBM i Access 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.
As etapas requeridas para configurar associações de arquivo dependerão da distribuição Linux e do ambiente de área de trabalho sendo usado. Em geral, as etapas necessárias serão semelhantes às etapas acima, usadas para o Windows.
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.
A função apropriada do IBM i Access Client Solution será executada quando você der um clique duplo nos arquivos com este tipo.
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.
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 arquivo .zip do produto e fica no mesmo diretório que o arquivo acsbundle.jar, no qual o arquivo .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 utilizadas no caminho especificado, as palavras-chave são substituídas pelo texto ou caminho por elas definido. 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:
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 pela ID 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. Isso funciona em todos os sistemas operacionais, incluindo 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 é remota ou local, de acordo com o 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 é remota ou local de acordo com o local de {PRODUCTDIR}.
Exemplo 4 – configuração local na mídia portátil (como unidade USB):
com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directoryComo 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.
Aqui estão algumas outras opções de implementação que você pode querer considerar:
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:
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 for 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 sempre 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.
Nota:
Para evitar a importação do nome de usuário padrão especificado na guia Conexão de uma Configuração do sistema, coloque a propriedade a seguir no arquivo AcsConfig.properties.
com.ibm.iaccess.ResetDefaultUserOnImport=true
Alguns dos plug-ins da linha de comandos que não precisam de 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 arquivo .zip do produto em qualquer local no Sistema de arquivos integrado (IFS) do IBM i. Por exemplo, caso tenha extraído o arquivo .zip do produto em:
/home/AccessClientSolutionsE tiver uma solicitação de download de Transferência de dados salva anteriormente existente em:
/some_path/qcustcdt.dtfxSerá possível executar o comando a seguir no IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /PLUGIN=dtbatch /some_path/qcustcdt.dtfx')
Nota:
Há também PTFs do IBM i que se encarregarão da extração do conteúdo do produto em um IBM i.
Consulte a seção 5.3 PTFs opcionais do IBM i
O IBM i Access Client Solutions permite que os administradores do sistema restrinjam o usuário de funções específicas, configurando uma das duas propriedades a seguir no arquivo AcsConfig.properties:
com.ibm.iaccess.ExcludeComps=<function, function,...> com.ibm.iaccess.IncludeComps=<function, function,...>
A configuração de com.ibm.iaccess.ExcludeComps desativará as funções especificadas. Todas as outras funções serão ativadas. Nenhuma função especificada nesta propriedade ficará disponível a partir da GUI do ACS ou a partir da linha de comandos. As funções que podem ser especificadas nesta propriedade são listadas abaixo.
A configuração de com.ibm.iaccess.IncludeComps ativará as funções especificadas. Todas as outras funções serão desativadas. Qualquer função especificada nesta propriedade ficará disponível para uso normal. As funções que podem ser especificadas nesta propriedade são listadas abaixo.
Função Descrição 5250 Emulador 5250 cfg Configurações do Sistema checkupdates Verificar atualizações disponíveis cldownload Downloads da linha de comandos de Transferência de dados console Console 5250 consoleprobe Procurar a rede local para configurações do console db2 Esquemas db2tools Centro de desempenho SQL download Downloads da linha de comandos de Transferência de dados dtgui Interface gráfica com o usuário de Transferência de Dados hmcprobe Procurar partições em um HMC ifs Sistema de arquivos integrado keyman Gerenciamento de certificado SSL/TLS l1c IBM Navigator for i (Console do Nível 1) osssetup Gerenciamento de pacote de software livre restrictview Restringir a visualização de funções atualmente restritas rmtcmd Comando remoto (disponível a partir da linha de comandos) rss Executar Scripts SQL sm Gerenciador de Sessões 5250 splf Saída de Impressora (arquivos de spool) ssh Shell seguro sysdbg Depurador de sistema IBM i upload Uploads da linha de comandos de Transferência de dados vcp Painel de Controle Virtual Interfaces de gerenciamento de hardware: hmi1 Interface de Gerenciamento de Hardware 1 hmi2 Interface de Gerenciamento de Hardware 2 asmi Advanced System Management Interface (ASMI) csmi Copy Services Manager for i dcm Digital Certificate Manager dshmc DS HMC hmc Hardware Management Console (HMC) httpadmin Web (HTTP) Administration for i ivm Integrated Virtualization Manager specctrl Spectrum Control tapemgmt1 Gerenciamento de fita 1 tapemgmt2 Gerenciamento de fita 2 are Administration Runtime Expert db2webquery Db2 Web Query
As funções também podem ser especificadas como grupos usando as palavras-chave a seguir:
Grupo Funções dataxfer dtgui,upload,download,cldownload emulator sm,5250 keyman keyman opconsole console,vcp,consoleprobe,hmcprobe rmtcmd rmtcmd splf splf ifs ifs hwconsole hmi1,hmi2,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery l1cplugin l1c database db2,rss,db2tools debugger sysdbg
Normalmente, essas propriedades não seriam usadas juntas. Caso sejam usadas juntas e uma função seja especificada em ambas as propriedades, a função será desativada.
Exemplo 1: isso desativará todas as funções associadas a OPCONSOLE,HWCONSOLE,L1CPLUGIN. Todas as outras funções na lista acima serão ativadas.
com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN
Exemplo 2: isso ativará downloads de 5250 e de transferência de dados. Todas as outras funções na lista acima serão desativadas.
com.ibm.iaccess.IncludeComps=5250,DOWNLOAD
Caso o administrador do sistema queira atualizar o arquivo AcsConfig.properties dentro de acsbundle.jar antes de implementá-lo em seus usuários, este é um exemplo de como fazer isso:
jar uvf acsbundle.jar AcsConfig.propertiesConsulte 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.
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.
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.
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 menusOs arquivos serão convertidos em:
.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 menusOs 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:
Um utilitário de conversão de macro está disponível. A partir do Gerenciador de Sessões:
Ferramentas->Converter macro...Nota Técnica:
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 iOs arquivos serão convertidos em:
.dtfx - transferência de dados a partir do IBM i .dttx - transferência de dados para o IBM iO 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
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
O IBM i Access Client Solutions oferece suporte para Kerberos. Para usar o Kerberos ao se conectar a um sistema:
A propriedade com.ibm.iaccess.PC5250Compatibility pode ser usada para alterar o comportamento padrão do emulador ACS. Essa propriedade pode ser configurada em AcsConfig.properties com os seguintes valores:
allowNnAsFKeyHotspot - tratar os pontos de acesso NN (ex.: FNN, PFNN, FPNN) como pontos de acesso chave de função. allowHighlightBypassField - permitir que Ignorar campos com ENTFLDATR sejam destacados. allowTypingInSignPosition - permitir o chaveamento de '-' ou ' ' na posição de sinal de um campo numérico de sinal. allowTransformSpecialCharsOnPaste - alterar o modo como certos caracteres são transformados ao colar textos de documentos externos (ex.: citações curly tornam-se citações lineares).Exemplo 1:
com.ibm.iaccess.PC5250Compatibility=allowTransformSpecialCharsOnPasteExemplo 2: vários valores podem ser especificados em uma lista separada por vírgulas.
com.ibm.iaccess.PC5250Compatibility=allowNnAsFKeyHotspot,allowHighlightBypassField,allowTypingInSignPosition
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.
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:
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, é possível configurar as propriedades acima 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
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
Caso os caracteres especiais %1$s %2$s ou %3$s sejam usados na propriedade, o posicionamento de library.filename e de sheet# pode ser alterado ou eliminado.
Os valores possuem o seguinte significado:
%1$s - library.filename Por exemplo: qiws.qcustcdt
%2$s - sheet# Por exemplo: 1
%3$s - nome do arquivo de destino sem a extensão de arquivo
O uso de qualquer um desses valores especiais oferece total controle sobre o nome da planilha.
A configuração da propriedade como Sheet%2$s produzirá estes nomes de planilha: Sheet1, Sheet2, etc
com.ibm.iaccess.dataxfer.SheetId=Sheet%2$s
É possível usar %1$s %2$s ou %3$s em qualquer combinação com outros textos.
Nota:
Como os nomes das planilhas em uma pasta de trabalho devem ser exclusivos, a configuração da propriedade para usar %1$s ou %3$ sem também usar %2$s produzirá um erro, caso sejam necessárias mais de uma planilha.
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:
Para um IBM i no qual a configuração do console ainda não existe (por exemplo, um sistema novo, que recentemente foi entregue a uma empresa), um endereço IP de uma configuração de console será automaticamente designado no intervalo de 169.254.62.0 a 169.254.62.63 durante o carregamento inicial de programas. Para estes casos, as etapas a seguir ajudarão a estabelecer uma conexão de console usando o IBM i Access Client Solutions:
Quando estiver pronto para inserir o sistema IBM i no restante da infraestrutura de rede, é possível acessar o IBM Knowledge Center para obter informações adicionais sobre como configurar o adaptador LAN de Ferramentas de serviço:
Consulte 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:
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:
Nota:
O <path> pode ser um caminho absoluto ou um caminho relativo a partir do local
de acsbundle.jar. Apenas fontes monoespaçadas são reconhecidas pela emulação 5250.
Exemplo 1 (padrão):
com.ibm.iaccess.Fonts=FontsExemplo 2:
com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts
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 o Nome do usuário padrão corresponderem ao conteúdo do arquivo netrc, uma conexão com o sistema será estabelecida usando a senha do arquivo netrc, sem que o usuário seja solicitado.
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, consulte o tópico "Segurança e autoridade de objetos no sistema de arquivos QFileSvr.400" no IBM i Knowledge Center.
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, é possível configurar a propriedade a partir da linha de comandos, como outras propriedades Java, como a seguir:
-Dcom.ibm.iaccess.ifs.transferMechanism=ACS
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.
O suporte de Sistema de arquivos integrado não permite ações para objetos que possuem caminhos iniciados com /QFileSvr.400, /QNTC ou /QOPT. Caso o caminho de diretório atual ou algum caminho de objeto selecionado comece com /QFileSvr.400, /QNTC ou /QOPT, todos os itens no menu Ações serão desativados e não será exibido um menu de contexto.
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.
O desempenho do IFS ao exibir o conteúdo de um diretório é determinado pelos atributos de coluna selecionados (Visualizar -> Colunas...) e a existência ou não de links simbólicos no diretório. Para links não simbólicos, há um impacto adicional sobre o desempenho ao selecionar CCSID ou Owner. Para links simbólicos, há um impacto adicional sobre o desempenho para cada atributo de coluna selecionado que seja diferente de Ícone, Nome e Tamanho (KB)
Nota: o Tamanho (KB) para links simbólicos não é exibido ao navegar no diretório. Selecione Propriedades para obter o tamanho do arquivo representado pelo link simbólico.
Ao exibir um diretório com um grande número de entradas, é possível exceder o limite de memória padrão da Java Virtual machine na qual o IBM i Access Client Solutions está sendo executado. Isso pode fazer com que todas as janelas abertas fiquem mais lentas e, eventualmente, parem de responder. Ao exibir diretórios com um grande número de entradas, considere usar o filtro Incluir para limitar o número de entradas enviadas do servidor. Ou, inicie o produto usando a opção -Xmx para aumentar a memória disponível. Por exemplo:
java -Xmx4g -jar V:/some_location/acsbundle.jar ou Start_Programs\Windows_x86-64\acslaunch_win-64.exe -Xmx4g
Os exemplos acima aumentarão a memória padrão de 1 para 4 gigabytes. Dependendo do número de entradas no diretório, pode ser necessário aumentar ainda mais o tamanho.
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 de SSH ativará 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á possuem um shell seguro por padrão. Para essas plataformas, assume-se que existe um cliente OpenSSH localizado em /usr/bin/ssh. Usuários do Windows precisarão instalar um dos shells seguros disponíveis para o 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 a instalação do pacote OpenSSH
bash está disponível como parte do subsistema Linux para Windows
Se houver diversos aplicativos SSH instalados, será possível utilizar a propriedade com.ibm.iaccess.PreferredSSHClient para configurar o cliente SSH preferencial.
Exemplos do Linux:
com.ibm.iaccess.PreferredSSHClient=XterminalEmulator
com.ibm.iaccess.PreferredSSHClient=MateTerminal
com.ibm.iaccess.PreferredSSHClient=Terminator
com.ibm.iaccess.PreferredSSHClient=GnomeTerminal
com.ibm.iaccess.PreferredSSHClient=Konsole
com.ibm.iaccess.PreferredSSHClient=Xfce4
Exemplos do Mac:
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, é 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, pode ser necessário configurar com.ibm.iaccess.SSHClientOpt para fornecer todos os argumentos necessários. Por exemplo, para desativar os avisos, se o encaminhamento do X11 não for utilizado:
com.ibm.iaccess.SSHClientOpts=-x
Se receber um erro de conexão dentro do cliente SSH ativado (por exemplo, "conexão recusada"), ou se uma janela aparecer e desaparecer imediatamente, pode ser necessário iniciar o daemon SSH com o comando acima.
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:
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 A1-1 É necessário usar o JDK 8.0 ou superior. Consulte 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 Ao dar 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. Q11 Depois de instalar o JDK 8.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 8.0. Será necessário usar uma opção que especifique explicitamente o caminho para o início do Java para JDK 8. Consulte 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 que está 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.
Veja a página da web a seguir:
Soluções IBM i Access Client (5733XJ1)