5733XJ1 IBM i Access Client Solutions Os conteúdos deste documento foram actualizados a: 6 de Maio, 2013 Conteúdos: 1.0 Apresentação 2.0 Funções 3.0 Pré-Requisitos 4.0 Conteúdos do Produto 5.0 Instalação 5.1 Actualizar uma Instalação Existente 6.0 Permissões de Ficheiros 6.1 Permissões de Ficheiros (Linux, Mac, AIX) 6.2 Permissões de Ficheiros (Windows) 7.0 Iniciar o Produto 7.1 Iniciar o Produto 7.2 Iniciar o Produto (utilizando um script) 7.3 Iniciar o Produto (utilizando a linha de comandos) 8.0 Configuração 8.1 Localização da Configuração 9.0 Tópicos Avançados 9.1 Mais Opções da linha de comandos 9.2 Associações de Ficheiros 9.3 Alterar a Localização da Configuração 9.4 Outras Opções de Implementação 9.5 Pacotes Personalizados 9.6 Migrar do IBM i Access for Windows 9.7 Gestão de Chaves 9.8 Suporte de Transferência de Dados para Folhas de Cálculo de Excel e de Calc 9.9 Estabelecer uma Ligação à Consola para o IBM i 10.0 Diagnósticos de Serviço 11.0 Perguntas Mais Frequentes (FAQ,Frequently Asked Questions) 12.0 Histórico de Actualizações 1.0 Introdução ---------------- O IBM i Access Client Solutions é o novo membro da família de produtos IBM i Access. Fornece uma interface independente de plataforma baseada em Java que executa na maioria dos sistemas operativos que suportam Java incluindo Linux, Mac e Windows. O IBM i Access Client Solutions consolida as tarefas mais comuns para gerir o seu sistema IBM i numa localização simplificada. O IBM i Access Client Solutions utiliza os mesmos servidores de sistemas centrais IBM i que os outros produtos IBM i Access Family e requer a mesma licença IBM i Access Family (XW1) para utilizar a emulação 5250 e componentes de Transferência de Dados. Estão também disponíveis dois pacotes opcionais que incluem middleware para utilizar e desenvolver aplicações de cliente para Windows e Linux: IBM i Access Client Solutions - Pacote de Aplicações do Windows IBM i Access Client Solutions - Pacote de Aplicações de Linux Os clientes que utilizam o IBM i 6.1 ou IBM i 7.1 podem adquirir o IBM i Access Client Solutions ao descarregar o mesmo do sítio da Web Entitled Software Support (ESS) sob 5761-SS1 ou 5770-SS1. Os clientes podem adquirir suportes ao encomendar a função de renovação 6288 de 5761-SS1 ou 5770-SS1. O suportes físico para o IBM i Access Client Solutions não contém os Pacotes de Aplicações do Windows e Linux opcionais. Estes pacotes apenas estão disponíveis a partir do sítio da Web Entitled Software Support (ESS). O suporte físico contém uma versão executável do produto que permite ao utilizador executar o produto directamente a partir do CD. O suporte físico também inclui um arquivo ZIP do produto que poderá ser copiado e extraído para uma localização à preferência do cliente. Para obter informações adicionais visite: http://www.ibm.com/systems/power/software/i/access/solutions.html Para obter as informações mais recentes sobre produto do IBM i Access Family visite: http://www.ibm.com/systems/i/software/access/caann.html 2.0 Componentes ------------ Componentes do IBM i Access Client Solutions incluem: - um emulador de terminal 5250 com todas as funcionalidades baseado no IBM Rational Host-on-Demand. Além de todas as componentes de apresentação 5250 habituais do IBM i Access for Windows, pode alterar o seu emulador de terminal 5250 entre idiomas sem reiniciar a estação de trabalho. Além disso, pode ter múltiplas sessões concorrentes com páginas de códigos do sistema central. Permite separar idiomas a serem apresentados dentro de sessões de emulação diferentes. A emulação da impressora também é suportada. - um Gestor de Sessões 5250 modelado pelo IBM Personal Communications Session Manager que pode ser utilizado para gerir todas as suas sessões de emulador 5250 - Transferência de Dados que fornece a capacidade para transferir dados de/para a base de dados IBM i de/para vários tipos de ficheiro na sua estação de trabalho tal como folhas de cálculo OpenDocument (*.ods), Livro do Excel (*.xlsx) e outros formatos de ficheiro - A Saída da Impressora faculta uma interface que permite visualizar ficheiros nas filas de saída do IBM i e também faculta a capacidade de descarregar esses mesmos ficheiros para o sistema de cliente. - um Painel de Controlo Virtual com uma interface gráfica para o painel de operação do IBM i - emulação 5250 para a Consola LAN - consolidação para configurações de interface de gestão de hardware incluindo ASMI, IVM e HMC - função de iniciar para o IBM Navigator for i utilizando o navegador predefinido O Pacote de Aplicações do Windows opcional inclui: - conectividade ao DB2 for i utilizando ODBC, .Net e OLE DB - Toolkit de programação para aceder a objectos de sistema do IBM i - Suporte para ligações de TLS/SSL - Controlador de impressora AFP O Pacote de Aplicações de Linux opcional contém um controlador de ODBC para aceder ao DB2 for i e suporta tipos de dados de 64 bits completos. 3.0 Pré-requisitos ----------------- 3.1 Pré-requisitos (estação de trabalho) -------------------------------- O IBM i Access Client Solutions vai executar na maioria dos sistemas operativos que suportam Java 6.0 ou posterior incluindo várias versões de Linux, Mac e Windows. Uma maneira de verificar a versão de Java instalado no seu sistema é abrir um pedido onde um comando pode ser introduzido (Linha de comandos, Interface, Terminal, etc) e depois escreva o comando: java -version A seguinte saída (de dados) indica que a versões 6.0 está instalada: java version "1.6.0_31" O 31 neste exemplo refere-se ao nível de actualização. A seguinte saída (de dados) indica que a versões 7.0 está instalada: java version "1.7.0" Aqui estão alguns sítios da Web de fornecedores Java. Certifique-se de que está a executar com a versão mais actualizada de Java da sua plataforma. http://www.oracle.com/technetwork/java/javase/downloads/index.html http://www.oracle.com/technetwork/java/javase/index-137561.html http://java.com/en/download/manual.jsp http://support.apple.com/downloads http://support.apple.com/downloads/#macosandsoftware http://support.apple.com/downloads#Java http://openjdk.java.net/install 3.2 Pré-requisitos (Conectividade ao IBM i) ----------------------------------------- O IBM i Access Client Solutions vai ligar-se ao IBM i edição 5.4 e posterior. As seguintes componentes requerem o IBM i edição 6.1 ou posterior: Navigator for i Consola 5250 Painel de Controlo Virtual Se for utilizar ligações SSL, carregue e aplique o PTF específico da edição do IBM i apropriada para o seu sistema: SI45601 - 5.4 SI45248 - 6.1 SI45610 - 7.1 Se for utilizar a Consola 5250 ou o componente Painel de Controlo Virtual para um IBM i com a edição 6.1, carregue e aplique os seguintes PTFs: MF55543 MF55549 Se for utilizar a Consola 5250 ou o componente Painel de Controlo Virtual para um IBM i com a edição 6.1 com o código de máquina 6.1.1, carregue e aplique os seguintes PTFs: MF55540 MF55547 Se está a utilizar a Consola 5250 ou a componente Painel de Controlo Virtual para um IBM i com a edição 7.1, carregue e aplique os seguintes PTFs: MF55485 MF55538 4.0 Conteúdos do produto -------------------- Os seguintes ficheiros e directórios estão contidos no arquivo ZIP do produto: acsbundle.jar - um ficheiro JAR executável do produto AcsConfig.properties- um ficheiro que contém definições da configuração (também existe dentro de acsbundle.jar) Documentação - directório que contém documentação GettingStarted_en.txt - informações de como iniciar Licença - um directório que contém termos e condições para a utilização Avisos - um directório que contém avisos e informações Start_Programs - directório que contém ficheiros binários específicos da plataforma que podem ser utilizados para iniciar o produto. Linux_i386-32 Linux_x86-64 Mac_i386-32_x86-64 Windows_i386-32 Windows_x86-64 Start_Scripts - um directório que contém scripts que pode ser utilizado para iniciar o produto. Linux_Mac_Other - um directório de scripts perl para iniciar o produto de qualquer plataforma onde perl está disponível. Windows - um directório que contém um JScript para iniciar no Windows Mac_Application - um directório que contém um agrupamento de aplicações para Mac Linux_Application - um directório que contém um agrupamento de aplicações para Linux Icons - um directório que contém ficheiros que podem ser utilizados como ícones properties - um directório que contém informações acerca da versão do produto 5.0 Instalação ---------------- Instalar o IBM i Access Client Solutions é tão simples como descompactar o arquivo zip. Determina a localização onde pretende instalar o produto. Pode ser qualquer localização onde a estação de trabalho (PC, Mac, etc) tem autoridade de leitura para aceder aos ficheiros. Isto inclui a unidade de disco rígido, uma unidade de rede remota (partilhada) ou suporte portátil tal como um CD ou unidade Flash USB. Copia o arquivo .ZIP para a localização desejada. Depois, descompactar o arquivo .ZIP utilizando qualquer utilitário .ZIP da sua escolha. Nota Técnica: Alguns utilitários de arquivo não preservam todos os atributos dos ficheiros guardados. Por exemplo, nas plataformas Mac e Linux, o comando unzip é geralmente uma escolha melhor do que o comando jar. Para obter informações adicionais, consulte a secção 6.0 Permissões de Ficheiros. 5.1 Actualizar uma instalação existente ------------------------------------- Melhorias e correcções serão disponibilizadas numa base periódica. Estas actualizações são fornecidas como uma instalação de produto completa. Quando estas actualizações estão disponíveis, vai necessitar de actualizar a sua instalação existente. Antes de actualizar a instalação: Guarde quaisquer alterações que fez ao ficheiro AcsConfig.properties (ou altere o nome do mesmo). Se não alterou este ficheiro, então não necessita de o guardar. Para actualizar a instalação existente, siga estes passos na secção 5.0 Instalação e sobreponha os seus ficheiros instalados existentes. Alguns administradores podem escolher instalar a versão actualizada numa nova localização. Se utilizou este método, assegure-se de que eliminou a instalação antiga após ter verificado a nova instalação. Após ter instalado a versão actualizada: Se guardou uma cópia de um ficheiro personalizado AcsConfig.properties, restaure a sua cópia guardada para a localização da instalação actualizada. 6.0 Permissões de ficheiro -------------------- A secção 7.0 Iniciar o produto descreve várias maneiras diferentes de iniciar o IBM i Access Client Solutions. Se for utilizar um dos ficheiros binários ou scripts facultados para iniciar o produto, necessitará de se certificar de que as suas permissões do ficheiro têm a permissão de execução activada. As permissões de ficheiro atribuídas ao descompactar o ficheiro de arquivo .ZIP são determinadas por vários factores incluindo o sistema operativo, o utilitário de arquivamento utilizado para descompactar o arquivo .ZIP, a autoridade do utilizador, etc. Caso tenha dificuldades em utilizar um dos ficheiros binários ou scripts facultados, verifique as permissões do ficheiro. As seguintes secções descrevem alguns métodos para verificar as permissões do ficheiro. 6.1 Permissões de ficheiro (Linux, Mac, AIX) -------------------------------------- Para sistemas operativos como Unix, pode utilizar os seguintes comandos de uma interface ou pedido terminal para verificar as permissões de um ficheiro: ls -l Para alterar as permissões de um ficheiro, pode utilizar o seguinte comando: chmod Por exemplo: chmod a+rx ...pode adicionar leitura e executar permissão para todos chmod 755 ...daria ao proprietário do ficheiro permissão de leitura/gravar/executar e apenas de leitura/executar para todos os outros. Ajuda adicional para os comandos ls e chmod está disponível na Internet. 6.2 Permissões de ficheiro (Windows) ------------------------------ Para o Windows, enquanto o ficheiro é apresentado no 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. Assegure-se de que tem permissão de leitura e de execução. Em versões recentes do Windows, pode também utilizar o comando icacls para ver e alterar a permissão de um ficheiro. 7.0 Iniciar o produto ------------------------ Há múltiplas maneiras de iniciar o IBM i Access Client Solutions. No entanto, já que há uma variedade de maneiras e localizações como/onde o java pode ser instalado, alguns dos métodos podem requerer configuração adicional. Se um dos métodos abaixo não funcionar, tente um método diferente. Em alguns casos, são dadas instruções adicionais. Pode também achar a sessão 11.0 Perguntas mais frequentes (FAQ, Frequently Asked Questions) útil. Quando utilizar um ficheiro binário ou script conforme descrito abaixo, o ficheiro binário ou script tem de estar na estrutura de directório contida no arquivo zip. Por conveniência, também pode copiar/mover o(s) ficheiro(s) binário(s) e/ou scripts para a(s) sua(s) plataforma(s) para o mesmo directório onde existe acsbundle.jar. 7.1 Iniciar o Produto ---------------------------------------------- Para iniciar o produto a partir de um navegador de sistema de ficheiros (por exemplo Explorar do Windows Explorer, Mac OS X Finder, etc) utilizando um ficheiro binário específico da plataforma, localize o subdirectório em Start_Programs que identifica o seu 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 Java." As soluções IBM i Access Client não conseguiram localizar uma instalação java numa localização que reconhece. Pode tentar um dos seguintes métodos nas secções: 7.1.1 Iniciar o Produto - Opções Adicionais 7.2 Iniciar o Produto (utilizando um script) 7.3 Iniciar o Produto (utilizando a linha de comandos) 7.1.1 Iniciar o Produto - Opções Adicionais ----------------------------------------------- Pode também tentar um dos seguintes métodos quando tentar utilizar o ficheiro binário para a sua 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 Encontrar o caminho principal de Java para saber como localizar o caminho principal de Java na sua estação de trabalho. Este métodos adicionais são apenas suportados em plataformas Linux e Windows: 1. Definir a variável do ambiente JAVA_HOME para o caminho principal de java (OR) 2. Utilizar a opção -vm no comando binário para especificar o caminho principal de java. Especifique -h no comando binário para obter ajuda adicional (OR) 3. Copie uma estrutura de directórios de Ambiente de Tempo de Execução Java (JRE, Java Runtime Environment) para o mesmo directório que o ficheiro binário que está a tentar utilizar. 7.1.2 Localizar o caminho principal de Java -------------------------------- Pode iniciar o produto utilizando um dos métodos nesta secção: 7.2 Iniciar o produto (utilizando um script) (OR) 7.3 Iniciar o produto (utilizando uma linha de comandos) depois pode determinar o caminho principal de java na estação de trabalho a partir do GUI principal do IBM i Access Client Solutions. Na barra de menus, seleccione Ajuda->Sobre O caminho java.home é apresentado neste painel. A propriedade java.home contém a localização do caminho principal de java para a sua estação de trabalho. Este é o caminho que vai necessitar de especificar quando definir a variável do ambiente JAVA_HOME ou quando utilizar a opção -vm no comando. 7.1.2.1 Localizar o caminho principal de java (em Windows) ----------------------------------------------- Em plataformas Windows, procure java.exe. O binário java está normalmente localizado ou numa gaveta ou num subdirectório jre/bin abaixo do caminho principal de Java. O caminho principal Java pode ser utilizado ao definir ou a variável do ambiente JAVA_HOME ou ao utilizar a opção -vm no comando. 7.1.2.2 Localizar o caminho principal de java (em Linux) ----------------------------------------------- Em linux pode utilizar o comando "Which" (qual): which java Vai dar-lhe o caminho para o comando 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. Pode processar ligações simbólicas utilizando o comando ls com a opção -l ls -l O binário java está normalmente localizado ou numa gaveta ou num subdirectório jre/bin abaixo do caminho principal de Java. O caminho principal Java pode ser utilizado ao definir ou a variável do ambiente JAVA_HOME ou ao utilizar a opção -vm no comando. 7.2 Iniciar o produto (utilizando um script) ---------------------------------------- Para iniciar o produto de um navegador de sistema de ficheiros (ex. Windows Explorer, Mac OS X Finder, etc) utilizando um dos scripts fornecidos, localize o script no subdirectório Start_Scripts que é compatível com o seu sistema operativo. A maioria dos sistemas operativos não baseado em Windows têm perl disponível por predefinição. O directório Start_Scripts/Linux_Mac_Other contém um script perl (com três extensões de nome de ficheiros diferentes) que podem ser utilizados para iniciar o produto em qualquer plataforma onde o perl está disponível. Seleccione o ficheiro que tem uma extensão do nome do ficheiro que o sistema operativo vai reconhecer como um script perl. Sistemas operativos baseados em Windows têm JScript disponível por predefinição. O directório Start_Script/Windows contém um JScript que pode ser utilizado para iniciar o produto em sistemas operativos Windows. Utilizando um método especifico de plataforma para procurar o sistema de ficheiros (ex. Windows Explorer, Mac OS X Finder, etc), localize o script que o seu sistema operativo reconhece. Depois, faça duplo clique para iniciar o produto. Pode também iniciar o produto com este script com uma Linha de comandos, terminal ou interface. 7.3 Iniciar o produto (utilizando a linha de comandos) ------------------------------------------------- Pode também iniciar o produto a partir da linha de comandos de qualquer local que possa introduzir um comando (linha de comandos, terminal de comandos, interface, etc) java -Xmx1024m -jar /acsbundle.jar onde é a localização para o ficheiro JAR executável do produto (ex. java -Xmx1024m -jar V:/some_location/acsbundle.jar ou java -jar V:/some_location/acsbundle.jar onde é a localização do comando java para JDK 6.0 ou posterior. Consulte a secção 7.1.2 Localizar o caminho principal 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 /Produto/Localização/Start_Programs/Mac_i386-32_x86-64/acslaunch_mac ou /Produto/Localização/Start_Scripts/Linux_Mac_Other/acslaunch Nota técnica: Na maioria das plataformas, o espaço de pilha JVM tem por predefinido um tamanho máximo que é demasiado pequeno para utilizar múltiplas funções dentro do produto IBM i Access Client Solutions. Um tamanho da pilha máximo de um GB (-Xmx1024m) é o tamanho mínimo recomendado. Especificar tamanhos menores do que um GB ou utilizar o tamanho da pilha predefinido pode produzir uma OutOfMemoryException. 8.0 Configuração ----------------- Adicione uma configuração do sistema por cada sistema IBM i que pretenda utilizar ou gerir. Para adicionar a configuração do sistema, seleccione Configurações do sistema das tarefas de Gestão. Depois, seleccione Novo. No separador Geral, introduza o nome do sistema. Para iniciar, o nome do sistema é tudo o que é necessário para executar tarefas Gerais. Quando tiver concluído, seleccione OK para guardar a informação que inseriu neste sistema, ou seleccione Guardar/Novo se tem sistemas adicionais que pretende adicionar às configurações. Pode adicionar novos sistemas à sua configuração ou actualizar configurações existentes utilizando os separadores Geral, Ligação ou Consola a qualquer altura. Para tarefas de Consola, são requeridas configurações adicionais. Configurações de consola são associadas automaticamente com o Nome do Sistema que introduziu no separador Geral. Para introduzir a configuração da consola para um sistema, seleccione Configurações de sistema das tarefas de Gestão. Seleccione Novo ou editar. Depois, seleccione o separador Consola. A tarefa Consola 5250 requer uma consola LAN ou uma consola HMC configurada. Caso não tenha uma consola LAN ou HMC configurada, consulte a secção 9.9 Estabelecer uma Ligação à Consola para o IBM i. A tarefa Painel de Controlo Virtual requer uma consola LAN configurada. A tarefa Interface de Gestão de Hardware requer uma interface de gestão de hardware configurada. Pode introduzir até duas configurações de interface de gestão de hardware. Quando tiver concluído, seleccione Fechar no painel de Configurações do Sistema. Utilizando a caixa de lista pendente do Sistema no painel principal do IBM i Access Client Solutions, seleccione um Sistema. Todas as tarefas de Consola associam automaticamente o Sistema seleccionado (introduzido no separador Geral) à configuração da consola (introduzida no separador Consola). Pode, agora, seleccionar um tarefa para o sistema seleccionado. Se seleccionar uma tarefa de Consola que não possui a informação correspondente introduzida no separador de configuração Consola, será apresentada uma mensagem de erro. 8.1 Localização da configuração -------------------------- Por predefinição, cada utilizador terá a sua própria localização única para as suas configurações. O directório raiz de configuração é determinado de uma maneira dependente da plataforma. Os directórios de configuração serão criados durante o arranque inicial. Para ver onde está o directório de configuração: Iniciar o produto (consulte a secção 7.0 Iniciar o produto) Editar->Preferências Seleccione o separador Definições Locais Root de configuração A localização da configuração não pode ser alterada enquanto o produto está a executar. Para alterar a localização da configuração, consulte a secção: 9.3 Alterar a localização da configuração 9.0 Tópicos avançados --------------------- 9.1 Mais opções de linha de comandos ----------------------------- Muitas das funções que estão disponíveis a partir do GUI principal também estão disponíveis a partir da linha de comandos. Estas funções podem ser invocadas por fornecer os parâmetros apropriados a qualquer das opções de linha de comandos apresentadas em: secção 7.3 Iniciar o produto (utilizando a linha de comandos) ex. /Product/Location/Start_Scripts/Linux_Mac_Other/acslaunch parm1 parm2 ... Apenas os parâmetros adicionais serão apresentados nas seguintes secções: 9.1.1 Criar cópia de segurança --------------- /PLUGIN=backup [/file=] é 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 pode ser localizada no ficheiro AcsConfig.properties. Esta função é equivalente a Ficheiro->Exportar do GUI principal. 9.1.2 Restaurar ---------------- /PLUGIN=restore /file= é a localização do ficheiro criado por Criar cópia de segurança Vai restaurar uma configuração guardada do ficheiro especificado. Qualquer configuração existente que não esteja no ficheiro especificado perder-se-á. A localização da configuração restaurada é determinada pela propriedade: com.ibm.iaccess.AcsBaseDirectory que pode ser localizada no ficheiro AcsConfig.properties. Esta função é equivalente a Ficheiro->Importar do GUI principal. 9.1.3 Certdl -------------- /PLUGIN=certdl /SYSTEM= Descarrega uma entidade certificadora (CA, certificate authority) do sistema IBM i especificado e armazena-a no arquivo fidedigno local do utilizador. É algo obrigatório para a autenticação do servidor com SS.L 9.1.4 Cfg ------------ /PLUGIN=cfg /SYSTEM= [/ipaddr=] [/userid=] [/ssl=] [/5250path=] [/del] [/r] /SYSTEM - nome do sistema /ipaddr - quando é solicitada uma ligação, este valor determina se vai ou não ocorrer uma procura do endereço de IP. Frequências válidas são: ALWAYS - procura endereços de IP para cada ligação HOURLY, DAILY, WEEKLY - procura endereços de IP consoante a quantidade de tempo que passou deste a última procura IP address - se é especificado um endereço de IP, a frequência da procura é presumida ser NEVER /userid - O ID de utilizador para um utilizador pode também ser definido pelos seguintes valores: *PROMPTALWAYS - faz pedidos pelo menos uma vez por cada ligação *KERBEROS - utiliza o nome identificador exclusivo do Kerberos, sem pedidos /ssl - o comutador fica em 0 para desligar o modo SSL, ou em 1 para ligar o mesmo /5250path - caminho para os perfis de emulação 5250 O /5250path pode ser definido a partir do GUI principal utilizando o Gestor de sessões 5250 e depois Ficheiro->Alterar directório... /del elimina a configuração existente /r substitui a configuração existente Isto permite várias opções de configuração a serem definidas a partir da linha de comandos. Estas opções podem também ser definidas a partir do GUI principal utilizando Configurações do sistema. 9.1.5 Cópia de Memória ---------- /PLUGIN=dump [/] Pede a todos os processos em execução no produto para fazer cópia da memória das respectivas sessões. Estas informações serão utilizadas por serviços IBM para fornecer ajuda técnica. Os registos gerados podem ser acedidos a partir do GUI principal por: Editar-Preferências Separador Definições Locais Directório de cópia de memória Caso não sejam especificadas opções, esta função é equivalente à seguinte função do GUI principal: Ferramentas->Gerar Registos de Serviço Opções válidas são: /heapdump - executa o procedimento acima mencionado e ainda uma cópia de memória da pilha JVM 9.1.6 Medic ----------- /PLUGIN=medic Empacota os registos existentes e cópias de memória da sessão num ficheiro ZIP que pode ser enviado para a IBM para serviço. O ficheiro ZIP resultante pode ser acedido a partir do GUI principal por: Editar-Preferências Separador Definições Locais Directório de serviço Esta função é equivalente a Ferramentas->Registos de Serviço de Pacote a partir do GUI principal. 9.1.7 Registo ------------ /PLUGIN=log /LEVEL= é um dos seguintes níveis de registo de suporte: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINEST Este suplemento permite ao utilizador comutar o nível de registo a partir da linha de comandos. O nível de registo pode ser definido a partir do GUI principal por: Editar->Preferências separador Geral Nível de registo 9.1.8 Início de sessão -------------- /PLUGIN=logon /SYSTEM= /USERID= /PASSWORD= /C limpa a cache [opcional] Este comando vai colocar na cache a palavra-passe e o ID de utilizador que podem ser utilizados para impedir o pedido de palavra-passe. 9.1.9 props -------------- /PLUGIN=props Abra o mesmo painel GUI que em Editar->Preferências do GUI principal. 9.1.10 Maint ------------ /PLUGIN=maint [/] As opções válidas são: /killdaemon - Termina as sessões daemon. Igual a Ferramentas->Repor para Manutenção a partir do GUI principal /clearpwcaches - limpa todas as palavras-passe colocadas na cache /clearjarcache - limpa a cache JAR do produto /clearlogs - limpa o Directório de registo em Editar->Preferências Separador de Definições local do GUI principal /cleardumps - limpa o Directório de cópias de memória em Editar->Preferências Separador de Definições local do GUI principal /clearsvcdir - limpa o Directório de Serviço em Editar->Preferências Separador de Definições local do GUI principal /clearsettings - limpa todas as definições para o utilizador actual Caso não sejam especificadas opções, não serão efectuadas quaisquer acções. 9.1.11 Ping -------------- /PLUGIN=ping /SYSTEM= [] Options include: /SSL=<1/0> Activa ou desactiva SSL /SERVERAUTH=<1/0> Activa ou desactiva Autenticação de Servidor SSL (a predefinição é desactivada) Esta opção é ignorada caso não esteja a testar SSL /GUI=<1/0> Activar/desactivar janela do GUI (a predefinição é desactivada caso seja lançado a partir da linha de comandos) /PORTS= Uma lista separada por vírgulas de portas a testar. Pode ser números ou nomes do serviço (ex. /PORTS=as-signon,as-sts). Se não for especificado, um conjunto de portas predefinido é testado. Especificar .CONSOLE irá verificar uma lista de portas específicas da consola. /TIMEOUT= Especifica um valor de tempo de espera, em segundos. O suplemento verifica a conectividade ao IBM i estabelecendo uma ligação à porta adequada. Se está a verificar uma ligação SSL, há uma tentativa de (protocolo de) reconhecimento SSL. Se for iniciado a partir de um GUI principal, ou invocado com /GUI=1, este suplemento mostra um diálogo. Se iniciado de uma linha de comandos sem /GUI=1, o resultado é enviado para a consola. Por predefinição, os seguintes serviços são verificados: as-central, as-rmtcmd, as-database, as-dtaq, as-file, as-netprt, drda, as-signon Esta função foi iniciada a partir do GUI principal por: Configurações do sistema seleccione um sistema e depois Editar separador Geral Verificar a ligação 9.1.12 Sm ------ /PLUGIN=sm Este suplemento inicia o GUI gestor de sessões 5250. É equivalente ao Gestor de sessões 5250 do GUI principal. 9.1.13 5250 ------------- /PLUGIN=5250 /SYSTEM= [/id=] [/] Este suplemento inicia um emulador 5250 com o sistema especificado. Esta função é equivalente ao Emulador 5250 do GUI principal. /id= - define o ID de sessão curta Opções válidas são: /name= - nome da sessão /wide - utilizar um tamanho de ecrã largo(27x132) /fullscreen - utilizar o ecrã inteiro /nosave - não guardar definições à saída /prompt - forçar o diálogo de configuração a aparecer /port= - número da porta /ssl - estabelecer ligação utilizando secure sockets /sso - ignorar ecrã de início de sessão /kerberos - Utilizar kerberos /width= - comprimento inicial da janela do emulador /height=- altura inicial da janela do emulador /xpos= - posição da coordenada X inicial do canto superior esquerdo da janela do emulador /ypos= - posição da coordenada Y inicial do canto superior esquerdo da janela do emulador 9.1.14 DTGui ----------- /PLUGIN=dtgui Este suplemento inicia o GUI principal para a Transferência de Dados. Esta função é equivalente à Transferência de Dados a partir do GUI principal. 9.1.15 Descarregar ------------------ /PLUGIN=download /file= [/userid=] /file - ficheiro com a extensão .dtfx que foi criado a partir de um descarregamento de uma Transferência de Dados anterior /userid - ID de utilizador a utilizar quando se liga ao sistema de destino O suplemento permite ao utilizador executar um descarregamento de Transferência de Dados guardado anteriormente. A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados. 9.1.16 Carregar ---------------- /PLUGIN=upload /file= [/userid=] /file - ficheiro com a extensão .dttx que foi criado a partir de um carregamento de uma Transferência de Dados anterior /userid - ID de utilizador a utilizar quando se liga ao sistema de destino O suplemento permite ao utilizador executar um carregamento de Transferência de Dados guardado anteriormente. A Transferência de Dados também está disponível a partir o GUI principal ao seleccionar Transferência de Dados. 9.1.17 CLDownload ---------------- /PLUGIN=cldownload /system= [/userid=] /hostfile= /clientfile=. /userid - ID de utilizador a utilizar quando efectuar a ligação ao sistema de destino /hostfile - Biblioteca e ficheiro de origem no sistema IBM i para a transferência /clientfile - Localização de ficheiro de destino para a transferência. O formato deste ficheiro será determinado pela extensão especificada (por exemplo, .csv .ods .xlsx .xlsx) Caso a extensão de ficheiro não esteja especificada ou se for de um tipo não suportado, os dados serão formatados como um ficheiro .csv O suplemento permite ao utilizador executar uma simples transferência de um ficheiro inteiro a partir da linha de comandos. 9.1.18 Consola ------------- /PLUGIN=consola /SYSTEM= Este suplemento inicia uma consola 5250 para o sistema especificado. Esta função é equivalente a uma Consola 5250 a partir do GUI principal. 9.1.19 VCP ------------- /PLUGIN=vcp /SYSTEM= Este suplemento inicia um Painel de Controlo Virtual para o sistema especificado. Esta função é equivalente a um Painel de Controlo Virtual a partir do GUI principal. 9.1.20 L1C ------------- /PLUGIN=l1c /SYSTEM= Este suplemento inicia um navegador para o IBM Navigator for i utilizando sistema especificado e a porta 2001. Esta função é equivalente ao Navigator for i a partir do GUI principal. 9.1.21 SPLF ------------- /PLUGIN=splf /SYSTEM= Este suplemento apresenta o GUI da Saída da Impressora para visualizar e transferir ficheiros em spool a partir do IBM i. Esta função é equivalente à Saída da Impressora a partir do GUI principal. 9.1.22 KEYMAN ------------- /PLUGIN=keyman Este suplemento apresenta a ferramenta Gestão de Chaves. Esta função é equivalente a Ferramentass->Gestão de Chaves a partir do GUI principal. 9.1.23 RMTCMD ------------- /PLUGIN=rmtcmd /SYSTEM= /CMD="" Este suplemento envia um comando CL para o sistema especificado. Esta função apenas está disponível a partir da linha de comandos. Sugestão: O comando CL terá de estar entre aspas para evitar que espaços quebrem o comando. 9.1.24 PWCHANGE ------------- /PLUGIN=pwchange /SYSTEMS= Este suplemento altera a palavra-passe nos sistemas especificados. Pede um ID de utilizador, palavra-passe nova e palavra-passe antiga ao utilizador. Esta função também pode ser utilizada a partir do GUI principal ao seleccionar o separador Palavras-Passe de Editar->Preferências 9.1.25 MIGRAR ------------- /PLUGIN=migrate /