152
Content Manager OnDemand para i Versão 7 Release 1 Guia de Planejamento e Instalação do Common Server S517-9671-00

Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

  • Upload
    trinhtu

  • View
    216

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Content Manager OnDemand para iVersão 7 Release 1

Guia de Planejamento e Instalação doCommon Server

S517-9671-00

����

Page 2: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91
Page 3: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Content Manager OnDemand para iVersão 7 Release 1

Guia de Planejamento e Instalação doCommon Server

S517-9671-00

����

Page 4: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

NotaAntes de utilizar estas informações e o produto suportado por elas, leia as informações em “Avisos” na página 123.

Esta edição se aplica à versão 7, release 1 do IBM Content Manager OnDemand para i (número de produto5770-RD1) e a todos os releases e modificações subsequentes, até que seja indicado o contrário em novas edições.

© Copyright IBM Corporation 2001, 2010.

Page 5: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Índice

Sobre o Guia de Planejamento eInstalação do IBM Content ManagerOnDemand para i Common Server(S517-7186) . . . . . . . . . . . . . viiQuem Deveria Ler Este Manual . . . . . . . viiComo Este Manual Está Organizado . . . . . . viiPré-requisitos e Informações Relacionadas . . . . ix

Outras Informações Estão Disponíveis na WorldWide Web . . . . . . . . . . . . . . ixIBM i Navigator . . . . . . . . . . . . xCentro de Informações do OnDemand . . . . . xInformações de Acessibilidade para o OnDemand x

Como Enviar Seus Comentários . . . . . . . . x

Resumo das Alterações. . . . . . . . xiNovas Funções . . . . . . . . . . . . . xiAprimoramentos de Comandos . . . . . . . xiiiFunções Adicionais Incluídas Anteriormente eIncluídas no OnDemand Versão 7.1 . . . . . . xivAo Fazer Upgrade para a Versão 7.1, Considere oSeguinte . . . . . . . . . . . . . . . xv

Parte 1. Introdução . . . . . . . . . 1

Capítulo 1. Sobre o OnDemand. . . . . 3Visão Geral . . . . . . . . . . . . . . . 3Visão Geral do Sistema . . . . . . . . . . . 4Conceitos . . . . . . . . . . . . . . . 4

Aplicativo . . . . . . . . . . . . . . 5Grupo de Aplicativos . . . . . . . . . . 5Pasta . . . . . . . . . . . . . . . . 5Gabinete . . . . . . . . . . . . . . . 6

Métodos de Indexação . . . . . . . . . . . 7Documentos . . . . . . . . . . . . . . 7Servidor . . . . . . . . . . . . . . . . 8

Gerenciador de Pedidos . . . . . . . . . 9Gerenciador de Banco de Dados . . . . . . 10Gerenciador de Armazenamento . . . . . . 10Indexação e Carregamento de Dados . . . . . 10Programas de Gerenciamento . . . . . . . 11Web Enablement Kit . . . . . . . . . . 12

Capítulo 2. Preparando para oOnDemand . . . . . . . . . . . . . 15Funções e Responsabilidades Administrativas . . . 16Interfaces de Programação de Aplicativo . . . . 17

Personalização do Cliente. . . . . . . . . 17APIs do Servidor . . . . . . . . . . . 18Registro do Servidor . . . . . . . . . . 18

Capítulo 3. Gerenciamento deArmazenamento em Archive . . . . . 21Introdução. . . . . . . . . . . . . . . 21

Objetos de Armazenamento no OnDemand. . . . 21Como Definir a Configuração do Armazenamento 22

Parte 2. Requisitos do Sistema . . . 23

Capítulo 4. Hardware e Software. . . . 25

Parte 3. Informações do Suporte dePlanejamento . . . . . . . . . . . 27

Capítulo 5. Relatórios e Outros Dados 29Como Reunir os Requisitos . . . . . . . . . 29Formatos dos Dados de Entrada . . . . . . . 29Dados de Indexação . . . . . . . . . . . 31

Indexação de Documento . . . . . . . . . 31Indexação de Página . . . . . . . . . . 32Como Indexar Dados com Programas doOnDemand . . . . . . . . . . . . . 33Como Indexar Relatórios Utilizando Campos deDatas . . . . . . . . . . . . . . . 34

Capítulo 6. Objetos do OnDemand . . . 35Visão Geral . . . . . . . . . . . . . . 35Pastas . . . . . . . . . . . . . . . . 36Grupos de Aplicativos . . . . . . . . . . . 37Aplicativos . . . . . . . . . . . . . . 39Usuários e Grupos . . . . . . . . . . . . 40Relacionamento de IDs do Usuário do OnDemandcom Perfis do Usuário do IBM i . . . . . . . 40Permissões . . . . . . . . . . . . . . 41

Visão Geral . . . . . . . . . . . . . 41Permissões para a Pasta . . . . . . . . . 41Permissões para Grupo de Aplicativos . . . . 42

Regras de Nomenclatura . . . . . . . . . . 43Tipos de Dados e Tipos de Campos . . . . . . 45

Capítulo 7. Requisitos de Memória. . . 49Visão Geral . . . . . . . . . . . . . . 49Hierarquia de Armazenamento . . . . . . . . 51Compactação de Dados . . . . . . . . . . 51Cálculo dos Requisitos de Armazenamento emDisco . . . . . . . . . . . . . . . . 52

Software do Sistema . . . . . . . . . . 52Espaço Temporário para Indexação . . . . . 52Armazenamento em Disco para RelatóriosArmazenados. . . . . . . . . . . . . 52Armazenamento do Banco de Dados doOnDemand . . . . . . . . . . . . . 53Armazenamento do Diário do Banco de Dados 54Espaço Temporário para Importação de Dados deÍndice . . . . . . . . . . . . . . . 54

Cálculo dos Requisitos de Armazenamento emArchive. . . . . . . . . . . . . . . . 55

© Copyright IBM Corp. 2001, 2010 iii

||

Page 6: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Espaço de Armazenamento de Relatório . . . . 55Espaço de Armazenamento de Índice Migrado . 55

Capítulo 8. Backup e Recuperação. . . 57Visão Geral . . . . . . . . . . . . . . 57Software do Servidor . . . . . . . . . . . 57Informações do Servidor . . . . . . . . . . 57Banco de Dados do OnDemand . . . . . . . 57

Backup do Banco de Dados . . . . . . . . 57Criação de Diário do Banco de Dados . . . . 58Recuperação do Banco de Dados . . . . . . 58

Relatórios . . . . . . . . . . . . . . . 58Armazenamento em Disco . . . . . . . . 59Armazenamento em Archive . . . . . . . 59

Capítulo 9. Como Salvar Arquivos deConfiguração . . . . . . . . . . . . 61Arquivos do OnDemand . . . . . . . . . . 61Arquivos de Fonte do Windows . . . . . . . 62

Parte 4. Instalação do Software. . . 63

Capítulo 10. Lista de Verificação daInstalação . . . . . . . . . . . . . 65

Capítulo 11. Instalação do Software doServidor OnDemand . . . . . . . . . 67Obtendo o Software OnDemand . . . . . . . 67Instalação do OnDemand. . . . . . . . . . 67

OnDemand procedimentos de instalação . . . 67Instalação do Cliente do Usuário Final doOnDemand . . . . . . . . . . . . . 68Instalação do Cliente Administrativo doOnDemand . . . . . . . . . . . . . 68

Parte 5. Configuração eInicialização do Sistema . . . . . . 69

Capítulo 12. Criação de uma ocorrência 71Sobre as ocorrências . . . . . . . . . . . 71Configuração de uma ocorrência . . . . . . . 71Alterando a Configuração de uma Instância . . . 73Exclusão de uma Instância . . . . . . . . . 74Início e Parada dos Servidores . . . . . . . . 75

Iniciando os Servidores . . . . . . . . . 75Parando os Servidores . . . . . . . . . . 76Gerenciamento de Trabalho do Servidor . . . . 77

Início Automático de Instâncias. . . . . . . . 78Conexão com Instâncias . . . . . . . . . . 78

Conexão a partir de Clientes do OnDemand . . 78Como Trabalhar com Instâncias. . . . . . . . 78

Capítulo 13. Definição do Locale . . . 81Consideração Importante sobre Códigos de Idioma 81Etapas a Serem Executadas Após ConfigurarCódigos de Idioma . . . . . . . . . . . . 82Resolvendo Problemas. . . . . . . . . . . 82

Capítulo 14. Configuração do ArquivoARS.CFG. . . . . . . . . . . . . . 85Parâmetro ARS_AUTOSTART_INSTANCE . . . . 85Parâmetro ARS_LANGUAGE . . . . . . . . 85Parâmetro ARS_MSGS_LANGUAGE . . . . . . 85Parâmetro ARS_MESSAGE_OF_THE_DAY . . . . 86Parâmetro ARS_NUM_DBSRVR . . . . . . . 86Parâmetro ARS_SUPPORT_CFSOD . . . . . . 86Parâmetro ARS_SUPPORT_HOLD . . . . . . . 86Parâmetro ARS_TMP . . . . . . . . . . . 86Parâmetro ARS_PRINT_PATH . . . . . . . . 86Parâmetro ARSSOCK_RESOLVE_CLIENT_NAME 87

Capítulo 15. Configuração daInicialização do Sistema . . . . . . . 89Iniciar os Jobs do Servidor . . . . . . . . . 89Iniciar os Monitores de Fila da Saída . . . . . . 89

Capítulo 16. Planejamento deProgramas de Manutenção . . . . . . 91Manutenção de Dados do Grupo de Aplicativos . . 91Backup do Banco de Dados do OnDemand . . . . 92

Parte 6. Preparação do Sistemapara Utilização . . . . . . . . . . 93

Capítulo 17. Verificação da Instalação 95

Capítulo 18. Definição de políticas demigração e conjuntos dearmazenamento . . . . . . . . . . . 97

Capítulo 19. Configuração do Grupo deAplicativos do Log do Sistema . . . . 99Manutenção dos Dados de Log do Sistema noArmazenamento em Archive . . . . . . . . 99Reduzindo o Tamanho do Log do Sistema. . . . 100

Capítulo 20. Configuração do Grupode Aplicativos de Migração doSistema . . . . . . . . . . . . . . 103Atribuição do Grupo de Aplicativos de Migraçãodo Sistema a um Conjunto de Armazenamento . . 103

Capítulo 21. Backup dos dados doOnDemand . . . . . . . . . . . . 105

Apêndice A. Servidores de Banco deDados . . . . . . . . . . . . . . 107Descrição . . . . . . . . . . . . . . . 107

Apêndice B. Suporte ao IdiomaNacional . . . . . . . . . . . . . 109Visão Geral . . . . . . . . . . . . . . 109Conversão entre Páginas de Códigos Diferentes 109

Quando a Conversão de Caracteres Ocorre? . . 109

iv Guia de Planejamento e Instalação

||

||||||||

||

||||

Page 7: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Mapeamento de Caracteres . . . . . . . . 110Como o OnDemand Determina Valores de Páginade Códigos? . . . . . . . . . . . . . . 111Configuração do Sistema para NLS . . . . . . 111

Identificadores de Idioma . . . . . . . . 111Códigos do Idioma . . . . . . . . . . 112Mapeando Fontes AFP . . . . . . . . . 113

Criação de Grupos de Aplicativos . . . . . . 114Criação de Aplicativos . . . . . . . . . . 114

Tipo de Dados . . . . . . . . . . . . 115Indexação . . . . . . . . . . . . . 115

Exibições Lógicas . . . . . . . . . . . 116Execução de Programas do OnDemand. . . . . 116

Apêndice C. Log do Sistema e Saídado Usuário de Log do Sistema . . . . 119

Avisos . . . . . . . . . . . . . . 123Marcas Registradas . . . . . . . . . . . 125

Índice Remissivo . . . . . . . . . . 127

Índice v

Page 8: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

vi Guia de Planejamento e Instalação

Page 9: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Sobre o Guia de Planejamento e Instalação do IBM ContentManager OnDemand para i Common Server (S517-7186)

Este manual contém informações sobre planejamento e instalação do IBM® ContentManager OnDemand para i Common Server Versão 7 Release 1 (OnDemand).

Quem Deveria Ler Este ManualEste manual é primeiramente intencionado para administradores de sistema queprecisam implementar, instalar e manter o software OnDemand. Também pode serutilizado por outros usuários que requerem um conhecimento sobre administraçãoe operação do sistema OnDemand.

Como Este Manual Está OrganizadoEste manual está organizado nas seguintes partes:v Parte 1, “Introdução”, na página 1 fornece uma visão geral do OnDemand. Esta

parte contém as seguintes sessões:Capítulo 1, “Sobre o OnDemand”, na página 3 fornece uma visão geral dosistemaCapítulo 2, “Preparando para o OnDemand”, na página 15 contéminformações que podem ajudá-lo a preparar sua empresa para o OnDemand,lista os tipos de tarefas administrativas necessárias para manter o sistema edescreve várias formas de configurar a operação do servidor e dos clientesCapítulo 3, “Gerenciamento de Armazenamento em Archive”, na página 21descreve como o OnDemand funciona com o gerenciador de armazenamentopara manter documentos em armazenamento de archive

v Parte 2, “Requisitos do Sistema”, na página 23 lista os requisitos de hardware,software, rede e impressão e outras informações sobre servidores e clientesOnDemand. Esta parte contém as seguintes sessões:

Capítulo 4, “Hardware e Software”, na página 25 lista os requisitos dehardware, software e licenciamento necessários para servidores e clientes,fornece informações sobre os diversos tipos de configuração do servidor,contém informações sobre o download de dados para o servidor e relatóriosde impressão a partir do servidor

v Parte 3, “Informações do Suporte de Planejamento”, na página 27 contéminformações que podem ajudá-lo a definir relatórios1 para o OnDemand, indexardados, fazer uma estimativa de requisitos de armazenamento e planejar obackup e a recuperação dos dados do sistema. Esta parte contém as seguintessessões:

Capítulo 5, “Relatórios e Outros Dados”, na página 29 contém informaçõesque podem ajudá-lo a planejar os relatórios que serão armazenados nosistemaCapítulo 6, “Objetos do OnDemand”, na página 35 contém informações quepodem ajudá-lo a planejar grupos de aplicativos, aplicativos e pastas dosseus relatórios

1. No OnDemand, o termo relatório refere-se a qualquer tipo de dado que você deseja armazenar no sistema. Um livro geral de10.000 páginas gerado por um aplicativo do IBM e um arquivo de duas páginas Lotus WordPro são relatórios do OnDemand.

© Copyright IBM Corp. 2001, 2010 vii

||

Page 10: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 7, “Requisitos de Memória”, na página 49 fornece informações quepodem ajudá-lo a fazer uma estimativa da quantidade de memória necessáriapara manter relatórios no sistemaCapítulo 8, “Backup e Recuperação”, na página 57 fornece informações quevocê pode utilizar para desenvolver um plano de backup e recuperação dosistemaCapítulo 9, “Como Salvar Arquivos de Configuração”, na página 61 forneceinformações sobre como configurar um servidor após instalar o softwareOnDemand para atender às necessidades específicas do ambiente

Parte 4, “Instalação do Software”, na página 63 fornece informações para instalaro software do servidor OnDemand no servidor IBM i. Esta parte contém asseguintes sessões:

Capítulo 10, “Lista de Verificação da Instalação”, na página 65 contéminformações para ajudá-lo a preparar o sistema para a instalação do software.Capítulo 11, “Instalação do Software do Servidor OnDemand”, na página 67contém informações sobre a instalação do software do servidor OnDemand,do cliente do usuário final e de software administrativo.

Parte 5, “Configuração e Inicialização do Sistema”, na página 69 forneceinformações sobre como configurar o servidor OnDemand para operar e oferecersuporte à sua empresa e a criar e inicializar o banco de dados. Esta parte contémas seguintes sessões:

Capítulo 12, “Criação de uma ocorrência”, na página 71 define e forneceinformações sobre a configuração de instâncias do OnDemand.Capítulo 13, “Definição do Locale”, na página 81Capítulo 14, “Configuração do Arquivo ARS.CFG”, na página 85 fornecediversos programas do OnDemand e como eles obtêm informações doarquivo ARS.CFG sobre diversas definições de configuração.Capítulo 15, “Configuração da Inicialização do Sistema”, na página 89 forneceinformações sobre as funções do servidor que você pode escolher para sereminiciadas automaticamente sempre que o sistema for iniciado.Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91fornece informações sobre os comandos de manutenção do OnDemand aserem executados automaticamente de forma regular.

v Parte 6, “Preparação do Sistema para Utilização”, na página 93 como verificar ainstalação do OnDemand. Esta parte contém as seguintes sessões:

Capítulo 17, “Verificação da Instalação”, na página 95 fornece informaçõessobre como iniciar sessão em um servidor, atualizar um servidor e outrasetapas de validação da instalação.Capítulo 18, “Definição de políticas de migração e conjuntos dearmazenamento”, na página 97 define políticas de migração e conjuntos dearmazenamento para que você possa definir relatórios para o OnDemand oucarregar dados no sistema.Capítulo 19, “Configuração do Grupo de Aplicativos do Log do Sistema”, napágina 99 fornece informações sobre como inicializar o log do sistema. O logdo sistema é consiste no grupo de aplicativos de Log do sistema, em umconjunto de aplicativos de Log do sistema e na pasta de Log do sistema.Quando você instala e configura o OnDemand, inicializa o log do sistema.Capítulo 20, “Configuração do Grupo de Aplicativos de Migração doSistema”, na página 103 fornece informações sobre migração de índice, que éo processo pelo qual o OnDemand move dados do índice do banco de dadospara o armazenamento de archive.

viii Guia de Planejamento e Instalação

Page 11: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 21, “Backup dos dados do OnDemand”, na página 105 forneceinformações sobre a criação de um backup off-line completo do banco dedados do OnDemand em mídia removível.

v Apêndice A, “Servidores de Banco de Dados”, na página 107 forneceinformações sobre o parâmetro ARS_NUM_DBSRVR no arquivo ARS.CFG, oqual determina o número de processos que OnDemand pode iniciar no servidorpara tratar pedidos do banco de dados.

v Apêndice B, “Suporte ao Idioma Nacional”, na página 109 fornece informaçõessobre o NLS (Suporte ao Idioma Nacional) fornecido pelo OnDemand e incluiinformações sobre as páginas de códigos (conjuntos de códigos) suportadas paraoferecer suporte a caracteres do NL (Idioma Nacional).

v Apêndice C, “Log do Sistema e Saída do Usuário de Log do Sistema”, na página119 fornece informações sobre as mensagens do sistema geradas peloOnDemand.

Pré-requisitos e Informações RelacionadasUse o Centro de Informações do IBM i como seu ponto de início para consultarinformações técnicas do IBM i.

O Centro de Informações pode ser acessado de duas formas:v No seguinte Web site: http://www.ibm.com/systems/i/infocenter/v Nos CD-ROMs fornecidos com seu pedido do IBM i: IBM i Information Center

SK3T-4091-07

O Centro de Informações do IBM i contém:v Informações novas e atualizadas, incluindo instalação e ugprades do IBM i,

migração de dados, serviço e resolução de problemas, disponibilidade,integração do IBM i, conexão com o IBM i, banco de dados, Linux®, WebSphere,Java™, comandos CL, APIs do sistema e manuais.

v Os orientadores e outras ferramentas interativas auxiliam na resolução deproblemas e na configuração de seu software IBM i.

O Centro de Informações contém conselhos e tópicos importantes tais como Java,TCP/IP, servidor da Web, redes seguras, partições lógicas, armazenamento emcluster, comandos CL e Interfaces de Programação de Aplicativo (APIs) do sistema.Ele também inclui links para IBM Redbooks relacionados e links da Internet paraoutros Web sites da IBM, como a página inicial da IBM.

Outras Informações Estão Disponíveis na World Wide WebInformações adicionais do IBM i estão disponíveis na World Wide Web. Você podeacessar informações gerais a partir da página inicial do IBM i, no seguinte Website: http://www.ibm.com/systems/i/

Para acessar workshops sobre funções avançadas do IBM i, selecione a guiaWorkshops a partir do Web site IBM Redbooks, localizado em:http://www.redbooks.ibm.com

Em todo o mundo, você pode ler, selecionar, solicitar e receber a entrega deProgram Temporary Fixes (PTFs) do programa IBM i através da Internet. PTFs(downloads) e informações de Preventive Service Planning (PSP) do IBM i naInternet estão disponíveis no seguinte local da Internet: http://www.ibm.com/systems/support/i

Sobre o Guia de Planejamento e Instalação do IBM Content Manager OnDemand para i Common Server (S517-7186) ix

|||

Page 12: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

A documentação do produto está disponível na página Documentação do Web sitede suporte do produto Content Manager OnDemand para i. Para ver uma lista detoda a documentação disponível do produto OnDemand para i, acessehttp://www.ibm.com/software/data/ondemand/400/support.html. Escolha o linkDocumentation e, em seguida, procure o título "Product Documentation," eselecione "Version 7.1 documentation (all supported languages)".

IBM i NavigatorO IBM i Navigator é uma poderosa interface gráfica para gerenciar seus servidoresIBM i. A funcionalidade do IBM i Navigator inclui navegação do sistema,configuração, recursos de planejamento e ajuda on-line para guiá-lo por suastarefas. O IBM i Navigator torna a operação e a administração do servidor maisfáceis e produtivas e é a única interface com o usuário para os novos recursosavançados do sistema operacional. Também inclui Central de Gerenciamento paragerenciar vários servidores a partir de um sistema central.

Informações adicionais sobre o IBM i Navigator podem ser localizadas no Centrode Informações do IBM i e no seguinte Web site: http://www.ibm.com/eserver/iseries/navigator/

Centro de Informações do OnDemandAlém do Centro de Informações do IBM i, certifique-se de visitar o Centro deInformações do OnDemand, que tem como foco apenas as informações relativas aoContent Manager OnDemand. O Centro de Informações do OnDemand forneceacesso às informações dos produtos, de forma rápida, centralizada e on-line. É umrepositório de documentação baseado em tarefas que permite que você procure nabiblioteca inteira do produto por comandos, códigos de erro ou qualquer outrotópico de interesse. Você pode marcar as páginas e recuperá-las posteriormentepara rápida referência.

Para usar o Centro de Informações do OnDemand, acesse http://publib.boulder.ibm.com/infocenter/cmod/v8r4m1//index.jsp

Informações de Acessibilidade para o OnDemandPara obter informações completas sobre os recursos de acessibilidade suportadospor esse produto consulte o IBM Content Manager OnDemand for i: Common ServerAdministration Guide.

Como Enviar Seus ComentáriosSeu feedback ajuda a IBM a fornecer informações de qualidade. Envie seuscomentários sobre esta publicação ou sobre outra documentação do OnDemand.Visite a página Reader's Comment Form (RCF) On-line do IBM Data Managementem www.ibm.com/software/data/rcf.

Lembre-se de incluir o nome e a versão do produto e o nome do manual. Seestiver comentando sobre um texto específico, inclua o local do texto (por exemplo,um capítulo e título de seção, um número de tabela, um número de página ou umtítulo de tópico de ajuda).

x Guia de Planejamento e Instalação

||||||

||||||||

||

Page 13: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Resumo das Alterações

Esta edição do IBM Content Manager OnDemand para i: Guia de Planejamento eInstalação do Common Server contém novas informações técnicas. Pode haver casosem que foram feitas alterações, mas as barras de alteração estão faltando. Asalterações significantes a notar são:

Novas Funçõesv Novos comandos foram incluídos para substituir as chamadas do programa para

várias funções do OnDemand diferentes:– Use o novo comando Create Instance for OnDemand (CRTINSTOND) em vez

de chamar o programa QRLMINST para criar novas instâncias doOnDemand. O novo comando fornece parâmetros adicionais além daquelesfornecidos pelo programa QRLMINST. O comando permite especificarparâmetros relacionados a Porta, Autoinicialização, Segurança e AuxiliaryStorage Pool (ASP) no comando para que os arquivos de configuraçãoars.ini e ars.cfg não precisem ser editados em muitos casos. Observe que ainterface de chamada do programa não é mais suportada. A interface docomando é a única interface suportada na versão 7.1.

– Use o novo comando Merge Spooled Files (MRGSPLFOND) em vez docomando de amostra MRGSPLFOND antigo (fornecido em releases anteriores)ou em vez de chamar o programa QRLMQMRGF para mesclar arquivos despool pequenos em um arquivo maior antes do arquivamento. O novocomando MRGSPLFOND fornecido com a versão 7.1 contém parâmetrosnovos e aprimorados que fornecem significativamente mais função que ocomando de amostra anterior. Qualquer um de seus programas existentes queusa o comando de amostra anterior deve ser alterado para usar os parâmetrosda versão 7.1.

– Use o comando Migrate Midia (MGRMEDRDAR) em vez de chamar oprograma QRLCSFAMMF para migrar dados do OnDemand de um tipo demídia para outro. (Esse comando estava disponível no OnDemand versão 6.1,mas está listado aqui para indicar que a chamada do programa não é maissuportada. Apenas a interface de comando é suportada na versão 7.1.)

– Use o comando Change Policy Level Date (CHGPLDOND) em vez de chamaro programa QRLCASMCLD se você precisar alterar as datas do nível depolítica de migração para dados arquivados. (Esse comando estava disponívelno OnDemand versão 6.1, mas está listado aqui para indicar que a chamadado programa não é mais suportada. Apenas a interface de comando ésuportada na versão 7.1.)

v Uma nova função do System i Navigator foi incluída para substituir a chamadado programa para configurar conjuntos de discos Network File System (NFS)para serem usados com o OnDemand.– Use os novos painéis Network File System (NFS) do plug-in System i

Navigator do OnDemand em vez de chamar o programa QRLCASMNFS.– Consulte o Content Manager OnDemand for i: Common Server

Administration Guide para obter instruções sobre como usar o NFS com oOnDemand.

v Recursos de gerenciamento aprimorado de retenção estão agora disponíveiscomo um recurso do OnDemand para i na 7.1, pago separadamente, quefornecem novas funções de suspensão e liberação para o cliente de usuário final

© Copyright IBM Corp. 2001, 2010 xi

||||

||

|||||||||

|||||||||

|||||

||||||

|||

||

|||

|||

Page 14: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

do OnDemand e parâmetros HOLD-ADD e HOLD-RELEASE para a APIARSDOC, além das APIs Java ODHold e ODHit do ODWEK. A expiração dedocumentos suspensos pode ser evitada até que a suspensão seja liberada.Consulte a nova entrada ARS_SUPPORT_HOLD para o arquivo ARS.CFG noIBM Content Manager OnDemand para i: Guia de Planejamento e Instalação doCommon Server.NOTA IMPORTANTE: Ao usar o gerenciamento aprimorado de retenção, o DiskStorage Manager (DSM) do OnDemand deve estar no controle total doprocessamento de expiração. Se estiver usando o OnDemand Archive StorageManager (ASM) ou o Tivoli Storage Manager, você deverá desativar acapacidade de ambos os gerenciadores de armazenamento de expirar dados. Porexemplo, no ASM, isso significa desativar ou excluir quaisquer níveis deExpiração nas políticas de migração usadas com os grupos de aplicativos doOnDemand que possuem o gerenciamento aprimorado de retenção ativado.

v Todos os dados de gerenciamento de armazenamento foram movidos dabiblioteca QUSRRDARS para a biblioteca de instâncias individual com a qual elaestá associada. Alguns objetos permanecem na biblioteca QUSRRDARS. Essamudança remove a necessidade de mover a biblioteca QUSRRDARS para umIndependent Auxiliary Storage Pool (IASP).

v Uma biblioteca de instâncias pode ser localizada em um Auxiliary Storage Pool(ASP de 2 a 32) do usuário.

v Um novo grupo de aplicativos de Carregamento do Sistema foi incluído, o qualcontém uma entrada para cada arquivo de entrada carregado no OnDemand.Usando o cliente OnDemand, é possível verificar quais dados foram carregadoscom êxito no OnDemand.

v Um novo utilitário ARSSUPPORT baseado em Java está disponível para reunirinformações de diagnóstico, tais como entradas de log. Essa ferramenta é útilquando você precisa relatar problemas para o Suporte de Software IBM.Consulte o IBM Content Manager OnDemand for i: Common ServerAdministration Guide para obter detalhes.

v O Xerces2 Java Parser Versão 2.6.2 está incluído nesta versão do ContentManager OnDemand para i. Consulte o IBM Content Manager OnDemand parai: Guia de Planejamento e Instalação do Common Server para obter instruçõessobre como usar essa versão do analisador.

v Várias mudanças do OnDemand Web Enablement Kit (ODWEK) estão incluídasna versão 7.1. Procure as barras de mudanças em todo o IBM Content ManagerOnDemand for i: Common Server ODWEK Installation and Configuration Guidepara identificar as mudanças.

v Atualizações foram feitas na função de administração de lote (ARSXML API),incluindo atributos novos, renomeados e removidos. Por exemplo, o valor deatributo de nome de _ALL foi removido para atualização e exclusão. (_ALLainda é suportado para operações de exportação.) Consulte o IBM ContentManager OnDemand for i: Common Server Administration Guide para obterdetalhes.

v Novos programas de amostra foram incluídos e amostras existentes foramatualizadas. Consulte o arquivo de origem QSAMPLES2 na biblioteca QRDARS.

v Uma documentação foi incluída com relação à expiração baseada no ArchiveStorage Manager (ASM), que poderia eliminar a necessidade de executar o DiskStorage Manager (DSM). Esse recurso foi disponibilizado no OnDemand 6.1, masestá listado aqui para indicar que uma documentação adicional foi incluída noIBM Content Manager OnDemand for i: Common Server Administration Guidesobre esse tópico. Consulte também a NOTA IMPORTANTE acima, sob

xii Guia de Planejamento e Instalação

||||||

||||||||

|||||

||

||||

|||||

||||

||||

||||||

||

||||||

Page 15: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

gerenciamento aprimorado de retenção, referente às funções de gerenciamentode armazenamento do OnDemand existentes e os novos recursos degerenciamento de retenção.

v O AFP2WEB Transform (que inclui o AFP2PDF e o AFP2HTML), que permiteque dados AFP sejam visualizados usando uma interface do OnDemand WebEnablement Kit (ODWEK), está disponível como um recurso do OnDemand parai, na versão 7.1, pago separadamente. Consulte seu representante ou parceiro denegócios IBM para obter informações adicionais sobre o AFP2WEB Transform.

v O PDF Indexer suporta agrupamento de recursos e a remoção de recursos nãousados. Após a ativação do agrupamento de recursos, os recursos comuns nosdocumentos em um único arquivo de entrada são agrupados e armazenadoscomo um único objeto e os recursos não usados de um arquivo de entradapodem ser removidos antes da indexação. Novos parâmetros do PDF Indexer(RESTYPE e REMOVERES) foram incluídos para suportar esse novo recurso.Para obter informações adicionais, consulte o IBM Content Manager OnDemandfor i: Common Server Indexing Reference.

v A integração com a plataforma FileNet P8 é agora suportada como um recursoda versão 7.1, pago separadamente, permitindo que você envie metadados doContent Manager OnDemand para i para o FileNet e obtenha a vantagem dosrecursos Business Process Management (BPM) e FileNet Records Manager (RM)do FileNet. Para obter informações adicionais sobre esse recurso ContentFederation Services para OnDemand, consulte a nova entradaARS_SUPPORT_CFSOD para o arquivo ARS.CFG no IBM Content ManagerOnDemand para i: Guia de Planejamento e Instalação do Common Server e anova função CFSOD-FED para o ARSDOC no IBM Content Manager OnDemandfor i: Common Server Administration Guide.

v A documentação sobre várias áreas de dados que controlam as funções doOnDemand foi consolidada e incluída no IBM Content Manager OnDemand fori: Common Server Administration Guide.

v Um novo cabeçalho de coluna foi incluído no arquivo de entrada do programapós-processador do OnDemand. Esse novo cabeçalho inicia com o caractere "<" etermina com o caractere ">". Seus programas pós-processadores devem sertestados para assegurar compatibilidade com essa inclusão.

Aprimoramentos de Comandosv Um novo tipo de monitor *DIR2 foi incluído no comando Start Monitor for

OnDemand (STRMONOND), acionado por arquivos .ARD (como a APIARSLOAD) em vez dos arquivos .IND, como o tipo de monitor *DIR atual.Observe que o tipo de monitor *DIR no comando End Monitor for OnDemand(ENDMONOND) encerra qualquer um dos tipos de monitor, independentementese foi iniciado como um monitor *DIR ou *DIR2.

v Dois novos parâmetros foram incluídos no comando Start Monitor forOnDemand (STRMONOND). O parâmetro End server (ENDSVR) permiteencerrar o servidor de instâncias quando o monitor é encerrado. O nome datarefa do Monitor (JOB) permite especificar o nome que você deseja usar para atarefa do nonitor.

v Dois novos parâmetros foram incluídos nos comandos Add Report toOnDemand (ADDRPTOND), Print Report from OnDemand (PRTRPTOND), StartMonitor for OnDemand (STRMONOND), Remove Report from OnDemand(RMVRPTOND), Start Import into OnDemand (STRIMPOND), Start ArchiveStorage Mgmt (STRASMOND), Start Disk Storage Management (STRDSMOND),Merge Spooled Files (MRGSPLFOND), Change Policy Level Date(CHGPLDOND) e Migrate Media (MGRMEDRDAR).

Resumo das Alterações xiii

|||

|||||

||||||||

||||||||||

|||

||||

||||||

|||||

|||||||

Page 16: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

– Usando INSTANCE(*DFT), que é o novo padrão em vez deINSTANCE(QUSROND), um nome de instância padrão pode ser recuperadode uma área de dados nomeada QDFTINST de forma que o nome dainstância não precise ser especificado explicitamente em cada comando.Consulte a ajuda on-line e o IBM Content Manager OnDemand for i:Common Server Administration Guide para obter detalhes sobre a área dedados QDFTINST.

– O parâmetro Start server (STRSVR) pode ser especificado para iniciar oservidor de instâncias quando o comando é executado. (O parâmetro STRSVRnão se aplica ao comando CHGPLDOND.) Consulte a ajuda on-line paraobter informações adicionais.

v Um novo parâmetro VALIDATE foi incluído no comando Start Disk StorageManagement (STRDSMOND) para assegurar que todos os arquivos dearmazenamento em disco sejam vinculados corretamente e contenham aspermissões de arquivo adequadas.

v O parâmetro Maximum number of monitors to start no comando Start Monitorfor OnDemand (STRMONOND) ao iniciar um monitor de fila de saída foireduzido de 99 para 9 para evitar atrasos de bloqueio que poderão ocorrer seum grande número de monitores for iniciado com relação à mesma fila de saída.

Funções Adicionais Incluídas Anteriormente e Incluídas no OnDemandVersão 7.1

v O parâmetro INSTANCE dos comandos Start TCP/IP Server (STRTCPSVR) eEnd TCP/IP Server (ENDTCPSVR) é agora suportado ao especificar *ONDMD(para OnDemand) para o parâmetro SERVER. É possível nomear uma instânciaespecífica para ser iniciada ou usar um dos três valores especiais (*DFT, *ALL,*AUTOSTART). Observe que a chamada do programa QRLMCTL para iniciar ouencerrar uma instância ainda é suportada, mas o uso dos comandos STRTCPSVRe ENDTCPSVR é recomendado. Consulte o IBM Content Manager OnDemandpara i: Guia de Planejamento e Instalação do Common Server e a ajuda on-linepara obter informações adicionais.

v O Lightweight Directory Access Protocol (LDAP), um padrão de mercado abertoque compartilha informações entre aplicativos distribuídos na mesma rede, podeser usado para gerenciar a autenticação básica de login diretamente no servidor.Consulte o IBM Content Manager OnDemand for i: Common ServerAdministration Guide para obter informações adicionais.

v O suporte para o formato de endereçamento Internet Protocol Versão 6 (IPv6),que é uma revisão do esquema de endereçamento IPv4 para TCP/IP, estáincluído na versão 7.1 do Content Manager OnDemand para i. Consulte o IBMContent Manager OnDemand para i: Guia de Planejamento e Instalação doCommon Server para obter informações adicionais.

v O *ASM pode agora ser especificado como a determinação de destino (TGT) nocomando Migrate Midia MGRMEDRDAR, permitindo que os dados sejammovidos da arquitetura do Spool File Archive (gerenciada pelo RMC) para aarquitetura do Common Server (gerenciada pelo ASM).

v O PDF Indexer permite agora que parte do nome do arquivo de entrada sejausada como um valor de índice ao armazenar dados usando a API ARSLOAD.

xiv Guia de Planejamento e Instalação

|||||||

||||

||||

||||

|||||||||

|||||

|||||

||||

||

Page 17: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Ao Fazer Upgrade para a Versão 7.1, Considere o Seguintev Se você estiver fazendo upgrade de uma versão anterior do OnDemand, é

necessário que esteja executando o servidor OnDemand versão 7.1.2.8, ousuperior, antes de fazer upgrade para o Content Manager OnDemand para iVersão 7 Release 1. Para determinar sua versão atual do servidor, consulte o IBMContent Manager OnDemand para i: Guia de Planejamento e Instalação doCommon Server para obter instruções.

v A Versão 7.1 do Content Manager OnDemand para i não suporta o software docliente OnDemand anterior à versão 7.1.2.0. Isso inclui, mas não se limita a,cliente OnDemand Windows® (usuário final), APIs CGI/Servlet/Java doODWEK, CICS e II4C (eClient).

v O cliente Administrador do OnDemand deve estar na mesma versão, ousuperior, que o servidor OnDemand. Para a versão 7.1 do Content ManagerOnDemand para i, o cliente Administrador do OnDemand deve estar na versão8.4.1.3 ou superior.

v Iniciar uma instância ou iniciar o processo do Archive Storage Management(ASM) pela primeira vez após fazer upgrade para a versão 7.1 leva mais tempoque o normal devido às conversões de arquivos e à movimentação de dados eobjetos específicos da instância da QUSRRDARS para as bibliotecas deinstâncias.– Não encerre a tarefa do servidor ou o ASM se você estiver preocupado de

que ela não está em progresso.– As mensagens de status são gravadas no log da tarefa durante as conversões

de arquivos e a movimentação de dados da QUSRRDARS para a biblioteca deinstâncias, as quais você pode verificar para confirmar se a tarefa está emprogresso.

v Se existir uma descrição de tarefa (tipo de objeto *JOBD) na bibliotecaQUSRRDARS que corresponda a um nome de instância do OnDemand definidono sistema, a descrição da tarefa será movida da QUSRRDARS para a bibliotecade instâncias. Quando o OnDemand procura uma descrição de tarefa para serusada para iniciar o servidor de instâncias, o OnDemand procura primeiro porum objeto *JOBD que esteja nomeado igual ao nome da instância na bibliotecade instâncias. Se nenhum for localizado, o OnDemand procurá por um objeto*JOBD que esteja nomeado igual ao nome da instância na bibliotecaQUSRRDARS. Se nenhum for localizado, o OnDemand usará a descrição detarefa QOND400 localizada na biblioteca QRDARS.

v As chamadas do programa a seguir foram substituídas por novos comandos ouuma nova interface do System i Navigator na versão 7.1:– Substitua o programa de amostra MRGSPLF e o comando de amostra

MRGSPLFOND anterior pelo novo comando MRGSPLFOND.– Substitua o programa QRLMINST pelo comando CRTINSTOND.– Substitua o programa QRLCASMNFS pela interface do plug-in System i

Navigator.– Substitua o programa QRLCSFAMMF pelo comando MGRMEDRDAR.– Substitua o programa QRLCASMCLD pelo comando CHGPLDOND.

v O menu OnDemand Commands (CMDOND), que inclui todos os comandos doOnDemand para i Common Server, é o único menu 5250 fornecido com oOnDemand versão 7.1. Os seguintes menus do OnDemand 5250 foramremovidos:– CMDRDAR– ONDEMAND

Resumo das Alterações xv

||||||

||||

||||

|||||

||

||||

||||||||||

||

||

|

||

|

|

||||

|

|

Page 18: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

– RDARS– RDARSDEF– RDARSM– RDARSOBJ– RDARSRLA– RDARSRPT– RDARSUTL

v Se você instalou fontes para serem usadas com o PDF Indexer, deverá verificar olocal das fontes e movê-las para os diretórios requeridos pelo PDF Indexer, senecessário. Para obter detalhes específicos, consulte o IBM Content ManagerOnDemand for i: Common Server Indexing Reference.

v O arquivo de impressora QPRLR133 na biblioteca QRDARS não faz mais partedo produto, porque ele era um componente do Spool File Archive, que não estãomais disponível. O arquivo de impressora é removido quando a versão 7.1 éinstalada.

v O programa de desmontagem do sistema de arquivos (QRLCASMUFS ) nãosuporta mais *ALL para o nome da instância, porque todos os arquivosespecíficos da instância estão agora nas bibliotecas de instâncias individuais.Você deve nomear uma instância específica ao chamar o programa.

v Antes de usar a versão mais recente do CGI/Servlet do OnDemand WebEnablement Kit (ODWEK), é necessário excluir todos os arquivos dos diretórioscache e temp do Web Enablement Kit. Os diretórios são especificados pelasentradas CACHEDIR e TEMPDIR no arquivo arswww.ini.

v As implementações existentes do Spool File Archive devem ser migradas doambiente do Spool File Archive para o Common Server antes de ser feitoupgrade do sistema no qual elas estão em execução para a versão 7.1. Osreleases 5.3 e 5.4 do Content Manager OnDemand incluíam o ambiente doCommon Server, bem como os ambientes legados do Spool File Archive,AnyStore, Record Archive e Object Archive. Todos esses ambientes sãototalmente suportados até, e inclusive, o i5/OS 5.4.Conforme declarado na Carta de Anúncio da IBM nº 206-030 de 14 de fevereirode 2006, o 5.4 era o último release em que o Spool File Archive, AnyStore,Record Archive e Object Archive seriam fornecidos e suportados. A partir doContent Manager OnDemand 5.3, um utilitário de migração Spool File Archivefoi disponibilizado como parte do produto de programa licenciado ContentManager OnDemand. O utilitário de migração fornece o recurso para migrardefinições de relatório e índices do ambiente do Spool File Archive legado parao ambiente do Common Server. Informações detalhadas sobre o utilitário demigração podem ser localizadas no Apêndice A do IBM Content ManagerOnDemand para iSeries: Guia de Planejamento e Instalação do Common Serverversão 5.4. As implementações existentes do Spool File Archive devem sermigradas do ambiente do Spool File Archive para o Common Server antes deser feito upgrade do sistema para a versão 7.1.

xvi Guia de Planejamento e Instalação

|

|

|

|

|

|

|

||||

||||

||||

||||

|||||||

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

Page 19: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parte 1. Introdução

Esta seção fornece uma visão geral do sistema OnDemand e contém informaçõespara ajudá-lo a compreender melhor como o OnDemand funciona. Esta seçãodescreve como o OnDemand gerencia relatórios e dados de índice, incluiinformações importantes como o OnDemand, o gerenciador do banco de dados e ogerenciador de armazenamento funcionam para carregar e recuperar documentos2

e contém uma lista das tarefas que os administradores do OnDemand executamnormalmente para gerenciar um sistema OnDemand.

2. No OnDemand, o termo documento refere-se a uma parte indexada de um relatório, tal como uma instrução, política ou outroagrupamento lógico de páginas.

© Copyright IBM Corp. 2001, 2010 1

Page 20: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

2 Guia de Planejamento e Instalação

Page 21: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 1. Sobre o OnDemand

Visão GeralO OnDemand suporta qualquer organização que possa se beneficiar de cópiaimpressa ou de substituição de microfichas e do acesso a informações de formainstantânea. Um sistema OnDemand pode suportar pequenos ambientes deescritório e grandes instalações corporativas, com centenas de usuários. OOnDemand pode melhorar tremendamente a produtividade e o serviço ao clienteem muitas empresas, proporcionando acesso rápido às informações que estãoarmazenadas no sistema.

O OnDemand processa a saída dos programas de aplicativo, extrai campos deíndice dos dados, armazena as informações do índice em um banco de dadosrelacional e armazena uma ou mais cópias dos dados no sistema. Com oOnDemand, é possível arquivar dados recém-criados e frequentemente acessadosem volumes de armazenamento em disco de alta velocidade e migrá-losautomaticamente para outros tipos de volumes de armazenamento à medida emque tornam-se antigos.

O OnDemand integra totalmente os recursos de Advanced Function Presentation(AFP), incluindo gerenciamento de recursos, índices e anotações e suporta areimpressão e o envio de fax de documentos com total fidelidade para osdispositivos conectados a uma estação de trabalho ou a um servidor doOnDemand.

O OnDemand fornece aos administradores ferramentas para gerenciar servidoresOnDemand e autorizar os usuários a acessar os servidores OnDemand e os dadosarmazenados no sistema.

O OnDemand fornece aos usuários a capacidade de exibir documentos, imprimir,enviar e receber e-mail, transmitir cópias de documentos por fax e anexaranotações eletrônicas a documentos.

Algumas das vantagens que o OnDemand oferece incluem:v Localização fácil dos dados sem especificar a data exata em que foram criadosv Recuperação das páginas necessárias do relatório, sem processar todo o relatóriov Exibição dos dados selecionados de um relatório

O OnDemand pode fornecer uma ferramenta de gerenciamento de informaçõescapaz de aumentar a eficiência ao se trabalhar com clientes.

O OnDemand executa o seguinte:v Integra os dados criados pelos programas aplicativos em um arquivo de

informações eletrônicas on-line e em um sistema de recuperaçãov Fornece o acesso controlado e confiável a todos os dados de uma organizaçãov Recupera os dados necessários, quando necessáriov Fornece um cliente intuitivo e padronizado, com recursos como miniaturas,

marcadores, notas e atalhos

© Copyright IBM Corp. 2001, 2010 3

Page 22: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Esses recursos significam que o OnDemand pode ajudá-lo a recuperar rapidamenteos dados específicos de que você precisa para fornecer atendimento rápido aocliente.

Visão Geral do SistemaUm sistema OnDemand consiste em: programas cliente e programas servidor quese comunicam através de uma rede que executa o protocolo de comunicaçãoTCP/IP; um gerenciador de banco de dados que mantém os dados do índice e asinformações de controle do servidor; gerenciadores de armazenamento quemantêm os documentos em vários tipos de dispositivos de armazenamento.

Os programas clientes do OnDemand são executados nas estações de trabalhoconectadas à rede e se comunicam com os servidores OnDemand. Os programasclientes do OnDemand operam em computadores pessoais executando sistemasWindows3. O programa cliente é a maneira que o usuário tem para procurar erecuperar dados armazenados no sistema. Com o programa cliente, os usuáriospodem criar consultas e pesquisar relatórios, recuperar documentos do OnDemand,exibir, imprimir, comunicar e-mails e transmitir cópias ou páginas de documentospor fax, assim como anexar anotações eletrônicas às páginas de um documento.

Os servidores OnDemand gerenciam as informações de controle e os dados doíndice, armazenam e recuperam documentos e arquivos de grupos de recursos eprocessam pedidos de consultas dos programas clientes OnDemand. Osdocumentos podem estar em volumes de armazenamento em disco, ótico e em fita.Novos relatórios podem ser carregados diariamente no OnDemand. Assim, oOnDemand consegue recuperar as informações mais recentes geradas pelosprogramas aplicativos.

Os programas clientes e os servidores OnDemand se comunicam através de umarede de computadores suportada por TCP/IP. Quando um usuário apresenta umaconsulta, o programa cliente envia um pedido de pesquisa ao servidor OnDemand.O servidor retorna ao usuário a lista de documentos que correspondem à consulta.Quando o usuário seleciona um documento para exibição, o programa clienterecupera uma cópia do documento, do servidor onde o documento foiarmazenado, abre uma janela de exibição e exibe o documento.

ConceitosOs termos aplicativo, grupo de aplicativos, pasta e gabinete representam como oOnDemand armazena, gerencia, recupera, visualiza e imprime relatórios e dados,juntamente com as informações de índice associadas. Ao definir um novo relatórioou tipo de dados para o OnDemand, um administrador deve criar um aplicativo eatribuir um aplicativo a um grupo de aplicativos (se não existir um grupo deaplicativos, o administrador deverá primeiramente criar um). Para que os usuáriospossam procurar e recuperar documentos, um administrador deve criar ouatualizar uma pasta para usar o grupo de aplicativos e o aplicativo. Para ajudar osusuários a localizarem as pastas rapidamente, os administradores podem criargabinetes.

3. O OnDemand fornece capacidade de executar a maioria das funções do cliente a partir de quase todos os sistemas operacionais,utilizando um navegador da Web. Consulte “Web Enablement Kit” na página 12 para obter informações sobre como acessar osdados armazenados nos servidores OnDemand com um navegador da Web.

4 Guia de Planejamento e Instalação

|||

Page 23: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

AplicativoUm aplicativo descreve as características físicas de um relatório para o OnDemand.Normalmente, define-se um aplicativo para cada programa que produza saídas queserão armazenadas no OnDemand. O aplicativo inclui informações sobre o formatodos dados, a orientação dos dados na página, o tamanho do papel, o comprimentodo registro e a páginas de códigos dos dados. Inclui também os parâmetros que oprograma de indexação utiliza para localizar e extrair dados do índice, assim comoas instruções de processamento que o OnDemand utiliza para carregar dados doíndice no banco de dados e os documentos nos volumes de armazenamento.

Grupo de AplicativosUm grupo de aplicativos contém os atributos de gerenciamento do armazenamentoe os campos de índice dos dados que são carregados no OnDemand. Ao secarregar um relatório no OnDemand, é preciso identificar o grupo de aplicativosno qual o OnDemand carregará os dados do índice e armazenará os documentos.Um grupo de aplicativos é uma coleção de um ou mais aplicativos OnDemandcom atributos comuns de indexação e de gerenciamento de armazenamento.Normalmente, diferentes relatórios são reunidos em um grupo de aplicativos paraque os usuários possam acessar suas informações com uma simples pesquisa.Todos os aplicativos do grupo devem ser indexados nos mesmos campos, porexemplo, o nome do cliente, o número da conta e a data.

PastaUma pasta é a maneira que o usuário possui para pesquisar e recuperar os dadosarmazenados no OnDemand. Uma pasta fornece aos usuários uma maneiraconveniente de procurar informações relacionadas, que estão armazenadas noOnDemand, sem considerar a origem dessas informações ou como os dados forampreparados. Uma pasta permite que um administrador configure uma tela deconsulta comum para vários grupos de aplicativos que podem usar diferentesesquemas de indexação, para que um usuário possa recuperar os dados com umaúnica consulta. Por exemplo, uma pasta chamada Informações do Aluno deveconter transcrições, contas e grades curriculares, que representam as informaçõesarmazenadas em diferentes grupos de aplicativos, definidas em diferentesaplicativos e criadas por diferentes programas.

A Figura 1 ilustra os conceitos descritos nesta seção.

A Figura 2 na página 6 mostra um exemplo.

PastaUma pasta é o objeto com o qual os usuáriosconsultam e recuperam relatórios. Uma pasta podeconsultar mais de um grupo de aplicativos,desde que os grupos de aplicativos tenham osmesmos campos do banco de dados.

O grupo de aplicativos é o local em que vocêdefine os requisitos de banco de dados, de armazenamentoem cache e de armazenamento em archive para relatórios. Umgrupo de aplicativos pode conter mais de umaplicativo, desde que os aplicativos possuamos mesmos atributos de gerenciamento debanco de dados e de armazenamento.

Cada aplicativo representa um único relatório.Você deve designar um aplicativo para umgrupo de aplicativos.

Grupo(s)de Aplicativos

Aplicativo(s)

Figura 1. Pastas, grupos de aplicativos e aplicativos (parte 1 de 2)

Capítulo 1. Sobre o OnDemand 5

|

|||

Page 24: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

GabineteSe os usuários tiverem muitas pastas, eles poderão agrupá-las em gabinetes, quepermitem que os usuários naveguem para as pastas mais facilmente.

Os gabinetes seguem estas regras:v Um gabinete pode conter uma ou mais pastas.v Uma pasta pode pertencer a zero ou mais gabinetes.

A Figura 3 na página 7 demonstra como os gabinetes podem organizar as pastasque um usuário precisa para gerar diferentes tipos de relatórios. Neste exemplo, ousuário precisa reunir informações sobre desempenho de fundos, saldo dos fundose transações de fundos para um relatório mensal. O gabinete "Relatório Mensal"contém pastas para cada tipo de informação que o usuário precisa coletar. Ousuário também precisa gerar relatórios de desempenho de investimentos para osclientes. Os relatórios de desempenho de investimentos incluem informações sobredesempenho de ações, desempenho de título e desempenho de fundos. O gabinete"Relatório do Cliente" contém pastas para ações, títulos e fundos. Ambos osgabinetes contêm a pasta para desempenho de fundos porque o usuário precisa deinformações sobre o desempenho de fundos para gerar ambos os relatórios.

PastaNome: Informações sobre AlunoCampos da Pasta: Nome do Aluno,Número do Aluno, Dados, Tipo de Documento

Nome: BILLSCampos do Banco de Dados: nome, número, bDateDuração dos Dados: Dois anosArmazenamento de Documentos: cache, archiveNome: GRADESCampos do Banco de Dados: nome, número, gDateDuração dos Dados: Dois anosArmazenamento de Documentos: cache, archiveNome: TRANSCampos do Banco de Dados: nome, número, tDateDuração dos Dados: Dois anosArmazenamento de Documentos: cache, archive

Nome: BILLSTipo de Dados: AFPIndexador: ACIFCampos de Índice: Nome, número, dDateNome: GRADESTipo de Dados: AFPIndexador: ACIFCampos de Índice: Nome, número, gDateNome: TRANSTipo de Dados: AFPIndexador: ACIFCampos de Índice: Nome, número, tDate

Grupo(s)de Aplicativos

Aplicativo(s)

Figura 2. Pastas, grupos de aplicativos e aplicativos (parte 2 de 2)

6 Guia de Planejamento e Instalação

|

|||

|

||

|

|

|

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

Page 25: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Métodos de IndexaçãoO OnDemand fornece duas maneiras para a indexação de dados:v A indexação de documentos é utilizada para os relatórios que contenham itens

lógicos, como as políticas, e instruções. Cada item de um relatório pode serindexado individualmente em valores como o número da conta, o nome docliente e o saldo. O OnDemand suporta até 32 valores de índice por item. Com aindexação de documentos, o usuário não precisa necessariamente conhecer osrelatórios ou os seus ciclos para recuperar um documento do OnDemand.

v A indexação de relatórios é utilizada para relatórios que contêm muitas páginascom o mesmo tipo de dados, como, por exemplo, um registro de transações.Cada linha do relatório geralmente identifica uma transação específica, e nãoseria econômico indexar cada linha. O OnDemand armazena o relatório comogrupos de páginas e indexa cada grupo. Quando os relatórios incluem um valorde transação ordenado (por exemplo, o número da fatura), o OnDemand podeindexar os dados no valor da transação. Isso é feito com a extração dos valoresiniciais e finais da transação para cada grupo de páginas e com oarmazenamento dos valores no banco de dados. Esse tipo de indexação permiteque os usuários recuperem diretamente um valor de transação específico.

DocumentosOs documentos do OnDemand representam grupos de páginas indexados.Normalmente um documento do OnDemand é uma seção lógica de um relatóriomaior, como os demonstrativos de um cliente individual em um relatório commilhares de demonstrativos. Um documento do OnDemand também poderepresentar uma parte de um relatório maior. Para os relatórios que não contêmgrupos lógicos de páginas, como os registros de transação, o OnDemand podedividi-los em grupos de páginas. Os grupos de páginas são indexados

Saldode Fundos

Pastas

Gabinetes

Opcional: É possível organizar pastasem gabinetes para permitir que os usuários naveguempara as pastas mais facilmente. Cada gabinete éuma coleta de pastas.

Uma pasta pode pertencer a maisde um gabinete.

Transaçõesde Fundos

Desempenhode Fundos

Desempenhode Títulos

Desempenhode Ações

RelatórioMensal

Relatóriodo Cliente

Figura 3. Usando gabinetes para organizar pastas

Capítulo 1. Sobre o OnDemand 7

|

|||

Page 26: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

individualmente e podem ser recuperados na estação de trabalho cliente de formamais eficaz que um relatório inteiro. Os documentos sempre são identificados pordata e, normalmente, por uma ou mais outras maneiras, como o nome do cliente, onúmero do cliente ou o número da transação.

A Figura 4 ilustra os aplicativos e documentos OnDemand. Um administradorpode definir o aplicativo BILLS para um relatório que contenha itens lógicos, comoos demonstrativos do cliente. O aplicativo BILLS utiliza o método de indexação dedocumentos para dividir o relatório em documentos. Cada demonstrativo dorelatório torna-se um documento no OnDemand. Os usuários podem recuperar umdemonstrativo especificando a data e uma combinação de nome e número. Umadministrador pode definir o aplicativo TRANS para um relatório que contenhalinhas de dados da transação ordenados. O aplicativo TRANS utiliza o método deindexação de relatório para dividir o relatório em documentos. Cada grupo de 100páginas do relatório torna-se um documento no OnDemand. Cada grupo éindexado utilizando-se o primeiro e o último dos valores da transação ordenadosque ocorrem no grupo. Os usuários podem recuperar o grupo de páginas quecontenha um número específico de transação, especificando a data e o número datransação. O OnDemand recupera o grupo que contém o valor informado pelousuário.

ServidorO servidor OnDemand mantém um banco de dados central a respeito dosrelatórios armazenados no OnDemand. O banco de dados também contéminformações sobre os objetos definidos para o sistema, como os usuários, grupos,impressoras, grupos de aplicativos, aplicativos, pastas, políticas de migração econjuntos de armazenamento. O servidor processa o início de sessão do cliente, asconsultas e os pedidos de impressão, além de atualizar o banco de dados. Oservidor também mantém os documentos armazenados em disco e, opcionalmente,trabalha com o gerenciador de armazenamento em arquivo para manter osdocumentos em mídia de arquivamento, como a mídia ótica e a fita. O servidorcarrega dados, recupera documentos e expira documentos.

O ambiente do servidor OnDemand possui vários componentes:v Um gerenciador de pedidos, que fornece serviços de cliente, de rede e de sistema

operacional, segurança e contabilização.v Um gerenciador de banco de dados, que mantém os dados de índice dos relatórios

armazenados no sistema.v As informações de controle do banco de dados sobre os usuários, grupos, grupos

de aplicativos, aplicativos, pastas, conjuntos de armazenamento e impressoras,

Demonstrativosdo Cliente063097

Relatóriode Transações063097

Instrução

Página 1-100

Número enome daData de Faturamentodo Aplicativo BILLS

Número daData da transaçãodo AplicativoTRANS

Figura 4. Aplicativos e documentos

8 Guia de Planejamento e Instalação

|

|||

Page 27: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

que estão definidas no sistema. As informações de controle determinam a pessoaque pode acessar o sistema, as pastas que um usuário pode abrir e os dados dosgrupos de aplicativos que um usuário pode pesquisar e recuperar.

v Um gerenciador de armazenamento em disco, que mantém os documentos em disco.O armazenamento em disco destina-se ao acesso em alta velocidade dosdocumentos utilizados com mais freqüência.

v Um gerenciador de armazenamento em arquivo para o armazenamento de longoprazo de uma ou mais cópias de documentos em mídia de arquivamento, comoa mídia ótica e a fita.

v Programas de Indexação de dados. Esses programas criam dados de índice ecoletam os recursos necessários (se houver). O OnDemand fornece váriosprogramas de indexação. O OS/400 Indexer pode ser utilizado para indexarvários tipos de dados e é o indexador OnDemand mais comum para os arquivosem spool. O OnDemand PDF Indexer pode ser usado para criar o dado doíndice para os arquivos Adobe® Acrobat PDF. O OnDemand Generic Indexerpode ser usado para processar o dado do índice para quase qualquer outro tipode dado que você desejar armazenar no sistema, como documentos HTML,documentos Lotus WordPro, arquivos TIFF etc.

v Programas de Carregamento de dados, que podem ser configurados paraarmazenar automaticamente dados do relatório em grupos de aplicativos eatualizar o banco de dados.

v Relatórios e recursos arquivados.v Um recurso de impressão do servidor que permite aos usuários a reimpressão de

um grande volume de documentos em alta velocidade. O OnDemand exigirá oPSF para IBM i Versão 7 Release 1 (uma opção de produto do IBM i), se vocêplanejar usar a função de impressão do servidor OnDemand para documentosAFP ou se planejar usar o fax do servidor para quaisquer documentos noOnDemand.

v Programas de gerenciamento do OnDemand para manter o banco de dados e osdocumentos do OnDemand em disco.

v Um recurso de registro de sistema, que fornece aos administradores ferramentaspara supervisionar as atividades do servidor e responder a eventos específicos àmedida que ocorrem. A interface com o recurso de registro de sistema é feitaatravés da pasta System Log e da saída do usuário System Log no OnDemand.

Os seguintes tópicos contêm informações adicionais:v O gerenciador de pedidos OnDemandv O gerenciador de banco de dados OnDemandv O gerenciador de armazenamento OnDemandv Indexação e carregamento de dadosv Programas de gerenciamento OnDemand

Gerenciador de PedidosO gerenciador de pedidos processa os pedidos de pesquisa dos programas clientesOnDemand. Quando um usuário informa uma pesquisa, o programa cliente enviaum pedido ao gerenciador de pedidos através da rede. O gerenciador de pedidostrabalha com o gerenciador de banco de dados para compilar uma lista de itenscorrespondentes à pesquisa e retorna a lista ao programa cliente. Quando o usuárioseleciona um item para exibição, o gerenciador de pedidos envia um pedido derecuperação ao gerenciador de armazenamento em disco, se o documento estiverem disco, ou ao gerenciador de armazenamento em arquivo, se o documentoestiver no armazenamento em arquivo. O gerenciador de armazenamento recupera

Capítulo 1. Sobre o OnDemand 9

Page 28: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

o documento e, opcionalmente, os recursos associados ao item. O programa clienteOnDemand descompacta e exibe o documento.

Os programas de gerenciamento OnDemand abrangem utilitários que mantêm obanco de dados e o armazenamento em disco, inclusive a capacidade de migrardados automaticamente do banco de dados e do armazenamento em disco para oarmazenamento em arquivo. Esses programas utilizam os serviços do gerenciadorde pedidos para gerenciar dados de índice, documentos e arquivos de recursos.

Quando um usuário se registra no sistema, o OnDemand atribui um número detransação exclusivo à instância do programa cliente. Todas as atividades associadasà instância do programa cliente contêm o mesmo número de transação. Ogerenciador de pedidos registra as mensagens geradas por vários programasOnDemand no System Log, por exemplo, registro, consulta, impressão, entreoutros. As mensagens contêm o número da transação, o ID do usuário, a marca dehora e outras informações. Os administradores podem abrir a pasta System Log eexibir as mensagens. O OnDemand ainda fornece uma saída de usuário SystemLog para que seja possível executar um programa definido pelo usuário eprocessar mensagens. Por exemplo, é possível projetar um programa definido pelousuário para enviar um alerta ao administrador quando determinadas mensagensaparecerem no System Log. As mensagens do System Log também podem serutilizadas para gerar relatórios de uso e de faturamento.

Gerenciador de Banco de DadosO OnDemand usa um gerenciador do banco de dados chamado DB2 UniversalDatabase (DB2; fornecido com o IBM i), para manter o dado do índice para osrelatórios que forem carregados no sistema. O gerenciador de banco de dadostambém mantém tabelas do sistema OnDemand, que descrevem aplicativos,grupos de aplicativos, conjuntos de armazenamento, pastas, grupos, usuários eimpressoras definidos para o sistema.

Gerenciador de ArmazenamentoO gerenciador de armazenamento em disco do OnDemand mantém uma cópia dedocumentos no disco, normalmente de forma temporária. O gerenciador dearmazenamento em disco migra documentos do disco para a mídia dearquivamento e remove os documentos cujo período de vigência de dados expirou.

O OnDemand também suporta um gerenciador de armazenamento em arquivo. Ogerenciador de armazenamento em arquivo mantém uma ou mais cópias dedocumentos na mídia de arquivamento, como a mídia ótica ou a fita. Você decidequais tipos de mídia de arquivos o sistema OnDemand deve suportar, configura osdispositivos de armazenamento no sistema e define os dispositivos dearmazenamento para o gerenciador de armazenamento em arquivo. Paraarmazenar os dados do grupo de aplicativos é preciso atribuir esse grupo a umconjunto de armazenamento, que é gerenciado pelo gerenciador de armazenamentoem arquivo.

Indexação e Carregamento de DadosOs relatórios armazenados no OnDemand devem ser indexados. O OnDemandsuporta vários tipos de dados de índice e programas de indexação. Por exemplo,você pode utilizar o OS/400 Indexer para extrair dados de índice dos relatóriosarmazenados no sistema. Um administrador define os campos de índice e outrosparâmetros de processamento que o OS/400 Indexer utiliza para localizar e extrairinformação de índice dos relatórios. Os programas de carregamento de dados do

10 Guia de Planejamento e Instalação

Page 29: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

OnDemand lêem os dados de índice gerados pelo OS/400 Indexer e carrega-os nobanco de dados do OnDemand. Os programas de carregamento de dados obtêmoutros parâmetros de processamento do banco de dados do OnDemand, tais comoos parâmetros utilizados para segmentar, compactar e armazenar os dados dorelatório em disco e em mídia de arquivamento. Os parâmetros de indexaçãopodem ser definidos com o cliente administrativo do OnDemand. O clienteadministrativo inclui um assistente de relatório que lhe permite criar parâmetros deindexação marcando, visualmente, amostras dos dados do relatório. O OnDemandtambém fornece programas de indexação que podem ser usados para gerar o dadodo índice para arquivos Adobe PDF e outros tipos de dados de origem, comoarquivos TIFF. Consulte o IBM Content Manager OnDemand for i: Common ServerIndexing Reference para obter detalhes sobre os programas de indexação fornecidoscom o OnDemand.

A Figura 5 mostra uma visão geral do processo de indexação e carregamento dedados.

O programa de carregamento de dados do OnDemand determina primeiramente seo relatório precisa ser indexado. Se o relatório precisar ser indexado, o programade carregamento de dados chamará o programa de indexação apropriado. Oprograma de indexação utiliza os parâmetros de indexação do aplicativoOnDemand para processar os dados do relatório. Esse programa pode extrair egerar dados de índice, dividir o relatório em grupos indexados e coletar osrecursos necessários à exibição e reimpressão do relatório. Após a indexação dorelatório, o programa de carregamento de dados processa os dados de índice, osgrupos indexados e os recursos, utilizando outros parâmetros do aplicativo e dogrupo de aplicativos. O programa de carregamento de dados trabalha com ogerenciador de banco de dados para atualizar o banco de dados do OnDemandcom os dados de índice que foram extraídos do relatório. Dependendo dosatributos de gerenciamento de armazenamento do grupo de aplicativos, oprograma de carregamento de dados pode trabalhar com o gerenciador dearmazenamento em disco para segmentar, compactar e copiar dados do relatóriopara o disco e o gerenciador de armazenamento de archive para copiar dados dorelatório para o armazenamento de archive.

Programas de GerenciamentoO OnDemand fornece um gerenciador de armazenamento em disco para manter eotimizar o banco de dados e manter documentos em disco. Geralmente, um

Indexação e Carregamentode DadosDados

doRelatório

Dadosde Índice

Banco deDados

Armazenamentodo Documento

Grupo de Aplicativos

Aplicativo

GruposIndexados

Figura 5. Preparação, indexação e carregamento de dados

Capítulo 1. Sobre o OnDemand 11

||

Page 30: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

administrador determina os parâmetros de processamento para esses programas,inclusive a freqüência com que eles devem ser executados. Quando alguém naorganização cria um grupo de aplicativos, especifica outros parâmetros que osprogramas utilizam para manter os dados do relatório armazenados no grupo. Porexemplo, ao criar um grupo de aplicativos, o administrador especifica o períodoem que os documentos devem ser mantidos no sistema e se os dados de índicedevem ser migrados do banco de dados para a mídia de arquivamento. Ogerenciador de armazenamento em disco usa as informações para migrardocumentos do disco para a mídia de archive, excluir documentos do disco, migraro dado do índice do banco de dados para a mídia de archive e excluir o dado doíndice do banco de dados. Essas funções são úteis porque o OnDemand podeocupar o espaço em disco que foi liberado pelos dados expirados e migrados. Vocêdeve configurar o sistema OnDemand para iniciar automaticamente os programasde gerenciamento em um planejamento regular; normalmente uma vez por noiteou semana.

O gerenciador de armazenamento de archive exclui dados da mídia de archivequando eles atingem sua data de expiração de armazenamento, se a política demigração contiver um nível de Expiração. Um administrador define as informaçõesde gerenciamento para o gerenciador de armazenamento em arquivo suportar osdados do OnDemand que gerencia. As informações de gerenciamento incluem osvolumes de armazenamento que podem conter dados do OnDemand, o número decópias de um relatório que se deve manter e o período em que os dados serãomantidos no sistema de gerenciamento de arquivos.

O OnDemand mantém os documentos no disco e na mídia de arquivamentoindependentemente um do outro, até que os documentos expirem. A expiração emum gerenciador de armazenamento expira dados do outro gerenciador dearmazenamento. Cada um utiliza seus próprios critérios para determinar quandoos dados expiram e devem ser removidos do sistema; cada um utiliza os seuspróprios comandos para remover documentos. Você precisa decidir como os dadosserão expirados de seu sistema e aplicar esses padrões consistentemente ao criarseus grupos de aplicativos e políticas de migração. Consulte Capítulo 3,“Gerenciamento de Armazenamento em Archive”, na página 21 para obter maisdetalhes.

Web Enablement KitO ODWEK (OnDemand Web Enablement Kit) é um recurso opcional que permiteque as pessoas de uma organização utilizem um navegador da Web para acessardados que são armazenados em um sistema OnDemand. Por exemplo, você podefornecer a algumas pessoas o URL (Uniform Resource Locator) de uma página daWeb que lhes permita conectar a um servidor OnDemand e escolher uma pastapara abrir; e pode fornecer a outras pessoas o URL de uma página da Web quelhes permita procurar uma pasta específica. O ODWEK verifica se o usuário tempermissão para utilizar o servidor OnDemand, utilizar a pasta e exibir dadosarmazenados no grupo de aplicativos. Após o usuário submeter uma pesquisa, oODWEK exibe uma página Web que contenha uma lista dos documentoscorrespondentes à pesquisa. O usuário seleciona um documento para ser exibido eo ODWEK o envia ao navegador.

O ODWEK contém vários componentes:v O programa servidor Web. O programa do servidor utiliza interfaces e

protocolos OnDemand padrão para acessar dados armazenados em um servidor

12 Guia de Planejamento e Instalação

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

||||||||

||||||||||

Page 31: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

OnDemand. Nenhum código adicional é necessário no servidor OnDemand parasuportar o ODWEK. Um dos programas servidor Web a seguir pode serutilizado para controlar o ODWEK:– Programa CGI. O programa CGI é executado em um sistema IBM i que esteja

executando o IBM HTTP Server.– Java servlet. O servlet é executado em um servidor HTTP ativado

paraJavacom um servidor de aplicativos Java, tal como o IBM WebSphereApplication Server.

v O visualizador da Web AFP. O visualizador da Web AFP permite que osusuários pesquisem, recuperem, exibam, naveguem e imprimam documentosAFP de um navegador da web. Cada pessoa em sua organização que planejarusar o AFP Web Viewer para visualizar documentos AFP deverá instalá-lo emsua estação de trabalho.

v O Image Web Viewer. O Image Web Viewer permite que os usuários procurem,recuperem, visualizem, naveguem e imprimam documentos BMP, GIF, JPEG,PCX, PNG e TIFF a partir de um navegador da Web. Cada pessoa em suaorganização que planejar usar o Image Web Viewer para visualizar documentospode precisar instalá-lo em sua estação de trabalho. Isso é necessário quandovocê deseja visualizar a imagem na janela do navegador, em vez de permitir umaplicativo de estação de trabalho padrão seja ativado para visualização.

v O applet Java Line Data. O applet Line Data permite que os usuários exibam osdocumentos de dados em linha a partir de um navegador da Web.

v O applet Java AFP2HTML. O applet AFP2HTML permite que os usuáriosvisualizem a saída gerada pelo IBM AFP2WEB Transform. O AFP2WEBTransform converte os documentos e recursos do AFP em arquivos HTML quepodem ser exibidos com o applet AFP2HTML. Para utilizar o appletAFP2HTML, obtenha o AFP2WEB Transform da IBM e o instale e configure noservidor Web. Consulte o representante IBM para obter informações adicionaissobre o AFP2WEB Transform.

Para exibir outros tipos de documentos armazenados no OnDemand, obtenha einstale o visualizador apropriado. Para requisitos de software, consultehttp://www.ibm.com/support/docview.wss?rs=152&uid=swg27016180

Nota: ODWEK é um kit de ativação e pode precisar de programação adicionalpara fornecer o ambiente da Web desejado. Consulte o IBM Content ManagerOnDemand for i: Common Server Web Enablement Kit Installation Guide paraobter informações adicionais.

Capítulo 1. Sobre o OnDemand 13

|||||||

|||

Page 32: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

14 Guia de Planejamento e Instalação

Page 33: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 2. Preparando para o OnDemand

Esta seção contém uma estrutura de tópicos que pode ser útil ao preparar aorganização para o ambiente do OnDemand e executar um lançamento piloto dosistema.v Trabalhe com um único departamento ou grupo de usuários finais. Envie um

memorando aos usuários, explicando como o OnDemand afetará o trabalhodiário.

v Desenvolva um curso de treinamento para usuários finais ou feche um contratocom a IBM para fornecer treinamento do OnDemand.

v Estabeleça um plano de suporte aos usuários. O plano deve incluir os nomes eos números de telefone das pessoas que devem ser contatadas para assistência euma lista das dicas para a detecção de problemas.

v Escolha um relatório ou um conjunto de relatórios para uma migração inicialpara o OnDemand. Obtenha uma cópia impressa dos relatórios.

v Revise-os e determine o tipo de indexação necessária. Em seguida, selecione oscampos do relatório para os campos de índice, pesquisa e exibição.

v Revise as seleções com os usuários. Verifique se os campos de índice, pesquisa eexibição permitem que os usuários recuperem os dados necessários.

v Determine as necessidades de exibição dos usuários.v Obtenha, instale e teste quaisquer transformações de dados que possam ser

necessárias. Por exemplo, se precisar converter dados AFP em dados HTML, épossível usar o AFP2WEB Transform, disponível na IBM.

v Identifique o tipo de dados contidos no relatório e determine como os dados deíndice serão criados.

v Se você planeja arquivar dados AFP para indexar o relatório, identifique osrecursos utilizados por este. Os recursos são objetos reutilizáveis encontrados napágina de um relatório, como as sobreposições e os segmentos de página. Assobreposições contêm os dados que foram combinados com os dados variáveisdo relatório durante a impressão e a exibição. Os segmentos de página sãográficos e imagens que aparecem nas páginas de um arquivo de relatórios, taiscomo o logotipo de uma empresa.

v Configure o armazenamento em arquivo (dispositivos de armazenamento ótico eem fita) no servidor. Defina as políticas para os dispositivos de mídia dearquivamento e para o gerenciamento de armazenamento do OnDemand paraque suportem os relatórios a serem armazenados no sistema.

v Utilize o cliente administrativo OnDemand para criar grupos de aplicativos eaplicativos necessários ao suporte dos relatórios.

v Utilize o cliente administrativo para definir as pastas que os usuários abrempara acessar os dados armazenados no sistema.

v Utilize o cliente administrativo para definir os usuários e os grupos para oOnDemand.

v Efetue a indexação dos relatórios.v Carregue o dados dos relatórios, dos recursos e do índice no grupo de

aplicativos.v Inicie o teste do usuário final. Supervisione os usuários a respeito dos testes

iniciais e dos campos de índice, de pesquisa e de exibição.

© Copyright IBM Corp. 2001, 2010 15

Page 34: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Atualize a lista de equipamentos essenciais da empresa para incluir hardware esoftware exigidos pelo sistema OnDemand. Atualize os manuais de operações ede recuperação da empresa com as informações solicitadas para operar, suportare fazer backup do sistema OnDemand.

Funções e Responsabilidades AdministrativasOs administradores do OnDemand assumem a responsabilidade pelo OnDemand ecuidam dele. O sistema OnDemand inclui tudo, como hardware, software deaplicativo e de sistema, relatórios e usuários.v O hardware inclui o servidor IBM i, dispositivos de backup, dispositivos de

mídia de archive, PCs clientes, terminais, impressoras e o equipamento de rede.v O software inclui o sistema operacional de base, o software de pré-requisito, os

programas cliente e servidor e os arquivos de configuração.v Os administradores definem os aplicativos OnDemand e decidem como o

OnDemand gerenciará os dados nos servidores.v Os administradores definem os grupos e os usuários do OnDemand para o

sistema e certificam-se de que o software cliente esteja instalado e funcionandocorretamente.

Ao mesmo tempo em que os administradores do OnDemand são responsáveis poreste ambiente coletivo do ponto de vista dos usuários do OnDemand, eles não sãoos únicos na organização a trabalhar com todos esses componentes.

Dependendo do tamanho de sua organização, pode haver uma ou várias pessoasadministrando o sistema. Se a sua organização for grande, as tarefasadministrativas poderão ser divididas entre várias pessoas. Por exemplo, umadministrador do sistema OnDemand pode manter conjuntos de armazenamentodo OnDemand, impressoras do sistema, grupos e usuários; um administrador deaplicativos OnDemand pode manter grupos de aplicativos, aplicativos e pastas; umadministrador do sistema operacional pode atribuir as atualizações do sistemaoperacional de base e determinar problemas; e um administrador de serviços podemanter registros do sistema e hardware e software da rede, assim como efetuaralterações nos equipamentos.

O que segue é uma lista típica de itens das tarefas necessárias para administrar emanter um sistema OnDemand. Algumas destas tarefas podem ser deresponsabilidade de uma pessoa que não seja um administrador do OnDemand.v Instalação e upgrade de equipamentosv Instalação e manutenção de programas OnDemand e outros softwarev Definição e identificação dos volumes de armazenamentov Monitorização do espaço utilizado pelo banco de dados e do espaço disponível

no sistemav Monitorização do espaço utilizado pelo armazenamento em disco e do espaço

disponível no sistemav Monitorização do espaço utilizado pelo armazenamento em arquivo e do espaço

disponível no sistemav Planejamento de jobs de manutenção dos bancos de dados, armazenamento em

disco e armazenamento em arquivov Trabalho com os usuários para determinar as necessidades de indexação e de

recuperação de relatóriosv Definição das políticas de migração e dos conjuntos de armazenamento

16 Guia de Planejamento e Instalação

Page 35: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Definição das impressoras do sistema OnDemandv Definição dos relatórios para o sistemav Definição de grupos e usuários do OnDemandv Carregamento de relatórios no sistema ou o planejamento dos jobs que os

carregamv Gerenciamento do processo de backup e de recuperação para o banco de dados

e outras áreas que contenham dados críticos para a operação do sistemav Monitorização das atividades do servidor e ajuste dos parâmetros do sistemav Solução dos problemas de servidor, rede e aplicativosv Resposta às perguntas do usuário finalv Estabelecimento de políticas de segurança e de auditoria; por exemplo, definir e

manter senhas e permissões; recursos de auditoria do usuário do OnDemandpara monitorar os grupos de aplicativos e as atividades do usuário; desenvolver,documentar e manter procedimentos de controle das alterações para preveniralterações não autorizadas do sistema

O OnDemand fornece um cliente administrativo para permitir que osadministradores mantenham os objetos OnDemand por meio de uma interfacegráfica com o usuário fácil de ser utilizada. O cliente administrativo é umaplicativo Windows de 32 bits. O cliente administrativo permite que osadministradores definam e mantenham aplicativos, grupos de aplicativos, pastas,gabinetes, conjuntos de armazenamento, impressoras do sistema, grupos eusuários. Inclui recursos que permitem aos administradores processar amostra dedados do relatório e criar parâmetros de indexação e exibições lógicas, marcandovisualmente uma amostra de relatório.

O OnDemand fornece um conjunto de comandos administrativos que ajudam osadministradores a manter o sistema. Por exemplo, o OnDemand fornece comandospara o carregamento e o descarregamento de relatórios, a manutenção do banco dedados, o armazenamento em disco e em arquivo e a pesquisa e recuperação dedocumentos. Muitos dos comandos administrativos podem ser configurados paraserem executados automaticamente, de modo regular.

Interfaces de Programação de AplicativoO OnDemand fornece vários tipos de interfaces de programação de aplicativos,que podem ser utilizadas para personalizar clientes OnDemand e trabalhar comobjetos no servidor.

Personalização do ClienteO OnDemand fornece informações sobre o controle do OLE (Object Linking andEmbedding) e sobre como personalizar o cliente Windows, especificando osparâmetros das linhas de comandos, invocando e manipulando o OnDemand apartir de outros aplicativos Windows de 32 bits com a interface DDE (IntercâmbioDinâmico de Dados) ou criando um arquivo PIF (Arquivo de Informações doProduto).

O IBM Content Manager OnDemand: Windows Client Customization Guide forneceinformação sobre personalização de clientes Windows.

4. O Monarch é um programa de software que pode ser adquirido da Datawatch Corporation.

Capítulo 2. Preparando para o OnDemand 17

Page 36: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Por exemplo, é possível integrar o Monarch4 Versão 5 com o cliente Windows paraque os usuários possam carregar documentos OnDemand no Monarch. O usuáriopode então manipular dados complexos no Monarch, como a criação de colunasderivadas e a geração de quadros e relatórios. Consulte o IBM Content ManagerOnDemand Windows: Client Customization Guide para obter informações adicionais.

APIs do ServidorO OnDemand fornece programas que podem ser utilizados para trabalhar comobjetos no sistema. Por exemplo:v O ARSDOC é um programa de processamento de documentos de múltiplas–

finalidades. O programa ARSDOC pode ser utilizado para: consultar o servidore gerar uma lista de itens correspondentes à consulta; recuperar documentos dosistema; incluir, excluir e atualizar documentos; e enviar documentos aoequipamento de impressão do servidor. O programa ARSDOC pode serexecutado a partir da linha de comandos ou ser invocado– de um programadefinido pelo usuário.

O IBM Content Manager OnDemand for i: Common Server Administration Guidefornece detalhes sobre estes e outros programas da API do servidor.

Registro do Servidor

Recurso de Registro do SistemaO OnDemand fornece o recurso de registro do sistema para ajudar umadministrador a supervisionar as atividades e a monitorar o sistema. O OnDemandpode registrar as mensagens que foram geradas por vários programas cliente eservidor. Por exemplo, o sistema pode ser configurado para registrar umamensagem no registro do sistema sempre que um usuário iniciar sessão. Podetambém ser configurado para registrar uma mensagem no registro do sistemasempre que ocorrer uma tentativa frustrada de início de sessão, e assim por diante.Quando o cliente administrativo é utilizado para incluir objetos no sistema eatualizar o banco de dados, o OnDemand registra as informações sobre as ações noregistro do sistema. É possível utilizar um dos programas cliente OnDemand parapesquisar e exibir mensagens do registro do sistema por marca de hora, gravidade,número de mensagens, ID do usuário e outros critérios de pesquisa.

Saída do Usuário no Registro do SistemaO OnDemand fornece uma saída de usuário que pode ser utilizada para processaras mensagens que estão gravadas no registro do sistema OnDemand. Um usocomum da saída do usuário no registro do sistema é aguardar as condições de erroou determinadas mensagens e tomar as devidas providências, como a notificação aum administrador ou operador e a execução de algum outro programa.

A saída do usuário no registro do sistema executa o programa ARSLOG depois degravar um registro no registro do sistema. Entretanto, o programa ARSLOG,fornecido com o OnDemand, não executa nenhuma função. Você deve substituiraquele fornecido pela IBM por seu próprio programa, que executa as funções deque precisa. Por exemplo, pode-se criar um programa para verificar o número damensagem e a gravidade de cada mensagem gravada no registro do sistema e,quando apropriado, enviar um alerta ao console do sistema.

O OnDemand envia parâmetros à saída do usuário no registro do sistema, como onome da instância do OnDemand, uma marca de hora, um identificador deregistro de log, o ID do usuário associado à ação, informações sobre a conta do IDdo usuário, a gravidade de uma mensagem, um número de mensagem e o texto da

18 Guia de Planejamento e Instalação

Page 37: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

mensagem. As informações que aparecem na parte de informações da conta damensagem podem ser especificadas para cada usuário definido para o sistema, pormeio de um cliente administrativo. Pode-se personalizar o texto das mensagensselecionando os campos (e os valores) do grupo de aplicativos a serem incluídos namensagem. Em seguida, é possível configurar o OnDemand para fornecerinformações específicas à saída do usuário no registro do sistema, definindo osparâmetros do sistema e do grupo de aplicativos com o cliente administrativo.

Consulte o Apêndice C, “Log do Sistema e Saída do Usuário de Log do Sistema”,na página 119 para obter informações adicionais sobre a saída do usuário noregistro do sistema.

Capítulo 2. Preparando para o OnDemand 19

Page 38: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

20 Guia de Planejamento e Instalação

Page 39: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 3. Gerenciamento de Armazenamento em Archive

IntroduçãoUm sistema OnDemand pode ser configurado para manter cópias de relatórios noarmazenamento em disco e em arquivo. As cópias no armazenamento em arquivodestinam-se ao armazenamento de longo prazo. O OnDemand suporta umavariedade de dispositivos de armazenamento ótico e em fita. O Gerenciamento deArmazenamento de Archive inclui os seguintes componentes:v Um programa servidor que mantém um banco de dados de informações sobre

os dispositivos e os dados que gerencia. O programa servidor também controla amídia de armazenamento e os dispositivos definidos para o OnDemand.

v Os comandos do servidor que controlam as atividades do programa servidor,como a migração e a expiração de dados.

v Um programa cliente IBM i Navigator que você pode usar para definir aspolíticas de gerenciamento de armazenamento. As políticas do gerenciamento dearmazenamento determinam onde os dados serão armazenados e o período emque deverão ser mantidos no OnDemand.

Objetos de Armazenamento no OnDemandOs critérios do gerenciamento de armazenamento especificados determinam onde equando o OnDemand armazena os relatórios e como os atualiza.

Um administrador cria um aplicativo OnDemand para cada relatório a serarmazenado no sistema. Os aplicativos com requisitos de indexação semelhantespodem ser colocados em uma coleta chamada de grupo de aplicativos.

Ao se carregar um relatório no OnDemand, é preciso atribuí-lo a um grupo deaplicativos. O grupo de aplicativos identifica um conjunto de armazenamento queaponta para uma política de migração associada. A política de migração identificaa localização (ou localizações) na qual os dados são armazenados. O OnDemandarmazena automaticamente uma cópia do relatório em disco, a menos que seespecifique o contrário. Se a política de migração também identificar aslocalizações do armazenamento em arquivo, então o OnDemand armazenaráautomaticamente uma cópia do relatório no armazenamento em arquivo.

Um ou mais grupos de aplicativos podem especificar o mesmo conjunto dearmazenamentos. Todos os dados associados a um determinado conjunto dearmazenamento (e a política de migração correspondente) são mantidos com o usodo mesmo tipo de mídia, de dispositivos, de duração de tempo de manutenção dosdados no sistema, e assim por diante.

Para obter informações adicionais sobre migração de documentos e recomendaçõespara os critérios de gerenciamento de armazenamento definidos em seus grupos deaplicativos, conjuntos de armazenamento e políticas de migração, consulte o IBMContent Manager OnDemand for i: Common Server Administration Guide.

© Copyright IBM Corp. 2001, 2010 21

||||

Page 40: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Como Definir a Configuração do ArmazenamentoAntes do início do carregamento do relatório no sistema, é preciso determinar oespaço de armazenamento necessário para receber os dados dos relatórios.Também é preciso determinar o período em que o sistema deverá manter umaversão do relatório, a quantidade de cópias do relatório a ser mantida pelo sistema,o tipo de mídia a ser utilizado para armazenar um relatório e qualquer outrorequisito comercial, legal ou operacional para o armazenamento e a manutenção dedados.

Após obter os requisitos de armazenamento, configure os dispositivos dearmazenamento e defina-os para o OnDemand. Por exemplo, você define umabiblioteca ótica para o servidor IBM i. Em seguida, o administrador do OnDemanddeve definir as políticas do gerenciamento de armazenamento, utilizando asinformações coletadas sobre os relatórios que se planeja manter no sistema. Porexemplo, as informações da política incluem o período de tempo em que oOnDemand deverá manter os dados gerenciados.

Ao carregar um relatório no sistema, é preciso identificar um grupo de aplicativos.Esse grupo identifica um conjunto de armazenamento. As informações do conjuntodeterminam a quantidade de cópias de um relatório, assim como o local em queserão mantidas.

22 Guia de Planejamento e Instalação

Page 41: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parte 2. Requisitos do Sistema

Esta seção do manual contém informações sobre os requisitos de hardware,software, redes e de impressão para servidores e clientes do OnDemand.

© Copyright IBM Corp. 2001, 2010 23

Page 42: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

24 Guia de Planejamento e Instalação

Page 43: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 4. Hardware e Software

A configuração exata de hardware e software necessária para que o OnDemandsuporte a organização depende do volume de dados que se pretende manter nosistema, do número de usuários simultâneos que o sistema deve suportar, dasnecessidades de backup e de recuperação da sua organização e dos níveis dedesempenho que o sistema deve atingir.

Para todos os requisitos de hardware e software, consulte http://www.ibm.com/support/docview.wss?rs=152&uid=swg27016180

Importante:: Se você estiver fazendo upgrade de um release anterior doOnDemand, é necessário que esteja executando o servidorOnDemand versão 7.1.2.8, ou superior, antes de fazer upgrade para oContent Manager OnDemand para i Versão 7 Release 1. É possíveldeterminar a versão de seu servidor atual usando um dos seguintesmétodos:v Se você estiver executando a versão 7.1.2.5, ou superior, do cliente

OnDemand, efetue logon no OnDemand Administrator ou nocliente de usuário final do OnDemand. Depois que o logon forefetuado, a versão do servidor será mostrada na linha demensagem na parte inferior direita do painel.

v Em qualquer versão do OnDemand, efetue logon no servidor IBMi. Inicie o qshell usando o comando QSH. Após o qshell seriniciado, insira ARSDATE (sem parâmetros adicionais) na linha decomando Qshell. A versão do servidor é exibida juntamente comoutras informações sobre a API ARSDATE.

© Copyright IBM Corp. 2001, 2010 25

||

||||||

|||||

|||||

Page 44: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

26 Guia de Planejamento e Instalação

Page 45: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parte 3. Informações do Suporte de Planejamento

Esta seção é uma fonte de planejamento para administradores do OnDemand.Outras pessoas em uma organização interessadas nesta seção poderiam incluirequipe de suporte técnico e de serviço, administradores de banco de dados,administradores de rede, administradores de aplicativo e qualquer outra pessoaque tenha a responsabilidade de tomar decisões sobre sistemas de negócios, taiscomo as pessoas responsáveis pelo planejamento do site físico, operações e backupe recuperação.

Esta seção descreve as atividades que a IBM recomenda que os administradores doOnDemand executem para planejar a instalação do OnDemand e preparar aoperação do OnDemand.

© Copyright IBM Corp. 2001, 2010 27

Page 46: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

28 Guia de Planejamento e Instalação

Page 47: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 5. Relatórios e Outros Dados

Esta seção contém informações que podem ajudar no planejamento de relatóriosque serão armazenados no OnDemand. Essas informações podem ser utilizadaspara determinar a configuração de hardware necessária para suportar o sistemaOnDemand. É fornecida uma lista de perguntas que podem ser feitas aos usuáriosdos relatórios, assim como informações sobre os tipos de dados que podem serarmazenados no OnDemand e sobre os relatórios de indexação.

Como Reunir os RequisitosO planejamento para o OnDemand requer a compreensão de como o sistema seráimplementado, quem o usará, como será utilizado e outras necessidades dousuário final. As respostas para essas perguntas fornecem informações quepermitem a configuração correta do sistema OnDemand, inclusive a configuraçãodo armazenamento e da rede para que possa suportar os aplicativos e os usuários:v Que tipos de fluxos de dados de impressão o sistema suportará? Há necessidade

de transformações para converter os dados de entrada em outros formatos deexibição (como AFP para HTML)?

v Qual é a organização lógica dos fluxos de dados de impressão?– Organização de página: um fluxo consistente de páginas de dados contábeis

ou de transação classificados.– Organização de documento: grupos lógicos de informações, como instruções ou

políticas.– Dados que podem não ter um formato consistente, como materiais de

referência ou literatura do produto.v O OnDemand irá suportar um gerenciamento de relatórios de curto prazo, um

armazenamento em arquivo de longo prazo ou ambos?v Qual é o volume de entradas a ser processado? Qual é o tamanho dos relatórios

(em páginas e bytes); quantos relatórios; quantas versões de relatórios?v Quais valores de índices os usuários de um relatório precisam para recuperar a

versão específica de um relatório (ou de um documento)?v Qual a disponibilidade de tempo para carregar relatórios no OnDemand? Diária?

Semanal?v Por quanto tempo pretende-se manter os dados do relatório no sistema?v Qual é a previsão média de usuários executando sessões simultaneamente? E nas

horas de pico?v Qual é a previsão de usuários ativos?v Qual é a taxa de transação dos usuários ativos?

Formatos dos Dados de EntradaO OnDemand suporta vários tipos de dados de entrada:v Fluxos de dados de impressão AFP, incluindo dados de linha combinados com

os campos estruturados AFP e dados de linha formatados com uma definição depágina.

v Fluxo de Caracteres da System Network Architecture (SNA). Dados de entradagerados a partir de um arquivo de impressora IBM i com um tipo de dispositivo*SCS.

© Copyright IBM Corp. 2001, 2010 29

Page 48: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v O mesmo que SCS, exceto que os dados incluem atributos de impressãoestendidos que podem ser ignorados em um fluxo de dados SCS. Os atributosde impressão estendidos incluem linhas variáveis por polegada e caracteresvariáveis por polegada.

v Dados de linha com caracteres ANSI ou caracteres de controle do carro damáquina.

v Arquivos de estação de trabalho, como documentos de texto, planilhas eapresentações, por exemplo.

v PDF (Arquivos Adobe Portable Data Format).v Arquivos de imagem nos seguintes formatos:

– BMP (Bitmap). Um arquivo que contém um gráfico mapeado em bits.– GIF (Graphic Interchange Format). Um formato de arquivo gráfico de cores

mapeadas por bits para computadores compatíveis com a IBM. O GIF utilizauma técnica de compactação eficiente para gráficos com alta resolução.

– JFIF (JPEG Format Image File). Um arquivo que contém dados de imagemcompactados, que utiliza o padrão JPEG (Joint Photographic Experts Group).

– PCX (Picture Exchange Format). Um arquivo que contém um gráfico noformato PCX, amplamente utilizado por aplicativos para PC, como oprograma PC Paintbrush. Permite a compactação com o PackBytes.

– PNG (Portable Network Graphics). Um formato de compactação sem perdaque pode tratar múltiplas cores e figuras grandes. Oferece economiassignificativas de tamanhos de arquivos sobre GIF, mas não tanto quanto sobreJPEG.

– TIFF (Tagged Image File Format). Um formato de imagem de gráficosmapeados por bits para imagens varridas com resoluções de até 300 DPI. OTIFF simula um sombreamento com escala em cinza. O OnDemand suportaarquivos simples e multipáginas TIFF, que são descompactados oucompactados com a compactação do JPEG, CCITT Grupo 3, CCITT Grupo 3 /2D e CCITT Grupo 4.

Além dos tipos de dados listados acima, o OnDemand permite o armazenamentode quase todos os tipos de dados no sistema. Por exemplo, é possível definir umaplicativo para os documentos HTML. Quando o aplicativo é definido, o tipo dearquivo de dados deve ser identificado. O tipo de arquivo determina o programaque o cliente inicia quando o usuário recupera um documento. Por exemplo, se otipo de cliente for HTM, o cliente poderá iniciar o Internet Explorer para visualizaro documento.

O AFP suporta objetos gráficos, de texto de apresentação, de imagens e de códigode barras. O armazenamento de dados AFP no sistema permite uma exibição comtotal fidelidade dos objetos de texto de apresentação e de imagem.5 Por exemplo,os usuários podem recuperar e exibir as instruções do cliente que o OnDemandapresenta, utilizando um formulário eletrônico, fontes e imagens. O usuário exibeuma cópia do demonstrativo, que aparece da mesma forma que o demonstrativoque o cliente recebeu no correio. O AFP também suporta navegação em umarquivo de relatório, utilizando-se um índice.

Ao armazenar relatórios que contêm dados AFP, é necessário também armazenaros recursos em OnDemand. Os recursos incluem sobreposições, segmentos de

5. A exibição dos objetos do código de barras não é suportada no momento. Entretanto, é possível exibir os códigos de barras queforam apresentados com o uso das fontes.

30 Guia de Planejamento e Instalação

||||

Page 49: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

página e definições de formulário. Eles também devem estar no processador ondeos dados precisam ser indexados e carregados.

Dados de IndexaçãoUma das principais operações que pode ser feita com o OnDemand são osrelatórios de índices. Quando um relatório é indexado, o OnDemand extrai osvalores de índice que estão no relatório e os armazena no banco de dados. Oscampos do banco de dados definidos para os grupos de aplicativos recebem osvalores de índice. Quando um usuário abre uma pasta, o OnDemand exibe umalista dos campos de pesquisa que representam os campos do banco de dados. Paraexecutar uma consulta, o usuário digita valores nos campos de pesquisa. OOnDemand compara os valores da pesquisa com os dos campos do banco dedados e recupera os itens correspondentes à consulta.

Quando um relatório é indexado, é possível dividir um relatório grande emunidades de informação menores e identificadas exclusivamente. Por exemplo,quando um programa de aplicativo gera contas de clientes, ele pode produzir umgrande fluxo de impressão constituído de milhares de contas de clientesindividuais. Com o OnDemand, é possível identificar contas de clientes individuaisdo relatório como unidades de informação ou itens lógicos menores e separados(conhecidos como documentos no OnDemand). Os usuários podem pesquisar erecuperar os itens lógicos utilizando identificadores como o número de conta, onome do cliente e a data.

Os relatórios processados com o OnDemand normalmente se encaixam em umadas duas categorias:v Documento. Para os relatórios constituídos por itens lógicos, como

demonstrativos, contas, políticas e faturas.v Página. Para os relatórios que contêm valores classificados, que aumentam ou

diminuem do início ao final do relatório, como um log de transações ou livrocontábil.

Geralmente, relatórios que não contêm itens lógicos ou dados de linha classificadospodem ser indexados com o método de indexação de documento.

Indexação de DocumentoA indexação de documento pode ser utilizada para os relatórios de índice que sãoconstituídos por itens lógicos ou para indexar os relatórios com valores exclusivos,como um número de conta ou um nome de cliente. Quando esses tipos derelatórios são pesquisados e recuperados, o OnDemand retorna uma lista dos itenscorrespondentes à consulta do usuário e transfere os itens individuais para oprograma cliente OnDemand a fim de serem exibidos e impressos. O OnDemandsuporta até 32 campos como índices ou filtros para os dados do tipo documento.Os campos não devem ser ordenados e podem conter informações numéricas oude texto. Os campos são armazenados no banco de dados como índices ou filtros.A Figura 6 na página 32 mostra um exemplo de um arquivo de relatórios e deindexação de documento.

Capítulo 5. Relatórios e Outros Dados 31

Page 50: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Indexação de PáginaA indexação de página permite que os usuários procurem dados do relatórioclassificados e recuperem a primeira ocorrência do valor que eles especificaram naconsulta. O OnDemand divide os dados do relatório em grupos de páginas earmazena os primeiros e os últimos valores do índice de cada grupo de páginas nobanco de dados. Quando um usuário digita uma consulta, o OnDemand retornauma lista dos itens correspondentes. Quando o usuário seleciona um item paraexibição, o OnDemand executa uma pesquisa de texto no item para o valorespecificado pelo usuário. O programa cliente OnDemand exibe a primeira páginaque contém o valor especificado pelo usuário. O OnDemand utiliza um valor deíndice ordenado, simples e exclusivo para a recuperação dos dados do relatório,por exemplo, um número de fatura ou um identificador de transação. A Figura 7na página 33 mostra um exemplo de um arquivo de relatório e indexação depágina.

Página1 de 4

11/2411/2612/01

Arctic AirlinesJules ClothiersBud's Car Rental

Emitsburg, COHampton, MAPortland, MA

022901234900543221153349043

388,75726,42

87,29

Desconecte e retorne para a parte superior com seu pagamento.

Data do Demonstrativo

01/08/2003

Número da Conta

3727-1644-0981

Limite de Crédito

12000

Crédito Disponível

9783

Pagamento Devido até:

15/8/2003

Quantia Devida:

$ 279.64

Quantia Delimitada:

$

Faça cheques pagáveis a:

Baxter Bay Bank: Dept: 1010 P.O Box 100, Boulder, CO 99999(303) 555-1212

John Smyth123 Ubik Way NorthMeadow Bridge, WV 99999-0000

More Bank for the BuckBaxter Bay Bank

FDIC

Camposde Índice

Figura 6. Método de indexação de documento

32 Guia de Planejamento e Instalação

|

|||

Page 51: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Como Indexar Dados com Programas do OnDemandO OnDemand fornece vários métodos para indexar os dados de impressão. Osseguintes tópicos fornecem informações adicionais:v Utilize a ferramenta gráfica do OnDemand para localizar visualmente e marcar

os valores do índice na página de impressãov Gere os dados do índice no programa aplicativo que gera o relatóriov Use o programa OnDemand PDF Indexer para indexar arquivos Adobe PDFv Crie dados de índice para o programa OnDemand Generic Indexer

Como Utilizar a Ferramenta GráficaUtilize a ferramenta de indexação gráfica do OnDemand para localizar visualmentee marcar os valores de índice dos dados de impressão que serão arquivados. Essaferramenta faz parte do cliente OnDemand Administrator e pode ser usadadurante a definição de um aplicativo.

Como Gerar Dados de Índice em Programas AplicativosÉ possível criar informações de índice para dados AFP usando o programa deaplicativo que gera o relatório. As informações de índice estão contidas em TagLogical Elements (TLEs) no fluxo de dados. Esses TLEs podem ser marcados comovalores de índice usando a ferramenta de indexação gráficas exatamente comoquaisquer outros dados na página de impressão. Alguns programas de aplicativo jáfornecem TLEs no fluxo de dados. Se não, talvez seja necessário modificar osprogramas de aplicativo para incluir TLEs se você optar por usá-los.

1Relatório de Fatura do Cliente Data 31/05/2003 Página 1

2Relatório de Fatura do Cliente Data 31/05/2003 Página 2

Cliente

BarnshornSmyth

BurbakanLittle

Cliente

PratteNoble

SimpsonDean

Data

16/3/200316/3/2003

16/3/200316/3/2003

Data

16/3/200316/3/2003

16/3/200316/3/2003

Preço

22,5030,10

12,1482,81

Preço

12,50320,11

2,1472,31

Número da Conta

05355880655388

86730666061655

Número da Conta

10635581065538

67533826166568

Númeroda FaturaClassificada

Número da Fatura

0045305100453051

0045305900453060

Número da Fatura

0045315100453152

0045315900453160

Figura 7. Método de indexação de página

Capítulo 5. Relatórios e Outros Dados 33

|

|||

Page 52: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Como Indexar Arquivos de Entrada PDFO OnDemand PDF Indexer é um utilitário que pode ser usado para extrair dadodo índice ou gerar dado do índice sobre arquivos Adobe PDF. Os dados de índicepodem aprimorar a capacidade de armazenamento, recuperação e exibição dedocumentos PDF com o OnDemand. O PDF Indexer processa os arquivos deentrada PDF. Um arquivo PDF é uma versão destilada de um arquivo PostScript®,incluindo estrutura e eficiência. Um arquivo PDF pode ser criado pelo AcrobatDistiller ou por um programa especial de driver de impressora chamadoPDFWriter. O PDF Indexer suporta os arquivos de entrada e saída do PDF Versão1.3. O IBM Content Manager OnDemand for i: Common Server Indexing Referencefornece detalhes sobre o programa PDF Indexer e mostra exemplos sobre comousá-lo para processar arquivos de entrada PDF.

Gerando Dado do Índice no Formato Generic IndexerO OnDemand fornece o Generic Indexer para que você possa criar dado do índicepara arquivos que não podem ser indexados usando outros métodos, como oOS/400 Indexer. Por exemplo, é possível criar um arquivo de índice no formatoGeneric Indexer que descreva um conjunto de arquivos de entrada que contêmdados no formato de imagem TIFF. O arquivo de índices contém os campos evalores de índice de cada arquivo a ser processado. O arquivo de índice tambémdescreve onde o processo de carregamento de dados do OnDemand pode localizardocumentos em um arquivo. O OnDemand cria uma linha no banco de dados paracada registro de índice contido no arquivo de índices. Os usuários podempesquisar o banco de dados utilizando uma combinação dos campos do índice queforam definidos no arquivo de índices. O IBM Content Manager OnDemand for i:Common Server Indexing Reference descreve o formato de arquivo de índice genérico.

Como Indexar Relatórios Utilizando Campos de DatasPara armazenar dados no sistema, cada relatório deve ser indexado com umcampo de data. Ao consultar o banco de dados, o OnDemand utiliza a data de umrelatório para diferenciar os dados de um relatório e de outro. O desempenho darecuperação também pode ser melhor ao utilizar um campo de data que tambémtenha sido definido como um campo de segmento. Além disso, o OnDemandtambém utiliza a data do relatório para determinar o momento de removerrelatórios do disco e o período em que os dados do relatório (dados de índice edocumentos) devem ser mantidos no sistema.

Utilize as datas que aparecem no relatório, como a data de execução, a data detransação ou a data do demonstrativo. Se os dados a serem armazenados noOnDemand não possuírem uma data, utilize a data na qual o relatório foicarregado no sistema.

O OnDemand suporta valores de data no intervalo de 1º de janeiro de 1970 a 17 desetembro de 2059. O OnDemand também suporta um campo de data/hora quepode conter valores de data de 1º de janeiro de 1970 a 18 de janeiro de 2038.

34 Guia de Planejamento e Instalação

|||

Page 53: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 6. Objetos do OnDemand

Este capítulo contém informações que podem ajudar no planejamento dos gruposde aplicativos, aplicativos e pastas para os relatórios.

Visão GeralNa instalação e configuração do software OnDemand, crie e inicialize um conjuntode tabelas do banco de dados que formem a estrutura interna do sistema. Quandoum relatório é definido para o sistema, o OnDemand inclui uma estrutura detabela de grupo de aplicativos e outras informações de controle para o banco dedados.

O OnDemand utiliza um conjunto de objetos para descrever as tabelas do banco dedados, os campos e os dados que formam o sistema. Ao se definir um objeto parao OnDemand, como um grupo de aplicativos, o OnDemand armazena no banco dedados as opções feitas e as informações digitadas a respeito do grupo deaplicativos. Toda vez que um relatório é carregado num grupo de aplicativos, oOnDemand atualiza o banco de dados com as informações de controle, inserelinhas de dados de índice em uma tabela do grupo de aplicativos e armazena osdados do relatório e os arquivos de recursos nos volumes de armazenamento.

Os usuários do sistema OnDemand abrem uma pasta para consultar e pesquisar osrelatórios que estão armazenados no sistema. Uma pasta é o objeto principal doOnDemand com os quais os usuários se relacionam. Uma pasta fornece aosusuários meios para pesquisar e recuperar dados armazenados no OnDemand. Osusuários abrem uma pasta para elaborar consultas e recuperar relatórios que estãoarmazenados nos grupos de aplicativos referidos pela pasta. Uma pasta podemencionar um ou mais grupos de aplicativos.

Um grupo de aplicativos representa os dados de índice e de relatório que foramcarregados no OnDemand. O banco de dados do OnDemand contém tabelas dedados dos grupos de aplicativos. Os registros na tabela dos grupos de aplicativoscontêm os valores de índice que foram extraídos dos relatórios e ponteiros para osdados do relatório (documentos). Um grupo de aplicativos pode conter um oumais aplicativos com as mesmas características de armazenamento e campos deíndice.

Um aplicativo OnDemand inclui uma descrição das características físicas de umrelatório, como o tipo de dados contidos no relatório e o formato do registro doarquivo de entrada, as instruções para os programas de indexação e decarregamento que processam o relatório, e as informações que o OnDemand utilizapara exibir e imprimir páginas do relatório. Normalmente, define-se um aplicativopara cada tipo de relatório a ser armazenado no OnDemand. É possível agrupar osaplicativos com as mesmas características de armazenamento e campos de índiceem um grupo de aplicativos.

Atribua um nome exclusivo a cada objeto definido para o OnDemand, como osgrupos de aplicativos, aplicativos e pastas.

O OnDemand utiliza as propriedades para descrever a aparência, ocomportamento e a estrutura interna dos objetos que formam um sistemaOnDemand. Por exemplo, Exibir Formato é uma propriedade de um campo de

© Copyright IBM Corp. 2001, 2010 35

Page 54: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

pasta que determina como os programas cliente OnDemand exibem os valores docampo na lista de documentos. As propriedades são agrupadas em categorias. Porexemplo, a categoria Geral, nas pastas, contém propriedades que descrevem asinformações gerais sobre uma pasta, como o nome e a descrição da pasta e osgrupos de aplicativos contidos nela.

PastasUma pasta fornece aos usuários os meios para pesquisar e recuperar os relatóriosrelacionados que estão armazenados no sistema. Os usuários abrem pastas, criamconsultas e recuperam relatórios dos grupos de aplicativos (entretanto, não hánecessidade de conhecerem ou compreenderem os grupos de aplicativos). Ao criaruma pasta, defina a pesquisa e exiba os campos que aparecem no momento emque os usuários abrem a pasta. Mapeie os campos da pasta nos campos do bancode dados, nos grupos de aplicativos referidos pela pasta. Os campos do banco dedados contêm valores de índice que foram extraídos dos relatórios para os gruposde aplicativos. Por exemplo, o campo de pesquisa da pasta Número da Conta doCliente pode ser mapeado no campo acct# do banco de dados do grupo deaplicativos. O OnDemand cria registros do banco de dados que incluem os valoresde índice para o campo acct# quando um relatório é carregado no grupo deaplicativos. Quando o usuário digita uma consulta, o OnDemand recupera osregistros do banco de dados, caso os valores do campo do banco de dados acct#correspondam ao valor que o usuário digitou no campo de pesquisa Número daConta do Cliente.

Ao definir uma pasta para o OnDemand, inclua um ou mais grupos de aplicativosna pasta, selecione os campos de índice nos grupos de aplicativos para queapareçam como pesquisa e exibam os campos quando o usuário abrir a pasta, eespecifique as propriedades dos campos de pesquisa e de exibição. Por exemplo,pode-se determinar o layout dos campos de pesquisa na tela e especificar osvalores que aparecerão automaticamente nos campos de pesquisa quando ousuário abrir a pasta.

O OnDemand mantém as informações sobre o nome da pasta e sua estrutura nobanco de dados do OnDemand. Por exemplo, o banco de dados contéminformações que descrevem os campos de pesquisa e de exibição definidos e oscampos do banco de dados selecionados nos grupos de aplicativos referidos pelapasta.

Defina uma pasta para o OnDemand por meio das propriedades e valoresagrupados em categorias. Uma categoria é um conjunto de propriedadesrelacionadas. O OnDemand fornece categorias de pasta para informações gerais,permissões, definições de campos, informações de campos e mapeamento doscampos. A categoria Geral é onde se especificam as propriedades gerais sobre apasta, como o nome da pasta e os seus grupos de aplicativos. A categoria depermissões é onde se determinam os grupos e usuários que podem abrir a pasta.Atribua outros tipos de autoridade para a pasta na categoria de permissões, comoa especificação de uma pessoa para administrar a pasta. A categoria de definiçõesdo campo é onde se definem os campos de pesquisa e de exibição para a pasta. Acategoria de informações do campo é onde se especificam os atributos dos camposde pesquisa e de exibição. Por exemplo, é possível especificar os operadores depesquisa disponíveis para cada campo e determinar a ordem em que os campos depesquisa aparecem na tela. A categoria de mapeamento do campo é onde semapeiam os campos de pesquisa e de exibição da pasta nos campos do banco dedados, nos grupos de aplicativos mencionados pela pasta.

36 Guia de Planejamento e Instalação

Page 55: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Grupos de AplicativosUm grupo de aplicativos é uma coleção de um ou mais aplicativos com os mesmoscampos de índice e as mesmas características de armazenamento. O grupo deaplicativos é o objeto que o OnDemand utiliza para manter os relatórios que foramcarregados no sistema. O grupo de aplicativos contém os dados de índice derelatórios, documentos, informações de gerenciamento, permissões para os grupose usuários com autoridade de acesso ao grupo de aplicativos, e assim por diante.

Ao definir um grupo de aplicativos, especifique o nome e o tipo de campos dobanco de dados que conterão os dados do índice extraídos dos relatórios e queserão carregados no grupo de aplicativos. Especifique se um campo do banco dedados será utilizado para indexar ou filtrar dados e outras características doscampos. Ao definir um grupo de aplicativos, o OnDemand cria uma estrutura detabelas para esse grupo no banco de dados, com uma coluna para cada campo dobanco de dados que for definido. Ao carregar um relatório no grupo de aplicativos,o OnDemand insere linhas em uma tabela para cada item indexado encontrado norelatório. Um item indexado pode ser um item lógico, como uma política ouinstrução, ou um grupo de páginas, dependendo de como o relatório estáorganizado e de como se decidiu indexar o relatório. Os usuários pesquisam osrelatórios utilizando um ou mais campos definidos para o grupo de aplicativos.

O OnDemand suporta até 32 campos de índice e de filtro para cada grupo deaplicativos:v Os campos de índice permitem acessar rapidamente um registro específico, por

meio de uma tecla, mas geralmente exigem a implementação de um grandeespaço de armazenamento em disco e precisam de mais tempo para carregardados no grupo de aplicativos. O OnDemand utiliza os campos de índice paralocalizar os registros no banco de dados que atendam aos critérios informadospelo usuário. O registro de índice contém a localização física de um item em umvolume de armazenamento.

v Os campos de filtro são utilizados para refinar consultas, recuperando apenasum subconjunto de registros encontrados com um campo de índice.Normalmente, os campos de filtro são utilizados com um campo de índice paraidentificar um item específico no grupo de aplicativos. Os campos de filtrotambém podem ser utilizados para exibir informações adicionais na lista dedocumentos, como um endereço.

O OnDemand requer um campo de segmento para cada grupo de aplicativosdefinido. O OnDemand utiliza o campo de segmento para organizar e manter osdados do grupo de aplicativos e localizar os itens correspondentes à consulta. Umcampo de segmento também permite que um usuário pesquise um arquivo deíndice específico para um aplicativo que utiliza a data (que é o campo desegmento). Sem um campo de segmento definido, todos os segmentos (arquivos deíndice) em um grupo de aplicativos são pesquisados. O campo de segmento deveser um dos seguintes campos de data ou campos de data/hora:v Data do relatório. A data em que o programa de aplicativos criou o arquivo de

relatórios. Essa normalmente é a data encontrada nas páginas do relatório.v Data do carregamento. A data em que o relatório foi carregado no grupo de

aplicativos. Utilize a data de carregamento se o relatório não possuir uma data.

Os requisitos de armazenamento e os campos do índice são as consideraçõesprincipais quando se define um grupo de aplicativos e se identificam os aplicativoscolocados nesse grupo. Um terceiro fator é a organização das informações contidas

Capítulo 6. Objetos do OnDemand 37

Page 56: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

no relatório. O OnDemand pode indexar, armazenar e recuperar dados contidosem um relatório com base na estrutura dos dados que contém.v Alguns relatórios são constituídos por grupos lógicos de informações, como as

instruções, as faturas e as políticas. Tais grupos, ou itens lógicos, podem conteruma ou mais páginas de informações. O OnDemand pode indexar, armazenar erecuperar os itens lógicos contidos em um relatório. Cada item lógico pode serindexado em até 32 valores, por exemplo, um número de conta, o nome docliente e o saldo. O OnDemand cria uma linha no banco de dados para cadaitem lógico localizado no relatório.

v Outros relatórios podem ser organizados de modo diferente e podem não conternecessariamente itens lógicos. Por exemplo, um relatório pode ter milhares depáginas de transação ou dados gerais do livro Razão. O OnDemand podeindexar, armazenar e recuperar informações desses tipos de relatórios, utilizandoos valores de índice, como data, número de página e um valor ordenado, comoo número da transação. O OnDemand divide os tipos de relatórios em gruposde páginas e faz um índice de cada um desses grupos. Embora esses tipos derelatórios possam conter itens lógicos, provavelmente não seria eficaz em termosde custo indexar todos os itens no relatório. Ou seja, é provável que a indexaçãode todos os itens nesses tipos de relatórios resulte na inclusão de milhares deregistros de índice no banco de dados, sempre que um relatório for carregado nogrupo de aplicativos.

Ao criar um grupo de aplicativos, especifique como o OnDemand deve armazenaros dados de índice nos relatórios que forem carregados para esse grupo. OOnDemand fornece dois métodos que podem ser utilizados para determinar comoos registros do índice serão carregados no banco de dados e como os usuáriospoderão consultar o grupo de aplicativos:v Cargas múltiplas por Tabela de banco de dados

Com esse método, sempre que um relatório for carregado no grupo deaplicativos, o OnDemand irá inserir os registros do índice em uma tabela jáexistente no banco de dados. Os registros do índice de cada relatório carregadono grupo de aplicativos são armazenados na mesma tabela do banco de dados.O OnDemand mantém os dados do grupo de aplicativos para que, na medidado conhecimento de um usuário que consulta esse grupo, eles pareçam residirem uma tabela do banco de dados. O OnDemand segmenta automaticamente osdados do grupo de aplicativos quando esse ultrapassa um determinadotamanho. O OnDemand mantém uma tabela de segmentos para cada grupo deaplicativos. A tabela de segmentos fornece melhor desempenho de consulta, aolimitar as pesquisas a uma tabela específica de dados do grupo de aplicativos eao utilizar um valor de dados para elaborar a consulta. Recomenda-se o usodesse método para a organização do banco de dados, quando os usuários quepesquisam dados armazenados no grupo de aplicativos não precisem conhecerou preocupar-se com uma instância específica do relatório que gerou asinformações de que necessitam. Esse é o método padrão e é utilizado na maioriados casos.

Ao criar um grupo de aplicativos, especifique as características de armazenamentodo relatório, como o prazo em que o OnDemand manterá os dados armazenadosnesse grupo e os valores de migração dos dados. As características dearmazenamento também determinam se o OnDemand armazenará uma cópia dorelatório em mídia de arquivamento, se o OnDemand deverá criar uma cópia debackup do relatório, e quando o OnDemand removerá os dados do relatório que jánão forem necessários.

38 Guia de Planejamento e Instalação

Page 57: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

O OnDemand pode executar três tipos de processamento nos dados do grupo deaplicativos:v Processo de expiração do banco de dados

Os dados do índice expiram (se passíveis de remoção do sistema) quandoatingem o período de Vigência de Dados e Índices (esse período é especificadona criação de um grupo de aplicativos). O OnDemand fornece um comando quepode ser utilizado para remover dados do índice. Normalmente, o comando édefinido para ser executado automaticamente, dentro de uma programaçãoregular. O processo de expiração do banco de dados recupera o espaço em discoocupado por dados de índice que foram excluídos.

v Processo de migração do discoA migração do disco é o processo de cópia de relatórios do armazenamento emdisco para o armazenamento em arquivo. Especifique quando um relatório deveser copiado do armazenamento em disco para o armazenamento em arquivoquando criar um grupo de aplicativos. O OnDemand fornece um comando quepode ser utilizado para copiar relatórios para o armazenamento em arquivo.Normalmente, o comando é definido para ser executado automaticamente,dentro de uma programação regular. A migração do disco otimiza o uso doarmazenamento em disco, ao mesmo tempo que fornece excelente desempenhopara as recuperações de relatórios em curto prazo. À medida que um relatórioenvelhece e a probabilidade de acesso torna-se menos freqüente, o OnDemandpode copiar automaticamente o relatório para um armazenamento de longoprazo (arquivamento). É possível ainda utilizar a migração do disco paraprorrogar o carregamento dos relatórios para o armazenamento em arquivo paraquando houver pouca ou nenhuma outra atividade no sistema.

v Processo de expiração no discoA expiração no disco é o processo de exclusão de relatórios que estãoarmazenados no disco. Especifique o período em que um relatório deverápermanecer no disco quando criar um grupo de aplicativos. O OnDemandfornece um comando que pode ser utilizado para excluir relatórios do disco.Normalmente, o comando é definido para ser executado automaticamente,dentro de uma programação regular. A expiração no disco recupera o espaço emdisco ocupado por relatórios expirados.

AplicativosUm aplicativo OnDemand descreve as características físicas de um relatório, asinstruções de processamento para os programas de indexação e de carregamentode dados e as informações sobre como o OnDemand exibe e imprime páginas deum relatório. Especifique as definições padrão para a exibição e impressão daspáginas de um relatório no nível do aplicativo OnDemand. Por exemplo, se umaimpressora padrão for selecionada para o aplicativo quando um usuário imprimirum documento que esteja associado a ele, o OnDemand enviará o documento paraa impressora especificada. Normalmente, define-se um aplicativo para cadarelatório diferente a ser carregado no sistema.

Ao criar um aplicativo, especifique as propriedades dos dados de entrada (como,por exemplo, se os dados contêm caracteres de controle do carro e o formato doregistro dos dados de entrada). O OnDemand utiliza as informações especificadaspara interpretar corretamente os dados a serem exibidos.

O aplicativo OnDemand é onde se especificam as informações para os programasde indexação e de carregamento de dados, como a técnica que o OnDemand utilizapara compactar o arquivo de relatórios, os parâmetros utilizados para indexar os

Capítulo 6. Objetos do OnDemand 39

Page 58: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

dados, e as informações que o OnDemand utiliza para processar os dados deíndice antes que os registros do índice sejam carregados no banco de dados. OOnDemand utiliza os parâmetros de indexação, as opções e os valores dos dadosespecificados para a localização dos dados de índice e sua extração do relatório.

Configure uma ou mais exibições lógicas de um relatório. Uma exibição lógicadetermina como o OnDemand exibe os relatórios de dados em linha e controlaoutras características de exibição. Por exemplo, é possível configurar uma exibiçãológica para que, quando o usuário selecionar um documento para exibição, oprograma cliente OnDemand trave automaticamente o cabeçalho do relatório nolocal quando o usuário rolar para cima ou para baixo em uma página.

Usuários e GruposCada usuário se registra no OnDemand com um ID do usuário. O OnDemandautentica os IDs do usuário e determina a autoridade de uso e administrativadisponível para o usuário, com base no ID do usuário para início de sessão. Um IDdo usuário OnDemand não precisa necessariamente identificar um usuárioindividual. No entanto, para fins contábeis e de segurança, convém atribuir um IDdo usuário OnDemand a cada pessoa que utiliza o sistema.

O OnDemand cria automaticamente o ID do usuário QONDADM quando osistema é inicializado. O ID do usuário QONDADM possui autoridade deadministrador do sistema. Um administrador do sistema pode executar as funçõesbásicas de usuário, como iniciar sessão no sistema e abrir pastas, e as funçõesadministrativas, como definir usuários e grupos e criar, atualizar e excluir gruposde aplicativos, aplicativos, pastas, conjuntos de armazenamento e impressoras.

Os grupos do OnDemand são meios para a organização de usuários por função,autorização ou qualquer outra finalidade. Ao definir um grupo no OnDemand,organize os usuários por departamento ou função e defina as permissões de pastae grupo de aplicativos que são comuns a todos os usuários atribuídos ao grupo. Aspermissões determinam os tipos de ações que os usuários atribuídos ao grupopodem executar. Não é preciso atribuir um usuário a um grupo, porém, fazendoisso a administração dos usuários com requisitos e recursos semelhantes ésimplificada. Nota: Os grupos do OnDemand não são iguais aos perfis de grupodo IBM i, mas é possível optar por usar os mesmos nomes se isso for mais fácil demanter.

Relacionamento de IDs do Usuário do OnDemand com Perfis doUsuário do IBM i

Quando o OnDemand é instalado, uma saída de usuário de segurança de logonpadrão é ativada, que força um relacionamento entre os IDs do usuário doOnDemand e os perfis do usuário do IBM i. Se você utilizar o OnDemandconforme foi instalado, é verdade dizer:v Um ID do usuário do OnDemand deve corresponder a um perfil do usuário do

IBM i.v Ao efetuar logon no OnDemand, a senha é a mesma que aquela usada ao

efetuar logon no IBM i. Se você alterar a senha usando o OnDemand, issoalterará na realidade a senha do IBM i. Quando você cria um ID do usuário doOnDemand, realmente deixa o campo de senha em branco.

v Defina o Prazo Máximo da Senha como A Senha Nunca Expira. Se vocêespecificar um valor para Prazo Máximo da Senha, o OnDemand poderá forçarum usuário a alterar sua senha antes que isso seja requerido pelo IBM i.

40 Guia de Planejamento e Instalação

Page 59: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Defina o Comprimento Mínimo da Senha como Permitir Senha em Branco. Issoevita que o OnDemand tente impor suas próprias regras no comprimento deuma senha e permite que o IBM i use suas próprias regras.

Se a saída de segurança não for ativada, o ID do usuário e senha do OnDemandnão terão relação com o ID do usuário e senha do IBM i e todas as configuraçõesde Parâmetros do Sistema do OnDemand serão respeitadas.

Nota: A ativação ou desativação dessa saída pode ser feita em um nível deinstância individual. Consulte Capítulo 12, “Criação de uma ocorrência”, napágina 71 para obter informações adicionais sobre as instâncias.

Permissões

Visão GeralComo medida de comodidade e de segurança, é possível atribuir um usuário a umgrupo. Ao se atribuir um usuário a um grupo, o usuário obtém as permissões dogrupo. Por exemplo, suponha que se crie um grupo e se autorize que esse abra apasta Informações do aluno. Qualquer usuário que seja atribuído ao grupoautomaticamente obterá permissão para abrir a pasta Informações do aluno.

Se um usuário for atribuído a mais de um grupo, normalmente obterá aspermissões de todos os grupos. Por exemplo, ao utilizar as definições do grupolistadas na Tabela 1, o usuário atribuído aos grupos poderá acessar as pastasContas do aluno e Transcrições do aluno.

Tabela 1. Permissões do grupo

Grupo Pastas

Conta Contas do aluno

Admissões Transcrições do aluno

Entretanto, há exceções à regra. Consulte informações sobre permissões no IBMContent Manager OnDemand for i: Common Server Administration Guide para obterdetalhes.

É possível definir permissões para pastas e grupos de aplicativos para cada usuárioe grupo definidos no OnDemand. Se as permissões forem definidas para um grupoespecífico, as permissões do grupo terão precedência sobre as definidas em nívelde pasta ou de grupo de aplicativos. Se as permissões forem definidas para umusuário específico, as permissões do usuário terão precedência, independentementedo grupo que o inclui ou das permissões definidas em nível de pasta ou de grupode aplicativos.

É possível definir permissões para pastas e grupos de aplicativos quando se incluiou atualiza uma pasta ou um grupo de aplicativos. Essas permissões tambémpodem ser definidas quando se inclui ou atualiza um usuário ou um grupo.

Permissões para a PastaAs permissões para pasta podem ser definidas no nível de pasta, grupo e usuário.A definição de permissões em nível de pasta concede as permissões que foramdefinidas a todos os usuários e grupos do OnDemand que ainda não as tenham. Adefinição de permissões em nível de grupo concede as permissões definidas atodos os usuários que foram atribuídos ao grupo. As permissões no nível de grupo

Capítulo 6. Objetos do OnDemand 41

Page 60: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

substituem as de nível de pasta. A definição de permissões em nível de usuárioconcede as permissões definidas a um usuário específico. As permissões em nívelde usuário substituem as de nível de grupo e de pasta.

Por padrão, apenas o usuário que criou a pasta, os usuários com permissão doadministrador para a pasta, os administradores de grupo/pasta e osadministradores do sistema podem acessar a pasta.

Você pode especificar os seguintes tipos de permissões para pasta:v Acesso. Os usuários podem abrir a pasta com os programas cliente OnDemand e

pesquisar e recuperar dados dos grupos de aplicativos mencionados na pasta.Para pesquisar e recuperar itens, os usuários devem ter acesso à permissão paraa pasta e acessar essa permissão para um ou mais grupos de aplicativosmencionados na pasta.

v Campos. Os usuários podem abrir a pasta com os programas cliente OnDemande modificar as informações do campo da pasta com a interface do administrador.O OnDemand mantém um conjunto de campos de pasta para cada usuário compermissão para os campos indicados para a pasta.

v Consultas nominais. Uma consulta nominal é um conjunto de critérios depesquisa, salvos por nome, que podem ser selecionados e restaurados noscampos de pesquisa da pasta. O OnDemand suporta dois tipos de consultasnominais: pública, ou seja, uma consulta nominal que está disponível a todos osusuários que podem abrir a pasta, e privada, que é uma consulta nominaldisponível apenas ao usuário que a criou. Os usuários podem receber autoridadepara exibir, criar, modificar e excluir consultas nominais.

v Administrador. Um administrador de pasta pode modificar e excluir a pasta. Elepode alterar as permissões de usuário e de grupo, incluir e remover usuários egrupos da pasta e alterar as informações dos campos da pasta.

Permissões para Grupo de AplicativosAs permissões para grupo de aplicativos podem ser definidas em nível de grupode aplicativos, grupo e usuário. A definição de permissões em nível de grupo deaplicativos concede as permissões definidas a todos os usuários e grupos doOnDemand que ainda não as tenham. A definição de permissões em nível degrupo concede as permissões definidas a todos os usuários que foram incluídos nogrupo. As permissões em nível de grupo substituem as de nível de grupo deaplicativos. A definição de permissões em nível de usuário concede as permissõesdefinidas a um usuário específico. As permissões em nível de usuário substituemas de nível de grupo e de grupo de aplicativos.

Por padrão, apenas o usuário que criou o grupo de aplicativos, os usuários compermissão do administrador para esse grupo, os administradores de grupo deaplicativos/pasta e os administradores do sistema podem acessar o grupo deaplicativos.

Você pode definir os seguintes tipos de permissões para grupos de aplicativos:v Acesso. Os usuários podem pesquisar e recuperar dados armazenados no grupo

de aplicativos, utilizando os programas cliente OnDemand.v Documento. Determina o tipo de funções do documento que os usuários podem

executar. As permissões padrão do documento são exibição, impressão, fax ecópia.

v Anotação. Determina os tipos de funções de anotação que os usuários podemexecutar. As permissões padrão de anotação são exibição e inclusão.

42 Guia de Planejamento e Instalação

Page 61: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Exibições lógicas. As exibições lógicas determinam como o OnDemand exibe aspáginas do arquivo de relatórios. Os usuários podem definir as própriasexibições lógicas com os programas cliente OnDemand.

v Administrador. Um administrador de grupo de aplicativos pode modificar eexcluir o grupo de aplicativos. Pode alterar as permissões do usuário e dogrupo, incluir e remover usuários e grupos do grupo de aplicativos, alterar asopções de log de mensagens, atualizar as definições do gerenciamento dearmazenamento para o grupo de aplicativos e alterar as informações dos camposdo grupo de aplicativos.

v Restrição à consulta. Limita o acesso aos dados do grupo de aplicativos.Normalmente, define-se uma restrição à consulta para limitar os dados que umusuário específico ou um grupo de usuários pode acessar.

Regras de NomenclaturaAo criar objetos no OnDemand, atribua nomes aos diversos objetos.

Nota: Se o OnDemand foi instalado com um idioma que exige múltiplos bytes porcaractere (por exemplo, Kanji), o número de caracteres permitido para umnome será menor que o número listado nas seções a seguir.

Ao se nomear um usuário, o nome especificado:v Pode conter de um a 128 caracteres (bytes), dependendo se os nomes de usuário

do OnDemand estiverem vinculados aos nomes de perfis do usuário do IBM i.Se você estiver usando o OnDemand conforme fornecido, os nomes de usuáriodo OnDemand serão vinculados aos nomes de perfil do usuário do IBM i. Essa éa configuração padrão e aplicável à maioria dos clientes. Entretanto, é possívelalterar isso, se você desejar, para que não exista nenhum relacionamento entre osnomes de usuário do OnDemand e os nomes de perfil do usuário do IBM i.Consulte “Relacionamento de IDs do Usuário do OnDemand com Perfis doUsuário do IBM i” na página 40 para obter mais detalhes.

v Não é possível incluir os caracteres ' (apóstrofo), * (asterisco), % (porcentagem) +(mais), [ (colchete esquerdo), ] (colchete direito), “ (aspas duplas) ou em branco

v Deve ser exclusivov Por padrão, o OnDemand converte as letras minúsculas de um nome do usuário

em maiúsculas (por exemplo, laguarde é armazenado como LAGUARDE)

Nota: Se você definir a própria saída do usuário para início de sessão, então serápreciso determinar as características dos IDs do usuário no sistema.

Ao se criar uma senha, o valor a ser especificado:v Pode conter de um a vinte caracteres (bytes).

Nota: Quando criar uma senha, o valor especificado poderá ter no máximo 20caracteres. Entretanto, a autenticação de senha que é montada noOnDemand verifica apenas os primeiros oito caracteres digitados pelousuário. Os caracteres adicionais são fornecidos aos clientes que optarampor implementar a segurança da própria senha utilizando a saída dousuário para início de sessão. Entre em contato com o Centro de SuportedaIBM para obter informações adicionais sobre a saída do usuário parainício de sessão.

v Por padrão, o OnDemand converte as letras minúsculas de uma senha emmaiúsculas (por exemplo, laguarde é armazenado como LAGUARDE)

Capítulo 6. Objetos do OnDemand 43

||

Page 62: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Nota: Se você definir uma saída do usuário para início de sessão, então serápreciso determinar as características das senhas no sistema.

Ao se nomear um grupo, o nome especificado:v Pode conter de um a 128 caracteres (bytes)v Não é possível incluir os caracteres ' (apóstrofo), * (asterisco), % (porcentagem) +

(mais), [ (colchete esquerdo), ] (colchete direito), “ (aspas duplas) ou em brancov Deve ser exclusivov Pode ter letras maiúsculas e minúsculas juntas; entretanto, o OnDemand não faz

distinção entre maiúsculas e minúsculas (por exemplo, LaGuarde é igual alaguarde)

Ao se nomear um grupo de aplicativos, aplicativo ou pasta, o nome especificado:v Pode conter de um a sessenta caracteres (bytes), inclusive espaços em branco

incorporados. Se você preferir utilizar a função de monitor da fila de saída doOnDemand para carregar automaticamente os relatórios, será preciso nomear osaplicativos e grupos de aplicativos, como os dez primeiros caracterescorrespondentes ao nome de arquivo em spool, os dados do usuário, o tipo deformulário ou um dos demais atributos do arquivo em spool. Consulte o IBMContent Manager OnDemand for i: Common Server Administration Guide para obterdetalhes adicionais sobre monitores de fila de saída.

v Não é possível incluir os caracteres ' (apóstrofo), % (porcentagem), [ (colcheteesquerdo), ] (colchete direito) ou “ (aspas duplas)

v Pode ter letras maiúsculas e minúsculas juntas; entretanto, o OnDemand não fazdistinção entre maiúsculas e minúsculas (por exemplo, LaGuarde é igual alaguarde)

v Um nome do aplicativo deve ser exclusivo do grupo de aplicativos ao qual oaplicativo é atribuído

v Um nome de grupo de aplicativos ou pasta deve ser exclusivo do servidor

Ao se nomear um campo da base de dados, o nome especificado:v Pode conter de um a dezoito caracteres (bytes)v Deve começar com letras de A até Zv Pode incluir as letras A até Z, os números de 0 até 9, @ (sinal de arroba), $

(cifrão), _ (sublinhado) e # (sinal de número)v Pode ter letras maiúsculas e minúsculas juntas; entretanto, o OnDemand não cria

um nome exclusivo (por exemplo, rDate é igual a rdate)v Deve ser exclusivo do grupo de aplicativosv Não pode ser nenhuma das palavras reservadas do OnDemand:

annot doc_offcomp_len doc_typecomp_off prt_nidcomp_type resourcedoc_len res_comp_typedoc_name sec_nid

v Não pode ser nenhuma das palavras reservadas pelo gerenciador do banco dedados (Para uma lista de palavras reservadas, consulte o Apêndice D do DB2 fori SQL Reference.)

Ao se nomear uma exibição lógica, o nome especificado:v Pode conter de um a trinta caracteres (bytes)v Pode ter letras maiúsculas e minúsculas juntas

44 Guia de Planejamento e Instalação

||

||

Page 63: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Uma exibição pública deve ser exclusiva do aplicativov Uma exibição privada deve ser exclusiva do usuário

Ao se nomear um campo da pasta, o nome especificado:v Pode conter de um a sessenta caracteres (bytes), inclusive espaços em branco

incorporadosv Pode ser composto por letras maiúsculas e minúsculas; entretanto, o OnDemand

não faz distinção entre maiúsculas e minúsculas (por exemplo, Data do Relatórioé igual a data do relatório)

v Deve ser exclusivo da pasta

Ao se nomear um conjunto de armazenamento ou política de migração, o nomeespecificado:v Pode conter de um a sessenta caracteres (bytes)v Pode ter letras maiúsculas e minúsculas juntas; entretanto, o OnDemand não faz

distinção entre maiúsculas e minúsculas (por exemplo, LaGuarde é igual alaguarde)

v Deve ser exclusivo

Ao se nomear a impressora do servidor, o nome especificado:v Pode conter de um a sessenta caracteres (bytes)v Pode ter letras maiúsculas e minúsculas juntas; entretanto, o OnDemand não faz

distinção entre maiúsculas e minúsculas (por exemplo, LaGuarde é igual alaguarde)

v Deve ser exclusivo do servidor

Ao se nomear uma fila da impressora do servidor, o nome especificado:v Deve ter um nome válido de fila de saída no servidor, digitado no formato

nomedabiblioteca/filadesaída

Tipos de Dados e Tipos de CamposAo se definir um grupo de aplicativos, o OnDemand cria uma estrutura para atabela do banco de dados, com os campos de índice e de filtro que foramdefinidos. Ao armazenar um relatório no grupo de aplicativos, o OnDemand extraios dados do índice que estão no relatório, coloca esses dados nos campos do bancode dados e insere linhas na tabela do grupo de aplicativos. Os campos do banco dedados definidos para o grupo de aplicativos podem conter diferentes tipos dedados. Ao definir os campos do banco de dados, selecione o tipo de dados paracada campo. O tipo de dados indica ao OnDemand o tipo de dados que pode serarmazenado no campo.

Ao se definir uma pasta para o OnDemand, os campos definidos podem serutilizados de duas maneiras:v Para os campos de pesquisa, nos quais os usuários informam os valores para

elaborar consultasv Para os campos de exibição, a fim de identificar os itens na lista de documentos

A Tabela 2 na página 46 lista os tipos de grupos de aplicativos e campos de pastasuportados pelo OnDemand.

Capítulo 6. Objetos do OnDemand 45

|

||

|||

|

Page 64: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 2. Tipos de grupos de aplicativos e de campos de pasta

Tipo de Campo Descrição

Inteiro Pequeno Contém números inteiros entre −32.768 e 32.767

Inteiro Contém números inteiros entre −2.147.483.648 e 2.147.483.647

Inteiro Grande Contém números inteiros entre −922337036854775808 e922337036854775807. Os campos de inteiro grande contêm umarepresentação de inteiro de 64 bits de um número ou de umacadeia de caracteres, na forma de uma constante de inteiro.

Decimal Contém números entre −10307 e 10308, com até 15 dígitossignificativos. É possível armazenar valores de moeda em umcampo decimal e utilizar o atributo de precisão para formatar ascasas decimais.

Cadeia (Fixa) Contém letras, números, símbolos especiais, tais como % e # equalquer outro caractere imprimível. Observe, entretanto, que ouso dos caracteres de sinal de percentual (%) e dois pontos (:) nodado do índice causa uma falha ou resultados imprevisíveis aorecuperar documentos usando a interface do OnDemand WebEnablement Kit (ODWEK). Um campo de cadeia de comprimentofixo requer um byte por caractere declarado; os caracteres nãousados consomem armazenamento.

Cadeia (Variável) Contém letras, números, símbolos especiais, tais como % e # equalquer outro caractere imprimível. Observe, entretanto, que ouso dos caracteres de sinal de percentual (%) e dois pontos (:) nodado do índice causa uma falha ou resultados imprevisíveis aorecuperar documentos usando a interface do OnDemand WebEnablement Kit (ODWEK). Um campo de cadeia de comprimentovariável requer um byte por caractere mais dois bytes para gastoadicional; os caracteres não usados não consomem armazenamento.

Data Contém uma data válida de 1º de janeiro de 1970 a 17 de setembrode 2059. Para indexar relatórios que contêm datas que ocorremantes de 1 de janeiro de 1970, é necessário definir a data como umcampo Cadeia. O OnDemand valida o valor de data.

Hora Contém os horários do dia, armazenados em incrementos de trêssegundos, de 0h (meia-noite) às 23h59min59s (dependendo de seuformato).

Data/Hora Contém um valor de data e de hora. A data pode ser de 1º dejaneiro de 1970 a 18 de janeiro de 2038. A hora é armazenada emincrementos de um segundo.

Data/Hora (FH) Contém um valor de data e de hora. A data pode ser de 1º dejaneiro de 1970 a 18 de janeiro de 2038. Um campo Data/Hora(TZ) é exatamente igual a um campo Data/Hora, mas usa o fusohorário configurado na estação de trabalho do cliente.

A Tabela 3 lista tipos adicionais de campos que são suportados nas pastas.

Tabela 3. Tipos adicionais de campos da pasta

Tipo de Campo Descrição

Pesquisa de Cor daAnotação

Utilize para a pesquisa de anotações de um documento,especificando uma cor. Uma correspondência ocorrerá e um itemserá incluído a lista de documentos se a cor do texto, em uma oumais anotações de um documento, for a mesma que a especificadano campo de pesquisa. Uma pasta pode ter um campo de pesquisade texto da anotação.

46 Guia de Planejamento e Instalação

||

||

||

||

|||||

|||||

|||||||||

|||||||||

|||||

||||

||||

||||||

Page 65: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 3. Tipos adicionais de campos da pasta (continuação)

Tipo de Campo Descrição

Pesquisa de Texto daAnotação

Utilize para a pesquisa de anotações para a cadeia especificada.Uma correspondência ocorrerá e um item será incluído na lista dedocumentos se uma ou mais anotações de um documento contivero texto especificado no campo de pesquisa. Uma pasta pode terum campo de pesquisa de texto da anotação.

Grupo de Aplicativos Em um campo de pesquisa, contém uma lista dos grupos deaplicativos que podem ser pesquisados na pasta. Ao criar umapasta que contenha mais de um grupo de aplicativos, defina umcampo desse grupo. Se estiverem habilitados a fazer consultas, osusuários poderão selecionar o nome do grupo de aplicativos que oOnDemand pesquisará, em vez de pesquisar todos os gruposcontidos na pasta (padrão). Em um campo de exibição, lista onome do grupo de aplicativos no qual o documento foiencontrado. Uma pasta pode ter um campo de grupo deaplicativos.

Segmento Contém uma lista de tabelas dos dados do índice armazenados nosgrupos de aplicativos que podem ser pesquisados na pasta. Cadaitem da lista representa um segmento dos dados do grupo deaplicativos. O OnDemand segmenta os dados do grupo deaplicativos por data. Se estiverem habilitados a fazer consultas, osusuários poderão selecionar um segmento específico dos dados dogrupo de aplicativos a ser pesquisado. Uma pasta pode ter umcampo de segmento.

Pesquisa de Texto Utilizado para procurar documentos que contenham uma palavraou frase não indexada. Uma correspondência ocorrerá e um itemserá incluído na lista de documentos quando uma ou mais linhasde um documento contiver a palavra ou a frase exatamente comofoi especificada. A cadeia de pesquisa pode conter, letras, números,símbolos especiais, como % e # e qualquer outro caractereimprimível. Uma pasta pode ter um campo de pesquisa de texto.Nota: A pesquisa de texto (seqüencial) ocorre no servidor. Umapesquisa de texto atrasa a geração da lista de documentos. Apenasos documentos que atendam aos critérios especificados nos outroscampos da pasta são pesquisados quanto à palavra ou fraseespecificada.

Um uso comum de um campo de pesquisa de texto é fornecer aosusuários um campo de pesquisa adicional, sem incorrer emsobrecarga do banco de dados. Por exemplo, considere que umrelatório seja indexado por data e número de transação. Um campode pesquisa de texto pode permitir que os usuários informemopcionalmente um nome de cliente, um número do telefone ouqualquer outra informação contida no(s) documento(s) que ousuário precisa recuperar (as informações não estão no banco dedados). Entretanto, um campo de pesquisa de texto influidiretamente no tempo necessário para gerar a lista de documentose no desempenho do servidor. Um grande número de usuários queexecutam pesquisas de texto simultaneamente normalmente podedrenar os recursos mesmo do servidor mais potente.

Suspender Usa um ícone de cadeado para indicar que um documento está emsuspensão. Quando um documento está em suspensão, o DiskStorage Manager (DSM) suspende sua expiração e exclusãoindefinidamente. O documento não expira e não pode ser excluídoaté que a suspensão seja liberada e o DSM seja executado. Afunção de suspensão não é compatível com a expiração baseada nogerenciador de armazenamento.

Capítulo 6. Objetos do OnDemand 47

|||||||

Page 66: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 3. Tipos adicionais de campos da pasta (continuação)

Tipo de Campo Descrição

Tipo de Documento Indica o formato de documento (AFP, SCS, PDF, definido pelousuário, por exemplo).

48 Guia de Planejamento e Instalação

||

Page 67: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 7. Requisitos de Memória

Visão GeralA estimativa das necessidades de armazenamento de um sistema OnDemandcomeça com a compreensão e a documentação das necessidades do usuário finalquanto ao armazenamento e ao acesso a dados. Capítulo 5, “Relatórios e OutrosDados”, na página 29 fornece informações que podem ajudá-lo a descobrir asnecessidades do usuário final.

Antes de transformar essas necessidades em um subsistema de armazenamentopara oferecer suporte ao sistema, revise as diversas questões operacionais e dedesempenho. Por exemplo, o OnDemand suporta até 32 campos de índices paracada relatório. Entretanto, os usuários não devem precisar de muitos índices paralocalizar uma versão específica de um relatório ou de um documento dentro dorelatório. O número de campos de índice definidos tem influência direta naquantidade de espaço em disco que será necessária para o banco de dados. Alémdisso, quanto mais índices forem definidos para um relatório, mais tempo levarápara que o relatório no sistema seja carregado. É importante trabalhar com osusuários e entender as necessidades de recuperação de dados. Defina somente onúmero necessário de campos de índice. Pode ser necessário equilibrar asnecessidades do usuário final com o espaço em disco, o tempo necessário paracarregar um relatório e outras questões de desempenho.

A manutenção de uma cópia dos relatórios no disco tem influência significativa naquantidade de armazenamento em disco necessária em seu sistema. A maior partedos clientes armazena as versões mais recentes, ou os relatórios acessados commais freqüência. Revise a forma como os usuários procuram e recuperaminformações a partir dos relatórios que você pretende armazenar no OnDemand.Por exemplo, se a maioria das recuperações ocorrer nos primeiros 90 dias após ageração de um relatório, provavelmente é melhor armazenar o relatório no discodurante esse período, no mínimo. Escolha um intervalo de tempo para cadarelatório que atenda às necessidades dos usuários e que também utilize o espaçoem disco da melhor forma.

Existem diversos componentes que devem ser medidos para determinar aquantidade de armazenamento em disco, ótico ou em fita necessária para suportaro sistema OnDemand. Por exemplo, os componentes a seguir do sistema exigemarmazenamento em disco:v Espaço de armazenamento para programas aplicativos e software de sistema,

incluindo o sistema operacional base, o software do servidor OnDemand equaisquer outros aplicativos do IBM necessários para seus negócios.

v Espaço de armazenamento para arquivos de configuração e de controle.v Espaço de armazenamento para o recurso de log do sistema OnDemand.v Espaço de armazenamento temporário para relatórios recebidos de outros

sistemas. Planeje o espaço em disco suficiente para conter o maior relatório queserá carregado no sistema ou o total dos vários relatórios que podem serpreparados para carregamento ao mesmo tempo, o que exigir mais espaço dearmazenamento. Em muitas empresas, a maioria das versões de um relatóriotem tamanho semelhante. Entretanto, pode ocorrer que um relatório seja muitomaior do que a média. Por exemplo, um relatório gerado no fim do mês ou nofim do trimestre pode ser muito maior do que a média dos relatórios.

© Copyright IBM Corp. 2001, 2010 49

Page 68: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Espaço de armazenamento temporário para indexar um relatório no servidorOnDemand.

v Espaço de armazenamento temporário para carregar um relatório no servidorOnDemand.

v Espaço de armazenamento para relatórios armazenados em disco. Esse valorpode ser zero no caso de relatórios que não exigem armazenamento em disco.Entretanto, pode ser necessário um espaço em disco muito grande pararelatórios que devem permanecer no disco por vários meses ou mais.O OnDemand compacta os dados do relatório antes de armazená-los. A taxa decompactação pode ter influência significativa na quantidade de espaço em disconecessária para armazenar um relatório. O OnDemand pode atingir umacompactação de até 30:1 em relatórios de dados on-line. Entretanto, no caso derelatórios que contêm dados AFP ou dados de imagens já compactadas, acompactação atingida é muito menor.

v Espaço de armazenamento para o banco de dados, que inclui tabelas do sistemaOnDemand (informações de controle e objetos definidos para o OnDemand) etabelas de grupos de aplicativos (dados de índice extraídos de relatórios). Aquantidade de espaço no banco de dados que deve ser planejada para umrelatório é um fator do número de documentos ou seções contidos no relatório,do número de campos de índice definidos para o relatório, do número deversões de um relatório (a freqüência com a qual o relatório é carregado nosistema) e o tempo necessário para manter um relatório no sistema.No caso de relatórios que contenham dados de transações ordenados, oOnDemand pode dividir o relatório em grupos com um número fixo de páginase criar uma linha de índice para cada grupo de páginas.6 No caso de relatóriosque contenham itens lógicos, tais como instruções e políticas, o OnDemand podecriar uma linha de índice para cada item lógico no relatório. Normalmente, oespaço necessário no banco de dados para indexar dados de transaçãoordenados é muito menor que o espaço em banco de dados necessário paraindexar relatórios que contenham itens lógicos. Além disso, os campos de índiceoferecem pesquisa rápida, mas exigem um espaço significativo de espaço nobanco de dados.

v Espaço de armazenamento para o diário OnDemand e receptores de diário. Énecessário planejar o espaço em disco para o diário OnDemand e para osreceptores utilizados para controle de consolidação.

v Espaço de armazenamento temporário para impressão e fax no servidor.v Espaço de armazenamento temporário para importar índices migrados de mídia

de arquivamento no banco de dados.

Os componentes do sistema a seguir exigem armazenamento em archive (ótico eem fita):v Relatórios que você pretende armazenar em mídia de arquivamento.v Cópias de backup de relatórios armazenados em mídia de arquivamento (para

aplicativos críticos, alguns clientes exigem que o sistema mantenha duas ou maiscópias de um relatório na mídia de arquivamento).

Você pode substituir volumes de armazenamento ótico cheios por volumes novosvazios na biblioteca ótica, conforme necessário, se os requisitos de disponibilidadedo sistema permitirem. Por exemplo, você pode optar por remover volumes dearmazenamento cheios de uma biblioteca um ano após o OnDemand ter gravado

6. No caso de dados de transação ordenados, os exemplos e cálculos a seguir supõem que o OnDemand cria um item indexado paracada grupo de 100 páginas em um relatório. O número de páginas em um grupo é um parâmetro que você pode configurar aoindexar um relatório. O IBM Content Manager OnDemand for i Common Server: Indexing Reference fornece mais informações.

50 Guia de Planejamento e Instalação

Page 69: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

dados de relatório no volume de armazenamento. Os volumes de armazenamentocheios podem ser substituídos por volumes de armazenamento recém-inicializadospara manter os relatórios mais recentes armazenados no sistema. Dessa forma, asversões mais recentes de um relatório estão sempre disponíveis na biblioteca.Entretanto, se for necessário manter vários anos de dados de relatório on-line nabiblioteca ou armazenar grandes quantidades de dados nos grupos do aplicativo,pode ser necessário planejar várias bibliotecas óticas no sistema.

Hierarquia de ArmazenamentoExistem diversas estratégias de armazenamento diferentes que você pode utilizarcom o OnDemand.

Por exemplo, o OnDemand permite a migração dos dados de um tipo de mídia dearmazenamento para outro, utilizando critérios definidos por um administrador. Oarmazenamento em disco pode ser utilizado para acesso em alta velocidade aosrelatórios. Quando um relatório é carregado no sistema, o OnDemand podearmazenar automaticamente uma cópia desse relatório no disco e outra cópia namídia de armazenamento de archive. O OnDemand também suporta a opção dearmazenar relatórios em disco e depois migrá-los para o armazenamento dearchive. Entretanto, recomendamos que você sempre planeje copiar relatórios emídia de arquivamento para o disco ao mesmo tempo (ao carregar o relatório).Dessa forma, é eliminada a necessidade de fazer backups periódicos doarmazenamento em disco, pois já existe uma cópia de backup dos relatórios namídia de arquivamento. A cópia de relatórios para o armazenamento em cache e oarmazenamento de archive ao mesmo tempo elimina a necessidade de migrarrelatórios para a mídia de arquivamento posteriormente.

Os relatórios expiram (podem ser removidos) do disco quando atingem a data deexpiração no disco. A data de expiração do relatório no disco é especificadaquando você cria um grupo de aplicativos. Por exemplo, você pode especificar queum relatório deve expirar do disco após ele estar armazenado por noventa dias. OOnDemand fornece um comando que pode ser utilizado para removerautomaticamente do disco os relatórios expirados, com uma programação regular.Após executar o processo de expiração, o OnDemand solicita o espaço ocupadopelos documentos expirados.

O OnDemand mantém os documentos no disco e na mídia de arquivamentoindependentemente um do outro, até que os documentos expirem. A expiração emum gerenciador de armazenamento expira dados do outro gerenciador dearmazenamento. Cada um utiliza seus próprios critérios para determinar quandoos dados expiram e devem ser removidos do sistema; cada um utiliza os seuspróprios comandos para remover documentos. Você precisa decidir como os dadosserão expirados de seu sistema e aplicar esses padrões consistentemente ao criarseus grupos de aplicativos e políticas de migração. Consulte Capítulo 3,“Gerenciamento de Armazenamento em Archive”, na página 21 para obter maisdetalhes.

Compactação de DadosO OnDemand pode compactar dados do relatório utilizando vários algoritmos decompactação diferentes antes de armazenar os dados no disco e no armazenamentode archive. A taxa de compactação que o OnDemand pode atingir tem impactosignificativo sobre a quantidade de espaço necessária para armazenar relatórios.

Capítulo 7. Requisitos de Memória 51

||||||||||

Page 70: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

As taxas de compactação que o OnDemand pode atingir variam muito,dependendo do tipo de dados e de seu formato. Nem sempre é possível fazer umaestimativa precisa da taxa de compactação simplesmente examinando os dados.Em média, o esperado é atingir compactação entre 2:1 e 15:1 para documentos AFPe até 30:1 em relatórios de dados em linha. A compactação de documentos AFP ébaseada no arquivo de dados de saída produzido pelo indexador e não no arquivode entrada, que pode ter dados em linha. Quando o indexador formata dados emlinha com uma definição de página, pode aumentar o tamanho dos dadosincluindo controles do AFP para posicionar o texto.

Para fazer uma estimativa correta do espaço de armazenamento necessário paraum relatório, recomendamos medir a taxa de compactação atingida por meio doarmazenamento real de uma amostra do relatório. O relatório pode serarmazenado utilizando o comando ADDRPTOND. O comando ADDRPTONDcoloca entradas no log do sistema, o que fornece valores de tamanho anterior eposterior que podem ser utilizados para a taxa de compactação real obtida.

Consulte o IBM Content Manager OnDemand for i Common Server AdministrationGuide para obter mais informações sobre o comando ADDRPTOND.

Cálculo dos Requisitos de Armazenamento em Disco

Software do SistemaOs servidores OnDemand exigem espaço em disco para uma grande variedade deprodutos de software para oferecer suporte aos aplicativos de negócios que sãoexecutados neles. Isto inclui o software do sistema operacional, software doaplicativo de negócios, espaço de trabalho temporário e o software do servidorOnDemand.

Espaço Temporário para IndexaçãoO OnDemand requer espaço de armazenamento temporário no disco pararelatórios de índice. O espaço temporário solicitado pelo OnDemand é a maiorinstância de um relatório multiplicada pelo número de relatórios que você planejaindexar ao mesmo tempo.

Utilize o cálculo a seguir para determinar o espaço temporário necessário pararelatórios de índice:

Espaço temporário = Maior tamanho do arquivo de relatório * 1,5

em que Maior tamanho do arquivo de relatório é o tamanho em bytes da maiorversão de um relatório a ser indexado, ou o tamanho total de todos os relatóriosque o servidor deve indexar ao mesmo tempo (se você indexar mais de umrelatório por vez).

Por exemplo, se o maior relatório tiver 400 MB, o espaço temporário necessáriopara indexar o relatório é:

Espaço temporário = 400 MB * 1,5 = 600 MB

Armazenamento em Disco para Relatórios ArmazenadosA quantidade de espaço em disco que deve ser dedicada aos dados do relatórioarmazenado varia muito com base em requisitos como o número de relatórios quevocê armazena no sistema, a taxa de compactação que o OnDemand pode atingir eo tempo necessário para manter um relatório no disco. A maior parte dos clientes

52 Guia de Planejamento e Instalação

Page 71: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

armazena relatórios em disco por um tempo curto para obter uma recuperaçãomais rápida dos relatórios mais utilizados. Conforme os relatórios ficam maisantigos e seus pedidos de recuperação são menos freqüentes, eles podem serrecuperados da mídia de arquivamento. Outro motivo para manter os relatórios nodisco é para que vários usuários tenham acesso a eles ao mesmo tempo. Como ogerenciador de armazenamento do archive pode precisar de seis a sessentasegundos para montar um volume de armazenamento ótico ou de fita e recuperarum relatório, normalmente não é possível oferecer suporte a taxa de alta transaçãopara relatórios armazenados em mídia de arquivamento.

Outro uso do armazenamento em disco é para relatórios com vida útil curta, comouma semana ou um mês. Esses tipos de relatórios podem ser armazenados emdisco e o OnDemand os exclui automaticamente ao atingirem a data de expiração.O armazenamento em disco também pode ser utilizado para manter relatórios paraos quais não é necessária uma cópia de backup.

Utilize o cálculo a seguir para determinar o espaço em disco necessário pararelatórios armazenados:

Espaço em disco necessário = Tamanho dos dados por semana* Número de semanas no disco

* Taxa de compactação de dados* 1,1

Por exemplo, se você pretende carregar 2 GB de dados de relatório no sistema porsemana, os relatórios devem ser mantidos em disco por 12 semanas e a taxa decompactação for 3:1 (0,33), os espaço em disco necessário para o espaço dearmazenamento em cache pode ser calculado da seguinte forma:

Espaço necessário em disco = 2 GB * 12 * ,33 * 1,1 = 8,71 GB

Armazenamento do Banco de Dados do OnDemandAo carregar um relatório no sistema, o OnDemand extrai dados do índice dorelatório e os armazena em uma tabela do grupo de aplicativos no banco de dados.Para relatórios que contenham itens lógicos, tais como instruções e critérios, oOnDemand pode criar uma linha do banco de dados para cada item encontrado norelatório. Para relatórios que contenham dados da transação ordenados, oOnDemand pode criar uma linha do banco de dados para cada grupo indexado depáginas (por padrão, 100 páginas em um grupo).

Uma linha do banco de dados contém uma quantidade fixa de informações que oOnDemand utiliza para manter relatórios (aproximadamente 40 bytes) e todos oscampos de filtro e índice que você definir para o grupo de aplicativos. Os camposde índice, que permitem que os usuários localizem documentos rapidamente,exigem um armazenamento em disco significativamente maior que os campos defiltro (os campos de índice também exigem maior tempo de carregamento noOnDemand).

Existem quatro fatores principais que determinam a quantidade de espaço emdisco necessária para o banco de dados do OnDemand:v O número de campos de filtro e de índicesv O tamanho dos campos de filtro e dos índicesv O número de itens indexados por mêsv Por quantos meses o OnDemand mantém os dados do índice no banco de dados

Capítulo 7. Requisitos de Memória 53

Page 72: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

A Tabela 4 lista os tipos de campos de índice suportados pelo OnDemand e onúmero de bytes necessários para armazenar um valor em cada tipo de campo deíndice.

Tabela 4. Tipos e tamanhos de campos de índice

Tipo de Campo Tamanho de Campo

Inteiro Pequeno 2 bytes

Inteiro 4 bytes

Inteiro Grande 8 bytes

Decimal (Ponto Flutuante) 8 bytes

Cadeia (Fixa) 1 - 254; 1 byte por caractere declarado,mesmo que utilizado parcialmente

Cadeia (Variável) 25 - 254; 1 byte por caractere mais 2 bytes desobra; caracteres não utilizados nãoconsomem memória

Data 4 bytes

Hora 4 bytes

Data/Hora 4 bytes

Data/Hora (FH) 4 bytes

Armazenamento do Diário do Banco de DadosO banco de dados do OnDemand inclui um diário de recuperação e receptores dediário utilizados para recuperação a partir de erros no aplicativo ou no sistema.Em combinação com backups do banco de dados, eles são utilizados pararecuperar a consistência do banco de dados a partir do momento em que ocorreu oerro. Ao criar uma instância do OnDemand, um diário chamado QSQJRN serácriado em sua biblioteca de instâncias. Um receptor de diário chamadoQSQJRN0001 é criado automaticamente como primeiro receptor do diário. QSQJRNé um diário gerenciado pelo sistema, o que significa que o sistema operacionalgerencia a alteração dos receptores do diário conforme necessário. As mensagensrelacionadas a esse diário são enviadas para a fila de mensagens QSYSOPR.

Espaço Temporário para Importação de Dados de Índice

Nota: Se você não pretende migrar dados de índice do banco de dados para amídia de arquivamento, não é necessário alocar espaço de armazenamentotemporário para importar os dados de índice migrados. É importanteentender que a migração dos dados de índice não é recomendada. Portanto,poucos clientes devem precisar ler esta seção.

O OnDemand requer espaço de trabalho temporário para importar dados de índicemigrados da mídia de arquivamento para o banco de dados. É necessário alocarespaço em disco suficiente para suportar o número máximo de pedidos deimportação simultâneos que o servidor deve gerenciar. O espaço alocado é baseadono tamanho das tabelas do grupo de aplicativos e no número de tabelas quedevem ser importadas para atender a uma consulta de dados migrados.

54 Guia de Planejamento e Instalação

Page 73: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Cálculo dos Requisitos de Armazenamento em Archive

Espaço de Armazenamento de RelatórioQuando você faz uma estimativa do espaço necessário para armazenar umrelatório em archive, deve levar em consideração o tamanho do relatório, a taxa decompactação atingida e o tempo pelo qual o gerenciador de armazenamento doarchive mantém o relatório. A mídia de arquivamento pode ser de armazenamentoótico ou fita magnética. Utilize o cálculo a seguir para fazer uma estimativa doespaço necessário:

Espaço de armazenamento de archive =( Dados por mês * duração dos dados em meses )* taxa de compactação* 1,1

Por exemplo, se você pretende armazenar 8 GB de dados de relatório por mês, ogerenciador de armazenamento do archive deve manter os dados por sete anos e oOnDemand pode atingir uma taxa de compactação de 3:1 (0,33), serão necessáriosaproximadamente 244 GB de espaço de armazenamento em archive:

Espaço ótico = ( 8 GB * 84 ) * 0,33 * 1,1 = 244 GB

Espaço de Armazenamento do Relatório de BackupO sistema OnDemand pode manter uma (segunda) cópia de backup dos relatóriosque você armazena na mídia de arquivamento. Normalmente, você mantém váriascópias de relatórios críticos para a operação de sua empresa que sejam impossíveisou difíceis de recriar.

Para que o OnDemand mantenha uma cópia de backup dos seus relatórios,duplique o espaço de armazenamento em archive calculado em “Espaço deArmazenamento de Relatório”.

Espaço de Armazenamento de Índice Migrado

Nota: É importante entender que a migração dos dados de índice não érecomendada. Portanto, poucos clientes devem precisar ler esta seção.

O OnDemand suporta a migração automática de índices a partir do banco dedados para o armazenamento em archive, para que você possa manter índicespouco utilizados por um longo tempo. Entretanto, a migração de índices deve serfeita somente quando não houver mais necessidade de recuperar os relatórios queeles indicam. Por exemplo, suponha que todas as consultas em um relatórioocorram nos 24 primeiros meses após o carregamento do relatório no sistema.Após esse período, praticamente não há consultas no relatório. Os índices podemser migrados do banco de dados para o armazenamento em archive. A migraçãode dados de índice é opcional; você pode optar por migrar os índices de todos,alguns ou nenhum dos grupos de aplicativos do sistema. Além disso, vocêdetermina por quanto tempo os índices permanecem no banco de dados antes de oOnDemand migrá-los para o armazenamento em archive.

Utilize o cálculo a seguir para determinar o espaço de armazenamento em archivenecessário para manter índices migrados:

Espaço de banco de dados da mídia de archive = ( Tamanho do banco de dados por mês *proporção de compactação ) * ( vida útil dos dados - meses antes da migração )

Capítulo 7. Requisitos de Memória 55

Page 74: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Por exemplo, se o tamanho do banco de dados for 202 MB por mês, os índicesdeverão ser mantidos por 84 meses e permanecerão no banco de dados por 24meses antes da migração. Portanto, o a memória de archive necessária para conteros índices migrados é:

Espaço de banco de dados da mídia de archive = ( 202 MB * ,33 )* ( 84 - 24 ) = 4 GB

56 Guia de Planejamento e Instalação

Page 75: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 8. Backup e Recuperação

Visão GeralEsta seção do manual descreve o backup e a recuperação do OnDemand e fornecerecomendações sobre métodos e procedimentos que um administrador podeutilizar para certificar-se de que os seguintes componentes críticos do OnDemandpossam ser recuperados quando necessário:v software do OnDemandv informações sobre servidor OnDemand, criadas e modificadas durante a

instalação, configuração e operação contínua do OnDemandv banco de dados do OnDemandv relatórios arquivados

Consulte o Capítulo 5 do IBM Content Manager OnDemand for i: Common ServerAdministration Guide para bibliotecas e objetos específicos a serem submetidos abackup em uma base regular.

Software do ServidorSe ocorrer uma falha de mídia ou outro evento não previsto, pode ser necessáriorestaurar os programas do software OnDemand e outros aplicativos e softwaredefinido pelo usuário utilizados no sistema.

É importante armazenar a mídia de backup para esses produtos de software emum local seguro. Recomendamos que você registre o OnDemand como parte deseu plano de recuperação de negócios e armazene a mídia do produto no mesmolocal que os outros programas e arquivos vitais para a operação dos seus sistemas.

Informações do ServidorQuando você instalou e configurou o OnDemand, especificou informações quepersonalizaram a operação do OnDemand em seu ambiente. Essas informaçõesestão armazenadas em arquivos de controle localizados em diversos diretórios IFSno servidor. Recomendamos que você faça backup dos arquivos de controleimediatamente após verificar a instalação do OnDemand. Além disso, se você fazalterações periódicas nas informações do servidor OnDemand, recomendamos quevocê faça backup dos arquivos de controle regularmente.

Consulte as publicações do sistema operacional e do dispositivo para obterdetalhes sobre conceitos e comandos de backup e restauração.

Banco de Dados do OnDemand

Backup do Banco de DadosO sistema operacional fornece comandos para que você possa criar cópias debackup do banco de dados do OnDemand.

Se seu planejamento de produção permitir, recomendamos que você crie backupsoff-line regularmente, talvez todas as noites ou uma vez por semana. Backupsoff-line programados regularmente podem reduzir o tempo necessário para recriar

© Copyright IBM Corp. 2001, 2010 57

Page 76: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

o banco de dados, caso necessário. Mantenha a mídia de backup em um localseguro até a próxima vez que criar um backup off-line do banco de dados.

Se seu planejamento não permitir tempo para backups off-line (isto é, caso seusistema permaneça sempre disponível para os usuários), faça backups on-lineregularmente. Consulte o Guia de Backup e Recuperação para obter detalhes sobrecomo fazer backup do banco de dados.

Criação de Diário do Banco de DadosO gerenciador do banco de dados cria diários para registrar informações sobrealterações no banco de dados do OnDemand. As informações do diário sãoutilizadas para recuperar dados corrompidos do banco de dados. A criação dediário garante que não ocorra perda de dados. Combinando as informações nodiário com uma cópia de backup do banco de dados, o banco de dados doOnDemand pode ser recuperado a qualquer instante.

Recuperação do Banco de DadosExistem dois tipos de recuperação do banco de dados. O primeiro recupera a partirde falhas durante transações de atualização. O diário ajuda a corrigir esse tipo defalha permitindo que as transações recebidas antes da falha sejam reaplicadas aobanco de dados ou sejam retrocedidas. O retrocesso de transações é uma forma deretornar o banco de dados ao estado anterior à transação que provocou a falha.

O segundo tipo de recuperação lida com danos no banco de dados do OnDemand,normalmente provocado por falha na mídia. A combinação de diários e uma cópiade backup do banco de dados pode ser utilizada para recriar o banco de dados doOnDemand em um determinado instante.

Caso ocorra uma falha muito grande, o administrador do sistema precisa intervirpara recuperar o banco de dados. A recuperação de falhas catastróficas inicia com arestauração da última cópia de backup completa do banco de dados. Em seguida, oadministrador do sistema reaplica as transações gravadas no(s) diário(s). Essasetapas recriam o banco de dados do OnDemand antes da grande falha.

RelatóriosO OnDemand pode armazenar cópias de relatórios no disco e no armazenamentoem archive:v O objetivo principal do armazenamento em disco é um armazenamento e

recuperação dos relatórios por um período curto e com alta velocidade.v O objetivo principal do armazenamento em archive é um armazenamento e

recuperação dos relatórios por um período longo. Os relatórios noarmazenamento em archive também podem ser utilizados como cópias debackup, no caso de o armazenamento ser danificado ou tornar-se indisponível. Oarmazenamento de archive consiste em volumes de armazenamento em disco,ótico ou fita ou em servidores Tivoli Storage Manager gerenciados pelogerenciador de armazenamento de archive.

Ao carregar um relatório no sistema, a maior parte dos clientes configura o sistemapara copiar relatórios para o armazenamento em disco e em archive ao mesmotempo.

O OnDemand pode recuperar uma cópia de um relatório do armazenamento emarchive após o relatório ter sido removido do disco, ou se a cópia no disco nãoestiver disponível. Entretanto, é necessário configurar o sistema para suportar

58 Guia de Planejamento e Instalação

Page 77: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

várias cópias de relatórios. Defina dispositivos para o gerenciador dearmazenamento em archive e configure o OnDemand para utilizar armazenamentoem archive. Configure o OnDemand para utilizar armazenamento em archivedefinindo políticas de migração e conjuntos de armazenamento, atribuindo gruposde aplicativos aos conjuntos de armazenamento e configurando a migração dedados em grupos de aplicativos.

Armazenamento em DiscoO armazenamento em disco é o local principal para armazenamento de relatóriospor um período curto.

Caso não copie os relatórios para o armazenamento em archive ao armazená-los noOnDemand, considere como recuperar os relatórios se necessário.

O armazenamento em disco pode ser protegido se for mantido em subsistemas dearmazenamento RAID. O armazenamento RAID pode oferecer excelentedisponibilidade, permitindo que os usuários acessem relatórios mesmo que umdisco ou um controlador falhe. Entretanto, o armazenamento RAID não é à provade falhas. Podem ocorrer situações nas quais, devido a várias falhas no controladorou no disco, os usuários não conseguem acessar os relatórios. Recomendamos quemanter sempre uma cópia de backup dos relatórios no armazenamento em archive.

Armazenamento em ArchiveA política de migração do OnDemand identifica o local em que a cópia principalde um relatório é mantida. O OnDemand recupera a cópia principal do relatório apartir do armazenamento em archive após a remoção do relatório do disco. Osclientes que tenham razões especiais de negócios, jurídicas ou de desempenhopodem desejar que o sistema mantenha uma cópia de backup de seus relatórios noarmazenamento em archive. A cópia de backup pode ser utilizada se a cópiaprincipal for danificada ou tornar-se indisponível.

Capítulo 8. Backup e Recuperação 59

Page 78: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

60 Guia de Planejamento e Instalação

Page 79: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 9. Como Salvar Arquivos de Configuração

Quando você instala software em um servidor OnDemand, os programas deinstalação copiam arquivos de programas, arquivos de configuração e outros tiposde arquivos da mídia de distribuição para diretórios no servidor. Ao configurar umservidor para atender às necessidades específicas do seu ambiente, você fazalterações no arquivo de configuração e pode personalizar outros arquivos, taiscomo arquivos definidos pelo usuário e arquivos de inicialização de fontes.

Após fazer alterações em algum arquivo de configuração ou antes de fazer oupgrade para uma nova versão do OnDemand, recomendamos que você salve umacópia dos arquivos listados nesta seção. Consulte o Capítulo 5 do IBM ContentManager OnDemand for i: Common Server Administration Guide para bibliotecas eobjetos específicos a serem submetidos a backup em uma base regular.

Arquivos do OnDemandSalve uma cópia dos arquivos de configuração do OnDemand listados na Tabela 5.Nota: Substitua <instância> pelo nome real da <instância> à qual o arquivopertence.

Tabela 5. Arquivos de configuração do OnDemand a serem salvos

Arquivo Localização Padrão Objetivo

ars.cache /QIBM/UserData/OnDemand/<instância>/config Definir detalhes doarmazenamento em disco.

ars.cfg /QIBM/UserData/OnDemand/<instância>/config Arquivo de configuraçãodo servidor OnDemand.Alterações descritas noCapítulo 14, “Configuraçãodo Arquivo ARS.CFG”, napágina 85.

ars.ini /QIBM/UserData/OnDemand/config Configurar instâncias doOnDemand. Alteraçõesdescritas no Capítulo 12,“Criação de umaocorrência”, na página 71.

ars.dbfs /QIBM/UserData/OnDemand/<instância>/config Não utilizado, mas deveexistir.

arsload.cfg /QIBM/UserData/OnDemand/<instância>/config Definir um ID do usuário euma senha padrão doadministrador do sistemaOnDemand para oprograma ARSLOAD.Mudanças descritas noApêndice B do IBM ContentManager OnDemand for i:Common ServerAdministration Guide(SC19–2792)

© Copyright IBM Corp. 2001, 2010 61

Page 80: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 5. Arquivos de configuração do OnDemand a serem salvos (continuação)

Arquivo Localização Padrão Objetivo

arslog /QIBM/ProdData/OnDemand/bin O link simbólico para oprograma de saída dousuário de Log do sistemapadrão. Descrito noApêndice C, “Log doSistema e Saída do Usuáriode Log do Sistema”, napágina 119.

Arquivos de Fonte do WindowsSe você modificou quaisquer arquivos relacionados a fonte nas estações de trabalhodo cliente Windows, salve uma cópia dos arquivos listados em Tabela 6. Quandoinstalar um novo nível de software do cliente, esses arquivos serão substituídos eas modificações efetuadas serão perdidas. Por isso, você pode optar por fazerbackup dos arquivos modificados.

A localização mostra o diretório de instalação padrão do cliente Windows.

Tabela 6. Arquivos de página de códigos definidos pelo usuário (cliente Windows)

Arquivo Localização Objetivo

ICODED.FNT \Program Files\IBM\OnDemand32\Font Arquivo de fontes codificadas. Contém a listade arquivos de fontes codificadas utilizadaspelo programa do cliente Windows.

CSDEF.FNT \Program Files\IBM\OnDemand32\Font Arquivo de definição do conjunto decaracteres. Contém a lista dos conjuntos decaracteres utilizados pelo programa do clienteWindows.

CPDEF.FNT \Program Files\IBM\OnDemand32\Font Arquivo de definição da página de códigos.Contém a lista de arquivos de página decódigos utilizados pelo programa do clienteWindows.

ALIAS.FNT \Program Files\IBM\OnDemand32\Font O arquivo de alias. Utilizado para mapearfontes AFP para fontes do tipo 1 ou Truetype.

62 Guia de Planejamento e Instalação

Page 81: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parte 4. Instalação do Software

Esta seção contém instruções para instalar o software do servidor OnDemand noservidor IBM i.

© Copyright IBM Corp. 2001, 2010 63

Page 82: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

64 Guia de Planejamento e Instalação

Page 83: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 10. Lista de Verificação da Instalação

A configuração do sistema OnDemand normalmente exige que você faça oseguinte:__ 1. Entre em contato com o IBM Support Center para obter as PTFs mais

recentes do OnDemand ou obtenha a lista a partir da página da Web desuporte do OnDemand em http://www.ibm.com/software/data/ondemand/400/support.html (na página "Download" sob InformationAPARs). A lista de PTFs atuais pode ser localizada no APAR Informativo denúmero II14497. Considere solicitar as PTFs atuais do IBM i (DB2 emparticular) e do IBM i Access, pois esses dois produtos são uma parteintegral do sistema OnDemand. Após obter a lista atual de PTFs, carregue aaplique-as em seu sistema.

__ 2. Obtenha uma cópia do documento Read This First mais recente doOnDemand no endereço da Web http://www.ibm.com/software/data/ondemand/400/support.html (na página "Documentation" juntamente com aoutra documentação da Versão 7 Release 1). Imprima e leia o documentointeiro antes de iniciar.

__ 3. Verifique os pré-requisitos do OnDemand (consulte o Capítulo 4, “Hardwaree Software”, na página 25) e os produtos de hardware e software necessáriose opcionais.

__ 4. Se estiver atualizando para uma nova versão do OnDemand, salve osarquivos de configuração utilizados pelo sistema (consulte o Capítulo 9,“Como Salvar Arquivos de Configuração”, na página 61). Além disso, anotequalquer alteração que você tenha feito no perfil de usuário QRDARS400.Uma atualização irá sobrepor esse perfil de usuário do OnDemand e seránecessário fazer as alterações novamente depois que a atualização forconcluída.

__ 5. Obtenha o software OnDemand (consulte Capítulo 11, “Instalação doSoftware do Servidor OnDemand”, na página 67).

__ 6. Instale o software OnDemand no servidor IBM i (consulte o Capítulo 11,“Instalação do Software do Servidor OnDemand”, na página 67).

__ 7. Configure o software OnDemand (consulte a Parte 5, “Configuração eInicialização do Sistema”, na página 69). Esta etapa inclui o seguinte:__ a. Refazer qualquer alteração no perfil de usuário QRDARS400 que você

anotou no item 4, acima__ b. Criação de uma instância (consulte o Capítulo 12, “Criação de uma

ocorrência”, na página 71)__ c. Definição dr um locale (consulte o Capítulo 13, “Definição do Locale”,

na página 81)__ d. Configuração do arquivo ARS.CFG (consulte o Capítulo 14,

“Configuração do Arquivo ARS.CFG”, na página 85)__ e. Configuração da inicialização do sistema (consulte o Capítulo 15,

“Configuração da Inicialização do Sistema”, na página 89)__ f. Definição do planejamento dos programas de manutenção (consulte o

Capítulo 16, “Planejamento de Programas de Manutenção”, na página91)

__ 8. Crie e inicialize o banco de dados no servidor (consulte o Capítulo 12,“Criação de uma ocorrência”, na página 71)

© Copyright IBM Corp. 2001, 2010 65

|||||||||

Page 84: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Verifique a instalação do OnDemand (consulte o Capítulo 17, “Verificação daInstalação”, na página 95):__ 1. Para acessar o sistema, você deve instalar o programa cliente OnDemand em

uma estação de trabalho. Consulte o IBM Content Manager OnDemand: Guiado Usuário para mais detalhes sobre instalação do software do clienteOnDemand.

__ 2. Inicie a sessão no servidor com um programa do cliente OnDemand.

Prepare o sistema para a utilização:__ 1. Defina políticas de migração e conjuntos de armazenamento (consulte o

Capítulo 18, “Definição de políticas de migração e conjuntos dearmazenamento”, na página 97). Antes de incluir grupos de aplicativos oude carregar dados no sistema, defina políticas de migração e conjuntos dearmazenamento.

__ 2. Configure o grupo de aplicativos de Log do sistema (consulte o Capítulo 19,“Configuração do Grupo de Aplicativos do Log do Sistema”, na página 99).Antes de definir relatórios no sistema, carregar dados, ou permitir que osusuários acessem o sistema, configure o grupo de aplicativos de Log dosistema.

__ 3. Configure o grupo de aplicativos de Migração do sistema (consulte oCapítulo 20, “Configuração do Grupo de Aplicativos de Migração doSistema”, na página 103). Caso pretenda migrar dados de índice para oarmazenamento em archive, configure o grupo de aplicativos de Migraçãodo sistema.

Nota: Não é recomendado migrar dados de índice para o armazenamentoem archive.

__ 4. Faça backup do banco de dados (consulte Capítulo 21, “Backup dos dadosdo OnDemand”, na página 105). Após configurar o sistema, recomendamosque seja criada um backup completa do banco de dados do OnDemand.

Instalação e configuração de software opcional:1. Caso planeje reimprimir documentos AFP ou enviar via fax quaisquer

documentos usando a função de impressão do servidor OnDemand, vocêdeverá instalar o PSF para o IBM i no servidor OnDemand para i. Execute asseguintes tarefas:__ a. Instale e configure o PSF para o IBM i (parte do IBM i).__ b. Defina uma impressora do servidor no OnDemand com o cliente

administrativo.2. Se você pretende configurar as mensagens enviadas ao log do sistema ou

definir seu próprio programa de saída do usuário de log do sistema, consulte oApêndice C, “Log do Sistema e Saída do Usuário de Log do Sistema”, napágina 119.

66 Guia de Planejamento e Instalação

Page 85: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 11. Instalação do Software do Servidor OnDemand

É necessário instalar uma cópia do software do servidor OnDemand em seuservidor IBM i.

Obtendo o Software OnDemandO software OnDemand não é mais enviado na mídia em pilha (CDs) recebida commuitos outros programas licenciados. O produto está agora disponível a partir doWeb site do Passport Advantage, onde ele pode ser transferido por download. Paraobter instruções importantes e detalhadas sobre o processo de obtenção einstalação do software, consulte o http://www.ibm.com/support/docview.wss?uid=swg21245956. A IBM recomenda que você imprima e revise oarquivo PDF de instruções fornecido com as informações em vez das instruçõesabreviadas disponíveis no site do Passport Advantage como um arquivo TXT.

Instalação do OnDemandEste capítulo fornece instruções de instalação para todos os recursos doOnDemand Common Server.

Importante:: As implementações existentes do Spool File Archive devem sermigradas do ambiente do Spool File Archive para o Common Serverantes de ser feito upgrade do sistema no qual elas estão em execuçãopara a 6.1 ou 7.1. Os releases 5.3 e 5.4 do Content ManagerOnDemand incluíam o ambiente do Common Server, bem como osambientes legados do Spool File Archive, AnyStore, Record Archive eObject Archive. Todos esses ambientes eram totalmente suportadosaté, e inclusive, o 5.4. Conforme declarado na Carta de Anúncio daIBM nº 206-030 de 14 de fevereiro de 2006, o 5.4 era o último releaseem que o Spool File Archive, AnyStore, Record Archive e ObjectArchive seriam fornecidos e suportados. A partir do ContentManager OnDemand 5.3, um utilitário de migração Spool FileArchive foi disponibilizado como parte do produto de programalicenciado Content Manager OnDemand, fornecendo recurso paramigrar definições de relatório e índices do ambiente do Spool FileArchive legado para o ambiente do Common Server. Informaçõesdetalhadas sobre o utilitário de migração podem ser localizadas noApêndice A do IBM Content Manager OnDemand for iSeriesCommon Server Planning and Installation Guide for 5.4. Asimplementações existentes do Spool File Archive devem ser migradasdo ambiente do Spool File Archive para o Common Server antes deser feito upgrade do sistema no qual elas estão em execução para a6.1 ou 7.1.

OnDemand procedimentos de instalaçãoPara instalar o OnDemand, siga as instruções do manual denominado Instalação doSoftware (SC17-1257).

Importante:: Se você estiver fazendo upgrade de um release anterior doOnDemand, é necessário que esteja executando o servidorOnDemand versão 7.1.2.8, ou superior, antes de fazer upgrade para o

© Copyright IBM Corp. 2001, 2010 67

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

|||

Page 86: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Content Manager OnDemand para i Versão 7 Release 1. É possíveldeterminar a versão de seu servidor atual usando um dos seguintesmétodos:v Se você estiver executando a versão 7.1.2.5, ou superior, do cliente

OnDemand, efetue logon no OnDemand Administrator ou nocliente de usuário final do OnDemand. Depois que o logon forefetuado, a versão do servidor será mostrada na linha demensagem na parte inferior direita do painel.

v Em qualquer versão do OnDemand, efetue logon no servidor IBMi. Inicie o qshell usando o comando QSH. Após o qshell seriniciado, insira ARSDATE (sem parâmetros adicionais) na linha decomando Qshell. A versão do servidor é exibida juntamente comoutras informações sobre a API ARSDATE.

O número do programa licenciado para o OnDemand Versão 7 Release 1 é5770RD1. Os recursos individuais do OnDemand (instalados separadamente) são:v *BASE para o Suporte Base (necessário para todos os outros)v 10 para o Common Serverv 11 para o ODWEK (Web Enablement Kit)v 12 para o PDF Indexer

As opções 1 a 5 não se aplicam a esta publicação e não estão mais disponíveis.Consulte a Versão 5 Release 4 do IBM Content Manager OnDemand for i: InstallationGuide para obter informações adicionais sobre essas opções.

A forma recomendada de instalar o OnDemand é utilizar a opção de menu Instalarprogramas licenciados no menu Trabalhar com programas licenciados (go licpgm).Na tela Instalar programas licenciados, digite 1 para Incluir uma opção e depoisdigite cada um dos recursos listados acima que você solicitou (como *BASE e, emseguida, opção 10, 11, ou 12 conforme necessário).

Se você instalar o OnDemand com qualquer outro método, erros poderão ocorrerao tentar usá-lo.

A IBM recomenda que você solicite, carregue e aplique todas as PTFs disponíveispara o OnDemand após a instalação com êxito do programa licenciado. Consulte oAPAR Informativo II14497 para obter uma lista completa de PTFs do OnDemandVersão 7 Release 1. O APAR Informativo pode ser solicitado eletronicamenteusando o comando SNDPTFORD, especificando II14497 para o número de PTF.Certifique-se de ler a carta na capa da PTF e de seguir todas as instruçõesespeciais.

Instalação do Cliente do Usuário Final do OnDemandPara obter informações sobre a instalação do cliente OnDemand para Windows,consulte o IBM Content Manager OnDemand: Guia do Usuário (S517-7165).

Nota: O Web site do FTP para obter o software do cliente do OnDemand éftp://service.software.ibm.com/software/ondemand/fixes/.

Instalação do Cliente Administrativo do OnDemandPara obter informações sobre como instalar o cliente administrativo do OnDemandpara Windows, consulte o IBM Content Manager OnDemand for i: Common ServerAdministration Guide (SC19-2792).

68 Guia de Planejamento e Instalação

|||

|||||

|||||

||

|

|

|

|

|||||||

Page 87: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parte 5. Configuração e Inicialização do Sistema

Esta parte do manual descreve como configurar o servidor OnDemand para operare suportar sua empresa e para criar e inicializar o banco de dados. Esta partecontém as seguintes sessões:v Capítulo 12, “Criação de uma ocorrência”, na página 71v Capítulo 13, “Definição do Locale”, na página 81v Capítulo 14, “Configuração do Arquivo ARS.CFG”, na página 85v Capítulo 15, “Configuração da Inicialização do Sistema”, na página 89v Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

© Copyright IBM Corp. 2001, 2010 69

Page 88: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

70 Guia de Planejamento e Instalação

Page 89: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 12. Criação de uma ocorrência

Sobre as ocorrênciasUma ocorrência do OnDemand é um ambiente de servidor lógico com sua própriabiblioteca contendo um conjunto exclusivo de arquivos de banco de dados. Umaocorrência é definida no arquivo ARS.INI nomeando a ocorrência (que identifica onome da biblioteca utilizada pela ocorrência). Todos os arquivos de banco dedados pertencentes a uma ocorrência são executados somente em um CCSID.

Você pode executar várias ocorrências no mesmo servidor, cada uma configuradade uma forma:v Para ter ambientes de teste e produção separadosv Para ter bancos de dados utilizando CCSIDs diferentes

Quando você trabalha com mais de uma ocorrência, deve identificar o nome daocorrência ao executar comandos do OnDemand (tais como ADDRPTOND eSTRMONOND).

Cada ocorrência tem segurança diferente das outras ocorrências na mesmamáquina. Defina usuários e grupos para cada ocorrência e permissões de grupo deaplicativos e de pasta para os usuários de cada ocorrência. Cada ocorrência temseu próprio log do sistema.

Cada ocorrência adiciona requer recursos adicionais do sistema, tais como memóriavirtual e espaço em disco, além de administração.

Configuração de uma ocorrênciaExecute as seguintes etapas para criar sua(s) instância(s) do OnDemand:1. Seu perfil do usuário deve ter o código do idioma configurado para aquele da

instância que você deseja criar. Como o código do idioma é configurado noperfil do usuário, pode ser necessário alterar o perfil do usuário, em seguida,desconectar-se e conectar-se novamente antes de criar a instância. Use ocomando Change User Profile (CHGUSRPRF) para alterar (se necessário) seuperfil do usuário. Você também precisa certificar-se de que outros parâmetrosrelacionados ao idioma em seu perfil do usuário estão definidos corretamente.(O comando Change User Profile (CHGUSRPRF) não mostrará a definição dolocale atual; ele mostrará *SAME. Use o comando Display User Profile(DSPUSRPRF) para verificar a definição do locale.) O parâmetro Locale JobAttributes (SETJOBATR) em seu perfil do usuário é utilizado para determinarquais valores são obtidos do locale. Para o OnDemand, no mínimo, você deveutilizar SETJOBATR(*CCSID). Por exemplo, se você estiver nos Estados Unidose estiver utilizando o idioma inglês, insira o comando:CHGUSRPRF USRPRF(nome_do_perfil_do_usuário) LANGID(ENU) CNTRYID(US) CCSID(37)

SETJOBATR(*CCSID *DATFMT *TIMSEP *DATSEP *DECFMT *SRTSEQ)LOCALE('/QSYS.LIB/EN_US.LOCALE')

Se estiver na Espanha e estiver utilizando o idioma espanhol com suporte Euro,insira o comando:CHGUSRPRF USRPRF(nome_do_perfil_do_usuário) LANGID(ESP) CNTRYID(ES) CCSID(1145)

SETJOBATR(*CCSID *DATFMT *TIMSEP *DATSEP *DECFMT *SRTSEQ)LOCALE('/QSYS.LIB/ES_ES.LOCALE')

© Copyright IBM Corp. 2001, 2010 71

|

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

|||

||

|||

Page 90: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Para obter informações adicionais sobre códigos de idioma, consulte oCapítulo 13, “Definição do Locale”, na página 81. Consulte a Tabela 10 napágina 112 para obter uma lista de locales.

2. Nomeie a instância ou use o nome da instância padrão QUSROND. O nome dainstância deve ser um nome de biblioteca válido para o IBM i. O nome dainstância deve iniciar com um caractere alfabético ou @ seguido por qualquerum destes caracteres: 0-9, A-Z, @, # ou sublinhado (_). Certifique-se de que nãoexista nenhuma biblioteca, perfil do usuário ou lista de autorização com essenome. Além disso, o nome da instância não deve iniciar com a letra Q (excetoQUSROND) e não deve ser nomeado CONFIG ou WWW. Esse nome dainstância é chamado de [instância] no restante destas instruções.

3. Crie a instância usando o comando Create Instance forOnDemand(CRTINSTOND). É necessário especificar, pelo menos, o nome dainstância (que usa os valores e padrões do sistema para os parâmetrosadicionais, como *DFT para o parâmetro PORT, que usa a porta 1445). Épossível especificar parâmetros adicionais a fim de customizar a instância paraatender seus requisitos. Por exemplo, é possível especificar um identificador deidioma de três caracteres (usando o parâmetro LANGID) que devecorresponder a um dos identificadores de idioma listados na Tabela 9 na página111. Se você especificar o parâmetro LOCALE, o identificador especificadodeverá estar incluído na lista de códigos de idioma válidos na Tabela 10 napágina 112. Se a instância precisar estar localizada em um Auxiliary StoragePool (ASP) do usuário, o número do ASP do usuário (2 a 32) deverá serespecificado para o parâmetro ASP e *ASP deverá ser especificado para oparâmetro ASPDEV. Se a instância precisar estar localizada em um IndependentAuxiliary Storage Pool (IASP), então *ASPDEV deverá ser especificado para oparâmetro ASP e o nome do IASP (tal como IASP2) deverá ser especificadopara o parâmetro ASPDEV. Por exemplo, o comandoCRTINSTOND INSTANCE(ONDTEST) LANGID(ENU) LOCALE('/QSYS.LIB/EN_US.LOCALE')

criaria uma instância chamada ONDTEST com um idioma de servidor Inglêsdos Estados Unidos, usando a porta TCP/IP 1445.O comando CRTINSTOND executa o seguinte:a. Cria o diretório /CONFIG em /QIBM/UserData/OnDemand e os arquivos

padrão e modelo nesse diretório (se ainda não existirem).b. Anexa o arquivo modelo ARS.INI (no diretório /QIBM/ProdData/

OnDemand/config) ao arquivo real ARS.INI (no diretório/QIBM/UserData/OnDemand/CONFIG) e utiliza o nome da instânciasempre que encontrar [instância] no arquivo modelo.

c. Cria o diretório de instâncias: /QIBM/UserData/OnDemand/[instância]. Sea instância estiver localizada em um ASP Independente, o caminho dodiretório de instâncias será precedido pelo nome do ASP Independente. Porexemplo, se o nome do ASP Independente for IASP, o diretório de instânciasserá criado no diretório /IASP/QIBM/UserData/OnDemand.

d. Cria os arquivos ARS.CFG, ARS.CACHE e ARS.DBFS no diretório/QIBM/UserData/OnDemand/[instância] e utiliza o nome da instânciasempre que encontrar [instância] e o identificador de idioma sempre queencontrar [idioma] no arquivo modelo. (Os arquivos modelo para esses trêsnovos arquivos estão localizados no diretório /QIBM/ProdData/OnDemand/config.) Se a instância estiver localizada em um ASPIndependente, o caminho do diretório de instâncias será precedido pelonome do ASP Independente. Por exemplo, se o nome do ASP Independentefor IASP, os arquivos ARS.CFG, ARS.CACHE e ARS.DBFS serão criados nodiretório /IASP/QIBM/UserData/OnDemand/[instância].

72 Guia de Planejamento e Instalação

|||

||||||||

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

|

||

|

||

||||

|||||

||||||||||

Page 91: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

e. Cria a biblioteca e as tabelas do banco de dados para a instância. Se ainstância estiver localizada em um IASP, você deverá configurar o GrupoASP antes de poder trabalhar com os arquivos nessa biblioteca. Use ocomando Set ASP Group (SETASPGRP) para configurar o Grupo ASP.

f. Cria os diretórios necessários para a instância, conforme especificado nosarquivos ARS.CFG e ARS.CACHE.

g. Cria um perfil do usuário com o mesmo nome que a instância e inclui esseusuário na instância como um Administrador do Sistema OnDemand.

h. Cria uma lista de autorizações com o mesmo nome que a instância.i. Se a instância estiver localizada em um ASP Independente, um registro será

incluído no arquivo QARLCASP na biblioteca QUSRRDARS.

Alterando a Configuração de uma InstânciaPode ser necessário alterar alguns dos parâmetros de configuração a partir dosvalores que você especificou quando executou o comando CRTINSTOND antes deusar essa instância pela primeira vez. Neste caso, você precisará editar o arquivoARS.INI localizado no diretório /QIBM/UserData/OnDemand/config, usando ocomandoEDTF '/QIBM/UserData/OnDemand/CONFIG/ARS.INI'

É possível reconfigurar os valores listados a seguir. A definição da instância iniciacom a linha [@SRV@_[instância]] em que [instância] é o nome da instância. Porexemplo, a instância ONDTEST iniciaria com a linha [@SRV@_ONDTEST].

As seguintes linhas podem precisar ser revisadas:PORT=0. A porta na qual o servidor atende para receber pedidos de um clienteOnDemand. O valor de 0 significa utilizar a porta padrão de 1445. Somente umservidor pode estar atendendo em uma porta específica em um determinadomomento. Para executar múltiplas instâncias simultaneamente, é necessárioespecificar uma porta não usada em seu sistema. É possível executar ocomando Work with TCP/IP Network Sts (WRKTCPSTS) OPTION(*CNN) paraver quais portas estão atualmente em uso no sistema.SRVR_FLAGS_SECURITY_EXIT=1. Especifica que você deseja usar os IDs deusuário e senhas do IBM i como os IDs de usuário e senhas do OnDemand.Este é o valor padrão, o que simplifica para os usuários finais, pois eles nãoprecisam manter várias senhas. Se os usuários do OnDemand não precisaremter IDs de usuário do IBM i, você deverá especificar um valor 0 para esseparâmetro. Ao executar isso, as senhas do OnDemand não têm relacionamentocom as senhas do IBM i. Entretanto, se um ID do usuário do OnDemand e umperfil do usuário do IBM i corresponderem, alguns comandos e APIs doOnDemand usarão o perfil do usuário do IBM i como o ID do usuário doOnDemand, mesmo se você tiver optado por não relacionar os dois. Essasituação poderia permitir que os usuários do IBM i executassem funções doOnDemand que você não pretendia que eles executassem. Portanto, um ID dousuário do OnDemand não deve corresponder a um perfil do usuário do IBM ia menos que os dois IDs sejam usados pelo mesmo indivíduo. Se você fizeruma alteração no valor SRVR_FLAGS_SECURITY_EXIT, deverá revisar osvalores de Parâmetros do Sistema OnDemand (definidos por meio do clienteadministrativo OnDemand) para a instância alterada. Consulte “Relacionamentode IDs do Usuário do OnDemand com Perfis do Usuário do IBM i” na página40 para obter detalhes.HOST=LOCALHOST. Se você estiver ativando o IPv6 em seu sistema IBM i eprecisar que algumas instâncias do OnDemand usem o endereçamento IPv4 e

Capítulo 12. Criação de uma ocorrência 73

||||

||

||

|

||

||

|||||

|

|||

|

|||||||

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

||

Page 92: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

outras usem o endereçamento IPv6, pode ser necessário alterar HOST=LOCALHOSTpara HOST=IPV6-LOCALHOST dentro da sub-rotina ARS.INI para cada instânciaque for usar endereços IPv6. É possível querer que algumas instâncias sejamexecutadas com IPv6 e outras com IPv4. Esse ambiente combinado é totalmentesuportado. Além disso, durante a transição de IPv4 para IPv6, os clientesOnDemand que usam endereços IPv4 podem se conectar ao servidorsimultaneamente com clientes que usam endereços IPv6.

Pode ser necessário alterar alguns dos parâmetros de configuração do ARS.CFG apartir dos valores-padrão, antes de usar essa instância pela primeira vez. Paraexecutar isso, edite o arquivo ARS.CFG localizado no diretório/QIBM/UserData/OnDemand/instancename (em que instancename é o nome dainstância a ser revisada). Por exemplo, você poderia usar o comando Edit FileEDTF '/QIBM/UserData/OnDemand/MYINSTANCE/ARS.CFG'

Se a instância fosse criada em um IASP nomeado IASP2, o comando seriaEDTF '/IASP2/QIBM/UserData/OnDemand/MYINSTANCE/ARS.CFG'

É possível alterar estes valores:ARS_LANGUAGE=ENU. Especifica o idioma no qual essa instância éexecutada. O exemplo mostra o uso do idioma inglês. Os idiomas válidos sãolistados em “Códigos do Idioma” na página 112.ARS_MSGS_LANGUAGE=ENU. Especifica o idioma usado para as mensagensdo servidor. O exemplo mostra o uso do idioma inglês. Os idiomas válidos sãolistados em “Códigos do Idioma” na página 112.ARS_AUTOSTART_INSTANCE=1. Especifica se o servidor deve ser iniciadoautomaticamente, ou não, para essa instância ao usar o comando Start TCP/IPServer (STRTCPSVR). Defina esse valor como 1 para iniciar automaticamente oservidor dessa instância; defina esse valor como 0 se não desejar iniciarautomaticamente o servidor dessa instância. Consulte “Início e Parada dosServidores” na página 75 para obter informações adicionais sobre comocontrolar quais servidores são iniciados automaticamente.

Não modifique os outros valores nesses arquivos de definição de instância semprimeiro consultar o Suporte do OnDemand.

Você deve encerrar e reiniciar o servidor de instâncias após fazer quaisquermudanças.

Exclusão de uma InstânciaPara excluir completamente uma instância, faça o seguinte:1. Se o servidor para a instância já foi iniciado, encerre-o antes de excluir a

instância. Você pode finalizar um servidor específico, seguindo as instruções em“Início e Parada dos Servidores” na página 75.

2. Exclua a biblioteca da instância. Isto pode ser feito emitindo o seguintecomando: DLTLIB LIB([instância]) Ao emitir esse comando, você pode receberuma mensagem indicando que um receptor de diário não foi completamentesalvo. Você pode responder com I para ignorar essa mensagem.

3. Exclua o diretório da instância que está em /QIBM/UserData/OnDemand. Sevocê utilizar o comando WRKLNK, cada diretório deverá estar vazio para quepossa ser excluído. Se houver arquivos em um subdiretório, será necessárioentrar em cada subdiretório na instância para excluir os arquivos e diretóriosdele antes de remover o diretório.

74 Guia de Planejamento e Instalação

|||||||

|||||

|

|

|

|

|||

|||

|||||||

||

||

Page 93: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Nota: O comando WRKLNK pode ser utilizado para excluir recursivamentetodos os objetos em um diretório. Isso pode ser feito emitindo o seguintecomando: WRKLNK '/QIBM/UserData/OnDemand/[instância]' em que[instância] é o nome da instância. Especifique o opção 2 para editar odiretório da instância que deseja excluir. Em seguida, especifique a opção9 para todo diretório listado naquele diretório da instância. Finalmente,pressione F12 para voltar à página anterior e exclua você mesmo odiretório da ocorrência.

4. Exclua a definição da instância dentro do arquivo ars.ini no diretório/QIBM/UserData/OnDemand/config.v Se a instância foi usada com o OnDemand Web Enablement Kit (ODWEK),

remova qualquer referência à instância do arquivo arswww.ini no diretório/QIBM/UserData/OnDemand/www. Se você estiver utilizando suporte aoCGI multilíngüe, o nome do diretório será /QIBM/UserData/OnDemand/www/[ccsid], em que ccsid é o CCSID necessário. Se você estiver usando oWebSphere Application Server V6, o nome do diretório será/QIBM/UserData/WebSphere.

5. Exclua a lista de autorização da instância. Isto pode ser feito emitindo oseguinte comando: DLTAUTL AUTL[instância] em que [instância] é o nome dainstância que você está excluindo.

6. Se você criou uma instância em um ASP Independente, entre em contato com osuporte de software IBM para discutir as etapas para excluir o registro dainstância do QUSRRDARS.

7. Você deve excluir o perfil do usuário da instância (que possui um nomecorrespondente ao nome da instância), porém verifique se o perfil do usuárionão pertence aos objetos que ainda serão necessários depois que a instância forexcluída. Utilize o comando Work with Objects by Owner (WRKOBJOWN),especificando o nome da instância para o parâmetro de perfil do usuário(USRPRF) para revisar objetos pertencentes ao perfil de usuário da instância.Exclua cada objeto ou altere o proprietário para um perfil de usuário diferente.

Início e Parada dos ServidoresÉ necessário iniciar um servidor de uma instância antes que os clientes possamconectar-se à instância.

Iniciando os ServidoresOs servidores são iniciados usando o comando STRTCPSVR *ONDMD. Oparâmetro INSTANCE do comando STRTCPSVR *ONDMD suporta os valoresespeciais *DFT, *ALL e *AUTOSTART, bem como a especificação do nome de umainstância. (Uma instância será configurada para autoinicialização se o arquivoars.cfg para essa instância contiver ARS_AUTOSTART_INSTANCE=1.) Ovalor-padrão para o parâmetro INSTANCE é *DFT. Você também pode criar umaárea de dados nomeada STRTCPSVR para controlar melhor o comportamento docomando STRTCPSVR. Consulte o Content Manager OnDemand for i: CommonServer Administration Guide para obter mais detalhes sobre a área de dados.

Sem a área de dados STRTCPSVR, os valores *DFT e *AUTOSTART funcionam deforma idêntica. Todas as instâncias configuradas para autoinicialização sãoiniciadas. O uso do valor especial *ALL iniciará todas as instâncias configuradas nosistema. Você também pode especificar o nome de uma única instância a seriniciada, por exemplo: STRTCPSVR SERVER(*ONDMD) INSTANCE(ONDTEST).

Capítulo 12. Criação de uma ocorrência 75

|||

|

||

|

|||||||||

|||||

Page 94: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Com a área de dados, o valor *DFT iniciará apenas a instância nomeada na área dedados. A área de dados deve ser nomeada STRTCPSVR e localizada na bibliotecaQUSRRDARS. A área de dados deve ser do tipo caractere com um comprimento de10. Para criar a área de dados, use o comando: CRTDTAARADTAARA(QUSRRDARS/STRTCPSVR) TYPE(*CHAR) LEN(10)VALUE(QUSROND) TEXT('Nome da instância de autoinicialização paraSTRTCPSVR *ONDMD *DFT'), em que QUSROND é o nome da instância a seriniciada.

Os valores especiais *ALL e *AUTOSTART funcionam de forma idêntica tanto coma área de dados como sem a área de dados.

Para determinar quais instâncias são iniciadas quando STRTCPSVRSERVER(*ONDMD) INSTANCE(*AUTOSTART) é executado, é possível procurarpor ARS_AUTOSTART_INSTANCE=1 no arquivo ARS.CFG. Entretanto, há umamaneira mais fácil, para que você não tenha que verificar o arquivo ARS.CFG paracada instância.

Use o comandogrep

em qshell para pesquisar o conteúdo de todos os arquivos ARS.CFG para a cadeiaARS_AUTOSTART_INSTANCE=1. Por exemplo:$grep -n 'ARS_AUTOSTART_INSTANCE=1' /qibm/userdata/ondemand/*/ars.cfg/qibm/userdata/ondemand/ONDDEMO/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1/qibm/userdata/ondemand/ONDDEU/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1/qibm/userdata/ondemand/ONDENU/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1/qibm/userdata/ondemand/QUSROND/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1$

A partir da saída desse comando, é possível determinar que as instânciasONDDEMO, ONDDEU, ONDENU e QUSROND serão iniciadas quandoSTRTCPSVR SERVER(*ONDMD) INSTANCE(*AUTOSTART) for executado.

A tabela a seguir resume o comportamento do comando STRTCPSVR com e sem aárea de dados STRTCPSVR.

Tabela 7. Comando STRTCPSVR com e sem a Área de Dados STRTCPSVR

*DFT *ALL *AUTOSTART Instância Nomeada

Sem a área de dados,a execução deSTRTCPSVR inicia:

Todas as instânciasconfiguradas paraautoinicialização

Todas as instânciasconfiguradas nosistema

Todas as instânciasconfiguradas paraautoinicialização

A instância nomeada

Com a área de dados,a execução deSTRTCPSVR inicia:

Apenas a instâncianomeada na área dedados

Todas as instânciasconfiguradas nosistema

Todas as instânciasconfiguradas paraautoinicialização

A instância nomeada

Parando os ServidoresOs servidores são parados usando o comando ENDTCPSVR *ONDMD. Oparâmetro de instância do comando STRTCPSVR *ONDMD suporta os valoresespeciais *DFT e *ALL, bem como a especificação do nome de uma instância. Ovalor-padrão para o parâmetro INSTANCE é *DFT. Você também tem a opção decriar uma área de dados nomeada STRTCPSVR para controlar melhor ocomportamento do comando ENDTCPSVR. Crie a área de dados conforme descritoacima. Consulte o Content Manager OnDemand for i: Common Server

76 Guia de Planejamento e Instalação

||||||||

||

|||||

|

|

||

|||||||

|||

||

||

|||||

|||

|||

|||

|||

|

|||

|||

|||

|||

|

|

|

|||||||

Page 95: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Administration Guide para obter mais detalhes sobre a área de dados. Observeque, mesmo que a área de dados esteja nomeada como STRTCPSVR, ela controlaambos os comandos, STRTCPSVR e ENDTCPSVR. Isso é, por design, para que o*DFT inicie e termine a mesma instância.

Sem a área de dados STRTCPSVR, os valores *DFT e *ALL funcionam de formaidêntica. Todas as instâncias ativas são terminadas. Você também pode especificaro nome de uma única instância a ser terminada, por exemplo: ENDTCPSVRSERVER(*ONDMD) INSTANCE(ONDTEST).

Com a área de dados, o valor *DFT termina apenas a instância nomeada na áreade dados. A área de dados deve ser nomeada STRTCPSVR e localizada nabiblioteca QUSRRDARS.

A tabela a seguir resume o comportamento do comando ENDTCPSVR com e sem aárea de dados STRTCPSVR.

Tabela 8. Comando ENDTCPSVR com e sem a Área de Dados STRTCPSVR

*DFT *ALL Instância Nomeada

Sem a área de dados,ENDTCPSVR termina:

Todas as instâncias ativas Todas as instâncias ativas A instância nomeada é

Com a área de dados,ENDTCPSVR termina:

Apenas a instâncianomeada na área de dados

Todas as instâncias ativas A instância nomeada é

Gerenciamento de Trabalho do ServidorAs tarefas do servidor são iniciadas usando uma descrição de tarefa pelo nome dainstância (que deve estar localizado na biblioteca de instâncias). Se uma descriçãode tarefa com esse nome não for localizada na biblioteca de instâncias, a descriçãode tarefa QOND400 na biblioteca QRDARS será usada (e poderá ser alterada, senecessário).

A descrição do job controla os seguintes atributos de job do servidor:v JOBQv JOBPTYv OUTPTYv PRTDEVv OUTQv INLLIBLv LOGv LOGCLPGMv INQMSGRPYv HOLDv DATEv SWSv JOBMSGQMXv JOBMSGQFL

Por exemplo, se você desejar alterar a fila de tarefas usada pela instância TEST, crieuma descrição de tarefa chamada TEST na biblioteca TEST que especifique a fila detarefas a ser usada.

Capítulo 12. Criação de uma ocorrência 77

||||

||||

|||

||

||

||||

|||||

||||||

|

|

|||||

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|

|||

Page 96: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Para alterar a prioridade de execução das tarefas do servidor, você deve incluiruma entrada de roteamento para o subsistema. A tarefa do servidor é sempresubmetida com os dados de roteamento QRLMSERVER. Para alterar a prioridadede execução de todas as tarefas do servidor de todas as instâncias para 40, vocêpoderia incluir a seguinte entrada de roteamento para o subsistema QSYSWRK. (Énecessário escolher um número de sequência (SEQNBR) que ainda não esteja emuso.)ADDRTGE SBSD(QSYSWRK) SEQNBR(1841) CMPVAL(QRLMSERVER) PGM(QSYS/QCMD)

CLS(QSYS/QSYSCLS40)

Após fazer essa mudança, você deve parar e reiniciar todos os seus servidores.

Início Automático de InstânciasPara permitir que uma instância seja iniciada automaticamente sempre que osistema reiniciar, inclua um dos comandos descritos em “Início e Parada dosServidores” na página 75 no programa QSTRUP. É possível também incluir oscomandos em um programador de jobs.

Conexão com Instâncias

Conexão a partir de Clientes do OnDemandPara fazer conexão com uma determinada instância o cliente deve iniciar sessão noservidor utilizando a porta correta. Utilize a caixa de diálogo Atualizar servidorespara incluir servidores no cliente. Ao incluir um servidor, identifique o nome doservidor, o número da porta e o protocolo de comunicação utilizado paracomunicar-se com o servidor. O número da porta especificado na caixa de diálogoAtualizar servidores deve ser igual ao valor especificado para a instância noarquivo ARS.INI.

Como Trabalhar com InstânciasO OnDemand oferece comandos que você pode utilizar para trabalhar com umainstância. Por exemplo, o OnDemand fornece comandos para adicionar, remover eimprimir arquivos em spool e outros tipos de dados e para gerenciar oarmazenamento. Na maioria do comandos do OnDemand, um dos parâmetros quevocê pode especificar para um comando é o nome da instância Por padrão, se vocênão especificar um nome, o nome da instância será QUSROND. Se você der à suaúnica instância um nome diferente de QUSROND ou se trabalhar com mais deuma instância, sempre especifique o nome da instância ao executar um comando.Dessa forma é possível certificar-se de que você está trabalhando com a instânciacorreta.

Consulte o IBM Content Manager OnDemand for i: Common Server AdministrationGuide, apêndice intitulado “Command reference”, para obter informaçõesadicionais sobre os comandos do OnDemand.

O OnDemand também fornece APIs que você pode utilizar para trabalhar comuma instância.

A API ARSLOAD utiliza o parâmetro –I instance. O OnDemand recupera o nomedo servidor associado à instância a partir do arquivo ARS.INI. Por exemplo(utilizando o QSHELL):

arsload -I TEST -d /test/file1 -c /test/file2

78 Guia de Planejamento e Instalação

|||||||

||

|

Page 97: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

em que TEST é o nome da instância. No exemplo, o parâmetro PORT da seção[@SRV@_TEST] do arquivo ARS.INI identifica o servidor.

A API ARSDOC fornece o identificador -h para especificar o nome da instância.

O exemplo a seguir mostra como executar os programas no QSHELL,especificando o nome da instância:

/arsdoc get -h TEST -F parmfile

em que TEST é o nome da instância. No exemplo, o OnDemand utiliza o parâmetroPORT na seção [@SRV@_TEST] do arquivo ARS.INI para identificar o servidor.

Consulte o IBM Content Manager OnDemand for i: Common Server AdministrationGuide, apêndice intitulado “API and user exit reference”, para obter informaçõesadicionais sobre as APIs do OnDemand.

Capítulo 12. Criação de uma ocorrência 79

Page 98: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

80 Guia de Planejamento e Instalação

Page 99: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 13. Definição do Locale

O OnDemand requer a especificação de um locale para cada instância do CommonServer, para assegurar que os dados tenham o identificador de idioma corretoassociado a eles durante o processo do arquivamento. As etapas descritas a seguirdevem ser executadas para cada instância do OnDemand para que o servidordessa instância possa ser iniciado. Mesmo que você esteja executando um sistemaem inglês americano, ainda será necessário executar essas etapas. Algumas dessasetapas também foram discutidas no Capítulo 12, “Criação de uma ocorrência”, napágina 71, porém são incluídas novamente aqui para complementação.

A IBM envia uma série de objetos de locale (tipo de objeto *LOCALE) na bibliotecaQSYS. Outros são fornecidos como código fonte que devem ser criados utilizandoo comando CRTLOCALE. (Os nomes de locale seguidos por um asterisco (*) natabela de valores de locale em “Códigos do Idioma” na página 112 devem sercriados utilizando o comando CRTLOCALE.) Se o código de idioma necessárioprecisar ser criado a partir do código de origem, você deverá instalar a opção 21do IBM i (Suporte Estendido ao NLS; uma opção de produto 5770-SS1), quecontém todos os arquivos de origem de código de idioma fornecidos pela IBM. Sevocê precisar de um código de idioma não fornecido pela IBM (nenhuma origemou objeto), será necessário copiar e modificar um código de idioma existente paraatender suas necessidades. A assistência para fazer isso pode ser obtida daorganização de suporte IBM em sua região.

Consideração Importante sobre Códigos de IdiomaO perfil do usuário com o mesmo nome da instância E todos os perfis do usuárioque executam as funções de carregamento de dados do OnDemand (comoADDRPTOND, STRMONOND, arsload ou arsdoc add) devem ter seu localedefinido para o locale da instância.

Importante: Se os perfis de usuário que executam as funções de carregamento dedados do OnDemand também forem usados para outro trabalho não OnDemandem seu sistema, alterar o valor de LOCALE poderá impactar outros aplicativos nãoOnDemand. Em vez disso, considere a criação de perfis do usuário específicos doOnDemand para o carregamento de dados, de modo a não impactar os outrosaplicativos e, em seguida, modifique somente o valor LOCALE para os perfis dousuário específicos do OnDemand. Se necessário, altere o locale dos perfis dousuário utilizando o comando CHGUSRPRF (Alterar Perfil do Usuário). Vocêtambém precisa certificar-se de que outros parâmetros relacionados ao idioma nosperfis de usuário estejam configurados corretamente. O parâmetro SETJOBATR éutilizado para determinar quais valores são obtidos do locale. Para o OnDemand,no mínimo, você deve utilizar SETJOBATR(*CCSID). Por exemplo, se você estiver naEspanha e estiver utilizando o idioma espanhol com suporte Euro, insira ocomando:CHGUSRPRF USRPRF(nome_do_perfil_do_usuário) LANGID(ESP) CNTRYID(ES)

CCSID(1145) SETJOBATR(*CCSID *DATFMT *TIMSEP *DATSEP *DECFMT*SRTSEQ) LOCALE('/QSYS.LIB/ES_ES_E.LOCALE')

Após configurar o código do idioma correto em um perfil do usuário do IBM i,você poderá optar por copiar esse perfil do usuário para criar um outrosemelhante para ser usado com o OnDemand. A função de cópia do IBM i nãocopia o valor de parâmetro LOCALE. Depois que a cópia estiver concluída, você

© Copyright IBM Corp. 2001, 2010 81

|

||||

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

|||

||||

Page 100: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

deve emitir o comando CHGUSRPRF, como mostrado anteriormente para definir oLOCALE. Você pode utilizar o comando Display User Profile (DSPUSRPRF) paraexibir ou verificar o locale de um perfil do usuário existente.

Se você não tiver um código de idioma configurado no perfil do usuário usadopara carregar dados, a tarefa de carregamento falhará. O log da tarefa do qshell,QP0ZSPWP, contém a mensagem de erro É NECESSÁRIO CONFIGURAR UM CÓDIGO DEIDIOMA.

Etapas a Serem Executadas Após Configurar Códigos de IdiomaAs instruções descritas no Capítulo 12, “Criação de uma ocorrência”, na página 71descrevem as etapas necessárias para criar, iniciar e acessar com êxito uma novainstância do OnDemand Common Server.

Se você encontrar problemas ao tentar criar uma instância do OnDemand CommonServer, consulte a lista de problemas, causas e recuperações, a seguir. Se precisar deassistência adicional, entre em contato com a organização de suporte ao softwareem sua região.

Resolvendo ProblemasA seguinte lista inclui alguns dos problemas relacionados a locale que você podeencontrar ao criar uma instância ou arquivar dados. É descrita a causa de cadapossível problema e são explicadas as etapas para recuperar de um problema.

Problema: Aparece a mensagem: CPFA0A9 Objeto não encontrado. LOCALE/QSYS.LIB/EN_GB_E.LOCALE NOT FOUND

Causa: Você especificou um locale que não existe no sistema.

Recuperação: Especifique um locale que existe no sistema ou crie o localenecessário, utilizando o comando CRTLOCALE.

Problema: Você recebe a mensagem: OND1005 A instância MYINSTANCE do OnDemandnão foi criada. O log da tarefa do qshell também contém OND0588 É necessárioconfigurar um código de idioma.

Causa: Você não especificou um locale no perfil do usuário criando a instância ounão desconectou-se e conectou-se novamente depois de alterar o perfil do usuáriopara especificar um locale.

Recuperação: Exclua os diretórios do IFS criados para a instância. Exclua o perfildo usuário da instância. Exclua a lista de autorização da instância.

Problema: Os dados não serão carregados no OnDemand. Não há uma mensagemde log do sistema indicando a causa da falha. O log da tarefa para a tarefa decarregamento não contém uma mensagem de erro específica.

Causa: Não há um locale especificado no perfil do usuário que executa o job decarregamento.

Recuperação: Verifique o log da tarefa do qshell, QP0ZSPWP, quanto à mensagemde erro OND0588 É necessário configurar um código de idioma.. Se o log datarefa contiver essa mensagem, será necessário alterar o perfil do usuário que estáexecutando a tarefa de carregamento para especificar um código de idioma.

82 Guia de Planejamento e Instalação

|||

||||

|||

Page 101: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Problema: Falha no arquivo em spool ao arquivar. O log do sistema contém amensagem 88, incluindo texto semelhante ao seguinte Linha 1: a cadeia "0/12/11" não pôde ser convertida em uma data de formato %m/%d/%y. Verifique aguia Carregar Informações na definição do aplicativo e verifique se o formato dedata é especificado como %y/%m/%d e se os espaços iniciais serão removidos.

Causa Provável: O perfil do usuário que está arquivando os dados possui umlocale especificado, mas esse locale não é compatível com a instância para a qualos dados estão sendo carregados. Por exemplo, especificar um locale tcheco, mastentar arquivar dados em inglês americano causará esse tipo de falha. Observe queé possível, de fato, ter um erro de definição de data efetiva, mas é provável que eleesteja relacionado a códigos de idioma se você já tiver verificado que asinformações de data estão corretas.

Recuperação: Especifique um código de idioma no perfil do usuário que estáarquivando os dados que são compatíveis com a instância na qual os dados estãosendo arquivados.

Capítulo 13. Definição do Locale 83

Page 102: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

84 Guia de Planejamento e Instalação

Page 103: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 14. Configuração do Arquivo ARS.CFG

Quando você executa os diversos programas do OnDemand, eles obtêminformações do arquivo ARS.CFG sobre várias definições de configuração. Asinformações incluem a definição de idioma do banco de dados e a localização dosdiretórios de configuração e de área de trabalho temporários, por exemplo. Antesde começar a utilizar o OnDemand, revise os parâmetros no arquivo ARS.CFG. Amaioria dos valores que a IBM fornece são suficientes para muitos clientes.Entretanto, pode ser necessário alterar alguns dos valores para seu ambiente. Sevocê efetuar alterações no arquivo ARS.CFG durante a execução do sistema, énecessário encerrar e reiniciar o servidor para que o OnDemand possa utilizarqualquer valor que você modifique.

Para alterar o arquivo ARS.CFG, inicie sessão como QSECOFR. Emita o comandoWRKLNK e altere para o diretório /QIBM/UserData/OnDemand/<instância>, em que<instância> é o nome da instância do OnDemand. O nome da instância padrão éQUSROND. Faça uma cópia de backup dos arquivos fornecidos pela IBM. Edite oarquivo ARS.CFG utilizando a Opção 2 (Editar) na tela WRKLNK.

Parâmetro ARS_AUTOSTART_INSTANCEPadrões para 1 (o que significa SIM, inicia automaticamente este servidor deinstâncias) para instância QUSROND. Padrões para 0 (o que significa NÃO, nãoinicia automaticamente este servidor de instâncias) para todas as outras instâncias.Quando você criar uma nova instância (diferente de QUSROND), as tarefas doservidor para essa instância não serão iniciadas automaticamente por meio daemissão de STRTCPSVR SERVER(*ONDMD) INSTANCE(*AUTOSTART) a menosque o valor desse parâmetro seja alterado de 0 para 1.

Se optar por não autoinicializar o servidor de uma instância, você poderá iniciar oservidor manualmente. Consulte “Início e Parada dos Servidores” na página 75para obter informações adicionais sobre como iniciar e parar seus servidores deinstâncias.

Parâmetro ARS_LANGUAGEO ambiente no idioma nacional utilizado para criar o banco de dados. OOnDemand utiliza um código de idioma de três caracteres para derivar o locale e oconjunto de códigos para o sistema operacional do servidor. Consulte oApêndice B, “Suporte ao Idioma Nacional”, na página 109 para obter uma lista doscódigos de idiomas e informações sobre a configuração do sistema para suporte acaracteres no idioma nacional.

Importante: Forneça o código de idioma correto para seu ambiente operacionalantes de criar o banco de dados da instância do OnDemand.

Parâmetro ARS_MSGS_LANGUAGESe desejar algo diferente do inglês para as mensagens do servidor, altere esseparâmetro no arquivo ars.cfg para a instância e especifique o ID do idioma de trêscaracteres que você deseja usar. Para ver uma lista de valores de ID do idiomaválidos, consulte os nomes de diretório em /QIBM/ProdData/OnDemand/localeno servidor IBM i após instalar o OnDemand.

© Copyright IBM Corp. 2001, 2010 85

Page 104: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parâmetro ARS_MESSAGE_OF_THE_DAYUtilize especificar a mensagem do dia para o cliente OnDemand. Defina um nomede caminho completo de um arquivo que contém a mensagem que você deseja queo cliente exiba. Por exemplo:ARS_MESSAGE_OF_THE_DAY=/QIBM/ProdData/OnDemand/tmp/message.txt

O conteúdo do arquivo de mensagem pode conter no máximo 1024 caracteres detexto. O cliente administrativo e o cliente do usuário final mostram a mensagemapós o usuário se conectar ao servidor. Para fechar a caixa de mensagens econtinuar, o usuário deve clicar OK. Se um arquivo de mensagem não forespecificado, ocorre o processamento normal do cliente.

Parâmetro ARS_NUM_DBSRVRDetermina o número de processos que o OnDemand inicia no servidor para tratarconexões com o banco de dados. O valor padrão é 5 (cinco). Consulte oApêndice A, “Servidores de Banco de Dados”, na página 107 para obterinformações adicionais sobre este parâmetro.

Parâmetro ARS_SUPPORT_CFSODPara usar o Content Federation Services para OnDemand, esse parâmetro deve serconfigurado para 1. Consulte o documento em http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101378 para obter detalhes adicionais sobre aconfiguração e o uso do Content Federation Services.

Parâmetro ARS_SUPPORT_HOLDPar usar o gerenciamento de retenção aprimorada, esse parâmetro deve serconfigurado para 1. Consulte o documento em http://www.ibm.com/support/techdocs/atsmastr.nsf/WebIndex/WP101378 para obter detalhes adicionais sobre aconfiguração e o uso de gerenciamento de retenção aprimorada.

Parâmetro ARS_TMPA localização na qual programas do OnDemand armazenam dadostemporariamente. Aloque espaço livre suficiente no sistema de arquivosespecificado para suportar tarefas tais como migração e importação de dados deíndice. O valor padrão é: /QIBM/UserData/OnDemand/<instância>/tmp (em que<instância> é o nome da instância do OnDemand).

Parâmetro ARS_PRINT_PATHA localização na qual a função de impressão do OnDemand armazenatemporariamente dados de impressão. Certifique-se de que exista espaço suficientena localização especificada para conter os arquivos de impressão para o númeromáximo de pedidos de impressão simultâneos com o qual o servidor trabalha. Ovalor padrão é: /QIBM/UserData/OnDemand/<instância>/tmp (em que <instância> éo nome da instância do OnDemand).

86 Guia de Planejamento e Instalação

|

||||

|

||||

Page 105: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parâmetro ARSSOCK_RESOLVE_CLIENT_NAMESe você estiver encontrando tempos de reposta de logon mais longos que o normalem um ambiente DHCP, a inclusão da seguinte linha no arquivo ARS.CFG poderácorrigir o problema:ARSSOCK_RESOLVE_CLIENT_NAME=0

Capítulo 14. Configuração do Arquivo ARS.CFG 87

Page 106: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

88 Guia de Planejamento e Instalação

Page 107: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 15. Configuração da Inicialização do Sistema

Esta seção fornece informações sobre as funções do servidor que você podeescolher para serem iniciadas automaticamente sempre que o sistema for iniciado.

Modifique o programa QSTRUP do sistema operacional para emitirautomaticamente comandos do servidor sempre que este for reiniciado.

Para executar uma possível inclusão no programa QSTRUP:v Inicie os jobs do servidor OnDemandv Inicie os monitores de fila de saída do OnDemand

Iniciar os Jobs do ServidorO exemplo a seguir mostra o comando que inicia os jobs do servidor OnDemand.Para mais detalhes e opções de início e parada dos servidores, consulte o “Início eParada dos Servidores” na página 75.STRTCPSVR SERVER(*ONDMD)

Iniciar os Monitores de Fila da SaídaUtilize o comando Start Monitor for OnDemand (STRMONOND) para iniciar osmonitores de fila de saída do OnDemand para filas de saída que receberão osarquivos em spool destinados ao OnDemand. Revise o texto da ajuda on-line paradeterminar os parâmetros específicos que você deseja especificar para cadamonitor.

Também é possível criar definições de monitor usando o plug-in OnDemandArchive do IBM i Navigator. Após iniciar o IBM i Navigator, selecione OnDemandArchive, em seguida, use Definições de Monitor sob Administração do CommomServer. Essas definições de monitor permite predefinir os parâmetros deinicialização do monitor e especificar uma forma de automatizar o início dosmonitores.

Consulte “Loading spooled file data” no IBM Content Manager OnDemand for i:Common Server Administration Guide para obter informações adicionais sobremonitores de fila de saída.

Depois, é possível encerrar o monitor, se desejado, usando o comando EndMonitor for OnDemand (ENDMONOND) ou configurando as condições paraencerramento quando emitir o comando STRMONOND ou configurar a definiçãode monitor usando o IBM i Navigator, conforme descrito acima.

© Copyright IBM Corp. 2001, 2010 89

Page 108: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

90 Guia de Planejamento e Instalação

Page 109: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 16. Planejamento de Programas de Manutenção

Esta seção descreve os comandos de manutenção do OnDemand a seremexecutados automaticamente de forma regular. Os programas de manutenção quetalvez você queira executar em um planejamento regular incluem aqueles quemantêm o dado do grupo de aplicativos no banco de dados e no disco e mantêmdados do sistema OnDemand no banco de dados.

Importante: A maior parte dos programas de manutenção deve ser executadaquando não houver outros programas atualizando o banco de dadosou exigindo acesso exclusivo ao banco de dados. Por exemplo, vocênão deve carregar os dados (ADDRPTOND, STRMONOND, arsload,arsdoc add) ao mesmo tempo em que executa o comando demanutenção de armazenamento em disco (STRDSMOND). Noentanto, o comando STRASMOND pode ser executado enquanto osdados estiverem sendo arquivados no OnDemand. Os backups nãodevem ser feitos enquanto os comandos STRDSMOND eSTRASMOND ou o carregamento de dados estiver sendo executado.

O horário e a freqüência com os quais os comandos de manutenção eas opções de processamento especificadas são executados variam,dependendo do seu ambiente. Por exemplo, se você não carregadados todos os dias, ou se inclui algumas linhas no banco de dadosao carregar dados, pode programar a manutenção com menorfreqüência, talvez uma vez por semana. No entanto, se você carregarum volume alto de dados todos os dias, deverá manter o banco dedados depois de concluir o processamento de carregamento. Se o seusistema tiver bastante espaço disponível em disco para armazenar odado do índice e relatórios, os programas de manutenção poderão serplanejados com menos frequência.

Os exemplos a seguir ilustram um método de manutenção diária. Osexemplos utilizam opções típicas para manter o banco de dados e oarmazenamento em disco e criam imagens de backup completo dobanco de dados. Os programas de manutenção são programados paraserem executados pela manhã cedo, antes de os usuários começarem aacessar o sistema. Esse planejamento supõe que todo o carregamentode dados é concluído antes do início dos programas de manutenção.Utilize os exemplos como guia.

Manutenção de Dados do Grupo de Aplicativos

Nota: O servidor OnDemand deve ser executado, caso contrário os comandos demanutenção falham.

Você pode utilizar os comandos STRDSMOND e STRASMOND para manter dadosdo grupo de aplicativos no banco de dados e no armazenamento em disco e emarchive. Esses comandos de manutenção determinam as ações a serem tomadas apartir de parâmetros que você especifica e recuperando informações de degerenciamento de armazenamento a partir de grupos de aplicativos. Os comandospodem fazer o seguinte para os grupos de aplicativos:

© Copyright IBM Corp. 2001, 2010 91

Page 110: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v Copiar dados de relatório do armazenamento em disco para o armazenamentoem archive

v Expirar dados de relatório do armazenamento em disco e do armazenamento emarchive

v Migrar dados de índice do banco de dados para o armazenamento em archive(se necessário, apesar de não ser recomendado).

v Expirar dados de índice do banco de dados

Normalmente você planeja essas ações nos comandos de manutençãoregularmente. Se sua empresa carrega um grande volume de dados no sistematodos os dias, recomendamos que você planeje a execução dos comandos após ofim do processo de carregamento. Para volumes baixos a médios, você poderiaoptar por executar os comandos de manutenção semanalmente. Programe aexecução dos comandos durante um período de pouca um nenhuma atividade nosistema.

Consulte o IBM Content Manager OnDemand for i: Common Server AdministrationGuide para obter informações adicionais sobre os comandos STRDSMOND eSTRASMOND.

Backup do Banco de Dados do OnDemandApós terminar o carregamento dos dados no OnDemand e a manutenção do bancode dados, recomendamos que você crie uma imagem de backup do banco dedados do OnDemand. A imagem de backup pode ser utilizada para recuperar obanco de dados, no caso de falha no hardware ou se os dados do aplicativo foremdanificados. Se você processa vários carregamentos todos os dias, então convémfazer backup do banco de dados uma vez ao dia, após o último processo decarregamento ser concluído.

Consulte o Capítulo 21, “Backup dos dados do OnDemand”, na página 105 e oIBM Content Manager OnDemand for i: Common Server Administration Guide paraobter informações adicionais sobre como fazer backup dos dados do OnDemand.

92 Guia de Planejamento e Instalação

Page 111: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Parte 6. Preparação do Sistema para Utilização

Esta seção do manual descreve como verificar a instalação do OnDemand. Outrastarefas importantes descritas nesta seção incluem:v Definição de políticas de migração e de conjuntos armazenamento. É necessário

incluir políticas de migração e de conjuntos armazenamento no sistema para queseja possível criar grupos de aplicativos ou atribuir os grupos de aplicativosdefinidos pelo sistema a um conjunto de armazenamento. Dependendo dascaracterísticas do gerenciamento de armazenamento dos relatórios que vocêplaneja armazenar no sistema, pode ser necessário incluir mais de uma políticade migração e conjunto de armazenamento.

v Configuração do grupo de aplicativos de log do sistema. A IBM recomenda quevocê designe o grupo de aplicativos de Log do Sistema a um conjunto dearmazenamento que especifique a mídia de archive (como conjunto de discos,ótica ou fita) para que o sistema possa manter uma cópia permanente dos dadosdo log do sistema.

v Configuração do grupo de aplicativos de migração do sistema. Se você pretendemigrar dados de índice do banco de dados para o armazenamento em archive,crie um conjunto de armazenamento que especifica mídia de arquivamento.Após incluir o conjunto de armazenamento no sistema, atribua o grupo deaplicativos Migração do sistema no conjunto de armazenamento. A migração dedados de índice do banco de dados para o armazenamento em archive não érecomendada.

v Criação de uma cópia de backup do banco de dados. Após instalar e configuraro OnDemand, a IBM recomenda que seja criada uma cópia de backup do bancode dados do OnDemand.

© Copyright IBM Corp. 2001, 2010 93

Page 112: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

94 Guia de Planejamento e Instalação

Page 113: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 17. Verificação da Instalação1. Conclua todas as etapas obrigatórias do Capítulo 11, “Instalação do Software

do Servidor OnDemand”, na página 67.2. Conclua todas as etapas obrigatórias do Parte 5, “Configuração e Inicialização

do Sistema”, na página 69.3. Se esse procedimento não tiver sido feito, instale o programa do cliente

OnDemand em uma estação de trabalho. Consulte o IBM Content ManagerOnDemand: Guia do Usuário para obter detalhes.

4. Inicie o programa do cliente OnDemand. O OnDemand exibe a caixa dediálogo Iniciar sessão no servidor.

5. Clique em Atualizar servidores. O OnDemand exibe a caixa de diálogoAtualizar servidores.

6. Digite o nome do servidor do OnDemand. Clique em Ajuda para obterinformações sobre campos e opções.

7. Clique em Adicionar e depois em Fechar para retornar à caixa de diálogoIniciar sessão no servidor.

8. Selecione o nome do servidor incluído na caixa de diálogo Atualizarservidores, se ainda não estiver selecionado.

9. Digite um ID do usuário e uma senha do OnDemand nos campos fornecidos.Ao iniciar a sessão no sistema pela primeira vez, é necessário especificar o IDdo usuário interno do OnDemand, QONDADM. Inicialmente, a senha é QONDADM1.No entanto, será solicitado que você insira e verifique uma nova senha.)

10. Pressionar Enter.11. Abra e procure na pasta Log do sistema.

Se for possível exibir mensagens armazenadas no log do sistema, a instalação doOnDemand terá sido bem sucedida.

Se o programa do cliente não iniciar, verifique a unidade, o nome do caminho e onome do programa utilizados para iniciar o programa. Em seguida, tente ocomando novamente.

Se o programa do cliente emitir uma mensagem indicando um problema, executeas instruções da janela de mensagem. Se o problema persistir, entre em contatocom o centro de suporte da IBM a fim de obter ajuda para resolver o problema.

© Copyright IBM Corp. 2001, 2010 95

Page 114: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

96 Guia de Planejamento e Instalação

Page 115: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 18. Definição de políticas de migração e conjuntosde armazenamento

Defina políticas de migração e conjuntos de armazenamento para que possadeterminar relatórios para o OnDemand ou carregar dados no sistema.

Você pode configurar o OnDemand para copiar dados para o armazenamento emdisco ou em archive (ou ambos). Os atributos de gerenciamento do armazenamentodos grupos de aplicativos incluídos no sistema determinam os tipos de mídianecessários e como configurar conjuntos de armazenamento no sistema.

O conjunto de armazenamento deve conter no mínimo um local dearmazenamento principal. Um local de armazenamento primário pode usararmazenamento em disco (o padrão) ou especificar a mídia de armazenamento dearchive, como conjunto de discos, ótica ou fita. A ajuda on-line do clienteadministrativo fornece detalhes sobre a definição de características dearmazenamento. Consulte também o IBM Content Manager OnDemand for i: CommonServer Administration Guide para obter informações adicionais sobre políticas demigração e conjuntos de armazenamento.

Apesar de não ser recomendado, se você pretende migrar dados de índice para oarmazenamento em archive, atribua o grupo de aplicativos Migração do sistema aum conjunto de armazenamento que especifica armazenamento em archive.Recomendamos também que você atribua o grupo de aplicativos Log do sistema aum conjunto de armazenamento que especifique o armazenamento em archivepara que o sistema possa manter uma cópia permanente dos dados gravados nolog do sistema. Os tópicos a seguir fornecem detalhes adicionais:v Capítulo 19, “Configuração do Grupo de Aplicativos do Log do Sistema”, na

página 99v Capítulo 20, “Configuração do Grupo de Aplicativos de Migração do Sistema”,

na página 103

© Copyright IBM Corp. 2001, 2010 97

Page 116: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

98 Guia de Planejamento e Instalação

Page 117: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 19. Configuração do Grupo de Aplicativos do Log doSistema

Quando você instala e configura o OnDemand, inicializa o log do sistema. O logdo sistema é consiste no grupo de aplicativos de Log do sistema, em um conjuntode aplicativos de Log do sistema e na pasta de Log do sistema. O grupo deaplicativos de Log do sistema contém as informações sobre gerenciamento doarmazenamento que o OnDemand utiliza para manter os dados gravados no logdo sistema. Quando você inicializa o sistema, o grupo de aplicativos não éatribuído a uma política de migração e nem a um conjunto de armazenamento.Como o grupo de aplicativo não está designado a um conjunto de armazenamento,o sistema não migra uma cópia dos dados do log do sistema para a mídia dearchive.

A IBM recomenda que, antes de iniciar a definição de relatórios para o OnDemand,carregar dados no sistema ou permitir que os usuários acessem o sistema, vocêconfigure o grupo de aplicativos de Log do Sistema para manter uma cópiapermanente dos dados que são gravados no log do sistema. Isso pode ser feitodefinindo primeiro uma política de migração (e seu conjunto de armazenamentocorrespondente) que especifique uma mídia de armazenamento em archive, talcomo conjunto de discos, ótica ou de fita e, em seguida, atualizando o grupo deaplicativos de Log do sistema e atribuindo-o ao conjunto de armazenamento.

Independente de onde você deseja manter os dados do Log do Sistema, éimportante notar que o Log do Sistema é a forma mais direta de localizar o ID deCarga para os dados arquivados. Cada vez que os dados são carregados noOnDemand, o número de mensagem 87 é colocado no Log do Sistema e o Id deCarga é registrado como parte dessa mensagem. O ID de Carga (também chamadode "ID de Relatório") é um parâmetro requerido pelos parâmetros Remove Report(RMVRPTOND) e Print Report (PRTRPTOND).

Manutenção dos Dados de Log do Sistema no Armazenamento emArchive

A IBM recomenda a criação de uma política de migração que especifique a mídiade armazenamento de archive. Inclua no mínimo um local de armazenamentoprincipal na política de migração. A localização de armazenamento principal deveidentificar mídia de armazenamento em archive para manter os dadosindefinidamente. Consulte Capítulo 18, “Definição de políticas de migração econjuntos de armazenamento” para obter mais informações.

Após criar a política de migração (que cria automaticamente um conjunto dearmazenamento com o mesmo nome), atualize o grupo de aplicativos de Log dosistema e atribua-o ao conjunto de armazenamento. Após atribuir o grupo deaplicativos ao conjunto de armazenamento e reiniciar o servidor, o sistema mantémautomaticamente uma cópia do log do sistema no armazenamento em archiveespecificado.

Depois de criar a política de migração, conclua as etapas a seguir para atribuir ogrupo de aplicativos de Log do sistema a um conjunto de armazenamento:1. Inicie o IBM i Navigator. Selecione o servidor OnDemand e conecte-se, se

solicitado.

© Copyright IBM Corp. 2001, 2010 99

Page 118: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

2. Inicie o cliente administrativo clicando com o botão direito do mouse emAdministração do Common Server sob a seção Archive do OnDemand doIBM i Navigator.

3. Selecione as Funções Administrativas do Cliente. (Consulte o IBM ContentManager OnDemand for i: Common Server Administration Guide para obterinformações sobre como instalar as funções do cliente administrativo se essesitens não aparecerem no IBM i Navigator em sua estação de trabalho.)

4. Inicie sessão no servidor com um ID do usuário que tenha autoridade deadministrador do sistema. (O ID do usuário integrado, QONDADM, possuiautoridade do administrador do sistema.)

5. Clique em Grupo de aplicativos.6. Clique com o botão direito do mouse no grupo de aplicativos de migração do

Log do sistema.7. No menu pop-up, selecione Atualizar para abrir a janela Atualizar um grupo

de aplicativos.8. Clique na guia Gerenciamento do armazenamento.9. Na lista Nome do conjunto de armazenamento, selecione o nome do conjunto

de armazenamento. O nome do conjunto de armazenamento selecionado devecorresponder à definição de política de migração criada para os dados do Logdo sistema.

10. Clique em Avançado para abrir a caixa de diálogo Gerenciamento dearmazenamento avançado.

11. Selecione Próxima migração em cache em Migrar dados do cache. Esseprocedimento faz com que o OnDemand copie os dados de log do sistemapara o armazenamento em archive na próxima vez que os comandos demanutenção forem executados. Você também pode selecionar "Após x dias nocache", se quiser que os dados de log do sistema permaneçam no cache (emdisco) durante algum período antes de serem copiados para o armazenamentoem archive.

12. Clique em OK para fechar a caixa de diálogo Gerenciamento dearmazenamento avançado.

13. Clique em OK para salvar suas alterações e fechar a janela Atualizar umgrupo de aplicativos.

A ajuda on-line do cliente administrativo fornece informações sobre as opções napágina Gerenciamento do Armazenamento.

Reduzindo o Tamanho do Log do SistemaOutra forma de gerenciar o espaço necessário para os dados do log do sistema éremover ou limitar as mensagens no log que não sejam importantes para você.Talvez você não considere necessário manter cada entrada de log para cadarecuperação de documento, cada inclusão de anotação e cada logoff, por exemplo.Entretanto, é possível optar por manter as entradas de log do sistema para onúmero de mensagem 87, que indica um carregamento bem-sucedido e contém oID de carregamento dos dados específicos que estão sendo carregados (que énecessário para PRTRPTOND e RMVRPTOND, conforme já descrito nestecapítulo).

As entradas de log do sistema existentes podem ser excluídas seletivamente,usando a API ARSDOC DELETE, executada no ambiente QSHELL em seu servidorIBM i. Um exemplo é mostrado a seguir, e considera que você já esteja emQSHELL no momento em que a API é executada. (Consulte o IBM Content ManagerOnDemand for i: Common Server Administration Guide para obter mais detalhes sobre

100 Guia de Planejamento e Instalação

Page 119: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

o uso da API ARSDOC DELETE.) As entradas de log do sistema também podemser limitadas de forma que apenas as consideradas importantes sejam sempreregistradas. Consulte a seguir o exemplo de ARSDOC DELETE para obter maisinformações sobre essa opção também.

Lembre-se de salvar os arquivos de log do sistema antes de desempenharatividades de limpeza. O primeiro log do sistema que o OnDemand utiliza é umarquivo físico denominado SL2, encontrado na biblioteca da instância. Quando oarquivo SL2 é cheio, o próximo arquivo de log do sistema é criadoautomaticamente e nomeado SL3, e continua sendo criado e incrementado por um,conforme necessário.

No exemplo a seguir, utilize a função ARSDOC DELETE para excluir todas asmensagens do log do sistema para o intervalo de data especificado, exceto para amensagem de log do sistema 87:$> arsdoc delete -h QUSROND -v -i "WHERE NOT(MSG_NUM = 87)" -G 'Log do Sistema'-f 'Log do Sistema' -S 01.05.2007,10.05.2007,%d.%m%Y06/06/07 11:30:39: Iniciando arsdoc. Versão: 7.1.2.806/06/07 11:30:39: QRDARS/ARSDOC delete -h QUSROND -v -i WHERE NOT(MSG_NUM = 87)-G System Log -f System Log -S 01.05.2007,10.05.2007,%d%m%Y06/06/07 11:30:39: Procurando a pasta 'Log do Sistema' ...06/06/07 11:30:39: Procura bem-sucedida06/06/07 11:30:39: Procurando documentos em 'Log do Sistema' ...06/06/07 11:30:39: Consultando o banco de dados com a cadeia

SQL 'WHERE NOT(MSG_NUM = 87)'06/06/07 11:30:41: Procura bem-sucedida06/06/07 11:30:41: Excluindo documentos 616106/06/07 11:30:45: Exclusão bem-sucedida06/06/07 11:30:41: arsdoc concluído.

Depois que você executa ARSDOC DELETE para limpar as entradas de log dosistema não-necessárias, o OnDemand reutiliza o espaço que era utilizado pelosregistros que você excluiu. Como alternativa, é possível optar por reorganizar osarquivos de log do sistema usando o comando do IBM i, Reorganize Physical FileMbr (RGZPFM). Por exemplo, você pode executar RGZPFM instance_name/SL2, emque instance_name é o nome da instância do OnDemand. De qualquer modo, éprovável que você queira reorganizar tudo, exceto o arquivo de log do sistemaatual.

Como uma etapa final, pode ser que você queira limitar o que é enviado para olog do sistema no futuro. O Cliente Administrador do OnDemand permiteselecionar quais atividades do OnDemand criarão entradas no log do sistema. Paraselecionar quais atividades criam entradas no log do sistema em um servidorOnDemand:1. Efetue logon no servidor com o Cliente Admnistrador do OnDemand.2. Clique com o botão direito do mouse no servidor.3. No menu popup, selecione Parâmetros do Sistema, para chamar a caixa de

diálogo Parâmetros do Sistema.4. Selecione as atividades do OnDemand que você deseja registrar na Criação de

Log do Sistema e Criação de Log de Saída de Usuário.

Capítulo 19. Configuração do Grupo de Aplicativos do Log do Sistema 101

Page 120: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

102 Guia de Planejamento e Instalação

Page 121: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 20. Configuração do Grupo de Aplicativos deMigração do Sistema

Nota: A migração do índice não é recomendada.

A migração do índice é o processo pelo qual o OnDemand move dados do índicedo banco de dados para o armazenamento em archive. Esse processo otimiza oespaço de armazenamento do banco de dados ao mesmo tempo que permite amanutenção de dados do índice por muito tempo. Normalmente, os dados deíndice são migrados quando os usuários não precisam mais acessar os relatórios,mas por exigência jurídica ou por outro motivo, ainda é necessário manter osdados por alguns anos ou meses. O OnDemand utiliza as definições degerenciamento de armazenamento em grupos de aplicativos para determinar se osdados de índice são migrados ou não para o armazenamento em archive. Todos osdados migrados são gerenciados por meio do grupo de aplicativos Migração dosistema.

Quando você instala e configura o OnDemand, inicializa a função de migração dosistema. A migração do sistema consiste no grupo de aplicativos de Migração dosistema, em um conjunto de aplicativos de Migração do sistema e na pasta deMigração do sistema. O grupo de aplicativos de Migração do sistema contém asinformações sobre gerenciamento do armazenamento que o OnDemand utilizapara manter os dados de índice migrados para o armazenamento em archive. Atéque você atribua o grupo de aplicativos a um conjunto de armazenamento queespecifique a mídia para arquivamento, o OnDemand não pode migrar dados deíndice do banco de dados para o armazenamento em archive. Consulte oCapítulo 18, “Definição de políticas de migração e conjuntos de armazenamento”,na página 97 e “Atribuição do Grupo de Aplicativos de Migração do Sistema a umConjunto de Armazenamento” para obter informações adicionais.

Atribuição do Grupo de Aplicativos de Migração do Sistema a umConjunto de Armazenamento

Se for necessário que o sistema mantenha dados de índice no armazenamento emarchive, atribua o grupo de aplicativos de Migração do sistema a um grupo deaplicativos que mantenha os dados indefinidamente.

Após atribuir o grupo de aplicativos ao conjunto de armazenamento e reiniciar oservidor, o sistema migra automaticamente os dados de índice para oarmazenamento em archive, sempre que o comando de manutenção for executado.Conclua as etapas a seguir para atribuir o grupo de aplicativos de Migração dosistema a um conjunto de armazenamento:1. Inicie o IBM i Navigator. Selecione o servidor OnDemand e inicie sessão, se

solicitado.2. Inicie o cliente administrativo clicando com o botão direito do mouse em

Administração do Common Server na seção Archive do OnDemand do IBM iNavigator. Então, selecione as Funções Administrativas do Cliente. (Consulte oIBM Content Manager OnDemand for i: Common Server Administration Guide paraobter informações sobre como instalar as funções do cliente administrativo seesses itens não aparecerem no IBM i Navigator em sua estação de trabalho.)

© Copyright IBM Corp. 2001, 2010 103

Page 122: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

3. Inicie sessão no servidor com um ID do usuário que tenha autoridade deadministrador. O ID do usuário interno, QONDADM, tem autoridade deadministrador do sistema.

4. Clique em Grupo de aplicativos.5. Aponte para o grupo de aplicativos de Migração do sistema e clique com o

botão direito do mouse.6. No menu popup, selecione Atualizar para abrir a janela Atualizar um grupo de

aplicativos.7. Clique na guia Gerenciamento do armazenamento.8. Na lista Nome do conjunto de armazenamento, selecione o nome do conjunto

de armazenamento. O conjunto de armazenamento selecionado deve identificaruma mídia de arquivamento que mantenha dados indefinidamente.

9. Clique em OK.

A ajuda on-line do cliente administrativo fornece informações sobre as opções napágina Gerenciamento do armazenamento.

104 Guia de Planejamento e Instalação

Page 123: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Capítulo 21. Backup dos dados do OnDemand

Para concluir o processo de instalação e configuração, recomendamos que você crieum backup completo off-line do banco de dados do OnDemand em mídiaremovível. O backup completo do banco de dados é necessário para recriar obanco de dados, caso necessário. A única forma de recriar o banco de dados é sevocê tiver um backup completo do banco de dados (e todos receptores de diáriogerados desde o último backup completo do banco de dados). Consulte o IBMContent Manager OnDemand for i: Common Server Administration Guide para obterinformações adicionais sobre como fazer backup de seus dados do OnDemand.

Crie um registro das informações sobre o backup do banco de dados, inclusive adata e hora da criação do backup e o rótulo do volume de armazenamento.Mantenha a cópia de backup em um local seguro, de preferência externamente.Salve a cópia de backup no mínimo até a próxima criação de outro backupcompleto do banco de dados.

© Copyright IBM Corp. 2001, 2010 105

Page 124: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

106 Guia de Planejamento e Instalação

Page 125: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Apêndice A. Servidores de Banco de Dados

O parâmetro ARS_NUM_DBSRVR no arquivo ARS.CFG determina o número deprocessos que o OnDemand pode iniciar no servidor para tratar pedidos do bancode dados. Utilize o parâmetro ARS_NUM_DBSRVR para equilibrar o desempenho,distribuindo a carga de trabalho do banco de dados entre vários processos e o usode recursos do sistema.

DescriçãoCada acesso ao banco de dados requer um agente do banco de dados. OOnDemand pode iniciar um agente do banco de dados para cada acesso.Entretanto, isso consome muitos recursos do sistema, pois um novo job é iniciadosempre que um agente do banco de dados é iniciado. Utilize o parâmetroARS_NUM_DBSRVR para otimizar a forma como o OnDemand trata a carga dobanco de dados. Por exemplo, você pode definir o ARS_NUM_DBSRVR para que oOnDemand inicie um número fixo de agentes do banco de dados,independentemente do número de pedidos simultâneos do banco de dados.Embora isso possa parecer restritivo, geralmente os pedidos do banco de dados sãoprocessados muito rapidamente.

Os fatores a serem considerados ao definir o parâmetro ARS_NUM_DBSRVRincluem:v Número de usuários simultâneosv Número de jobs de carregamento de dados ativosv Número de processos de manutenção do banco de dados ativos

Recomendamos que você defina o parâmetro ARS_NUM_DBSRVR para suportar onúmero de pico de acessos simultâneos ao banco de dados os quais você supõeque o servidor vai tratar. Um valor baixo limita o acesso ao banco de dadosdurante períodos de alta atividade no banco de dados. Um valor alto exige maisrecursos do sistema durante períodos de alta atividade no banco de dados. O valorescolhido também depende das características das consultas. Por exemplo,consultas gerais normalmente utilizam um agente do banco de dados por maistempo do que uma consulta específica.

© Copyright IBM Corp. 2001, 2010 107

Page 126: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

108 Guia de Planejamento e Instalação

Page 127: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Apêndice B. Suporte ao Idioma Nacional

Visão GeralEste capítulo contém informações sobre o NLS (Suporte ao Idioma Nacional)fornecido pelo OnDemand, incluindo informações sobre as páginas de códigos(conjuntos de códigos) suportadas para oferecer suporte aos caracteres do NL(Idioma Nacional).

Conversão entre Páginas de Códigos DiferentesA página de códigos mapeia cada caractere de um conjunto de caracteres, tal comoo alfabeto latino, para uma representação numérica. Cada página de códigos éidentificada por um identificador numérico. Por exemplo, a página de códigos 850representa o caractere A como o hexadecimal 41.

O ideal para um melhor desempenho é que os clientes e aplicativos do OnDemandsempre utilizem a mesma página de códigos que a instância do OnDemand7.Entretanto, esse processo nem sempre é prático ou possível. O OnDemand oferecesuporte à conversão de caracteres que permite que os clientes, aplicativos einstâncias utilizem páginas de códigos diferentes. Isso significa que, enquanto umainstância do OnDemand deve ser executada em uma única página de códigos, osclientes que acessam a instância podem operar em qualquer página de códigos e osrelatórios armazenados no OnDemand podem conter caracteres codificados emqualquer página de códigos.

Entretanto, quando você usa páginas de códigos diferentes, o OnDemand podeprecisar converter os caracteres de uma página de códigos para uma outradiferente a fim de manter o significado dos dados.

Quando a Conversão de Caracteres Ocorre?A conversão de caracteres pode ocorrer nas seguintes situações:v Quando um cliente estiver operando um ema página de códigos diferente da

página de códigos da instância do OnDemand.A conversão de dados de caracteres ocorre no servidor utilizando tabelas demapeamento da página de códigos Unicode. As tabelas de mapeamento dapágina de códigos Unicode existem para todos os idiomas de byte simples eduplo. Por exemplo, um cliente Windows operando na página de códigos 1252de Latim 1 pode acessar uma instância do OnDemand que possui os dados decaractere codificados na página de códigos 819 de Latim 1 (conjunto de códigosISO 8859-1).Os dados que o usuário digita (ou os valores padrão) são convertidos emUnicode pelo OnDemand. Os dados de Unicode resultantes em seguida sãoconvertidos na página de códigos da instância. Por exemplo, o usuário digita umID do usuário, uma senha e um nome do servidor para iniciar sessão em umservidor. O OnDemand converte os caracteres da página de códigos do clienteem Unicode e depois de Unicode para a página de códigos da instância.

7. Uma instância do OnDemand é um ambiente lógico do servidor OnDemand, com uma biblioteca (e um conjunto de arquivos debanco de dados). Cada instância do OnDemand deve ser executada em uma única página de códigos.

© Copyright IBM Corp. 2001, 2010 109

Page 128: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Os dados enviados ao cliente são convertidos em Unicode pelo OnDemand. Osdados de Unicode resultantes em seguida são convertidos na página de códigosdo cliente. Por exemplo, após autenticar o ID do usuário e a senha, o servidorcria uma lista de nomes da pasta que o usuário pode abrir. O OnDemandconverte os caracteres da página de códigos da instância para Unicode e, emseguida, de Unicode para a página de códigos do cliente.

v Quando os dados de índice do OnDemand estão em uma página de códigosdiferente da página de códigos da instância do OnDemand.A conversão de dados de caracteres ocorre no servidor utilizando tabelas demapeamento da página de códigos Unicode. O OnDemand converte oscaracteres da página de códigos dos dados de índice em Unicode e depois deUnicode para a página de códigos da instância. Por exemplo, os dados de índicecom a página de códigos 1252 podem ser armazenados em uma instância quetenha dados de caracteres codificados na página de códigos 37.

A conversão de caracteres não ocorre para:v Documentos armazenados no OnDemand.

Quando você armazena documentos no OnDemand, eles são armazenados noservidor por um fluxo de bytes e não ocorre conversão de caracteres. Porexemplo, se os caracteres do documento forem codificados na página de códigos500, os caracteres permanecem codificados na página de códigos 500 quandoarmazenados no OnDemand.Quando um usuário recuperar um documento do OnDemand, o servidor enviao documento ao cliente sem converter os caracteres de uma página de códigosna outra. Por exemplo, um documento é armazenado no OnDemand comcaracteres codificados na página de códigos 500. Quando o usuário recupera odocumento, ele permanece codificado na página de códigos 500, embora ocliente possa estar executando em uma página de códigos diferente daquela dainstância, tal como 1252. Entretanto, o programa de exibição do cliente mapeiacaracteres em um documento da página de códigos do servidor para a página decódigos do cliente.

Mapeamento de CaracteresPara dados AFP Double-Byte Character Set (DBCS) e dados de linha DBCS eSingle-Byte Character Set (SBCS), o cliente OnDemand converte automaticamenteos caracteres em um documento da página de códigos do servidor para a páginade códigos do cliente usando conversores ICU. Esse método de mapeamento decaracteres funciona com o cliente Windows e suporta os idiomas DBCS (para AFPe dados em linha) e SBCS (para dados em linha) inclusive a maior parte dosmapeamentos de UDCs (Caracteres Definidos pelo Usuário) DBCS. Os conversoresICU mapeiam automaticamente a área definida pelo usuário de uma página decódigos para a área definida pelo usuário padrão da tabela ICU correspondente. Sea página de códigos contiver mapeamentos UDC fora da área definida pelousuário padrão, você poderá criar e usar seu próprio conversor ICU. (Casocontrário, o programa de visualização não poderá exibir os caracterescorretamente.) Use o utilitário Character Data Representation Architecture (CDRA)para criar seu próprio conversor ICU. Para dados AFP, altere o parâmetroIconvLocalePath na seção Preferências do arquivo FLDPORT2.INI para usar seupróprio conversor ICU. Para obter informações sobre conversão de dados decaractere, mapeamento de fontes e assuntos relacionados, consulte o IBM ContentManager OnDemand Windows: Client Customization Guide.

Para obter informações adicionais sobre o ICU, consulte http://www.icu-project.org/.

110 Guia de Planejamento e Instalação

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

||

Page 129: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

O AFP Viewer opera internamente em Unicode e usa o ICU para converter dados.

Como o OnDemand Determina Valores de Página de Códigos?A página de códigos do cliente é determinada a partir do ambiente operacionalquando é feita a conexão com a instância. Por exemplo, no Windows, a página decódigos deriva do locale, conforme especificado nas Configurações regionais noPainel de controle.

A página de códigos da instância deriva do valor especificado no momento dacriação da instância. A instância está em apenas uma página de códigos.

A página de códigos dos dados do índice gerada por um indexador é determinadapela página de códigos especificada pela entrada. Quando os dados do índice sãoarmazenados em uma instância, eles são convertidos da página de códigosespecificada na página de códigos da instância. Quando os dados do índice sãorecuperados de uma instância, são convertidos da página de códigos da instânciapara a página de códigos do cliente.

A página de códigos de um documento de dados em linha é derivada doaplicativo (página Exibir informações). Para todos os outros tipos de documentos, apágina de códigos deriva dos dados. O servidor nunca executa conversão decaracteres em documentos.

Configuração do Sistema para NLSAo criar uma instância do OnDemand, especifique o identificador de idioma e olocale para essa instância. Esses valores determinam as definições do idioma para ainstância. Consulte o Capítulo 12, “Criação de uma ocorrência”, na página 71 paraobter informações adicionais sobre a criação de instâncias e a especificação doidentificador de idioma e do locale.

Identificadores de IdiomaA Tabela 9 lista os identificadores de idioma suportados pelo OnDemand.

Tabela 9. Identificadores de idioma suportados

Identificador do Idioma País ou região

FRC Canadá

CHS China

HRV Croácia

CZE República Tcheca

DAN Dinamarca

ARA Egito

FIN Finlândia

FRA França

DEU Alemanha

ELL Grécia

HUN Hungria

ITA Itália

JPN Japão

Apêndice B. Suporte ao Idioma Nacional 111

|

||

||

||

||

||

||

||

||

||

||

||

||

||

||

||

Page 130: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 9. Identificadores de idioma suportados (continuação)

Identificador do Idioma País ou região

KOR Coréia

NLD Holanda

NOR Noruega

PLK Polônia

PTB Portugal/Brasil

RUS Rússia

SKY Eslováquia

SLO Eslovênia

ESP Espanha

SVE Suécia

CHT Taiwan

ENU Estados Unidos/Inglês

Códigos do IdiomaAs informações na Tabela 10 podem ajudá-lo a determinar a abreviação do idiomae o locale a ser utilizado ao criar uma instância do servidor OnDemand. Umainstância pode ser criada em qualquer idioma, mesmo que esse idioma não estejainstalado para i5/OS.

A partir da V5R4, o código do idioma base para cada idioma foi alterado paraincluir o suporte para a moeda Euro. Novos códigos de idioma foram criados semsuporte ao Euro. Por exemplo, o código do idioma ES_ES agora inclui suporte aoEuro, assim como o código do idioma ES_ES_E existente. Se você necessitar de umcódigo de idioma em espanhol sem suporte ao Euro, deve utilizar ES_ES_PE.

A tabela não fornece uma lista completa de todos os códigos de idioma, CCSIDs,países ou locales. Informações de referência adicionais podem ser obtidas a partirdo IBM i Globalization no endereço da Web www.ibm.com/systems/i/software/globalization/.

Tabela 10. Códigos de Idioma, CCSIDS e LocalesCódigo doIdioma

Em OD1 Idioma SBCS CCSID SBCS CCSID(Euro)

DBCS CCSID País ou região Locale2 Locale (Euro)2

ARA Y Árabe 420 ÁrabeFalado

EgitoCatar

AR_AA

AR_EG *AR_QA *

CHS Y ChinêsSimplificado

836 9351388

China ZH_CH_GBK *ZH_CN

CHT Y ChinêsTradicional

25 937 Taiwan ZH_TW

CSY5 Y Tcheco 870 1154 RepúblicaTcheca

CS_CZ

DAN Y Dinamarquês 277 1142 Dinamarca DA_DK_PE * DA_DK

DES Alemão (Suíça) 500 1148 Suíça DE_CH

DEU Y Alemão 273 1141 ÁustriaAlemanha

DE_AT_PE *DE_DE_PE

DE_ATDE_DE

ELL Y Grego 875 4971 Grécia EL_GR_PE * EL_GR

ENA Inglês(Austrália)

25 1140 Austrália EN_AU *

ENB Inglês (Bélgica) 500 1148 Bélgica EN_BE_PE * EN_BE

ENG Inglês (ReinoUnido)

285 1146 Reino Unido EN_GB_PE * EN_GB

ENP InglêsMaiúscula

25 1140 EN_UPPER

ENU Y Inglês (EUA) 25 1140 Estados Unidos EN_US

ESP Y Espanhol 284 1145 EspanhaMéxico

ES_ES_PE *ES_MX *

ES_ES

112 Guia de Planejamento e Instalação

|

||

||

||

||

||

||

||

||

||

||

||

||

|||

||||

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

||||||||||

||||

|

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

||||||||||

||||||||||

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

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

||||||||||

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

Page 131: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 10. Códigos de Idioma, CCSIDS e Locales (continuação)Código doIdioma

Em OD1 Idioma SBCS CCSID SBCS CCSID(Euro)

DBCS CCSID País ou região Locale2 Locale (Euro)2

FIN Y Finlandês 278 1143 Finlândia FI_FI_PE FI_FI

FRA Y Francês 297 1147 França FR_FR_PE FR_FR

FRB Francês(Bélgica)

500 1148 Bélgica FR_BE_PE FR_BE

FRC Y Francês(Canadá)

500 1148 Canadá FR_CA FR_CA_M

FRS Francês (Suíça) 500 1148 Suíça FR_CH

HEB Hebraico 424 Israel HE_IL

HRV Y Croata 870 1153 Croácia HR_HR

HUN Y ENU 870 1153 Hungria HU_HU

ITA Y FAR 280 1144 Itália IT_IT_PE IT_IT

ITS Italiano (Suíça) 500 1148 Suíça IT_CH *

JPN Y JaponêsKatakana comminúscula

290 1027 5035 Japão JA_5035

KOR Y Coreano 833 933 Coréia do Sul KO_KR

NLB Holandês(Bélgica)

500 1148 Bélgica NL_BE_PE NL_BE

NLD Y Dutch 25 1140 Holanda NL_NL_PE NL_NL

NON Norueguês -Nynorsk

277 1142 Noruega NO_NO

NOR Y Norueguês -Bokmal

277 1142 Noruega NB_NO *

PLK Y Polonês 870 1153 Polônia PL_PL

PTB Y Português doBrasil

25 1140 Brasil PT_BR

PTG Português 25 1140 Portugal PT_PT_PE PT_PT

RUS Y KOR 1025 1154 Rússia RU_RU

SKY Y Eslovaco 870 1153 Eslováquia SK_SK

SLO Y Esloveno 870 1153 Eslovênia SL_SI

SVE Y Sueco 278 1143 Suécia SV_SE_PE * SV_SE

THA Finlândia 838 1160 Tailândia TH_TH TH_TH_E

TRK Turco 1026 1155 Turquia TR_TR

Notas:

1. Um Y nessa coluna indica que o OnDemand emitirá mensagens de log do sistema nesse idioma. Para todos os outros idiomas o OnDemand emitirá mensagens delog do sistema em inglês.

2. Os nomes de locale seguidos por um asterisco (*) devem ser criados utilizando o comando CRTLOCALE. Todos os outros nomes de locale listados são enviados nabiblioteca QSYS. Observe que o asterisco não faz parte do nome real do locale. Ele é utilizado nessa tabela simplesmente para fins de identificação. Antes de criarcódigos de idioma, é necessário instalar a Opção 21 do IBM i, Extended NLS Support. Esta opção de produto contém todos os arquivos de origem de código doidioma fornecidos pela IBM. Se você precisar de um código de idioma não fornecido pela IBM, será necessário copiar e modificar um código de idioma existentepara atender suas necessidades. A assistência para executar isso pode ser obtida a partir da organização de suporte da IBM em sua área.

3. O seguinte comando mostra um exemplo de como criar um locale:

CRTLOCALE LOCALE('/QSYS.LIB/SV_SE_PE.LOCALE')SRCFILE('/QSYS.LIB/QSYSLOCALE.LIB/QLOCALESRC.FILE/SV_SE_PE.MBR')CCSID(278) TEXT('SWEDEN/SWEDISH LOCALE WITH EURO')

4. Para uma instância no idioma japonês, ela deverá ser criada com CCSID 5035 e locale JA_5035. Utilizar uma combinação de CCSID/locale que suporta apenasmaiúscula resultará em mensagens do OnDemand ilegíveis no log do sistema.

5. O código de idioma Tcheco no IBM i é CSY; o código de idioma Tcheco no OnDemand é CZE.

Mapeando Fontes AFPÉ provável que você precise mapear as fontes usadas por seus documentos parafontes que podem ser exibidas no cliente.

É necessário mapear fontes AFP se seus documentos possuírem fontes nãodefinidas para o OnDemand, fontes IBM AFP modificadas, ou fontes AFP criadaspor você ou por outras pessoas da empresa. Caso contrário, o programa devisualização talvez não consiga exibir os caracteres corretamente. Se seusdocumentos utilizam fontes não definidas no OnDemand, os usuários vêem umamensagem ao exibi-los. O IBM Content Manager OnDemand: Windows ClientCustomization Guide fornece mais detalhes sobre o mapeamento de fontes AFP.

Mapeie fontes AFP utilizando os arquivos de definição de fontes fornecidos peloOnDemand. Os arquivos são armazenados no subdiretório FONT no diretório noqual o OnDemand foi instalado (por padrão, \Arquivos de programas\IBM\OnDemand32).

Apêndice B. Suporte ao Idioma Nacional 113

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

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

||||||||||

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

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

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

||||||||||

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

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

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

Page 132: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

O OnDemand fornece os arquivos de definição de fonte para os seguintes idiomasde múltiplos bytes:v Japonês (ICODED.JPN, CSDEF.JPN, CPDEF.JPN)v Coreano (ICODED.KOR, CSDEF.KOR, CPDEF.KOR)v Chinês simplificado (ICODED.CHS, CSDEF.CHS, CPDEF.CHS)v Chinês tradicional (ICODED.CHT, CSDEF.CHT, CPDEF.CHT)

Por exemplo, para japonês, se uma fonte for listada no arquivo CSDEF.JPN, elaserá suportada no visualizador AFP. O mapeamento real de fontes, da fonte AFPpara a fonte Windows, ocorre na seção [FGID] do arquivo CSDEF.JPN (a seção[FGID] está no final do arquivo). Se uma fonte não estiver listada no arquivoCSDEF.JPN, você poderá adicioná-la, editando o arquivo CSDEF.JPN com umeditor de texto padrão.

Criação de Grupos de AplicativosUm grupo de aplicativos é um contêiner de dados de relatório. Os relatórios e osdados de índice utilizados para recuperá-los e mantê-los são armazenados em umgrupo de aplicativos. Os campos de banco de dados são definidos para cada grupode aplicativos. Os campos de banco de dados representam categorias deinformações em um relatório. Quando você carrega um relatório em um grupo deaplicativos, armazena informações de índice sobre o relatório no banco de dados.

Quando você define campos de banco de dados, especifica atributos dos campos.Os atributos incluem o nome do campo, o tipo e o comprimento. Para dados decaracteres, o comprimento do campo deve especificar o número de bytesnecessários para conter os dados do campo no banco de dados. Para idiomas debyte duplo, a conversão de cadeia de caracteres entre as páginas de códigos poderesultar em um aumento ou diminuição no comprimento da cadeia quando osdados são carregados no banco de dados. Por exemplo, o cliente não utilizacaracteres SOSI (Shift-Out/Shift-In) para separar SBCS e DBCS, mas o servidor osutiliza. Você deve permitir essa possível expansão ao especificar o comprimento deum campo de dados. O comprimento máximo de um campo de dados noOnDemand é 254 bytes. Verifique o comprimento de cada campo do banco dedados (cadeia) definido:v Se você utiliza o Assistente de relatório para gerar grupos de aplicativos, o

Assistente de relatório converte cadeias selecionadas na página de códigos dobanco de dados e exibe o número de caracteres necessário para conter a cadeiano banco de dados. Você pode aceitar o valor gerado pelo Assistente de relatórioou substitui-lo por outro valor.

v Se utilizar o comando Incluir um grupo de aplicativos para incluir grupos deaplicativos, você deverá calcular o número de bytes necessários para conter ocampo no banco de dados e digitar o valor na página Informações sobre ocampo.

Criação de AplicativosNormalmente você cria um aplicativo do OnDemand para cada tipo de relatórioou fonte de dados que pretende armazenar no OnDemand. Quando você cria umaplicativo, especifica seus atributos. Os atributos incluem:v O tipo de dado do relatório, tal como ele é armazenado no OnDemand (por

exemplo, AFP). O tipo de dados determina o programa de exibição utilizadopara exibir páginas do relatório.

114 Guia de Planejamento e Instalação

Page 133: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

v O programa utilizado para indexar o relatório. Se você utilizar um dosprogramas de indexação fornecidos com o OnDemand, normalmente o aplicativoOnDemand incluirá os parâmetros que o programa de indexação utiliza paraprocessar o relatório e gerar os dados de índice.

v Exibições lógicas dos dados de relatório. As exibições lógicas fornecem formasdiferentes de exibir páginas de um relatório de dados em linha.

Você pode criar um aplicativo utilizando o Assistente de relatório ou utilizando ocomando Add an Application. Crie informações de índice digitando parâmetros evalores diretamente no aplicativo, especificando o nome de um arquivo deparâmetro que contém as informações ou utilizando o Indexador gráfico para gerarinformações de índice. Crie exibições lógicas digitando valores diretamente noaplicativo ou utilizando a janela de exemplo de dados para gerar as informaçõeslógicas de exibição.

Tipo de DadosO Tipo de dados do aplicativo identifica o formato dos dados conformearmazenado no OnDemand e o visualizador que o cliente chama para exibirdocumentos armazenados no aplicativo. Se você pretende armazenar dados emlinha no OnDemand ou criar parâmetros de indexação com o indexador gráfico(utilizando um arquivo fonte de dados em linha), defina o Tipo de dados doaplicativo como Linha. (Nota: As referências a um tipo de dados de Linha nessadiscussão também incluem o tipo de dados de SCS, porque o SCS é processadocomo dados da Linha. O tipo de dados estendido de SCS é processado de maneiradiferente e, portanto, não pode ser utilizado.) Quando você define o Tipo de Dadospara Linha:v Verifique a página de códigos dos dados. A página de códigos dos dados

normalmente é a página de códigos do sistema operacional no qual os dadosforam criados. No OnDemand, a página de códigos padrão dos dados em linhaé 500 (ISO EBCDIC).

v Se os dados da linha contiverem códigos SOSI (Shift-In/Shift-Out), indique comoo OnDemand os tratará. Os códigos SOSI indicam quando o código aponta parauma alteração de registro de byte único para byte duplo e de byte duplo parabyte único. Selecione a partir de SOSI1, SOSI2 e SOSI3. Esses valores sãoespecificados utilizando o OnDemand Administrator Client, utilizando o campoModo PR na guia Visualizar Informações em uma definição de aplicativo.)

Para todos os outros tipos de dados, a página de códigos está encapsulada nosdados. Para dados AFP, os caracteres podem estar codificados em mais de umapágina de códigos. O visualizador de AFP utiliza arquivos de mapeamento paraexibir dados de byte simples e duplo na página de códigos correta. Você podeprecisar mapear as fontes AFP usadas por um documento para fontes geométricasno PC para que o cliente exiba corretamente todos os caracteres. O IBM ContentManager OnDemand: Windows Client Customization Guide fornece mais detalhessobre o mapeamento de fontes AFP.

IndexaçãoSe você utiliza o Indexador genérico para indexar os dados de entrada, a página decódigos padrão será 500. Se for necessário gerar dados de índice em alguma outrapágina de códigos, especifique o parâmetro CODEPAGE: no arquivo de parâmetrosutilizado pelo Indexador genérico. Consulte o IBM Content Manager OnDemand fori: Common Server Indexing Reference para obter informações adicionais.

Se você usar o indexador gráfico para gerar parâmetros de indexação para umrelatório que contém dados de caractere de byte duplo, poderá ser necessário

Apêndice B. Suporte ao Idioma Nacional 115

Page 134: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

alterar os valores de coluna inicial, coluna final e largura da coluna gerados peloindexador gráfico. Quando você abre um relatório com o indexador gráfico, ocliente converte os caracteres da página de códigos do host na página de códigosdo PC. Se o relatório tiver dados de caracteres de duplo byte, os códigos SOSI nosdados não são convertidos. Como resultado, ao selecionar uma cadeia que contémdados de caractere de byte duplo, a coluna inicial da cadeia poderá ser exibidaincorretamente pelo indexador gráfico. Além disso, se a cadeia no relatório original(gerada no host) tiver códigos SOSI, a coluna final ou o valor de largura da colunaserão exibidos incorretamente pelo indexador gráfico. Para gerar parâmetros deindexação corretos para dados de caracteres de byte duplo:v Crie os parâmetros de indexação utilizando o indexador gráficov Utilizando uma cópia do relatório original (gerado no host), determine a coluna

inicial real, a coluna final e os valores de largura de coluna para as cadeiasselecionadas no relatório (disparos e campos)

v Altere os parâmetros de indexação, utilizando o OnDemand Administrator,Client, clicando no botão Modificar, depois de selecionar a opção Teclado naseção Origem de Parâmetros da guia Informações do Indexador.

Importante: Após modificar os parâmetros de indexação, não abra novamente orelatório com o indexador gráfico. Se isso for feito, as modificaçõesserão perdidas.

Exibições LógicasSe você usar a janela de dados de amostra para criar visualizações lógicas para umrelatório que contém dados de caractere de byte duplo, poderá ser necessárioalterar os valores de coluna inicial, coluna final e largura da coluna gerados peloOnDemand. Quando você abre um relatório na janela de exemplo de dados, ocliente converte os caracteres da página de códigos do host na página de códigosdo PC. Se o relatório tiver dados de caracteres de duplo byte, os códigos SOSI nosdados não são convertidos. Como resultado, ao selecionar uma cadeia que contémdados de caractere de byte duplo, a coluna inicial da cadeia poderá ser exibidaincorretamente pelo indexador gráfico. Além disso, se a cadeia no relatório original(gerada no host) tiver códigos SOSI, a coluna final ou o valor de largura da colunaserão exibidos incorretamente pelo indexador gráfico. Para gerar indexações lógicascorretas para dados de caracteres de byte duplo:v Crie as exibições lógicas utilizando a janela de exemplo de dadosv Utilizando uma cópia do relatório original (gerado no host), determine a coluna

inicial real, a coluna final e os valores de largura de coluna para as cadeiasselecionadas no relatório (campos e a cadeia de validação)

v Altere as informações sobre a exibição lógica, substituindo os valores na páginaCampos de exibição lógica.

Importante: Após modificar as informações de exibição lógica, não abranovamente o relatório na janela de exemplo de dados. Se isso forfeito, as modificações serão perdidas.

Execução de Programas do OnDemandDeterminados programas do OnDemand aceitam dados de entrada (parâmetros evalores) de um arquivo de parâmetros. Quando você trabalha com um banco dedados do idioma de byte duplo, os dados no arquivo de parâmetros devem sercodificados na página de códigos do banco de dados. A Tabela 11 na página 117lista os países ou regiões DBCS suportados pelo OnDemand e a página de códigosque você deve executar ao criar o arquivo de parâmetros. Quando for necessário

116 Guia de Planejamento e Instalação

Page 135: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

criar um arquivo de parâmetros, recomendamos que você trabalhe a partir de umemulador 5250 e utilize a opção 2=Editar nas telas WRKLNK para editar umarquivo de fluxo. Não crie o arquivo de parâmetros em um PC e depois utilize oprograma de FTP para enviá-lo ao servidor.

Tabela 11. Páginas de códigos DBCS

País ou Região Página de Códigos do Host

China 935

Japão 290 ou 1027

Coréia 933

Taiwan 937

Apêndice B. Suporte ao Idioma Nacional 117

Page 136: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

118 Guia de Planejamento e Instalação

Page 137: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Apêndice C. Log do Sistema e Saída do Usuário de Log doSistema

O OnDemand gera mensagens sobre as diversas ações que ocorrem no sistema. Porexemplo, quando um usuário inicia sessão no sistema, o OnDemand gera umamensagem que contém a data e hora, o tipo de ação, o ID do usuário e outrasinformações. Você pode configurar o OnDemand para salvar as mensagens em umlog do sistema. Além disso, pode configurar o sistema para enviar as mensagens aum programa definido pelo usuário. O programa definido pelo usuário podeprocessar mensagens da forma que você desejar. Por exemplo, pode enviar alertaspara administradores, compilar estatísticas ou gerar informações sobre contas.

Faça o seguinte para configurar o sistema para enviar as mensagens a umprograma definido pelo usuário:v Ative o OnDemand para gerar mensagens do sistema e especifique os tipos de

mensagens geradas, selecionando as opções apropriadas na caixa de diálogoParâmetros do sistema.

v Ative o OnDemand para gerar mensagens do grupo de aplicativos selecionandoa opção apropriada na caixa de diálogo Parâmetros do sistema.

v Especifique os tipos de mensagens do grupo de aplicativos geradas selecionandoopções na página Log de mensagens nos grupos de aplicativos.

v Ative o OnDemand para enviar mensagens para um programa definido pelousuário selecionando as opções apropriadas na caixa de diálogo Parâmetros dosistema.

Depois de concluir essas etapas, o OnDemand salva as mensagensautomaticamente no log do sistema e as envia para o programa definido pelousuário.

O OnDemand envia as mensagens para um programa chamado ARSLOG. Oprograma ARSLOG fornecido pela IBM não executa função alguma. Entretanto,você pode substituir o programa ARSLOG fornecido pela IBM por um programadefinido pelo usuário que executa funções específicas, tais como verificar o númeroda mensagem e emitir alertas aos administradores.

As mensagens que o OnDemand envia ao programa ARSLOG contêm osparâmetros listados na Tabela 12.

Tabela 12. Parâmetros do programa ARSLOG (programa de saída do usuário de log dosistema)

Parâmetro Objetivo Tamanho Exemplo

$1 Instância do OnDemand 10 carac QUSROND

$2 Marca de hora 20 carac 08/13/95 14:24:31

$3 Identificador de registro dolog

10 carac 57049

$4 ID do usuário doOnDemand

128 carac QONDADM

$5 Informações de contas dousuário

60 carac Z76-001J/999999

© Copyright IBM Corp. 2001, 2010 119

Page 138: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Tabela 12. Parâmetros do programa ARSLOG (programa de saída do usuário de log dosistema) (continuação)

Parâmetro Objetivo Tamanho Exemplo

$6 Gravidade:

1 Alerta

2 Erro

3 Aviso

4 Informação

5 Depuração

1 carac 3

$7 Número da mensagem 5 carac 31

$8 Texto da mensagem 255 carac Falha no Login: od400lib17.52.365.12

$9 Arquivo de documento 256 caracteres Este parâmetro será usadoapenas se a mensagem delog do sistema sendopassada para a saída deusuário tiver informaçõesadicionais não incluídas notexto da mensagem. Oarquivo é excluídoimediatamente após oprograma de saída retornaro controle para oOnDemand.1

Notas:

1. Por exemplo, ao visualizar as mensagens de log do sistema 87 ou 88 a partir doCliente OnDemand, Sim será indicado no título da coluna Visualizar da lista dedocumentos. Visualizar=Sim indica que informações adicionais estãodisponíveis para essas mensagens. O parâmetro de arquivo do documentocontém o nome completo do caminho do arquivo que contém o texto adicionala ser processado pela saída de usuário. O arquivo é armazenado no diretórioespecificado pelo parâmetro ARS_TMP no arquivo ARS.CFG (consulte“Parâmetro ARS_TMP” na página 86). Um exemplo do conteúdo desseparâmetro tal como ele é passado para a saída de usuário poderia ser:/QIBM/USERDATA/ONDEMAND/QUSROND/TMP/ARS.155.0000000000000013.SYSLOG.

Se você criar seu próprio programa ARSLOG, lembre-se de que o programaARSLOG e quaisquer programas chamados por ele são executados como usuárioQRDARS400. O QRDARS400 deve ter autoridade para todos os objetos utilizadospelo programa ARSLOG.

Os programas do OnDemand são codificados na linguagem C. Entretanto, oprograma ARSLOG pode ser escrito em qualquer linguagem. Você é responsávelpor desenvolver o programa ARSLOG. Valide a qualidade e o desempenho doprograma ARSLOG e de todos os outros programas que ele chama.

Um exemplo de programa ARSLOG CL está no arquivo fonte QSAMPLES2 nasbibliotecas QRDARS e QUSRRDARS. Qualquer código fonte de programa que vocêmodificar não deve ser colocado na biblioteca QRDARS, pois ela é substituída

120 Guia de Planejamento e Instalação

Page 139: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

durante upgrades do software. Entretanto, a biblioteca QUSRRDARS não ésubstituída e pode ser utilizada para a origem modificada.

Após criar seu programa, você deve compilá-lo e colocá-lo em sua própriabiblioteca (não a QRDARS). Em seguida, você deve alterar o link simbólico em/QIBM/PRODDATA/ONDEMAND/BIN/ARSLOG para apontar para seuprograma. Por exemplo, se você chamasse seu programa de MYARSLOG e ocolocasse na biblioteca QUSRRDARS, primeiro excluiria o link simbólico atualusando este comando: RMVLNK OBJLNK('/QIBM/PRODDATA/ONDEMAND/BIN/ARSLOG'). Depois, você incluiria o link em seu programa usando estecomando: ADDLNK OBJ('/QSYS.LIB/QUSRRDARS.LIB/MYARSLOG.PGM')NEWLNK('/QIBM/PRODDATA/ONDEMAND/BIN/ARSLOG')

A ajuda on-line do cliente administrativo fornece informações sobre como ativar oOnDemand para gerar mensagens e enviá-las para o programa ARSLOG. A ajudaon-line também fornece informações sobre como selecionar quais mensagens dogrupo de aplicativos o OnDemand gera e envia para o programa ARSLOG.

Apêndice C. Log do Sistema e Saída do Usuário de Log do Sistema 121

|||||||||

Page 140: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

122 Guia de Planejamento e Instalação

Page 141: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nosEstados Unidos.

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidosnesta publicação em outros países. Consulte um representante IBM local para obterinformações sobre produtos e serviços disponíveis atualmente em sua área.Qualquer referência a produtos, programas ou serviços IBM não significa queapenas produtos, programas ou serviços IBM possam ser utilizados. Qualquerproduto, programa ou serviço funcionalmente equivalente, que não infrinjanenhum direito de propriedade intelectual da IBM, poderá ser usado emsubstituição. Entretanto, a avaliação e verificação da operação de qualquer produto,programa ou serviço não IBM são de responsabilidade do Cliente.

A IBM pode ter patentes ou solicitações de patentes relativas a assuntos descritosnesta publicação. O fornecimento desta publicação não lhe garante direito algumsobre tais patentes. Pedidos de licenças devem ser enviados, por escrito, para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para pedidos de licença relacionados a informações de DBCS (Conjunto deCaracteres de Byte Duplo), entre em contato com o Departamento de PropriedadeIntelectual da IBM em seu país ou envie pedidos de licença, por escrito, para:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições nãoestejam de acordo com a legislação local:A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTAPUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DENENHUM TIPO, SEJA EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS A ELASNÃO SE LIMITANDO, AS GARANTIAS IMPLÍCITAS DE NÃO INFRAÇÃO,COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO.Alguns países não permitem a exclusão de garantias expressas ou implícitas emcertas transações, portanto, essa disposição pode não se aplicar ao Cliente.

Essas informações podem conter imprecisões técnicas ou erros tipográficos. Sãofeitas alterações periódicas nas informações aqui contidas; tais alterações serãoincorporadas em futuras edições desta publicação. A IBM pode, a qualquermomento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nestapublicação, sem aviso prévio.

Referências nestas informações a Web sites não IBM são fornecidas apenas porconveniência e não representam de forma alguma um endosso a esses Web sites.

© Copyright IBM Corp. 2001, 2010 123

Page 142: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Os materiais contidos nesses Web sites não fazem parte dos materiais desseproduto IBM e a utilização desses Web sites é de inteira responsabilidade doCliente.

A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgarapropriada sem incorrer em qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto comobjetivo de permitir: (i) a troca de informações entre programas criadosindependentemente e outros programas (incluindo este) e (ii) a utilização mútuadas informações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condiçõesapropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito nesta publicação e todo o material licenciadodisponível são fornecidos pela IBM sob os termos do Contrato com o Cliente IBM,do Contrato Internacional de Licença do Programa IBM ou qualquer outro contratoequivalente.

Todos os dados de desempenho aqui contidos foram determinados em umambiente controlado. Portanto, os resultados obtidos em outros ambientesoperacionais podem variar significativamente. Algumas medidas podem ter sidotomadas em sistemas em nível de desenvolvimento e não há garantia de que estasmedidas serão iguais em sistemas geralmente disponíveis. Além disso, algumasmedidas podem ter sido estimadas por extrapolação. Os resultados reais podemvariar. Os usuários deste documento devem verificar os dados aplicáveis para seuambiente específico.

As informações relativas a produtos não IBMforam obtidas junto aos fornecedoresdos respectivos produtos, de seus anúncios publicados ou de outras fontesdisponíveis publicamente. A IBM não testou estes produtos e não pode confirmar aprecisão de seu desempenho, compatibilidade nem qualquer outra reivindicaçãorelacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBMdevem ser encaminhadas diretamente a seus fornecedores.

Estas informações contêm exemplos de dados e relatórios utilizados em operaçõesdiárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplosincluem nomes de indivíduos, empresas, marcas e produtos. Todos esses nomessão fictícios e qualquer semelhança com nomes e endereços utilizados por umaempresa real é mera coincidência.

LICENÇA DE COPYRIGHT:Estas informações contêm programas de aplicativos de amostra na linguagemfonte, ilustrando as técnicas de programação em diversas plataformas operacionais.O Cliente pode copiar, modificar e distribuir estes programas de amostra sem anecessidade de pagar à IBM, com objetivos de desenvolvimento, utilização,marketing ou distribuição de programas aplicativos em conformidade com ainterface de programação de aplicativo para a plataforma operacional para a qualos programas de amostra são criados. Esses exemplos não foram testados

124 Guia de Planejamento e Instalação

Page 143: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

completamente em todas as condições. Portanto, a IBM não pode garantir ouimplicar a confiabilidade, manutenção ou função destes programas. Os programasde amostra são fornecidos "NO ESTADO EM QUE SE ENCONTRAM", semgarantia de nenhum tipo. A IBM não será responsável por quaisquer danos quesuscitarem do uso dos programas de amostra.

Se estas informações estiverem sendo exibidas em cópia eletrônica, as fotografias eilustrações coloridas podem não aparecer.

Marcas RegistradasIBM, o logotipo IBM e ibm.com são marcas ou marcas registradas da InternationalBusiness Machines Corporation nos Estados Unidos e/ou em outros países. Seestes e outros termos de marca registrada da IBM estiverem marcados em suaprimeira ocorrência nestas informações com um símbolo de marca registrada (® ou™), estes símbolos indicarão marcas registradas dos Estados Unidos ou de direitoconsuetudinário de propriedade da IBM no momento em que estas informaçõesforem publicadas. Estas marcas registradas também podem ser marcas registradasou de direito consuetudinário em outros países. Uma lista atual de marcasregistradas da IBM está disponível na Web em “Copyright and trademarkinformation” no endereço www.ibm.com/legal/ copytrade.shtml

Adobe, Acrobat, Portable Document Format (PDF) e PostScript são marcas oumarcas registradas da Adobe Systems Incorporated nos Estados Unidos e/ou emoutros países.

Intel® e Pentium® são marcas registradas da Intel Corporation nos Estados Unidose/ou em outros países.

Java e todos os logotipos e marcas registradas baseados em Java são marcasregistradas da Sun Microsystems, Inc. nos Estados Unidos e/ou em outros países.

Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou emoutros países.

Lotus é uma marca registrada da Lotus Development Corporation nos EstadosUnidos e/ou em outros países.

UNIX® é uma marca registrada do The Open Group nos Estados Unidos e emoutros países.

Windows e Windows NT® são marcas registradas da Microsoft® Corporation nosEstados Unidos e/ou em outros países.

Outros nomes de empresas, produtos e serviços podem ser marcas registradas oumarcas de serviço de terceiros.

Avisos 125

Page 144: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

126 Guia de Planejamento e Instalação

Page 145: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Índice Remissivo

Aadministrativas

funções e responsabilidades 16API

Veja interface de programação de aplicativoAPIs 17aplicativo

nomenclatura 43sobre 39visão geral 5, 39

armazenamentobanco de dados 49, 54como calcular 49espaço em disco 52espaço temporário 52importação de dados de índice migrados 54índices migrados 55planejamento para 49relatório 49relatórios de indexação 52relatórios em mídia de arquivamento 55requisitos 49requisitos de armazenamento do log de recuperação 54requisitos de armazenamento do log de transações 54requisitos de armazenamento em archive 55requisitos de armazenamento em disco 52

armazenamento em archiveíndices migrados 55relatórios em mídia de arquivamento 55requisitos 55sobre 21visão geral 21

armazenamento em discorequisitos 52

arquivo ARS.CACHE 72arquivo ARS.CFG

conexões do banco de dados, especificação 86configuração 85criação 72inicialização das instâncias 85instâncias de inicialização automática 85parâmetro ARS_AUTOSTART_INSTANCE 85parâmetro ARS_LANGUAGE 85parâmetro ARS_MESSAGE_OF_THE_DAY 86parâmetro ARS_MSGS_LANGUAGE 85parâmetro ARS_NUM_DBSRVR 86, 107parâmetro ARS_PRINT_PATH 86parâmetro ARS_SUPPORT_CFSOD 86parâmetro ARS_SUPPORT_HOLD 86parâmetro ARS_TMP 86Parâmetro ARSSOCK_RESOLVE_CLIENT_NAME 87parâmetro de espaço temporário 86parâmetro de idioma 85parâmetro de idioma de mensagem 85parâmetro de impressão 86parâmetro de impressão do servidor 86parâmetro de mensagem do dia 86parâmetros do gerenciador de banco de dados 107parâmetros do servidor 86

arquivo ARS.DBFS 72arquivo ARS.INI 72

arquivo de registro do sistema 17arquivos de configuração

como salvar 61arquivos de inicialização 89, 91arquivos de registro 17assistente de relatório 115, 116

Bbackup do banco de dados 92, 105backup e recuperação 57

banco de dados 57documentos 58relatórios 58

banco de dadosbackup 92, 105backup e recuperação 57conexões 86, 107criação 71importação de dados de índice migrados 54logs 54manutenção 91migração 103nomes de campos 43planejamento da manutenção 91processo de expiração 39recuperação 57requisitos de armazenamento do log de recuperação 54requisitos de armazenamento do log de transações 54requisitos de espaço de armazenamento 54requisitos de memória 49tipos de campos 45

Bitmap (BMP) 30BMP (Bitmap) 30

Ccampo de pesquisa de cor da anotação 46, 47campo de pesquisa de texto 47campo do grupo de aplicativos 47campo do segmento 47campos de datas

indexação 34tipo de campo da pasta 46tipo de campo do banco de dados 46

campos de filtrocampos, filtro 37

campos do índicecampos, índice 37

campos estruturados Map Coded Font Format 2 115campos estruturados Shift Out Shift In 115campos estruturados SOSI 115campos MCF2 estruturados 115cargas múltiplas por tabela de banco de dados 38CFSOD 86cliente

APIs 17personalização 17

cliente WindowsAPIs 17

© Copyright IBM Corp. 2001, 2010 127

Page 146: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

cliente Windows (continuação)personalização 17

comandos 17comandos do servidor 17como instalar

software 63software OnDemand 67

como salvar arquivos de configuração 61compactação 51comprimento da senha 43conceitos

aplicativo 5carregamento de dados 10dados do carregamento 10documento 7expiração 11gabinete 6gerenciador de armazenamento 10gerenciador de armazenamento em arquivo 10gerenciador de armazenamento em cache 10grupo de aplicativos 5indexação 10métodos de indexação 7migração 11pasta 5servidor 8servidor de bibliotecas 8servidor de objetos 8visão geral do sistema 4visão geral do sistema cliente/servidor 4

conexão com o banco de dados 86, 107conjuntos de armazenamento 97convenções

nomes 43

Ddados

compactação 51formatos 29indexação 31

dados AFPentrada 29indexação 33

dados de linhaentrada 30indexação 31

dados de SCS Estendidoentrada 30

dados definidos pelo usuário 30dados do carregamento

visão geral 10dados do índice

migração 103dados genéricos

indexação 33dados PDF

indexação 33dados SCS

entrada 29DB2

conexões 86, 107parâmetro ARS_NUM_DBSRVR 107

DBCSassistente de relatório 115, 116campos de grupos de aplicativos 114campos do banco de dados 114

DBCS (continuação)campos estruturados Shift Out Shift In 115campos estruturados SOSI 115exibições lógicas 116fontes 113idiomas, suporte aos 109indexação de dados 115indexador genérico 115indexador gráfico 115, 116páginas de códigos 115programas 116

definição da variável de ambiente de fuso horário 46definição de um conjunto de armazenamento 97definição de um nó de armazenamento 97DHCP

ARSSOCK_RESOLVE_CLIENT_NAME 87documento

definido 1expiração 11indexação 10, 31migração 11sobre 7

documentosbackup e recuperação 58

Eespaço temporário 86

requisitos de memória 52exibições lógicas 116expiração

visão geral 11

Ffontes 113fontes AFP 113formatos de arquivos suportados pelo OnDemand

Bitmap (BMP) 30BMP (Bitmap) 30dados AFP 29dados de linha 30dados de SCS Estendido 30dados definidos pelo usuário 30dados SCS 29GIF (Graphic Interchange Format) 30Graphic Interchange Format (GIF) 30JFIF (JPEG Format Image File) 30JPEG Format Image File (JFIF) 30PCX (Picture Exchange Format) 30PDF (Portable Data Format) 30Picture Exchange Format (PCX) 30PNG (Portable Network Graphics) 30Portable Data Format (PDF) 30Portable Network Graphics (PNG) 30Tagged Image File Format (TIFF) 30TIFF (Tagged Image File Format) 30

formatos dos dados de entrada 29funções

administrativas 16

Ggabinete

visão geral 6

128 Guia de Planejamento e Instalação

Page 147: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

gerenciador de armazenamentoexpiração 11migração 11visão geral 10

gerenciador de banco de dadosexpiração 11migração 11visão geral 10

GIF (Graphic Interchange Format) 30Graphic Interchange Format (GIF) 30grupo de aplicativos

indexação 38nomenclatura 43permissões 42sobre 37tipos de campos 45tipos de campos do banco de dados 45visão geral 5, 37

gruposnomes 43sobre 40visão geral 40

grupos de aplicativosmanutenção 91migração de dados para o armazenamento em archive 91planejamento da manutenção 91

HHOLD 86

Iimportação de dados de índice migrados

requisitos de espaço de armazenamento 54indexação

alternativas 33campos de datas 34dados AFP 33Dados DBCS 115dados de linha 31dados genéricos 33dados PDF 33documentos 31espaço temporário 52grupos de aplicativos 38métodos 7outros dados 33outros programas de indexação 33programa Generic Indexer 34programa PDF Indexer 34programas 7, 33programas aplicativos 33relatórios 32requisitos 31requisitos de espaço 52visão geral 10

indexador genérico 115indexador gráfico 115, 116índices

requisitos de espaço de armazenamento em archive 55índices migrados

requisitos de espaço de armazenamento 55inicialização das instâncias 85inicialização do sistema 89, 91

início de sessãoARSSOCK_RESOLVE_CLIENT_NAME 87

instânciascomo iniciar 85inicialização automática 85

instâncias de inicialização automática 85interface de programação de aplicativo

log do sistema 119programas de saída do usuário 119

interfaces de programação de aplicativos 17

JJFIF (JPEG Format Image File) 30JPEG Format Image File (JFIF) 30

Llista de verificação 65lista de verificação da instalação 65locale 85log, sistema

definição de API 119programas de saída do usuário 119

log de recuperaçãorequisitos de espaço de armazenamento 54

log de transaçõesrequisitos de espaço de armazenamento 54

log do sistemadefinição de API 119programas de saída do usuário 119

logsrequisitos de espaço de armazenamento 54

Mmanutenção de software 61mapeamento de fontes AFP 113mensagens

definição de API 119log do sistema 119programas de saída do usuário 119

migraçãoarmazenamento em cache do armazenamento em

archive 91dados do grupo de aplicativos 91grupo de aplicativos, configuração 103visão geral 11

migração de dados do índice 103migração do sistema

grupo de aplicativos, configuração 103Monarch

integração com o cliente 18

NNLS 109nomes 43nomes de campos 43nomes de campos de consulta 43nomes de campos de pesquisa 43nós de armazenamento 97

Índice Remissivo 129

Page 148: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

Oorganização do banco de dados

cargas múltiplas por tabela de banco de dados 38OS/400 Indexer

visão geral 10

Ppágina

indexação 32páginas de códigos 115parâmetro ARS_AUTOSTART_INSTANCE 85parâmetro ARS_LANGUAGE 85parâmetro ARS_MESSAGE_OF_THE_DAY 86parâmetro ARS_MSGS_LANGUAGE 85parâmetro ARS_NUM_DBSRVR 86, 107parâmetro ARS_PRINT_PATH 86parâmetro ARS_SUPPORT_CFSOD 86parâmetro ARS_SUPPORT_HOLD 86parâmetro ARS_TMP 86Parâmetro ARSSOCK_RESOLVE_CLIENT_NAME 87parâmetro de idioma 85parâmetro de idioma de mensagem 85parâmetro de mensagem do dia 86parâmetro MCF2REF 115parâmetros

ARS_AUTOSTART_INSTANCE 85ARS_LANGUAGE 85ARS_MESSAGE_OF_THE_DAY 86ARS_MSGS_LANGUAGE 85ARS_NUM_DBSRVR 86, 107ARS_PRINT_PATH 86ARS_SUPPORT_CFSOD 86ARS_SUPPORT_HOLD 86ARS_TMP 86ARSSOCK_RESOLVE_CLIENT_NAME 87MCF2REF 115

parâmetros do gerenciador de banco de dadosARS_NUM_DBSRVR 107

pastacampo de pesquisa de cor da anotação 46, 47campo de pesquisa de texto 47campo do grupo de aplicativos 47campo do segmento 47nomenclatura 43nomes de campos 43permissões 41sobre 36tipos de campos 45tipos de campos de consulta 45tipos de campos de pesquisa 45visão geral 5, 36

PCX (Picture Exchange Format) 30PDF (Portable Data Format) 30permissões

grupo de aplicativos 42pasta 41sobre 41visão geral 41

Picture Exchange Format (PCX) 30planejamento de programas de manutenção 91PNG (Portable Network Graphics) 30políticas, migração 97políticas de migração 97Portable Data Format (PDF) 30Portable Network Graphics (PNG) 30

procedimentos de instalação 67processo de expiração 39processo de expiração em cache 39processo de migração em cache 39programa ARSLOG 119programa Generic Indexer 34programa PDF Indexer 34programas aplicativos

indexação com 33programas de gerenciamento

visão geral 11programas de manutenção

planejamento 91programas de saída do usuário

ARSLOG 119log do sistema 119

PTFs 68

Rrecuperação 57

banco de dados 57registro do servidor 17reinstalação de software 61relatório

armazenamento em mídia de arquivamento 55definido viiexpiração 11formatos 29indexação 10, 31migração 11requisitos de memória 49

relatóriosbackup e recuperação 58

requisitosarmazenamento 49armazenamento do banco de dados 54armazenamento do software 52armazenamento em archive 55armazenamento em disco 52banco de dados 54espaço de armazenamento de índice migrado 55espaço de armazenamento para importação de dados de

índice migrados 54espaço temporário 52hardware 25memória 25processador 25relatórios de indexação 52relatórios em mídia de arquivamento 55requisitos de armazenamento do log de recuperação 54requisitos de armazenamento do log de transações 54software 25

requisitos de memória 25requisitos de processador 25requisitos de software

armazenamento 52armazenamento em disco 52

responsabilidadesadministrativas 16

Ssaída do usuário no início de sessão 17saídas do usuário

início de sessão 17

130 Guia de Planejamento e Instalação

Page 149: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

saídas do usuário (continuação)log do sistema 119

senhas 43servidor

visão geral 8servidores

arquivo ARS.CFG 85sistemas de arquivos

armazenamento em cache 91sistemas de arquivos de armazenamento em cache

manutenção 91planejamento da manutenção 91

softwarearquivos de configuração 61como instalar 63como salvar arquivos de configuração 61manutenção 61reinstalando 61software de impressão

como instalar 63software de impressão do servidor

como instalar 63upgrade 61

software de impressãocomo instalar 63espaço temporário 86

software de impressão do servidorcomo instalar 63espaço temporário 86

suporte a idioma nacional 85, 109

TTagged Image File Format (TIFF) 30tarefas

administrativas 16TIFF (Tagged Image File Format) 30tipos de campos 45tipos de campos de consulta 45tipos de campos de pesquisa 45transformação de dados 29

Uupgrade de software 61usuários

nomes 43senhas 43sobre 40visão geral 40

Vvariáveis de ambiente

FH (fuso horário) 46fuso horário (FH) 46

variável de ambiente de fuso horário 46variável de ambiente FH 46verificação da instalação 95visão geral do sistema 4visão geral do sistema cliente/servidor 4

Índice Remissivo 131

Page 150: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

132 Guia de Planejamento e Instalação

Page 151: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91
Page 152: Guia de Planejamento e Instala. · APIs do Servidor .....18 ... Um livro geral de ... Capítulo 16, “Planejamento de Programas de Manutenção”, na página 91

����

Número do Programa: 5770-RD1

Printed in USA

S517-9671-00