IBM Host Access Transformation Services: Guia do Usuário e ... · Utilizando o Assistente de...

IBM Host Access Transformation Services

Guia do Usurio e do AdministradorVerso 9.5

S517-1492-01

IBM

IBM Host Access Transformation Services

Guia do Usurio e do AdministradorVerso 9.5

S517-1492-01

IBM

NotaAntes de utilizar estas informaes e o produto suportado por elas, leia as informaes gerais no Apndice C, Avisos, napgina 569.

Dcima Edio (novembro de 2015)

Copyright IBM Corporation 2003, 2015.

ndice

Captulo 1. Utilizando o HATS (HostAccess Transformation Services) . . .. 1Entendendo os Conceitos e Objetos-Chave do HATS 2Entendendo o Processamento do Aplicativo do HATS 9Entendendo o Desenvolvimento de AplicativosHATS . . . . . . . . . . . . . . .. 12Como Posso Saber Qual a Minha Verso doHATS? . . . . . . . . . . . . . . .. 13Reunindo Informaes sobre Determinao deProblemas . . . . . . . . . . . . . .. 14Onde Posso Encontrar Informaes sobre o HATS? 14

Captulo 2. Migrando para o HATS V9.5 17Migrao do HATS . . . . . . . . . . .. 17

Importando um projeto do HATS . . . . .. 17Utilizando o Assistente de Migrao HATS . .. 18Migrando Transformaes do HATS . . . .. 19Consideraes Especiais sobre Migrao . . .. 19

Usurios do HATS para Host Publisher . . . .. 25Migrando do Host Publisher Verso 4 . . .. 26

Migrao do J2EE . . . . . . . . . . .. 29

Captulo 3. Desenvolvendo eImplementando Aplicativos da Web doHATS . . . . . . . . . . . . . .. 31Organizando Aplicativos da Web do HATS . . .. 33

Movendo Projetos da Web do HATS para umArquivo .ear Diferente . . . . . . . . .. 34

Fazendo Backup de Projetos do HATS . . . .. 34Exportando e Importando Projetos da Web do HATS 35

Exportando um Projeto da Web. . . . . .. 35Importando um Projeto da Web . . . . .. 35

Implementando Aplicativos HATS da Web . . .. 36Ativando o Tempo de Execuo do HATS . .. 36Exportando seu Projeto como um Aplicativo JavaEE . . . . . . . . . . . . . . .. 37Instalando seu Aplicativo em um Ambiente deTempo de Execuo . . . . . . . . .. 37Alteraes Necessrias no Ambiente de Tempode Execuo . . . . . . . . . . . .. 39

Desenvolvendo aplicativos do HATS para o ApacheGeronimo Server . . . . . . . . . . .. 41

Instalando e Configurando para ServidoresGeronimo . . . . . . . . . . . . .. 42Consideraes e Limitaes para ServidoresGeronimo . . . . . . . . . . . . .. 43

Desenvolvendo Aplicativos do HATS para o OracleWebLogic Server. . . . . . . . . . . .. 43

Instalao e Configurao de ServidoresWebLogic . . . . . . . . . . . . .. 43Consideraes e Limitaes para ServidoresWebLogic . . . . . . . . . . . . .. 45

Desenvolvendo aplicativos do HATS para o IBMBluemix Server . . . . . . . . . . . .. 45

Configurando o Rational SDP for IBM BluemixServer . . . . . . . . . . . . . .. 45Consideraes e limitaes do IBM BluemixServer . . . . . . . . . . . . . .. 46

Desenvolvendo aplicativos do HATS para oWebSphere Application Server Liberty Profile . .. 47

Consideraes e limitaes do WebSphereApplication Server Liberty Profile . . . . .. 48

Desenvolvendo aplicativos do HATS paradispositivos mveis. . . . . . . . . . .. 49

Consideraes e limitaes para dispositivosmveis . . . . . . . . . . . . . .. 49Consideraes e Limitaes dos Dispositivos iPad 57Consideraes e Limitaes para DispositivosAndroid . . . . . . . . . . . . .. 57

Captulo 4. Desenvolvendo eImplementando Aplicativos Rich Clientdo HATS . . . . . . . . . . . . .. 59Desenvolvendo Aplicativos Rich Client do HATS .. 60Especficos da Plataforma de Destino . . . . .. 61

Contedo do Projeto . . . . . . . . .. 61Configurando o Nvel de Conformidade doCompilador . . . . . . . . . . . .. 62

Projeto de Extenso de Tempo de Execuo RCP doHATS . . . . . . . . . . . . . . .. 62Trabalhando com Projetos do Rich Client do HATS 63

Copiando Recursos entre Projetos da Web e RichClient . . . . . . . . . . . . . .. 65Exportando e Importando Projetos do Rich Clientdo HATS . . . . . . . . . . . . .. 66

Testando Aplicativos Rich Client do HATS . . .. 67Configurando a Plataforma de Destino . . .. 67Instalando Plug-ins de Tempo de Execuo . .. 68Configurando o JRE Padro . . . . . . .. 69Ativando seu Projeto . . . . . . . . .. 70

Implementando Aplicativos HATS Rich Client . .. 72Empacotando um Ambiente do Cliente Eclipsepara Distribuio . . . . . . . . . .. 72Empacotando Clientes Eclipse Existentes (EclipseRCP, Lotus Notes ou Lotus Expeditor Client) .. 73Atualizando Nmeros de Verso de Plug-in eRecurso. . . . . . . . . . . . . .. 83

Administrando Aplicativos Rich Client do HATS .. 84Ambiente de Tempo de Execuo . . . . . .. 84

visualizao Aplicativos . . . . . . . .. 84Visualizao Transformao . . . . . . .. 87Prompt do ID da Estao de Trabalho . . .. 89solicitao do nome da LU . . . . . . .. 89Preferncias . . . . . . . . . . . .. 89

Consideraes e Limitaes do Rich Client do HATS 93

Captulo 5. Modificando um projeto doHATS . . . . . . . . . . . . . .. 95Viso Geral . . . . . . . . . . . . .. 95

Copyright IBM Corp. 2003, 2015 iii

||

|||

||||||||||||

Conexes . . . . . . . . . . . . . .. 97Modelo . . . . . . . . . . . . . . .. 98Processamento . . . . . . . . . . . .. 98

Apresentao Padro . . . . . . . . .. 98Regras globais . . . . . . . . . . .. 103Substituio de Texto . . . . . . . . .. 107Componentes e Widgets . . . . . . . .. 107Barra de FerramentasApenas RCP . . . . . . . . . . .. 108Teclado Numrico do Aplicativo . . . . .. 108Teclado numrico do host . . . . . . .. 109Operator Information Area . . . . . . .. 109DBCS . . . . . . . . . . . . . .. 111

Eventos . . . . . . . . . . . . . .. 111Prioridade de Evento de Tela . . . . . .. 111Eventos do Aplicativo . . . . . . . .. 112

Outro . . . . . . . . . . . . . . .. 116Suporte do teclado . . . . . . . . .. 116Cdigo do Idioma do Cliente . . . . . .. 117Substituies de Parmetros de Conexo . .. 117Atualizao Assncrona -Apenas RCP . . . . . . . . . . .. 120Desconexo e Atualizao Automticas -Apenas Web . . . . . . . . . . .. 120Substituies de Variveis Globais . . . .. 127Configuraes do Cliente . . . . . . .. 128Assistncia de Contedo da Macro . . . .. 133Configuraes do Portlet . . . . . . .. 134

Origem . . . . . . . . . . . . . .. 135Usando as preferncias do HATS . . . . . .. 135Utilizao de Outras Preferncias do Rational SDP 140

Captulo 6. Gerenciando as Conexes 143Criando uma conexo . . . . . . . . .. 143Editor de Conexo. . . . . . . . . . .. 144

Viso Geral . . . . . . . . . . . .. 144Bsico . . . . . . . . . . . . . .. 144Avanado . . . . . . . . . . . .. 145Impresso . . . . . . . . . . . .. 148Manipulao de Tela . . . . . . . . .. 150Segurana . . . . . . . . . . . .. 152Conjunto . . . . . . . . . . . . .. 154Macros . . . . . . . . . . . . .. 155Lista de Usurios . . . . . . . . . .. 156Origem . . . . . . . . . . . . .. 158

Captulo 7. Trabalhando com Eventosde Tela . . . . . . . . . . . . .. 159Assistente para Criar uma Customizao de Tela 159Assistente para Criar uma Combinao de Telas 160Editando Eventos de Telas . . . . . . . .. 160

Viso Geral . . . . . . . . . . . .. 160Critrios de Reconhecimento de Tela ou Tela deIncio . . . . . . . . . . . . . .. 161Renderizao (Apenas Combinao de Telas) 166Navegao (Apenas Combinao de Telas) .. 166Tela Final (Apenas Combinao de Telas) . .. 166Aes . . . . . . . . . . . . . .. 167Regras Globais . . . . . . . . . . .. 179Substituio de texto . . . . . . . . .. 180

Prxima Tela . . . . . . . . . . .. 182Origem . . . . . . . . . . . . .. 182

Telas Ocultas . . . . . . . . . . . .. 182Critrios de Reconhecimento . . . . . .. 183Manipulao Automtica de Telas Inibidas .. 183Manipulando Vrias Telas Inibidas . . . .. 184

Importando Conjuntos de Mapas BMS . . . .. 184

Captulo 8. Trabalhando comTransformaes . . . . . . . . .. 187Assistente para Criar uma Transformao . . .. 187Editando Transformaes . . . . . . . .. 189

Editando Transformaes para Projetos da Web 189Editando Transformaes para Projetos do RichClient . . . . . . . . . . . . . .. 193Resumo das Diferenas entre EditarTransformaes da Web e do Rich Client . .. 195

Assistentes de Transformao . . . . . . .. 195Inserir Componente do Host . . . . . .. 195Editar Componente do HostApenas Web . . . . . . . . . . .. 197Edio de Transformao de DojoApenas Web . . . . . . . . . . .. 198Inserir Processamento Padro . . . . . .. 198Editar Processamento PadroApenas Web . . . . . . . . . . .. 198Inserir Pasta TabuladaApenas Web . . . . . . . . . . .. 199Inserir Chave de Macro . . . . . . . .. 200Inserir Varivel Global . . . . . . . .. 200Inserir rea de Informaes do OperadorApenas Web . . . . . . . . . . .. 201Inserir Teclado Numrico do Host . . . .. 201Inserir Teclado Numrico do Aplicativo . .. 201Inserir Todos os Componentes do HostApenas Web . . . . . . . . . . .. 202Inserir a Tela ArmazenadaApenas Web . . . . . . . . . . .. 202

Visualizando Transformaes . . . . . . .. 203Teclado numrico do host . . . . . . . .. 203

Captulo 9. Descries eConfiguraes do Componente e doWidget . . . . . . . . . . . . .. 205Configuraes de componente e widget . . .. 205Configuraes de Componentes de Host . . .. 205

Linha de Comandos . . . . . . . . .. 206Dilogo . . . . . . . . . . . . .. 207ENPTUI . . . . . . . . . . . . .. 211Campo . . . . . . . . . . . . .. 213Tecla de Funo . . . . . . . . . .. 215Palavra-chave DDS HTMLApenas Web . . . . . . . . . . .. 217Campo de Entrada . . . . . . . . .. 219Campo de Entrada com Sugestes . . . .. 221Seleo de Item. . . . . . . . . . .. 224Light Pen (Ateno) . . . . . . . . .. 226Caneta de Luz (Seleo) . . . . . . . .. 228Lista de Seleo . . . . . . . . . .. 230Subarquivo . . . . . . . . . . . .. 233

iv IBM Host Access Transformation Services: Guia do Usurio e do Administrador

Tabela . . . . . . . . . . . . . .. 240Tabela (Campo). . . . . . . . . . .. 242Tabela (visual) . . . . . . . . . . .. 244Texto . . . . . . . . . . . . . .. 246URL . . . . . . . . . . . . . .. 247

Configuraes de Widget . . . . . . . .. 248Boto . . . . . . . . . . . . . .. 249Tabela de botes . . . . . . . . . .. 251CalendrioApenas Web . . . . . . . . . . .. 253Caixa de opes . . . . . . . . . .. 260CombinaoApenas RCP . . . . . . . . . . .. 262Dilogo . . . . . . . . . . . . .. 265Drop-down (entrada de dados) . . . . .. 267Drop-down (seleo) . . . . . . . . .. 271Campo . . . . . . . . . . . . .. 274Grfico (Barra Horizontal, Linha, Barra Vertical) 282Rtulo. . . . . . . . . . . . . .. 287Link . . . . . . . . . . . . . .. 289Link (Seleo de Itens) . . . . . . . .. 291Lista . . . . . . . . . . . . . .. 293Pop-up . . . . . . . . . . . . .. 297Boto de Opes (Entrada de Dados) . . .. 303Boto de Opes (Seleo de Itens) . . . .. 306Boto de Opes (Seleo) . . . . . . .. 309Barra de Rolagem (ENPTUI) . . . . . .. 312Subarquivo (Caixa de Opes). . . . . .. 314Subarquivo (drop-down) . . . . . . .. 322Subarquivo (Pop-up) . . . . . . . . .. 330Tabela . . . . . . . . . . . . . .. 339Entrada de Texto . . . . . . . . . .. 346Barra de FerramentasApenas RCP . . . . . . . . . . .. 350

Configuraes de Widget (Dojo) . . . . . .. 354Consideraes e Limitaes do Widget DojoHATS . . . . . . . . . . . . . .. 354Caixa de Combinao (Dojo)Apenas Web . . . . . . . . . . .. 355Caixa de Texto de Data (Dojo)Apenas Web . . . . . . . . . . .. 357Grade Melhorada (Dojo)Apenas Web . . . . . . . . . . .. 360Seleo de Filtragem (Dojo)Apenas Web . . . . . . . . . . .. 361Caixa de Texto (Dojo)Apenas Web . . . . . . . . . . .. 364Caixa de Texto de Validao (Dojo)Apenas Web . . . . . . . . . . .. 364

Mapeamento de componente e widget . . . .. 366

Captulo 10. Utilizando Modelos . .. 369Exemplos de Modelo . . . . . . . . . .. 369Assistente para Criar um Modelo. . . . . .. 373Editando Modelos . . . . . . . . . . .. 374

Editando Modelos para Projetos da Web . .. 374Editando Modelos para Projetos do Rich Client 379

Teclado Numrico do Aplicativo . . . . . .. 380

Captulo 11. Macros e Terminal Host 383Editor de Macro . . . . . . . . . . .. 384

Viso Geral . . . . . . . . . . . .. 384Avisos e Extraes. . . . . . . . . .. 396Origem . . . . . . . . . . . . .. 396

Trabalhando com erros de macro . . . . . .. 396Importando uma Macro . . . . . . . . .. 397Exportando uma Macro . . . . . . . . .. 397Sugestes e Dicas de Macros . . . . . . .. 398

Evitando um Loop Infinito . . . . . . .. 398Manipulando Telas Temporrias . . . . .. 398

Captulo 12. Interagindo com variveisglobais . . . . . . . . . . . . .. 399Renomeando Variveis Globais . . . . . .. 401Diferenas Entre Variveis Globais e Variveis deMacro . . . . . . . . . . . . . . .. 401

Variveis Globais . . . . . . . . . .. 401Variveis de Macro . . . . . . . . .. 401

Captulo 13. Usando objetos deintegrao. . . . . . . . . . . .. 403Criando um Objeto de Integrao . . . . .. 403Encadeamento do Objeto de Integrao. . . .. 404

Decidindo Quando Utilizar o Encadeamento doObjeto de Integrao . . . . . . . . .. 405Utilizando o Encadeamento de Objetos deIntegrao . . . . . . . . . . . .. 405Depurando Aplicativos que Utilizam oEncadeamento do Objeto de Integrao. . .. 407

Construindo Pginas da Web a partir de um Objetode Integrao . . . . . . . . . . . .. 408

Criar Pginas da Web do Modelo 1 . . . .. 408Criar Pginas da Web do Struts . . . . .. 409Criar Pginas da Web JSF . . . . . . .. 410

BasicIOErrorPage.jsp e AdvancedIOErrorPage.jsp 411Trabalhando com Objetos de Integrao em JSPs 412

Inserir Propriedades do Objeto de Integrao 412Inserir Redirecionar para o Aplicativo do HATS 413

Captulo 14. Combinando Telas. . .. 415Combinando Dados de Sada Contguos . . .. 415Combinando Dados de Sada no Contguos . .. 415Combinando a Sada de Vrios Aplicativos . .. 416Combinando a Entrada para Vrias Telas . . .. 416

Captulo 15. Ativando o suporte aimpresso . . . . . . . . . . . .. 417Configurando a Sesso de Impresso do Host emHosts 3270 . . . . . . . . . . . . .. 417Definindo Suporte Impresso para seu Projeto 417

Para Conexes 3270E . . . . . . . . .. 417Para Conexes 5250 . . . . . . . . .. 420

Fornecendo Documentao para Usurios . . .. 421

Captulo 16. Ativando o suporte ateclado . . . . . . . . . . . . .. 423Definindo o suporte a teclado . . . . . . .. 423Alterando a Aparncia dos Keypads. . . . .. 423

ndice v

Fornecendo Documentao para Usurios . . .. 424Suporte Tecla de Campo 5250 Especial . .. 426

Remapeando o Teclado em um Aplicativo doHATS . . . . . . . . . . . . . . .. 427

Conceitos a Serem Entendidos antes deRemapear as Teclas do HATS . . . . . .. 427Remapeando Teclas para Aplicativos da Web doHATS . . . . . . . . . . . . . .. 430Remapeando Teclas para Aplicativos Rich Clientdo HATS . . . . . . . . . . . . .. 433Incluindo Botes do Keypad Adicionais em umaTransformao . . . . . . . . . . .. 435

Captulo 17. Utilizando a Simulao deHost . . . . . . . . . . . . . .. 437Assistente para Simulao de Host . . . . .. 437Editor de Simulao de Host . . . . . . .. 438

Guia Viso Geral . . . . . . . . . .. 438Guia Origem . . . . . . . . . . .. 439

Gravao no Ambiente de Tempo de Execuo .. 439Opes de Reproduo . . . . . . . . .. 439Importando e Exportando Arquivos de Rastreio 440

Captulo 18. Usando o consoleadministrativo do HATS . . . . . .. 441Console administrativo do HATS e segurana doWebSphere . . . . . . . . . . . . .. 441Funes do Console Administrativo do HATS .. 443Iniciando o Console Administrativo do HATS .. 444

Iniciando o Console Administrativo EnquantoEst no HATS Toolkit. . . . . . . . .. 445

Utilizando as Funes no Console Administrativodo HATS . . . . . . . . . . . . . .. 445

Selecionando Escopo de Gerenciamento . .. 445Gerenciando Licenas . . . . . . . .. 446Monitorando Conexes . . . . . . . .. 447Monitorando Conjuntos de Conexes . . .. 447Monitorando Configuraes de Conjuntos . .. 447Monitorando Listas de Usurios e Membros deListas de Usurios . . . . . . . . . .. 447Administrando Componentes de Determinaode Problemas . . . . . . . . . . .. 448

Funes do Terminal de Vdeo . . . . . .. 452Utilizando o Terminal de Exibio para Teste eDepurao . . . . . . . . . . . .. 452

Captulo 19. WebSphere Portal eHATS . . . . . . . . . . . . . .. 453Criando Portlets do HATS . . . . . . . .. 453

Criando um Novo Projeto de Portlet do HATS 454Gerando Portlets de Projetos da Web do HATS 454

Trabalhando com Portlets do HATS . . . . .. 456Substituies de Parmetros de Conexo eVariveis Globais . . . . . . . . . .. 456Comunicao de Portlet . . . . . . . .. 457PDTs Customizados e Tabelas Customizadas 460Servios da Web para Portlets Remotos . . .. 460

Testando Portlets do HATS . . . . . . . .. 461Exportando Portlets do HATS . . . . . . .. 461Administrando portlets do HATS. . . . . .. 461

Usando um aplicativo administrativoindependente do HATS . . . . . . . .. 462

Consideraes e limites do portlet do HATS . .. 463Consideraes e limites comuns . . . . .. 463

Captulo 20. WebFacing e HATS . .. 467Interao do HATS com o WebFacing . . . .. 467

Conexo do HATS com um Servidor deWebFacing . . . . . . . . . . . .. 467Interoperabilidade do HATS com AplicativosWebFacing . . . . . . . . . . . .. 468

Captulo 21. Segurana e WebExpress Logon. . . . . . . . . .. 471Ativando a Segurana de SSL . . . . . . .. 471Ativando a Segurana SSH . . . . . . . .. 474Utilizando o Web Express Logon (WEL) . . .. 474

Viso Geral . . . . . . . . . . . .. 474Arquitetura . . . . . . . . . . . .. 475Planejando a Implementao . . . . . .. 476Implementao . . . . . . . . . . .. 476Como Criar uma Macro de Logon do WEL .. 477Plug-in de Segurana da Rede . . . . . .. 478Plug-ins do Credential Mapper . . . . .. 478Parmetros de Inicializao. . . . . . .. 480Criar Arquivo de Armazenamento de ChavesSSL (Apenas DCAS) . . . . . . . . .. 486

Usando Tickets de Servios do Kerberos . . .. 488Segurana de Java 2 . . . . . . . . . .. 489

Arquivo de Polticas . . . . . . . . .. 489Usando o IBM Certificate Management paraAplicativos HATS . . . . . . . . . . .. 490

Criando um Arquivo de Banco de Dados Chave 490Solicitando e Armazenando Certificados dasAutoridades de Certificao . . . . . .. 491Usando um certificado autoassinado . . .. 493Trocando Certificados . . . . . . . .. 494Consideraes da Ferramenta de Gerenciamentode Certificado . . . . . . . . . . .. 494

Captulo 22. Suporte a Idiomas . . .. 497Cdigos de Idioma . . . . . . . . . .. 497Pginas de Cdigos . . . . . . . . . .. 498Configuraes de Codificao . . . . . . .. 500Suporte ao 5250 Unicode . . . . . . . .. 501Utilizando Caracteres Acentuados para a Pgina deCdigos 937 . . . . . . . . . . . . .. 501Usando a Pgina de Cdigos 1388 (GB18030) . .. 501Mapeamento de Cdigo de Host para Pginas deCdigos 1390 e 1399 . . . . . . . . . .. 502

Suporte JIS2004. . . . . . . . . . .. 502Remapeando os Caracteres do Teclado e da Tela 505

Prioridade de Substituio de Caracteres . .. 506

Captulo 23. Suporte ao AplicativoBidirecional . . . . . . . . . . .. 507Ambiente do Software . . . . . . . . .. 508Trabalhando com Terminal Host . . . . . .. 508

Limitaes do Terminal Host . . . . . .. 510Capturando Telas . . . . . . . . . .. 510

vi IBM Host Access Transformation Services: Guia do Usurio e do Administrador

Reconhecendo Componentes Bidirecionais do Host 510Controlando a Orientao de Widgets . . . .. 511Controlando o Alinhamento de Widgets . . .. 512Suporte Bidirecional a Componentes e WidgetsPersonalizados . . . . . . . . . . . .. 513Variveis Globais . . . . . . . . . . .. 513Substituio de Texto . . . . . . . . . .. 513Regras Globais . . . . . . . . . . . .. 514Permitindo que o Usurio Reverta a Direo daTela . . . . . . . . . . . . . . .. 514Opes de Exibio Bidirecional do VT . . . .. 515Opes Bidirecionais de Aviso e Extrao de Macro 516Opes Bidirecionais de Consulta SQL de Macro 516Suporte Impresso da Direita para a Esquerda 517Suporte ao Mapa BMS . . . . . . . . .. 517Suporte ao Objeto de Integrao . . . . . .. 518Suporte de Servios da Web Bottom-up. . . .. 519Suporte de Servios da Web RESTful . . . .. 520Suporte ao Portlet . . . . . . . . . . .. 520Informaes para Usurios . . . . . . . .. 520

Campo Reverso Automtico . . . . . .. 521Campo Reverso . . . . . . . . . .. 522Funes da rea de Transferncia . . . .. 522OIA (Operator Information Area) . . . . .. 522Comutao de Camada de Teclado Automtico 522

Suporte a Unicode do IBM i 5250. . . . . .. 523Funes para Pginas de Cdigos rabes . . .. 523

Orientao de Tela do HATS Toolkit . . . .. 523Customizando a Direo para Pginas JSP. .. 524Direo de Formato . . . . . . . . .. 524Formato Seletivo rabe . . . . . . . .. 524Troca Simtrica e Numrica . . . . . .. 524Desativar entrada de rabe-dgitos ocidentais 525Comutao de Camada de Teclado Automtico 525Limitaes do Terminal Host . . . . . .. 525Capturas de Tela . . . . . . . . . .. 525Configurando Sesses de Impresso em rabeno System i Access for Web . . . . . .. 526Outras Consideraes . . . . . . . .. 526

Incluses em Arquivos do HATS . . . . . .. 527

Captulo 24. Suporte a conjunto decaracteres de byte duplo . . . . .. 529Suporte ao Campo DBCS e SBCS . . . . . .. 529Verificao de tipo de dados . . . . . . .. 530Verificao de comprimento de campo . . . .. 530Preveno para copiar e colar . . . . . . .. 530IME (Input Method Editor) . . . . . . . .. 530Mudana de AutoIME . . . . . . . . .. 531Consideraes sobre Shift Out/Shift In . . . .. 531Outras Consideraes . . . . . . . . .. 532

Configuraes de Tema do Projeto . . . .. 532Editor de Configuraes do Projeto . . . .. 532Editor de Eventos de Tela . . . . . . .. 534

Componentes de Host . . . . . . . .. 534Widgets . . . . . . . . . . . . .. 535Suporte Macro . . . . . . . . . .. 536Criando um Objeto de Integrao . . . .. 536Trabalhando com aplicativos de dispositivomvel . . . . . . . . . . . . . .. 536Remapeando os Caracteres do Teclado e da Tela 537Trabalhando com caracteres definidos pelousurio . . . . . . . . . . . . .. 537

Apndice A. Arquivo de Propriedadesde Tempo de Execuo . . . . . .. 543Opes de Rastreio . . . . . . . . . .. 547Rastreio Host On-Demand . . . . . . . .. 548Rastreio de Simulao de Host . . . . . .. 550

Apndice B. Referncia deOrganizao de Tela do HATS . . .. 553Viso Geral da Organizao de Tela . . . . .. 553Procedimento de Organizao de Tela . . . .. 553Analisando dados de sada . . . . . . . .. 554Esperando Sinalizadores OIA . . . . . . .. 557Alterando Configuraes de Customizao . .. 558Determinando Qual Estratgia o HATS EstUtilizando . . . . . . . . . . . . .. 559Resoluo de Conteno (Apenas TN3270E) . .. 559

Resoluo de Contedo Utilizando o z/OSCommunications Server . . . . . . . .. 560Resoluo de Conteno Utilizando OutrosServidores de Comunicao . . . . . .. 560Impacto no Desempenho de Utilizao daResoluo de Conteno . . . . . . . .. 561Determinando o Status da Resoluo deConteno . . . . . . . . . . . .. 561

Atualizao Automtica . . . . . . . . .. 562Manipulao de Tela Transitria . . . . . .. 562Configuraes de Manipulao de Tela em BrancoInicial . . . . . . . . . . . . . . .. 564Configuraes do HATS Relacionadas . . . .. 565Ajustando a Organizao de Tela do HATS . .. 566Referncias . . . . . . . . . . . . .. 568

Informaes Sobre a Resoluo de Conteno 568Guia de Macros Avanadas . . . . . . .. 568

Apndice C. Avisos . . . . . . . .. 569Informaes da interface de programao . . .. 571Marcas Registradas . . . . . . . . . .. 571

Glossrio . . . . . . . . . . . .. 573

ndice Remissivo . . . . . . . . .. 583

ndice vii

viii IBM Host Access Transformation Services: Guia do Usurio e do Administrador

Captulo 1. Utilizando o HATS (Host Access TransformationServices)

Com o IBM Host Access Transformation Services (HATS), possvel criaraplicativos da Web e aplicativos do rich client que fornecem uma interface grficacom o usurio (GUI) de fcil uso para os aplicativos do 3270 em execuo emplataformas do IBM z Systems e os aplicativos 5250 em execuo em plataformasdo sistema operacional IBM i. Aplicativos HATS podem acessar aplicativos 5250sem necessitarem da capacidade OLPT (Online Transaction Processing). Nestemanual, estes aplicativos 3270 e 5250 baseados em caracteres so referenciadoscomo aplicativos host. Tambm possvel criar recursos de Arquitetura Orientadaa Servios (SOA) utilizando servios da Web que fornecem interfaces deprogramao padro para lgica de negcios e transaes contidas nos aplicativoshost. Os dados nas telas de emulao de terminal de vdeo (VT) tambm podemser acessados.

Os aplicativos HATS podem ter uma aparncia moderna. aplicativos HATS da Webpodem ser desenvolvidos com uma interface que corresponde s pginas da Webou do portal da sua empresa e os usurios podem acess-las por meio denavegadores da Web. Aplicativos da Web do HATS tambm pode serdesenvolvidos para fornecer acesso a seus aplicativos host a partir de dispositivosremotos, como telefones celular, terminais de coleta de dados e PDAs (PersonalDigital Assistants).

Os aplicativos rich client do HATS podem ser desenvolvidos para seremexecutados em uma implementao do Eclipse Rich Client Platform (RCP), noLotus Notes ou no Lotus Expeditor Client para fornecer aplicativos clientes nativosdestinados ao desktop de um usurio. Para obter informaes adicionais sobre oambiente Eclipse RCP, consulte http://www.eclipse.org/home/categories/rcp.php.Para obter mais informaes sobre o Lotus Notes, consulte o Knowledge Center doLotus Notes em http://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.html. Para obter mais informaes sobre oLotus Expeditor Client, consulte o Knowledge Center do Lotus Expeditor emhttp://www-01.ibm.com/support/knowledgecenter/SSVHEW_6.2.0/welcome.html.

Para obter informaes sobre o que novo no HATS V9.5, consulte Introduo doHATS.

Nota: Em todo esse documento, as definies de configurao que se aplicamsomente a aplicativos da Web do HATS e a aplicativos EJB, a no ser queobservado de outra forma, esto marcadas comApenas Web. As definies de configurao que se aplicam apenas aosaplicativos da plataforma rich client do HATS so marcadas comApenas RCP.

O HATS tem dois componentes:v O HATS Toolkit um conjunto de plug-ins para o IBM Rational Software

Delivery Platform baseado no Eclipse (Rational SDP). Para obter maisinformaes sobre quais verses do Rational SDP so suportadas, consulte aseo Pr-requisitos na publicao Introduo do HATS.

Copyright IBM Corp. 2003, 2015 1

||||||||||||

|||||||

|

||||||

http://www.eclipse.org/home/categories/rcp.phphttp://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.htmlhttp://www-01.ibm.com/support/knowledgecenter/SSKTMJ_8.5.3/welcome_Domino_8_5_3.htmlhttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsphttp://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jspgsintro.htm#whatsnewgsintro.htm#whatsnewgsinstal.htm#prereqs

O HATS Toolkit permite desenvolver novos aplicativos, uma etapa por vez,visualizando e salvando cada mudana feita. Com o tempo, ou com a rapidezque voc desejar, possvel simplificar seu aplicativo HATS, tornando-o maisfcil de utilizar do que os aplicativos host cujos dados so apresentados por elee, possivelmente, mover as funes dos aplicativos host em seus aplicativos doHATS. O processo de desenvolvimento para construo de aplicativos da Web edo rich client do HATS semelhante. Para obter informaes adicionais, consulteEntendendo o Desenvolvimento de Aplicativos HATS na pgina 12.Aps ter desenvolvido um aplicativo HATS, voc o implementa em umambiente de tempo de execuo de produo.

v O cdigo de tempo de execuo do HATS executado como parte de umaplicativo HATS implementado no ambiente de tempo de execuo de produo,WebSphere Application Server, WebSphere Portal, servidor de aplicativos da webApache Geronimo com o continer da web Tomcat, Oracle WebLogic Server ou aplataforma rich client. Os usurios interagem com o aplicativo HATS atravs daGUI do HATS e os dados so enviados e recebidos entre o usurio e o aplicativohost.

Para obter informaes adicionais consulte o Captulo 3, Desenvolvendo eImplementando Aplicativos da Web do HATS, na pgina 31 e o Captulo 4,Desenvolvendo e Implementando Aplicativos Rich Client do HATS, na pgina59.

Entendendo os Conceitos e Objetos-Chave do HATSEsta seo explica os conceitos chave e os objetos do HATS, alguns dos quais estodescritos em Entendendo o Processamento do Aplicativo do HATS na pgina 9.Vrios objetos chave no HATS so criados utilizando um assistente, mas soexibidos ou modificados aps a criao utilizando um editor.

ProjetoUma coleta de recursos do HATS (tambm chamados de artefatos), que socriados utilizando assistentes do HATS Toolkit e customizados por editoresdo HATS Toolkit. Esses recursos so exportados como um aplicativo doHATS. H cinco tipos de projetos do HATS: Web, EJB, rich client e parapropsitos de administrao de aplicativos da Web do HATS (incluindo eEJB), projetos de console administrativo do HATS. Para obter informaesadicionais, consulte Captulo 3, Desenvolvendo e ImplementandoAplicativos da Web do HATS, na pgina 31.

EventoUm recurso do HATS um recurso que executa um conjunto de aes combase de um determinado estado sendo atingido. Existem dois tipos deeventos do HATS, eventos de aplicativos e eventos de tela.

Evento de AplicativoUm evento do HATS acionado por alteraes de estado no ciclo de vida doaplicativo. Os exemplos de evento de aplicativo incluem o primeiro acesso deum usurio ao aplicativo do HATS (um evento Incio), ou um aplicativoencontrando uma tela no reconhecida (um evento Tela NoCorrespondente). Para obter informaes adicionais, consulte Eventos doAplicativo na pgina 112.

Evento de TelaUm evento do HATS que acionado quando uma tela do host reconhecidapor atender a critrios de reconhecimento de tela especficos. H dois tiposde eventos de tela, customizaes de tela e combinaes de telas.

2 IBM Host Access Transformation Services: Guia do Usurio e do Administrador

|

||||||||

Personalizao de TelaUm evento de tela do HATS projetado para executar um conjunto de aesquando uma tela do host reconhecida. Exemplos de customizaes de telasincluem o reconhecimento de uma tela e sua transformao em uma GUIpara o usurio ou a ativao de uma macro para ignorar essa tela. Adefinio de customizao de tela inclui um conjunto de critrios dereconhecimento de tela e uma lista de aes que podem ser tomadas quandouma tela do host atende aos critrios de reconhecimento de tela. As regrasglobais do nvel de tela e as configuraes de substituio de texto tambmso includas. Para obter informaes adicionais, consulte Captulo 7,Trabalhando com Eventos de Tela, na pgina 159.

Combinao de TelasUm evento de tela do HATS projetado para reunir dados de sada de telas dehost consecutivas e semelhantes, combin-las e exibi-las em uma nicapgina de sada. Um exemplo de uma combinao de telas inclui reconheceruma tela que contm apenas dados parciais e navegar por todas as telassubseqentes para reunir todos os dados restantes para exibir ao usurio. Adefinio de combinao de telas inclui um conjunto de critrios dereconhecimento de tela para as telas inicial e final a serem combinadas, comonavegar de tela em tela e o componente e widget a serem utilizados parareconhecer e exibir os dados reunidos de cada tela. Alm disso, ela incluiuma lista de aes a serem executadas uma ou mais vezes, regras globais donvel da tela e configuraes de substituio de texto. Para obter informaesadicionais, consulte Captulo 7, Trabalhando com Eventos de Tela, napgina 159.

Critrios de Reconhecimento de TelaAo criar um evento de tela, voc configura critrios de reconhecimento detela utilizados pelo HATS para corresponder uma ou mais telas. As telas dohost podem ser reconhecidas por qualquer combinao de critrios, incluindoquantos campos ou campos de entrada esto na tela, as coordenadas daposio do cursor e as cadeias de texto na tela em um retngulo definido ouem qualquer lugar na tela. Voc tambm pode utilizar variveis globais, cor,regio de comparao com valor e regio de comparao com critrios deregio para critrios de reconhecimento de tela.

Quando um host exibe uma tela, o HATS determina se a tela de host atualcorresponde a qualquer critrio de reconhecimento da tela que vocconfigurar em qualquer evento de tela em seu projeto. Se o HATS localizaruma correspondncia, as aes definidas para o evento de tela seroexecutadas.

Para obter informaes adicionais sobre a configurao de critrios dereconhecimento de tela, consulte Critrios de Reconhecimento de Tela ouTela de Incio na pgina 161.

AoUma etapa que executada quando ocorre um evento, como quando encontrada uma tela do host que corresponde aos critrios de reconhecimentode tela especificados para um evento de tela. Uma lista de aes parte dadefinio de cada evento e evento de tela. do aplicativo.

TransformaoUm arquivo A JSP (JavaServer Pages) (para projetos da Web) ou umcomposto SWT (Standard Widgets Toolkit) (para projetos rich client) quedefine como componentes do host devem ser extrados e exibidos utilizandowidgets em uma GUI. A aplicao de uma transformao uma das aespossveis de um evento de tela. Voc pode editar transformaes de forma

Captulo 1. Utilizando o HATS (Host Access Transformation Services) 3

WYSIWYG, arrastando componentes do HATS a partir da paleta emodificando configuraes a partir da visualizao Propriedades do HATS.No possvel editar Transformaes de Rich no modo WYSIWYG, pois oJava visual editor no est mais disponvel no Rational SDP V9.5. Para obtermais informaes sobre funes removidas e descontinuadas no RationalApplication Developer, consulte http://www.ibm.com/support/docview.wss?uid=swg27038549.

Para obter informaes adicionais sobre a criao de transformaes, consulteo Captulo 8, Trabalhando com Transformaes, na pgina 187.

Componentes do HostOs Componentes do Host so objetos do HATS responsveis porreconhecer elementos da tela do host (como linhas de comandos,teclas de funo e outros) que voc apresenta ao usurio doaplicativo HATS. Voc pode utilizar o conjunto de componentes dohost que o HATS fornece ou pode criar o seu prprio.

Para obter informaes adicionais sobre a seleo dos componentesdo host para utilizar com seu projeto do HATS, consulte InserirComponente do Host na pgina 195.

Para obter mais informaes sobre o uso do assistente para criarcomponentes e widgets customizados, consulte a publicao HATSWeb Application Programmer's Guide ou HATS Rich Client PlatformProgrammer's Guide, dependendo do seu ambiente de aplicativos.

WidgetsWidgets so objetos do HATS responsveis por criar a sada da GUIpara componentes do host na apresentao do HATS. Por exemplo,voc pode converter os componentes do host da tecla de funo emwidgets de boto, permitindo que o usurio veja as teclas de funocomo botes de comando no aplicativo HATS. Voc pode utilizar owidgets que acompanha o HATS ou pode criar um prprio.

Para obter informaes adicionais sobre a seleo dos widgets parautilizar com seu projeto do HATS, consulte Inserir Componente doHost na pgina 195.

Para obter mais informaes sobre o uso do assistente para criarcomponentes e widgets customizados, consulte a publicao HATSWeb Application Programmer's Guide ou HATS Rich Client PlatformProgrammer's Guide, dependendo do seu ambiente de aplicativos.

ConexoUm conjunto de parmetros utilizado pelo HATS para se conectar aosaplicativos host. H dois tipos de conexes no HATS, padro (tambmdenominada transformao) e plano de fundo. Cada aplicativo HATS possuiuma conexo padro para o aplicativo host cujas telas o HATS transformar.As conexes secundrias so quaisquer conexes em um aplicativo HATS queno a conexo padro. O HATS no transforma telas de conexes emsegundo plano. No entanto, possvel escolher dinamicamente qual conexoser tratada como a conexo padro. Para obter informaes adicionais,consulte Captulo 6, Gerenciando as Conexes, na pgina 143.

Regras GlobaisAs regras especificam a substituio no nvel da tela ou no nvel do projetode um determinado tipo de campo de entrada de host com um widgetespecfico utilizando fragmentos de transformao. O fragmento de


|||||

http://www.ibm.com/support/docview.wss?uid=swg27038549http://www.ibm.com/support/docview.wss?uid=swg27038549pgcmpwgt.htmpgcmpwgt.htmrcppgd10.htm#pgcmpwgtrcppgd10.htm#pgcmpwgtpgcmpwgt.htmpgcmpwgt.htmrcppgd10.htm#pgcmpwgtrcppgd10.htm#pgcmpwgt

transformao contm o contedo que voc deseja utilizar para substituirtodas as ocorrncias de um padro em qualquer transformao fornecida.

Nota: As regras globais podem ser desativadas para um uso especfico deuma transformao, editando a ao de transformao de um eventode tela.

Para obter informaes adicionais, consulte Processamento na pgina 98.

Processamento PadroO mtodo utilizado pelo HATS para renderizar uma tela do host para a qualno existe nenhum evento de tela especfico. A renderizao padro tambmpode ser utilizada em uma transformao especfica para ser aplicada emuma rea definida de uma tela do host. Para obter informaes adicionais,consulte Processamento na pgina 98.

Substituio de TextoA substituio de texto utilizada no nvel do projeto ou no nvel da telapara transformar o texto em suas telas do host em imagens,Apenas Web HTML, ou outro texto em sua transformao da GUI. Paraobter informaes adicionais, consulte Substituio de Texto na pgina 107.

ModeloUm arquivo JSP (para projetos da Web) ou uma classe Java SWT composta(para projetos do rich client) que permite o aprimoramento da aparncia deseu projeto. Ao criar um projeto HATS, selecione um modelo a ser utilizadocomo o modelo padro para o seu projeto. O modelo pode conter logotiposda empresa e informaes e links para outras pginas. possvel selecionarseu padro dos modelos de amostra que so fornecidos com o HATS ou possvel projetar modelos customizados para seus projetos utilizando oassistente e o editor de modelo no HATS Toolkit. Tambm possvel criarum modelo previamente preenchido a partir de um arquivo existente, oupara projetos da Web, previamente preenchidos a partir de uma URL.

Na GUI, o modelo envolve a rea na qual a transformao aparece. Vocpode aplicar um modelo diferente do padro como resultado de um eventode tela. Para obter informaes adicionais sobre a associao de um modelo auma transformao, consulte o Captulo 10, Utilizando Modelos, na pgina369.

Lgica de NegciosQualquer cdigo Java chamado como uma ao em um evento, tal como umacustomizao de tela. A lgica de negcios especfica ao aplicativo.

Para obter mais informaes sobre a lgica de negcios, consulte a publicaoHATS Web Application Programmer's Guide ou HATS Rich Client PlatformProgrammer's Guide, dependendo do seu ambiente de aplicativos.

Varivel GlobalUma varivel que utilizada para armazenar um valor que pode serutilizado durante a existncia de uma instncia do aplicativo HATS. O valorde uma varivel global pode ser extrado de uma tela do host ou definidapelo desenvolvedor. As variveis globais podem ser utilizadas em modelos,transformaes, aes de evento de tela ou critrios de reconhecimento. Elastambm podem ser compartilhadas entre aplicativos da Web em um arquivo.ear (enterprise archive) ou entre aplicativos rich client executando no mesmoambiente do rich client. As variveis globais podem ser indexadas e tambmutilizadas em macros, em lgica de negcios e em Objetos de Integrao.


pgblogic.htmrcppgd09.htm#pgblogicrcppgd09.htm#pgblogic

Para obter informaes adicionais sobre variveis globais, consulte oCaptulo 12, Interagindo com variveis globais, na pgina 399.

MacroUm script de XML que define um conjunto de telas e determinadas aes quedevem ser adotadas nessas telas. Utilize as macros para automatizar asinteraes do usurio com o host. Voc pode gravar e reproduzir macros paraignorar telas, efetuar loop, solicitar entrada de dados de usurios (ou inserirvoc mesmo os dados ou com variveis globais) e extrair informaes da telado host.

As macros podem ser utilizadas em diferentes formas em um aplicativo doHATS:v Uma macro pode ser executada na conexo padro como parte de uma

ao Executar macro de um evento do HATS. Ela deve ser a ltima aodefinida para um evento de tela.

v Uma macro pode ser reproduzida em uma conexo de segundo planocomo parte de uma ao Executar Transao de Macro de um evento doHATS.

v Uma macro pode ser reproduzida incluindo botes de Macro em umatransformao. Isto permite que um usurio controle se a macro serreproduzida ou no.

v Uma macro pode ser reproduzida por um Objeto de Integrao.v Uma macro de conexo pode ser utilizada para preparar uma conexo.v Uma macro de desconexo pode ser utilizada para limpar uma conexo.

Para obter informaes adicionais sobre a incorporao de macros noambiente do HATS, consulte o Captulo 11, Macros e Terminal Host, napgina 383.

Objetos de IntegraoObjetos Java criados a partir de uma macro que podem ser utilizados comoblocos de construo para aplicativos do WebSphere. Os Objetos deIntegrao so Java beans que encapsulam interaes com origens de dadosdo host. Essas origens de dados incluem aplicativos orientados por terminalque usam dados 3270, 5250 e terminal de vdeo (VT).

Os Objetos de Integrao que compartilham a mesma conexo podem seragrupados para se obter uma tarefa principal nica em seu aplicativo doHATS. Isto chamado de encadeamento de Objetos de Integrao. Para obterinformaes adicionais, consulte Captulo 13, Usando objetos de integrao,na pgina 403.

Terminal HostUma conexo no HATS Toolkit para um host ao vivo. Ao utilizar o terminalhost, possvel capturar telas, criar eventos de tela e transformaes eregistrar e editar macros. Voc tambm pode reproduzir as macrosanteriormente gravadas ou importadas. O terminal host tambm permitevisualizar sua tela como uma GUI.

Terminal de VdeoUma janela do terminal que exibe telas do host que voc pode utilizarenquanto testa e depura para observar interaes entre um aplicativo HATS eum aplicativo host no tempo de execuo. Voc tambm pode interagir com oaplicativo host utilizando telas do host na janela do terminal. Para obterinformaes adicionais sobre o terminal de vdeo, consulte Utilizando oTerminal de Exibio para Teste e Depurao na pgina 452.


Captura de TelaUma representao XML de uma tela do host, armazenada em um arquivo.hsc, utilizada para criar ou customizar uma customizao de tela,combinao de telas, transformao ou regra global ou macro. Capturas detela so teis porque permitem que voc desenvolva um projeto HATSmesmo quando conectado ao host. Elas tambm so teis na criao demacros que so o ncleo do Objeto de Integrao do HATS e do suporte deservios da Web.

As capturas de telas do host do terminal de vdeo (VT) podem ser usadaspara criar ou customizar uma macro usando o Visual Macro Editor e comotela de registro de entrada ao configurar conjunto. Elas no podem serusadas para criar customizaes de tela, combinaes de tela, transformaes,renderizao padro ou regras globais.

Executar no ServidorApenas Web

Uma funo no Rational SDP que permite testar os projetos da Web do HATSem uma instncia do WebSphere Application Server ou do WebSphere Portal,conforme apropriado. Nesse modo, voc pode modificar e testar asconfiguraes de tempo de execuo, definidas no arquivoruntime.properties, que so implementadas no ambiente de tempo deexecuo. Saiba que todas as alteraes feitas nas configuraes de tempo deexecuo durante o teste neste modo sero retidas e efetivadas quando vocimplementar o aplicativo do HATS em um ambiente de tempo de execuo.Para obter informaes adicionais sobre como alterar configuraes do tempode execuo, consulte Administrando Componentes de Determinao deProblemas na pgina 448.

Depurar no ServidorApenas Web

O mesmo que Executar no Servidor e, alm disso, permite que voc:v Utilize o terminal de exibio para ver as telas do host conforme so

navegadas durante o teste do seu projeto.v Consulte as mensagens de depurao no console do Rational SDP.v Veja as alteraes feitas em seu projeto, por exemplo, alterao de um

modelo ou uma transformao, sem ter que reiniciar seu aplicativo noservidor de teste

v Modifique e teste configuraes de tempo de execuo, definidas noarquivo runtime-debug.properties, sem modificar as configuraes,definidas no arquivo runtime.properties file, que so implementadas noambiente de tempo de execuo.

v Percorra o cdigo Java, tais como a lgica de negcios do HATS.

Definir Perfil no ServidorApenas Web

O mesmo que Executar no Servidor, alm de permitir que voc localize asoperaes que exigem mais tempo e identifique as aes que so repetidaspara eliminar a redundncia. Essa funo pode ser utilizada para anlise dedesempenho, ajudando voc a obter um melhor entendimento do aplicativo.

ExecutarApenas RCP

Uma funo no Rational SDP que permite testar seus projetos rich client doHATS em uma instncia do Eclipse, Lotus Notes ou Lotus Expeditor Client.Nesse modo, voc pode modificar e testar as configuraes de tempo deexecuo, definidas no arquivo runtime.properties, que so implementadas


|||||||||||

no ambiente de tempo de execuo. Saiba que todas as alteraes feitas nasconfiguraes de tempo de execuo durante o teste neste modo sero retidase efetivadas quando voc implementar o aplicativo do HATS em umambiente de tempo de execuo. Para obter informaes adicionais sobrecomo alterar configuraes do tempo de execuo, consulte AdministrandoAplicativos Rich Client do HATS na pgina 84.

DepurarApenas RCP

O mesmo que Executar e, alm disso, permite que voc:v Utilize o terminal de exibio para ver as telas do host conforme so

navegadas durante o teste do seu projeto.v Consulte as mensagens de depurao no console do Rational SDP.v Veja as alteraes feitas em seu projeto, por exemplo, alterao de um

modelo ou uma transformao, sem ter que reiniciar seu aplicativo.v Modifique e teste configuraes de tempo de execuo, definidas no

arquivo runtime-debug.properties, sem alterar as configuraes de tempode execuo, definidas no arquivo runtime.properties file, que soimplementadas no ambiente de tempo de execuo.

v Percorra o cdigo Java, tais como a lgica de negcios do HATS.

Definir PerfilApenas RCP

O mesmo que Executar, alm de permitir que voc localize as operaes queexigem mais tempo e identifique as aes que so repetidas para eliminar aredundncia. Essa funo pode ser utilizada para anlise de desempenho,ajudando voc a obter um melhor entendimento do aplicativo.

Suporte a ImpressoA capacidade de um desenvolvedor de especificar uma sesso da impressorapara ser associada com uma sesso do host e de permitir que o usuriovisualize tarefas de impresso do aplicativo host, envie-as para a impressoraou salve-as no disco. Suporte de impresso est disponvel apenas para aconexo padro.

Para obter informaes adicionais sobre o suporte impresso, consulte oCaptulo 15, Ativando o suporte a impresso, na pgina 417.

Suporte ao TecladoA capacidade para um desenvolvedor permitir que um usurio utilize umteclado fsico para interagir com o host quando o aplicativo for executado emuma GUI. O desenvolvedor tambm decide se necessrio incluir um tecladonumrico do host, um teclado numrico de aplicativos ou ambos, em umprojeto. Se os teclados numricos estiverem includos, o desenvolvedordecidir quais teclas esto includas e como essas teclas e o teclado numricoaparecero na GUI.

Para obter informaes adicionais sobre o suporte ao teclado, consulte oCaptulo 16, Ativando o suporte a teclado, na pgina 423.

Suporte ao Teclado NumricoO teclado numrico do host uma tabela de botes ou links que permitemque os usurios interajam com o host como se fossem pressionadas as teclasfsicas em um teclado. No entanto, os usurios ainda podem utilizar as teclasfsicas no teclado em vez dos botes ou links no teclado numrico do host.Para obter informaes adicionais sobre o teclado numrico do host, consulteTeclado numrico do host na pgina 203


O teclado numrico do aplicativo uma tabela de botes ou links quepermitem que os usurios executem tarefas relacionadas ao aplicativo HATS,como visualizao de tarefas de impresso ou atualizao da tela. Para obterinformaes adicionais sobre o teclado numrico de aplicativos, consulteTeclado Numrico do Aplicativo na pgina 380.

Entendendo o Processamento do Aplicativo do HATSAntes de criar um projeto HATS, voc deve entender como o HATS processa osaplicativos host. Como os usurios acessam cada tela de um aplicativo, o HATSprocessa o aplicativo conforme descrito nas seguintes etapas. A Figura 1 na pgina11 mostra o fluxo destas etapas. Os conceitos-chave esto descritos emEntendendo os Conceitos e Objetos-Chave do HATS na pgina 2.1. Quando o host exibe uma tela, o HATS compara a tela do host ao conjunto de

critrios de reconhecimento de tela definido em cada um dos eventos de telaativados do projeto, na ordem definida pela prioridade do evento, at que sejalocalizada uma correspondncia.

2. Quando for localizada uma correspondncia, o HATS executar as aesdefinidas para o evento de tela. Para ambos os eventos de customizao de telae combinao de telas, podem ser includas as aes listadas abaixo. Almdisso, para um evento de combinao de telas, o HATS navega por vrias telasreunindo dados de cada tela para exibir ao usurio.v Aplicar a transformao utilizando o modelo associado. O HATS exibe

qualquer componentes do host (definido na transformao) como widgets daGUI.

v Executar lgica comercialv Extrair varivel globalv Inserir dadosv Definir varivel globalv Remover varivel globalv Enviar varivel global (apenas projetos do portlet padro do HATS)v Mostrar URL ou SWT Composite

Apenas RCP

v Mostrar URLApenas Web

v Encaminhar para a URLApenas Web

v Executar macrov Executar transao de macrov Enviar teclav Desconectarv Pausar

Para obter informaes adicionais, consulte Aes na pgina 167.


Notas:

1. Quando uma correspondncia de tela localizada, pelo menos uma ao deve serexecutada, mas uma transformao da tela no precisa ser exibida ao usurio. Emoutras palavras, a ao aplicar uma transformao no necessria.

2. possvel executar aes nos dados da tela do host antes e depois que o usuriointeragir com ela. Por exemplo, voc pode extrair alguns dados como uma varivelglobal, substituir algumas informaes por novos dados e, em seguida, aplicar atransformao antes de mostrar a transformao para o usurio. Depois que eleexecutar uma ao que retorne os dados da tela, ser possvel executar extraes einseres adicionais antes do retorno final dos dados ao host.

3. Se nenhum critrio de reconhecimento de tela corresponder tela do host, oHATS processar o evento do aplicativo de tela no correspondido. A aopadro desse evento exibir a tela do host utilizando a transformao padro eaplicando o modelo padro. A transformao padro utiliza as definies deprocessamento estabelecidas nas definies do projeto.

4. Conforme o host apresenta cada nova tela de um aplicativo, o HATS inicia naetapa 1 novamente e continua durante todas as etapas. A Figura 1 na pgina 11mostra como o HATS processa as telas.

Nota: Se uma macro for utilizada para ignorar o processamento de tela, essastelas no estaro sujeitas a este processo.


Os Eventos de tela so um importante conceito no desenvolvimento de um projetoHATS. Sem os critrios de reconhecimento da tela definidos em um evento de tela,o HATS no sabe quais aes adotar quando a tela do host for recebida.

Voc deve se familiarizar com os princpios bsicos dos eventos de tela antes deiniciar o processo de desenvolvimento. Os elementos principais dos critrios dereconhecimento da tela de definio so discutidos no Captulo 7, Trabalhandocom Eventos de Tela, na pgina 159.

Tela do hostrecebida

Verificar primeiroevento de tela (SE)

Todos oscritrios

necessrioscorrespondem?

Algumacorrespondncia

de critrioopcional?

ExistealgumoutroSE?

Desempenhar aesdefinidas para evento

de tela nico

Opcionalmente, enviartela ao usurio

Desempenhar aesdefinidas para este

evento de tela

Verificar prximoevento de tela

No

No

Sim

Sim

Sim

No

Faa as alteraes neste grfico (camada gif_graphic) para a sada GIF:

Tela do hostrecebida

Verificar primeiroevento de tela (SE)

Todosos critriosnecessrios

correspondem?

Algumacorrespondncia

de critrioopcional?

ExistealgumoutroSE?

Desempenhar aesdefinidas para evento

de tela nico

Opcionalmente,enviar

tela ao usurio

Desempenhar aesdefinidas para este

evento de tela

Verificar prximoevento de tela

No

No

Sim

Sim

Sim

No

Faa as alteraes neste grfico (camada eps_graphic) para a sada EPS:

Figura 1. Processamento de Tela do HATS


Entendendo o Desenvolvimento de Aplicativos HATSO HATS permite que voc utilize uma abordagem interativa para odesenvolvimento de aplicativos. Voc pode iniciar com uma configurao simples eincluir refinamentos quando estiver pronto. Voc pode testar cada alterao quefizer utilizando o ambiente de teste do Rational SDP. A maioria das alteraespodem ser vistas por uma simples atualizao da transformao do HATS. Vocpode fazer modificaes se necessrio e salvar seu trabalho antes de continuar paraa prxima alterao. Esta seo descreve uma seqncia possvel de etapas quevoc pode utilizar para projetar e desenvolver seu aplicativo HATS. Voc pode seaprofundar mais nesse sentido e pode parar no momento em que desejar.1. Comece criando um aplicativo HATS que utiliza todos os padres e veja

imediatamente todas as telas do host renderizadas em uma GUI. Arenderizao padro pode renderizar suas telas do host de forma que preserveo layout original da tela e inclua automaticamente controles da GUI, comolinks, botes e tabelas para aprimorar a produtividade do usurio.

2. Crie um modelo que corresponda s pginas da Web de sua empresa ou aoutros aplicativos da empresa e veja todas as suas telas do host renderizadascom a aparncia de sua empresa. Voc pode iniciar e modificar um dosmodelos fornecidos com o HATS ou, para aplicativos da Web do HATS, vocpode importar o Web site de sua empresa como um modelo. Consulte oCaptulo 10, Utilizando Modelos, na pgina 369 para obter informaesadicionais. Agora o aplicativo HATS corresponde ao estilo e s cores daspginas da Web de sua empresa ou a outros aplicativos corporativos.

3. Configure definies no nvel do projeto (em todo o aplicativo) e veja quantode seu aplicativo do host pode ser manipulado sem a configurao de telasespecficas. possvel alterar caractersticas no nvel do projeto nas diversasguias do editor Configuraes do Projeto. Consulte o Captulo 5, Modificandoum projeto do HATS, na pgina 95 para obter informaes adicionais. Porexemplo, tente fazer algumas alteraes como:v Alterar a renderizao padro para renderizar uma lista de seleo como

uma lista suspensa. Isso ir alterar todas as listas de seleo para listasdrop-down.

v Crie uma ou mais regras globais para configurar a forma como o HATStransforma os campos de entrada em suas telas de host. Por exemplo, altereos campos de data para widgets de calendrio ou campos de localizao paralistas drop-down.

v Utilize a substituio de texto para alterar uma ou mais cadeias queaparecem nas telas do host. Por exemplo, possvel alterar a palavra signonpara logon.

v Veja como suas telas de host so transformadas. H elementos que aparecemna maioria das telas que voc deseja ver transformados de maneira diferente?Esses elementos podem ser candidatos para modificar as configuraes dealguns componentes (para alterar como os componentes do host soreconhecidos) ou widgets (para alterar como os controles da GUI sorenderizados na transformao). Voc pode alterar essas configuraes nonvel do projeto para estabelecer os padres a serem utilizados nas telas dohost. Voc tambm pode alterar as configuraes para instncias individuaisde componentes e widgets quando voc os inclui nas transformaes. Paraobter informaes adicionais, consulte Processamento na pgina 98.

4. Crie eventos no nvel da tela para reconhecer telas do host especficas e acionarum conjunto de aes a serem executadas.v Se voc utilizar mapas do BMS, poder comear importando conjuntos de

mapas do BMS para criar capturas de telas para suas telas do host. Caso


contrrio, utilize a funo de terminal host do HATS para conectar-se aoaplicativo do host e criar capturas de tela para as telas especficas nas quaisdeseja agir e reconhecer. Em seguida, a partir de cada captura de tela, crieum evento de tela.

v Utilize o assistente Criar uma Customizao de Tela para customizaralgumas das telas do host para simplific-las, remover itens no utilizados eautomaticamente extrair e preencher os dados para simplificar a entrada dousurio. Fornea controles da GUI especficos da tela para um maior grau deprodutividade para o usurio. Para obter informaes adicionais, consulteCaptulo 7, Trabalhando com Eventos de Tela, na pgina 159.

v um requisito comum poder reunir dados de vrias telas do host eapresent-los em uma nica pgina de sada ou fornecer uma nica pginade entrada que, ento, fornece vrias telas do host com dados. O HATSfornece vrios mtodos para executar essas operaes. Os mtodos diferentesincluem o uso de combinaes de telas, customizaes de telas,transformaes, macros, variveis globais e Objetos de Integrao. O mtodoa ser utilizado depende da operao a ser executada e do local dos dados.Para iniciadores, tente utilizar o assistente Criar uma Combinao de Telapara combinar dados que no se ajustem em uma nica tela do host eexibi-los em uma nica pgina de sada. Para obter informaes adicionais,consulte o Captulo 14, Combinando Telas, na pgina 415 e o Captulo 7,Trabalhando com Eventos de Tela, na pgina 159.

5. Crie macros simples para ajudar o usurio a navegar no aplicativo do host. Asmacros podem ser utilizadas para executar funes que ignorem telas, solicitarentrada de dados pelo usurio ou extrair dados de uma ou mais telas do host.Para obter informaes adicionais, consulte Captulo 11, Macros e TerminalHost, na pgina 383.

6. Para aplicativos da Web, crie Objetos de Integrao, que so construdos apartir de macros e so Java beans que encapsulam interaes com umaplicativo de host. Em seguida, utilize os Objetos de Integrao para criarpginas da Web de Modelo 1, Struts ou JSF (JavaServer Faces) a fim deconduzir interaes com seu aplicativo do host. Voc tambm pode executar osObjetos de Integrao a partir de sua prpria lgica de negcios Java ouestend-los para fornecer interfaces EJB (Enterprise JavaBeans) ou de serviosda Web para seu aplicativo de host. Para obter informaes adicionais, consulteCaptulo 13, Usando objetos de integrao, na pgina 403.

Como Posso Saber Qual a Minha Verso do HATS?Voc pode determinar a verso do HATS Toolkit e de cada projeto do HATS.

Para determinar qual verso de HATS Toolkit que voc est utilizando, verifiqueos Pacotes Instalados do IBM Installation Manager:1. No menu Iniciar, selecione Todos os Programas > IBM Installation Manager >

Visualizar Pacotes Instalados.2. A pgina IBM Installation Manager - Ofertas Instaladas lista todos os pacotes

(incluindo nveis de verso e compilao) e recursos instalados.

Voc pode determinar a verso (incluindo o nvel de manuteno) de cada projetodo HATS. Estas informaes de verso so mantidas em cada projeto em umarquivo chamado .serviceHistory.xml . Esse arquivo pode ser visualizado a partirda visualizao do Navegador da perspectiva do HATS na pasta WebContent\WEB-INF\profiles (para projetos da Web), na pasta de perfis (paraprojetos do rich client) e na pasta ejbModule (para projetos do EJB).


|

As informaes de verso para projetos .ear do HATS e para o projeto de extensode tempo de execuo RCP do HATS so mantidas no arquivo product.xml. Essearquivo pode ser visualizado a partir da visualizao Navegador na pasta-raiz doprojeto.

Reunindo Informaes sobre Determinao de Problemass vezes, voc pode precisar de assistncia na determinao de problemasrelacionados ao HATS. Para obter instrues sobre como reunir informaes dedeterminao de problema para a equipe de suporte do HATS, consulte a seo,Reunindo Informaes de Determinao de Problema, em Resoluo de Problemas doHATS.

Onde Posso Encontrar Informaes sobre o HATS?As seguintes informaes do HATS esto disponveis antes de voc instalar oHATS:v A documentao do HATS est disponvel no CD de instalao do HATS. A

partir da barra de ativao de instalao, selecione links para os seguintesdocumentos: Notas sobre o Release Introduo (pdf)

v O Knowledge Center do HATS em http://www.ibm.com/support/knowledgecenter/SSXKAY_9.5.0 inclui informaes sobre Notas sobre aLiberao, perguntas mais frequentes (FAQs), informaes de referncia da API,tutoriais, informaes do WebFacing e verses em HTML e PDF dos documentoslistados abaixo. As verses PDF traduzidas tambm esto includas. Introduo do HATS Guia do Usurio e do Administrador do HATS HATS Web Application Programmer's Guide HATS Rich Client Platform Programmer's Guide HATS Advanced Macro Guide Mensagens do HATS Resoluo de Problemas do HATS Desenvolvendo Aplicativos WebFacing

v O website do produto HATS em http://www.ibm.com/software/products/us/en/rhats inclui informaes adicionais do produto, como viso geral de recursos,download de avaliao, requisitos do sistema, etc.

v O ponto de acesso do HATS em https://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218d incluiuma biblioteca de recursos, fruns de discusso, blogs e mais.

v O Web site do IBM Education Assistant em http://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jsp integra apresentaes narradas,demonstraes, tutoriais e links de recursos para ajudar a utilizar produtos IBMcom xito. Procure pelos Servios de Transformao do Host Access no ndice.

Alm das informaes que esto disponveis antes de voc instalar o HATS, asinformaes a seguir esto disponveis no sistema aps a instalao do HATS:v Os links para o website do HATS, Knowledge Center e Notas sobre a Liberao

esto disponveis no menu Iniciar do Windows.


||

contacting_support.htm#gatheringhttp://www.ibm.com/support/knowledgecenter/SSXKAY_9.5.0http://www.ibm.com/support/knowledgecenter/SSXKAY_9.5.0http://www.ibm.com/software/products/us/en/rhatshttp://www.ibm.com/software/products/us/en/rhatshttps://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dhttps://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dhttps://www.ibm.com/developerworks/mydeveloperworks/groups/service/html/communityview?communityUuid=2ce1fd8d-d706-4afd-b9ef-9000ad21218dhttp://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jsphttp://publib.boulder.ibm.com/infocenter/ieduasst/rtnv1r0/index.jspreadme.htm

v A documentao do HATS, incluindo WebFacing, est disponvel no menuAjuda na barra de menus do Rational SDP. Selecione Ajuda > Contedo daAjuda e, no painel Contedo, selecione Desenvolvendo Aplicativos do HATS.

v O tutorial da pgina de Boas-vindas do HATS o orienta pelo processo dedesenvolvimento de um aplicativo HATS e, se instalado no produto IBMRational Developer for Power Systems Software, apresenta o recurso IBMWebFacing Tool for IBM i do HATS Toolkit.

v Se o WebFacing Tool estiver instalado, o tutorial da pgina de Boas-vindas doWebFacing fornece informaes similares s do tutorial da pgina deBoas-vindas do HATS.

v Ajuda contextual est disponvel em todos os campos nos assistentes e editoresdo HATS. Pressione a tecla F1 para ver a ajuda no HATS Toolkit.

v Dicas so fornecidas em pontos-chave no processo de desenvolvimento de umprojeto HATS. Voc pode controlar se deseja ver as dicas modificando aspreferncias do HATS.



Captulo 2. Migrando para o HATS V9.5

Se voc for um usurio do Host Publisher V4, HATS V5, V6, V7.0, V7.1, V7.5, V8.0,V8.5 ou V9.0, possvel migrar seus projetos para o HATS V9.5.

Os projetos do HATS V4 LE, HATS V5 LE e HATS V4 no podem ser migradosdiretamente para o HATS V8.0, V8.5, V9.0 ou V9.5. Para migrar esses projetos,primeiro deve-se migr-los para uma liberao provisria do HATS; por exemplo,V5, V6, V7, V7.1 ou V7.5, e, ento, migr-los da liberao provisria para o HATSV8.0, V8.5, V9.0 ou V9.5. Consulte a documentao do seu release anterior doHATS para obter informaes sobre como migrar projetos do HATS.

Se estiver utilizando uma verso do Host Publisher anterior V4.0, primeirodever seguir as instrues para migrao de aplicativos do Host Publisher para oHost Publisher V4.0. Acesse http://www.ibm.com/support/entry/portal/overview/software/rational/rational_host_access_transformation_services e insiraa sequncia de procura "Como migrar o Host Publisher". Para obter informaesadicionais, consulte Usurios do HATS para Host Publisher na pgina 25.

Migrao do HATSA migrao de um projeto do HATS de um release anterior do HATS umprocesso de duas etapas.1. Importe o projeto na rea de trabalho do HATS V9.5 usando um dos mtodos a

seguir:v Importe um projeto existente selecionando seu diretrio-raiz ou um archive.v Verifique o projeto fora de um repositrio de cdigo (como CVS ou IBM

Rational ClearCase).v Abra um Rational SDP V7.0 ou posterior, rea de trabalho que contenha o

projeto, no Rational SDP V9.5.2. Migre o projeto usando o assistente para migrao do HATS.

Importando um projeto do HATSSe voc tiver uma liberao do HATS V5, ou mais recente, instalada, ser possvelexportar o projeto para um arquivo zip ou um arquivo de troca de projeto e, emseguida, import-lo e migr-lo para o HATS V9.5. Consulte a documentao de seurelease anterior do HATS para obter informaes sobre a exportao de projetos doHATS. Para obter mais informaes sobre a importao de projetos da web doHATS e rich client no HATS V9.5, consulte Exportando e Importando Projetos daWeb do HATS na pgina 35 e Exportando e Importando Projetos do Rich Clientdo HATS na pgina 66.

Se voc tiver armazenado seus projetos do HATS no Rational ClearCase, devercriar uma visualizao de captura instantnea contendo esses projetos e depoisimport-los em sua rea de trabalho do HATS V9.5 usando Arquivo > Importar >Geral > Projetos Existentes na rea de Trabalho. Durante a importao, noselecione a opo Copiar projetos na rea de trabalho. Depois que os projetosforem importados na rea de trabalho do HATS V9.5, voc ter a opo demigr-los para o HATS V9.5. Durante a migrao, os arquivos que precisam seratualizados tm o registro de sada efetuado automaticamente do RationalClearCase.

Copyright IBM Corp. 2003, 2015 17

|

|

||

||||||

|

||

|

|

|

||

http://www.ibm.com/support/entry/portal/overview/software/rational/rational_host_access_transformation_serviceshttp://www.ibm.com/support/entry/portal/overview/software/rational/rational_host_access_transformation_services

Migrao da rea de trabalho do Rational SDPO assistente de Migrao da rea de Trabalho do Rational SDP exibido quandoum projeto importado na rea de trabalho e precisar de algum nvel de migraodo Rational SDP. Este assistente executa alguma migrao bsica de projeto doRational SDP e, se o projeto for destinado a um tempo de execuo no suportado,fora a escolher um tempo de execuo de destino suportado. Na preparao paraexecuo do assistente de Migrao do HATS, voc deve primeiro executar oassistente de Migrao da rea de Trabalho do Rational SDP.

Nota: A migrao da rea de trabalho do Rational SDP V9.5 suporta somenteprojetos criados no Rational SDP V7.0 ou mais recente. Ao importar umprojeto HATS pr-V7.0, a migrao da estao de trabalho do Rational SDPfalhar e uma mensagem de erro ser exibida. A migrao do HATS aindapoder migrar o projeto para o HATS V9.5.

Utilizando o Assistente de Migrao HATSQuando voc alternar para a perspectiva HATS, se tiver um projeto criado a partirde uma liberao do HATS anterior em sua rea de trabalho do HATS V9.5,receber uma mensagem afirmando que a rea de trabalho contm um projeto doHATS que precisa ser migrado.

Voc deve usar o assistente de Migrao do HATS para migrar esse projeto para oHATS V9.5 antes de investigar quaisquer erros mostrados na visualizaoProblemas porque a migrao pode eliminar alguns ou todos esses erros.

Para utilizar o assistente de Migrao do HATS, siga estas etapas:1. Na visualizao Projetos HATS, clique com o boto direito sobre o projeto e

selecione Migrar Projeto.2. Caso possua outros projetos de um release anterior do HATS que estejam

associados ao projeto do HATS selecionado para migrao, esses projetostambm sero migrados, bem como quaisquer projetos .ear do HATSassociados.

3. Clique em OK para iniciar a migrao.4. Se o projeto no possuir um projeto .ear associado, voc precisar associar o

projeto .war aps a migrao. Para associar o projeto .war a um projeto .ear,consulte Movendo Projetos da Web do HATS para um Arquivo .ear Diferentena pgina 34.

Notas:

1. Aps a migrao, verifique os detalhes no Relatrio de Migrao.2. Se um projeto da Web do HATS que est sendo migrado tiver um tempo de

execuo de destino no suportado (se o assistente de Migrao de rea deTrabalho do Rational SDP no tiver sido executado) ou mscaras nosuportadas do WebSphere, o assistente de Migrao do HATS configurar o otempo de execuo de destino e as mscaras no nvel suportado mais baixo doWebSphere Application Server para projetos da Web. Uma mensagem exibidae registrada no log informando que de fato a alterao foi feita.

3. Se, aps a migrao, voc receber um erro indicando que o tempo de execuodo destino no est definido, edite as propriedades de seu projeto e selecione otempo de execuo de destino apropriado. Para fazer isto, clique com o botodireito no projeto e selecione Propriedades. Na janela Propriedades, selecioneTempos de Execuo Destinados. Na lista Tempos de Execuo, selecione otempo de execuo apropriado.


|

|

|

|||||||

4. A migrao de um projeto de uma liberao anterior do HATS para o HATSV9.5 no pode ser desfeito.

Migrando Transformaes do HATSAo migrar seus projetos do HATS de uma liberao anterior do HATS para oHATS V9.5, as transformaes no projeto tambm so migradas. Alteraes feitasnas transformaes dependem do release do HATS a partir do qual est fazendo amigrao. Todas as transformaes so salvas na pasta MigrationBackup antes deserem migradas.

Consideraes Especiais sobre Migrao

Avano AutomticoSe em verses anteriores do HATS voc ativou a funo de avano automticoincluindo a linha turnAutoTabOn(); no arquivo lxgwfunctions.js, agora deverutilizar a configurao Ativar avano automtico de campo na seoConfiguraes de Cliente da guia Outro no editor de Configuraes de Projeto.Para obter informaes adicionais, consulte Configuraes do Cliente na pgina128.

Arquivos de BackupA migrao do HATS cria uma pasta de backup no diretrio do projeto chamadaMigrationBackup. Esta pasta contm cpias dos arquivos do projeto antigo antesde serem sobrescritas pelo processo de migrao. Esses arquivos so salvos,permitindo que voc os compare e mescle com os novos arquivos do HATS V9.5.No se preocupe se ocorrerem problemas, estes arquivos no sero mais utilizadospelo aplicativo. Quando estiver satisfeito com todos os arquivos salvos que foramcomparados e mesclados, ser possvel excluir a pasta MigrationBackup.

Nota: Antes de excluir a pasta MigrationBackup, possvel publicar um projetomigrado para o WebSphere Application Server para testar como ele secomporta. Entretanto, os erros na lista de tarefas causados pela pastaMigrationBackup podem criar problemas na publicao para o WebSphereApplication Server. Para evitar isto, possvel remover a pastaMigrationBackup do projeto ou permitir que os aplicativos contendo errossejam publicados em um servidor. Para permitir que os aplicativos contendoerros sejam publicados em um servidor, selecione Janela > Preferncias >Servidor > WebSphere Application Server na barra de menus do RationalSDP e selecione Permitir aplicativos contendo erros sejam publicados emum servidor.

Widget de BotoSe voc migrar um projeto criado antes do HATS V7.0.0.2 e escolher implementar aopo Ativar cores de primeiro plano se utilizar um modelo que utiliza a folha deestilo blacktheme.css, deve atualizar manualmente a folha de estilo blacktheme.cssde uma das seguintes maneiras:1. Remova a linha a seguir da declarao input.HATSBUTTON:

color: lime;

Isso permite que as cores de primeiro plano sejam renderizadas nas teclas defuno; no entanto, isso faz com que outros botes gerados por um widget doHATS renderizem uma cor padro.

2. Combine as declaraes de CSS relacionadas s cores para cada cor. Porexemplo, troque:

Captulo 2. Migrando para o HATS V9.5 19

||

|

|

.HBLUE {color: #3c9dff;

}input.HBLUE {

white-space: normal;letter-spacing: normal;

}

para.HBLUE, input.HBLUE {

color: #3c9dff;white-space: normal;letter-spacing: normal;

}

Repita essa alterao para cada cor.

Uma alternativa para editar manualmente a folha de estilo blacktheme.css criarum novo projeto simulado e copiar os arquivos CSS de tema deste projeto em seuprojeto. Esteja ciente de que quaisquer alteraes feitas em seus arquivos de CSSsero sobrescritas.

beans de acesso EJBSe voc tiver projetos existentes do HATS V5 que tenham Beans de Acesso EJB,talvez obtenha erros de compilao ou de tempo de execuo que comeam com"HPubReqCompleteEvent no pode ser resolvido". Para corrigir isso, regenere oBeans de Acesso EJB.

Nota: O suporte ao aplicativo EJB do HATS foi descontinuado no HATS V9.5.Embora o suporte para aplicativos HATS EJB continue por enquanto, a IBMreserva-se o direito de remover esse recurso em um release subsequente doproduto. As alternativas so:v Utilizar servios da Web para acessar seus Objetos de Integrao. Para

obter mais informaes, consulte Desenvolvendo Servios da Web, noHATS Web Application Programmer's Guide.

v Criar beans EJB customizados para acessar seus Objetos de Integrao.Para obter mais informaes, consulte Usando um Objeto de Integraoem um Continer EJB (de seu prprio EJB), no HATS Web ApplicationProgrammer's Guide.

Widget CampoSe quiser usar a configurao Render using monospace font para o widgetCampo, e seu projeto foi criado originalmente em um release anterior ao HATSV7.0, voc deve atualizar seus arquivos CSS conforme se segue:1. Inclua a seguinte classe nos arquivos whitetheme.css, graytheme.css,

monochrometheme.css, tantheme.css e blacktheme.css:.HF {

font-family: courier new, monospace;}

2. Remova font-family: monospace de todas as classes H-color (cor do HATS) detodos os arquivos CSS.

Regras globaisUma nova configurao, enforceImmediacy, includa em qualquer regra globalimportada para o HATS V9.5 do HATS V5. Quando essa configurao verdadeira, a regra global se comporta como no HATS V5 quando a opo Apenascampo de entrada mais prximo selecionada para a opo Transformar do


|

|

pgwebsv.htmpgcusio.htm#writingpgcusio.htm#writing

padro Localizar campos de entrada por texto adjacente. Quando essaconfigurao falsa, o padro, a regra global se comporta como no HATS V9.5.

Para fazer com que as regras globais definidas recentemente se comportem comoas regras globais do HATS V5, voc deve incluir e configurar a definioenforceImmediacy como true. Para fazer isso, na guia Origem do editor deConfiguraes do Projeto, inclua a seguinte configurao na tag globalRulescomponentSettings:

Variveis GlobaisAntes do HATS V7, o valor de uma varivel global, digitado em um promptinserido em uma transformao utilizando a opo Prompt para varivel globalcom caixa de entrada, poderia ser truncado porque alguns caracteres no eramescapados corretamente.

Nesta verso do HATS, os valores da varivel global solicitados por umatransformao so escapados apropriadamente para evitar truncamento. Asvariveis globais inseridas em uma transformao utilizando a opo Exibir valorde varivel global como texto esttico no so afetadas por essa alterao. Osprompts da varivel global inseridos em uma transformao em uma verso doHATS anterior ao HATS V7 no so automaticamente atualizados durante amigrao, portanto, eles no so afetados por esta alterao.

Compactao HTTPSe voc deseja usar o suporte do HATS para compactao de HTTP nos projetosmigrados do HATS V5.0.x, V6.0 e V6.0.1, voc deve incluir manualmente o filtro decompresso no arquivo do Web Deployment Descriptor (web.xml). Para incluir ofiltro de compactao no arquivo web.xml:1. No HATS Toolkit, alterne para a visualizao Navegador da perspectiva do

HATS.2. Abra o arquivo web.xml localizado na pasta Web Content\WEB-INF de seu

projeto.3. Clique na guia Origem para visualizar a origem desse arquivo.4. Copie as instrues a seguir aps o ltimo mapeamento de servlet definido

(procure o ltimo ).

Provides compression for output from HATS entryservlet

CompressionFilterCompressionFiltercom.ibm.hats.runtime.filters.CompressionFilter

5. Copie as instrues a seguir aps o ltimo mapeamento de filtro definido(procure o ltimo ).

CompressionFilterEntryServletERRORFORWARDINCLUDEREQUEST

CompressionFilter/


|

CompressionFilter/index.jsp

6. Salve o arquivo.

Nota: Se voc j tiver executado esse projeto no servidor, ser necessrio publicarnovamente o aplicativo para o WebSphere Application Server paraselecionar a alterao no arquivo web.xml.

Ferramentas de gerenciamento de licena do IBMOs aplicativos vinculados do HATS, WebFacing e HATS/WebFacing migrados parao HATS V9.5 devem ser reimplementados no ambiente de produo paraselecionar o suporte para o novo arquivo de assinatura do HATS V9.5 pelasferramentas de gerenciamento de licena do IBM; por exemplo, IBM License MetricTool e IBM Tivoli Asset Discovery for Distributed.

Aplicativos da Web do WebFacing: As ferramentas de gerenciamento de licenada IBM detectam aplicativos da Web implementados como Enterprise Archives(EARs) para WebSphere Application Servers suportados. Como os projetos da webdo WebFacing so criados independentemente dos EARs associados, o arquivo deassinatura do HATS V9.5 deve ser includo manualmente. Siga as etapas abaixopara ativar a deteco adequada de aplicativos da Web do WebFacing.1. Crie uma pasta chamada itlm diretamente sob o EAR associado ao projeto do

WebFacing.2. Localize o arquivo de assinaturas denominado

Host_Access_Transformation_Services-9.0.0.swidtag no diretrio de plug-indo HATS\plugins\com.ibm.hats_nnn\

em que shared_install_directory o diretrio de recursos compartilhados no qualvoc instalou a oferta HATS utilizando o IBM Installation Manager e nnn averso e o nvel da construo do HATS.

3. Copie o arquivo de assinaturas do plug-in para a pasta itlm criadaanteriormente.

4. Exporte seu projeto como um EAR e reimplemente.5. As ferramentas de gerenciamento de licena da IBM agora podero detectar seu

aplicativo.

Se voc ativou a deteco para um projeto antigo do WebFacing e migrou esseprojeto para o V9.5, voc dever remover o arquivo de assinaturas existente (porexemplo, WDHT0700.sys2 se o projeto antigo do WebFacing for da V7.0) do EARassociado do projeto e incluir o arquivo de assinaturas do V9.5(Host_Access_Transformation_Services-9.0.0.swidtag) antes da reimplementao.

Segurana de Java 2Durante a migrao para o HATS V9.5, o arquivo was.policy de segurana de Java2 do WebSphere Application Server sobrescrito. Se voc customizou o arquivowas.policy em projeto pr-HATS V9.5, ento voc dever customizar novamente oarquivo aps a migrao.

Mapeamentos de TecladoEm verses anteriores do terminal do host do HATS, a tecla Pause foi mapeadapara a ao [limpar] do host. No HATS V7, e posterior, o terminal do host, a teclaEsc mapeada para a ao do host [limpar].


||

|

|

||||

|

|

Em verses do HATS anteriores ao HATS V6, Ctrl+R era utilizado para sessesbidirecionais para reverter a tela. No HATS V6 e posterior, Ctrl+R mapeado paraum RESET do host para sesses bidirecionais e no bidirecionais e Alt+Enter mapeado para reverso para sesses bidirecionais.

Rich client aplicativos

Ligaes de teclado do Lotus Notes:

Se voc migrar para o HATS V9.5 um projeto de rich client do pr-HATS V7.5.1direcionado ao Lotus Expeditor, os mapeamentos de teclado para o Lotus Notessero includos no projeto.

Configuraes de Ativao:

Aps a migrao de um projeto rich client, se no for possvel ativ-lo no ambientede teste, crie uma nova configurao de ativao para utilizar no ambiente de teste.Para fazer isto, na visualizao Projetos HATS, clique com o boto direito domouse no projeto e selecione Executar ou Depurar. A janela Executar (ou Depurar)Configuraes ser exibida. Se o projeto for destinado ao Eclipse RCP, clique com oboto direito do mouse em Aplicativo Eclipse e selecione Novo. Se o projeto fordestinado ao Lotus Notes ou Lotus Expeditor , clique com o boto direito domouse em Servios do Cliente e selecione Novo. Se desejar, modifique o nome elocal da configurao de ativao. Tambm possvel excluir configuraes deativao antigas desta janela. Clique em Executar (ou Depurar) para ativar oprojeto no ambiente de teste.

Temas:

Os aplicativos rich client do HATS V7.0 que usam o tema Emulador de TerminalClssico tero a configurao Navegao com tecla de seta ativada aps amigrao.

Sequncias no em ingls americano em modelos e transformaes:

Cadeias em ingls no-US includas nos modelos e transformaes de um projetodo HATS rich client construdas com o HATS V7.0 ou V7.0.0.1 no so compiladascorretamente quando o projeto exportado como um recurso. Para contornar esseproblema, aps a migrao do projeto para o HATS V9.5, edite o arquivobuild.properties localizado na pasta raiz do projeto. Inclua a seguinte linha naparte inferior do arquivo build.properties:javacCustomEncodings.library.jar =src/rcpproject/templates/[UTF-8],src/rcpproject/transformations/[UTF-8]

Em que rcpproject o nome do projeto do rich client.

Ativao de Tempo de ExecuoPara ativar totalmente o tempo de execuo do HATS V9.5 para produo, vocdeve especificar suas configuraes de licena usando ao assistente deConfiguraes de Licena. Voc deve fazer isso mesmo para projetos cujos temposde execuo se encontravam totalmente ativados nas verses anteriores do HATS.Para obter mais informaes sobre a especificao de configuraes de licena,consulte Enabling HATS runtime and license settings na publicao HATS GettingStarted


|

gslicense.htm

Nota: Os aplicativos da Web do HATS cujos tempos de execuo no estocompletamente ativados esto restritos a apenas duas conexes de host detempo de execuo. Os aplicativos rich client do HATS cujos tempos deexecuo no esto completamente ativados possibilitam conexes de hostilimitadas no ambiente de teste local, mas no conexes de host em umambiente de produo implementado.

Secure Sockets Layer (SSL)Durante a migrao, o HATS V9.5 converte arquivos de classe de certificado SSL,arquivos CustomizedCAs.class, em arquivos keystore PKCS12 com os nomesappname-CustomizedCAs.p12 e senhas hats, em que appname o nome do projeto.Aps a migrao, voc deve utilizar a ferramenta Certificate Management (tambmconhecida como IBM Key Management ou iKeyMan) para alterar as senhas dosnovos arquivos de armazenamento de chaves e verific-las utilizando o editor deconexo. Para obter informaes adicionais, consulte Segurana na pgina 152.

Modos de TesteComeando com o HATS V7, os modos de teste Executar no Servidor (paraprojetos da Web) e Executar (para projetos do rich client) podem ser utilizadospara modificar e testar as configuraes do tempo de execuo que soimplementadas no ambiente de produo. Saiba que todas as alteraes feitas nasconfiguraes de tempo de execuo durante o teste neste modo sero retidas eefetivadas quando voc implementar o aplicativo do HATS em um ambiente deproduo.

Os modos de Teste Depurar no Servidor (para projetos da Web) e Depurar (paraprojetos rich client) podem ser utilizados para modificar e testar as configuraesde tempo de execuo sem modificar as configuraes implementadas no ambientede produo.

Para obter informaes adicionais sobre como alterar configuraes do tempo deexecuo para projetos da Web, consulte Iniciando o Console AdministrativoEnquanto Est no HATS Toolkit na pgina 445. Para obter informaes adicionaissobre como alterar configuraes do tempo de execuo para projetos do richclient, consulte Administrando Aplicativos Rich Client do HATS na pgina 84.

componente de host URLAntes do HATS V7, o componente de host URL procurava dentro do campo deentrada e do campo protegido. A partir do HATS V7, o componente de host URLprocura apenas dentro dos campos protegidos no-ocultos.

Web Express Logon (WEL)Quando um projeto da web do HATS migrado para o HATS V9.5 sem nenhumEAR associado, o Web Express Logon (WEL) no funciona corretamente. Asinformaes de configurao do WEL para um projeto da Web so mantidas emseu projeto EAR associado. Se o projeto EAR associado no for importado emigrando, ento, suas informaes sero perdidas.

Se voc importar os projetos da Web e EAR como archive na rea de trabalho emigrar o projeto da Web, o projeto EAR associado tambm ser migrado e asinformaes de configurao do WEL no sero perdidas.

A partir do HATS V7, o Java Secure Socket Extension (JSSE) utilizado pelosplug-ins de mapeador de credenciais HATS DCAS/RACF/JDBC e DCAS/RACF


|

|

baseado em certificado para conexes seguras com o servidor DCAS. Comoresultado, considere as seguintes alteraes para os parmetros de inicializao deplug-in.

CMPI_DCAS_KEYRING_FILEEste parmetro est reprovado e no deve ser utilizado. Entretanto, seutilizado, ele suportado no HATS V9.5 em conjunto com o parmetrodescontinuado, CMPI_DCAS_KEYRING_PASSWORD. e assumindo que otipo de conjunto de chaves seja pkcs12. Utilize CMPI_DCAS_TRUSTSTOREem substituio. Para obter informaes adicionais, consulte Parmetrosde Inicializao na pgina 480.

Este parmetro especifica um banco de dados de keyring. Um conjunto dechaves deve ser especificado para fornecer acesso ao certificado clienteDCAS assim como ao certificado do servidor DCAS. Os certificadosestabelecem uma conexo segura autenticada do cliente com o servidorDCAS. Este parmetro uma referncia de arquivo para utilizar o conjuntode chaves. O plug-in do DCAS o cliente DCAS. O arquivo do conjuntode chaves deve ser armazenado no arquivo .ear.

CMPI_DCAS_KEYRING_PASSWORDEste parmetro est reprovado e no deve ser utilizado. No entanto, seusado, ele suportado no HATS V9.5 em conjunto com o parmetrodescontinuado, CMPI_DCAS_KEYRING_FILE, e supondo que o tipo deconjunto de chaves seja pkcs12. UtilizeCMPI_DCAS_TRUSTSTORE_PASSWORD em substituio. Para obterinformaes adicionais, consulte Parmetros de Inicializao na pgina480.

Este parmetro especifica a senha do banco de dados de keyring.

Usurios do HATS para Host PublisherSe voc for um usurio com experincia no IBM WebSphere Host Publisher,precisar ajustar sua abordagem a fim de desenvolver projetos com o HATS.Algumas diferenas chaves entre as abordagens do HATS e do Host Publisher nodesenvolvimento de projetos so:v No h servidor HATS para instalar. O cdigo executvel do HATS, conhecido

como o tempo de execuo do HATS, incorporado em cada .ear do HATS quando exportado no HATS Toolkit. Os projetos HATS tambm permitiro ter vriosarquivos .war dentro de um arquivo .ear.

v O Host Publisher no transforma as telas do host ou as apresenta ao usurio; emvez disso, ele recupera informaes especficas dos aplicativos host e exibe essasinformaes. Embora voc possa criar um projeto do HATS que

IBM Host Access Transformation Services: Guia do Usuário e ... · Utilizando o Assistente de...

Documents

Transcript of IBM Host Access Transformation Services: Guia do Usuário e ... · Utilizando o Assistente de...