O Manual de Iniciação Rápida contém instruções para implementar o produto que funcionam para a maioria dos utilizadores que executem Windows, Mac ou Linux. Para instalar este produto para um único utilizador ou para um PC de múltiplos utilizadores, consulte o Manual de Iniciação Rápida na pasta Documentation.
Detalhes adicionais sobre o produto, outras opções de implementação e personalização do produto encontram-se incluídos no resto deste documento.
O IBM i Access Client Solutions é o membro mais recente da família de produtos IBM i Access. Fornece uma interface independente de plataforma baseada em Java que executa na maioria dos sistemas operativos que suportam Java incluindo Linux, Mac e Windows. O IBM i Access Client Solutions consolida as tarefas mais comuns para gerir o seu sistema IBM i numa localização simplificada.
O IBM i Access Client Solutions utiliza os mesmos servidores de sistemas centrais IBM i que os outros produtos IBM i Access Family e requer a mesma licença IBM i Access Family (5770XW1) para utilizar a emulação 5250 e componentes de Transferência de Dados.
Também se encontram disponíveis dois pacotes opcionais que incluem middleware para utilizar e desenvolver aplicações cliente para Windows e Linux.
IBM i Access Client Solutions - Pacote de Aplicações do Windows
IBM i Access Client Solutions - Pacote de Aplicações de Linux
Os clientes que utilizam o IBM i 7.2 ou posterior que tenham a autorização de utilização actual podem adquirir o IBM i Access Client Solutions através das seguintes formas:
Os pacotes de aplicações opcionais para Windows e Linux encontram-se disponíveis a partir do sítio da Web Entitled Software Support (ESS).
Os clientes podem adquirir suportes ao encomendar a função de renovação 6288 de 5761-SS1 ou 5770-SS1. O suporte físico contém uma versão executável do produto que permite ao utilizador executar o produto directamente a partir do CD. O suporte físico também inclui um ficheiro .zip do produto que poderá ser copiado e extraído para uma localização escolhida pelo utilizador. O suporte físico para o IBM i Access Client Solutions não contém os Pacotes de Aplicações do Windows e Linux opcionais.
Para obter informações adicionais visite:
IBM i Access Client Solutions
Para obter as informações mais recentes sobre produtos do IBM i Access Family visite:
IBM i Access Family
As funcionalidades do IBM i Access Client Solutions incluem:
O Pacote de Aplicações do Windows opcional inclui:
O pacote de Aplicações do Linux opcional inclui:
O IBM i Access Client Solutions irá ser executado na maioria dos sistemas operativos
que suportam Java 8.0 ou superior, incluindo várias versões do Linux, Mac e Windows.
Nota: O ACS pode não conseguir localizar o Java 8 no macOS 11.0 Big Sur. Recomendamos a instalação do Java 11.
Recomendação:
Manter a versão de Java na versão mais actual garante que
dispõe sempre das últimas correcções de segurança.
Uma forma de verificar a versão de Java instalado no sistema é abrir um pedido de confirmação onde seja possível introduzir um comando (Linha de Comandos, Interface, Terminal, etc) e, em seguida, escrever o comando:
java -version
O seguinte resultado indica que a versão 8.0 está instalada:
java version "1.8.0_191"
O 191, neste exemplo, refere-se ao nível de actualização.
Seguem-se alguns sítios da Web de fornecedores Java. Certifique-se de que está a executar com a versão mais actualizada de Java da sua plataforma.
https://adoptopenjdk.net/
https://aws.amazon.com/corretto/
http://openjdk.java.net/install
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Nota Técnica para Mac:
Quando instalar Java em Mac, seleccione um JDK em vez de um JRE. O JRE para Mac instala Java apenas para o navegador.
Não instala Java para outras aplicações. A instalação do JDK torna o Java disponível para outras
aplicações como, por exemplo, o IBM i Access Client Solutions.
O IBM i Access Client Solutions estabelece ligação a qualquer edição do IBM i suportada.
O IBM i Access Client Solutions utiliza os mesmos servidores de sistemas centrais IBM i que os outros produtos IBM i Access Family e requer a mesma licença IBM i Access Family (5770XW1) para utilizar a emulação 5250 e componentes de Transferência de Dados.
Se estiver a utilizar ligações SSL, carregue e aplique as seguintes PTFs do IBM i
para a sua edição:
7.2 - SI55392, SI57320, MF60333, MF60334
Se estiver a utilizar o Navigator for i, carregue e aplique as PTFs do IBM i
adequadas à sua edição:
7.2 - Grupo de PTF SF99713 nível 30 ou posterior
7.3 - Grupo de PTF SF99722 nível 17 ou posterior
Os seguintes ficheiros e directórios estão contidos no ficheiro .zip do produto:
acsbundle.jar - um ficheiro JAR executável do produto AcsConfig.properties- ficheiro que contém definições de configuração (também existe dentro de acsbundle.jar) Mac_Application - um directório que contém o script de instalação para Mac Linux_Application - um directório que contém os scripts de instalação para Linux Windows_Application - um directório que contém os scripts de instalação para Windows Start_Programs - directório que contém ficheiros binários específicos da plataforma que podem ser utilizados para iniciar o produto. Linux_i386-32 Linux_x86-64 Mac_i386-32_x86-64 Windows_i386-32 Windows_x86-64 Documentação - directório que contém documentação QuickStartGuide - informações sobre a iniciação GettingStarted - informações detalhadas sobre o produto Licença - um directório que contém termos e condições para a utilização Avisos - um directório que contém avisos e informações Propriedades - um directório que contém informações acerca da versão do produto Sample_Scripts - um directório que contém scripts de exemplo que podem ser utilizados para iniciar o produto se os ficheiros binários em Start_Programs não funcionarem. Linux_Mac_Other - um directório de scripts perl para iniciar o produto de qualquer plataforma onde perl está disponível. Windows - um directório que contém um JScript para iniciar no Windows Ícone - um directório que contém ficheiros que podem ser utilizados como ícones Tipos de letra - directório onde será possível adicionar tipos de letra de largura fixa adicionais para emulação 5250
A criação de pacotes do IBM i Access Client Solutions fornece várias opções de instalação, a partir de uma instalação única de utilizador muito simples, para a maioria das instalações de múltiplos utilizadores avançadas.
Os scripts de instalação foram fornecidos nas pastas Mac_Application, Linux_Application e Windows_Application (consulte a secção 4.0 Conteúdos do Produto) podem ser utilizados para uma grande variedade de opções de instalação.
Para uma instalação única de utilizador em Mac, Linux e Windows ou para uma instalação de múltiplos utilizadores num Windows PC, consulte o Manual de Iniciação Rápida. O Manual de Iniciação Rápida explica como podem ser utilizados os scripts de instalação disponibilizados para efectuar estes tipos de instalações simples.
Se for um administrador a planear a implementação para diversos utilizadores, deverá ler
os seguintes artigos:
IBM i Access Client Solutions: Personalização e implementação facilitadas
IBM i Access Client Solutions: Resposta a perguntas de personalização e implementação
Estes artigos explicam como um administrador pode pré-personalizar a
instalação para múltiplos utilizadores antes da implementação utilizando
a opção /AdminConfig suportada pelos scripts de instalação.
Para administradores que pretendam automatizar a instalação no modo silencioso, utilize o parâmetro /AdminConfig para pré-configurar a instalação. Em seguida, utilize o parâmetro /Q durante a instalação actual. Por exemplo:
Windows_Application\install_acs_64.js /AdminConfig Windows_Application\install_acs_64.js /Q
Para além das opções anteriores, também pode ter a opção de desempacotar apenas o ficheiro .zip para qualquer localização à sua escolha. Pode ser qualquer localização onde a estação de trabalho tem autoridade de leitura para aceder aos ficheiros. Isto inclui a unidade de disco rígido, uma unidade de rede remota (partilhada) ou suporte portátil tal como um CD ou unidade Flash USB. O desempacotamento do ficheiro .zip conclui a instalação.
Nota Técnica:
Alguns utilitários de arquivo não preservam todos os atributos dos ficheiros guardados. Por exemplo,
nas plataformas Mac e Linux, o comando unzip é geralmente uma escolha melhor do que o comando jar. Para obter informações adicionais, consulte a secção 6.0 Permissões de Ficheiros.
As melhorias e correcções são disponibilizadas numa base periódica. Estas actualizações são fornecidas como uma instalação de produto completa. Quando estas actualizações estão disponíveis, deve actualizar a instalação existente.
Para utilizadores que fazem a manutenção da respectiva instalação:
Opção 1:
Para actualizar uma instalação existente que tenha instalada através
dos scripts de instalação, extraia os conteúdos de uma versão mais
recente do produto. Invoque o script de instalação a partir desta nova versão da
mesma forma que o fez durante a instalação inicial. Isto irá actualizar os ficheiros do produto sem alterar a configuração existente.
Opção 2:
Se escolheu instalar o produto sem utilizar os scripts de instalação
para extraírem os conteúdos do ficheiro .zip para a mesma localização
escolhida, em seguida, para actualizar o produto, será necessário
extrair os conteúdos da nova versão do produto para a versão
existente.
Tenha em conta que poderá ser necessário guardar e restaurar o conteúdo do ficheiro AcsConfig.properties caso tenha feito alterações personalizadas ao mesmo.
Para administradores que mantenham uma versão do produto numa localização central acedida por múltiplos utilizadores:
Extraia os conteúdos da versão mais recente sobre a versão existente.
Se efectuou alterações personalizadas ao ficheiro
AcsConfig.properties, deverá guardar o ficheiro AcsConfig.properties
antes de extrair os conteúdos da nova versão do produto para uma
versão existente. Após extrair os conteúdos da nova versão do produto e restaurar o ficheiro AcsConfig.properties, os utilizadores terão de executar uma das seguintes opções:
Opção 1:
Caso os utilizadores estejam a executar directamente a partir da localização remota, não serão necessárias mais acções. Os utilizadores terão de reiniciar o produto para obter as novas actualizações.
Opção 2:
Execute o script de instalação da mesma forma que a instalação inicial para actualizar a instalação local.
Opção 3:
Caso tenha configurado uma Localização de Actualizações do IBM i, secção 5.2, solicite aos utilizadores que seleccionem Ajuda->procurar actualizações a partir da interface gráfica do utilizador principal.
Deverá surgir um painel a informar que existe uma actualização disponível. Seleccionem Instalar Actualização. Também é possível executar esta opção a partir da linha de comandos através da utilização do suplemento INSTALLUPDATES.
Após seguir os passos adequados acima, reinicie o produto. É possível utilizar Ajuda->Acerca de a partir da interface gráfica do utilizador principal para verificar se as actualizações foram aplicadas.
Os administradores poderão utilizar um sistema do IBM i como a respectiva localização central para executar instalações e aplicar actualizações. Independentemente de como implementar o produto inicialmente para os utilizadores, será possível utilizar uma localização central num IBM i de forma a que os utilizadores poderão aplicar uma actualização com um clique de um botão. Os passos são os seguintes:
com.ibm.iaccess.CheckUpdateSystem=system_name (consulte a Nota 1 abaixo) com.ibm.iaccess.CheckUpdatePath=/path_where_zip_was_extracted (Consulte a Nota 2 abaixo)
A definição da propriedade com.ibm.iaccess.CheckUpdateSystem faz com que Ajuda->Procurar Actualizações se comporte de forma diferente. Em vez de procurar numa localização da Web externa pela disponibilidade de uma versão actualizada, é procurada a localização do IBM i acima pela existência de ficheiros do produto actualizados. É detectada uma actualização quando a marca de hora de qualquer ficheiro do produto requerido for alterada. A marca de hora é apresentada no painel Ajuda->Procurar Actualizações com uma opção para instalar a actualização.
O utilizador necessitará de credenciais válidas para o sistema especificado para com.ibm.iaccess.CheckUpdateSystem. Caso as respectivas credenciais ainda não tenham sido colocadas na memória cache a partir de uma ligação anterior para este sistema, ser-lhe-á pedido para fornecer credenciais válidas. A falha no fornecimento de credenciais válidas fará com que não sejam detectadas actualizações.
Não será pedido aos utilizadores que possuem uma Localização de Actualizações do IBM i configurada e tenham seleccionado a opção "Notificar-me quando existirem actualizações disponíveis" sob Editar->Preferências Preferences que facultem credenciais. Apenas serão notificados da existência de uma actualização disponível caso tenham estabelecido ligação com êxito a com.ibm.iaccess.CheckUpdateSystem desde a última vez que iniciaram sessão no respectivo PC.
Nota:
Nota especial para administradores que mantêm um ficheiro AcsConfig.properties personalizado dentro de acsbundle.jar:
Esta funcionalidade descarrega o ficheiro acsbundle.jar que existe no IBM i na localização especificada. Não é executado qualquer processamento especial para manter uma versão personalizada do ficheiro AcsConfig.properties durante uma actualização. Caso tenha personalizado anteriormente o ficheiro AcsConfig.properties dentro de acsbundle.jar, será necessário certificar-se de que a nova versão de acsbundle.jar contém as personalizações pretendidas antes de disponibilizar o mesmo para descarregar.
Para Administradores que pretendem manter uma localização centralizada num IBM i para os respectivos utilizadores instalarem e actualizarem o produto, existem PTFs específicos das edições que facultarão os conteúdos extraídos de IBMiAccess_v1r1.zip em:
/QIBM/ProdData/Access/ACS/Base
As PTFs para 1.1.8.7 são:
V7R4M0 SI76178 V7R3M0 SI76179 V7R2M0 SI76180Estas PTFs serão substituídas para cada actualização de produto e normalmente estarão disponíveis dentro de 2 semanas da disponibilidade da actualização do produto.
A Secção 7.0 Iniciar o Produto descreve várias formas diferentes de iniciar o IBM i Access Client Solutions. Se utilizar um dos ficheiros binários ou scripts fornecidos para iniciar o produto, necessitará de se certificar de que as suas permissões do ficheiro têm a permissão de execução activada. As permissões de ficheiro atribuídas ao descompactar o ficheiro de arquivo .ZIP são determinadas por vários factores incluindo o sistema operativo, o utilitário de arquivamento utilizado para descompactar o arquivo .ZIP, a autoridade do utilizador, etc.
Caso tenha dificuldades em utilizar um dos ficheiros binários ou scripts facultados, verifique as permissões do ficheiro. As seguintes secções descrevem alguns métodos para verificar as permissões do ficheiro.
Para sistemas operativos semelhantes ao Unix, é possível utilizar o seguinte comando a partir de um pedido de confirmação de interface ou terminal para verificar as permissões de um ficheiro:
ls -l <ficheiro>
Para alterar as permissões de um ficheiro, é possível utilizar o seguinte comando:
chmod <permissão> <ficheiro>
chmod a+rx <ficheiro>para facultar a permissão de leitura/escrita/execução ao proprietário do ficheiro e apenas leitura/execução para todos os outros:
chmod 755 <ficheiro>
Ajuda adicional para os comandos ls e chmod está disponível na Internet.
Para o Windows, enquanto visualiza o ficheiro através do explorador do Windows, faça clique com o botão direito do rato no ficheiro e seleccione propriedades. O separador de segurança contém as permissões do ficheiro. Certifique-se de que tem permissão de Leitura e Execução.
Em versões recentes do Windows, pode também utilizar o comando icacls para ver e alterar a permissão de um ficheiro.
Existem várias formas de iniciar o IBM i Access Client Solutions. Se utilizou os scripts de instalação para instalar o produto, a forma mais fácil para iniciar o produto é encontrada no Manual de Iniciação Rápida.
Se o produto não foi instalado através dos scripts de instalação, o resto desta secção irá descrever formas alternativas sobre como iniciar o produto. Uma vez que existe uma grande variedade de formas e de localizações onde/como pode ser instalado o Java, alguns dos métodos poderão requerer configurações adicionais. Se um dos métodos abaixo não funcionar, tente um método diferente. Em alguns casos, são dadas instruções adicionais.
Quando utilizar um ficheiro binário ou script conforme descrito abaixo, o ficheiro binário ou script terá de estar na mesma estrutura de directórios conforme contida no ficheiro .zip. Por conveniência, também pode copiar/mover o(s) ficheiro(s) binário(s) e/ou scripts para a(s) sua(s) plataforma(s) para o mesmo directório onde existe acsbundle.jar.
Para iniciar o produto a partir de um visualizador de ficheiros (por exemplo o Explorador do Windows, Mac OS X Finder, etc) utilizando um ficheiro binário específico para a plataforma, localize o sub-directório em Start_Programs que identifica o sistema operativo e arquitectura de hardware.
Localize o ficheiro binário que o sistema operativo reconhece. Depois faça duplo clique para iniciar o produto. Pode também iniciar o produto com este ficheiro binário com uma Linha de comandos, terminal ou interface.
Se obter o seguinte erro:
"Erro ao carregar o módulo de Java."
As soluções IBM i Access Client não conseguiram localizar uma instalação de Java numa localização que reconhece. Poderá tentar um dos seguintes métodos nas secções:
7.1.1 Iniciar o Produto - Opções Adicionais
7.2 Iniciar o Produto (utilizando um script)
7.3 Iniciar o Produto (utilizando a linha de comandos)
Também poderá tentar um dos seguintes métodos quando tentar utilizar o ficheiro binário para a plataforma. Estes métodos permitem-lhe identificar qual o Ambiente de Tempo de Execução Java (JRE, Java Runtime Environment) que deve ser utilizado para iniciar o produto. Consulte a secção 7.1.2 Localizar o Caminho Inicial de Java para obter informações sobre como localizar o caminho inicial de Java na estação de trabalho. Estes métodos adicionais apenas são suportados em plataformas de Linux e Windows:
É possível iniciar o produto através de um dos seguintes métodos na secção:
7.2 Iniciar o Produto (utilizando um script) (OU)
7.3 Iniciar o Produto (utilizando a linha de comandos)
em seguida, é possível determinar o caminho inicial de Java na estação de trabalho a partir da interface gráfica do utilizador principal do IBM i Access Client Solutions. Na barra de menus, seleccione
Ajuda->Sobre
O caminho java.home é apresentado neste painel.
A propriedade java.home contém a localização do caminho principal de Java para a sua estação de trabalho. Este é o caminho que vai necessitar de especificar quando definir a variável do ambiente JAVA_HOME ou quando utilizar a opção -vm no comando.
Em plataformas do Windows, procure por java.exe. O binário Java está normalmente localizado numa gaveta ou num subdirectório jre/bin abaixo do caminho principal de Java. O caminho principal Java pode ser utilizado ao definir ou a variável do ambiente JAVA_HOME ou ao utilizar a opção -vm no comando.
Em Linux é possível utilizar o comando "which":
which javaIsto facultar-lhe-á um caminho para o comando de Java ou uma ligação simbólica para o mesmo.
Resolve quaisquer ligações simbólicas até obter, finalmente, o ficheiro binário em si para o comando java. É possível processar ligações simbólicas através do comando ls com a opção -l:
ls -l <ficheiro>O binário Java está normalmente localizado numa gaveta ou num subdirectório jre/bin abaixo do caminho principal de Java. O caminho principal Java pode ser utilizado ao definir ou a variável do ambiente JAVA_HOME ou ao utilizar a opção -vm no comando.
Existe um directório Sample_Scripts no directório Documentation.
A forma preferencial para iniciar o produto é através da utilização de um ficheiro binário especifico para a plataforma disponível em Start_Programs. Os scripts em Sample_Scripts devem ser apenas utilizados se o binário especifico para a plataforma não funcionar.
Para iniciar o produto a partir de um navegador de sistemas de ficheiros (por exemplo o Explorador do Windows, Mac OS X Finder, etc) utilizando um dos scripts facultados, localize o script compatível com o sistema operativo no sub-directório Sample_Scripts.
A maioria dos sistemas operativos não baseado em Windows têm perl disponível por predefinição. O directório Sample_Scripts/Linux_Mac_Other contém um script perl (com três extensões de nome de ficheiros diferentes) que podem ser utilizados para iniciar o produto em qualquer plataforma onde o perl está disponível. Seleccione o ficheiro que tem uma extensão do nome do ficheiro que o sistema operativo vai reconhecer como um script perl.
Sistemas operativos baseados em Windows têm JScript disponível por predefinição. O directório Sample_Script/Windows contém um JScript que pode ser utilizado para iniciar o produto em sistemas operativos Windows.
Utilizando um método especifico de plataforma para procurar o sistema de ficheiros (ex. Explorador do Windows, Mac OS X Finder, etc), localize o script que o seu sistema operativo reconhece. Depois, faça duplo clique para iniciar o produto. Pode também iniciar o produto com este script com uma Linha de comandos, terminal ou interface.
Também é possível iniciar o produto a partir da linha de comandos de qualquer sítio onde seja possível introduzir um comando (Linha de Comandos, Terminal, Interface, etc)
java -Xmx1024m -jar <caminho>/acsbundle.jaronde <caminho> é a localização do ficheiro JAR executável do produto
java -Xmx1024m -jar V:/some_location/acsbundle.jarou
<caminho_java>java -jar V:/some_location/acsbundle.jaronde <java_path> é a localização do comando Java para JDK 8.0 ou superior.
Consulte a secção 7.1.2 Localizar o Caminho Inicial de Java para determinar o caminho completo para o comando Java.
Também pode utilizar qualquer um dos programas ou scripts a partir da linha de comandos. Por exemplo:
/Product/Location/Start_Programs/Linux_x86-64/acslaunch_linux-64 /Product/Location/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac C:\Product\Location\Start_Programs\Windows_x86-64\acslaunch_win-64.exe
Nota Técnica:
Na maioria das plataformas, o espaço de pilha da máquina Virtual Java tem como predefinição um tamanho máximo demasiado pequeno para utilizar múltiplas funções dentro do produto IBM i Access Client Solutions. Um tamanho da pilha máximo de um GB (-Xmx1024m) é o tamanho mínimo recomendado. Especificar tamanhos menores do que um GB ou utilizar o tamanho da pilha predefinido pode produzir uma OutOfMemoryException.
Adicione uma configuração do sistema para cada sistema do IBM i que pretende utilizar ou gerir. Para adicionar a configuração do sistema, seleccione Configuração do sistema das tarefas Gestão. Depois, seleccione Novo. No separador Geral, introduza o nome do sistema. Para iniciar, o nome do sistema é tudo o que é necessário para executar tarefas Gerais.
Quando tiver concluído, seleccione OK para guardar a informação que inseriu neste sistema ou seleccione Guardar/Novo se tem sistemas adicionais que pretende adicionar às configurações.
Para configurar um sistema para estabelecer uma ligação TLS/SSL, consulte a secção Configurar Ligações Seguras.
Pode adicionar novos sistemas à sua configuração ou actualizar configurações existentes utilizando os separadores Geral, Ligação ou Consola a qualquer altura.
Para tarefas de Consola, são requeridas configurações adicionais. Configurações de consola são associadas automaticamente com o Nome do Sistema que introduziu no separador Geral. Para introduzir a configuração da consola para um sistema, seleccione Configurações de sistema das tarefas de Gestão. Seleccione Novo ou editar. Depois, seleccione o separador Consola. A tarefa Consola 5250 requer uma consola LAN ou uma consola HMC configurada. Caso não tenha uma consola de LAN ou HMC configurada, consulte a secção 9.9 Estabelecer uma Ligação de Consola ao IBM i.
A tarefa Interface de Gestão de Hardware requer uma interface de gestão de hardware configurada. Pode introduzir até seis configurações de interface de gestão de hardware.
Quando tiver concluído, seleccione Fechar no painel de Configurações do Sistema.
Utilizando a caixa de lista pendente do Sistema no painel principal do IBM i Access Client Solutions, seleccione um Sistema. Todas as tarefas de Consola associam automaticamente o Sistema seleccionado (introduzido no separador Geral) à configuração da consola (introduzida no separador Consola).
Pode, agora, seleccionar um tarefa para o sistema seleccionado. Se seleccionar uma tarefa da Consola para a qual não foram introduzidas as informações correspondentes no separador de configuração da Consola, é apresentada uma mensagem de erro.
Por predefinição, cada utilizador terá a sua localização exclusiva para a respectiva configuração. O directório raiz de configuração é determinado de uma maneira dependente da plataforma. Os directórios de configuração são criados durante o arranque inicial. Para visualizar onde se encontra o directório da configuração:
Inicie o produto (consulte a secção 7.0 Iniciar o Produto)
Editar->Preferências
Seleccione o separador Definições Locais
Raiz de Configuração
A localização da configuração não pode ser alterada enquanto o produto está a executar. Para alterar a localização da configuração, consulte a secção 9.3 Alterar a Localização da Configuração
Muitas das funções disponíveis a partir da interface gráfica do utilizador principal também se encontram disponíveis a partir da linha de comandos. Estas funções poderão ser invocadas através do fornecimento dos parâmetros apropriados a qualquer uma das opções da linha de comandos demonstradas na:
secção 7.3 Iniciar o Produto (utilizando a linha de comandos)
Por exemplo:
Start_Programs\Windows_x86-64\acslaunch_win-64.exe parm1 parm2 ...
Apenas os parâmetros adicionais são apresentados nas seguintes secções:
/PLUGIN=backup [/file=<nomeficheiro>] <nomeficheiro> é o nome do ficheiro a ser criado
Isto guardará a configuração actual para o ficheiro especificado. O ficheiro resultante pode ser utilizado como entrada para a opção de linha de comandos Restaurar na mesma ou em diferentes estações de trabalho (independentemente do sistema operativo).
A localização da configuração a ser guardada é determinada pela propriedade:
com.ibm.iaccess.AcsBaseDirectory...que se encontra no ficheiro AcsConfig.properties.
Esta função é equivalente a Ficheiro->Exportar Configuração a partir da interface gráfica do utilizador principal.
/PLUGIN=restore /file=<nomeficheiro> <nomeficheiro> é a localização do ficheiro criado pela Cópia de SegurançaVai restaurar uma configuração guardada do ficheiro especificado. Qualquer configuração existente que não esteja no ficheiro especificado perder-se-á.
A localização da configuração restaurada é determinada pela propriedade:
com.ibm.iaccess.AcsBaseDirectory...que se encontra no ficheiro AcsConfig.properties.
Esta função é equivalente a Ficheiro->Importar Configuração a partir da interface gráfica do utilizador principal.
Nota:
Para evitar ter que importar o nome de utilizador predefinido especificado no separador Ligação de uma Configuração de Sistema,
coloque a seguinte propriedade no ficheiro AcsConfig.properties.
com.ibm.iaccess.ResetDefaultUserOnImport=true
/PLUGIN=certdl /SYSTEM=<sistema>Descarrega uma entidade certificadora (CA, certificate authority) do sistema IBM i especificado e armazena-a no arquivo fidedigno local do utilizador. É algo obrigatório para a autenticação do servidor com SS.L
/PLUGIN=cfg /GUI /GUI - esta opção iniciará a GUI de Configurações do Sistema É equivalente a iniciar as Configurações do Sistema a partir da GUI principal. Nota: Ao definir com.ibm.iaccess.CfgActionsRestricted=true no AcsConfig.properties ocultará os botões Novo/Editar/Copiar/Eliminar no painel de Configurações do Sistema. /PLUGIN=cfg /LIST /LIST - lista os sistemas configurados com as respectivas opções de ligação /PLUGIN=cfg /SYSTEM=<sistema> [/ipaddr=<frequência>] [/userid=<idutilizador>] [/ssl=<comutador>] [/5250path=<caminho>] [/del] [/r] /SYSTEM - nome do sistema /ipaddr - quando uma ligação é solicitada, este valor determina se irá ocorrer uma procura do endereço de IP. As frequências válidas são: ALWAYS - procurar o endereço de IP para cada ligação HOURLY, DAILY, WEEKLY - procurar o endereço de IP se a quantidade de tempo tiver decorrido desde a última procura Endereço de IP - se um endereço de IP for especificado, a frequência da procura é assumida como sendo NEVER /userid - ID de utilizador para um utilizador também poderá ser definido para os seguintes valores: *SHARE - pede uma vez as credenciais de início de sessão que que serão partilhadas por sistemas que utilizam esta opção. *PROMPTALWAYS - perguntar pelo menos uma vez para cada ligação *KERBEROS - utilize o nome primário de Kerberos, sem pedir informações /ssl - comutador é 0 para desligar o modo SSL ou 1 para o ligar /5250path - caminho para os perfis de emulação 5250 O /5250path poderá ser definido por Ficheiro->Alterar Directório... de Gestor de sessões 5250 /del elimina configuração existente /r substitui a configuração existenteIsto permite várias opções de configuração a serem definidas a partir da linha de comandos. Estas opções podem também ser definidas a partir do GUI principal utilizando Configurações do sistema.
/PLUGIN=dump [/<opções>]Pede a todos os processos em execução no produto para fazer cópia da memória das respectivas sessões. Estas informações são utilizadas por serviços IBM para fornecer suporte técnico.
É possível aceder aos registos criados a partir da interface gráfica do utilizador principal através de:
Editar->Preferências
Separador Definições Locais
Directório Cópias de Memória
Caso não sejam especificadas opções, esta função é equivalente à seguinte função da interface gráfica do utilizador principal:
Ferramentas->Criar Registos de Serviço
As opções válidas são:
/heapdump - executa o procedimento acima mencionado e ainda uma cópia de memória da pilha JVM
/PLUGIN=medicEmpacota os registos existentes e cópias de memória do módulo num ficheiro .zip que pode ser enviado para a IBM para assistência.
É possível aceder ao ficheiro .zip resultante a partir da interface gráfica do utilizador principal através de:
Editar-Preferências
Separador Definições Locais
Directório Service
Esta função é equivalente a Ferramentas->Registos de Serviço do Pacote a partir da interface gráfica do utilizador principal.
/PLUGIN=log /LEVEL=<Nível> <Nível> é um dos seguintes: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINESTEste suplemento permite ao utilizador comutar o nível de registo a partir da linha de comandos.
Também é possível definir o nível de registo a partir da interface gráfica do utilizador principal através de:
Editar->Preferências
Separador Geral
Nível de Registo
/PLUGIN=início de sessão /SYSTEM=<sistema> [/USERID=<IDutilizador>] [/PASSWORD=<palavra-passe>] [/AUTH] [/C] [/GUI=<1|0>] /SYSTEM - nome do sistema /USERID - ID do utilizador /PASSWORD - palavra-passe associada ao ID do utilizador /AUTH - tenta ligar-se ao sistema com credenciais de início de sessão especificadas e apenas as coloca em cache em caso de êxito /C - limpa a cache /GUI - se pode ou não, ser utilizada uma interface gráfica do utilizadorEste comando vai colocar na cache a palavra-passe e o ID de utilizador que podem ser utilizados para impedir o pedido de palavra-passe.
/PLUGIN=propsAbre o mesmo painel da interface gráfica do utilizador que Editar->Preferências da interface gráfica do utilizador principal.
/PLUGIN=maint [/<opções>] As opções válidas são: /killdaemon - termina módulos daemon. O mesmo que Ferramentas->Repor para Manutenção a partir da GUI principal Ao definir com.ibm.iaccess.ResetForMaintenanceOnExit=true no AcsConfig.properties chamará /killdaemon quando o Access Client Solutions terminar. /clearpwcaches - limpa todas as palavras-passe em cache /clearjarcache - limpa a cache do ficheiro JAR do produto /clearlogs - limpa o Directório Registos em Editar->Preferências Separador Definições Locais a partir da interface gráfica do utilizador principal /cleardumps - limpa o Directório Cópias de Memória em Editar->Preferências Separador Definições Locais a partir da interface gráfica do utilizador principal /clearsvcdir - limpa o Directório Serviço em Editar->Preferências Separador Definições Locais a partir da interface gráfica do utilizador principal /clearsettings - limpa todas as definições para o utilizador actualCaso não sejam especificadas opções, não são efectuadas quaisquer acções.
/PLUGIN=ping /SYSTEM=<sistema> [</opções>] As opções incluem: /SSL=<1|0> Ligar ou desligar SSL /ACCEPTALLCERTS=<1|0> Adicionar ou não automaticamente todos os certificados de SSL ao conjunto fidedigno (quando utilizar SSL). /SERVERAUTH=<1|0> Ligar ou desligar a autenticação do Servidor SSL (a predefinição é desligado). Esta opção é ignorada se não testar o SSL. /GUI=<1|0> Alternar a janela GUI entre ligada/desligada (a predefinição é desligado caso seja iniciada a partir da linha de comandos) /PORTS=<port1,port2> Uma lista separada por vírgulas de portas a testar. Poderão ser números ou nomes de serviços (por exemplo /PORTS=as-signon,as-sts). Caso não seja especificada, é testado um conjunto predefinido de portas. Especificar .CONSOLE irá verificar uma lista de portas específicas da consola. /TIMEOUT=<segundos> Especifique um valor de tempo de espera, em segundos.Este suplemento verifica a conectividade ao IBM i estabelecendo uma ligação à porta adequada. Se está a verificar uma ligação SSL, há uma tentativa de (protocolo de) reconhecimento SSL. Se for iniciado a partir de uma interface gráfica de utilizador principal ou invocado com /GUI=1, este suplemento mostra um diálogo. Se iniciado de uma linha de comandos sem /GUI=1, o resultado é enviado para a consola.
Para não SSL, os seguintes serviços e portas são verificados:
sshd 22 telnet 23 drda 446 as-svrmap 449 as-nav 2004 as-central 8470 as-database 8471 as-dtaq 8472 as-file 8473 as-netprt 8474 as-rmtcmd 8475 as-signon 8476
Para SSL, os seguintes serviços e portas são verificados:
sshd 22 telnet-ssl 992 ddm-ssl 448 as-svrmap 449 as-nav 2005 as-central-s 9470 as-database-s 9471 as-dtaq-s 9472 as-file-s 9473 as-netprt-s 9474 as-rmtcmd-s 9475 as-signon-s 9476
Esta função pode ser iniciada a partir da interface gráfica do utilizador principal através de:
Configurações do Sistema
seleccione um sistema e, em seguida, Editar
Separador Geral
Verificar Ligação
/PLUGIN=smEste suplemento inicia a GUI do Gestor de Sessões 5250.
É equivalente ao Gestor de Sessões 5250 da GUI principal.
/PLUGIN=5250 /SYSTEM=<system> [/<opções>] Este suplemento inicia um emulador 5250 com o sistema especificado. Esta função é equivalente ao Emulador 5250 da GUI principal. As opções válidas são: /id=<A-Z> - ID de sessão curta /name=<name> - nome da sessão /wsid=<identifier> - id da estação de trabalho /wide=<1|0|true|false> - utilize um tamanho de ecrã largo (27x132) /fullscreen<1|0|true|false> - utilize o ecrã completo /nosave=<1|0|true|false> - não guardar definições ao sair /prompt=<1|0|true|false> - forçar o diálogo de configuração a aparecer /port=<port> - número de porta /ssl=<1|0|true|false> - ligar através da utilização de secure sockets /sso=<1|0|true|false> - ignorar ecrã de início de sessão /kerberos - Utilizar Kerberos /width=<width> - largura inicial da janela do emulador /height=<height> - altura inicial da janela do emulador /xpos=<xpos> - posição da coordenada X inicial do canto superior esquerdo da janela do emulador /ypos=<ypos> - posição da coordenada Y inicial do canto superior esquerdo da janela do emulador /watermark - apresentar o nome do sistema como marca d'água no ecrã /watermark=<text> - apresentar o texto facultado como marca d'água no ecrã
/PLUGIN=dtgui Este suplemento inicia a GUI principal para a Transferência de Dados. Esta função é equivalente à Transferência de Dados a partir do GUI principal.
/PLUGIN=download [/userid=<idutilizador>] <filename> [<nomeficheiro> <nomeficheiro> ...] /userid - ID de utilizador a utilizar aquando da ligação ao sistema de destino <filename>- ficheiro com a extensão .dtfx criado a partir de um descarregamento da Transferência de Dados anterior.O suplemento permite ao utilizador executar um descarregamento de Transferência de Dados guardado anteriormente.
A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados.
/PLUGIN=upload [/userid=<idutilizador>] <filename> [<nomeficheiro> <nomeficheiro> ...] /userid - ID de utilizador a utilizar aquando da ligação ao sistema de destino <filename>- ficheiro com a extensão .dttx criado a partir de um carregamento da Transferência de Dados anterior.O suplemento permite ao utilizador executar um descarregamento de Transferência de Dados guardado anteriormente.
A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados.
/PLUGIN=cldownload /system=<sistema> [/userid=<idutilizador>] {/hostfile=<biblioteca/nomeficheiro> | /sql="statement"} {/clientfile=<caminho><nomeficheiro>.<extensão> | /display} [/<opções>] /userid - ID de utilizador a utilizar aquando da ligação ao sistema de destino /hostfile - Biblioteca e ficheiro de origem no sistema IBM i para o descarregamento por exemplo /hostfile=QIWS/QCUSTCDT /sql - especificar uma instrução SQL por exemplo /sql="select CUSNUM,LSTNAM,INIT,ZIPCOD from QIWS/QCUSTCDT" /clientfile - Localização do ficheiro de destino para o descarregamento O formato deste ficheiro será determinado pela extensão especificada (por exemplo, .csv .ods .xlsx .xlsx) Se a extensão do ficheiro não for especificada ou for de um tipo não suportado, os dados serão formatados como um ficheiro .csv /display - escrever a saída de dados para o terminal As opções válidas são: /colheadings=<1/0> - Incluir títulos de colunas como a primeira linha. Quando especificado, os nomes das colunas serão o título. /usecollabels - Utilizar etiquetas de colunas para o título.O suplemento permite ao utilizador executar uma simples transferência de um ficheiro inteiro a partir da linha de comandos.
/PLUGIN=console /SYSTEM=<sistema>Este suplemento inicia uma consola 5250 com o sistema especificado.
Esta função é equivalente a uma Consola 5250 a partir do GUI principal.
/PLUGIN=vcp /SYSTEM=<sistema>Este suplemento inicia um Painel de Controlo Virtual para o sistema especificado.
Esta função é equivalente a um Painel de Controlo Virtual a partir do GUI principal.
/PLUGIN=l1c /SYSTEM=<sistema>Este suplemento inicia um navegador para o IBM Navigator for i utilizando o sistema especificado e a porta 2001.
Esta função é equivalente ao Navigator for i a partir do GUI principal.
/PLUGIN=splf /SYSTEM=<sistema>Este suplemento apresenta a GUI da Saída da Impressora para visualizar e transferir ficheiros em spool a partir do IBM i.
Esta função é equivalente à Saída da Impressora a partir do GUI principal.
/PLUGIN=keymanEste suplemento apresenta a ferramenta Gestão de Chaves.
Esta função é equivalente a Ferramentas->Gestão de Chaves a partir da interface gráfica do utilizador principal.
/PLUGIN=rmtcmd /SYSTEM=<sistema> {/CMD="<comando CL>" | file=<nome_ficheiro>} [/noprompt=<1|0>] [/immed=<0|1>] /cmd="<comando CL>" - um comando a executar. Utilize plicas para evitar espaços da quebra do comando. /file=<nome_ficheiro> - especifique um ficheiro de entrada com vários comandos. Os comandos deverão ser apresentados um por linha sem plicas. /noprompt=<1|0> - ao especificar um ficheiro de entrada, ignore os resultados e quaisquer pedidos de confirmação antes de prosseguir. /immed=<0|1> - enviar cada comando à medida que é lido.Este suplemento envia comando(s) CL para o sistema especificado.
Esta função apenas está disponível a partir da linha de comandos.
/PLUGIN=pwchange /SYSTEMS=<sistema,sistema,sistema,...>Este suplemento altera a palavra-passe nos sistemas especificados. Pede um ID de utilizador, palavra-passe nova e palavra-passe antiga ao utilizador.
Também é possível utilizar esta função a partir da interface gráfica do utilizador principal através da selecção do separador Palavras-Passe a partir de Editar->Preferências
/PLUGIN=migrate /<opção> /SYSTEM=<sistema> <sistema> poderá ser definido para um nome de sistema ou definido para *ALL para indicar todos os sistemas. As opções válidas são: /IMPORT - Copiar uma (ou todas) a(s) configuração(ões) do sistema da configuração do Windows já existente para o IBM i Access Client Solutions. /EXPORT - Copiar uma (ou todas) a(s) configuração(ões) do sistema para a configuração do Windows já existente a partir do IBM i Access Client Solutions. /DELETE - Eliminar uma (ou todas) a(s) configuração(ões) do sistema da configuração do Windows já existente.Este suplemento faculta a capacidade de copiar configurações do sistema alternadamente entre o IBM i Access Client Solutions e a configuração do Windows já existente, suportada pelo IBM i Access for Windows.
Também é possível utilizar esta função a partir da interface gráfica do utilizador principal através da selecção de Ficheiro->Copiar Ligações
/PLUGIN=restrict /<opções> As opções válidas são: /restrict=<func1,func2,func3> Restringe as funções facultadas nesta estação de trabalho. /unrestrict=<func1,func2,func3> Permite as funções facultadas nesta estação de trabalho. /list Lista se as funções têm permissão ou se são restringidas nesta estação de trabalho. /export=<ficheiro> Exportar restrições para o ficheiro denominado com uma extensão de ficheiro .acsr. /import=<ficheiro>.acsr Importar restrições de um ficheiro com uma extensão de ficheiro .acsr. /exportreg=<ficheiro> Exportar um ficheiro de registo do Windows (ficheiro .reg).
Este suplemento fornece a capacidade a qualquer utilizador com autoridade de administrador ou root de restringir certas funções de todos os utilizadores na estação de trabalho actual.
Função Descrição 5250 Emulador 5250 cfg Configurações do Sistema checkupdates Verificar se existem actualizações disponíveis cldownload Descarregamentos de linha de comandos de transferência de dados console Consola 5250 consoleprobe Procurar configurações de consola na rede local db2 Esquemas db2tools Centro de Desempenho de SQL download Descarregamentos de linha de comandos de transferência de dados dtgui Interface gráfica do utilizador da Transferência de Dados hmcprobe Procurar uma HMC por partições ifs Sistema de Ficheiros Integrados installupdates Instalar actualizações a partir de uma localização configurada do IBM i keyman Gestão de certificados SSL/TLS l1c IBM Navigator for i (Consola de Nível 1) osssetup Gestão de Pacotes de Código Aberto restrictview Restringir vista de funções restritas actualmente rmtcmd Comando remoto (disponível a partir da linha de comandos) rss Executar Scripts de SQL sm Gestor de Sessões 5250 splf Saída da Impressora (ficheiros em spool) ssh Secure Shell sysdbg IBM i System Debugger upload Carregamentos de linha de comandos de transferência de dados vcp Painel de Controlo Virtual Interfaces de Gestão de Hardware: hmi1 Interface de Gestão de Hardware 1 hmi2 Interface de Gestão de Hardware 2 asmi Interface de Gestão de Sistemas Avançada (Advanced System Management Interface, ASMI) csmi Copy Services Manager for i dcm Gestor de Certificados Digitais dshmc DS HMC hmc Consola de Gestão de Hardware (HMC) httpadmin Web (HTTP) Administration for i ivm Gestor de Virtualização Integrada specctrl Spectrum Control tapemgmt1 Gestão de Bandas 1 tapemgmt2 Gestão de Bandas 2 are Administration Runtime Expert db2webquery Db2 Web Query
As funções também podem ser excluídas como um grupos através das palavras-chave:
Grupo Funções dataxfer dtgui,upload,download,cldownload emulator sm,5250 keyman keyman opconsole console,vcp,consoleprobe,hmcprobe rmtcmd rmtcmd splf splf ifs ifs hwconsole hmi1,hmi2,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery l1cplugin l1c database db2,rss,db2tools debugger sysdbgA capacidade para restringir funções também está disponível para um administrador ou utilizador com autoridade root a partir da GUI principal.
Para uma forma mais fácil para restringir funções em múltiplas estações de trabalho, consulte a secção 9.5 Pacotes Personalizados.
/PLUGIN=restrictviewLista as funções que estão actualmente restringidas nesta estação de trabalho.
/PLUGIN=fileassoc [<tipoficheiro> <tipoficheiro> ...] [/c] <filetype> - os tipos de ficheiro válidos são; dttx, dtfx, hod, bchx, ws, bch, sql /c - limpa a associação de ficheiro para os tipos de ficheiro especificadosNuma plataforma Windows, isto define as associações de ficheiros para ficheiros do tipo .dttx, .dtfx, .hod, .bchx, .ws, .bch e .sql. Numa plataforma não-Windows, é apresentada uma mensagem de erro.
Esta função é equivalente a Ferramentas->Associações de Ficheiros a partir da interface gráfica do utilizador principal.
/PLUGIN=dtbatch [/userid=<idutilizador>] <filename> [<nomeficheiro> <nomeficheiro> ...] /userid - ID de utilizador a utilizar aquando da ligação ao sistema de destino <nomeficheiro>- ficheiro com a extensão .dtfx ou .dttx criado a partir de um descarregamento ou carregamento da Transferência de dados anterior. Podem ser especificados múltiplos ficheiros com ou sem esta palavra-chave.O suplemento permite ao utilizador executar um descarregamento de Transferência de Dados guardado anteriormente.
A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados.
/PLUGIN=pm5250 [/input=<ficheiro> ... /output=<directório>] [/verbose] [/gui] /input - Ficheiros a migrar. Os ficheiros têm de ser ficheiros 5250 com uma extensão de .ws, .bch, .kmp, .pmp ou .bar. /output - localização onde os ficheiros migrados serão armazenados. /verbose - apresenta resultados de ficheiros migrados. /gui - inicia a interface de utilizador para migrar ficheiros 5250.O suplemento permite que o utilizador migre ficheiros do emulador do IBM i Access for Windows Personal Communications para o emulador do IBM i Access Client Solutions. Alguns ficheiros convertidos terão uma nova extensão de ficheiro. Consulte a secção 9.6.2 Migrar Emulação 5250.
/PLUGIN=rss /SYSTEM=<system> /DATABASE=<database> [/FILE=<file>] [/SQL=<file>] [/AUTORUN=<0,1>] /FILE=<filename> - Abre o ficheiro especificado /SQL=<sql> - Iniciar com o SQL especificado /AUTORUN=<1,0> - Executa o script automaticamenteO suplemento permite ao utilizador executar instruções de SQL e comandos de CL.
/PLUGIN=DB2TOOLS /SYSTEM=<system> /DATABASE=<database> [Options] As opções válidas são: /ACTION=<LIST | ANALYZE | STATEMENTS | COMPARE> - Acção a executar: A opção LIST pode ser utilizada com o argumento LISTNAME e apresenta o Centro de Desempenho de SQL com a lista especificada. A opção ANALYZE analisa o conjunto de dados de desempenho facultado. A opção STATEMENTS mostra as instruções para a cache de plano de SQL ou o dado conjunto de dados de desempenho. A opção COMPARE compara o(s) dado(s) conjunto(s) de dados de desempenho. /NAME=<name> - O nome do conjunto de dados de desempenho /TABLE=<name> - O nome da tabela que contém os dados de desempenho /SCHEMA=<name> - O nome do esquema da tabela que contém dados de desempenho /LISTNAME=<DBMONITORS | PCEVENTMONITORS | PCSNAPSHOTS | LIVE_PLAN_CACHE> - A lista inicial a apresentar no Centro de Desempenho de SQL.O suplemento do Centro de Desempenho de SQL faculta um conjunto de ferramentas para ajudar a optimizar o SQL nas aplicações da base de dados:
/PLUGIN=ifs /SYSTEM=<system>O Sistema de Ficheiros Integrado fornece uma interface para procurar o Sistema de Ficheiros Integrado do IBM i e trabalhar com os objectos no Sistema de Ficheiros Integrado das seguintes maneiras:
/PLUGIN=DB2 /SYSTEM=<system>Este suplemento faculta uma interface para gerir as bases de dados Db2 for i no IBM i.
/PLUGIN=checkupdatesO suplemento fornece uma interface para verificar se existem actualizações disponíveis.
/PLUGIN=SSH /SYSTEM=<system>O Terminal SSH iniciará um cliente SSH já instalado (emulador de terminal) no seu PC para o Sistema de Ficheiros Integrado do IBM i.
/PLUGIN=OSSSETUPO OSSSETUP iniciará uma interface que lhe permitirá gerir pacotes de código aberto no IBM i.
/PLUGIN=installupdates [Opções] As opções válidas são: /noprompt Não pedir ID de utilizador e palavra-passe Nota: Quando utilizar esta opção, caso as credenciais do utilizador para o sistema remoto já se encontrem na memória cache, a procura de actualizações disponíveis irá continuar normalmente. Caso as credenciais do utilizador não se encontrem na memória cache, a autorização para o sistema remoto será recusada e as actualizações não serão disponibilizadas.INSTALLUPDATES irá procurar no sistema IBM i configurado por actualizações disponíveis e irá descarregar e instalar a actualização automaticamente para a instalação do PC local. Para configurar uma localização do IBM i para descarregar actualizações, consulte a secção 5.2.
/PLUGIN=httpproxyuiHTTPPROXYUI irá iniciar uma proxy HTTP protegida que activa a conectividade de um IBM i para a Internet através do computador que executa esta proxy. O acesso à Internet será activado a partir de qualquer sessão do Terminal SSH que introduzir os comandos fornecidos pelo suplemento HTTPPROXYUI.
/udcnv [/wide] /wide Esta opção apenas é válida com a página de códigos 932. Quando especificada, o ficheiro de imagem de tipos de letra produzir irá conter caracteres Unicode.Invocação de exemplo:
Start_Programs\Windows_x86-64\acslaunch_win-64.exe /udcnvEsta opção de linha de comandos destina-se a criar um ficheiro de imagem de tipos de letra que contém Caracteres Definidos pelo Utilizador (UDC, User Defined Characters) que se encontram actualmente configurados numa estação de trabalho Windows. O ficheiro de imagem de tipos de letra será uma página de códigos ANSI baseada no locale da estação de trabalho. São suportadas as seguintes páginas de códigos ANSI:
Página de Códigos Plataforma Nome do ficheiro de imagem de tipos de letra 932 Windows Japonês jpn24.fnt 949 Windows Coreano kor24.fnt 936 Windows Chinês Simplificado chs24.fnt 950 Windows Chinês Tradicional cht24.fntÉ possível utilizar o ficheiro de imagem de tipos de letra criado com a emulação de impressora 5250 em combinação com uma Tabela de Definições de Impressora (PDT, Printer Definition Table) numa estação de trabalho Windows. O comando irá iniciar uma interface gráfica do utilizador que permitirá especificar o caminho no qual deverá colocar o ficheiro de imagem de tipos de letra criado. O ficheiro de imagem de tipos de letra tem de possuir o nome especificado acima e ser colocado na pasta Emulator\fonts que existe em:
<Raiz de Configuração>\Emulator\fontsOnde <Raiz de Configuração> é normalmente um caminho como:
C:\Users\<nome_utilizador>\Documents\IBM\iAccessClientPara localizar a Raiz de Configuração efectiva para a instalação, consulte a secção 8.1 Localização da Configuração.
Limitações:
Alguns ficheiros de configuração criados pelo IBM i Access Client Solutions são suportados a partir da linha de comandos quando são facultados como o primeiro e único parâmetro. Quando estes ficheiros com extensões do nome do ficheiro especificas são fornecidas como o primeiro parâmetro, o IBM i Access Client Solutions vai associar o ficheiro com a função a ser invocada e fornecer o ficheiro como entrada a essa função.
As seguintes extensões têm suporte de associação de ficheiros:
.dttx - pedido de carregamento da Transferência de Dados .dtfx - pedido de descarregamento da Transferência de Dados .hod - perfil da sessão do emulador 5250 .bchx - perfil de emulação de sessões múltiplas .ws - perfil da sessão do emulador 5250 (Personal Communications) .bch - perfil de emulação de sessões múltiplas (Personal Communications) .sql - ficheiro SQLExemplos da linha de comandos:
acslaunch_xxx dt_download_file.dtfx - executa a operação de descarregamento guardada acslaunch_xxx dt_upload_file.dttx - executa a operação de carregamento guardada acslaunch_xxx system_lp13ut20.hod - inicia uma sessão 5250 para o sistema...onde acslaunch_xxx é a sintaxe da linha de comandos para iniciar o produto. Consulte a secção 7.3 Iniciar o Produto (utilizando a linha de comandos).
Estas associações de ficheiro de linha de comandos suportadas permitem ao utilizado configurar manualmente associações de ficheiros específicos do sistema operativo (OS, operating system). Uma vez que associações de ficheiros são dependentes de plataformas, os passos necessários dependem do OS.
A razão pela qual pode considerar estabelecer associações de ficheiros para o OS é para ter a capacidade de fazer duplo clique num ficheiro (de um dos tipos de ficheiro suportados supracitados) para iniciar a função designada.As secções seguintes fornecem alguns exemplos sobre estabelecer associações de ficheiros para alguns sistemas operativos.
A função apropriada do IBM i Access Client Solution vai executar quando fizer duplo clique nos ficheiros deste tipo.
Siga os passos no Manual de Iniciação Rápida para Linux. Isto irá instalar a aplicação para /opt/ibm/iAccessClientSolutions. Também irá criar: /usr/share/applications/IBM i Access Client Solutions.desktop
Para criar um ícone para o produto no ambiente de trabalho, copie o ficheiro .desktop referido acima para a pasta Desktop. Poderá ser necessário ajustar as permissões de ficheiro no ambiente de trabalho de forma a ser executável.
Os passos requeridos para configurar associações de ficheiros dependerão na distribuição do Linux e no ambiente de trabalho que estão a ser utilizados. Regra geral, os passos requeridos vão ser semelhantes aos passos listados acima utilizados pelo Windows.
Para poder utilizar Associações de Ficheiros num Mac, o tipo de ficheiro tem de estar associado a uma aplicação. Siga os passos no Manual de Iniciação Rápida para Mac para que o IBM i Access Client Solutions seja uma aplicação instalada.
A função apropriada do IBM i Access Client Solution vai executar quando fizer duplo clique nos ficheiros deste tipo.
Utilize a aplicação Pré-Visualização para localizar a pasta Ícones dentro do directório do produto e utilize o Localizador para substituir o ícone em Obter Informações.
Por predefinição, cada utilizador terá a sua localização exclusiva para a respectiva configuração. É possível alterar a localização da configuração através da definição da propriedade:
com.ibm.iaccess.AcsBaseDirectory
Esta propriedade existe dentro do ficheiro AcsConfig.properties.
O ficheiro AcsConfig.properties existe em duas localizações quando o produto é enviado. Encontra-se no ficheiro acsbundle.jar. Por conveniência, é também fornecido no ficheiro .zip do produto e encontra-se no mesmo directório que o ficheiro acsbundle.jar quando o ficheiro .zip for descompactado.
Durante o iniciar, o produto apenas vai utilizar o primeiro ficheiro AcsConfig.properties que localizar. Primeiro verifica o directório onde se encontra o ficheiro acsbundle.jar. Caso AcsConfig.properties não seja localizado no mesmo directório que o ficheiro acsbundle.jar, utilizará o ficheiro AcsConfig.properties dentro do ficheiro acsbundle.jar.
Pode seleccionar por actualizar AcsConfig.properties em acsbundle.jar com um caminho de configuração personalizado. Se o fizer, certifique-se de que o directório onde se encontra o acsbundle.jar não contém um ficheiro AcsConfig.properties, caso contrário este será utilizado. Isto faculta a flexibilidade de poder distribuir a localização da configuração com o ficheiro acsbundle.jar enquanto faculta também a flexibilidade para o substituir.
São facultadas palavras-chave especiais que podem ser utilizadas quando definir o caminho da configuração. Quando as palavras-chave são utilizadas no caminho especificado, as palavras-chave são substituídas pelo texto ou caminho que definem. Apenas uma palavra-chave pode ser utilizada no caminho de configuração. As palavras-chave especiais e respectivos significados são:
{USER} - O ID do utilizador actual. Esta palavra-chave poderá situar-se em qualquer ponto no caminho
As seguintes palavras-chave apenas poderão situar-se no início do caminho especificado:
{PRODUCTDIR} - o caminho para o mesmo directório que acsbundle.jar {TEMPDIR} - o caminho para um directório temporário específico da plataforma {ROOT} - o caminho para a raiz do sistema de ficheiros {HOME} - o caminho para o directório inicial do utilizador {DEFAULT} - o caminho predefinido que o produto utilizaria normalmente
Nota Técnica:
Não recomendamos a partilha de uma configuração entre vários utilizadores.
Por exemplo, se X fosse uma unidade de rede partilhada, a seguinte definição poderia provocar resultados imprevisíveis:
com.ibm.iaccess.AcsBaseDirectory=X:/Shared_Network_drive/config_directory
Existem vários problemas com a partilha deste caminho de configuração por vários utilizadores:
Quando se partilha um caminho de configuração entre múltiplos utilizadores, deve ser utilizada a palavra-chave {USER} para evitar colisões com outros utilizadores. Será substituída pelo ID de utilizador do utilizador actual.
Quando definir o caminho de configuração, utilize uma barra ('/') em vez de uma barra invertida ('\') como separador de directórios. Isto irá funcionar em todos os sistemas operativos, incluindo o Windows.
Eis algumas configurações exemplo recomendadas:
Exemplo 1 - configuração local para o utilizador actual (predefinição):
com.ibm.iaccess.AcsBaseDirectory=Quando AcsBaseDirectory não está definido, a configuração tem por predefinição um caminho dependente da plataforma para o utilizador. Esta é a definição para o IBM i Access Client Solutions.
Exemplo 2 - configuração remota (ou local) exclusiva para cada utilizador:
com.ibm.iaccess.AcsBaseDirectory={ROOT}/config_directory/{USER}/A configuração é remota ou local com base na localização de {ROOT}.
Exemplo 3 - configuração remota (ou local) exclusiva para cada utilizador:
com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directory/{USER}/A configuração é remota ou local com base na localização de {PRODUCTDIR}.
Exemplo 4 - configuração local num suporte portátil (como uma unidade USB):
com.ibm.iaccess.AcsBaseDirectory={PRODUCTDIR}/config_directoryUma vez que o caminho para o suporte portátil irá variar dependendo do sistema onde está a ser utilizado, esta definição permite que a configuração seja relativa aos ficheiros do produto. Neste exemplo, a palavra-chave {USER} não foi especificada intencionalmente para que a configuração na unidade USB fosse utilizada pelo utilizador da unidade USB, independentemente do ID de utilizador.
Aqui podem ser encontradas outras opções de implementação que poderá querer ter em conta:
É possível utilizar as seguintes propriedades no ficheiro AcsConfig.properties para definir automaticamente uma configuração para novos utilizadores ou para actualizar uma configuração para utilizadores existentes:
com.ibm.iaccess.autoimport com.ibm.iaccess.autoimport.version
Seguem-se os passos necessários:
Funciona da seguinte forma:
A configuração guardada referenciada pela propriedade com.ibm.iaccess.autoimport é importada automaticamente quando o valor inteiro da propriedade com.ibm.iaccess.autoimport.version não corresponder ao último valor importado. Para além de facultar uma forma de definir uma configuração inicial e facultar actualizações a uma configuração existente, isto também faculta uma forma de retroceder uma configuração para uma configuração anterior. A configuração será actualizada sempre que houver uma disparidade entre o valor inteiro da propriedade de versão com a última versão que foi importada. Porém, enquanto uma configuração importada pode alterar a configuração para um sistema existente na configuração do utilizador, um sistema nunca será eliminado da configuração do utilizador.
É possível especificar o caminho para a propriedade com.ibm.iaccess.autoimport como um caminho absoluto, um URL ou com palavras-chave definidas na secção 9.3. Por exemplo:
com.ibm.iaccess.autoimport=C:/acs_bak.zip
com.ibm.iaccess.autoimport=file///C:/acs_bak.zip
com.ibm.iaccess.autoimport=http://your.company.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport=ftp://your.company.com/path/file/acs_bak.zip
com.ibm.iaccess.autoimport={PRODUCTDIR}/acs_bak.zip
É facultada flexibilidade adicional ao permitir que o ficheiro de configuração seja distribuído dentro de acsbundle.jar ou no mesmo directório que acsbundle.jar.
Para qualquer um dos casos, defina com.ibm.iaccess.autoimport com o nome do ficheiro sem um caminho precedente:
com.ibm.iaccess.autoimport=acs_bak.zip
Um valor especial de * é permitido para com.ibm.iaccess.autoimport.version:
com.ibm.iaccess.autoimport.version=*
Isto irá importar sempre a configuração independentemente de qualquer versão anterior.
Nota:
Para evitar ter que importar o nome de utilizador predefinido especificado no separador Ligação de uma Configuração de Sistema,
coloque a seguinte propriedade no ficheiro AcsConfig.properties.
com.ibm.iaccess.ResetDefaultUserOnImport=true
Alguns dos suplementos de linha de comandos que não requerem uma interface gráfica do utilizador podem ser utilizados de forma nativa no IBM i. Por exemplo, pode utilizar a Transferência de Dados para extrair as bases de dados para um tipo de ficheiro de folha de cálculo directamente no IBM i sem ser necessário descarregar dados para o PC.
Para o executar, pode extrair o ficheiro .zip do produto para qualquer local no Sistema de Ficheiros Integrados (IFS) do IBM i. Por exemplo, se extraiu o ficheiro .zip do produto para:
/home/AccessClientSolutionsE ainda tiver um pedido de descarregamento de Transferência de Dados guardado anteriormente que exista em:
/some_path/qcustcdt.dtfxPode executar o seguinte comando no IBM i:
QSH CMD('java -jar /home/AccessClientSolutions/acsbundle.jar /PLUGIN=dtbatch /some_path/qcustcdt.dtfx')
Nota:
Também existem PTFs do IBM i que extrairão os conteúdos do produto pelo utilizador num IBM i.
Consulte a secção 5.3 PTFs Opcionais do IBM i
O IBM i Access Client Solutions faculta aos administradores do sistema a capacidade
de restringir a utilização de funções específicas através da definição de uma das
seguintes duas propriedades no ficheiro AcsConfig.properties:
com.ibm.iaccess.ExcludeComps=<função, função,...> com.ibm.iaccess.IncludeComps=<função, função,...>
Ao definir com.ibm.iaccess.ExcludeComps desactivará as funções especificadas. Todas as outras funções serão activadas. Qualquer função especificada nesta propriedade não estará disponível a partir da GUI de ACS principal nem a partir da linha de comandos. As funções que podem ser especificadas nesta propriedade são listadas abaixo.
Ao definir com.ibm.iaccess.IncludeComps activará as funções especificadas. Todas as outras funções serão desactivadas. Qualquer função especificada nesta propriedade está disponível para utilização normal. As funções que podem ser especificadas nesta propriedade são listadas abaixo.
Função Descrição 5250 Emulador 5250 cfg Configurações do Sistema checkupdates Verificar se existem actualizações disponíveis cldownload Descarregamentos de linha de comandos de transferência de dados console Consola 5250 consoleprobe Procurar configurações de consola na rede local db2 Esquemas db2tools Centro de Desempenho de SQL download Descarregamentos de linha de comandos de transferência de dados dtgui Interface gráfica do utilizador da Transferência de Dados hmcprobe Procurar uma HMC por partições ifs Sistema de Ficheiros Integrados keyman Gestão de certificados SSL/TLS l1c IBM Navigator for i (Consola de Nível 1) osssetup Gestão de Pacotes de Código Aberto restrictview Restringir vista de funções restritas actualmente rmtcmd Comando remoto (disponível a partir da linha de comandos) rss Executar Scripts de SQL sm Gestor de Sessões 5250 splf Saída da Impressora (ficheiros em spool) ssh Secure Shell sysdbg IBM i System Debugger upload Carregamentos de linha de comandos de transferência de dados vcp Painel de Controlo Virtual Interfaces de Gestão de Hardware: hmi1 Interface de Gestão de Hardware 1 hmi2 Interface de Gestão de Hardware 2 asmi Interface de Gestão de Sistemas Avançada (Advanced System Management Interface, ASMI) csmi Copy Services Manager for i dcm Gestor de Certificados Digitais dshmc DS HMC hmc Consola de Gestão de Hardware (HMC) httpadmin Web (HTTP) Administration for i ivm Gestor de Virtualização Integrada specctrl Spectrum Control tapemgmt1 Gestão de Bandas 1 tapemgmt2 Gestão de Bandas 2 are Administration Runtime Expert db2webquery Db2 Web Query
As funções também podem ser especificadas como grupos através das seguintes palavras-chave:
Grupo Funções dataxfer dtgui,upload,download,cldownload emulator sm,5250 keyman keyman opconsole console,vcp,consoleprobe,hmcprobe rmtcmd rmtcmd splf splf ifs ifs hwconsole hmi1,hmi2,asmi,csmi,dcm,dshmc,hmc,httpadmin,ivm,specctrl,tapemgmt1,tapemgmt2,are,db2webquery l1cplugin l1c database db2,rss,db2tools debugger sysdbg
Normalmente estas propriedades não seriam utilizadas em conjunto. Caso sejam utilizadas em conjunto e for especificada uma função em ambas as propriedades, a função será desactivada.
Exemplo 1: Desactivará todas as funções associadas a OPCONSOLE,HWCONSOLE,L1CPLUGIN. Todas as outras funções na lista acima serão activadas.
com.ibm.iaccess.ExcludeComps=OPCONSOLE,HWCONSOLE,L1CPLUGIN
Exemplo 2: Activará descarregamentos de 5250 e de transferência de dados. Todas as outras funções na lista acima serão desactivadas.
com.ibm.iaccess.IncludeComps=5250,DOWNLOAD
Caso o administrador do sistema pretenda actualizar o ficheiro AcsConfig.properties dentro de acsbundle.jar antes de o implementar para os respectivos utilizadores, um exemplo de como executar esta acção é:
jar uvf acsbundle.jar AcsConfig.propertiesConsulte a secção 9.3 Alterar a Localização da Configuração para obter informações adicionais sobre a forma como o IBM i Access Client Solutions determina que ficheiro AcsConfig.properties utilizar.
Os ficheiros de configuração do IBM i Access Client Solutions não são compatíveis com as funções correspondentes no IBM i Access for Windows. O IBM i Access Client Solutions faculta um caminho de migração para vários itens chave, como é mencionado nas secções seguintes.
A função Copiar Ligações disponível a partir do menu da interface gráfica do utilizador principal em Ficheiro->Copiar Ligações faculta uma interface para copiar configurações do sistema entre o IBM i Access Client Solutions e a configuração do Windows já existente suportada pelo IBM i Access for Windows. Para obter informações adicionais, consulte a ajuda para o painel principal de Copiar Ligações. As configurações do sistema também podem ser migradas utilizando a linha de comandos. Consulte a secção 9.1.25 MIGRATE para obter informações adicionais.
É possível converter os ficheiros de emulação 5250 utilizados pelo emulador IBM i Access for Windows Personal Communications através da utilização do Gestor de Sessões 5250 no IBM i Access Client Solutions. É possível converter os seguintes tipos de ficheiros a partir de Personal Communications:
.ws - perfil do emulador .bch - ficheiro de comandos do emulador .kmp - ficheiro de personalização do teclado .pmp - ficheiros de sobreposição .bar - ficheiros de barra de menusOs ficheiros são convertidos para:
.hod - perfil do emulador .bchx - ficheiro de comandos do emulador .kmp - ficheiro de personalização do teclado .pmp - ficheiros de sobreposição .bar - ficheiros de barra de menusOs tipos de ficheiros .kmp, .pmp e .bar são utilizados por ambos os produtos. Contudo, os formatos não são compatíveis. Os ficheiros convertidos são criados num caminho específico do IBM i Access Client Solutions.
A conversão destes ficheiros pode ser iniciada a partir do menu do IBM i Access Client Solutions Session Manager ao:
Está disponível um utilitário de conversão de macros. A partir do Gestor de Sessões:
Ferramentas->Converter Macro...Nota Técnica:
A Transferência de Dados no IBM i Access Client Solutions faculta um assistente para converter ficheiros de pedidos de Transferência de Dados guardados criados pelo IBM i Access for Windows.
É possível converter os seguintes tipos de ficheiros a partir do IBM i Access for Windows:
.dtf - transferência de dados do IBM i .dtt - transferência de dados para o IBM iOs ficheiros são convertidos para:
.dtfx - transferência de dados do IBM i .dttx - transferência de dados para o IBM iO assistente de migração da Transferência de Dados não migra ficheiros .fdf. O novo tipo de ficheiro requerido pelo IBM i Access Client Solutions é do tipo .fdfx e pode ser gerado durante um descarregamento ou ao utilizar o Assistente de Criar Ficheiro.
O assistente de migração da Transferência de dados está disponível a partir do menu principal da Transferência de Dados através da selecção de Acções->Migração da Transferência de Dados
Para aplicações de 5250 que exploram EHLLAPI quando acedem ao emulador Personal Communications enviado com o IBM i Access for Windows, consulte o seguinte artigo KB para obter informações sobre a utilização de EHLLAPI com o IBM i Access Client Solutions:
http://www-01.ibm.com/support/docview.wss?uid=nas8N1010639
O IBM i Access Client Solutions tem suporte para Kerberos. Para utilizar Kerberos
quando ligar a um sistema:
É possível utilizar a propriedade com.ibm.iaccess.PC5250Compatibility para alterar o comportamento predefinido para o emulador ACS. É possível definir esta propriedade no ficheiro AcsConfig.properties com os seguintes valores:
allowNnAsFKeyHotspot - tratar pontos activos NN (por exemplo FNN, PFNN, FPNN) como pontos activos de teclas de função. allowHighlightBypassField - permitir o destaque de ignorar campos com ENTFLDATR. allowTypingInSignPosition - permitir que '-' ou ' ' sejam codificados na posição de sinal de um campo numérico de sinal. allowTransformSpecialCharsOnPaste - alterar como certos caracteres são convertidos quando colar texto de documentos externos (por exemplo, plicas curvas tornam-se plicas direitas).Exemplo 1:
com.ibm.iaccess.PC5250Compatibility=allowTransformSpecialCharsOnPasteExemplo 2: É possível especificar múltiplos valores numa lista separada por vírgulas.
com.ibm.iaccess.PC5250Compatibility=allowNnAsFKeyHotspot,allowHighlightBypassField,allowTypingInSignPosition
A gestão de certificados para ligações SSL (Secure Socket Layer) está disponível a partir da interface gráfica do utilizador principal através da selecção de Ferramentas->Gestão de Chaves. Algumas tarefas na Base de Dados de Chaves requerem a frase-passe de integridade do arquivo de chaves.
Para além de suportar descarregamentos para um Ficheiro, a Transferência de Dados também suporta descarregamentos para uma folha de cálculo activa para a folha de cálculo do Excel da Microsoft ou a folha de cálculo do Calc de OpenOffice. Para descarregar para uma folha de cálculo activa, o painel principal do GUI da Transferência de Dados faculta a opção para seleccionar um Dispositivo de Saída. Por predefinição, o Dispositivo de Saída é Ficheiro. Caso a plataforma suporte interacção com a folha de cálculo do Excel e/ou Calc, poderão ser seleccionadas opções adicionais para uma Folha de Cálculo do Excel Activa e uma Folha de Cálculo de Calc Activa a partir da caixa de lista pendente Dispositivo de Saída.
Restrições:
Durante um pedido de carregamento de Transferência de Dados, se um campo de caracteres ou numérico exceder o tamanho definido do campo, o pedido de carregamento irá terminar.
Para permitir que os campos de caracteres sejam truncados a partir do fim, defina a seguinte propriedade no ficheiro AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
Para permitir que os campos numéricos sejam definidos para os respectivos valores máximo
e mínimo quando o campo numérico fornecido exceder o limite definido, defina a
seguinte propriedade no ficheiro AcsConfig.properties:
com.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true
Quando estas propriedades são definidas para true, o pedido de carregamento irá continuar sem fornecer qualquer indicação de que ocorreu um truncamento ou um sobrecarregamento. Os campos de caracteres são truncados no fim. Os campos numéricos são definidos para o respectivo valor máximo para sobrecarregamentos e para o respectivo valor mínimo para ultrapassagem de capacidade por defeito.
Em alternativa, as propriedades acima podem ser definidas a partir da linha de comandos como outras propriedades Java da seguinte forma:
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowCharacterTruncation=true
-Dcom.ibm.iaccess.dataxfer.jdbc.AllowNumericOverflow=true
Durante as transferências, é gerado um nome de folha com base no nome do ficheiro e da biblioteca de origem do IBM i com o apêndice >Folha#" em que # é substituído pelo número de folha apropriado. Por exemplo:
qiws.qcustcdt>Folha1
Para substituir a porção do ficheiro e da biblioteca do nome da folha, poderá especificar a seguinte propriedade:
com.ibm.iaccess.dataxfer.SheetId=your_string
Isto irá gerar:
a_sua_cadeia>Folha1
Caso os valores especiais de %1$s %2$s ou %3$s sejam utilizados na propriedade, será possível alterar ou eliminar a colocação de library.filename e sheet#.
Os valores têm o seguinte significado:
%1$s - library.filename Por exemplo: qiws.qcustcdt
%2$s - sheet# Por exemplo: 1
%3$s - nome de ficheiro de destino sem extensão de ficheiro
A utilização de qualquer um destes valores especiais fornece controlo total sobre o nome da folha.
A definição da propriedade para Sheet%2$s irá produzir os nomes de folha: Sheet1, Sheet2, etc
com.ibm.iaccess.dataxfer.SheetId=Sheet%2$s
Poderá utilizar %1$s %2$s ou %3$s em qualquer combinação com outro texto.
Nota:
Uma vez que os nomes das folhas numa folha de cálculo têm de ser exclusivos, a definição da propriedade para utilizar %1$s ou %3$ sem utilizar também %2$s irá produzir um erro caso seja necessária mais do que uma folha.
Para executar funções administrativas no IBM i, é necessária uma consola 5250. O IBM i Access Client Solutions suporta configurações de consolas LAN e HMC.
Caso saiba o nome do sistema central de Serviço ou o endereço de IP do Serviço para o IBM i ou o nome do sistema central ou endereço de IP para a consola HMC, é possível configurar as informações da consola dentro do IBM i Access Client Solutions através dos seguintes passos:
Para um IBM i onde a configuração da consola ainda não existe (por exemplo um novo sistema acabado de ser entregue à empresa), um endereço de IP para uma ligação à consola é atribuído automaticamente no intervalo de 169.254.62.0 - 169.254.62.63 durante o IPL. Para estes casos, os seguintes passos ajudarão a estabelecer uma ligação à consola através do IBM i Access Client Solutions:
Quando estiver pronto para adicionar o sistema IBM i ao resto da infra-estrutura de rede, existem informações adicionais no IBM Knowledge Center sobre como configurar o Adaptador de LAN das Ferramentas de Serviço:
Consulte Configurar o servidor das ferramentas de serviço para DST.
Para sistemas IBM i que já têm uma configuração de consola LAN e já pertencem à infra-estrutura de rede, é possível utilizar os seguintes passos para localizar configurações de consola existentes:
É possível adicionar tipos de letra adicionais ao directório Tipos de Letra para emulação 5250.
Para facultar localizações alternativas e/ou múltiplas para tipos de letra adicionais, defina a propriedade com.ibm.iaccess.Fonts localizada no ficheiro AcsConfig.properties.
O directório Tipos de Letra predefinido poderá ser substituído através da definição da propriedade com.ibm.iaccess.Fonts para:
Nota:
O <caminho> poderá ser um caminho absoluto ou um caminho relativo a iniciar a partir da localização de acsbundle.jar. Apenas são reconhecidos pela emulação 5250 tipos de letra de largura fixa.
Exemplo 1 (predefinição):
com.ibm.iaccess.Fonts=FontsExemplo 2:
com.ibm.iaccess.Fonts=/Users/All/Fonts;Fonts
Para permitir a utilização de um ficheiro .netrc (Linux e Mac) ou de um ficheiro _netrc (Windows), aceda à interface gráfica do utilizador
principal do IBM i Access Client Solutions e, a partir da barra de menus, seleccione
Editar->Preferências
Separador Geral
Marque a caixa: Ler ficheiro netrc para obter informações de início de sessão
Faça clique no botão Aplicar
Reinicie o IBM i Access Client Solutions
O formato padrão de um ficheiro netrc é:
máquina <sistema> login <id-utilizador> password <palavra-passe>
O ficheiro netrc tem de ser armazenado no directório inicial do
utilizador e o nome do sistema e o ID de utilizador têm de
corresponder às Configurações de Sistema. A partir do IBM i Access Client Solutions:
Seleccione Configurações de Sistema
Seleccione e, em seguida, Edite o sistema
Separador Ligações
Seleccione Utilizar nome de utilizador predefinido para pedir uma vez por cada sistema
Preencha o ID de utilizador para o Nome de utilizador predefinido
Seleccione OK
Quando o nome do sistema e o Nome de utilizador predefinido corresponderem aos conteúdos do ficheiro netrc, é criada uma ligação ao sistema, utilizando a palavra-passe do ficheiro netrc sem pedir o utilizador.
O Suporte de Sistema de Ficheiros Integrados utiliza o sistema de ficheiros QFileSvr.400 para copiar ou enviar objectos de uma partição do IBM i para outra. Isto significa que o perfil de utilizador e a palavra-passe em ambas as partições precisam corresponder e as partições têm de ter o mesmo valor de sistema ao nível da palavra-passe (QPWDLVL). Se utilizar a autenticação de Kerberos, ambas as partições têm de ter o Serviço de Autenticação de Rede e o Mapeamento de Identidade Empresarial (EIM, Enterprise Identity Mapping) configurados. Para obter mais detalhes, consulte o tópico "Segurança e autoridade de objectos no sistema de ficheiros QFileSvr.400" no IBM i Knowledge Center.
As ligações para outras do IBM i efectuadas pelo sistema de ficheiros QFileSvr.400 não são seguras.
Caso seja necessária uma ligação segura quando copiar ou enviar
objectos de uma partição do IBM i para outra, a configuração
para a partição tem de ser configurada para utilizar SSL e as
Configurações de Sistema têm de ter a opção "Utilizar SSL para a
ligação" seleccionada para essa partição e tem de ser definida a
seguinte propriedade no ficheiro AcsConfig.properties:
com.ibm.iaccess.ifs.transferMechanism=ACS
Em alternativa, a propriedade pode ser definida a partir da linha de comandos como outras propriedades Java da seguinte forma:
-Dcom.ibm.iaccess.ifs.transferMechanism=ACS
O suporte do Sistema de Ficheiros Integrado requer autoridade para utilizar os seguintes comandos CL:
CPY CPYFRMSTMF CPYTOSTMF CRTDIR CRTLIB CRTSAVF RMVDIR RST SAV SETASPGRP
Se o utilizador não utilizar estes comandos CL, as acções de Copiar (Copy), Colar (Paste), Enviar (Send), Eliminar (Delete) e de Nova Pasta (New Folder) irão falhar.
O suporte de Sistema de Ficheiros Integrado não permite acções para objectos que tenham caminhos que sejam iniciados com /QFileSvr.400, /QNTC ou /QOPT. Se o caminho do directório actual ou qualquer caminho de objecto seleccionado inicia com /QFileSvr.400, /QNTC ou /QOPT, todos os itens no menu Acções serão desactivados e não será apresentado um menu contextual.
O suporte do Sistema de Ficheiros Integrados não permite a acção Copiar (Copy), Colar (Paste) ou Enviar (Send) quando o caminho de origem ou de destino do objecto está localizado numa ASP independente.
O desempenho de IFS quando apresentar o conteúdo de um directório é determinado pelos atributos de colunas seleccionados (Ver->Colunas...) e se o directório contém ligações simbólicas. Para ligações não simbólicas, existe um impacto no desempenho adicional quando seleccionar CCSID ou Owner. Para ligações simbólicas, existe um impacto no desempenho adicional para cada atributo de coluna seleccionado diferente de Icon, Name e Size (KB)
Nota: Size (KB) para ligações simbólicas não é apresentado quando procurar o directório. Seleccione Propriedades para obter o tamanho do ficheiro representado pela ligação simbólica.
Quando apresentar um directório com um grande número de entradas, poderá exceder o limite de memória predefinido da máquina Virtual de Java onde o IBM i Access Client Solutions se encontra em execução. Isto poderá fazer com que todas as janelas abertas abrandem e eventualmente parem de responder. Caso apresente directórios com um grande número de entradas, considere utilizar o filtro Incluir para limitar o número de entradas enviadas a partir do servidor. Ou inicie o produto com a opção -Xmx para aumentar a memória disponível. Por exemplo:
java -Xmx4g -jar V:/some_location/acsbundle.jar ou Start_Programs\Windows_x86-64\acslaunch_win-64.exe -Xmx4g
Os exemplos acima irão aumentar a memória da predefinição de 1 gigabyte para 4 gigabytes. Poderá ser necessário aumentar ainda mais o tamanho com base no número de entrada no directório.
Para plataformas onde existe uma Secure Shell por predefinição ou onde foi instalada, a funcionalidade de Terminal de SSH aparecerá na interface gráfica do utilizador principal do IBM i Access Client Solutions. O Terminal de SSH iniciará um emulador de terminal para o Sistema de Ficheiros Integrado do IBM i.
A maioria dos sistemas Mac, Linux e outros sistemas derivados de UNIX já possuem uma Secure Shell por predefinição. Para estas plataformas, assume-se que existe um cliente de OpenSSH e que está localizado em /usr/bin/ssh. Os utilizadores de Windows necessitarão de instalar uma das Secure Shells disponíveis para Windows.
Secure Shells suportadas pelo IBM i Access Client Solutions:
Linux: Xterm, XterminalEmulator, MateTerminal, Terminator, GnomeTerminal, Konsole, Xfce4
Mac: Terminal, iTerm2
Windows: cygwin, PuTTY, bash
cygwin necessita que o pacote de OpenSSH seja instaladao
bash está disponível como parte do subsistema Linux para Windows
Se existirem múltiplas aplicações de SSH instaladas, pode utilizar a propriedade com.ibm.iaccess.PreferredSSHClient para definir o cliente de SSH preferido.
Exemplos de Linux:
com.ibm.iaccess.PreferredSSHClient=XterminalEmulator
com.ibm.iaccess.PreferredSSHClient=MateTerminal
com.ibm.iaccess.PreferredSSHClient=Terminator
com.ibm.iaccess.PreferredSSHClient=GnomeTerminal
com.ibm.iaccess.PreferredSSHClient=Konsole
com.ibm.iaccess.PreferredSSHClient=Xfce4
Exemplos de Mac:
com.ibm.iaccess.PreferredSSHClient=iTerm2
Exemplos de Windows:
com.ibm.iaccess.PreferredSSHClient=Cygwin
com.ibm.iaccess.PreferredSSHClient=Putty
com.ibm.iaccess.PreferredSSHClient=Bash
Para os casos em que o cliente de SSH não está instalado na localização standard, pode utilizar a propriedade com.ibm.iaccess.PreferredSSHClient para disponibilizar o caminho completamente qualificado para o cliente de SSH instalado.
com.ibm.iaccess.PreferredSSHClient=C:\PuTTY\putty.exe
Quando caminho completamente qualificado é disponibilizado, também pode necessitar de definir com.ibm.iaccess.SSHClientOpt para disponibilizar todos os argumentos necessários. Por exemplo, para desactivar avisos se não utilizar o reencaminhamento X11:
com.ibm.iaccess.SSHClientOpts=-x
Se receber um erro de ligação no cliente SSH iniciado (por exemplo, "ligação recusada") ou se surgir uma janela, mas desaparecer imediatamente, pode necessitar de iniciar o daemon de SSH com o comando acima indicado.
Se encontrar um problema que requer a assistência da IBM, o técnico IBM poderá direccioná-lo para uma ou ambas as seguintes soluções:
A partir da interface gráfica do utilizador principal do IBM i Access Client Solutions:
Q1 Quando tento iniciar o IBM i Access Client Solutions obtenho o seguinte erro: não é possível carregar classe: java.lang.UnsupportedClassVersionError A1-1 É necessário utilizar JDK 8.0 ou superior. Consulte a secção 3.0 Pré-requisitos Q2 Quando tento iniciar o script utilizando um dos ficheiros binários facultados ou scripts a partir de uma sessão de interface ou terminal, obtenho o seguinte erro: Permissão recusada A2-1 Verifique as permissões de ficheiro do ficheiro para garantir que tem permissão de execução. Consulte a secção 6.0 Permissões de Ficheiros. P3 Quando faço duplo clique num dos ficheiros fornecidos para iniciar o produto, não acontece nada. A3-1 O Java poderá não estar instalado. Consulte a secção 3.0 Pré-requisitos A3-2 O ficheiro que está a utilizar para iniciar o produto poderá não ter permissão de execução. Consulte a secção 6.0 Permissões de Ficheiros. A3-3 Poderão existir problemas com o ambiente. Para visualizar que erros poderão estar a ocorrer, tente executar o ficheiro facultado a partir de uma linha de comandos. Consulte a secção 7.3 Iniciar o Produto (utilizando a linha de comandos). P4 Pretendo utilizar um dos ficheiros binários para iniciar o produto, mas obtenho o seguinte erro: "Erro ao carregar o módulo Java." R4-1 O binário não conseguia localizar o directório inicial da instalação java. Verifique se Java está instalado. Consulte a secção 3.0 Pré-requisitos. A4-2 A secção 7.1.1 Iniciar o Produto - Opções Adicionais contém métodos adicionais para iniciar o produto utilizando um ficheiro binário. P5 Depois de definir a variável do ambiente JAVA_HOME, o ficheiro binário que utilizo para iniciar o produto funciona a partir de uma linha de comandos, mas não funciona quando eu faço duplo clique no ficheiro. A5-1 A variável do ambiente JAVA_HOME poderá não ser visível a partir do gestor de ficheiros que está a utilizar quando faz duplo clique no ficheiro. A definição de variáveis do ambiente varia através de sistemas operativos, bem como a respectiva visibilidade. Tente definir a variável do ambiente JAVA_HOME como uma variável do ambiente do sistema para o sistema operativo. O sistema operativo poderá referir-se a variáveis do ambiente do sistema como variáveis do ambiente globais. Após definir a variável do ambiente JAVA_HOME, feche e reabra o gestor de ficheiros e tente fazer duplo clique sobre o ficheiro binário novamente. Q6 Quando faço duplo-clique num dos ficheiros facultados para iniciar o produto, um editor de texto apresenta o ficheiro. R6-1 Assegure-se de que está a utilizar um script que tem uma extensão do nome do ficheiro que o seu sistema operativo reconhece. R6-2 Experimente um dos outros scripts. R6-3 Altere o programa que abre o ficheiro. A6-4 Verifique as permissões do ficheiro para garantir que tem permissão de execução. Consulte a secção 6.0 Permissões de Ficheiros. P7 Quando faço duplo clique em um dos ficheiros fornecidos para iniciar o produto, perguntam-me qual o programa que deve ser utilizado para abrir o ficheiro. R7-1 Assegure-se de que está a utilizar um script que tem uma extensão do nome do ficheiro que o seu sistema operativo reconhece. A7-2 Defina o programa que abre o ficheiro para algo compatível com o ficheiro binário ou script que está a utilizar. Por exemplo, Terminal (em Mac). A7-3 Verifique as permissões de ficheiro do ficheiro para garantir que tem permissão de execução. Consulte a secção 6.0 Permissões de Ficheiros. P8 Quando inicio o IBM i Access Client Solutions num Mac a partir do Localizador, aparece uma sessão terminal e esta não desaparece mesmo após terminar o IBM i Access Client Solutions. R8-1 Para eliminar o aparecimento da sessão terminal, utilize os scripts de instalação para Mac no Manual de Iniciação Rápida. P9 Qual é a melhor maneira de iniciar o produto? A9-1 É possível iniciar o produto com qualquer um dos três métodos na secção 7.0 Iniciar o Produto utilizando os binários, scripts ou a linha de comandos. Qualquer método que funcione no ambiente é aceitável. P10 Por que razão existem tanto ficheiros binários (Start_Programs) e scripts (Sample_Scripts) para iniciar o produto? R10-1 Os scripts não são específicos de sistemas operativos e fornecem uma maneira mais genérica de iniciar o produto quando os ficheiros binários específicos para a plataforma não funcionam. R10-2 Alguns sistemas operativos requerem binários ao definir associações de ficheiros. Para a maioria dos casos, os ficheiros binários devem ser utilizados para iniciar o produto. A10-3 Alguns ambientes poderão ter firewalls que restringem o acesso a partes do IBM i Access Client Solutions. A utilização dos ficheiros binários para iniciar o produto facilitam o processo de autorização de acesso para os administradores de sistema. Q11 Após instalar JDK 8.0 (ou superior), continuo a obter o seguinte erro: não é possível carregar classe: java.lang.UnsupportedClassVersionError A11-1 A versão predefinida de Java a ser utilizada na estação de trabalho é anterior a JDK 8.0. Será necessário utilizar uma opção que especifica explicitamente o caminho para a página inicial de Java para JDK 8. Consulte a secção 7.1.2 Localizar o Caminho Inicial de Java. Utilize o caminho inicial de Java para um dos métodos descritos em qualquer uma das seguintes secções: 7.1.1 Iniciar o Produto - Opções Adicionais
7.3 Iniciar o Produto (utilizando a linha de comandos)
P12 Não consigo importar ficheiros de mapeamento de teclado personalizados (.kmp) a partir das minhas sessões de emulador 5250 do Windows. A12-1 Na versão inicial do IBM i Access Client Solutions que ficou disponível em Julho de 2012, a importação de ficheiros .kmp a partir de perfis de sessão do emulador 5250 do Windows (.ws) não era suportada. Desde a versão que foi disponibilizada em Outubro de 2012, a importação de ficheiros .kmp a partir de perfis de sessão 5250 (.ws) é agora suportada. Q13 A personalização do teclado para o emulador 5250 é muito diferente do que era no Windows. Têm alguma sugestão? A13-1 A definição do teclado está dividida em categorias. A partir de uma sessão do emulador: Faça clique em Editar > Preferências > Teclado ou faça clique no botão Redefinição na barra de ferramentas. Faça clique sobre o separador Atribuição de Tecla. Seleccione uma Categoria. As definições de teclas predefinidas aparecerão sob as categorias "Funções do Sistema Central" e "Comandos de Menu". Seleccione a função que pretende atribuir. Faça clique sobre Atribuir uma Tecla. No teclado, prima a tecla (ou combinação de teclas) que pretende atribuir a esta função. A13-2 Para obter ajuda sobre definições de teclas personalizadas: Faça clique em Editar > Preferências > Teclado ou faça clique no botão Redefinição na barra de ferramentas. Seleccione o botão Ajuda. P14 Quando tento iniciar o produto no Mac OS X 10.8 Mountain Lion, obtenho uma mensagem de diálogo que indica que a aplicação não está assinada. A14-1 Esta é uma política de segurança imposta por predefinição a começar com o Mac OS X 10.8 Mountain Lion. Consulte a seguinte página da Web para obter informações sobre como permitir que a aplicação seja executada: http://macperformanceguide.com/MountainLion-application-signing.html P15 Sou um utilizador do IBM i Access for Windows, posso migrar as minhas configurações do sistema para o IBM i Access Client Solutions? A15-1 Consulte a secção 9.6.1 Migrar Configurações de Sistema. P16 Sou um utilizador do IBM i Access for Windows, posso migrar os meus perfis de emulação para o IBM i Access Client Solutions? A16-1 Consulte a secção 9.6.2 Migrar Emulação 5250 P17 Sou um utilizador do IBM i Access for Windows, posso migrar os meus ficheiros de pedidos de Transferência de Dados para o IBM i Access Client Solutions? A17-1 Consulte a secção 9.6.3 Migrar Ficheiros de pedidos de Transferência de Dados Guardados. P18 O EHLLAPI funciona com o IBM i Access Client Solutions? A18-1 Consulte a secção 9.6.4 EHLLAPI P19 O kerberos funciona com o IBM i Access Client Solutions? A19-1 Consulte a secção 9.6.5 Kerberos P20 Sou um administrador de sistema e gostaria de ocultar certas funções dos meus utilizadores. A20-1 Consulte a secção 9.5 Pacotes Personalizados P21 Quando selecciona um ícone de ajuda num painel, não é apresentado nenhum texto. A21-1 O texto de ajuda é apresentado normalmente no navegador do ambiente de trabalho. Nalguns casos, o ambiente de trabalho poderá não ter um navegador ou poderá não estar correctamente configurado. A21-2 Para apresentar o texto de ajuda sem utilizar o navegador do ambiente de trabalho, defina a seguinte propriedade no ficheiro AcsConfig.properties: com.ibm.iaccess.javaAwtDesktopAllowed=false Em alternativa, é possível definir a propriedade a partir da linha de comandos como outras propriedades java conforme se segue: -Dcom.ibm.iaccess.javaAwtDesktopAllowed=false Q22 Ao utilizar a Transferência de Dados, selecciono um dispositivo de Saída de "Folha de Cálculo de Excel Activa" ou "Folha de Cálculo de Calc Activa" e obtenho o seguinte erro: "A Folha de Cálculo Activa não foi localizada" Q22-1 Não existe uma folha de cálculo activa. Abra uma folha de cálculo nova ou existente e tente o pedido de novo. Q22-2 Pode haver uma disparidade de número de bits entre a aplicação de folha de cálculo que está utilizar e a máquina Virtual Java que está a executar o IBM i Access Client Solutions. Consulte a secção 9.8 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc P23 Ao utilizar a Transferência de Dados num Mac, não vejo nenhuma opção no dispositivo de saída para interagir com uma folha de cálculo activa. Q23-1 A Transferência de Dados não consegue interagir com folhas de cálculo activas em Mac devido à disparidade de número de bits entre a aplicação OpenOffice e a JVM que executa o IBM i Access Client Solutions. Para obter detalhes adicionais, consulte a secção 9.8 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e Calc. P24 Ao utilizar a Transferência de Dados, selecciono um dispositivo de saída de "Folha de Cálculo de Calc Activa" e não aparece nada na caixa Nome. R24-1 Isto é normal para novas folhas de cálculo de Calc que nunca foram guardadas. A Transferência de Dados conseguirá actualizar na mesma a folha de cálculo com dados descarregados.
Consulte a seguinte página da Web:
IBM i Access Client Solutions (5733XJ1)