Este documento contêm informações de pré-requisitos do produto WebSphere Development Tools for AS/400. Além disso, este documento inclui quaisquer limitações do produto e informações não incluídas na documentação.
Índice
Regras Gerais
Não utilize arquivos de resposta. Eles não são suportados.
Quando for perguntado se deseja reiniciar a máquina durante a instalação, sempre resposta Sim. Para alguns idiomas, a caixa de diálogo de reinício da máquina tem apenas os botões Sim e Não. Sempre responda Sim.
O aplicativo msiexec.exe pode gerar a seguinte mensagem de erro: "A instrução em '...' memória recomendada em '...'. A memória não pôde ser 'lida'." Clique em OK. Isso não parece afetar adversamente a instalação do produto.
A instalação parece ocasionalmente estar inativa por até 5 minutos. Isso é normal. A instalação é concluída apenas quando o diálogo de conclusão aparece.
Componentes Opcionais| Componente | Incluído com o produto | Reinício necessário | Tipos de Instalação | Comentários |
|---|---|---|---|---|
| MS JVM (msjava.dll) |
Sim | Sim | Interativa - lançado a partir da instalação | Requerido para funções do Studio. |
| J2SDK 1.2.2 | Sim | Não | Interativa - lançado a partir da instalação | Requerido para todas as funções do CODE/400 e VARPG. Consulte Notas JDK. | Netscape Communicator | Sim (V4.7) em um CD separado |
Não | Manual - instala selecionando o CD e o diretório da linguagem apropriada |
| Microsoft Internet Explorer | Não, obter a partir do fornecedor |
Sim | Manual - instala a versão 4.0 ou superior | Se não instalado, a maioria das funções do Studio não irão funcionar. |
Navegador da Web
A ajuda foi testada no Netscape Navigator 4.7 e Internet Explorer 4 e superior.
Após a instalação, certifique-se de que os navegadores da Web passaram do servidor proxy para o nome do servidor "localhost".
Algumas vezes, seu navegador não pode conectar-se ao servidor web local httpdl.exe porque ele tenta localizar a máquina chamada "localhost" utilizando um servidor proxy. Isso geralmente acontece quando seu navegador está definido para configuração proxy manual ou automática. Se você utilizar configuração proxy manual, poderá modificar as configurações do seu navegado para evitar que o navegador tente resolver "localhost" utilizando um servidor proxy. Se você utilizar configuração proxy automática, precisará pedir ao proprietário do arquivo de configuração proxy automático para incluir 127.0.0.1 como um proxy exceto no servidor proxy.
Para determinar se seu navegador está configurado para a configuração proxy manual e para incluir substituições de proxy, se necessário, siga estas etapas. Estas instruções são para as versões do navegador indicadas; se estiver utilizando uma versão de navegador diferente, as etapas poderão ser diferentes:
Para o Netscape 4.7:
127.0.0.1 como um proxy exceto no servidor proxy.Para o Internet Explorer 5.0:
Você também deverá atualizar o arquivo %SystemRoot%\system32\drivers\etc\hosts incluindo a linha:
127.0.0.1 localhost
se ela ainda não estiver presente. Se você alterar este valor, poderá precisar sair e reiniciar seu navegador para que a alteração entre em vigor.
Se fizer quaisquer alterações na configuração do navegador ou no arquivo "...\etc\hosts", tente recarregar a home page de ajuda em seu navegador. Se ainda ocorrerem erros ao tentar conectar-se ao locahost:49213, entre em contato com o suporte da IBM.
Se o servidor proxy automático não estiver acessível ao tentar exibir a ajuda, pode ser que não tenha sido possível resolver o localhost para o endereço local 127.0.0.1. Você pode solucionar temporariamente este problema (enquanto o servidor proxy estiver indisponível), alterando a conexão direta para a Internet na etapa 4 (Netscape) ou na etapa 3 (Internet Explorer) descritas anteriormente.
Existe um problema conhecido no Netscape com a função Pesquisa de Ajuda no Windows 2000. Consulte Netscape no Windows 2000 para obter uma descrição. Para utilizar o Internet Explorer para ajuda, lance o Internet Explorer e selecione Sim para a mensagem "Deseja torná-lo seu navegador padrão?". Você deve desligar e reiniciar um recurso de produto antes que a alteração do navegador padrão possa passar a vigorar.
Instalação no Windows 95 ou Windows 98
Se você receber uma mensagem de erro indicando que o NetQuestion não pode ser instalado, o motivo é que a
instrução PATH no arquivo autoexec.bat está com mais de 200 caracteres. Reduza a instrução PATH para corrigir este
problema.
As estações de trabalho do Windows 95 devem estar com a versão 4.00.950a ou superior e ter o Internet Explorer 5 versão 5.00.2314.1003 ou superior instalada antes de instalar este produto.
Instalação no Windows NT ou Windows 2000
Devido à alteração do Microsoft Installer na utilização das variáveis de ambiente no Windows NT e 2000, siga essas regras:
x: refere-se à unidade na qual o produto está instalado.
| O nome da variável do sistema | deve incluir esta entrada |
| CLASSPATH | x:\wdt400\java |
| HELP | x:\wdt400\help |
| IPF_PATH32 | x:\wdt400\system |
| LOCPATH | x:\wdt400\system |
| PATH | x:\wdt400 |
Desinstalando o Produto
Para desinstalar o WebSphere Development Tools para AS/400, em um prompt de comandos, execute wdt4imain.exe a partir da origem de instalação original e utilize a opção Remover na tela Manutenção do Programa. Não utilize o método Incluir/Remover Programas do Windows e não remova manualmente recursos individuais porque estes não serão removidos corretamente.
Sempre reinicialize a máquina após remoção da instalação do produto.
A desinstalação ou cancelamento da instalação deixa arquivos indesejados, diretórios e entradas de registro. Para restaurar a estação de trabalho para seu estado original, execute o seguinte procedimento.
wdclean.exe em um diretório da estação de trabalho de sua escolha.wdclean.exe se ele não for necessário novamente.c:\wdt400. Certifique-se de que o caminho esteja correto. Utilize apenas nomes abreviados no caminho.win95, win98, winnt ou win2k.
cd %temp% para acessar os arquivos descompactados. Se você descompactar em um diretório específico, altere para este diretório.cleanup [path] [OS] em que [path] é o caminho de instalação e [OS] é o sistema operacional.
concluir para excluir os arquivos de limpeza.
Modificação do produto
Para alterar os recursos disponíveis neste produto, insira o CD 1 de instalação na unidade de CD, digite x:\wdt4imain.exe em um prompt de comandos (em que x: é a letra da unidade de CD) e utilize a opção Modificar na tela Manutenção do Programa. Não utilize o método Incluir/Remover Programas do Windows e não remova manualmente recursos individuais porque estes não serão removidos corretamente.
Sempre reinicialize a máquina depois da modificação do produto.
Cancelando a Instalação
Se você clicar em Cancelar durante a instalação, desinstale o produto conforme descrito na seção Desinstalação do Produto para garantir que todos os arquivos tenham sido removidos.
Instalação do Idioma Nacional
O produto irá instalar um idioma de acordo com as características de localidade do sistema. Se você alterar as
características de localidade depois que a instalação for concluída, os recursos do produto e as
telas de ajuda podem não exibir o idioma correto. Para alterar o idioma, remova completamente a instalação do produto como descrito na seção Remoção da Instalação do Produto, altere a localidade e instale novamente o produto.
Instalando a versão em coreano ou espanhol
A instalação no idioma coreano ou espanhol pode resultar em duas entradas do WebSphere Studio no menu
Iniciar->Programas>IBM WebSphere Development Tools para AS400. Você pode obter uma correção para isso no site do WDT/400 na Web, como segue.
wsmerge.exe em um diretório da estação de trabalho de sua escolha.win95, win98, winnt ou win2k.
cd %temp% para acessar os arquivos descompactados. Se você descompactar em um diretório específico, altere para este diretório.wsmerge [OS] em que [OS] é o sistema operacional.
Alterações para o WebSphere Studio Guide for AS/400
Nomes de Programas referenciados em Criar pacote do aplicativo Web mudam da seguinte forma:
Alterações para os Controles de Tempo de Design do WebSphere
A descrição na ajuda online está incompleta para Operando 1 e Operando 2 para propriedades do atributo
run-time associadas aos seguintes Controles de Tempo de Design do WebSphere Studio for AS/400 (DTCs): Checkbox, Combobox, Entryfield, Label, Listbox, Pushbutton e Radiobutton.
A descrição do Operando 1 deve mostrar:
Digite o nome do campo para o operando. O campo
pode ser qualquer nome de campo exclusivo na página
JSP.
O nome especificado
deve ser o mesmo nome do parâmetro de saída especificado na página
Especificação dos parâmetros de entrada e saída para o programa ILE no assistente de Interação com a Web.
A descrição do Operando 2 deve mostrar:
Digite um valor de constante para esse operando para a comparação com o operando 1. Você pode digitar também um nome de campo para o operando 2 se você selecionar Operando de nome de campo. O campo
pode ser qualquer nome de campo exclusivo na página
JSP.
O nome especificado
deve ser o mesmo nome do parâmetro de saída especificado na página
Especificação dos parâmetros de entrada e saída para o programa ILE no assistente de Interação com a Web.
Alterações para o Assistente de Interação com a Web do WebSphere Studio
O Assistente de Interação com a Web fornece um campo "Servlet URL" para preparar um modelo de um link de hipertexto
para chamada e transmissão de dados para servlets. O diálogo "Especificação de um nome para a interação com a Web" mostra URL. A caixa final que mostra a criação do servlet permite alterações dos dados. Por exemplo, o Servlet URL pode aparecer como:
"/servlet/NuthinServlet?Custno=#1&Custna=#2".
Se os valores "#1" e "#2" estão substituídos por "12345" e "Smith", então a chamada equivalente é:
"servlet/NuthinServlet com Custno=12345 e Custna=Smith".
Adicionais do VisualAge RPG
Os seguintes atributos de Parte foram incluídos no VisualAge RPG.
| Part | Atributo | Tipo | Descrição | Operation Operação |
Operacional em runtime |
|---|---|---|---|---|---|
| Sub-arquivo | EditColumn | numérico | Retorna o número da coluna da célula que está aberta para edição. | setatr getatr |
não
sim |
| EditIndex | numérico | Retorna o número da linha da célula aberta para edição. | setatr getatr |
não
sim |
|
| EditText | texto | Retorna o texto sendo editado no momento na célula em edição. Retorna uma cadeia vazia se nenhuma célula estiver aberta para edição. |
setatr getatr |
não
sim |
|
| Janela | PrintAsIs | texto | Imprime a imagem e mantém aparência proporcional. | setatr getatr |
sim
não |
| Imagem | PrintAsIs | texto | Imprime a imagem e mantém aparência proporcional. | setatr getatr |
sim
não |
Exemplo de Visão Geral da Ajuda
O nome do programa de Serviços do Subarquivo API para o Subarquivo DTC mudou de SFLIBSRV para QDTSSFL.
Esta alteração afeta a documentação de Ajuda encontrada em:
Visão Geral
Informações Iniciais do WebSphere Development Tools para AS/400
Criando Aplicativos na Web
Exemplo: Criando um Aplicativo na Web utilizando o WebSphere Studio para AS/400.
Todas as descrições que lêem ". . . módulo SFLIBSRV de API" deveriam ler ". . . programa de serviços QDTSSFL" de API.
Notas JDK
O IBM WebSphere Development Tools para AS/400 é enviado com o IBM J2SDK (Java 2 Software Development Kit), J2SDK Standard Edition v1.2.2. incluindo JavaDocs. Se você optar por utilizar um JDK diferente, esta versão deve ser 1.2 ou
superior para assegurar a funcionalidade de todas as partes do código Java.
Para utilizar um JDK diferente, determine o diretório principal JRE (Java Runtime Environment). No Editor CODE, digite o comando "SET GLOBAL.JREHOME x:\dir" onde x:\dir é o diretório principal JRE. Por exemplo, "SET GLOBAL.JREHOME C:\JDK1.2\JRE".
Quando a instalação do J2SDK estiver concluída, atualize as variáveis de ambiente do sistema PATH e CLASSPATH para incluir o diretório J2SDK apropriado. Isto permite que o VARPG utilize Java. Por exemplo, se você instalou o J2SDK no diretório x:\jdk12, então inclua a seguinte informação para a variável PATH: x:\jdk12\bin.
Se você planeja usar o componente do VisualAge RPG Media, depois instale o Java Media Framework API.
VisualAge RPG Designer GUI e Java Plug-in
O Netscape Navigator e o Internet Explorer da Microsoft não suportam atualmente o
mesmo nível de J2SDK que o VisualAge RPG utiliza. Sendo assim, os applets criados com o
VisualAge RPG GUI Designer não serão executados diretamente com esses navegadores. Para executar os applets do VisualAge RPG applets em um desses navegadores,
você deve possuir o Java Plug-in 1.2 instalado (incluído com J2SDK) e o
HTML Converter disponível a partir do JavaSoft. Você pode fazer download desses softwares seguindo os links na página da Web "The Source for Java Technology" no site da Sun na Web em sun.com. O HTML Converter permite converter a página HTML com seu tag de applet para utilizar o Java Plug-in. A conversão cria uma tag de objeto que informa ao navegador da Web para utilizar o Java Plug-in ao invés do Java 2 Runtime Environment.
O Distributed Debugger
Quando você está depurando um Programa ou Programa de Serviço que foi executado a partir de uma página da Web gera da
pelo WebSphere Studio for AS/400, o término do Programa ou do ponto de entrada do Programa de Serviço não faz com que o depurador seja encerrado.
Isto previne sessões de depuração sub-seqüentes.
Para depurar novamente, utilize o botão Interromper para fechar a sessão de depuração pendente.
Object Level Trace
Se o Object Level Trace no Windows 95 ou Windows 98 não inicia, certifique-se que o espaço de ambiente está definido com o valor máximo. No arquivo CONFIG.SYS procure a diretriz SHELL e assegure que o valor /E está definido como 32768.
Por exemplo: SHELL=C:\WINDOWS\COMMAND.COM /p /E:32768
O visualizador do OLT falhará se arquivos de ambiente no diretório DbgProf estiverem corrompidos. Se isso acontecer, exclua todos os arquivos do diretório DbgProf. Existe um diretório separado para cada usuário. Quando o visualizador do OLT iniciar, ele criará os arquivos novamente.
O visualizador do OLT exibe o erro "Cannot open input stream for dertrdfl" quando é iniciado pela primeira vez ou após a exclusão de arquivos de ambiente no diretório DbgProf. Esse erro não afeta a execução do visualizador do OLT.
Não conformidade do Netscape Navigator
O Netscape Navigator não está em conformidade com os padrões para HTML 4. páginas da Web geradas pelo WebSphere
Studio for AS/400 e exibidas pelo Netscape Navigator possuem problemas de DTC descritos na tabela a seguir.
Estes problemas não ocorrem quando o Internet Explorer é utilizado.
| Tipo DTC | Problemas de Aparência | Problemas de Eventos | Problemas de Atributo |
|---|---|---|---|
| Entryfield | Cor e cor de segundo plano padrão não podem ser substituídas. | OnSelect, OnClick, OnDblClick, OnMouseOver, OnMouseDown, OnMouseUp e OnMouseOut não são suportados. | O atributo "alignment" move o campo inteiro, não apenas o texto. O atributo "readonly" não é suportado, mas esse problema pode ser solucionado da seguinte forma: - selecione o DTC - a caixa de diálogo Controlar Propriedades é exibida - selecione a guia eventos - clique no evento onFocus - digite "this.blur();" na caixa script. |
| Checkbox | Sem problemas | OnChange não é suportado. | Sem problemas |
| Combobox | Cor e cor de segundo plano padrão não podem ser substituídas. Fonte é ignorada. |
Sem problemas | Sem problemas |
| Listbox | Cor e cor de segundo plano padrão não podem ser substituídas. Fonte é ignorada. |
Sem problemas | Sem problemas |
| MLE | Cor e cor de segundo plano padrão não podem ser substituídas. Fonte é ignorada. Quebra de texto incorreta para a próxima linha. |
OnSelect não é suportado. | Sem problemas |
| Pushbutton | A cor de plano de fundo sempre aparece em cinza claro. | OnKeyPress, OnKeyUp, OnKeyDown, OnMouseOut e OnMouseOver não são suportados. | Sem problemas |
| Radiobutton | Sem problemas | OnMouseOut, OnMouseOver, OnKeyUp, OnKeyDown, OnKeyPress e OnChange não são suportados. | Sem problemas |
Netscape no Windows 2000
Existe um problema conhecido com o Netscape (versões 4.5 a 4.74 e outras possíveis) em algumas máquinas com Windows 2000 que podem tornar a pesquisa de ajuda online extremamente lenta. Ao enviar um formulário dessas versões do Netscape, o aplicativo Netscape utiliza os ciclos do processador disponíveis em sua máquina até que a resposta seja recebida do sistema remoto. Geralmente isso não é um problema ao fazer uma pesquisa remota (por exemplo, em um site na Web). No entanto, uma vez que o programa de pesquisa do produto está sendo executado em sua máquina local, o fato de que o Netscape leva muito mais tempo de CPU significa que existe muito pouco tempo de CPU reservado para que o programa de pesquisa realize sua pesquisa. Como conseqüência, uma ação de pesquisa que deveria retornar um resultado em um segundo pode levar muitos minutos no Windows 2000.
Este problema de desempenho pode ser evitado selecionando uma janela diferente, que não seja do Netscape, depois de cada vez que você submeter uma pesquisa. Isto geralmente faz com que o Netscape ao utilizar ciclos de CPU excessivos, pare enquanto aguarda por uma resposta e os resultados da pesquisa são geralmente exibidos um segundo depois de optar por esta janela.
Como alternativa, você pode utilizar o Microsoft Internet Explorer para exibir a ajuda. O problema de desempenho não ocorre com este navegador.
Norton AntiVirus
Se o Norton AntiVirus estiver instalado em uma máquina com Windows 95 ou Windows 98 e alguma parte do WebSphere Development Tools, como o Debugger ou o Object Level Trace, não funcionar, desative o Norton AntiVirus e tente novamente.
A Ajuda não funciona
Depois da instalação, se a Ajuda não funcionar porque o navegador não inicia, então reconfigure o sistema de Ajuda. Não são necessários os CDs de instalação para o procedimento a seguir.
| 1. | Determine o sistema operacional YY da estação de trabalho. |
YY é |
||
95 para Windows 95 |
98 para Windows 98 |
|||
NT para Windows NT |
2K para Windows 2000 |
|||
| 2. | Determine a unidade W em que o diretório WDT400\help está localizado. |
W é |
a unidade na qual o produto está instalado. | |
| 3. | Determine a unidade X em que o diretório imnnq_YY está localizado. |
X é |
geralmente a unidade em que o produto está instalado. | |
| 4. | Determine o idioma zz_ZZ que foi instalado. | zz_ZZ é |
||
en_US para inglês |
fr_FR para francês |
|||
de_DE para alemão |
pt_BR para português do Brasil |
|||
it_IT para italiano |
es_ES para espanhol |
|||
ko_KR para coreano |
ja_JP para japonês |
|||
zh_CN para chinês simplificado |
zh_TW para chinês tradicional |
|||
| 5. | Abra a janela Prompt de Comandos. | |||
| 6. | Altere para a unidade X. Substitua X e digite o comando: | X: |
||
| 7. | Altere o diretório para imnnq_YY. Substitua YY e digite o comando: |
cd imnnq_YY |
||
| 8. | Para remover o sistema de ajuda, substitua X, YY e zz_ZZ e digite este comando: |
vahcfgw.exe remove /p va400 /f X:\imnnq_YY /l zz_ZZ |
||
| 9. | Para restaurar o sistema de ajuda, substitua W e zz_ZZ e digite este comando: |
vahcfgw.exe install /w W:\wdt400\help /l zz_ZZ |
||
| 10. | Aguarde a conclusão da reconfiguração de Ajuda e, em seguida, feche a janela Prompt de Comandos. |
|||
O documento Notas de Release fornece informações dos recursos principais do produto, requisitos de hardware e software e o processo de migração.
Visite-nos nas páginas da World Wide Web em:
ibm.com/software/awdtools/wdt400/
Você pode também obter estas páginas seguindo os links a partir da home page IBM Software ibm.com/software/Siga os grupos de notícias e envie suas dúvidas:
Servidor de notícias:
news.software.ibm.com
Grupos de notícias sugeridos:
ibm.software.code400
ibm.software.vajava
ibm.software.varpg
Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos. A IBM pode não oferecer os produtos, serviços ou recursos discutidos neste documento em outros países. Solicite informações sobre os produtos e serviços atualmente disponíveis em sua localidade através de um Representante Autorizado da IBM. Qualquer referência a um produto IBM, programa ou serviço não pretende estabelecer que somente esse produto, programa ou serviço possa ser utilizado. Pode ser usado qualquer produto, programa ou serviço funcionalmente equivalente que não infrinja os direitos de propriedade intelectual da IBM. Cabe ao usuário, porém, a responsabilidade de avaliar e testar a operação de qualquer produto, programa ou serviço IBM.
A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos desta publicação. O fornecimento deste documento não lhe garante direito algum sobre tais patentes. Consultas sobre licenças devem ser enviadas, por escrito, para:
Gerência de Relações Comerciais e Industriais da IBM BrasilO parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO" SEM GARANTIA DE ESPÉCIE ALGUMA, EXPLÍCITA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE NÃO-VIOLAÇÃO, COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM FIM ESPECÍFICO. Alguns países não permitem a exclusão de garantias explícitas ou implícitas em certas transações; portanto, esta disposição pode não se aplicar a você.
Estas informações podem conter imprecisões técnicas ou erros tipográficos. Periodicamente são feitas alterações às informações aqui contidas; elas serão incorporadas às novas edições da publicação. A IBM pode fazer aperfeiçoamentos e/ou alterações nos produtos e/ou programas descritos nesta publicação a qualquer momento, sem aviso prévio.
Quaisquer referência encontradas nesta informação aos sites Web não-IBM são fornecidas apenas por motivo de praticidade e de maneira alguma servem como endosso a tais sites Web. Os materiais contidos nesses sites da Web não fazem parte dos materiais deste produto IBM e a utilização desses sites da Web é de inteira responsabilidade do cliente.
Licenciados do programa que desejem obter informações a respeito dele a fim de permitir: (i) a troca de informações entre programas criados independentemente de outros programas (incluindo este) e (ii) o uso mútuo das informações que foram trocadas devem entrar em contato com Centro de Atendimento IBM.
Centro de Atendimento IBM Department 071Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns casos, o pagamento de uma taxa.
O programa licenciado descrito nestas informações e todo o material licenciado disponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, Contrato de Licença de Programa Internacional IBM ou qualquer contrato equivalente.
Esta documentação descreve a Interface de Programação de Uso Geral e as Informações de Orientação Associadas fornecidas pelo IBM WebSphere Development Tools para AS/400.
Os termos a seguir são marcas ou marcas registradas da
International Business Machines Corporation nos Estados Unidos e/ou em outros países:
|
|
|
|
InstallShield é uma marca da InstallShield Corporation.
Intel e Pentium são marcas registradas da Intel Corporation.
Java e todas as marcas baseadas em Java são marcas ou marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.
Netscape Navigator é uma marca do Netscape Communications Corporation.
Lotus, Lotus Notes e Domino são marcas ou marcas registradas da Lotus Development Corporation nos Estados Unidos e/ou em outros países.
ActiveX, Microsoft, SourceSafe, Visual C++, Visual SourceSafe, Windows, Windows NT, Win32, Win32s e o logotipo do Windows são marcas ou marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.
UNIX é uma marca registrada nos Estados Unidos e em outros países licenciada exclusivamente através da The Open Group.
Outros nomes de empresas, produtos e serviços podem ser marcas ou marcas de serviço de outros.