common server planning and installation guide

Content Manager OnDemand para iVersion 7 Release 2

Common Server Planning andInstallation Guide

SC19-2790-01

��

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

Aviso da Edição

This edition applies to version 7, release 2 of IBM Content Manager OnDemand for i (product number 5770-RD1)and to all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright IBM Corporation 2001, 2014.

Índice

IBM Navigator for i . . . . . . . . . vii

Accessibility information for ContentManager OnDemand . . . . . . . . . ix

Requisitos do Sistema . . . . . . . . xi

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

About Content Manager OnDemand. . . 3Content Manager OnDemand overview . . . . . 3Visão Geral do Sistema . . . . . . . . . . . 4Conceitos . . . . . . . . . . . . . . . 4

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

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

Gerenciador de Solicitações . . . . . . . . 10Gerenciador do Banco de Dados . . . . . . 10Gerenciador de Armazenamento . . . . . . 11Indexação e carregamento de dados . . . . . 11Programas de Gerenciamento . . . . . . . 12Content Manager OnDemand Web EnablementKit . . . . . . . . . . . . . . . . 13

Preparing for Content ManagerOnDemand . . . . . . . . . . . . . 15Funções e Responsabilidades Administrativas . . . 16Interfaces de Programação de Aplicativos . . . . 17

Customização do Cliente . . . . . . . . . 17APIs do Servidor . . . . . . . . . . . 18Criação de Log do Servidor . . . . . . . . 18

Gerenciamento de Armazenamento deArchive . . . . . . . . . . . . . . 21Gerenciamento de Armazenamento de Archive . . 21Content Manager OnDemand storage objects . . . 21Como Definir a Configuração do Armazenamento 22

Parte 2. Informações dePlanejamento . . . . . . . . . . . 23

Relatórios e Outros Dados . . . . . . 25Coletando Requisitos . . . . . . . . . . . 25Formatos de Dados de Entrada . . . . . . . . 26Dados de Indexação . . . . . . . . . . . 27

Indexação de Documento . . . . . . . . . 27Indexação de Página . . . . . . . . . . 28

Indexing data with Content Manager OnDemandprograms . . . . . . . . . . . . . . 29Como Indexar Relatórios Utilizando Campos deDatas . . . . . . . . . . . . . . . 30

Content Manager OnDemand objects 31Visão Geral . . . . . . . . . . . . . . 31Pastas . . . . . . . . . . . . . . . . 32Grupos de Aplicativos . . . . . . . . . . . 33Aplicativos . . . . . . . . . . . . . . 35Usuários e Grupos . . . . . . . . . . . . 36Content Manager OnDemand user ID relationshipto IBM i user profiles . . . . . . . . . . . 36Permissões . . . . . . . . . . . . . . 37

Visão Geral . . . . . . . . . . . . . 37Permissões da Pasta . . . . . . . . . . 37Permissões do Grupo de Aplicativos . . . . . 38

Regras de Nomenclatura . . . . . . . . . . 39Tipos de Dados e Tipos de Campos . . . . . . 41

Requisitos de Armazenamento . . . . 43Visão Geral . . . . . . . . . . . . . . 43Hierarquia de Armazenamento . . . . . . . . 45Compactação de Dados . . . . . . . . . . 45Cálculo dos Requisitos de Armazenamento emDisco . . . . . . . . . . . . . . . . 46

Software do Sistema . . . . . . . . . . 46Espaço Temporário para Indexação . . . . . 46Armazenamento em Disco para RelatóriosArmazenados. . . . . . . . . . . . . 46Content Manager OnDemand database storage 47Armazenamento do Diário do Banco de Dados 48Espaço Temporário para Importação de Dado doÍndice . . . . . . . . . . . . . . . 48

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

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

Backup and recovery . . . . . . . . 51Visão Geral do Backup e da Recuperação . . . . 51Software de Servidor . . . . . . . . . . . 51Informações do Servidor . . . . . . . . . . 51Content Manager OnDemand database . . . . . 52

Backup de Banco de Dados . . . . . . . . 52Diário do Banco de Dados . . . . . . . . 52Recuperação de Banco de Dados . . . . . . 52

Relatórios . . . . . . . . . . . . . . . 52Armazenamento em Disco . . . . . . . . 53Armazenamento de archive . . . . . . . . 53

Salvar os Arquivos de Configuração 55Content Manager OnDemand files. . . . . . . 55Windows font files . . . . . . . . . . . . 55

© Copyright IBM Corp. 2001, 2014 iii

Parte 3. Instalando o Software . . . 57

Lista de Verificação da Instalação . . . 59

Installing Content Manager OnDemandserver software . . . . . . . . . . . 61Obtaining Content Manager OnDemand software . 61Installing Content Manager OnDemand . . . . . 61

Content Manager OnDemand installationprocedures . . . . . . . . . . . . . 61Installing the Content Manager OnDemandend-user client . . . . . . . . . . . . 63Installing the Content Manager OnDemandadministrative client . . . . . . . . . . 63

Parte 4. Configuração eInicialização do Sistema . . . . . . 65

Criando uma Instância . . . . . . . . 67Sobre as Instâncias . . . . . . . . . . . . 67Configuração de uma ocorrência . . . . . . . 67Alterando a Configuração de uma Instância . . . 69Exclusão de uma Instância . . . . . . . . . 70Início e Parada dos Servidores . . . . . . . . 71

Iniciando os Servidores . . . . . . . . . 71Parando os Servidores . . . . . . . . . . 73Gerenciamento de Trabalho do Servidor . . . . 73

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

Connecting from Content Manager OnDemandclients . . . . . . . . . . . . . . . 74

Como Trabalhar com Instâncias. . . . . . . . 75

Definição do Locale . . . . . . . . . 77Consideração Importante sobre Códigos de Idioma 77Etapas a Serem Executadas Após ConfigurarCódigos de Idioma . . . . . . . . . . . . 78Resolvendo Problemas. . . . . . . . . . . 78

Configuring the ARS.CFG file . . . . . . 81ARS_AUTOSTART_INSTANCE parameter . . . . . . 81ARS_DISABLE_ARSLOG parameter . . . . . . . . 81ARS_LANGUAGE parameter . . . . . . . . . . 82ARS_LDAP_ALLOW_ANONYMOUS parameter. . . . . . 82ARS_LDAP_BASE_DN parameter. . . . . . . . . 82ARS_LDAP_BIND_ATTRIBUTE parameter . . . . . . 82ARS_LDAP_BIND_MESSAGES_FILE parameter . . . . 82ARS_LDAP_IGN_USERIDS parameter . . . . . . . 82ARS_LDAP_MAPPED_ATTRIBUTE parameter . . . . . 83ARS_LDAP_PORT parameter . . . . . . . . . . 83ARS_LDAP_SERVER parameter . . . . . . . . . 83ARS_MESSAGE_OF_THE_DAY parameter . . . . . . 83ARS_MSGS_LANGUAGE parameter . . . . . . . . 83ARS_NUM_DBSRVR parameter . . . . . . . . . 83ARS_PRINT_PATH parameter . . . . . . . . . 84ARS_SUPPORT_CFSOD parameter . . . . . . . . 84ARS_SUPPORT_HOLD parameter. . . . . . . . . 84ARS_TMP parameter . . . . . . . . . . . . 84

ARSSOCK_RESOLVE_CLIENT_NAME parameter . . . . 84

Configurar o Sistema na Inicialização 85Iniciar os Jobs do Servidor . . . . . . . . . 85Iniciar os Monitores . . . . . . . . . . . 85

Planejando Programas de Manutenção 87Manutenção de Dados do Grupo de Aplicativos . . 87Backing up the Content Manager OnDemanddatabase . . . . . . . . . . . . . . . 88

Parte 5. Preparação do Sistemapara Utilização . . . . . . . . . . 89

Saving Content Manager OnDemandpasswords into encrypted files . . . . 91Exemplos de Comandos ARSSTASH . . . . . . 91Sintaxe do Comando ARSSTASH . . . . . . . 92

Verificação da Instalação . . . . . . . 93

Definição das políticas de migração edos conjuntos de armazenamento . . . 95

Configuração do Grupo de Aplicativosdo Log do Sistema . . . . . . . . . 97Mantendo Dados de Log do Sistema noArmazenamento de Archive . . . . . . . . . 97Reduzindo o Tamanho do Log do Sistema . . . . 98

Configurando o Grupo de Aplicativosde Carregamento do Sistema . . . . 101Designando o Grupo de Aplicativos Carregamentodo Sistema a um Conjunto de Armazenamento . . 101

Configuração do Grupo de Aplicativosde Migração do Sistema. . . . . . . 103Atribuição do Grupo de Aplicativos de Migraçãodo Sistema a um Conjunto de Armazenamento . . 103

Backing up the Content ManagerOnDemand data . . . . . . . . . . 105

Parte 6. Apêndices . . . . . . . . 107

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

Apêndice B. suporte ao idiomanacional. . . . . . . . . . . . . . 111Visão Geral . . . . . . . . . . . . . . 111Conversão entre Páginas de Códigos Diferentes . . 111

Quando a Conversão de Caracteres Ocorre? . . 111Mapeamento de Caractere . . . . . . . . 112

iv Planning and Installing for i

|||

||||||

Configuração do Sistema para NLS . . . . . . 113Identificadores de Idiomas, CCSIDs e Códigosde Idiomas . . . . . . . . . . . . . 113Mapping AFP fonts . . . . . . . . . . 114

Criando Grupos de Aplicativos . . . . . . . 114Criando Aplicativos . . . . . . . . . . . 115

Tipo de Dados . . . . . . . . . . . . 115Indexação . . . . . . . . . . . . . 116Visualizações Lógicas . . . . . . . . . . 116

Running Content Manager OnDemand programs 117

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

|||

vi Planning and Installing for i

IBM Navigator for i

IBM Navigator for i é uma poderosa interface gráfica para gerenciar os servidoresIBM® i.

A funcionalidade do IBM Navigator for i inclui navegação no sistema,configuração, recursos de planejamento e ajuda online para guiá-lo pelas tarefas. OIBM Navigator for i torna mais fáceis e mais produtivas a operação e aadministração do servidor, e é a única interface com o usuário para recursos novose avançados do sistema operacional. Também inclui Central de Gerenciamentopara gerenciar vários servidores a partir de um sistema central.

© Copyright IBM Corp. 2001, 2014 vii

viii Planning and Installing for i

Accessibility information for Content Manager OnDemand

For complete information about accessibility features that are supported by thisproduct, see the IBM Content Manager OnDemand for i: Common ServerAdministration Guide.

© Copyright IBM Corp. 2001, 2014 ix

x Planning and Installing for i

Requisitos do Sistema

Para obter os requisitos do sistema, consulte o seguinte: Requisitos do Sistema deHardware e Software

© Copyright IBM Corp. 2001, 2014 xi

http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity-reports/report/html/softwareReqsForProduct?deliverableId=1301098213267

http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity-reports/report/html/softwareReqsForProduct?deliverableId=1301098213267

xii Planning and Installing for i

Parte 1. Introdução

This section provides an overview of the Content Manager OnDemand system andcontains information that can help you better understand how Content ManagerOnDemand works.

This section describes how Content Manager OnDemand manages reports andindex data, includes important information about how Content ManagerOnDemand, the database manager, and the storage manager work to index, load,and retrieve documents, and contains a list of the tasks that Content ManagerOnDemand administrators typically perform to manage a Content ManagerOnDemand system.

© Copyright IBM Corp. 2001, 2014 1

2 Planning and Installing for i

About Content Manager OnDemand

Content Manager OnDemand overviewA Content Manager OnDemand system can support small office environments andlarge enterprise installations with hundreds of system users.

Content Manager OnDemand can dramatically improve productivity and customerservice in many businesses by providing fast access to information stored in thesystem.

Content Manager OnDemand processes the output of application programs,extracts index fields from the data, stores the index information in a relationaldatabase, and stores one or more copies of the data in the system. With ContentManager OnDemand, you can archive newly created and frequently accessed dataon high speed, disk storage volumes and automatically migrate them to othertypes of storage volumes as they age.

Content Manager OnDemand fully integrates the capabilities of AdvancedFunction Presentation (AFP), including management of resources, indexes, andannotations, and supports full fidelity reprinting and faxing of documents todevices attached to a workstation or Content Manager OnDemand server.

Content Manager OnDemand provides administrators with tools to manageContent Manager OnDemand servers, and authorize users access to ContentManager OnDemand servers and data stored in the system.

Content Manager OnDemand provides users the ability to view documents, print,email, and fax copies of documents, and attach electronic notes to documents.

Some of the advantages that Content Manager OnDemand offers include: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

Content Manager OnDemand can provide you with an information managementtool that can increase your effectiveness when working with customers.

Content Manager OnDemand does the following: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

These features mean that Content Manager OnDemand can help you quicklyretrieve the specific data that you need to provide fast customer service.


Visão Geral do SistemaA Content Manager OnDemand system consists of client programs and serverprograms that communicate over a network running the TCP/IP communicationsprotocol, a database manager that maintains index data and server controlinformation, and storage managers that maintain documents on various types ofstorage devices.

Content Manager OnDemand client programs run on workstations attached to thenetwork and communicate with Content Manager OnDemand servers. ContentManager OnDemand client programs operate on personal computers runningWindows systems. O programa cliente é a maneira que o usuário tem paraprocurar e recuperar dados armazenados no sistema. Using the client program,users can construct queries and search for reports, retrieve documents fromContent Manager OnDemand, view, print, email, and fax copies or pages ofdocuments, and attach electronic notes to pages of a document.

Content Manager OnDemand provides the capability to do most client functionsfrom almost any operating system, by using a Web browser.

Content Manager OnDemand servers manage control information and index data,store and retrieve documents and resource group files, and process query requestsfrom Content Manager OnDemand client programs. Os documentos podem estarem volumes de armazenamento em disco, ótico e em fita. New reports can beloaded into Content Manager OnDemand every day. That way, Content ManagerOnDemand can retrieve the latest information generated by application programs.

Content Manager OnDemand client programs and servers communicate over acomputer network supported by TCP/IP. When a user submits a query, the clientprogram sends a search request to the Content Manager OnDemand server. Oservidor 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.

ConceitosThe terms application, application group, folder, and cabinet represent howContent Manager OnDemand stores, manages, retrieves, views, and prints reportsand data, along with the associated index information.

When defining a new report or type of data to Content Manager OnDemand, anadministrator must create an application and assign the application to anapplication group. (se não existir um grupo de aplicativos, o administrador deveráprimeiramente criar um). Antes que os usuários possam pesquisar e recuperardocumentos, um administrador deverá criar ou atualizar uma pasta para utilizar ogrupo de aplicativos e o aplicativo. Para ajudar os usuários a localizar pastasrapidamente, os administradores podem criar gabinetes.

AplicativoAn application describes the physical characteristics of a report to ContentManager OnDemand. Typically you define an application for each program thatproduces output that will be stored in Content Manager OnDemand.


O aplicativo inclui informações sobre o formato dos dados, a orientação dos dadosna página, o tamanho do papel, o comprimento do registro e a páginas de códigosdos dados. The application also includes parameters that the indexing programuses to locate and extract index data and processing instructions that ContentManager OnDemand uses to load index data in the database and documents onstorage volumes.

Grupo de AplicativosAn application group contains the storage management attributes of index fieldsfor the data that you load into Content Manager OnDemand. When you load areport into Content Manager OnDemand, you must identify the application groupwhere Content Manager OnDemand will load the index data and store thedocuments.

An application group is a collection of one or more Content Manager OnDemandapplications with common indexing and storage management attributes.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.

PastaA folder is the user's way to query and retrieve data stored in Content ManagerOnDemand. A folder provides users with a convenient way to find relatedinformation stored in Content Manager OnDemand, regardless of the source of theinformation or how the data was prepared.

Uma pasta permite que um administrador configure uma tela de consulta comumpara vários grupos de aplicativos que podem usar diferentes esquemas deindexação, para que um usuário possa recuperar os dados com uma únicaconsulta. Por exemplo, uma pasta chamada Informações do Aluno deve contertranscrições, contas e grades curriculares, que representam as informaçõesarmazenadas em diferentes grupos de aplicativos, definidas em diferentesaplicativos e criadas por diferentes programas.

The following folders, application groups, and applications (part 1 of 2) graphicillustrates the concepts described in this section.

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, dearmazenamento em cache e de armazenamentoem 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 designarum aplicativo para um grupo de aplicativos.

Grupo(s)de Aplicativos

Aplicativo(s)

About Content Manager OnDemand 5

The following folders, application groups, and applications (part 2 of 2) graphicshows an example.

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)

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.

É possível organizar as pastas que um usuário precisa para gerar diferentes tiposde relatórios. Por exemplo, o usuário precisa reunir informações sobre desempenhode fundos, saldo dos fundos e transações de fundos para um relatório mensal. Ogabinete " Relatório Mensal " contém pastas para cada tipo de informação que ousuário precisa coletar. O usuário também precisa gerar relatórios de desempenhode investimentos para os clientes. Os relatórios de desempenho de investimentosincluem informações sobre desempenho de ações, desempenho de título edesempenho de fundos. O gabinete " Relatório do Cliente " contém pastas paraações, seguro-garantia e fundos. Ambos os gabinetes contêm a pasta paradesempenho de fundos porque o usuário precisa de informações sobre odesempenho de fundos para gerar ambos os relatórios.


Métodos de IndexaçãoÉ possível indexar dados de duas maneiras; indexação de documento ou derelatório.

Content Manager OnDemand provides two ways to index data: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. Content Manager OnDemand supports up to 128 index valuesper item. With document indexing, the user does not necessarily need to knowabout reports or report cycles to retrieve a document from Content ManagerOnDemand.

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. Content Manager OnDemand stores thereport as groups of pages and indexes each group. When reports include asorted transaction value (for example, invoice number), Content ManagerOnDemand can index the data on the transaction value. Isso é feito com aextração dos valores iniciais e finais da transação para cada grupo de páginas ecom o armazenamento dos valores no banco de dados. Esse tipo de indexaçãopermite que os usuários recuperem diretamente um valor de transaçãoespecífico.

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 1. Usando gabinetes para organizar pastas


DocumentosContent Manager OnDemand documents represent indexed groups of pages.Typically a Content Manager OnDemand document is a logical section of a largerreport, such as an individual customer statement within a report of thousands ofstatements.

A Content Manager OnDemand document can also represent a portion of a largerreport. For reports that do not contain logical groups of pages, such as transactionlogs, Content Manager OnDemand can divide the report into groups of pages. Osgrupos de páginas são indexados individualmente e podem ser recuperados naestação de trabalho cliente de forma mais eficaz que um relatório inteiro. Osdocumentos sempre são identificados por data e, normalmente, por uma ou maisoutras maneiras, como o nome do cliente, o número do cliente ou o número datransação.

The diagram below illustrates Content Manager OnDemand applications anddocuments. Um administrador pode definir o aplicativo BILLS para um relatórioque contenha itens lógicos, como os demonstrativos do cliente. O aplicativo BILLSutiliza o método de indexação de documentos para dividir o relatório emdocumentos. Each statement in the report becomes a document in ContentManager OnDemand. Os usuários podem recuperar um demonstrativoespecificando a data e uma combinação de nome e número. Um administradorpode definir o aplicativo TRANS para um relatório que contenha linhas de dadosda transação ordenados. O aplicativo TRANS utiliza o método de indexação derelatório para dividir o relatório em documentos. Each group of 100 pages in thereport becomes a document in Content Manager 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. Content Manager OnDemand retrieves the group that contains the valueentered by the user.

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ção doAplicativo TRANS

Figura 2. Aplicativos e documentos


ServidorThe Content Manager OnDemand server maintains a central database about thereports stored in Content Manager 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, as consultas e os pedidos deimpressão, além de atualizar o banco de dados. O servidor também mantém osdocumentos armazenados em disco e, opcionalmente, trabalha com o gerenciadorde armazenamento em arquivo para manter os documentos em mídia dearquivamento, como a mídia ótica e a fita. O servidor carrega dados, recuperadocumentos e expira documentos.

The Content Manager OnDemand server environment contains severalcomponents: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 eimpressoras, que estão definidas no sistema. As informações de controledeterminam a pessoa que pode acessar o sistema, as pastas que um usuáriopode abrir e os dados dos grupos de aplicativos que um usuário pode pesquisare recuperar.

v Um gerenciador de armazenamento em disco, que mantém os documentos emdisco. 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). Content Manager OnDemandprovides several indexing programs. The OS/400 Indexer can be used to index avariety of data types, and is the most common Content Manager OnDemandindexer for spooled files. The Content Manager OnDemand PDF Indexer can beused to create index data for Adobe Acrobat PDF files. The Content ManagerOnDemand Generic Indexer can be used to process index data for almost anyother type of data that you want to store on the system, such as HTMLdocuments, Lotus WordPro documents, TIFF files, and so forth.

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. Content ManagerOnDemand requires PSF (a product option of IBM i), if you plan to use theContent Manager OnDemand server print function for AFP documents or if youplan to use server fax for any documents in Content Manager OnDemand.

v Content Manager OnDemand management programs to maintain the ContentManager OnDemand database and documents on disk.


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. The interface to the system logging facility is through theSystem Log folder and the System Log user exit within Content ManagerOnDemand.

Os seguintes tópicos contêm informações adicionais:v The Content Manager OnDemand request managerv The Content Manager OnDemand database managerv The Content Manager OnDemand storage managerv Indexação e carregamento de dadosv Content Manager OnDemand management programs

Gerenciador de SolicitaçõesThe request manager processes search requests from Content Manager OnDemandclient programs. Quando um usuário inserir uma consulta, o programa clienteenviará uma solicitação pela rede para o gerenciador de solicitações.

O gerenciador de pedidos trabalha com o gerenciador de banco de dados paracompilar uma lista de itens correspondentes à pesquisa e retorna a lista aoprograma cliente. Quando o usuário seleciona um item para exibição, ogerenciador de pedidos envia um pedido de recuperação ao gerenciador dearmazenamento em disco, se o documento estiver em disco, ou ao gerenciador dearmazenamento em arquivo, se o documento estiver no armazenamento emarquivo. O gerenciador de armazenamento recupera o documento e,opcionalmente, os recursos associados ao item. The Content Manager OnDemandclient program decompresses and displays the document.

Content Manager OnDemand management programs include utilities that maintainthe database and disk storage, including the ability to automatically migrate datafrom the database and disk storage to archive storage. Esses programas utilizam osserviços do gerenciador de pedidos para gerenciar dados de índice, documentos earquivos de recursos.

When a user logs on to the system, Content Manager OnDemand assigns a uniquetransaction number to that instance of the client program. Todas as atividadesassociadas à instância do programa cliente contêm o mesmo número de transação.The request manager records messages generated by the various Content ManagerOnDemand programs in the System Log, for example, logon, query, print, and soforth. As mensagens contêm o número da transação, o ID do usuário, o registro dedata e hora, e outras informações. Os administradores podem abrir a pasta SystemLog e exibir as mensagens. Content Manager OnDemand also provides a SystemLog user exit so that you can run a user-defined program to process messages. Porexemplo, é possível projetar um programa definido pelo usuário para enviar umalerta ao administrador quando determinadas mensagens aparecerem no SystemLog. As mensagens do System Log também podem ser utilizadas para gerarrelatórios de uso e de faturamento.

Gerenciador do Banco de DadosContent Manager OnDemand uses a database manager called DB2 UniversalDatabase (DB2; provided with IBM i), to maintain the index data for the reportsthat you load into the system.


The database manager also maintains the Content Manager OnDemand systemtables that describe the applications, application groups, storage sets, folders,groups, users, holds, cabinets, and printers that you define to the system.

Gerenciador de ArmazenamentoThe Content Manager OnDemand disk storage manager maintains a copy ofdocuments, usually temporarily, on disk.

O gerenciador de armazenamento em disco migra documentos do disco para amídia de arquivamento e remove os documentos cujo período de vigência dedados expirou.

Content Manager OnDemand also supports an archive storage manager. 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. You decidewhich types of archive media that your Content Manager OnDemand system mustsupport, configure the storage devices on the system, and define the storagedevices to the archive storage manager. Para armazenar os dados do grupo deaplicativos é preciso atribuir esse grupo a um conjunto de armazenamento, que égerenciado pelo gerenciador de armazenamento em arquivo.

Indexação e carregamento de dadosThe reports that you store in Content Manager OnDemand must be indexed.Content Manager OnDemand supports several types of index data and indexingprograms.

Por exemplo, você pode utilizar o OS/400 Indexer para extrair dados de índice dosrelatórios armazenados no sistema. Um administrador define os campos de índicee outros parâmetros de processamento que o OS/400 Indexer utiliza para localizare extrair informação de índice dos relatórios. Content Manager OnDemand dataloading programs read the index data generated by the OS/400 Indexer and load itinto the Content Manager OnDemand database. The data loading programs obtainother processing parameters from the Content Manager OnDemand database, suchas parameters used to segment, compress, and store report data on disk and onarchive media. You can define your indexing parameters with the ContentManager OnDemand administrative client. O cliente administrativo inclui umassistente de relatório que lhe permite criar parâmetros de indexação marcando,visualmente, amostras dos dados do relatório. Content Manager OnDemand alsoprovides indexing programs that can be used to generate index data for AdobePDF files and other types of source data, such as TIFF files. See the IBM ContentManager OnDemand for i: Common Server Indexing Reference for details about theindexing programs provided with Content Manager OnDemand.

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


The Content Manager OnDemand data loading program first determines whetherthe report needs to be indexed. Se o relatório precisar ser indexado, o programa decarregamento de dados chamará o programa de indexação apropriado. Theindexing program uses the indexing parameters from the Content ManagerOnDemand application to process the report data. 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. The data loading program works with the database managerto update the Content Manager OnDemand database with index data extractedfrom the report. Dependendo dos atributos de gerenciamento de armazenamentodo grupo de aplicativos, o programa de carregamento de dados pode trabalharcom o gerenciador de armazenamento em disco para segmentar, compactar ecopiar dados do relatório para o disco e o gerenciador de armazenamento dearchive para copiar dados do relatório para o armazenamento de archive.

Programas de GerenciamentoContent Manager OnDemand provides a disk storage manager to maintain andoptimize the database and maintain documents on disk. Geralmente, umadministrador determina os parâmetros de processamento para esses programas,inclusive a freqüência com que eles devem ser executados.

Quando alguém na organização cria um grupo de aplicativos, especifica outrosparâmetros que os programas utilizam para manter os dados do relatórioarmazenados no grupo. Por exemplo, ao criar um grupo de aplicativos, oadministrador especifica o período em que os documentos devem ser mantidos nosistema e se os dados de índice devem ser migrados do banco de dados para amídia de arquivamento. O gerenciador de armazenamento em disco usa asinformações para migrar documentos do disco para a mídia de archive, excluirdocumentos do disco, migrar o dado do índice do banco de dados para a mídia dearchive e excluir o dado do índice do banco de dados. These functions are usefulbecause Content Manager OnDemand can reclaim the disk space released byexpired and migrated data. You should configure your Content Manager

Indexação e Carregamento de DadosDados doRelatório

Dadosde Índice

Banco deDados

ArmazenamentodoDocumento

Grupo de Aplicativos

Aplicativo

Grupos Indexados

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


OnDemand system to automatically start these management programs on a regularschedule, usually once every night or week.

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. An administrator defines managementinformation to the archive storage manager to support the Content ManagerOnDemand data it manages. The management information includes storagevolumes that can contain Content Manager OnDemand data, the number of copiesof a report to maintain, and how long to keep data in the archive managementsystem.

Content Manager OnDemand maintains documents on disk and on archive mediaindependently of each other, until the documents expire. A expiração em umgerenciador 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.

Content Manager OnDemand Web Enablement KitThe Content Manager OnDemand Web Enablement Kit is an optional feature ofContent Manager OnDemand that allows people in an organization to use a Webbrowser to access data stored in a Content Manager OnDemand system.

Por exemplo, você pode fornecer a algumas pessoas o URL (Uniform ResourceLocator) de uma página da Web que lhes permita conectar a um servidorOnDemand e escolher uma pasta para abrir; e pode fornecer a outras pessoas oURL de uma página da Web que lhes permita procurar uma pasta específica.ODWEK verifies that the user has permission to use the Content ManagerOnDemand server, has permission to use the folder, and has permission to viewthe data stored in an application group. 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. The server program uses standard Content Manager

OnDemand interfaces and protocols to access data stored in an OnDemandserver. No additional code is needed on the Content Manager OnDemand serverto support 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 na organização que planejar usar oAFP Web Viewer para visualizar documentos do AFP, deverá instalá-lo em suaestaçã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. The AFP2HTML applet lets users view the outputgenerated by the IBM Content Manager OnDemand Advanced FunctionPresentation Transformations. The IBM Content Manager OnDemand AdvancedFunction Presentation Transformations converts AFP documents and resourcesinto HTML files that can be displayed with the AFP2HTML applet. Se vocêplanejar usar o applet AFP2HTML, deverá obter o Advanced FunctionPresentation Transformations na IBM e o instalá-lo e configurá-lo no servidor daweb. See your IBM representative for more information about the IBM ContentManager OnDemand Advanced Function Presentation Transformations.


Preparing for Content Manager OnDemand

This section contains an outline that you might find helpful as you prepare yourorganization for the Content Manager OnDemand environment and perform apilot roll out of the system.v Trabalhe com um único departamento ou grupo de usuários finais. Send a

memo to the users to explain how Content Manager OnDemand will affect theirdaily work.

v Develop an end-user training course or contract with IBM to provide training forContent Manager 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 Choose a report or set of reports for an initial migration to Content ManagerOnDemand. 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. For example, if you need to convert AFP data to HTML data, youcan use the IBM Content Manager OnDemand Advanced Function PresentationTransformations for IBM i Transform, available from 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. Define archive media devices and storage managementpolicies to Content Manager OnDemand to support the reports that you plan tostore on the system.

v Use the Content Manager OnDemand administrative client to create theapplication groups and applications required to support your reports.

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

v Use the administrative client to define users and groups to Content ManagerOnDemand.

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.


v Update your company's vital records list to include the hardware and softwarerequired by the Content Manager OnDemand system. Update your company'soperations and recovery manuals with information required to operate, support,and backup the Content Manager OnDemand system.

Funções e Responsabilidades AdministrativasContent Manager OnDemand administrators assume responsibility for and takecare of the Content Manager OnDemand system.

The Content Manager OnDemand system includes all sorts of things, includinghardware, application and system software, reports, and users.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 Administrators define Content Manager OnDemand applications and decide

how Content Manager OnDemand will manage data on the servers.v Administrators define Content Manager OnDemand groups and users to the

system and make sure that the client software is installed and operatingproperly.

While Content Manager OnDemand administrators are responsible for thiscollective environment from the viewpoint of Content Manager OnDemand users,it is likely the Content Manager OnDemand administrators are not the only peoplein an organization working on all these components.

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. For example, a ContentManager OnDemand system administrator could maintain Content ManagerOnDemand storage sets, system printers, holds, groups, and users; a ContentManager OnDemand application administrator could maintain application groups,applications, and folders; an operating system administrator could apply baseoperating system upgrades and perform problem determination; and a serviceadministrator could maintain records of system and network hardware andsoftware and make equipment changes.

The following list of items is typical of the tasks required to administer andmaintain a Content Manager OnDemand system. Some of these tasks might be theresponsibility of a person other than a Content Manager OnDemand administrator.v Instalação e upgrade de equipamentosv Installing and maintaining Content Manager OnDemand programs and other

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 arquivo


v Trabalho com os usuários para determinar as necessidades de indexação e derecuperação de relatórios

v Definição das políticas de migração e dos conjuntos de armazenamentov Defining Content Manager OnDemand system printersv Definição dos relatórios para o sistemav Defining Content Manager OnDemand groups and usersv 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 Establishing security and audit policies, for example: set and maintain

passwords and permissions; use Content Manager OnDemand's audit facilitiesto monitor application group and user activity; develop, document, andmaintain change control procedures to prevent unauthorized changes to thesystem

Content Manager OnDemand provides an administrative client to allowadministrators to maintain Content Manager OnDemand objects through aneasy-to-use, graphical user interface. The administrative client is a 32–bit Windowsapplication. O cliente administrativo permite que os administradores definam emantenham aplicativos, grupos de aplicativos, pastas, gabinetes, conjuntos dearmazenamentos, retenções, impressoras do sistema, grupos e usuários. Incluirecursos que permitem aos administradores processar amostra de dados dorelatório e criar parâmetros de indexação e exibições lógicas, marcandovisualmente uma amostra de relatório.

Content Manager OnDemand provides a set of administrative commands to helpadministrators maintain the system. For example, Content Manager OnDemandprovides commands for loading and unloading reports, maintaining the database,disk, and archive storage, and querying and retrieving documents. Muitos doscomandos administrativos podem ser configurados para serem executadosautomaticamente, de modo regular.

Interfaces de Programação de AplicativosContent Manager OnDemand provides several kinds of application programminginterfaces that you can use to customize Content Manager OnDemand clients andwork with objects on the server.

Customizaçã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).

The IBM Content Manager OnDemand: Windows Client Customization Guide providesinformation about customizing the Windows clients.

Preparing for Content Manager OnDemand 17

Por exemplo, é possível integrar o Monarch1 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: Guia de Customização do Cliente para obter informaçõesadicionais.

APIs do ServidorContent Manager OnDemand provides programs that you can use to work withobjects on the system. Exemplo:v The ARSDOC program is a multi–purpose document processing program. O

programa ARSDOC pode ser utilizado para: consultar o servidor e gerar umalista de itens correspondentes à consulta; recuperar documentos do sistema;incluir, excluir e atualizar documentos; e enviar documentos ao equipamento deimpressão do servidor. You can run the ARSDOC program from the commandline or invoke it from a user–defined program.

The IBM Content Manager OnDemand for i: Common Server Administration Guideprovides details about these and other server API programs.

Criação de Log do Servidor

Recurso de Registro do SistemaContent Manager OnDemand provides the system logging facility to help anadministrator track activity and monitor the system.

Content Manager OnDemand can record the messages that are generated by thevarious client and server programs. Por exemplo, o sistema pode ser configuradopara registrar uma mensagem no registro do sistema sempre que um usuárioiniciar sessão. Pode também ser configurado para registrar uma mensagem noregistro do sistema sempre que ocorrer uma tentativa frustrada de início de sessão,e assim por diante. When you use the administrative client to add objects to thesystem and update the database, Content Manager OnDemand records informationabout your actions in the system log. You can use one of the Content ManagerOnDemand client programs to search for and view messages from the system logby time stamp, severity, message number, user ID, and other search criteria.

Saída do Usuário no Registro do SistemaContent Manager OnDemand provides a user exit that can be used to process themessages that are written to the Content Manager OnDemand system log.

Um uso comum da saída do usuário no registro do sistema é aguardar ascondições de erro ou determinadas mensagens e tomar as devidas providências,como a notificação a um administrador ou operador e a execução de algum outroprograma.

A saída de usuário de log do sistema executa o programa ARSLOG após gravarum registro no log do sistema. However, the ARSLOG program that is providedwith Content Manager OnDemand does not perform any functions. Você devesubstituir aquele fornecido pela IBM por seu próprio programa, que executa asfunções de que precisa. Por exemplo, pode-se criar um programa para verificar onúmero da mensagem e a gravidade de cada mensagem gravada no registro dosistema e, quando apropriado, enviar um alerta ao console do sistema.

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


Content Manager OnDemand sends parameters to the system log user exit, such asthe name of the Content Manager OnDemand instance, a time stamp, a log recordidentifier, the user ID that is associated with the action, accounting information forthe user ID, a message severity, a message number, and the text of the message. Asinformações que aparecem na parte de informações da conta da mensagem podemser especificadas para cada usuário definido para o sistema, por meio de umcliente administrativo. Pode-se personalizar o texto das mensagens selecionando oscampos (e os valores) do grupo de aplicativos a serem incluídos na mensagem. Youcan further configure Content Manager OnDemand to provide specific informationto the system log user exit by setting system and application group parameterswith the administrative client.

Preparing for Content Manager OnDemand 19

Gerenciamento de Armazenamento de Archive

Gerenciamento de Armazenamento de ArchiveYou can configure a Content Manager OnDemand system to maintain copies ofreports on disk and in archive storage.

As cópias no armazenamento em arquivo destinam-se ao armazenamento de longoprazo. Content Manager OnDemand supports a variety of optical and tape storagedevices. O Gerenciamento de Armazenamento de Archive inclui os seguintescomponentes:v Um programa servidor que mantém um banco de dados de informações sobre

os dispositivos e os dados que gerencia. The server program also controls thestorage media and devices that you define to Content Manager OnDemand.

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

v A web-based Content Manager OnDemand component of IBM Navigator for ithat you can use to define storage management policies and archive mediadefinitions. The storage management policies determine where data is storedand how long Content Manager OnDemand maintains the data.

Content Manager OnDemand storage objectsThe storage management criteria that you specify determines where and whenContent Manager OnDemand stores reports and how it maintains them.

An administrator creates a Content Manager OnDemand application for eachreport that is to be stored on the system. Os aplicativos com requisitos deindexação semelhantes podem ser colocados em uma coleta chamada de grupo deaplicativos.

When you load a report into Content Manager OnDemand, you assign it to anapplication group. O grupo de aplicativos identifica um conjunto dearmazenamento que aponta para uma política de migração associada. A política demigração identifica a localização (ou localizações) na qual os dados sãoarmazenados. Content Manager OnDemand will automatically store a copy of thereport on disk, unless you specify otherwise. If a migration policy also identifiesarchive storage locations, then Content Manager OnDemand automatically stores acopy of the report in archive storage.

Um ou mais grupos de aplicativos podem especificar o mesmo conjunto dearmazenamento . 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.

For more information on migrating documents and recommendations for storagemanagement criteria defined in your application groups, storage sets, andmigration policies, see the IBM Content Manager OnDemand for i: Common ServerAdministration Guide.


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.

About this task

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.

After collecting the storage requirements, you configure storage devices on thesystem and define devices to Content Manager OnDemand. Por exemplo, vocêdefine uma biblioteca ótica para o servidor IBM i. Then the Content ManagerOnDemand administrator defines storage management policies, using theinformation that you collected about the reports that you plan to maintain on thesystem. For example, the policy information includes the length of time thatContent Manager OnDemand should keep the data that it manages.

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.


Parte 2. Informações de Planejamento

This section is a planning source for Content Manager OnDemand administrators.

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.

This section describes activities that IBM recommends Content ManagerOnDemand administrators perform to plan for the installation of Content ManagerOnDemand and prepare for the operation of Content Manager OnDemand.


Relatórios e Outros Dados

This section contains information that can help you plan for the reports that youwill be storing into Content Manager OnDemand.

You can use the information to help determine the hardware configuration thatyou need to support your Content Manager OnDemand system. We list questionsthat you might ask users of the reports, provide information about the types ofdata that you can store in Content Manager OnDemand, and provide informationabout indexing reports.

Coletando RequisitosPlanning for Content Manager OnDemand requires that you understand how thesystem will be deployed, who will use the system and how they will use it, andother end-user requirements.

Answers to these questions provide information that allows you to properlyconfigure your Content Manager OnDemand system, including the storage andnetwork configuration, to support your applications and users: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 Will Content Manager OnDemand support short-term report management,

long-term archival storage, or both?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 How much time is available to load reports into Content Manager 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 de Dados de EntradaThe types of data listed below, Content Manager OnDemand allows you to storealmost any other type of data on the system.

Content Manager OnDemand supports several types of input data: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.

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.

Por exemplo, é possível definir um aplicativo para os documentos HTML. Quandoo aplicativo é definido, o tipo de arquivo de dados deve ser identificado. O tipo dearquivo determina o programa que o cliente inicia quando o usuário recupera umdocumento. Por exemplo, se o tipo de cliente for HTM, o cliente poderá iniciar oInternet Explorer para visualizar o documento.

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


O AFP suporta objetos gráficos, de texto de apresentação, de imagens e de códigode barras. O armazenamento de dados do AFP no sistema permite umavisualização de fidelidade total de texto de apresentação e objetos de imagens. Forexample, users can retrieve and view customer statements that Content ManagerOnDemand presents using an electronic form, fonts, and images. 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.

When you store reports that contain AFP data, you must also store the resourcesinto Content Manager OnDemand. Os recursos incluem sobreposições, segmentosde página e definições de formulário. Eles também devem estar no processadoronde os dados precisam ser indexados e carregados.

Dados de IndexaçãoOne of the main operations that you do with Content Manager OnDemand is toindex reports.

When you index a report, Content Manager OnDemand extracts index values fromthe report and stores them in the database. Os campos do banco de dadosdefinidos para os grupos de aplicativos recebem os valores de índice. When a useropens a folder, Content Manager OnDemand displays a list of search fields, whichrepresent the database fields. Para executar uma consulta, o usuário digita valoresnos campos de pesquisa. Content Manager OnDemand compares the values fromthe search values with the values in the database fields and retrieves the items thatmatch the query.

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. With Content Manager OnDemand, you can identify the individualcustomer bills within the report as smaller, separate information units, or logicalitems (known as documents in Content Manager OnDemand). Os usuários podempesquisar e recuperar os itens lógicos utilizando identificadores como o número deconta, o nome do cliente e a data.

The reports that you process with Content Manager OnDemand generally fit intoone of two categories: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.

Relatórios e Outros Dados 27

When searching and retrieving these types of reports, Content ManagerOnDemand returns a list of the items that match the user's query and transfers theindividual items to the Content Manager OnDemand client program for viewingand printing. Content Manager OnDemand supports up to 128 fields as indexes orfilters for document-type data. Os campos não devem ser ordenados e podemconter informações numéricas ou de texto. Os campos são armazenados no bancode dados como índices ou filtros. O gráfico mostra um exemplo de um arquivo derelatório e de indexação de documento.

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.

Content Manager OnDemand divides the report data into groups of pages andstores the first and last index values contained in each group of pages in thedatabase. When the user enters a query, Content Manager OnDemand returns a listof the items that match the query. When the user selects an item for viewing,Content Manager OnDemand performs a text search within the item for the valuespecified by the user. The Content Manager OnDemand client program displaysthe first page that contains the value specified by the user. Content ManagerOnDemand uses a single, unique sorted index value for the retrieval of the reportdata, for example, an invoice number or a transaction identifier. O gráfico mostra

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 4. Método de indexação de documento


um exemplo de um arquivo de relatório e de indexação de página.

Indexing data with Content Manager OnDemand programsContent Manager OnDemand provides a variety of methods to index your printdata.

Os seguintes tópicos contêm informações adicionais:v Use the Content Manager OnDemand graphical tool to visually locate and mark

index values from the print pagev Gere os dados do índice no programa aplicativo que gera o relatóriov Use the Content Manager OnDemand PDF Indexer program to index Adobe

PDF filesv Create index data for the Content Manager OnDemand Generic Indexer program

Como Utilizar a Ferramenta GráficaYou can use the Content Manager OnDemand graphical indexing tool to visuallylocate and mark index values from the print data you plan to archive.

This tool is part of the Content Manager OnDemand Administrator client and canbe used during your definition of an application.

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 5. Método de indexação de página

Relatórios e Outros Dados 29

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 Tag Logical Elements (TLEs) no fluxode dados. Esses TLEs podem ser marcados como valores de índice usando aferramenta de indexação gráficas exatamente como quaisquer outros dados napágina de impressão. Alguns programas de aplicativo já fornecem TLEs no fluxode dados. Se não, talvez seja necessário modificar os programas de aplicativo paraincluir TLEs se você optar por usá-los.

Como Indexar Arquivos de Entrada PDFThe Content Manager OnDemand PDF Indexer is a utility that you can use toextract index data from or generate index data about Adobe PDF files.

The index data can enhance your ability to store, retrieve, and view PDFdocuments with Content Manager OnDemand. O PDF Indexer processa osarquivos de entrada PDF. Um arquivo PDF é uma versão destilada de um arquivoPostScript, incluindo estrutura e eficiência. Um arquivo PDF pode ser criado peloAcrobat Distiller ou por um programa especial de driver de impressora chamadoPDFWriter. The IBM Content Manager OnDemand for i: Common Server IndexingReference provides details about the PDF Indexer program and shows examples onhow to use it to process PDF input files.

Gerando Dado do Índice no Formato Generic IndexerContent Manager OnDemand provides the Generic Indexer so that you can createindex data for files that cannot be indexed using other methods, such as theOS/400 Indexer.

Por exemplo, é possível criar um arquivo de índice no formato Generic Indexerque descreva um conjunto de arquivos de entrada que contêm dados no formatode imagem TIFF. O arquivo de índices contém os campos e valores de índice decada arquivo a ser processado. The index file also describes where the ContentManager OnDemand data loading process can find documents within a file.Content Manager OnDemand will create a row in the database for each indexrecord contained in the index file. Os usuários podem pesquisar o banco de dadosutilizando uma combinação dos campos do índice que foram definidos no arquivode índices. The IBM Content Manager OnDemand for i: Common Server IndexingReference describes the generic index file format.

Como Indexar Relatórios Utilizando Campos de DatasPara armazenar dados no sistema, cada relatório deve ser indexado com umcampo de data.

When querying the database, Content Manager OnDemand uses the date in areport to distinguish one report's data from another. O desempenho da recuperaçãotambém pode ser melhor ao usar um campo de data que foi definido como umcampo de segmento. In addition, Content Manager OnDemand also uses the reportdate to determine when to remove reports from disk and how long to maintainreport data (index data and documents) on the system.

Utilize as datas que aparecem no relatório, como a data de execução, a data detransação ou a data do demonstrativo. If the data that you want to store in ContentManager OnDemand does not contain a date, you can use the date that the reportwas loaded into the system.


Content Manager OnDemand objects

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

Visão GeralWhen you install and configure the Content Manager OnDemand software, youcreate and initialize a set of database tables that form the internal framework of thesystem.

When you define a report to the system, Content Manager OnDemand adds anapplication group table structure and other control information to the database.

Content Manager OnDemand uses a set of objects to describe the database tables,fields, and data that make up the system. When you define an object to ContentManager OnDemand, such as an application group, Content Manager OnDemandstores the choices that you make and the information that you enter about theapplication group into the database. Every time that you load a report into anapplication group, Content Manager OnDemand updates the database with controlinformation, inserts rows of index data into an application group table, and storesreport data and resource files on storage volumes.

Users of the Content Manager OnDemand system open a folder to query andaccess reports that are stored on the system. A folder is the primary ContentManager OnDemand object that users deal with. A folder provides users the meansto search for and retrieve data stored in Content Manager OnDemand. Os usuáriosabrem 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.

An application group represents the index and report data that you load intoContent Manager OnDemand. The Content Manager OnDemand database containstables of application group data. 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.

A Content Manager OnDemand application includes a description of the physicalcharacteristics of a report, such as the type of data contained in the report and therecord format of the input file, instructions to the indexing and loading programsthat process the report, and information that Content Manager OnDemand uses todisplay and print pages of the report. Typically, you define an application for eachtype of report that you plan to store in Content Manager OnDemand. É possívelagrupar os aplicativos com as mesmas características de armazenamento e camposde índice em um grupo de aplicativos.

You assign a unique name to each object that you define to Content ManagerOnDemand, such as application groups, applications, and folders.

Content Manager OnDemand uses properties to describe the appearance, behavior,and internal structure of the objects that make up a Content Manager OnDemand


system. For example, Display Format is a property of a folder field that determineshow Content Manager OnDemand client programs display the values of the fieldin the document list. As propriedades são agrupadas em categorias. Por exemplo, acategoria Geral, nas pastas, contém propriedades que descrevem as informaçõesgerais sobre uma pasta, como o nome e a descrição da pasta e os grupos deaplicativos 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, criam consultas e recuperam relatórios dos grupos deaplicativos (entretanto, não há necessidade de conhecerem ou compreenderem osgrupos de aplicativos). Ao criar uma pasta, defina a pesquisa e exiba os camposque aparecem no momento em que os usuários abrem a pasta. Mapeie os camposda pasta nos campos do banco de dados, nos grupos de aplicativos referidos pelapasta. Os campos do banco de dados contêm valores de índice que foram extraídosdos relatórios para os grupos de aplicativos. Por exemplo, o campo de pesquisa dapasta Número da Conta do Cliente pode ser mapeado no campo acct# do banco dedados do grupo de aplicativos. Content Manager OnDemand creates databaserecords that include the index values for the acct# field when you load a reportinto the application group. When the user enters a query, Content ManagerOnDemand retrieves records from the database if the values of the acct# databasefield match the value that the user typed in the Customer Account Number searchfield.

When you define a folder to Content Manager OnDemand, you add one or moreapplication groups to the folder, select index fields from the application groups toappear as search and display fields when the user opens the folder, and specify theproperties of the search and display fields. Por exemplo, pode-se determinar olayout dos campos de pesquisa na tela e especificar os valores que aparecerãoautomaticamente nos campos de pesquisa quando o usuário abrir a pasta.

Content Manager OnDemand maintains information about the name of the folderand its structure in the Content Manager OnDemand database. Por exemplo, obanco de dados contém informações que descrevem os campos de pesquisa e deexibição definidos e os campos do banco de dados selecionados nos grupos deaplicativos referidos pela pasta.

You define a folder to Content Manager OnDemand through properties and valuesgrouped in categories. Uma categoria é um conjunto de propriedades relacionadas.Content Manager OnDemand provides folder categories for general information,permissions, field definitions, field information, and field mapping. A categoriaGeral é onde se especificam as propriedades gerais sobre a pasta, como o nome dapasta e os seus grupos de aplicativos. A categoria de permissões é onde sedeterminam os grupos e usuários que podem abrir a pasta. Atribua outros tipos deautoridade para a pasta na categoria de permissões, como a especificação de umapessoa para administrar a pasta. A categoria de definições do campo é onde sedefinem os campos de pesquisa e de exibição para a pasta. A categoria deinformações do campo é onde se especificam os atributos dos campos de pesquisae de exibição. Por exemplo, é possível especificar os operadores de pesquisadisponíveis para cada campo e determinar a ordem em que os campos de pesquisaaparecem na tela. A categoria de mapeamento do campo é onde se mapeiam oscampos de pesquisa e de exibição da pasta nos campos do banco de dados, nosgrupos de aplicativos mencionados pela pasta.


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.

The application group is the object that Content Manager OnDemand uses tomaintain the reports that you load into the system. O grupo de aplicativos contémos dados de índice de relatórios, documentos, informações de gerenciamento,permissões para os grupos e usuários com autoridade de acesso ao grupo deaplicativos, 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. When you define an application group, Content Manager OnDemandcreates an application group table structure in the database, with a column for eachdatabase field that you defined. When you load a report into the applicationgroup, Content Manager OnDemand inserts rows into an application group tablefor each indexed item found in the report. Um item indexado pode ser um itemlógico, como uma política ou instrução, ou um grupo de páginas, dependendo decomo o relatório está organizado e de como se decidiu indexar o relatório. Osusuários pesquisam os relatórios utilizando um ou mais campos definidos para ogrupo de aplicativos.

Content Manager OnDemand supports up to 128 index and filter fields for eachapplication group: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. Content Manager OnDemand uses index fields tolocate the records in the database that meet the search criteria entered by theuser. O registro de índice contém a localização física de um item em um volumede 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.

Content Manager OnDemand requires a segment field for each application groupthat you define. Content Manager OnDemand uses the segment field to organizeand maintain application group data and to locate items that match a query. 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.

Content Manager OnDemand objects 33

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 contidasno relatório. Content Manager OnDemand can index, store, and retrieve datacontained in a report based on the structure of the data that it contains.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. Content Manager OnDemand can index,store, and retrieve the logical items contained in a report. Cada item lógico podeser indexado em até 128 valores, por exemplo, número da conta, nome do clientee saldo. Content Manager OnDemand creates a row in the database for eachlogical item it finds in the report.

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. Content ManagerOnDemand can index, store, and retrieve information from these types of reportsusing index values such as date, page number, and a sorted value, such astransaction number. Content Manager OnDemand divides these types of reportsinto groups of pages and indexes each group of pages. 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.

When you create an application group, you specify how Content ManagerOnDemand should store the index data for the reports that you load into theapplication group. Content Manager OnDemand provides a method that you canuse to determine how index records are loaded into the database and how userscan query the application group:v Cargas múltiplas por Tabela de banco de dados

With this method, each time that you load a report into the application group,Content Manager OnDemand inserts the index records into an existing databasetable. Os registros do índice de cada relatório carregado no grupo de aplicativossão armazenados na mesma tabela do banco de dados. Content ManagerOnDemand maintains the application group data so that, as far as a userquerying the application group knows, they appear to reside in one databasetable. Content Manager OnDemand automatically segments the applicationgroup data when it grows beyond a certain size. Content Manager OnDemandmaintains a segment table for each application group. A tabela de segmentosfornece melhor desempenho de consulta, ao limitar as pesquisas a uma tabelaespecífica de dados do grupo de aplicativos e ao utilizar um valor de dadospara elaborar a consulta.

When you create an application group, you specify the storage characteristics ofthe report, such as the length of time that Content Manager OnDemand maintainsdata stored in the application group and the data migration values. The storagecharacteristics also determine whether Content Manager OnDemand stores a copyof the report on archive media, whether Content Manager OnDemand shouldcreate a backup copy of the report, and when Content Manager OnDemandremoves report data when it is no longer needed.

Content Manager OnDemand can perform three types of processing on applicationgroup data: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). Content Manager OnDemand provides acommand that you can use to remove index data. 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. Content Manager OnDemand provides acommand that you can use to copy reports to archive storage. Normalmente, ocomando é definido para ser executado automaticamente, dentro de umaprogramação regular. A migração do disco otimiza o uso do armazenamento emdisco, ao mesmo tempo que fornece excelente desempenho para as recuperaçõesde relatórios em curto prazo. As a report ages, and in all likelihood accessesbecomes less frequent, Content Manager OnDemand can automatically copy thereport to long-term (archive) storage. É possível ainda utilizar a migração dodisco para prorrogar o carregamento dos relatórios para o armazenamento emarquivo para quando 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. Content ManagerOnDemand provides a command that you can use to delete reports from disk.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.

AplicativosA Content Manager OnDemand application describes the physical characteristics ofa report, processing instructions for the indexing and data loading programs, andinformation about how Content Manager OnDemand displays and prints pages ofa report.

You can specify default settings for viewing and printing pages of a report at theContent Manager OnDemand application level. For example, if you select a defaultprinter for the application, when a user prints a document that is associated withthe application, Content Manager OnDemand sends the document to the printerthat you specified. Normalmente, define-se um aplicativo para cada relatóriodiferente 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). Content Manager OnDemand uses the informationthat you specify to properly interpret the data for viewing.

The Content Manager OnDemand application is where you specify information tothe indexing and data loading programs, such as the technique that ContentManager OnDemand uses to compress the report file, the parameters used to indexthe data, and information that Content Manager OnDemand uses to process indexdata before loading index records into the database. Content Manager OnDemand


uses the indexing parameters, options, and data values that you specify to locateindex data in and extract index data from the report.

Configure uma ou mais exibições lógicas de um relatório. A logical viewdetermines how Content Manager OnDemand displays line data reports andgoverns other viewing characteristics. For example, you can set up a logical viewso that when a user selects a document for viewing, the Content ManagerOnDemand client program automatically locks the heading of the report in placewhen the user scrolls up or down on a page.

Usuários e GruposEach user logs on to Content Manager OnDemand with a user ID. ContentManager OnDemand authenticates user IDs and determines the usage andadministrative authority available to the user based on the log on user ID.

A Content Manager OnDemand user ID does not necessarily have to identify anindividual user. However, for accounting and security purposes, you probablywant to assign a Content Manager OnDemand user ID to each person that uses thesystem.

Content Manager OnDemand automatically creates the QONDADM user ID whenyou initialize the system. 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 efetuar login 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 armazenamentos, gabinetes, eimpressoras.

Content Manager OnDemand groups are a means to organize users by function,authorization, holds, or any other purpose you might require. When you define aContent Manager OnDemand group, you can organize users by department orfunction and set folder and application group permissions that are common to allof the users assigned to the group. As permissões determinam os tipos de açõesque os usuários atribuídos ao grupo podem executar. Não é preciso atribuir umusuário a um grupo, porém, fazendo isso a administração dos usuários comrequisitos e recursos semelhantes é simplificada.

Content Manager OnDemand groups are not the same as IBM i group profiles, butyou might choose to use the same names if that is easier to maintain.

Content Manager OnDemand user ID relationship to IBM i user profilesWhen you install Content Manager OnDemand, a default logon security user exitis enabled that forces a relationship between your Content Manager OnDemanduser IDs and your IBM i user profiles.

If you use Content Manager OnDemand as installed, then the following is true:v A Content Manager OnDemand user ID must match an IBM i user profile.v The password when logging on to Content Manager OnDemand is the same as

the password used when logging on to IBM i. If you change the password usingContent Manager OnDemand, it actually changes the IBM i password. Whenyou create a Content Manager OnDemand user ID, you actually leave thepassword field blank.


v Defina o Prazo Máximo da Senha como A Senha Nunca Expira. If you specify avalue for Maximum Password Age, then Content Manager OnDemand mightforce a user to change their password before it is required by IBM i.

v Defina o Comprimento Mínimo da Senha como Permitir Senha em Branco. Thisprevents Content Manager OnDemand from trying to impose its own rules onthe length of a password and allows IBM i to use its own rules.

If the security exit is not enabled, then the Content Manager OnDemand user IDand password have no relation to the IBM i user ID and password and all theContent Manager OnDemand System Parameter settings are honored.

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 a pastaInformaçõ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 usar as configurações do grupolistadas na tabela, um usuário designado a ambos os grupos poderão acessar aspastas Notas do Aluno e Históricos Escolares de Alunos.

Tabela 1. Permissões do grupo

Grupo Pastas

Conta Contas do aluno

Admissões Transcrições do aluno

Entretanto, há exceções à regra. See information about permissions in the IBMContent Manager OnDemand for i: Common Server Administration Guide for details.

You can set folder and application group permissions for every user and groupdefined to Content Manager OnDemand. Se as permissões forem definidas paraum grupo específico, as permissões do grupo terão precedência sobre as definidasem nível de pasta ou de grupo de aplicativos. Se as permissões forem definidaspara um usuário específico, as permissões do usuário terão precedência,independentemente do grupo que o inclui ou das permissões definidas em nível depasta ou de grupo de 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 da PastaAs permissões para pasta podem ser definidas no nível de pasta, grupo e usuário.Setting permissions at the folder level provides all Content Manager OnDemandusers and groups that are not otherwise given permissions with the permissionsthat you define.


A definiçã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 gruposubstituem 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.

É possível configurar os seguintes tipos de permissões de pasta:v Acesso. Users can open the folder with Content Manager OnDemand client

programs and search for and retrieve data from the application groupsreferenced in the folder.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. Users can open the folder with Content Manager OnDemand clientprograms and can modify the folder field information with the administratorinterface. Content Manager OnDemand maintains a set of folder fields for eachuser given fields permission for the folder.

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. Content Manager OnDemand supports two typesof named queries: public, that is, a named query that is available to all users thatcan open the folder, and private, that is, a named query available only to theuser that created the named query. Os usuários podem receber autoridade paraexibir, 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 do Grupo de AplicativosAs permissões para grupo de aplicativos podem ser definidas em nível de grupode aplicativos, grupo e usuário. Setting permissions at the application group levelprovides all Content Manager OnDemand users and groups that are not otherwisegiven permissions with the permissions that you define.

A definição de permissões em nível de grupo concede as permissões definidas atodos os usuários que foram incluídos no grupo. As permissões em nível de gruposubstituem as de nível de grupo de aplicativos. A definição de permissões em nívelde usuário concede as permissões definidas a um usuário específico. As permissõesem nível de usuário substituem as 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. Users can search for and retrieve data stored in the application group

using Content Manager OnDemand client programs.


v Documento. Determina o tipo de funções do documento que os usuários podemexecutar. 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.

v Exibições lógicas. Logical views determine how Content Manager OnDemanddisplays report file pages. Users can define their own logical views with ContentManager OnDemand client programs.

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 NomenclaturaWhen you create objects in Content Manager OnDemand, you assign names to thevarious objects.

If you install Content Manager OnDemand with a language that requires multiplebytes per character (for example, Kanji), the number of characters permitted for aname is less than the number listed in the sections that follow.

Ao se nomear um usuário, o nome especificado:v Can contain from one to 128 bytes, depending upon whether your Content

Manager OnDemand user names are linked to your IBM i user profile names. Ifyou are using Content Manager OnDemand as shipped, your Content ManagerOnDemand user names are linked to your IBM i user profile names. Essa é aconfiguração padrão e aplicável à maioria dos clientes. However, you canchange this if you like, so that there is no relationship between your ContentManager OnDemand user names and your IBM i user profile names.

v Cannot include the * (asterisk), % (percentage) + (plus), [ (left bracket), ] (rightbracket), “ (double quotation mark)

v Deve ser exclusivov By default, Content Manager OnDemand converts lowercase letters in a user

name to uppercase (for example, laguarde is stored as LAGUARDE)

Se você definir sua própria saída de usuário de logon, poderá determinar ascaracterísticas dos IDs do usuário em seu sistema.

Ao se criar uma senha, o valor a ser especificado:v Pode conter de um a 20 bytes. Ao criar uma senha, o valor especificado poderá

ter no máximo 20 bytes. However, the password authentication that is built intoContent Manager OnDemand verifies only the first eight characters that areentered by the user. Os caracteres adicionais são fornecidos aos clientes queoptaram por 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 Suporte daIBMpara obter informações adicionais sobre a saída do usuário para início de sessão.


v By default, Content Manager OnDemand converts lowercase letters in apassword to uppercase (for example, laguarde is stored as LAGUARDE). Se vocêdefinir uma saída do usuário para início de sessão, então será preciso determinaras características das senhas no sistema.

Ao se nomear um grupo, o nome especificado:v Pode conter de um a 128 bytesv Cannot include the * (asterisk), ' (apostrophe) % (percentage) + (plus), [ (left

bracket), ] (right bracket), “ (double quotation mark)v Deve ser exclusivov Can be mixed case; however, Content Manager OnDemand ignores the case (for

example, LaGuarde is the same as laguarde)

Ao se nomear um grupo de aplicativos, aplicativo ou pasta, o nome especificado:v Pode conter de um a 60 bytes, inclusive espaços em branco integrados. Se você

preferir utilizar a função de monitor da fila de saída do OnDemand paracarregar automaticamente os relatórios, será preciso nomear os aplicativos egrupos de aplicativos, como os dez primeiros caracteres correspondentes aonome de arquivo em spool, os dados do usuário, o tipo de formulário ou umdos demais atributos do arquivo em spool. Consulte o IBM Content ManagerOnDemand for i: Guia de Administração do Common Server para obter detalhesadicionais sobre monitores de fila de saída.

v Cannot include the '% (percentage), [ (left bracket), ] (right bracket), or “ (doublequotation mark) characters

v Can be mixed case; however, Content Manager OnDemand ignores the case (forexample, LaGuarde is the same as laguarde)

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 bytesv 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 Can be mixed case; however, Content Manager OnDemand doesn't create a

unique name (for example, rDate is the same as rdate)v Deve ser exclusivo do grupo de aplicativosv Cannot be any of the Content Manager OnDemand reserved words:

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 30 bytesv Pode ter letras maiúsculas e minúsculas juntas


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 60 bytes, inclusive espaços em branco integradosv Can be mixed case; however, Content Manager OnDemand ignores the case (for

example, Report Date is the same as report date)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 60 bytesv Can be mixed case; however, Content Manager OnDemand ignores the case (for

example, LaGuarde is the same as laguarde)v Deve ser exclusivo

Ao se nomear a impressora do servidor, o nome especificado:v Pode conter de um a 60 bytesv Can be mixed case; however, Content Manager OnDemand ignores the case (for

example, LaGuarde is the same as laguarde)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 CamposWhen you define an application group, Content Manager OnDemand creates astructure for a database table with the index and filter fields that you define.

When you store a report in the application group, Content Manager OnDemandextracts index data from the report, places the index data into the database fields,and inserts rows into the application group table. Os campos do banco de dadosdefinidos para o grupo de aplicativos podem conter diferentes tipos de dados. Aodefinir os campos do banco de dados, selecione o tipo de dados para cada campo.The data type tells Content Manager OnDemand what kind of data can be storedin the field.

When you define a folder to Content Manager OnDemand, the fields that youdefine can be used in two ways: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

Consulte a ajuda do cliente do administrador para obter uma lista de tipos decampos da pasta.


Requisitos de Armazenamento

Visão GeralEstimating storage requirements for a Content Manager OnDemand system beginswith understanding and documenting end-user requirements for storing andaccessing data.

Antes de transformar essas necessidades em um subsistema de armazenamentopara oferecer suporte ao sistema, revise as diversas questões operacionais e dedesempenho. For example, Content Manager OnDemand supports up to 128 indexfields for each report. Entretanto, os usuários não devem precisar de muitos índicespara localizar uma versão específica de um relatório ou de um documento dentrodo relató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. You should review how users search for and retrieve informationfrom the reports that you plan to store in Content Manager OnDemand. Porexemplo, 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.

There are several components that you need to measure to determine the amountof disk, optical, and tape storage required to support a Content ManagerOnDemand system. Por exemplo, os componentes a seguir do sistema exigemarmazenamento em disco:v Storage space for application programs and system software, including the base

operating system, the Content Manager OnDemand server software, and anyother applications on the IBM i that are required to run your business.

v Espaço de armazenamento para arquivos de configuração e de controle.v Storage space for the Content Manager OnDemand system logging facility.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.

v Temporary storage space for indexing a report on the Content ManagerOnDemand server.


v Temporary storage space for loading a report on the Content ManagerOnDemand server.

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.Content Manager OnDemand compresses report data before storing it. A taxa decompactação pode ter influência significativa na quantidade de espaço em disconecessária para armazenar um relatório. Content Manager OnDemand canachieve up to 30:1 compression on line data reports. Entretanto, no caso derelatórios que contêm dados AFP ou dados de imagens já compactadas, acompactação atingida é muito menor.For sorted transaction data, the examplesand calculations that follow assume that Content Manager OnDemand createsone indexed item for each group of 100 pages in a report. O número de páginasem um grupo é um parâmetro que você pode configurar ao indexar umrelatório. The IBM Content Manager OnDemand for i: Common Server IndexingReference provides move information.

v Storage space for the database, which includes Content Manager OnDemandsystem tables (control information and objects that you define to ContentManager OnDemand) and application group tables (index data extracted fromreports). A quantidade de espaço no banco de dados que deve ser planejadapara um relatório é um fator do número de documentos ou seções contidos norelatório, do número de campos de índice definidos para o relatório, do númerode versõ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.For reports that contain sorted transaction data, Content Manager OnDemandcan divide the report into groups of a fixed number of pages and create oneindex row for each group of pages. For reports that contain logical items, suchas statements, and policies, Content Manager OnDemand can create one indexrow for each logical item in the report. Normalmente, o espaço necessário nobanco de dados para indexar dados de transação ordenados é muito menor queo espaço em banco de dados necessário para indexar relatórios que contenhamitens lógicos. Além disso, os campos de índice oferecem pesquisa rápida, masexigem um espaço significativo de espaço no banco de dados.

v Storage space for the Content Manager OnDemand journal and journal receivers.You should plan for disk space for the Content Manager OnDemand journal andreceivers used for commitment control.

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 seguintes componentes do sistema requerem armazenamento de archive(armazenamento ótico e em 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. For example, you might decide to remove full storagevolumes from a library one year after the last time that Content ManagerOnDemand wrote report data to the storage volume. Os volumes dearmazenamento cheios podem ser substituídos por volumes de armazenamento


recém-inicializados para manter os relatórios mais recentes armazenados nosistema. Dessa forma, as versões mais recentes de um relatório estão sempredisponíveis na biblioteca. Entretanto, se for necessário manter vários anos de dadosde relatório on-line na biblioteca ou armazenar grandes quantidades de dados nosgrupos do aplicativo, pode ser necessário planejar várias bibliotecas óticas nosistema.

Hierarquia de Armazenamento

There are several different storage management strategies that you can use withContent Manager OnDemand.

For example, Content Manager OnDemand allows data to be migrated from onestorage media type to another using criteria defined by an administrator. Oarmazenamento em disco pode ser utilizado para acesso em alta velocidade aosrelatórios. When you load a report on the system, Content Manager OnDemandcan automatically store one copy of the report on disk and another copy of thereport on archive storage media. Content Manager OnDemand also supports theoption of storing reports on disk and then later migrating them to archive storage.Entretanto, recomendamos que você sempre planeje copiar relatórios e mídia dearquivamento para o disco ao mesmo tempo (ao carregar o relatório). Dessa forma,é eliminada a necessidade de fazer backups periódicos do armazenamento emdisco, pois já existe uma cópia de backup dos relatórios na mídia de arquivamento.A cópia de relatórios para o armazenamento em cache e o armazenamento dearchive ao mesmo tempo elimina a necessidade de migrar relatórios para a mídiade 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.Content Manager OnDemand provides a command that you can use toautomatically remove expired reports from disk on a regular schedule. After yourun expiration processing, Content Manager OnDemand reclaims the space takenby expired documents.

Content Manager OnDemand maintains documents on disk and on archive mediaindependently of each other until the documents expire. Cada um utiliza seuspróprios critérios para determinar quando os dados expiram e devem serremovidos do sistema; cada um utiliza os seus próprios comandos para removerdocumentos. Você precisa decidir como os dados serão expirados de seu sistema eaplicar esses padrões consistentemente ao criar seus grupos de aplicativos epolíticas de migração.

Compactação de DadosContent Manager OnDemand can compress report data using several different datacompression algorithms, before storing the data on disk and archive storage.

The compression ratio that Content Manager OnDemand can achieve has asignificant impact on the amount of space required to store reports.

The compression ratios that Content Manager OnDemand can achieve vary widelydepending on the type of data and the format of the data. Nem sempre é possívelfazer uma estimativa precisa da taxa de compactação simplesmente examinando os

Requisitos de Armazenamento 45

|||||||

dados. Em média, o esperado é atingir compactação entre 2:1 e 15:1 paradocumentos AFP e até 30:1 em relatórios de dados em linha. A compactação dedocumentos AFP é baseada no arquivo de dados de saída produzido peloindexador e não no arquivo de entrada, que pode ter dados em linha. Quando oindexador formata dados em linha com uma definição de página, pode aumentar otamanho dos dados incluindo 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. É possível armazenar umrelatório usando o comando ADDRPTOND. O comando ADDRPTOND colocaráentradas no log do sistema, que fornecerão valores de tamanho antes e depois, quepodem ser usados para calcular a proporção de compactação real atingida.

See the IBM Content Manager OnDemand for i: Common Server Administration Guidefor more information about the ADDRPTOND command.

Cálculo dos Requisitos de Armazenamento em Disco

Software do SistemaContent Manager OnDemand servers require disk space for a wide range ofsoftware products to support the business applications running on them.

This includes the operating system software, business application software,temporary work space, and the Content Manager OnDemand server software.

Espaço Temporário para IndexaçãoContent Manager OnDemand requires temporary storage space on disk to indexreports.

The temporary space required by Content Manager OnDemand is a factor of thelargest occurrence of a report and the number of reports that you plan to index atthe same time.

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 ArmazenadosThe amount of disk space that you should dedicate to stored report data variesgreatly based on requirements such as the number of reports that you store on thesystem, the compression ratio that Content Manager OnDemand can achieve, andthe amount of time that you need to keep a report on disk.


A maior parte dos clientes armazena relatórios em disco por um tempo curto paraobter uma recuperação mais rápida dos relatórios mais utilizados. Conforme osrelatórios ficam mais antigos e seus pedidos de recuperação são menos freqüentes,eles podem ser recuperados da mídia de arquivamento. Outro motivo para manteros relatórios no disco é para que vários usuários tenham acesso a eles ao mesmotempo. Como o gerenciador de armazenamento do archive pode precisar de seis asessenta segundos para montar um volume de armazenamento ótico ou de fita erecuperar um relatório, normalmente não é possível oferecer suporte a taxa de altatransação para relatórios armazenados em mídia de arquivamento.

Os relatórios não são excluídos automaticamente, a menos que o programa queexclui relatórios estiver configurado para executar em uma base planejada.

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

Content Manager OnDemand database storageWhen you load a report into the system, Content Manager OnDemand extractsindex data from the report and stores it in an application group table in thedatabase.

For reports that contain logical items, such as statements and policies, ContentManager OnDemand can create one database row for every item found in thereport. For reports that contain sorted transaction data, Content ManagerOnDemand can creates one database row for every indexed group of pages (bydefault, 100 pages in a group).

A database row contains a fixed amount of information that Content ManagerOnDemand uses to maintain reports (approximately 40 bytes) and any additionalindex and filter fields that you define for the application group. Os campos deíndice, que permitem que os usuários localizem documentos rapidamente, exigemum armazenamento em disco significativamente maior que os campos de filtro(Index fields also require more time to load into Content Manager OnDemand.)

There are four major factors that determine the amount of disk space required forthe Content Manager OnDemand database: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 The number of months that Content Manager OnDemand maintains the index

data in the database

See the administrator online help for a list of the types of index fields supportedby Content Manager OnDemand and the number of bytes required to store a valuein each type of index field.


||

Armazenamento do Diário do Banco de DadosThe Content Manager OnDemand database includes recovery journal and journalreceivers which are used to recover from application or system errors.

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. When you create a Content Manager OnDemand instance, a journal calledQSQJRN is created in your instance library. 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 Dado do ÍndiceContent Manager OnDemand requires temporary work space to import migratedindex data from archive media into the database.

É necessário alocar espaço em disco suficiente para suportar o número máximo depedidos de importação simultâneos que o servidor deve gerenciar. O espaçoalocado é baseado no tamanho das tabelas do grupo de aplicativos e no número detabelas que devem ser importadas para atender a uma consulta de dadosmigrados.

Se você não pretende migrar dados de índice do banco de dados para a mídia dearquivamento, não é necessário alocar espaço de armazenamento temporário paraimportar os dados de índice migrados. É importante entender que a migração dedado do índice não é recomendada. Portanto, poucos clientes devem precisar leresta seção.

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 do espaç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

For example, if you plan to store 8 GB of report data per month, the archivestorage manager must maintain the data for seven years, and Content ManagerOnDemand can achieve a compression ratio of 3:1 (0.33), you would requireapproximately 244 GB of archive storage space:

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

Espaço de Armazenamento de Relatório de BackupThe Content Manager OnDemand system can maintain a backup (second) copy ofreports that you store on archive media.


Normalmente, você mantém várias cópias de relatórios críticos para a operação desua empresa que sejam impossíveis ou difíceis de recriar.

If you need Content Manager OnDemand to maintain a backup copy of yourreports, double the archive storage space that you calculated.

Espaço de Armazenamento de Índice MigradoContent Manager OnDemand supports automatic migration of indexes from thedatabase to archive storage so that you can maintain seldom used indexes for longperiods of time.

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

Entretanto, a migração de índices deve ser feita somente quando não houver maisnecessidade de recuperar os relatórios que eles indicam. Por exemplo, suponha quetodas as consultas em um relatório ocorram nos 24 primeiros meses após ocarregamento do relatório no sistema. Após esse período, praticamente não háconsultas no relatório. Os índices podem ser migrados do banco de dados para oarmazenamento em archive. A migração de dados de índice é opcional; você podeoptar por migrar os índices de todos, alguns ou nenhum dos grupos de aplicativosdo sistema. In addition, you determine the length of time that indexes stay in thedatabase before Content Manager OnDemand migrates them to archive storage.

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 )

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


Backup and recovery

Visão Geral do Backup e da RecuperaçãoThis section of the book describes backup and recovery for Content ManagerOnDemand.

Content Manager OnDemand has recommendations about methods andprocedures that an administrator can use to make sure that the following criticalContent Manager OnDemand components can be recovered when needed:v Content Manager OnDemand softwarev Content Manager OnDemand server information, created or modified during

installation, configuration, and ongoing operation of Content ManagerOnDemand

v The Content Manager OnDemand databasev relatórios arquivados

See Chapter 5 of the Content Manager OnDemand for i: Common Server AdministrationGuide for specific libraries and objects to be backed up on a regular basis.

Software de ServidorIf a media failure or some other unforeseen event occurs, you may be required torestore the Content Manager OnDemand software programs, and other applicationand user-defined software that you use on the system.

É importante armazenar a mídia de backup para esses produtos de software emum local seguro. We recommend that you register Content Manager OnDemand aspart of your business recovery plan and store the product media in the same placethat you store the other programs and files that are vital to the operation of yoursystems.

Informações do ServidorWhen you installed and configured Content Manager OnDemand, you specifiedinformation that customized Content Manager OnDemand to operate in yourenvironment.

Essas informações estão armazenadas em arquivos de controle localizados emdiversos diretórios IFS no servidor. We recommend that you backup the controlfiles immediately after you have verified the installation of Content ManagerOnDemand. In addition, if you periodically make changes to the Content ManagerOnDemand server information, we recommend that you backup the control fileson a regular basis.

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


Content Manager OnDemand database

Backup de Banco de DadosSe seu planejamento de produção permitir, recomendamos que você crie backupsoff-line regularmente, talvez todas as noites ou uma vez por semana.

The operating system provides commands so that you can create backup copies ofthe Content Manager OnDemand database.

Backups off-line programados regularmente podem reduzir o tempo necessáriopara recriar o banco de dados, caso necessário. Mantenha a mídia de backup emum local seguro até a próxima vez que criar um backup off-line do banco dedados.

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.

Diário do Banco de DadosThe database manager uses journaling to record information about changes to theContent Manager OnDemand database.

As informações do diário são utilizadas para recuperar dados corrompidos dobanco de dados. A criação de diário garante que não ocorra perda de dados. Bycombining the information in the journal with a backup copy of the database, theContent Manager OnDemand database can be recovered to any point in time.

Recuperação de Banco de DadosO diário ajuda a corrigir esse tipo de falha permitindo que as transações recebidasantes da falha sejam reaplicadas ao banco de dados ou sejam retrocedidas. Oretrocesso de transações é uma forma de retornar o banco de dados ao estadoanterior à transação que provocou a falha.

Existem dois tipos de recuperação do banco de dados. O primeiro recupera a partirde falhas durante transações de atualização.

The second type of recovery deals with corruption of the Content ManagerOnDemand database and is usually caused by media failure. The combination ofjournals and a backup copy of the database can be used to recreate the ContentManager OnDemand database at a particular point in time.

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 aplica novamente as transações registradas nos diários.These steps will recreate the Content Manager OnDemand database before thecatastrophic failure.

RelatóriosContent Manager OnDemand can store copies of reports on disk and archivestorage.


O objetivo principal do armazenamento em disco é um armazenamento erecuperação dos relatórios por um período curto e com alta velocidade. O objetivoprincipal do armazenamento em archive é um armazenamento e recuperação dosrelatórios por um período longo. Os relatórios no armazenamento em archivetambém podem ser utilizados como cópias de backup, no caso de oarmazenamento ser danificado ou tornar-se indisponível. Archive storage consistsof disk, optical, or tape storage volumes, or Tivoli Storage Manager serversmanaged by the archive storage manager. Ao carregar um relatório no sistema, amaior parte dos clientes configura o sistema para copiar relatórios para oarmazenamento em disco e em archive ao mesmo tempo.

Content Manager OnDemand can retrieve a copy of a report from archive storageafter the report has been removed from disk or if the copy on disk is unavailable.Entretanto, é necessário configurar o sistema para suportar várias cópias derelatórios. You must define devices to the archive storage manager, and configureContent Manager OnDemand to use archive storage. You configure ContentManager OnDemand to use archive storage by defining migration policies andstorage sets, assigning application groups to the storage sets, and configuring datamigration in application groups.

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

If you do not copy reports to archive storage when you store them in ContentManager OnDemand, then you need to consider how you can recover the reportsin the event that you need to do so.

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 de archiveThe Content Manager OnDemand migration policy identifies where the primarycopy of a report is maintained. Content Manager OnDemand retrieves the primarycopy of the report from archive storage after the report has been removed fromdisk.

Os clientes 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.

Backup and recovery 53

Salvar os Arquivos de Configuração

When you install software on a Content Manager OnDemand server, theinstallation programs copy program files, configuration files, and other types offiles from the distribution media to directories on the server. 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.

After you make changes to any of your configuration files or before you upgradeto a new version of Content Manager OnDemand, we recommend that you save acopy of the files listed in this section. See Chapter 5 of the IBM Content ManagerOnDemand for i: Common Server Administration Guide for specific libraries andobjects to be backed up on a regular basis.

Content Manager OnDemand filesSave a copy of the Content Manager OnDemand configuration files listed in thetable.

Substitua instance pelo nome real da instance à qual o arquivo específico pertence.

Tabela 2. Content Manager OnDemand configuration files to save

Arquivo Localização Padrão Objetivo

ars.cache /QIBM/UserData/OnDemand/instance/config Definir detalhes doarmazenamento em disco.

ars.cfg /QIBM/UserData/OnDemand/instance/config Content ManagerOnDemand serverconfiguration file.

ars.ini /QIBM/UserData/OnDemand/config Configurar instâncias doOnDemand.

ars.dbfs /QIBM/UserData/OnDemand/instance/config Não utilizado, mas deveexistir.

arslog /QIBM/ProdData/OnDemand/bin O link simbólico para oprograma de saída dousuário de Log do sistemapadrão.

Windows font filesSe você modificou os arquivos relacionados à fonte nas estações de trabalho docliente do Windows, salve uma cópia dos arquivos listados na tabela.

Quando instalar um novo nível de software do cliente, esses arquivos serãosubstituídos e as modificações efetuadas serão perdidas. Por isso, você pode optarpor fazer backup dos arquivos modificados.

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


Tabela 3. 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. Usado para mapear oAFP Fonts para as fontes Truetype.


||

Parte 3. Instalando o Software

This section contains instructions for installing the Content Manager OnDemandserver software on the IBM i server.


Lista de Verificação da Instalação

Setting up your Content Manager OnDemand system typically requires that youdo the following steps.

Procedure1. Contact the IBM Support Center for the latest PTFs for Content Manager

OnDemand, or obtain the list from the Content Manager OnDemand supportweb page (under the Downloads heading). A lista de PTFs atuais pode serlocalizada no APAR de Informações número II14723. You should considerrequesting current PTFs for IBM i (DB2 in particular) and IBM i Access, becausethese two products are an integral part of the Content Manager OnDemandsystem. After you obtain the current list of PTFs, load and apply them on yoursystem.

2. Obtain a copy of the latest Content Manager OnDemand Read This Firstdocument from the web at the support web page (under the Featured linksheading). Print and read the entire document before you begin.

3. Check the Content Manager OnDemand prerequisites and verify the requiredand optional hardware and software products.

4. If you are upgrading to a new version of Content Manager OnDemand, savethe configuration files used by the system (see “Salvar os Arquivos deConfiguração” na página 55). Além disso, anote qualquer alteração que vocêtenha feito no perfil de usuário QRDARS400. An upgrade will overlay thisContent Manager OnDemand user profile and you must make the changesagain after your upgrade has completed.

5. Obtain the Content Manager OnDemand software (see “Installing ContentManager OnDemand server software” na página 61).

6. Install the Content Manager OnDemand software on the IBM i server (see“Installing Content Manager OnDemand server software” na página 61).

7. Configure the Content Manager OnDemand software (see Parte 4,“Configuração e Inicialização do Sistema”, na página 65). This step includes thefollowing:a. Refazer qualquer alteração no perfil de usuário QRDARS400 que você

anotou no item 4, acimab. Create an instance (see “Criando uma Instância” na página 67)c. Define a locale (see “Definição do Locale” na página 77)d. Configure the ARS.CFG file (see “Configuring the ARS.CFG file” na página 81)e. Configure system startup (see “Configurar o Sistema na Inicialização” na

página 85)f. Define schedules for maintenance programs (see “Planejando Programas de

Manutenção” na página 87)8. Create and initialize the database on the server (see “Criando uma Instância”

na página 67)

What to do next

Verify the installation of Content Manager OnDemand:


http://www.ibm.com/support/entry/portal/Overview/Software/Enterprise_Content_Management/Content_Manager_OnDemand_for_i



1. To access the system, you must install the Content Manager OnDemand clientprogram on a workstation. See the IBM Content Manager OnDemand: User'sGuide for details about installing Content Manager OnDemand client software.

2. Log on to the server with a Content Manager OnDemand client program.

Prepare o sistema para a utilização:1. Defina políticas de migração e conjuntos de armazenamentos. Antes de incluir

grupos de aplicativos ou de carregar dados no sistema, defina políticas demigração e conjuntos de armazenamento.

2. Configure o grupo de aplicativos Log do Sistema. Antes de definir relatórios nosistema, carregar dados, ou permitir que os usuários acessem o sistema,configure o grupo de aplicativos de Log do sistema.

3. Configure o grupo de aplicativos Migração do Sistema. Caso pretenda migrardados de índice para o armazenamento em archive, configure o grupo deaplicativos de Migração do sistema.

Nota: Não é recomendado migrar dados de índice para o armazenamento emarchive.

4. Faça backup dos bancos de dados. After configuring the system, werecommend that you create a full backup image of the Content ManagerOnDemand database.

Instalação e configuração de software opcional:1. If you plan to reprint AFP documents or fax any documents using the Content

Manager OnDemand server print function, then you must install PSF for IBM ion the Content Manager OnDemand for i server. Execute as seguintes tarefas:a. Instale e configure o PSF para o IBM i (parte do IBM i).b. Define a server printer on the Content Manager OnDemand server with the

administrative client.2. Planeje configurar as mensagens enviadas para o log do sistema ou defina seu

próprio programa de saída de usuário de log do sistema.


Installing Content Manager OnDemand server software

You must install a copy of the Content Manager OnDemand server software onyour IBM i server.

Obtaining Content Manager OnDemand softwareContent Manager OnDemand software is no longer sent on the stacked media(CDs) you receive with many of your other licensed programs.

About this task

O produto agora é disponibilizado no Web site do Passport Advantage, de ondepode ser transferido por download. 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.

Installing Content Manager OnDemandAs implementações existentes do Spool File Archive devem ser migradas doambiente do Spool File Archive para o Common Server antes que o sistema noqual elas estão em execução seja atualizado para 6.1, 7.1 ou 7.2.

About this task

Content Manager OnDemand releases 5.3 and 5.4 included the Common Serverenvironment, as well as the legacy environments of Spool File Archive, AnyStore,Record Archive, and Object Archive. Todos esses ambientes eram totalmentesuportados até, 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 release em que oSpool File Archive, AnyStore, Record Archive e Object Archive seriam fornecidos esuportados. Beginning with Content Manager OnDemand 5.3, a Spool File Archivemigration utility has been available as part of the Content Manager OnDemandlicensed program product, providing capability to migrate report definitions andindexes from the legacy Spool File Archive environment to the Common Serverenvironment. As implementações existentes do Spool File Archive devem sermigradas do ambiente do Spool File Archive para o Common Server antes que osistema no qual elas estão em execução seja atualizado para 6.1, 7.1 ou 7.2.

Content Manager OnDemand installation proceduresIf you are upgrading from a previous release of Content Manager OnDemand, youmust be running Content Manager OnDemand server version 8.4.0.3 or higherprior to upgrading to Content Manager OnDemand for i Version 7 Release 2.

About this task

É possível determinar a versão de seu servidor atual usando um dos seguintesmétodos:v Log on to either the Content Manager OnDemand Administrator or OnDemand

end-user client. Depois que o logon for efetuado, a versão do servidor serámostrada na linha de mensagem na parte inferior direita do painel.


|

|||

|

||

|||

v Efetue logon no servidor IBM i. Inicie o qshell usando o comando QSH. Após oqshell ser iniciado, insira ARSDATE (sem parâmetros adicionais) na linha decomando Qshell. A versão do servidor é exibida juntamente com outrasinformações sobre o programa ARSDATE.

The licensed program number for Content Manager OnDemand for i Version 7Release 2 is 5770RD1. The individual Content Manager OnDemand features (whichinstall separately) are as follows:v *BASE para o Suporte Base (necessário para todos os outros)

*BASE includes Common Server (previously option 10) and Content ManagerOnDemand Web Enablement Kit; previously option 11). This option alsoincludes the IBM Navigator for i - Content Manager OnDemand component(previously named IBM Navigator for i - Content Manager OnDemandAdministration).

v 12 para PDF Indexer (opcional)v 13 para Transformações do Advanced Function Presentation for IBM i (opcional)v 14 para Gerenciamento de Retenção Aprimorado (opcional)

Full text indexing support is also available for use with Content ManagerOnDemand for i Version 7 Release 2.

As opções 10 e 11 do produto são incluídas agora no *BASE e não requerem mais ainstalação de uma opção separada. Importante: se as opções 10 ou 11 do produtoexistirem em seu sistema, elas serão excluídas durante o processo de upgrade.

The System i Navigator - Content Manager OnDemand component is replaced bythe web-based IBM Navigator for i - Content Manager OnDemand component thatis included in the *BASE product option. Important: The System i Navigator -Content Manager OnDemand component is not supported at 7.2 and is deletedduring the upgrade process.

As opções do produto de 1 a 5 não se aplicam a esta publicação e não estão maisdisponíveis. They have not been supported since Content Manager OnDemand foriSeries 5.4 (licensed program number 5722RD1). Important: If options 1 through 5of licensed program number 5722RD1 exist on your system during the upgrade toContent Manager OnDemand for i 7.2, they are deleted during the upgradeprocess.

As opções são:v 1 para Archive de Spoolv 2 para Archive de Objetov 3 para Archive de Registrov 4 para AnyStorev 5 para Servidor (usado com Archive de Spool)

The recommended way to install Content Manager OnDemand is to use theinstallation licensed programs menu option from the Work with Licensed Programsmenu (GO LICPGM). Na tela de programas licenciados para instalação, digite 1para Incluir uma opção e, em seguida, digite cada um dos recursos listados acimaque você pediu (como *BASE e, em seguida, a opção 12, 13 ou 14 conformenecessário).


||||

|||

|

|||||

|

|

|

||

|||

|||||

||||||

|

|

|

|

|

|

||||||

Importante: The first time you start the Content Manager OnDemand servers aftera server upgrade or licensed program release upgrade, you should start eachinstance separately. Depois que o primeiro servidor for iniciado, teste oarmazenamento e visualização de dados para assegurar que não existemproblemas. Em seguida, inicie um segundo servidor e execute os mesmos testes. Sevocê tiver uma instância de teste e uma instância de produção definidas, poderáconsiderar o trabalho com a instância de teste primeiro.

Installing the Content Manager OnDemand end-user clientFor information on installing the Content Manager OnDemand client for Windows,see Content Manager OnDemand: Client Installation Guide.

Installing the Content Manager OnDemand administrativeclient

The Content Manager OnDemand Administrator client must be at the sameversion or higher as the Content Manager OnDemand server. For version 7.2 ofContent Manager OnDemand for i, the Content Manager OnDemandAdministrator client must be at version 9.0.0.3 or higher.

About this task

For information on installing the Content Manager OnDemand administrativeclient for Windows, see Content Manager OnDemand for i: Common ServerAdministration Guide.

Installing Content Manager OnDemand server software 63

|||||||

|

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

This part of the book describes how to configure the Content Manager OnDemandserver to operate and support your organization and create and initialize thedatabase. Esta parte contém as seguintes sessões:


Criando uma Instância

Sobre as InstânciasUma instância é definida no arquivo ARS.INI nomeando a instância (que identificao nome da biblioteca usada pela instância).

A Content Manager OnDemand instance is a logical server environment with itsown library containing a unique set of database files. Todos os arquivos de bancode dados 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

When you work with more than one instance, you must identify the instance namewhen you run Content Manager OnDemand commands (such as ADDRPTONDand STRMONOND).

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. A renomeação de uma instâncianão é suportada. Se for necessário alterar o nome de uma instância, você deverácriar uma nova instância, exportar ou recriar suas definições, como aplicativos,grupos de aplicativos, pastas, usuários, etc., e recarregar os dados necessários nanova instância.

Configuração de uma ocorrênciaSeu perfil do usuário deve ter o código do idioma configurado para aquele dainstância que você deseja criar. Como o código de idioma é configurado no perfildo usuário, você poderá precisar alterar o perfil do usuário, em seguida, efetuarsign off e sign on novamente antes de criar a instância

About this task

Use o comando Change User Profile (CHGUSRPRF) para alterar (se necessário)seu perfil 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. (Ocomando Change User Profile (CHGUSRPRF) não mostra a configuração docódigo de idioma atual; ele mostra *SAME.

Use Display User Profile (DSPUSRPRF) para verificar a configuração do código deidioma. O parâmetro Locale Job Attributes (SETJOBATR) no perfil do usuário éusado para determinar quais valores são obtidos a partir do código de idioma.


Procedure

To create your Content Manager OnDemand instance:1. Name the instance or use the default instance name of QUSROND. O nome da

instâ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 (excetopara QUSROND), e não deve ser nomeado CONFIG ou WWW. Esse nome dainstância é referido como [instance] no restante destas instruções.

2. Create the instance by using the Create Instance for OnDemand(CRTINSTOND) command. No mínimo, você deve especificar o nome dainstância (que, em seguida, usa valores do sistema e padroniza para osparâmetros adicionais, como *DFT para o parâmetro PORT, que usa a porta1445). É possível especificar parâmetros adicionais a fim de customizar ainstância para atender seus requisitos. Por exemplo, é possível especificar umidentificador de idioma de três caracteres (usando o parâmetro LANGID) quedeve corresponder a um dos identificadores de idioma. Se você especificar oparâmetro LOCALE, aquele que você especificar deverá ser incluído na lista decódigos de idiomas válidos. Se a instância dever ser localizada em umAuxiliary Storage Pool (ASP) do usuário, em seguida, o número do ASP dousuário (2 a 32) deverá ser especificado para o parâmetro ASP e *ASP deverá serespecificado para o parâmetro ASPDEV. Se a instância dever ser localizada emum Independent Auxiliary Storage Pool (IASP), em seguida, *ASPDEV deverá serespecificado para o parâmetro ASP e o nome IASP (como IASP2) deverá serespecificado para o parâmetro ASPDEV.

Importante: Se você criar uma instância em um IASP, essa instância nãopoderá ter um conjunto de discos no ASP do sistema ou em um ASP dousuário.Por exemplo, o comando a seguir criaria uma instância chamada ONDTESTcom um idioma de servidor Inglês dos Estados Unidos, usando a porta TCP/IP1445:CRTINSTOND INSTANCE(ONDTEST) LANGID(ENU) LOCALE(’/QSYS.LIB/EN_US.LOCALE’)

O comando CRTINSTOND:v Cria o diretório /CONFIG em /QIBM/UserData/OnDemand e os arquivos de

modelo e padrão dentro desse diretório (se ainda não existirem).v Anexa o arquivo ARS.INI de modelo (no diretório /QIBM/ProdData/OnDemand/

config) para o arquivo ARS.INI real (no diretório /QIBM/UserData/OnDemand/CONFIG) e usa o nome da instância sempre que localizar [instance] no arquivode modelo.

v Cria o diretório de instâncias: /QIBM/UserData/OnDemand/[instance]. Se ainstância estiver localizada em um ASP Independente, o caminho do diretóriode instâncias será precedido pelo nome ASP Independente. Por exemplo, se onome ASP Independente for IASP, o diretório de instâncias será criado nodiretório /IASP/QIBM/UserData/OnDemand.

v Cria os arquivos ARS.CFG, ARS.CACHE e ARS.DBFS no diretório:/QIBM/UserData/OnDemand/[instance] e usa o nome da instância sempre quelocalizar [instance] e o identificador de idioma sempre que localizar [language]no arquivo de modelo. (Os arquivos de modelo para esses três novosarquivos estão localizados no diretório /QIBM/ProdData/OnDemand/config). Sea instância estiver localizada em um ASP Independente, o caminho dodiretório de instâncias será precedido pelo nome ASP Independente. Por


exemplo, se o nome ASP Independente for IASP, os arquivos ARS.CFG,ARS.CACHE e ARS.DBFS serão criados no diretório /IASP/QIBM/UserData/OnDemand/[instance].

v 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 Grupo ASPantes que possa trabalhar com arquivos nessa biblioteca. Use o comando SetASP Group (SETASPGRP) para configurar o Grupo ASP.

v Cria os diretórios necessários para a instância, conforme especificado nosarquivosARS.CFG e ARS.CACHE. And creates a user profile with the same nameas the instance, and adds that user to the instance as a Content ManagerOnDemand System Administrator.

v Cria uma lista de autorizações com o mesmo nome que a instância. Se ainstâ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ânciaVocê poderá precisar alterar alguns parâmetros de configuração a partir dosvalores especificados quando executou o comando CRTINSTOND. Essesparâmetros existem no arquivo ARS.INI ou no arquivo ARS.CFG.

Para alterar alguns dos parâmetros de configuração no arquivo ARS.INI localizadono diretório /QIBM/UserData/OnDemand/config, use o comando Edit File (EDTF):EDTF ’/QIBM/UserData/OnDemand/CONFIG/ARS.INI’

Cada definição de instância é iniciada com a linha [@SRV@_[instance]] em queinstance é o nome da instância. Por exemplo, a instância ONDTEST iniciaria com alinha [@SRV@_ONDTEST].

Revise as linhas a seguir:

PORT=0The port to which the server listens to receive requests from a ContentManager OnDemand client. O valor de 0 significa utilizar a porta padrão de1445. Somente um servidor pode estar atendendo em uma porta específica emum determinado momento. Para executar múltiplas instânciassimultaneamente, é necessário especificar uma porta não usada em seu sistema.É possível executar o comando Work with TCP/IP Network Status(WRKTCPSTS) OPTION(*CNN) para ver quais portas estão atualmente em usono sistema.

SRVR_FLAGS_SECURITY_EXIT=1Specifies that you want to use IBM i user IDs and passwords as the ContentManager OnDemand user IDs and passwords. Este é o valor padrão, o quesimplifica para os usuários finais, pois eles não precisam manter várias senhas.If your Content Manager OnDemand users do not need to have IBM i user IDsthen you should specify a value of 0 for this parameter. When you do this,your Content Manager OnDemand passwords have no relationship to IBM ipasswords. However, if a Content Manager OnDemand user ID and an IBM iuser profile match, some Content Manager OnDemand commands and APIsuse the IBM i user profile as the Content Manager OnDemand user ID, even ifyou have chosen not to relate the two. This situation could permit IBM i usersto perform Content Manager OnDemand functions that you did not intend forthem to perform. A Content Manager OnDemand user ID should not match anIBM i user profile name unless the two ids are used by the same individual. Ifyou make a change to the SRVR_FLAGS_SECURITY_EXIT value, you should

Criando uma Instância 69

review the Content Manager OnDemand System Parameters values (definedusing the Content Manager OnDemand administrative client) for the instancethat you have changed.

HOST=LOCALHOSTIf you are enabling IPv6 on your IBM i system and need some of your ContentManager OnDemand instances to use IPv4 addressing and others to use IPv6addressing, you might need to change HOST=LOCALHOST toHOST=IPV6-LOCALHOST within the ARS.INI stanza for each instance thatyou want to use IPv6 addresses. É possível querer que algumas instânciassejam executadas com IPv6 e outras com IPv4. Esse ambiente combinado étotalmente suportado. Also, during the transition from IPv4 to IPv6, ContentManager OnDemand clients that use IPv4 addresses can connect to the serversimultaneously with clients that use IPv6 addresses.

Para alterar alguns dos parâmetros de configuração no arquivo ARS.CFG localizadono diretório /QIBM/UserData/OnDemand/instancename (em que instancename é onome da instância que você deseja alterar): use o comando Edit File (EDTF): EDTF’/QIBM/UserData/OnDemand/MYINSTANCE/ARS.CFG’

É possível alterar estes valores:

ARS_DISABLE_ARSLOG=1Especifica que a saída de usuário do ARSLOG deve ser desativada. Configureesse valor como 1 para desativar a saída; configure esse valor como 0 paraativar a saída.

ARS_LANGUAGE=ENUEspecifica o idioma no qual essa instância é executada. O exemplo mostra ouso do idioma inglês.

ARS_MSGS_LANGUAGE=ENUEspecifica o idioma usado para as mensagens do servidor. O exemplo mostra ouso do idioma inglês.

ARS_AUTOSTART_INSTANCE=1Especifica se o servidor deve ser iniciado automaticamente ou não para essainstância ao usar o comando Start TCP/IP Server (STRTCPSVR). Defina essevalor como 1 para iniciar automaticamente o servidor dessa instância; definaesse valor como 0 se não desejar iniciar automaticamente o servidor dessainstância.

Do not modify any of the other values in these instance definition files withoutfirst consulting with Content Manager OnDemand Support. Você deve encerrar ereiniciar o servidor de instâncias após fazer quaisquer mudanças.

Exclusão de uma InstânciaÉ possível excluir uma instância. Se o servidor para a instância já foi iniciado,encerre-o antes de excluir a instância.

Antes de Começar

É possível finalizar um servidor específico, seguindo as instruções para parar umservidor.


Procedure

Para excluir uma instância:1. Delete the instance library. Issue the following command: DLTLIB

LIB([instance]). Ao emitir esse comando, você pode receber uma mensagemindicando que um receptor de diário não foi salvo totalmente. Você poderesponder com I para ignorar essa mensagem.

2. Delete the instance directory which is under /QIBM/UserData/OnDemand. Se vocêusar o comando WRKLNK, cada diretório deverá estar vazio para que elepossa ser excluído. If files exist in a subdirectory you will have to go into eachsubdirectory under the instance to delete the files and directories in it beforeremoving the directory. É possível usar o comando WRKLNK para fazer umaexclusão recursiva de todos os objetos em um diretório.a. You can do this by issuing the following command: WRKLNK

'/QIBM/UserData/OnDemand/[instance]' where [instance] is your instancename.

b. Specify option 2 to edit the instance directory you want to delete.c. Then specify option 9 for every directory listed in that instance directory.d. Select F12 to go back to the previous screen and then delete the instance

directory itself.3. Delete the instance definition within file ARS.INI in directory

/QIBM/UserData/OnDemand/config. If the instance has been used with theContent Manager OnDemand Web Enablement Kit (ODWEK), remove anyreference to the instance from the arswww.ini file in the directory/QIBM/UserData/OnDemand/www. Se você estiver usando o suporte de CGImultilíngue, o nome do diretório será /QIBM/UserData/OnDemand/www/[ccsid],em que ccsid é o CCSID necessário. If you are using WebSphere ApplicationServer V6, the directory name will be /QIBM/UserData/WebSphere.

4. Delete the instance authorization list. You can do this by issuing the followingcommand: DLTAUTL AUTL[instance] where [instance] is the name of the instanceyou are deleting.

5. If you have created an instance in an Independent ASP, contact IBM softwaresupport to discuss steps to delete the instance record from QUSRRDARS.

6. You should delete the instance user profile (which has a name that matches theinstance name), but be careful to verify that the user profile does not ownobjects that will still be required after the instance is deleted. Use o comandoWork with Objects by Owner (WRKOBJOWN), especificando o nome dainstância para o parâmetro (USRPRF) de perfil do usuário para revisar objetospertencentes ao perfil do usuário da instância. Exclua cada objeto ou altere oproprietá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 ServidoresAbout this task

Os servidores são iniciados usando o comando STRTCPSVR *ONDMD. Oparâmetro INSTANCE do comando STRTCPSVR *ONDMD suporta os valoresespeciais de *DFT, *ALL e *AUTOSTART, bem como a especificação do nome deuma instância. (Uma instância será configurada para autoinicialização se o arquivo


ARS.CFG para essa instância contiver ARS_AUTOSTART_INSTANCE=1). O valor padrãopara o parâmetro INSTANCE é *DFT. É possível criar também uma área de dadosnomeada STRTCPSVR para controlar ainda mais o comportamento do comandoSTRTCPSVR. See the Content Manager OnDemand for i: Administration Guide formore details about the data area.

Sem a área de dados STRTCPSVR, os valores de *DFT e *AUTOSTARTfuncionam de forma idêntica. Todas as instâncias configuradas paraautoinicialização são iniciadas. O uso do valor especial *ALL inicia todas asinstâncias configuradas no sistema. É possível especificar também o nome de umaúnica instância a ser iniciada, por exemplo: STRTCPSVR SERVER(*ONDMD)INSTANCE(ONDTEST).

Com a área de dados, o valor de *DFT inicia apenas a instância nomeada na áreade dados. A área de dados deve ser nomeada STRTCPSVR e localizada nabiblioteca QUSRRDARS. A área de dados deve ser do tipo caractere com umcomprimento de 10. Para criar a área de dados, use o comando:CRTDTAARA DTAARA(QUSRRDARS/STRTCPSVR) TYPE(*CHAR) LEN(10) VALUE(QUSROND) TEXT(’Autostart instance name for STRTCPSVR *ONDMD *DFT’)

em que QUSROND é o nome da instância a ser iniciada.

Os valores especiais *ALL e *AUTOSTART funcionam da mesma maneira com aárea de dados como sem a área de dados.

Para determinar as instâncias que são iniciadas quando STRTCPSVRSERVER(*ONDMD) INSTANCE(*AUTOSTART) for executado, é possívelprocurar por ARS_AUTOSTART_INSTANCE=1 no arquivo ARS.CFG. No entanto, há umamaneira mais fácil, para que você não precise verificar o arquivo ARS.CFG para cadainstância.

Use o comandogrep

em qshell para procurar o conteúdo de todos os arquivos ARS.CFG para a sequênciaARS_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 sejam 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 4. 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 éiniciada:

Todas as instânciasconfiguradas paraautoinicialização

Todas as instânciasconfiguradas nosistema


A instância nomeada


Tabela 4. Comando STRTCPSVR com e sem a Área de Dados STRTCPSVR (continuação)

*DFT *ALL *AUTOSTART Instância Nomeada

Com a área de dados,a execução deSTRTCPSVR éiniciada:

Apenas a instâncianomeada na área dedados

Todas as instânciasconfiguradas nosistema


A instância nomeada

Parando os ServidoresAbout this task

Os 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. See the Content Manager OnDemand for i: Common Server AdministrationGuide for more details about the data area. Observe que, mesmo que a área dedados esteja nomeada como STRTCPSVR, ela controla ambos os comandos,STRTCPSVR e ENDTCPSVR. Isso é, por design, para que o *DFT inicie e termine amesma 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 5. 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ção de tarefa com esse nome não for localizada na biblioteca deinstâncias, a descrição de tarefa QOND400 na biblioteca QRDARS será usada (epoderá ser alterada, se necessário).

A descrição do job controla os seguintes atributos de job do servidor:v JOBQv JOBPTY


v 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.

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 cada vez que osistema for reiniciado, você deverá incluir um dos comandos no programaQSTRUP. É possível também incluir os comandos em um programador de jobs.

Conexão com Instâncias

Connecting from Content Manager OnDemand clientsPara 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.

About this task

Ao incluir um servidor, identifique o nome do servidor, o número da porta e oprotocolo de comunicação utilizado para comunicar-se com o servidor. O númeroda porta especificado na caixa de diálogo Atualizar Servidores deve ser o mesmoque o valor especificado para a instância no arquivo ARS.INI.


Como Trabalhar com InstânciasContent Manager OnDemand provides commands that you can use to work withan instance.

About this task

For example, Content Manager OnDemand provides commands to add, remove,and print spooled files and other data types and to manage storage. On many ofthe Content Manager OnDemand commands, one of the parameters that you canspecify to a command is the name of the instance. Por padrão, se você nãoespecificar de outra maneira, o nome da instância será QUSROND. Se vocênomear a única instância como algo diferente de QUSROND ou se trabalhar commais de uma instância, deverá especificar sempre o nome da instância ao executarum comando. Dessa forma é possível certificar-se de que você está trabalhandocom a instância correta.

See the IBM Content Manager OnDemand for i: Administration Guide appendixentitled “Command reference” for more information about OnDemand commands.

Content Manager OnDemand also provides APIs that you can use to work with aninstance.

The ARSLOAD API uses the –I instance parameter. O OnDemand recupera onome do servidor que é associado à instância a partir do arquivo ARS.INI. Porexemplo (utilizando o QSHELL):

arsload -I TEST -d /test/file1 -c /test/file2

em que TEST é o nome da instância. No exemplo, o parâmetro PORT na 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 usa o parâmetroPORT na seção [@SRV@_TEST] do arquivo ARS.INI para identificar o servidor.

See the IBM Content Manager OnDemand for i: Administration Guide appendixentitled “API and user exit reference” for more information about ContentManager OnDemand APIs.


Definição do Locale

About this task

Content Manager OnDemand requires the specification of a locale for eachCommon Server instance, in order to ensure that your data has the correctlanguage identifier associated with it during the archive process. The stepsoutlined below must be performed for each Content Manager OnDemand instancebefore the server for that instance can be started. Mesmo que você estejaexecutando um sistema em inglês americano, ainda será necessário executar essasetapas.

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. Se o código de idioma necessário precisar ser criado apartir do código de origem, você deverá instalar a opção 21 do IBM i (SuporteEstendido ao NLS; uma opção de produto 5770-SS1), que contém todos os arquivosde origem de código de idioma fornecidos pela IBM. Se você precisar de umcódigo de idioma não fornecido pela IBM (nenhuma origem ou objeto), seránecessário copiar e modificar um código de idioma existente para atender suasnecessidades. A assistência para fazer isso pode ser obtida da organização desuporte IBM em sua região.

Consideração Importante sobre Códigos de IdiomaThe user profile named the same as your instance AND all user profiles thatperform Content Manager OnDemand data loading functions (such asADDRPTOND, STRMONOND, arsload or arsdoc add) must have their locale setto the locale of the instance.

If the user profiles that perform Content Manager OnDemand data loadingfunctions are also used for other non-Content Manager OnDemand work on yoursystem, changing their LOCALE value might impact other non-Content ManagerOnDemand applications. Consider creating specific Content Manager OnDemanduser profiles for data loading instead, so as not to impact your other applications,and then only modify the LOCALE value for the specific Content ManagerOnDemand user profiles. Se necessário, altere o código de idioma dos perfis dousuário usando o comando Change User Profile (CHGUSRPRF). Você tambémdeve certificar-se de que outros parâmetros relacionados ao idioma nos perfis dousuário estejam configurados corretamente. O parâmetro SETJOBATR é usado paradeterminar quais valores são obtidos do código de idioma. For Content ManagerOnDemand, at a minimum, you must use SETJOBATR(*CCSID). Por exemplo, sevocê 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_E.LOCALE’)

After setting the correct locale on an IBM i user profile, you might choose to copythat user profile to create another similar user profile for use with ContentManager OnDemand. A função de cópia do IBM i não copia o valor de parâmetroLOCALE. Após a cópia ser concluída, você deverá emitir o comandoCHGUSRPRF conforme mostrado acima para configurar o LOCALE. É possível


usar o comando Display User Profile (DSPUSRPRF) para exibir ou verificar ocódigo de idioma 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 IdiomaIf you encounter problems while trying to create a Content Manager OnDemandCommon Server instance, see the list of problems, causes, and recoveries below.

About this task

Se precisar de assistência adicional, entre em contato com a organização de suporteao software em 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 cada possível problema e são explicadas as etapas pararecuperar 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.


Problema: Falha no arquivo em spool ao arquivar. O log do sistema contém amensagem 88, incluindo o texto semelhante ao seguinte Linha 1: A sequência "1/12/13" não pôde ser convertida em um data a partir do formato de %m/%d/%y.Verifique a guia Carregar Informações na definição do aplicativo e verifique se oformato de data é especificado como %y/%m/%d e se os espaços iniciais serãoremovidos.

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.

Definição do Locale 79

Configuring the ARS.CFG file

When you run the various Content Manager OnDemand programs, they obtaininformation from the ARS.CFG file about a variety of configuration settings.

About this task

As informações incluem a definição de idioma do banco de dados e a localizaçãodos diretórios de configuração e de área de trabalho temporários, por exemplo.Before you begin using Content Manager OnDemand, you should review theparameters in the ARS.CFG file. A maioria dos valores que a IBM fornece sãosuficientes para muitos clientes. Entretanto, pode ser necessário alterar alguns dosvalores para seu ambiente. If you make changes to the ARS.CFG file while thesystem is running, you must stop and restart the server before Content ManagerOnDemand can use any values that you modify.

Para alterar o arquivo ARS.CFG, efetue logon como QSECOFR. Issue the WRKLNKcommand and change to the /QIBM/UserData/OnDemand/instance directory, whereinstance is the name of your Content Manager OnDemand instance. O nome dainstância padrão é QUSROND. Faça uma cópia de backup dos arquivos fornecidospela IBM. Edite o arquivo ARS.CFG usando a Opção 2 (Editar) na tela WRKLNK.

ARS_AUTOSTART_INSTANCE parameterPadrõ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.

Ao criar uma nova instância (diferente de QUSROND), as tarefas do servidor paraessa instância não são iniciadas automaticamente emitindo STRTCPSVRSERVER(*ONDMD) INSTANCE(*AUTOSTART), a não ser que você altere o valor desseparâmetro de 0 para 1.

Se optar por não autoinicializar o servidor de uma instância, você poderá iniciar oservidor manualmente.

ARS_DISABLE_ARSLOG parameterO ambiente no idioma nacional utilizado para criar o banco de dados. ContentManager OnDemand uses a three-character language code to derive the locale andcode set for the server operating system.

You must provide the correct language code for your operating environment beforeyou create the Content Manager OnDemand instance database.

Esse parâmetro especifica que a saída de ARSLOG deve ser desativadacompletamente. Without specifying this parameter, even though all user exitlogging is disabled in the System Parameters window of the Content ManagerOnDemand Administrator client, an attempt is still made to call the ARSLOG exitfor certain messages. Especificando ARS_DISABLE_ARSLOG=1 no arquivoARS.CFG, a saída ARSLOG não é chamada de maneira nenhuma. Se você nãoplanejar o uso da saída ARSLOG, especifique ARS_DISABLE_ARSLOG=1 paraminimizar a sobrecarga ao tentar chamar a saída ARSLOG.


ARS_LANGUAGE parameterO ambiente no idioma nacional utilizado para criar o banco de dados. ContentManager OnDemand uses a three-character language code to derive the locale andcode set for the server operating system.

You must provide the correct language code for your operating environment beforeyou create the Content Manager OnDemand instance database.

ARS_LDAP_ALLOW_ANONYMOUS parameterEspecifica se conexões de ligação anônimas são ou não permitidas neste servidorLDAP. Os valores válidos são TRUE e FALSE. Se for FALSE, você também deveráespecificar um ID do usuário LDAP e senha no arquivo stash.

ARS_LDAP_BASE_DN parameterEspecifica o nome distinto de base a ser usado.

Esse parâmetro é necessário para a autenticação LDAP.

Exemplo 1:ARS_LDAP_BASE_DN=ou=mycity,o=xyzcompany

Exemplo 2:ARS_LDAP_BASE_DN=dc=ondemand,dc=xyzcompany

ARS_LDAP_BIND_ATTRIBUTE parameterEspecifica o atributo que está sendo ligado e é o nome do atributo a ser procuradono servidor LDAP.

Esse parâmetro é necessário para a autenticação LDAP.

Exemplo:ARS_LDAP_BIND_ATTRIBUTE=mail

ARS_LDAP_BIND_MESSAGES_FILE parameterSpecifies the location of a file containing the LDAP message strings the ContentManager OnDemand server looks for during login.

Isso é usado para emitir mensagens quando a senha do usuário estiver prestes aexpirar ou quando sua conta LDAP estiver bloqueada.ARS_LDAP_BIND_MESSAGES_FILE é usado em conjunção com o arquivo ARSLDAP.INIpara implementar essa funcionalidade.

ARS_LDAP_IGN_USERIDS parameterThis parameter specifies the user IDs that Content Manager OnDemand ignoreswhen you enable LDAP for authentication. If the parameter does not exist or youdo not specify a value, Content Manager OnDemand defaults to ADMIN.


É possível especificar até 10 IDs do usuário, delimitados por uma vírgula. Se vocêespecificar uma lista de IDs do usuário e desejar incluir ADMIN, deveráespecificá-lo na lista.

ARS_LDAP_MAPPED_ATTRIBUTE parameterSpecifies the attribute being returned to Content Manager OnDemand as a user ID.

Esse é o nome do atributo a ser retornado do servidor LDAP depois que o nomedo atributo de ligação for localizado. Ele pode ser igual ou diferente do atributo deligação. Esse parâmetro é necessário para a autenticação LDAP.

Exemplo:ARS_LDAP_MAPPED_ATTRIBUTE=sAMAccountName

ARS_LDAP_PORT parameterEspecifica a porta na qual o LDAP está atendendo. O valor padrão é 389. Esseparâmetro é opcional.

ARS_LDAP_SERVER parameterEspecifica o endereço IP ou o nome completo do host do servidor LDAP. Esseparâmetro é necessário para a autenticação LDAP.

ARS_MESSAGE_OF_THE_DAY parameterUse to specify the message of the day for the Content Manager OnDemand client.Defina um nome de caminho completo de um arquivo que contém a mensagemque você deseja que o 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 em OK. Se um arquivo de mensagem não forespecificado, ocorre o processamento normal do cliente.

ARS_MSGS_LANGUAGE parameterSe você desejar um idioma diferente do inglês para as mensagens do servidor,altere esse parâmetro no arquivo ars.cfg para a instância e especifique o ID doidioma de três caracteres que deseja usar.

To see a list of valid language id values, see the directory names within/QIBM/ProdData/OnDemand/locale on your IBM i server after you install ContentManager OnDemand.

ARS_NUM_DBSRVR parameterDetermines the number of processes that Content Manager OnDemand starts onthe server to handle connections to the database.

O valor padrão é 5.

Configuring the ARS.CFG file 83

ARS_PRINT_PATH parameterThe location where the Content Manager OnDemand server print functiontemporarily stores print data.

Certifique-se de que exista espaço suficiente na localização especificada para conteros arquivos de impressão para o número máximo de pedidos de impressãosimultâneos com o qual o servidor trabalha. The default value is:/QIBM/UserData/OnDemand/instance/tmp (whereinstance is the name of the ContentManager OnDemand instance).

ARS_SUPPORT_CFSOD parameterTo use Content Federation Services for Content Manager OnDemand, you must setthis parameter to 1.

See the Web Index document for additional details about the set up and use ofContent Federation Services for Content Manager OnDemand.

ARS_SUPPORT_HOLD parameterAtiva o recurso Gerenciamento de Retenção Aprimorado, um recurso com preçodeterminado separadamente.

Para obter mais informações sobre esse recurso, consulte o Guia de Gerenciamento deRetenção Aprimorado.

ARS_TMP parameterThe location where Content Manager OnDemand programs temporarily store data.

Aloque espaço livre suficiente no sistema de arquivos especificado para suportartarefas tais como migração e importação de dados de índice. The default value is:/QIBM/UserData/OnDemand/instance/tmp (where instance is the name of the ContentManager OnDemand instance).

ARSSOCK_RESOLVE_CLIENT_NAME parameterSe você estiver tendo tempos de resposta de logon mais longos do que o normalem um ambiente DHCP, incluindo a seguinte linha ao arquivo ARS.CFG poderácorrigir o problema: ARSSOCK_RESOLVE_CLIENT_NAME=0


Configurar o Sistema na Inicialização

Existem funções do servidor que você pode escolher para serem iniciadasautomaticamente, sempre que o sistema for iniciado.

É possível modificar o programa QSTRUP do sistema operacional para emitirautomaticamente comandos do servidor, cada vez que servidor for reiniciado.

Considere o seguinte para possíveis adições ao programa QSTRUP:v Start the Content Manager OnDemand server jobsv Start the Content Manager OnDemand monitor

Iniciar os Jobs do ServidorThe following example shows the command that starts the Content ManagerOnDemand server jobs: STRTCPSVR SERVER(*ONDMD)

Iniciar os MonitoresUse the Start Monitor for OnDemand (STRMONOND) command to start ContentManager OnDemand output queue monitors for output queues or directorymonitors to receive files destined for Content Manager OnDemand.

Antes de Começar

Revise o texto da ajuda on-line para determinar os parâmetros específicos que vocêdeseja especificar para cada monitor.

About this task

You can also create monitor definitions using the Content Manager OnDemandcomponent of IBM Navigator for i. After starting IBM Navigator for i, selectContent Manager OnDemand, then click Directory Monitors or Output QueueMonitors as needed.

See Loading spooled file data in the IBM Content Manager OnDemand for i: CommonServer Administration Guide for more information on monitors.

Posteriormente, é possível encerrar o monitor, se desejado, usando o comando EndMonitor for OnDemand (ENDMONOND) ou configurando as condições parafinalizar ao emitir o comando STRMONOND ou configurar a definição domonitor usando o IBM Navigator for i, conforme descrito acima.


Planejando Programas de Manutenção

This section describes the Content Manager OnDemand maintenance commands torun automatically on a regular schedule.

Antes de Começar

The maintenance programs that you might want to run on a regular scheduleinclude those that maintain application group data in the database and on disk,and maintain Content Manager OnDemand system data in the database.

About this task

A maior parte dos programas de manutenção deve ser executada quando nãohouver outros programas atualizando o banco de dados ou exigindo acessoexclusivo ao banco de dados. Por exemplo, você não deve carregar dados(ADDRPTOND, STRMONOND, arsload, arsdoc add ) ao mesmo tempo em queexecuta o comando de manutenção de armazenamento em disco (STRDSMOND).

However, the STRASMOND command can be run while archiving data intoContent Manager OnDemand. Os backups não devem ser executados enquanto oSTRDSMOND, STRASMOND ou o carregamento de dados estiverem emexecução. O horário e a freqüência com os quais os comandos de manutenção e asopções de processamento especificadas são executados variam, dependendo do seuambiente.

Por exemplo, se você não carrega dados todos os dias, ou se inclui algumas linhasno banco de dados ao carregar dados, pode programar a manutenção com menorfreqüência, talvez uma vez por semana. No entanto, se você carregar um volumealto de dados todos os dias, deverá manter o banco de dados depois de concluir oprocessamento de carregamento. Se o seu sistema tiver bastante espaço disponívelem disco para armazenar o dado do índice e relatórios, os programas demanutenção poderão ser planejados com menos frequência.

Os exemplos a seguir ilustram um método de manutenção diária. Os exemplosutilizam opções típicas para manter o banco de dados e o armazenamento emdisco e criam imagens de backup completo do banco de dados. Os programas demanutenção são programados para serem executados pela manhã cedo, antes de osusuários começarem a acessar o sistema. Esse planejamento supõe que todo ocarregamento de dados é concluído antes do início dos programas de manutenção.Utilize os exemplos como guia.

Manutenção de Dados do Grupo de AplicativosAbout this task

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


gerenciamento de armazenamento a partir de grupos de aplicativos. Os comandospodem fazer o seguinte para os grupos de aplicativos:v Copiar dados de relatório do armazenamento em disco para o armazenamento

em archivev Expirar dados de relatório do armazenamento em disco e do armazenamento em

archivev 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.

See the IBM Content Manager OnDemand for i: Common Server Administration Guidefor more information about the STRDSMOND and STRASMOND commands.

Backing up the Content Manager OnDemand databaseAfter you finish loading data into Content Manager OnDemand and maintainingthe database, we recommend that you create a backup image of the ContentManager OnDemand database.

About this task

A imagem de backup pode ser utilizada para recuperar o banco de dados, no casode falha no hardware ou se os dados do aplicativo forem danificados. Se vocêprocessa vários carregamentos todos os dias, então convém fazer backup do bancode dados uma vez ao dia, após o último processo de carregamento ser concluído.

See the section on backing up data and IBM Content Manager OnDemand for i:Common Server Administration Guide for more information about backing up yourContent Manager OnDemand data.


Parte 5. Preparação do Sistema para Utilização

This section of the book describes how to verify the installation of ContentManager OnDemand.

Outras tarefas 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. After installing andconfiguring Content Manager OnDemand, IBM recommends that you create abackup copy of the Content Manager OnDemand database.


Saving Content Manager OnDemand passwords intoencrypted files

É possível armazenar IDs do usuário e senhas em arquivos criptografados (tambémchamados arquivos stash).

About this task

Armazenar senhas no arquivo stash pode ajudá-lo a melhorar a segurança porquenão é necessário especificar a senha na linha de comandos onde a senha pode estarvisível para outras pessoas. É possível armazenar o ID do usuário e senha nassituações a seguir em um arquivo stash:v Each Content Manager OnDemand instancev Each Content Manager OnDemand program that runs as a daemon or service

(for example, arsload)

Armazene o arquivo stash em um diretório e especifique esse diretório noparâmetro SRVR_OD_STASH do arquivo ARS.INI. Content Manager OnDemandprograms locate the stash file in that directory. If you need to override the user IDand password stored in the stash file, create a stash file and store it in a directorywhere you run a Content Manager OnDemand program. Por motivos desegurança, limite o acesso ao arquivo por meio de permissões do arquivo ouexclua-o quando não precisar mais dele.

Para armazenar os IDs do usuário e senhas em um arquivo stash, execute as etapasa seguir:

Procedure1. Create a stash file by running the arsstash command. O comando solicita a

senha. Para obter uma descrição da sintaxe do comando ARSSTASH, consulte“Sintaxe do Comando ARSSTASH” na página 92. For examples of ARSSTASHcommands, see “Exemplos de Comandos ARSSTASH”.

2. Salve o arquivo stash em um diretório e limite o acesso a esse arquivo por meiode permissões de arquivo.

Exemplos de Comandos ARSSTASHPara armazenar o ID de usuário USER2 e a senha para o serviço LDAP em umarquivo stash existente denominado ars.stash, insira o comando a seguir: arsstash-a 7 -s ars.stash -u USER2

Para armazenar o ID de usuário USER3 e a senha do daemon ARSLOAD em umarquivo stash existente denominado ars.stash, insira o comando a seguir: arsstash-a 3 -s ars.stash -u USER3

Para armazenar o ID de usuário DEMOUSER e a senha para uso por qualquerinstância, daemon ou serviço OnDemand, e armazenar esse ID e senha em umarquivo stash existente denominado ars.stash, insira o comando a seguir: arsstash-a 1 -s ars.stash -u DEMOUSER

Para visualizar o ID do usuário atualmente designado para ARSLOAD, insira ocomando a seguir: arsstash -a 3 -s ars.stash


Sintaxe do Comando ARSSTASHO diagrama a seguir descreve a sintaxe do comando ARSSTASH:

�� arsstash -s stash_file_name-a action -c

-u userid

��

A lista a seguir descreve os parâmetros do comando ARSSTASH:

actionEspecifica se um ID do usuário e senha devem ser armazenados ou excluídosdo arquivo stash. Se você não especificar o parâmetro -a, o comando executaráa ação 1. Se você não especificar o parâmetro -u com ações, o comandoARSSTASH exibirá o ID do usuário atualmente designado para essa instância,daemon ou serviço. É possível especificar um dos seguintes valores para oparâmetro action:

1 Store the Content Manager OnDemand user ID and password. Se você nãoespecificar uma ação, essa ação será a ação padrão.

2 Delete the Content Manager OnDemand user ID and password.

3 Store the Content Manager OnDemand user ID and password for theARSLOAD program.

6 Store the Content Manager OnDemand user ID and password forProduction Data Distribution.

7 Armazene o ID do usuário LDAP e senha.

-c Crie um arquivo stash.

-sstash_file_nameNome do arquivo stash.

-uuseridUser ID for the Content Manager OnDemand instance, daemon, or servicespecified by the action variable.


Verificação da Instalação

You can verify the Content Manager OnDemand installation by completing thefollowing tasks.

Procedure

Para verificar a instalação:1. Conclua todas as etapas necessárias para instalar o software de servidor.2. Conclua todas as etapas necessárias para configurar o servidor.3. If you have not already done so, install the Content Manager OnDemand

client program on a workstation.4. Start the Content Manager OnDemand client program. Content Manager

OnDemand displays the Logon to a Server dialog box.5. Click Update Servers. Content Manager OnDemand displays the Update

Servers dialog box.6. Enter the name of the Content Manager OnDemand server. Clique em Ajuda

para obter informações sobre campos e opções.7. Click Add > Close to return to the Logon to a Server dialog box.8. Selecione o nome do servidor incluído na caixa de diálogo Atualizar

servidores, se ainda não estiver selecionado.9. Type a Content Manager OnDemand user ID and password in the fields

provided. The first time that you log on to the system, you must specify thebuilt-in Content Manager OnDemand user ID, QONDADM. Inicialmente, asenha é QONDADM1. No entanto, será solicitado que você insira e verifiqueuma nova senha.

10. Open and search the System Log folder.

Results

If you were able to view messages stored in the system log, then you can considerthe installation of Content Manager OnDemand successful.

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.


Definição das políticas de migração e dos conjuntos dearmazenamento

You must define migration policies and storage sets before you can define reportsto Content Manager OnDemand or load data into the system.

You can set up Content Manager OnDemand to copy data to disk storage orarchive storage (or both). Os atributos de gerenciamento do armazenamento dosgrupos 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. The Content Manager OnDemandonline help provides details about defining storage characteristics. Also see theIBM Content Manager OnDemand for i: Common Server Administration Guide for moreinformation about migration policies and storage sets.

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.


Configuração do Grupo de Aplicativos do Log do Sistema

When you install and configure Content Manager OnDemand, you initialize thesystem log.

O log do 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. TheSystem Log application group contains the storage management information thatContent Manager OnDemand uses to maintain the data written to the system log.Quando você inicializa o sistema, o grupo de aplicativos não é atribuído a umapolítica de migração e nem a um conjunto de armazenamento. Como o grupo deaplicativo não está designado a um conjunto de armazenamento, o sistema nãomigra uma cópia dos dados do log do sistema para a mídia de archive.

IBM recommends that, before you begin defining reports to Content ManagerOnDemand, loading data into the system, or allowing users to access the system,you configure the System Log application group to maintain a permanent copy ofthe data that is written to the system log. Isso pode ser feito definindo primeirouma política de migração (e seu conjunto de armazenamento correspondente) queespecifique uma mídia de armazenamento em archive, tal como conjunto de discos,ótica ou de fita e, em seguida, atualizando o grupo de aplicativos de Log dosistema e atribuindo-o ao conjunto de armazenamento.

Não importa onde decidir manter dados de Log do Sistema, é importante notarque a procura do Log do Sistema é uma das várias maneiras de localizar o ID deCarga para os dados arquivados. Every time data is loaded into Content ManagerOnDemand, message number 87 is placed in the System Log, and the Load ID isrecorded as part of that message. O ID da Carga (também chamado "ID doRelatório") é um parâmetro necessário para os comandos Remove Report(RMVRPTOND) e Print Report (PRTRPTOND).

Mantendo Dados de Log do Sistema no Armazenamento de ArchiveA 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.

About this task

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.

Procedure

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. Start the Content Manager OnDemand Administrator client.2. Log on to the server with a user ID that has system administrator authority.

(The default user named QONDADM has system administrator authority.)3. Click Application Groups.4. Right-click on the System Log application group.5. From the pop-up menu, select Update to open the Update an Application

Group window.6. Click the Storage Management tab.7. In the Storage Set Name list, select the name of the storage set. The storage set

name selected should match the migration policy definition created for yourSystem Log data.

8. Under Cache Data, specify at least 1 day for the Cache Document Data for xDays value. O grupo de aplicativos Log do Sistema é criado com um valorpadrão de 10000 dias em cache. É possível reduzir esse número ao configuraro grupo de aplicativos Log do Sistema para usar um conjunto dearmazenamento . Você deve especificar pelo menos um dia em cache, paraque as entradas de log do sistema sejam anexadas às entradas anteriores acada dia, para gerenciamento de armazenamento mais eficiente, antes que elassejam enviadas para o gerenciador de armazenamento.

9. Click Advanced to open the Advanced Storage Management dialog box.10. Select Next Cache Migration under Migrate Data from Cache. Content

Manager OnDemand copies the system log data to archive storage the nexttime the maintenance commands execute. Você também pode selecionar Apósx dias no cache, se quiser que os dados de log do sistema permaneçam nocache (em disco) durante algum período antes de serem copiados para oarmazenamento em archive. É possível selecionar Próxima Migração emCache ou Após x Dias em Cache em vez de Quando os Dados SãoCarregados para que as entradas de log do sistema sejam anexadas àsentradas anteriores a cada dia para gerenciamento de armazenamento maiseficiente, antes que elas sejam enviadas para o gerenciador dearmazenamento.

11. Click OK to close the Advanced Storage Management dialog box.12. Click OK to save your changes and close the Update an Application Group

window.

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.No entanto, é 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 do Carregamento para os dados específicos que estão sendo carregados (que énecessário para PRTRPTOND e RMVRPTOND, conforme descrito anteriormenteneste capí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. (See the IBM Content ManagerOnDemand for i: Common Server Administration Guide for more details regarding the


use of the ARSDOC DELETE API.) 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 ’System Log’-f ’System Log’ -S 01.05.2007,10.05.2007,%d.%m%Y06/06/07 11:30:39: Starting arsdoc. Version: 7.206/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: Searching for folder ’System Log’ ...06/06/07 11:30:39: Search successful06/06/07 11:30:39: Searching for documents in ’System Log’ ...06/06/07 11:30:39: Querying database with SQL string ’WHERE NOT(MSG_NUM = 87)’06/06/07 11:30:41: Search successful06/06/07 11:30:41: Deleting 6161 documents06/06/07 11:30:45: Delete successful06/06/07 11:30:41: arsdoc completed.

After you run ARSDOC DELETE to clean up your unneeded system log entries,Content Manager OnDemand reuses the space that had been used by the recordsyou just deleted. Como alternativa, é possível optar por reorganizar os arquivos delog do sistema usando o comando do IBM i, Reorganize Physical File Mbr(RGZPFM). Por exemplo, você pode executar RGZPFM instance_name/SL2, em queinstance_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. Log on to the server with the Content Manager OnDemand Administrator

Client.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.

Configuração do Grupo de Aplicativos do Log do Sistema 99

Configurando o Grupo de Aplicativos de Carregamento doSistema

When you install and configure Content Manager OnDemand, you also initializethe system load logging facility.

About this task

O recurso de criação de log de carregamento do sistema consiste no grupo deaplicativos Carregamento do Sistema, em um conjunto de aplicativos decarregamento do sistema e na pasta Carregamento do Sistema. The System Loadapplication group contains the storage management information that ContentManager OnDemand uses to maintain the data written to the system load loggingfacility. Quando você inicializa o sistema, o grupo de aplicativos não é atribuído auma política de migração e nem a um conjunto de armazenamento. Como o grupode aplicativos não está designado a um conjunto de armazenamento, o sistema nãomigra uma cópia dos dados de log do sistema para a mídia de archive.

Before you begin defining reports to Content Manager OnDemand, loading data onthe system, or allowing users to access the system, you should configure theSystem Load application group to maintain a permanent copy of the data that iswritten to the system load logging facility. É possível fazer isso definindo primeirouma política de migração (e seu conjunto de armazenamento correspondente) queespecifica a mídia de armazenamento de archive, como um conjunto de discos,ótico ou de fitas e, em seguida, atualizando o grupo de aplicativos Carregamentodo Sistema e designando-o para o conjunto de armazenamento.

Não importa onde decidir manter dados de Carregamento do Sistema, éimportante notar que a procura da pasta Carregamento do Sistema é a maneiramais direta de localizar o ID do Carregamento para dados arquivados. Every timedata is loaded into Content Manager OnDemand, a record is written to the SystemLoad logging facility and the Load ID is recorded as part of that record. O ID doCarregamento (também chamado "ID do Relatório") é um parâmetro necessáriopara os comandos Remove Report (RMVRPTOND) e Print Report (PRTRPTOND).

Designando o Grupo de Aplicativos Carregamento do Sistema a umConjunto de Armazenamento

Se for necessário que o sistema mantenha dados de carregamento do sistema noarmazenamento de archive, você deverá designar o grupo de aplicativosCarregamento do Sistema a um conjunto de armazenamento que mantém dadosindefinidamente.

Antes de Começar

The Content Manager OnDemand online help provides information about theoptions on the Storage Management page of application group definitions.

About this task

Após criar a política de migração (que cria automaticamente um conjunto dearmazenamento com o mesmo nome), você deverá atualizar o grupo de aplicativos


|

|

|

||

|

|||||||||

||||||||

|||||||

||

|

||||

|

||

|

||

Carregamento do Sistema e designá-lo ao conjunto de armazenamento. Apósdesignar o grupo de aplicativos ao conjunto de armazenamento e reiniciar oservidor, o sistema manterá automaticamente uma cópia dos dados decarregamento do sistema no armazenamento de archive especificado. Conclua asetapas a seguir para designar o grupo de aplicativos Carregamento do Sistema aum conjunto de armazenamento:

Procedure1. Start the Content Manager OnDemand Administrator client.2. Log on to the server with a user ID that has system administrator authority.

(The default user named QONDADM has system administrator authority.)3. Click Application Groups.4. Right-click on System Load application group.5. From the pop-up menu, select Update to open the Update an Application

Group window.6. Click the Storage Management tab.7. In the Storage Set Name list, select the name of the storage set. O conjunto de

armazenamento selecionado deve identificar uma mídia de arquivamento quemantenha dados indefinidamente.

8. Click OK.


||||||

|

|

||

|

|

||

|

|||

|

|

Configuração do Grupo de Aplicativos de Migração doSistema

Index migration is the process by which Content Manager OnDemand movesindex data from the database to archive storage.

A migração do índice não é recomendada.

Esse processo otimiza o espaço de armazenamento do banco de dados ao mesmotempo que permite a manutenção de dados do índice por muito tempo.Normalmente, os dados de índice são migrados quando os usuários não precisammais acessar os relatórios, mas por exigência jurídica ou por outro motivo, ainda énecessário manter os dados por alguns anos ou meses. Content ManagerOnDemand uses the storage management settings in application groups todetermine whether or not to migrate index data to archive storage. Todos os dadosmigrados são gerenciados por meio do grupo de aplicativos Migração do sistema.

When you install and configure Content Manager OnDemand, you initialize thesystem migration function. A migração do sistema consiste no grupo de aplicativosde Migração do sistema, em um conjunto de aplicativos de Migração do sistema ena pasta de Migração do sistema. The System Migration application group containsthe storage management information that Content Manager OnDemand uses tomaintain index data migrated to archive storage. Until you assign the applicationgroup to a storage set that specifies archive media, Content Manager OnDemandcannot migrate index data from the database to archive storage.

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.

Antes de Começar

The Content Manager OnDemand online help provides information about theoptions on the Storage Management page.

About this task

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 designar o grupo de aplicativos de Migração doSistema para um conjunto de armazenamento:

Procedure1. Start the Content Manager OnDemand Administrator client.2. Log on to the server with a user ID that has system administrator authority.

(The default user named QONDADM has system administrator authority.)3. Click Application Groups.


|

||

|

4. Right-click on System Migration application group.5. From the pop-up menu, select Update to open the Update an Application

Group window.6. Click the Storage Management tab.7. In the Storage Set Name list, select the name of the storage set. O conjunto de

armazenamento selecionado deve identificar uma mídia de arquivamento quemantenha dados indefinidamente.

8. Click OK.


|

||

|

|||

|

Backing up the Content Manager OnDemand data

To complete the installation and configuration process, we recommend that youcreate a full, offline backup of the Content Manager OnDemand database onremovable media.

O backup completo do banco de dados é necessário para recriar o banco de dados,caso necessário. A única forma de recriar o banco de dados é se você tiver umbackup completo do banco de dados (e todos receptores de diário gerados desde oúltimo backup completo do banco de dados). See the IBM Content ManagerOnDemand for i: Common Server Administration Guide for more information aboutbacking up your Content Manager OnDemand data.

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.


Parte 6. Apêndices


Apêndice A. Servidores de Banco de Dados

The ARS_NUM_DBSRVR parameter in the ARS.CFG file determines the number ofprocesses that Content Manager OnDemand can start on the server to handledatabase requests. É possível usar o parâmetro ARS_NUM_DBSRVR para equilibrar odesempenho, distribuindo a carga de trabalho do banco de dados entre váriosprocessos e o uso de recursos do sistema.

Cada acesso ao banco de dados requer um agente do banco de dados. ContentManager OnDemand can start a database agent for each access.

Entretanto, isso consome muitos recursos do sistema, pois um novo job é iniciadosempre que um agente do banco de dados é iniciado. You can use theARS_NUM_DBSRVR parameter to optimize the way that Content Manager OnDemandhandles the database load. For example, you can define ARS_NUM_DBSRVR so thatContent Manager OnDemand starts a fixed number of database agents, regardlessof the number of concurrent database requests. Embora isso possa parecerrestritivo, geralmente os pedidos do banco de dados são processados muitorapidamente.

Os fatores a serem considerados ao configurar 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ê configure o parâmetro ARS_NUM_DBSRVR para suportar onúmero de pico de acessos simultâneos ao banco de dados que você espera que oservidor manipule. Um valor baixo limita o acesso ao banco de dados duranteperíodos de alta atividade no banco de dados. Um valor alto exige mais recursosdo 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.

DescriçãoCada acesso ao banco de dados requer um agente do banco de dados. ContentManager OnDemand can start a database agent for each access.

Entretanto, isso consome muitos recursos do sistema, pois um novo job é iniciadosempre que um agente do banco de dados é iniciado. You can use theARS_NUM_DBSRVR parameter to optimize the way that Content Manager OnDemandhandles the database load. For example, you can define ARS_NUM_DBSRVR so thatContent Manager OnDemand starts a fixed number of database agents, regardlessof the number of concurrent database requests. Embora isso possa parecerrestritivo, geralmente os pedidos do banco de dados são processados muitorapidamente.

Os fatores a serem considerados ao configurar o parâmetro ARS_NUM_DBSRVRincluem:v Número de usuários simultâneos


v Número de jobs de carregamento de dados ativosv Número de processos de manutenção do banco de dados ativos

Recomendamos que você configure o parâmetro ARS_NUM_DBSRVR para suportar onúmero de pico de acessos simultâneos ao banco de dados que você espera que oservidor manipule. Um valor baixo limita o acesso ao banco de dados duranteperíodos de alta atividade no banco de dados. Um valor alto exige mais recursosdo 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.


Apêndice B. suporte ao idioma nacional

Visão GeralThis chapter contains information about the National Language Support (NLS)provided by Content Manager OnDemand, including information about the codepages (code sets) supported to provide national language (NL) character support.

Conversão entre Páginas de Códigos DiferentesA Content Manager OnDemand instance is a logical Content Manager OnDemandserver environment, with one library (and set of database files). Each ContentManager OnDemand instance must run in a single code page.

A 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.

Ideally, for optimal performance, Content Manager OnDemand clients andapplications should always use the same code page as the Content ManagerOnDemand instance. Entretanto, esse processo nem sempre é prático ou possível.Content Manager OnDemand provides support for character conversion thatallows clients, applications, and instances to use different code pages. While aContent Manager OnDemand instance must run in a single code page, clients thataccess the instance can operate in any code page and reports that you store inContent Manager OnDemand can contain characters encoded in any code page.

However, when you use different code pages, Content Manager OnDemand mightneed to convert characters from one code page to a different code page in order tomaintain the meaning of the data.

Quando a Conversão de Caracteres Ocorre?A conversão de caracteres pode ocorrer em várias situações.

A conversão de caracteres pode ocorrer nas seguintes situações:v When a client is operating in a code page that is different from the code page of

the Content Manager OnDemand instance.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. For example, a Windows client operating in the Latin 1 code page 1252can access a Content Manager OnDemand instance that has character dataencoded in the Latin 1 code page 819 (code set ISO 8859-1).Any data that the user enters (or default values) is converted to Unicode byContent Manager 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, a senha e o nome do servidor para efetuar login em um servidor.Content Manager OnDemand converts the characters from the code page of theclient to Unicode and then from Unicode to the code page of the instance.


Any data sent to the client is converted to Unicode by Content ManagerOnDemand. Os dados de Unicode resultantes em seguida são convertidos napágina de códigos do cliente. Por exemplo, após autenticar o ID do usuário e asenha, o servidor constrói uma lista de nomes da pastas que o usuário estáautorizado a abrir. Content Manager OnDemand converts the characters fromthe code page of the instance to Unicode and then from Unicode to the codepage of the client.

v When Content Manager OnDemand index data is in a code page that is differentthan the code page of the Content Manager OnDemand instance.A conversão de dados de caracteres ocorre no servidor utilizando tabelas demapeamento da página de códigos Unicode. Content Manager OnDemandconverts the characters from the code page of the index data to Unicode andthen from Unicode to the code page of the instance. Por exemplo, os dados deíndice com a página de códigos 1252 podem ser armazenados em uma instânciaque tenha dados de caracteres codificados na página de códigos 37.

A conversão de caracteres não ocorrerá para:v Documents stored in Content Manager OnDemand.

When you store documents in Content Manager OnDemand, they are stored onthe server as a byte stream and no character conversion occurs. For example, ifthe characters in the document are encoded in code page 500, the charactersremain encoded in code page 500 when stored in Content Manager OnDemand.When a user retrieves a document from Content Manager OnDemand, the serversends the document to the client without converting the characters from onecode page to the other. Por exemplo, um documento é armazenado noOnDemand com caracteres codificados na página de códigos 500. Quando ousuário recupera o documento, ele permanece codificado na página de códigos500, embora o cliente possa estar executando em uma página de códigosdiferente daquela da instância, tal como 1252. Entretanto, o programa deexibição do cliente mapeia caracteres em um documento da página de códigosdo servidor para a página de códigos do cliente.

Mapeamento de CaracterePara o conjunto de caracteres de byte duplo (DBCS), dados do AFP e DBCS edados de linha do conjunto de caracteres de byte único (SBCS), o clienteOnDemand converte automaticamente os caracteres em um documento da páginade códigos do servidor para a página de códigos do cliente usando conversoresICU.

Esse método de mapeamento de caracteres funciona com o cliente Windows esuporta os idiomas DBCS (para AFP e dados em linha) e SBCS (para dados emlinha) inclusive a maior parte dos mapeamentos de UDCs (Caracteres Definidospelo Usuário) DBCS. Os conversores ICU mapeiam automaticamente a áreadefinida pelo usuário de uma página de códigos para a área definida pelo usuáriopadrão da tabela ICU correspondente. Se a página de códigos contivermapeamentos UDC fora da área definida pelo usuário padrão, você poderá criar eusar seu próprio conversor ICU. (Caso contrário, o programa de visualização nãopoderá exibir os caracteres corretamente.) Use o utilitário Character DataRepresentation Architecture (CDRA) para criar seu próprio conversor ICU. Paradados do AFP, altere o parâmetro IconvLocalePath na seção Preferências doarquivo FLDPORT2.INI para usar seu próprio conversor ICU. For informationconcerning character data conversion, font mapping, and related matters, see theIBM Content Manager OnDemand Windows: Client Customization Guide.


O AFP Viewer opera internamente em Unicode e usa o ICU para converter dados.

Configuração do Sistema para NLSWhen you create a Content Manager OnDemand instance, you specify thelanguage identifier and locale for the instance. Esses valores determinam asdefinições do idioma para a instância.

Identificadores de Idiomas, CCSIDs e Códigos de IdiomasLanguage identifiers are used to tag difference languages that Content ManagerOnDemand supports.

The information can help you determine the language identifier and locale to usewhen creating a Content Manager OnDemand server instance. Uma instância podeser criada em qualquer idioma, mesmo que esse idioma não esteja instalado parai5/OS. A partir da V5R4, o código do idioma base para cada idioma foi alteradopara incluir o suporte para a moeda Euro. Novos códigos de idioma foram criadossem suporte ao Euro. Por exemplo, o código do idioma ES_ES agora inclui suporteao Euro, assim como o código do idioma ES_ES_E existente. Se você necessitar deum código de idioma em espanhol sem suporte ao Euro, deve utilizar ES_ES_PE. Atabela não fornece uma lista completa de todos os identificadores de idiomas,CCSIDs ou códigos de idiomas.

Tabela 6. Identificadores de Idiomas, CCSIDs e Códigos de Idiomas Suportados

Identificador doIdioma

País ou região CCSID Código de Idioma

CHS China 1388 ZH_CN

HRV Croácia 870 HR_HR

CZE República Tcheca 870 CS_CZ

DAN Dinamarca 1142 DA_DK

ARA Egito 420 AR_AA

FIN Finlândia 1143 FI_FI

FRA França 1147 FR_FR

DEU Alemanha 1141 DE_DE

ELL Grécia 4971 EL_GR

HUN Hungria 870 HU_HU

ITA Itália 1144 IT_IT

JPN Japão 5035 JA_5035

KOR Coréia 933 KO_KR

NLD Holanda 1140 NL_NL

NOR Noruega 277 NO_NO

PLK Polônia 870 PL_PL

PTB Brasil 37 PT_BR

RUS Rússia 1025 RU_RU

SKY Eslováquia 870 SK_SK

SLO Eslovênia 870 SL_SI

ESP Espanha 1145 ES_ES

SVE Suécia 1143 SV_SE

Apêndice B. suporte ao idioma nacional 113

|

||

||||||||||

||

|||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

||||

Tabela 6. Identificadores de Idiomas, CCSIDs e Códigos de IdiomasSuportados (continuação)

Identificador doIdioma

País ou região CCSID Código de Idioma

CHT Taiwan 937 ZH_TW

ENU Estados Unidos 37 EN_US

Nota:

v Para uma instância no idioma japonês, ela deverá ser criada com CCSID 5035 elocale JA_5035. Using a CCSID and locale combination that only supportsuppercase characters causes unreadable Content Manager OnDemand messagesin the System Log.

v The Czech language code in IBM i is CSY; the Czech language code in ContentManager OnDemand is CZE.

Mapping AFP fontsÉ provável que você precise mapear as fontes usadas por seus documentos parafontes que podem ser exibidas no cliente.

You need to map AFP fonts if your documents contain fonts that are not defined toContent Manager OnDemand, if your documents contain modified IBM AFP fonts,or if your documents contain AFP fonts that you or others in your organizationcreated. Caso contrário, o programa de visualização talvez não consiga exibir oscaracteres corretamente. (If your documents use fonts that are not defined toContent Manager OnDemand, then users will see a message when viewing them.)The IBM Content Manager OnDemand: Windows Client Customization Guide providesdetails about mapping AFP fonts.

Mapeie fontes AFP utilizando os arquivos de definição de fontes fornecidos peloOnDemand. The files are stored in the FONT subdirectory under the directory inwhich Content Manager OnDemand was installed (by default, \ProgramFiles\IBM\OnDemand32).

Content Manager OnDemand provides font definition files for the followingmulti-byte languages: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, ela serásuportada no visualizador AFP. O mapeamento de fonte real a partir da fonte AFPpara a fonte Windows ocorre na seção [FGID] do arquivo CSDEF.JPN (a seção[FGID] fica no final do arquivo). Se uma fonte não for listada no arquivoCSDEF.JPN, será possível incluir a fonte editando o arquivo CSDEF.JPN com umeditor de texto padrão.

Criando 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 grupo de aplicativos. Oscampos de banco de dados representam categorias de informações em umrelatório. Quando você carrega um relatório em um grupo de aplicativos,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. The maximum length of a string field in Content ManagerOnDemand is 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 você usar o comando Incluir um Grupo de Aplicativos para incluir gruposde aplicativos, 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 do Campo.

Criando 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.

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 do


aplicativo 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 usando o OnDemand Administrator Client, usando o campo Modode PR na guia Visualizar Informações dentro de uma definição do 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. The IBM ContentManager OnDemand: Windows Client Customization Guide provides details aboutmapping AFP fonts.

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: Referência de Indexação para obter informações adicionais.

Visualizaçõ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 for feito, asmodificações serão perdidas.

Running Content Manager OnDemand programsCertain Content Manager OnDemand programs accept input data (parameters andvalues) from a parameter file. Quando você trabalha com um banco de dados doidioma de byte duplo, os dados no arquivo de parâmetros devem ser codificadosna página de códigos do banco de dados. Tabela 7 lists the DBCS countries orregions that are supported by Content Manager OnDemand and the code page thatyou must run under when you create the parameter file. Quando for necessáriocriar 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 7. 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 C. Log do Sistema e Saída do Usuário de Log doSistema

Content Manager OnDemand generates messages about the various actions thatoccur on the system. For example, when a user logs on the system, ContentManager OnDemand generates a message that contains the date and time, the typeof action, the user ID, and other information.

You can configure Content Manager OnDemand to save the messages to a systemlog. Além disso, pode configurar o sistema para enviar as mensagens a umprograma definido pelo usuário. O programa definido pelo usuário pode processarmensagens da forma que você desejar. Por exemplo, pode enviar alertas paraadministradores, compilar estatísticas ou gerar informações sobre contas.

Você deve fazer o seguinte para configurar o sistema para enviar as mensagens aum programa definido pelo usuário:v Enable Content Manager OnDemand to generate system messages and specify

the types of messages generated by selecting the appropriate options in theSystem Parameters dialog box.

v Enable Content Manager OnDemand to generate application group messages byselecting the appropriate option in the System Parameters dialog box.

v Especifique os tipos de mensagens do grupo de aplicativos geradas selecionandoas opções na página Criação de Log de Mensagens nos grupos de aplicativos.

v Enable Content Manager OnDemand to send messages to a user-definedprogram by selecting the appropriate options in the System Parameters dialogbox.

After you have completed these steps, Content Manager OnDemand automaticallysaves the messages in the system log and sends the messages to the user-definedprogram.

Content Manager OnDemand sends the messages to a program called ARSLOG. Oprograma ARSLOG fornecido pela IBM não executa nenhuma função. No entanto,é possível 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.

The messages that Content Manager OnDemand sends to the ARSLOG programcontain the parameters listed in the table.

Tabela 8. Parâmetros do Programa ARSLOG (Programa de Saída de Usuário do Log doSistema)

Parâmetro Objetivo Tamanho Exemplo

$1 Content ManagerOnDemand instance

10 carac QUSROND

$2 Marca de hora 20 carac 08/13/95 14:24:31

$3 Identificador de registro dolog

10 carac 57049

$4 Content ManagerOnDemand user ID

128 carac QONDADM


Tabela 8. Parâmetros do Programa ARSLOG (Programa de Saída de Usuário do Log doSistema) (continuação)

Parâmetro Objetivo Tamanho Exemplo

$5 Informações de contas dousuário

60 carac Z76-001J/999999

$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. The fileis deleted immediately afterthe exit program returnscontrol to Content ManagerOnDemand.1

Nota:

1. For example, when viewing system log messages 87 or 88 from the ContentManager OnDemand Client, Yes is indicated under the View column heading ofthe document list. 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. Um exemplo doconteúdo desse parâmetro como ele é passado para a saída de usuário poderá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 todos os programas que ele possa chamar são executados comousuário QRDARS400. QRDARS400 deve ter autoridade para todos os objetos que oprograma ARSLOG usa.

Content Manager OnDemand programs are coded in the C language. No entanto,o programa ARSLOG pode ser escrito em qualquer idioma. Você é responsávelpor desenvolver o programa ARSLOG. Valide a qualidade e o desempenho doprograma ARSLOG e de todos os outros programas que ele chama.

Uma amostra do programa ARSLOG CL pode ser localizada no arquivo de origemQSAMPLES2 nas bibliotecas QRDARS e QUSRRDARS. Qualquer código fonte deprograma que você modificar não deve ser colocado na biblioteca QRDARS, poisela é substituída durante upgrades do software. Entretanto, a bibliotecaQUSRRDARS não é substituída e pode ser utilizada para a origem modificada.


Depois de ter criado o programa, você deve compilá-lo e colocá-lo em sua própriabiblioteca (não na QRDARS). Em seguida, você deve alterar o link simbólico em/QIBM/PRODDATA/ONDEMAND/BIN/ARSLOG para apontar para seu programa. Porexemplo, se você chamasse o programa MYARSLOG e o colocasse na bibliotecaQUSRRDARS, deveria primeiro excluir o link simbólico atual usando estecomando: RMVLNK OBJLNK('/QIBM/PRODDATA/ONDEMAND/BIN/ARSLOG'). Em seguida, você incluiria o link no programa usando este comando:ADDLNK OBJ('/QSYS.LIB/QUSRRDARS.LIB/MYARSLOG.PGM')NEWLNK('/QIBM/PRODDATA/ONDEMAND/BIN/ARSLOG')

A última etapa é assegurar que o programa ARSLOG seja ativado. Verifique oarquivo ARS.CFG para confirmar que a entrada ARS_DISABLE_ARSLOG não estáconfigurada como 1 (para desativar) para a instância para a qual é possível ativar acriação de log. ARS_DISABLE_ARSLOG=1 desativa o programa de saída ARSLOG.

The online Help for the administrative client provides information about enablingContent Manager OnDemand to generate messages and send them to theARSLOG program. The online Help also provides information about how to selectwhich application group messages that Content Manager OnDemand generatesand sends to the ARSLOG program.

Apêndice C. Log do Sistema e Saída do Usuário de Log do Sistema 121

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 BUSINESSMACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO "NO ESTADO EMQUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSAOU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, ASGARANTIAS IMPLÍCITAS (OU CONDIÇÕES) 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.

Estas informações podem incluir 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.


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:

Av. Pasteur, 138-146Av. Pasteur, 138-146BotafogoRochester, MN 55901–7829CEP 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 deamostra na linguagem fonte, ilustrando as técnicas de programação em diversasplataformas operacionais. O Cliente pode copiar, modificar e distribuir estesprogramas de amostra sem a necessidade de pagar à IBM, com objetivos dedesenvolvimento, utilização, marketing ou distribuição de programas aplicativosem conformidade com a interface de programação de aplicativo para a plataformaoperacional para a qual os programas de amostra são criados. Esses exemplos nãoforam testados completamente em todas as condições. Portanto, a IBM não pode


garantir ou implicar a confiabilidade, manutenção ou função destes programas. Osprogramas de amostra são fornecidos "NO ESTADO EM QUE SE ENCONTRAM",sem garantia de nenhum tipo. A IBM não será responsável por quaisquer danosque suscitarem 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. If theseand other IBM trademarked terms are marked on their first occurrence in thisinformation with a trademark symbol (® or ™), these symbols indicate U.S.registered or common law trademarks owned by IBM at the time this informationwas published. Estas marcas registradas também podem ser marcas registradas oude direito consuetudinário em outros países. A current list of IBM trademarks isavailable on the Web at “Copyright and trademark information” atwww.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

Índice Remissivo

Aadministrativas

funções e responsabilidades 16agentes de banco de dados 109ambientes do servidor lógico 67API 119APIs 17aplicativo

nomenclatura 39sobre 35visão geral 5, 35

aplicativos 4armazenamento

archive 53banco de dados 43, 48como calcular 43espaço em disco 47espaço temporário 46importação de dados de índice

migrados 48índices migrados 49planejamento para 43relatório 43relatórios de indexação 46relatórios em mídia de

arquivamento 48requisitos 43requisitos de armazenamento do log

de recuperação 48requisitos de armazenamento do log

de transações 48requisitos de armazenamento em

archive 48requisitos de armazenamento em

disco 46armazenamento de archive 21, 53

índices migrados 49mantendo dados de log do

sistema 97relatórios em mídia de

arquivamento 48requisitos 48sobre 21visão geral 21

armazenamento de curto prazo 53armazenamento do banco de dados 47armazenamento em disco 53

requisitos 46, 47arquivo ARS.CACHE 67arquivo ARS.CFG

conexões do banco de dados,especificação 83

configuração 81criação 67inicialização das instâncias 81instâncias de inicialização

automática 81parâmetro

ARS_AUTOSTART_INSTANCE 81parâmetro

ARS_DISABLE_ARSLOG 81

arquivo ARS.CFG (continuação)parâmetro ARS_LANGUAGE 82parâmetro

ARS_MESSAGE_OF_THE_DAY 83parâmetro

ARS_MSGS_LANGUAGE 83parâmetro ARS_NUM_DBSRVR 83,

109parâmetro ARS_PRINT_PATH 84parâmetro

ARS_SUPPORT_CFSOD 84parâmetro ARS_SUPPORT_HOLD 84parâmetro ARS_TMP 84Parâmetro

ARSSOCK_RESOLVE_CLIENT_NAME 85parâmetro de espaço temporário 84parâmetro de idioma 81, 82parâmetro de idioma de

mensagem 83parâmetro de impressão 84parâmetro de impressão do

servidor 84parâmetro de mensagem do dia 83parâmetros do gerenciador de banco

de dados 109parâmetros do servidor 83

arquivo ARS.DBFS 67arquivo ARS.INI 67arquivo de registro do sistema 17arquivos 55arquivos de configuração

como salvar 55arquivos de fonte 55arquivos de fonte do Windows 55arquivos de inicialização 85, 87arquivos de registro 17ARSLOG 18assistente de relatório 116avisos 123

Bbackup de banco de dados 52backup do banco de dados 88, 105backup e recuperação 51

banco de dados 52documentos 53relatórios 53visão geral 51

banco de dadosbackup 88, 105backup e recuperação 52conexões 83, 109criação 67importação de dados de índice

migrados 48logs 48manutenção 87migração 103nomes de campos 39planejamento da manutenção 87

banco de dados (continuação)processo de expiração 33recuperação 52requisitos de armazenamento do log


de transações 48requisitos de espaço de

armazenamento 48requisitos de memória 43tipos de campos 41

bancos de dados 109diários 52fazendo backup 52recuperando 52

Ccampo de pesquisa de cor da

anotação 41campos de datas

indexação 30tipo de campo da pasta 41tipo de campo do banco de dados 41

campos de filtrocampos, filtro 33

campos do índicecampos, índice 33

campos estruturados Map Coded FontFormat 2 116

campos estruturados Shift Out ShiftIn 115

campos estruturados SOSI 115campos MCF2 estruturados 116cargas múltiplas por tabela de banco de

dados 33carregamento, sistema

grupo de aplicativos,configuração 101

carregamento do sistemagrupo de aplicativos,

configuração 101CCSIDs 67CFSOD 84cliente

APIs 17personalização 17

cliente administrativocomo instalar 63

cliente do usuário finalcomo instalar 63

cliente WindowsAPIs 17personalização 17

códigos de idiomascomandos 77configuração 78definindo 77

coletando requisitos 25comando CRTINSTOND 69, 70comandos 17


comandos do servidor 17como instalar 61

Content Manager OnDemandsoftware 61

software 59como salvar arquivos de

configuração 55compactação 45comprimento da senha 39conceitos

aplicativo 5carregamento de dados 11dados do carregamento 11documento 8expiração 12gabinete 6gerenciador de armazenamento 11gerenciador de armazenamento em

arquivo 11gerenciador de armazenamento em

cache 11grupo de aplicativos 5indexação 11métodos de indexação 7migração 12pasta 5servidor 9servidor de bibliotecas 9servidor de objetos 9visão geral do sistema 4visão geral do sistema

cliente/servidor 4conexão com o banco de dados 83, 109configuração de armazenamento

definindo 22configurando o sistema 65configurando objetos 31conjuntos de armazenamento 95, 101,

103conjuntos de códigos 111Content Manager OnDemand overview

anotações 3gerenciamento de recurso 3índices 3reimpressão de fidelidade total 3

convençõesnomes 39

conversões de caracteres 111

Ddados

compactação 45formatos 26indexação 27

dados AFPentrada 26indexação 29

dados de linhaentrada 26indexação 27

dados de log do sistema 97dados do carregamento

visão geral 11dados do índice

migração 103

dados estendidos de SCSentrada 26

dados genéricosindexação 29

dados PDFindexação 29

dados SCSentrada 26

DB2conexões 83, 109parâmetro ARS_NUM_DBSRVR 109

DBCSassistente de relatório 116campos de grupos de aplicativos 115campos do banco de dados 115campos estruturados Shift Out Shift

In 115campos estruturados SOSI 115exibições lógicas 116fontes 114idiomas, suporte aos 111indexação de dados 116indexador genérico 116indexador gráfico 116páginas de códigos 115programas 117

definição da variável de ambiente de fusohorário 41

definição de um conjunto dearmazenamento 95

definição de um nó dearmazenamento 95

definindo a configuração dearmazenamento 22

definindo um relatório 31DHCP

ARSSOCK_RESOLVE_CLIENT_NAME 85diretórios do IFS 51documento

definido 1expiração 12indexação 11, 28migração 12sobre 8

documentosbackup e recuperação 53

Eespaço de armazenamento de

relatório 49espaço de armazenamento de relatório de

backup 49espaço temporário 84

requisitos de memória 46exibições lógicas 116expiração

visão geral 12

Fferramenta gráfica 29fontes 114fontes AFP 114formatos de arquivos suportados pelo

dados estendidos de SCS 26

formatos de arquivos suportados pelo(continuação)

dados SCS 26formatos dos dados de entrada 26funções

administrativas 16

Ggabinete

visão geral 6gabinetes 4gerenciador de armazenamento

expiração 12migração 12visão geral 11

gerenciador de banco de dados 10expiração 12migração 12visão geral 11

gerenciador de solicitações 10gerenciamento de armazenamento 45gerenciamento de trabalho do

servidor 73gravando mensagens 18grupo de aplicativos

indexação 33nomenclatura 39permissões 38sobre 33tipos de campos 41tipos de campos do banco de

dados 41visão geral 5, 33

gruposnomes 39sobre 36visão geral 36

grupos de aplicativos 4carregamento do sistema 101log do sistema 97manutenção 87migração de dados para o

armazenamento em archive 87migração do sistema 103planejamento da manutenção 87

grupos de aplicativos de carregamento dosistema 101

grupos de aplicativos de log do sistemaconfiguração 97

grupos de aplicativos de migração dosistema 103

Hhierarquia de armazenamento 45HOLD 84

Ii Navigator

configuração viiManagement Central viinavegação do sistema vii

identificadoresidioma 113


identificadores de idiomas 113importação de dados de índice migrados

requisitos de espaço dearmazenamento 48

indexaçãoalternativas 29campos de datas 30dados AFP 29Dados DBCS 116dados de linha 27dados genéricos 29dados PDF 29documentos 28espaço temporário 46grupos de aplicativos 33métodos 7outros dados 29outros programas de indexação 29programa Generic Indexer 30programa PDF Indexer 30programas 7, 29programas aplicativos 30relatórios 28requisitos 27requisitos de espaço 46visão geral 11

indexador genérico 116indexador gráfico 116índices

requisitos de espaço dearmazenamento em archive 49

índices migradosrequisitos de espaço de

armazenamento 49inicialização das instâncias 81inicialização do sistema 85, 87inicializando o sistema 65início de sessão

ARSSOCK_RESOLVE_CLIENT_NAME 85instalação da criação de log do

sistema 18instâncias 67

alterando uma instância 69como iniciar 74, 81conectando 74configuração 67, 69configurando uma instância 67criação 75excluindo 70excluindo uma instância 70inicialização automática 81iniciando automaticamente 74trabalhando 75

instâncias de inicialização automática 81interface de programação de aplicativo

log do sistema 119programas de saída do usuário 119

interfaces de programação deaplicativos 17

LLDAP

AIX 82, 83atributo 83conexões de ligação anônimas 82ligação de atributo 82

LDAP (continuação)nome distinto de base 82nome do host do servidor LDAP 83porta LDAP 83sequências de IDs do usuário de

login 83sequências de mensagens de login 82

linhas do banco de dados 47lista de verificação 59lista de verificação da instalação 59locale 81, 82log, sistema

definição de API 119programas de saída do usuário 119

log de recuperaçãorequisitos de espaço de

armazenamento 48log de transações

requisitos de espaço dearmazenamento 48

log do sistemadefinição de API 119programas de saída do usuário 119

logsrequisitos de espaço de

armazenamento 48

Mmanutenção de software 55mapeamento

caracteres 112mapeamento de caractere 112mapeamento de fontes AFP 114mensagens

definição de API 119log do sistema 119programas de saída do usuário 119

mídia de backup 51migração

armazenamento em cache doarmazenamento em archive 87

dados do grupo de aplicativos 87grupo de aplicativos,

configuração 103visão geral 12

migração de dados do índice 103migração do sistema

grupo de aplicativos,configuração 103

Monarchintegração com o cliente 18

monitores de filas de saídacomo iniciar 85

NNLS 111, 113nomes 39nomes de campos 39nomes de campos de consulta 39nomes de campos de pesquisa 39nós de armazenamento 95

Oobjetos 31objetos de armazenamento 21objetos para relatórios 31ODWEK 13organização do banco de dados

cargas múltiplas por tabela de bancode dados 33

OS/400 Indexervisão geral 11

Ppágina

indexação 28páginas de códigos 111, 115

conversões 111parâmetro ARS_NUM_DBSRVR 109parâmetro

ARS_AUTOSTART_INSTANCE 81parâmetro ARS_DISABLE_ARSLOG 81parâmetro ARS_LANGUAGE 82parâmetro

ARS_MESSAGE_OF_THE_DAY 83parâmetro ARS_MSGS_LANGUAGE 83parâmetro ARS_NUM_DBSRVR 83, 109parâmetro ARS_PRINT_PATH 84parâmetro ARS_SUPPORT_CFSOD 84parâmetro ARS_SUPPORT_HOLD 84parâmetro ARS_TMP 84Parâmetro

ARSSOCK_RESOLVE_CLIENT_NAME 85parâmetro de idioma 81, 82parâmetro de idioma de mensagem 83parâmetro de mensagem do dia 83parâmetro MCF2REF 116parâmetros

ARS_NUM_DBSRVR 109ARS_AUTOSTART_INSTANCE 81ARS_DISABLE_ARSLOG 81ARS_LANGUAGE 82ARS_MESSAGE_OF_THE_DAY 83ARS_MSGS_LANGUAGE 83ARS_NUM_DBSRVR 83, 109ARS_PRINT_PATH 84ARS_SUPPORT_CFSOD 84ARS_SUPPORT_HOLD 84ARS_TMP 84ARSSOCK_RESOLVE_CLIENT_NAME 85MCF2REF 116

parâmetros do gerenciador de banco dedados

ARS_NUM_DBSRVR 109Passport Advantage 61pasta

campo de pesquisa de cor daanotação 41

nomenclatura 39nomes de campos 39permissões 38sobre 32tipos de campos 41tipos de campos de consulta 41tipos de campos de pesquisa 41visão geral 5, 32

pastas 4

Índice Remissivo 129

PDF (Portable Data Format) 26perfis do usuário 36permissões

grupo de aplicativos 38pasta 38sobre 37visão geral 37

planejamento 15instalação 23

planejamento de programas demanutenção 87

políticas, migração 95políticas de migração 95Portable Data Format (PDF) 26pré-requisito 89preparando 15preparando o sistema para uso 89procedimentos de instalação 61processo de expiração 33processo de expiração em cache 33processo de migração em cache 33programa ARSLOG 119programa Generic Indexer 30programa PDF Indexer 30programa QSTRUP 85programas aplicativos

indexação com 30programas de gerenciamento

visão geral 12programas de manutenção

planejamento 87programas de saída do usuário

ARSLOG 119log do sistema 119

Rrecuperação 51

banco de dados 52recuperação de banco de dados 52registro do servidor 17, 18reinstalação de software 55relacionamentos do ID do usuário 36relatório

armazenamento em mídia dearquivamento 48

expiração 12formatos 26indexação 11, 27migração 12requisitos de memória 43

relatórios 25armazenando 53backup e recuperação 53

relatórios no disco 21requisitos

armazenamento 43armazenamento de archive 48armazenamento do banco de

dados 48armazenamento do software 46armazenamento em disco 46, 47banco de dados 48espaço de armazenamento de índice

migrado 49

requisitos (continuação)espaço de armazenamento para

importação de dados de índicemigrados 48

espaço temporário 46relatórios de indexação 46relatórios em mídia de

arquivamento 48requisitos de armazenamento do log


de transações 48requisitos de software

armazenamento 46armazenamento em disco 46

resolução de problema 78responsabilidades

administrativas 16

Ssaída de usuário de log do sistema 18saída do usuário no início de sessão 17saídas do usuário

início de sessão 17log do sistema 119

senhas 36, 39servidor

visão geral 9servidores

arquivo ARS.CFG 81como iniciar 71diretórios do IFS 51gerenciando trabalho 73parando 71

sistemas de arquivosarmazenamento em cache 87

sistemas de arquivos de armazenamentoem cache

manutenção 87planejamento da manutenção 87

softwarearquivos de configuração 55como instalar 59como salvar arquivos de

configuração 55manutenção 55obtendo 61reinstalando 55software de impressão

como instalar 59software de impressão do servidor

como instalar 59upgrade 55

software de impressãocomo instalar 59espaço temporário 84

software de impressão do servidorcomo instalar 59espaço temporário 84

software de servidor 51suporte a idioma nacional 81, 82, 83, 111Suporte ao Idioma Nacional 113

Ttamanho do log do sistema

reduzindo 98tamanhos de logs 98tarefas

administrativas 16servidores 85

tarefas do servidorcomo iniciar 85

tipos de campos 41tipos de campos de consulta 41tipos de campos de pesquisa 41tipos de dados 25transformação de dados 25

Uupgrade de software 55usuários

nomes 39senhas 39sobre 36visão geral 36

Vvariáveis de ambiente

FH (fuso horário) 41fuso horário (FH) 41

variável de ambiente de fuso horário 41variável de ambiente FH 41verificação da instalação 93visão geral 31visão geral de permissões do grupo 37visão geral de requisitos 43visão geral do sistema 4visão geral do sistema

cliente/servidor 4

WWeb Enablement Kit 13


��

Impresso no Brasil

SC19-2790-01