Você está na página 1de 222

IBM Tivoli Workload Scheduler para Aplicativos

Guia do Usurio
V erso 8.2

S517-7785-00

IBM Tivoli Workload Scheduler para Aplicativos

Guia do Usurio
V erso 8.2

S517-7785-00

Nota Antes de utilizar estas informaes e o produto a que elas se referem, consulte as informaes em Avisos na pgina 195.

Primeira Edio (Junho de 2003) Esta edio se aplica verso 8, release 2 do IBM Tivoli Workload Scheduler para Aplicativos (nmero do programa 5698-WSE) e a todos os releases e modificaes subseqentes at que seja indicado o contrrio em novas edies. Copyright International Business Machines Corporation 2000, 2003. Todos os direitos reservados.

ndice
Prefcio . . . . . . . . . . . . . . vii
Quem Deve Ler este Manual . . . . . . . . vii O que este Manual Contm . . . . . . . . . vii Publicaes . . . . . . . . . . . . . . ix Publicaes do IBM Tivoli Workload Scheduler . . x Publicaes do IBM Tivoli Workload Scheduler para z/OS . . . . . . . . . . . . . . x Kit de Coleo de Cpia Eletrnica para o IBM Tivoli Workload Scheduler para z/OS . . . . . xi Publicaes listadas . . . . . . . . . . xii Acessando Publicaes On-line . . . . . . . xii Solicitando Publicaes . . . . . . . . . xii Fornecendo Feedback sobre as Publicaes . . . xii Acessibilidade . . . . . . . . . . . . . xiii Entrando em Contato com o IBM Software Support xiii Convenes Utilizadas neste Manual . . . . . xiii Convenes de Tipo de Caractere . . . . . . xiii Variveis e Caminhos que Dependem do Sistema Operacional . . . . . . . . . . xiv

Captulo 5. Definindo os Jobs de Agente Estendido . . . . . . . . . . 37


Definindo Jobs com o Job Scheduling Console . . . 37 Definindo Jobs com a Linha de Comandos do Tivoli Workload Scheduler . . . . . . . . . . . 40 Definindo Jobs para Planejamento Ponto a Ponto . . 41

Parte 2. Mtodo de Acesso do Oracle e-Business Suite . . . . . . 43


Captulo 6. Introduo . . . . . . . . 45
Recursos . . . . . Requisitos de Software Tarefas de Ps-instalao Interface Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 45 45 47

Captulo 7. Informaes de Definio do Job . . . . . . . . . . . . . . . 49


Definindo Jobs no Oracle Applications . . . . Executando um nico Job Simultaneamente . Definindo Jobs do Oracle Applications no Tivoli Workload Scheduler . . . . . . . . . . Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications . . . . . . . . . . Estados do Job do Tivoli Workload Scheduler e do Oracle Applications . . . . . . . . . . . . 49 . 49 . 49 . 49 . 51

Parte 1. Tarefas Comuns de Instalao e Configurao . . . . . . 1


Captulo 1. Viso Geral do Produto . . . 3 Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos . . 5
Como Instalar . . . . . . . . . . . . . Utilizando o Assistente de Instalao . . . . Utilizando a Instalao Silenciosa . . . . . Utilizando o Tivoli Configuration Manager . . Desinstalando o Produto . . . . . . . . . Removendo uma Instalao por meio do ISMP Removendo uma Instalao por meio do Tivoli Configuration Manager . . . . . . . . Completando a Remoo do Mtodo de Acesso para Oracle e-Business Suite . . . . . . . . 6 . 7 . 17 . 20 . 23 24 . 24 . 24

Captulo 8. Referncia do Arquivo de Opes MCMAGENT . . . . . . . . . 53


O Arquivo de Opes . . . . . . . Sintaxe de Entrada . . . . . . . Exemplo . . . . . . . . . . Criptografando as Senhas de Usurios Applications . . . . . . . . . . . . do . . . . . . . . . . Oracle . . . 53 53 54 54

Captulo 3. Definindo Opes com o Editor de Opes . . . . . . . . . . 27


Criando um Arquivo de Opes Locais . Herana de Valor da Opo . . . . . . . . . . . . 29 . 30

Parte 3. Mtodo de Acesso do PeopleSoft . . . . . . . . . . . . 55


Captulo 9. Introduo . . . . . . . . 57
Recursos . . . . . . . . . . . . . Viso Geral Funcional . . . . . . . . . Jobs do Programador de Processo do PeopleSoft Rastreamento de Job do PeopleSoft no Tivoli Workload Scheduler . . . . . . . . Segurana . . . . . . . . . . . . . Notas sobre o Suporte ao PeopleSoft verso 8.x . . . . . . . 57 . 57 . 57 . 58 . 58 . 58

Captulo 4. Definindo as Estaes de Trabalho de Agente Estendido . . . . 31


Criando uma Estao de Trabalho com o Job Scheduling Console . . . . . . . . . . . Criando uma Estao de Trabalho da Linha de Comando . . . . . . . . . . . . . . Definindo Estaes de Trabalho para Planejamento Ponto a Ponto . . . . . . . . . . . . Criando a Instruo CPUREC . . . . . . Definindo a Estao de Trabalho com ISPF . .
Copyright IBM Corp. 2000, 2003

. 31 . 33 . 34 . 34 . 35

Captulo 10. Planejamento de Implementao . . . . . . . . . . . 61


PeopleSoft Verso 7.5 ou Anterior . Requisitos do Host . . . . . Requisitos de Software . . . . . . . . . . . . . . . . . . . 61 . 61 . 61

iii

Instalao para Usurio do Windows . . . . Verificando o Ambiente PeopleSoft . . . . Criando um ID de Processamento de Batch no PeopleSoft . . . . . . . . . . . . . Arquivos Instalados . . . . . . . . . PeopleSoft Verso 8.x . . . . . . . . . . Requisitos do Host . . . . . . . . . . Requisitos de Software . . . . . . . . Criando um ID de Processamento de Batch no PeopleSoft . . . . . . . . . . . . . Arquivos Instalados . . . . . . . . .

. 61 . 62 . . . . . 62 62 62 62 63

. 63 . 63

Captulo 11. Tarefas de Ps-Instalao


Configurao do Usurio para Windows . . . . Criando o Arquivo de Opes . . . . . . . . Editando Manualmente os Arquivos de Opes Conectando Mais de um Banco de Dados do PeopleSoft . . . . . . . . . . . . . . Configurando o Ambiente PeopleSoft para a Verso 7.5 ou Anterior . . . . . . . . . . . . . Personalizando o Servidor de Processo . . . . Configurando o Cliente . . . . . . . . . Executando o Script do Data Mover . . . . . Configurando o Ambiente PeopleSoft para Verso 8.1x . . . . . . . . . . . . . . . . . Personalizando o Servidor de Aplicativos . . . Configurando o Cliente . . . . . . . . . Configurando o Ambiente PeopleSoft para a Verso 8.4x . . . . . . . . . . . . . . . . .

65
65 65 68 69 69 69 71 73 74 74 75 75

Criando o Perfil de Autorizao para o Usurio do Tivoli Workload Scheduler . . . . . . . . . Utilizando a Transao SU02 e Criando Manualmente o Perfil . . . . . . . . . . Utilizando a Transao PFCG (Gerador de Perfil) Copiar os Arquivos de Correo e de Transporte . . Importar Mdulos ABAP/4 para R/3. . . . . . Instalando os Mdulos ABAP do r3batch no Sistema R/3 . . . . . . . . . . . . . . . . . Resoluo de Problemas . . . . . . . . . . Alterando a Senha de ID do Usurio RFC do Tivoli Workload Scheduler . . . . . . . . . . . Migrando de Verses Anteriores . . . . . . . Utilizando o Suporte a XBP 2.0 . . . . . . . . Criando o Perfil de Autorizao para o Usurio do Tivoli Workload Scheduler . . . . . . . Imprimir Parmetros e Problemas de Classe Job . .

91 91 92 94 94 95 96 97 97 98 98 99

Captulo 16. Definindo Jobs de Agente Estendido do R/3 . . . . . . . . . . 101


Definindo um Job no R/3 . . . . . . . . Definindo um Job no Tivoli Workload Scheduler Utilizando Janelas Especficas do SAP do Job Scheduling Console . . . . . . . . . Parmetros da Cadeia de Tarefas para Jobs do R/3 . . . . . . . . . . . . . . . Os Estados de Job do Tivoli Workload Scheduler e do R/3 . . . . . . . . . . . . . . . 101 101 . 102 . 110 . 112

Captulo 12. Definindo os Jobs do PeopleSoft . . . . . . . . . . . . . 77


Criando Definies de Job do Peoplesoft no Tivoli Workload Scheduler . . . . . . . . . . . Parmetros de Cadeia de Tarefas para Jobs do PeopleSoft . . . . . . . . . . . . . . Configurando o Opens Dependencies 7.x Apenas . . Exemplo de Dependncias Abertas . . . . . IBM Tivoli Workload Scheduler e o Mapeamento de Status do Job do PeopleSoft . . . . . . . . . 77 77 78 79 80

Captulo 17. Executando Jobs Novamente . . . . . . . . . . . . 113


Cpia Antiga e Cpia Nova de um Job Executado Novamente . . . . . . . . . . . . . . 113

Captulo 18. Business Information Warehouse . . . . . . . . . . . . 115


Business Information Warehouse Support InfoPackages . . . . . . . . . . Autorizaes do Usurio . . . . . Componentes do Business Warehouse . . Definindo os Jobs de Agente Estendido para Opes de Planejamento do R/3 de um InfoPackage . . . . . . . . . . . . . . 115 . . . 115 . . . 115 BIW 115 . . . 116

Parte 4. Mtodo de Acesso do R/3


Captulo 13. Introduo
Recursos . . . . . . . . . . . . . Planejando o Processo para o Agente Estendido R/3 . . . . . . . . . . . . . . . Suporte Interface do XBP 2.0 . . . . . .

83
. . 85 do . . 85 . . 86

. . . . . . . 85 Captulo 19. Conectando-se ao Sistema R/3 . . . . . . . . . . . . 117


Conexes para um Servidor de Aplicativos Especfico. . . . . . . . . . . . Grupos de Logon . . . . . . . . . . . . . . 117 . 118

Captulo 14. Instalao . . . . . . . . 87


Requisitos de Software . . . . . . Viso Geral da Instalao . . . . . Instalando em Plataformas de Nvel 2 . Criptografando Senhas de Usurio do R/3 . . . . . . . . . . . . . . . . 87 87 88 89

Captulo 20. Arquivos de Opes do Mtodo de Acesso do R/3 . . . . . . 119


Opes de Configurao . . . . . . Opes Globais . . . . . . . . Opes Locais . . . . . . . . Opes Gerais . . . . . . . . Utilizao das Opes de Configurao . Migrao de Arquivos de Configurao . . . . . . . . . . . . . . . . . . . . . . . . 119 119 120 121 124 125

Captulo 15. Configurao do R/3 . . . 91


Viso Geral . . . . . . . . . . . . . . 91 Criando um Usurio RFC do IBM Tivoli Workload Scheduler . . . . . . . . . . . . . . . 91

iv

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 21. BDC Wait. . . . . . . . 127


Utilizando Nomes de Sesso BDC . . . . Utilizando IDs da Fila BDC com o Relatrio BDCRECXX . . . . . . . . . . . . Utilizando IDs da fila BDC com FM BDC_OPEN_GROUP . . . . . . . . . . . . . 127 . 128 . 129

Consideraes de Sincronizao . Informaes de Diagnstico . . . Mensagens de Gateway . . . . .

. . .

. . .

. . .

. . .

. 161 . 162 . 162

Parte 6. Capacidade de Servios Comuns . . . . . . . . . . . . . 167


Captulo 27. Referncia do Agente Estendido . . . . . . . . . . . . . 169
O que So Agentes Estendidos? . . . . . Definio de Estao de Trabalho . . . . Interface do Mtodo de Acesso . . . . . Sintaxe da Linha de Comandos do Mtodo Mensagens de Resposta do Mtodo . . . Arquivo de Opes do Mtodo . . . . Execuo do Mtodo . . . . . . . . . Tarefa LJ (Lanar Job) . . . . . . . Tarefa MJ (Gerenciar Job) . . . . . . Tarefa CF (Verificar Arquivo) . . . . . Tarefa GS (Obter Status) . . . . . . . O Comando cpuinfo . . . . . . . . Resoluo de Problemas . . . . . . . . Mensagens de Erro da Lista Padro de Jobs Mtodo No Executvel . . . . . . . Mensagens do Gerenciador de Console . . Mensagens do Composer e do Compiler . Mensagens do Jobman . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 169 169 169 171 172 173 173 174 174 175 176 176 176 176 176 176 176

Captulo 22. Recursos de Interceptao de Job e Pais-filhos . . 131


Interceptao de Job . . . . . . . . Implementando a Interceptao de Jobs Recursos Pais-filhos . . . . . . . . . . . . . . . 131 . 131 . 134

Captulo 23. Suporte Nacional a Idiomas . . . . . . . . . . . . . . 137


Opes de Suporte Nacional a Idiomas . . Pginas de Cdigo Suportadas pelo R/3 . Configuraes Suportadas e Limitaes . . . . . . . . . 137 . 137 . 138

Parte 5. Mtodo de Acesso do z/OS . . . . . . . . . . . . . . . 139


Captulo 24. Introduo . . . . . . . 141
Recursos . . . . . . . . . . . Requisitos de Software . . . . . . Viso Geral da Instalao . . . . . Instalando em Plataformas de Nvel 2 Instalando no z/OS . . . . . . Definindo Autorizaes no z/OS . . Observaes Adicionais . . . . . Verses de Gateway do z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 141 141 142 142 144 144 149

Captulo 28. A Biblioteca de Mapeamento do Cdigo de Retorno. . 179


O Arquivo de Mapeamento do Cdigo de Retorno 179 180 Mapeamento de Cdigo de Retorno para Psagent e MCMAGENT . . . . . . . . . 180 Nomes dos Arquivos de Mapeamento do Cdigo de Retorno . . . . . . . . . . 184

Captulo 25. Configurao e Operao 151


Arquivos de Opes de Mtodo . . . . . . . Arquivos de Opes de Mtodo em Plataformas de Nvel 2 . . . . . . . . . . . . . Definindo Jobs no z/OS . . . . . . . . . . Definindo Jobs do z/OS no Tivoli Workload Scheduler. . . . . . . . . . . . . . . Sintaxe de Definio de Tarefas para Jobs do z/OS Planejados com o Tivoli Workload Scheduler. . . . . . . . . . . . . . Sintaxe de Definio de Tarefas para Outros Jobs do z/OS . . . . . . . . . . . . Sintaxe de Dependncias de arquivo (OPENS) em arquivos do z/OS . . . . . . . . . 151 151 152 152

Captulo 29. Configurando o Utilitrio de Rastreamento . . . . . . . . . . 185 Captulo 30. Resoluo de Problemas 187

153 154 156

Resolvendo Problemas de Instalao do Mtodo de Acesso do PeopleSoft . . . . . . . . . . . 188

Captulo 31. Arquivos Instalados . . . 189

Parte 7. Apndices . . . . . . . . 193


Avisos . . . . . . . . . . . . . . 195
Marcas . . . . . . . . . . . . . . . 197

Captulo 26. Informaes de Referncia. . . . . . . . . . . . . 157


Viso Geral Tcnica . . . . . . . . Operao com o JES . . . . . . . Operao com o CA-7 . . . . . . Outras Dicas do CA-7 . . . . . . Operao com OPC ou Tivoli Workload Scheduler para z/OS . . . . . . . Verificando Arquivos no z/OS. . . . . . . . . . . . . . . . . . . . 157 157 158 159

Glossrio . . . . . . . . . . . . . 199 ndice Remissivo . . . . . . . . . . 203

. 159 . 161

ndice

vi

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Prefcio
O Guia do Usurio do IBM Tivoli Workload Scheduler para Aplicativos fornece informaes sobre como instalar, configurar e utilizar os mtodos de acesso do IBM Tivoli Workload Scheduler que executam e controlam jobs dos seguintes aplicativos: v Oracle e-Business Suite v PeopleSoft v R/3 v z/OS Este guia inclui e amplia o contedo dos seguintes manuais: v Guia do Usurio do IBM Tivoli Workload Scheduler para Aplicativos Oracle e-Business Suite v Guia do Usurio do IBM Tivoli Workload Scheduler para Aplicativos PeopleSoft v Guia do Usurio do IBM Tivoli Workload Scheduler para Aplicativos R/3 v Guia do Usurio do IBM Tivoli Workload Scheduler para Aplicativos z/OS

verso 8.1.1 para verso 8.1.1 para verso 8.1.1 para verso 8.1.1 para

Quem Deve Ler este Manual


Este manual destinado aos programadores de job que pretendem executar e controlar jobs desses aplicativos com o IBM Tivoli Workload Scheduler. O usurio deste guia deve ter alguns conhecimentos de: v IBM Tivoli Workload Scheduler v Tivoli Job Scheduling Console v O ambiente de aplicativo especfico

O que este Manual Contm


Este manual contm as seguintes sees: Parte 1. Tarefas Comuns de Instalao e Configurao A Parte 1 contm os seguintes captulos: v Captulo 1, Viso Geral do Produto, na pgina 3 descreve o funcionamento bsico de um agente estendido. v Captulo 2, Instalando o IBM Tivoli Workload Scheduler para Aplicativos, na pgina 5 descreve os vrios meios de instalar e desinstalar o produto, junto com as plataformas e os pr-requisitos suportados. v Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 descreve como usar o Editor de Opes. v Captulo 4, Definindo as Estaes de Trabalho de Agente Estendido, na pgina 31

Copyright IBM Corp. 2000, 2003

vii

descreve como definir as estaes de trabalho do agente estendido para todos os mtodos de acesso. v Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37 descreve como definir os jobs de agente estendido para todos os mtodos de acessos. Parte 2. Mtodo de Acesso do Oracle e-Business Suite A Parte 2 contm os seguintes captulos: v Captulo 6, Introduo, na pgina 45 descreve os recursos, os requisitos de software, as tarefas de ps-instalao e o software de interface especfico para o mtodo de acesso do Oracle e-Business Suite. v Captulo 7, Informaes de Definio do Job, na pgina 49 fornece informaes para definir os jobs do Tivoli Workload Scheduler especficos para esse mtodo de acesso. v Captulo 8, Referncia do Arquivo de Opes MCMAGENT, na pgina 53 descreve as opes usadas por esse mtodo de acesso. Parte 3. Mtodo de Acesso do PeopleSoft A Parte 3 contm os seguintes captulos: v Captulo 9, Introduo, na pgina 57 descreve os recursos, as funes e outras informaes gerais sobre o mtodo de acesso do PeopleSoft. v Captulo 10, Planejamento de Implementao, na pgina 61 descreve os requisitos de host e software e outras informaes relevantes para diferenciar as verses do PeopleSoft suportadas por esse mtodo. v Captulo 11, Tarefas de Ps-Instalao, na pgina 65 descreve as tarefas de ps-instalao para esse mtodo de acesso. v Captulo 12, Definindo os Jobs do PeopleSoft, na pgina 77 fornece informaes para definir os jobs do Tivoli Workload Scheduler especficos para esse mtodo de acesso. Parte 4. Mtodo de Acesso do R/3 A Parte 4 contm os seguintes captulos: v Captulo 13, Introduo, na pgina 85 descreve os recursos do mtodo de acesso R/3. v Captulo 14, Instalao, na pgina 87 fornece informaes de instalao especficas para esse mtodo de acesso e descreve a instalao em plataformas de Nvel 2. v Captulo 15, Configurao do R/3, na pgina 91 descreve como configurar esse mtodo de acesso para utiliz-lo com o R/3. v Captulo 16, Definindo Jobs de Agente Estendido do R/3, na pgina 101 fornece informaes para definir os jobs do Tivoli Workload Scheduler especficos para o mtodo de acesso de R/3. v Captulo 17, Executando Jobs Novamente, na pgina 113 descreve o mecanismo para nova execuo de jobs.

viii

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v Captulo 18, Business Information Warehouse, na pgina 115 fornece informaes sobre como utilizar o mtodo de acesso com o R/3 Business Information Warehouse. v Captulo 19, Conectando-se ao Sistema R/3, na pgina 117 v v v v descreve as conexes e os grupos de logon do R/3. Captulo 20, Arquivos de Opes do Mtodo de Acesso do R/3, na pgina 119 descreve as opes usadas por esse mtodo de acesso. Captulo 21, BDC Wait, na pgina 127 fornece detalhes sobre o BDC Wait. Captulo 22, Recursos de Interceptao de Job e Pais-filhos, na pgina 131 descreve a interceptao do job e os recursos Pas-filhos do XBP 2.0. Captulo 23, Suporte Nacional a Idiomas, na pgina 137 descreve o suporte de idioma nacional para esse mtodo de acesso.

Parte 5. Mtodo de Acesso z/OS A Parte 5 contm os seguintes captulos: v Captulo 24, Introduo, na pgina 141 lista os recursos do mtodo de acesso do z/OS; descreve como instalar a parte distribuda em plataformas de nvel 2 e como instalar os componentes de gateway no z/OS. v Captulo 25, Configurao e Operao, na pgina 151 descreve as opes desse mtodo de acesso e fornece informaes especficas do mtodo sobre a definio de job. v Captulo 26, Informaes de Referncia, na pgina 157 fornece informaes de referncia para operaes com os programadores de job suportados e lista as mensagens de gateway. Parte 6. Capacidade de Servios Comuns A Parte 6 contm os seguintes captulos: v Captulo 27, Referncia do Agente Estendido, na pgina 169 fornece informaes de referncia para desenvolver um mtodo de acesso do Tivoli Workload Scheduler. v Captulo 28, A Biblioteca de Mapeamento do Cdigo de Retorno, na pgina 179 descreve como usar o utilitrio de mapeamento do cdigo de retorno. v Captulo 29, Configurando o Utilitrio de Rastreamento, na pgina 185 descreve como configurar o utilitrio de rastreamento. v Captulo 30, Resoluo de Problemas, na pgina 187 fornece algumas informaes gerais sobre soluo de problemas. v Captulo 31, Arquivos Instalados, na pgina 189 lista os arquivos instalados de acordo a plataforma e com o recurso.

Publicaes
Esta seo lista as publicaes na biblioteca do IBM Tivoli Workload Scheduler eTambm descreve como acessar as publicaes Tivoli on-line, como solicitar publicaes Tivoli e como fazer comentrios sobre publicaes Tivoli.
Prefcio

ix

Publicaes do IBM Tivoli Workload Scheduler


Essa seo lista as publicaes na biblioteca do IBM Tivoli Workload Scheduler e documentos listados. Ela tambm descreve como acessar publicaes Tivoli on-line e como solicitar publicaes Tivoli. v IBM Tivoli Workload Scheduler - Guia de Planejamento e Instalao , S517-7780 Descreve como planejar uma rede do Tivoli Workload Scheduler e como instalar e personalizar o Tivoli Workload Scheduler e o software associado. v IBM Tivoli Workload Scheduler - Guia de Referncia, S517-7781 Explica a linha de comandos do Tivoli Workload Scheduler, o entendimento do funcionamento dos agentes estendidos e de rede e a integrao do Tivoli Workload Scheduler com o NetView e com o Tivoli Business Systems Manager. v IBM Tivoli Workload Scheduler - Resoluo de problemas e Mensagens de Erro , S517-7782 Interpreta as mensagens de erro do Tivoli Workload Scheduler e fornece fontes de informaes que ajudaro voc a resolver problemas com o Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler Job Scheduling Console - Notas sobre o Release, S517-7779 Fornece informaes sobre como trabalhar com o Tivoli Workload Scheduler, independentemente da plataforma, a partir de uma GUI comum. v IBM Tivoli Workload Scheduler Job Scheduling Console - Guia do Usurio, S517-7778 Fornece informaes sobre como trabalhar com o Tivoli Workload Scheduler, independentemente da plataforma, a partir de uma GUI comum. v IBM Tivoli Workload Scheduler para Notas sobre o Release de Aplicativos, S517-7786 Fornece as ltimas informaes sobre os agentes estendidos do Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler AS/400 Limited Fault-tolerant Agent Users Guide, SC32-1280 Descreve a instalao, configurao e utilizao dos agentes tolerantes a falhas do Tivoli Workload Scheduler no AS/400. v IBM Tivoli Workload Scheduler Plus Module - Guia do Usurio, S517-7783 Explica a configurao e utilizao do Plus Module do Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler - Notas Sobre o Release, S517-7784 Explica as ltimas informaes sobre o Tivoli Workload Scheduler.

Publicaes do IBM Tivoli Workload Scheduler para z/OS


Os seguintes documentos esto disponveis na biblioteca do IBM Tivoli Workload Scheduler para z/OS: v IBM Tivoli Workload Scheduler para z/OS Customization and Tuning , SC32-1265 Descreve como personalizar o Tivoli Workload Scheduler para z/OS. v IBM Tivoli Workload Scheduler para z/OS Diagnosis Guide and Reference, SC32-1261 Fornece informaes que ajudam a diagnosticar e corrigir possveis problemas ao utilizar o produto. v IBM Tivoli Workload Scheduler para z/OS General Information, SC32-1256 Descreve os benefcios de todo o conjunto do Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler para z/OS Getting Started, SC32-1262

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Descreve os conceitos e a terminologia do IBM Tivoli Workload Scheduler para z/OS e fornece instrues para que voc trabalhe com o produto assim que possvel. v IBM Tivoli Workload Scheduler para z/OS Installation Guide, SC32-1264 Explica como instalar o Tivoli Workload Scheduler para z/OS. v IBM Tivoli Workload Scheduler para z/OS Licensed Program Specifications, GI11-4208 Fornece informaes de planejamento sobre o Tivoli Workload Scheduler para z/OS. v IBM Tivoli Workload Scheduler para z/OS Managing the Workload, SC32-1263 Explica como planejar e programar a carga de trabalho e como controlar e monitorar o plano atual. v IBM Tivoli Workload Scheduler para z/OS Memo to Users, GI11-4209 Fornece um resumo das alteraes do release atual do produto. v IBM Tivoli Workload Scheduler para z/OS Messages and Codes, SC32-1267 Explica mensagens e cdigos. v IBM Tivoli Workload Scheduler para z/OS Program Directory, GI11-4203 Fornecido com a fita de instalao do Tivoli Workload Scheduler para z/OS, descreve todos os materiais de instalao e fornece instrues de instalao especficas para o nvel do release do produto e nmero do recurso. v IBM Tivoli Workload Scheduler para z/OS Programming Interfaces, SC32-1266 Fornece informaes para desenvolver programas de aplicativos. v IBM Tivoli Workload Scheduler para z/OS Quick Reference, SC32-1268 Fornece uma referncia de consulta fcil e rpida para operar o produto.

Kit de Coleo de Cpia Eletrnica para o IBM Tivoli Workload Scheduler para z/OS
Todos os manuais na biblioteca, exceto as publicaes licenciadas, esto disponveis no formato de cpia eletrnica apresentvel nos seguintes kits de coleo: v IBM Online Library Omnibus Edition OS/390 Collection Kit, SK2T-6700. v IBM Online Library z/OS Software Products Collection Kit, SK2T-4270. Voc pode ler os manuais em cpia eletrnica em CD-ROMs utilizando estes programas IBM licenciados: v Leitora de Cpia Eletrnica v BookManager READ/2 v BookManager READ/DOS v BookManager READ/6000 Todos os programas BookManager precisam de um computador pessoal equipado com uma unidade de disco de CD-ROM (capaz de ler discos formatados no padro ISO 9660), alm de uma placa e cabo correspondentes. Para obter informaes adicionais sobre hardware e software, consulte a documentao do produto BookManager especfico que voc est utilizando. As atualizaes de manuais entre os releases so fornecidas apenas em cpia eletrnica.

Prefcio

xi

Publicaes listadas
O Tivoli Software Glossary inclui definies para muitos termos tcnicos listados ao software Tivoli. O Tivoli Software Glossary est disponvel, somente em ingls, no seguinte Web site: http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

Acessando Publicaes On-line


O CD de documentao contm as publicaes que esto na biblioteca do produto. O formato das publicaes PDF e/ou HTML. Para acessar as publicaes utilizando um navegador da Web, abra o arquivo infocenter.html. O arquivo encontra-se no diretrio de publicaes apropriado no CD do produto. A IBM lana publicaes para este e todos os outros produtos Tivoli, assim que se tornam disponveis e sempre que so atualizados, no site do Tivoli Software Information Center na Web. O Tivoli Software Information Center est localizado no seguinte endereo da Web: http://publib.boulder.ibm.com/tividd/td/tdprodlist.html Clique no link do Tivoli Workload Scheduler para acessar a biblioteca de produtos. Nota: Se voc imprimir documentos PDF em papel que no seja tamanho carta, selecione a caixa de opes Ajustar pgina na janela Impresso do Adobe Acrobat. Essa opo fica disponvel quando voc clica em Arquivo Imprimir. Ajustar pgina garante que as dimenses totais de uma pgina tamanho carta sejam impressas no papel que voc est utilizando.

Solicitando Publicaes
possvel solicitar vrias publicaes on-line da Tivoli neste Web site:
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

Voc tambm pode solicitar por telefone ligando para um destes nmeros: v No Brasil: 0800-7873-78 v No Canad: 800-426-4968 Em outros pases, consulte o seguinte Web site para obter uma lista de nmeros de telefones: http://www.ibm.com/software/tivoli/order-lit/

Fornecendo Feedback sobre as Publicaes


Se voc tiver comentrios ou sugestes sobre os produtos e a documentao Tivoli, preencha a pesquisa de feedback do cliente no seguinte Web site: http://www.ibm.com/software/sysmgmt/products/support

xii

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Acessibilidade
Os recursos de acessibilidade ajudam usurios com deficincias fsicas, como mobilidade restrita ou viso limitada, a usar os produtos de software com xito. Com este produto, possvel utilizar tecnologias assistidas para ouvir e navegar na interface. Voc pode tambm utilizar o teclado em vez do mouse para operar todos os recursos da interface grfica com o usurio. Para obter informaes adicionais, consulte o Apndice Acessibilidade no Guia do Usurio do Console de Programao do Job do IBM Tivoli Workload Scheduler.

Entrando em Contato com o IBM Software Support


Se voc tiver algum problema com qualquer produto Tivoli, entre em contato com o IBM Software Support. Consulte o IBM Software Support Guide no seguinte Web site: http://techsupport.services.ibm.com/guides/handbook.html A documentao fornece informaes sobre como entrar em contato com o IBM Software Support, dependendo da gravidade do seu problema e das seguintes informaes: v Registro e elegibilidade v Nmeros de telefone e endereos de e-mail, dependendo do pas no qual voc est localizado; v Informaes que voc deve ter antes de entrar em contato com o IBM Software Support

Convenes Utilizadas neste Manual


Este manual utiliza diversas convenes para termos e aes especiais, comandos e caminhos dependentes do sistema operacional.

Convenes de Tipo de Caractere


Este manual usa as seguintes convenes tipogrficas: Negrito v Comandos em letras minsculas ou em letras maisculas e minsculas (exceto aqueles com todas as letras maisculas) que so difceis de distinguir do texto ao redor. v Controles de interface (caixas de opes, botes de comando, botes de opes, botes de giro, campos, pastas, cones, quadros de listagem, itens dentro de quadros de listagem, listas com vrias colunas, contineres, opes de menu, nomes de menu, guias, folhas de propriedade), rtulos (como Dica: e Consideraes sobre o sistema operacional:) v Ttulos de coluna em uma tabela v Palavras-chave e parmetros em um texto Os comandos (exceto os em letras maisculas) so exibidos em fonte negrito. Itlico v Citaes (ttulos de manuais, disquetes e CDs)
Prefcio

xiii

v v v v v

Palavras definidas no texto nfase de palavras (palavras como palavras) Letras como letras Novos termos no texto (exceto em uma lista de definies) Variveis e valores que voc deve fornecer

Espaamento Fixo v Exemplos, exemplos de cdigo e sada v Nomes de arquivos, palavras-chave de programao e outros elementos que so difceis de serem distinguidos do texto ao redor v Texto de mensagem e prompts dirigidos ao usurio v Texto que o usurio deve digitar v Valores para argumentos ou opes de comando Os exemplos de cdigo, sada, texto que voc deve digitar e mensagens do sistema so exibidos em espaamento fixo. barras de reviso Alteraes tcnicas no texto so indicadas por uma linha vertical esquerda da alterao.

Variveis e Caminhos que Dependem do Sistema Operacional


Este manual utiliza a conveno UNIX para especificar variveis de ambiente e para notao de diretrio. Ao utilizar a linha de comandos Windows, substitua $varivel por % varivel% para variveis de ambiente e substitua cada barra (/) por uma barra invertida ( \) nos caminhos de diretrio. Nota: Se voc estiver utilizando o bash shell em um sistema Windows, ser possvel utilizar as convenes UNIX.

xiv

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 1. Tarefas Comuns de Instalao e Configurao

Copyright IBM Corp. 2000, 2003

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 1. Viso Geral do Produto


Os XA (agentes estendidos) so utilizados para estender as funes de planejamento do job do IBM Tivoli Workload Scheduler para outros sistemas e aplicativos. Um agente estendido definido como uma estao de trabalho que tem um host e um mtodo de acesso. O host um FTA (agente tolerante a falhas) do Tivoli Workload Scheduler ou um SA (agente padro). O mtodo de acesso um programa executado pela estao de trabalho de host sempre que o Tivoli Workload Scheduler, por meio da linha de comando ou pelo Tivoli Job Scheduling Console, precisa interagir com o sistema externo. O Tivoli Workload Scheduler para Aplicativos inclui os seguintes mtodos de acesso: v Mtodo de acesso do Oracle e-Business Suite (MCMAGENT) v Mtodo de acesso do PeopleSoft (psagent) v Mtodo de acesso do R/3 (r3batch) v Mtodo de acesso do z/OS (mvsca7, mvsjes e mvsopc) Para ativar e monitorar um job em um agente estendido, o host executa o mtodo de acesso, transmitindo os detalhes do job como opes da linha de comando. O mtodo de acesso comunica-se com o sistema externo para ativar o job e retornar o status do job. Uma estao de trabalho de agente externo apenas uma entidade lgica listada ao mtodo de acesso hospedado pela estao de trabalho fsica do Tivoli Workload Scheduler. Mais de uma estao de trabalho de agente estendido pode ser hospedada pela mesma estao de trabalho do Tivoli Workload Scheduler e contar com o mesmo mtodo de acesso. O x-agent definido em uma definio de estao de trabalho padro do Tivoli Workload Scheduler, que fornece ao x-agent um nome e identifica o mtodo de acesso. A prxima figura mostra como esses elementos se ajustam no caso de uma configurao de agente estendido normal.

Copyright IBM Corp. 2000, 2003

Figura 1. Como os Agentes Estendidos Funcionam.

Para ativar um job em um ambiente externo, o Tivoli Workload Scheduler executa o mtodo de acesso de agente estendido fornecendo um nome de estao de trabalho de agente estendido e informaes sobre o job. O mtodo observa o arquivo de correspondncia chamado <WORKSTATION_NAME>_ <nome_do_mtodo>.opts para determinar a qual instncia do ambiente externo ele ir se conectar. O mtodo de acesso pode ativar jobs nessa instncia e monitor-los por meio da concluso do processo de gravao do job e das informaes de status no arquivo de lista padro do job. Os agentes estendidos podem ser usados para executar jobs em ambientes ponto a ponto, em que o planejamento e a monitorao so executados a partir de um controlador do IBM Tivoli Workload Scheduler para z/OS.

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos


Nas plataformas mais suportadas, todos os mtodos de acesso do IBM Tivoli Workload Scheduler para Aplicativos descritos neste guia so instalados por meio de um processo de instalao comum. Seguindo esse processo, voc instala um instncia do Tivoli Workload Scheduler para Aplicativos -em que a instncia corresponde ao adio de pelo menos um mtodo de acesso instalao do Tivoli Workload Scheduler existente - e seleciona um ou mais mtodos de acesso a partir dos recursos de instalao. O processo de instalao comum est disponvel para as seguintes plataformas, quando suportado por um mtodo de acesso: v Microsoft Windows NT ou 2000 v IBM AIX v HP-UX v Ambiente Operacional Sun v Linux para Intel v Linux/390 Para as seguintes plataformas, o processo de instalao permanece como descrito na documentao de mtodos individuais, no prximo captulo: v Compaq Tru64 v SGI Irix v IBM Sequent Dynix A tabela a seguir lista quais plataformas so suportadas por essa verso do IBM Tivoli Workload Scheduler para Aplicativos:
Tabela 1. Plataformas Suportadas Mtodo de Acesso Plataforma z/OS (Gateway) X X X X X X X X X z/OS (Servidor de transao) R/3 PeopleSoft Oracle eBusiness Suite

IBM OS/390 V2R10 e superior IBM z/OS V1R1 e superior IBM AIX verses 4.3.3, 5.1, 5.2 IBM Sequent Dynix verses 4.5.1 Solaris Operating Environment Verses 7, 8, 9 Hewlett Packard PA-RISC Verses 11.0, 11i

Copyright IBM Corp. 2000, 2003

Tabela 1. Plataformas Suportadas (continuao) Mtodo de Acesso Plataforma z/OS (Gateway) z/OS (Servidor de transao) X R/3 PeopleSoft Oracle eBusiness Suite

SuSE Linux Enterprise Server verso 7 para OS/390 e zSeries (kernel 2.4) RedHat Linux para OS/390 e zSeries verso 7 RedHat Linux (Intel) verses 7.2, 7.3 SuSE Linux (Intel) Enterprise Server verso 8 Microsoft Windows NT verso 4.0 com Service Pack 6a Microsoft Windows 2000 com Service Pack 3 Professional, Server, Advanced Compaq Tru64 Verso 5.1 SGI Irix verso 6.5.x

X X

X X

Como Instalar
Voc pode escolher dentre trs modos alternativos para instalar o Tivoli Workload Scheduler para Aplicativos: v Usando o assistente ISMP (InstallShield Multi-Platform) v Executando a opo de instalao silenciosa do InstallShield v Usando o componente de Distribuio de Software do Tivoli Configuration Manager Antes de instalar o produto utilizando um desses mtodos, verifique se as condies a seguir so atendidas: v Voc deve ter uma instalao vlida do IBM Tivoli Workload Scheduler verso 7.0 ou superior no computador antes de instalar qualquer um dos mtodos de acesso. v Voc deve ter direitos de raiz (Unix) ou de Administrador (Windows) para executar a instalao. v Voc deve parar todos os servios do Tivoli Workload Scheduler antes de iniciar o processo de instalao. v Para o mtodo de acesso do PeopleSoft: a instalao desse mtodo requer que o ambiente PeopleSoft correspondente j esteja instalado e totalmente acessvel a partir da estao de trabalho em que ocorrer a instalao.

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v Para o mtodo de acesso do Oracle eBusiness Suite: O servidor Oracle e-Business Suite exigido no mesmo n fsico que o mtodo de acesso e o host do Tivoli Workload Scheduler. v Certifique-se de que o processo de instalao no esteja em execuo na estao de trabalho. Esse cenrio pode existir em uma rede em que mais conexes telnet sejam abertas no mesmo computador Unix por usurios autorizados para que possam orientar remotamente a instalao de um mtodo de acesso. Execute o comando a seguir para verificar se o processo de instalao j est ativo no computador em que desejar fazer a instalao:
ps -ef | grep setup.bin

Pelo mesmo sinal, se sua estao de trabalho executar mais instncias do Tivoli Workload Scheduler, restrinja a execuo do processo de instalao para somente uma instncia por vez. v Antes de instalar instncias adicionais do produto ou de atualizar instncias existentes, verifique se o Editor de Opo no est em execuo, ou poder haver falha na instalao. Consulte Captulo 31, Arquivos Instalados, na pgina 189 para obter uma lista de arquivos que voc deve encontrar no computador aps a instalao.

Utilizando o Assistente de Instalao


Para utilizar o assistente de instalao do ISMP no computador, seu sistema operacional deve ser capaz de executar Java Runtime Environment (JRE) verso 1.3.1. Algumas plataformas requerem nveis de manuteno para que suportem o JRE 1.3.1. Consulte a tabela a seguir para saber se o sistema operacional deve ser corrigido ou no. Para as plataformas suportadas no includas nessa tabela, nenhuma correo adicional necessria.
Tabela 2. Correes Requeridas para Executar o JRE 1.3.1 Sistema Operacional IBM AIX Verso 4.3.3 IBM AIX Verso 5.1 Correo Requerida para Executar o JRE 1.3.1 AIX 433010 - Nvel de Manuteno Recomendado. AIX 510002 - Nvel de Manuteno Recomendado. Requer que APAR IY19375 seja anteriormente aplicado e consolidado. Se voc estiver utilizando um dos locales CKJ no UTF8 suportados, um dos seguintes conjuntos de arquivos (disponveis no CD base do AIX 5.1) ser necessrio: v X11.fnt.ucs.ttf (para ja_JP ou Ja_JP) v X11.fnt.ucs.ttf_CN (para zh_CN ou Zh_CN) v X11.fnt.ucs.ttf_KR (para ko_KR) v X11.fnt.ucs.ttf_TW (para zh_TW ou Zh_TW) Para usurios japoneses: se voc estiver utilizando o Mtodo de Entrada Japons, deve aplicar os seguintes PTFs para evitar alguns problemas listados ao Mtodo de Entrada. v jkit.Wnn6.base 2.2.0.2 (PTF U479697 ou APAR IY22917) (apenas usurios Wnn6) v X11.motif.lib 5.1.0.15 (PTF U479604 ou APAR IY22933) (apenas usurios AIX 5.1) Solaris Operating Environment Verses 7, 8, 9 Clusters de Correo datados de janeiro de 2002 ou posterior.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

Tabela 2. Correes Requeridas para Executar o JRE 1.3.1 (continuao) Sistema Operacional Hewlett Packard PA-RISC Verses 11.0, 11i Correo Requerida para Executar o JRE 1.3.1 As correes do sistema operacional devem estar instaladas antes que voc instale o produto. Para determinar quais correes foram instaladas em seu computador, efetue login como raiz e execute: /usr/sbin/swlist -l product Para suportar JRE 1.3.1.05, voc deve ter: v Para HP-UX 11.0, Quality Pack QPK1100 v Para HP-UX 11i, Quality Pack GOLDQPK11i

Para instalar um ou mais mtodos de acesso do Tivoli Workload Scheduler para Aplicativos no seu computador, execute os seguintes procedimentos: 1. Pare todos os servios do Tivoli Workload Scheduler. 2. A partir do CD do produto ou de uma imagem, execute o comando de instalao. Ele pode ser: v setup.bin no Unix v setup.exe no Windows A janela Bem-vindo exibida.

Figura 2. Janela Bem-vindo.

3.

Clique em Next para continuar. A janela Acordo de Licena do Software exibida.

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 3. Janela Acordo de Licena do Software.

4. Selecione o boto de opes para aceitar o acordo e clique em Next para continuar. A janela Escolher o Tipo de Instalao exibida.

Figura 4. Janela Escolher o Tipo de Instalao

5.

Escolha se voc est executando uma nova instalao do Tivoli Workload Scheduler para Aplicativos ou se est atualizando uma instalao existente. Se voc estiver instalando um mtodo de acesso adicional, selecione Update an instance. v Se voc escolher Create a new instance, o programa de instalao detectar e listar todas as instalaes do Tivoli Workload Scheduler no seu computador.
Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

v Se voc escolher Update an instance, o programa de instalao detectar e listar todas as instalaes do Tivoli Workload Scheduler para Aplicativos no seu computador. Clique em Next para continuar. Se voc selecionar Create a new instance uma janela similar Figura 5 ser exibida.

Figura 5. Janela Instncias Instaladas do Tivoli Workload Scheduler.

O programa de instalao pesquisa o sistema e lista todas as instncias do Tivoli Workload Scheduler existentes. Notas: a. Se o processo de descoberta no encontrar as instncias existentes, uma janela ser exibida no local em que voc poder inserir o caminho de instalao e o nome de uma instncia. b. Se voc estiver no Unix e tiver vrias instalaes do Tivoli Workload Scheduler verses 7.0 ou 8.1, que no foram instaladas adequadamente no diretrio inicial /home/TWSuser, a janela listar, aleatoriamente, somente uma das instncias e um dos nomes <desconhecido>. Dessas instncias, essa ser a nica que voc poder marcar para instalao. Consulte Tabela 24 na pgina 187 para obter detalhes. Se voc selecionar Update an instance, uma janela semelhante a Figura 6 na pgina 11 ser exibida.

10

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 6. Janela Instncias Instaladas do Tivoli Workload Scheduler para Aplicativos.

O programa de instalao pesquisa o sistema e lista todas as instncias do Tivoli Workload Scheduler para Aplicativos existentes. 6. Selecione uma ou mais instncias e clique em Next para continuar. Uma janela que lista todos os mtodos de acesso fornecidos com o Tivoli Workload Scheduler para Aplicativos exibida. A lista varia de acordo com a plataforma na qual voc est executando a instalao: as instalaes no Unix no listam o mtodo de acesso para o PeopleSoft, enquanto as instalaes no Windows no listam o mtodo de acesso para o Oracle. Este exemplo para uma instalao no Windows.

Figura 7. A Janela Selecionar os Recursos do Tivoli Workload Scheduler para Aplicativos no MS Windows.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

11

Este exemplo para uma instalao no Unix.

Figura 8. A Janela Selecionar os Recursos do Tivoli Workload Scheduler para Aplicativos no Unix.

7. Selecione o mtodo de acesso ou mtodos que deseja instalar no seu computador e clique em Next para continuar. Dependendo da quantidade e de quais mtodos de acesso voc selecionou, uma ou mais janelas adicionais exigiro informaes especficas para o mtodo de acesso. Isso pode ser: v Para todos os mtodos de acesso: o nome do usurio do Tivoli Workload Scheduler que estar executando o mtodo selecionado. Ele pode ter o mesmo nome definido quando o Tivoli Workload Scheduler foi instalado. v Para o mtodo de acesso do PeopleSoft: a verso do ambiente PeopleTools e um dos seguintes itens: Para o PeopleSoft verso 7.0x ou 7.5x, o caminho do diretrio de tempo de execuo COBOL (normalmente <PS_HOME>\cblbin). Para o PeopleSoft verso 8.1x, o caminho para o PeopleSoft External APIs (normalmente <EXT_API_DIR>\bin\client\winx86_extapi). Para o PeopleSoft verso 8.4x, o caminho para o diretrio cliente do PeopleSoft (normalmente <PS_HOME>\bin\client\winx86). Essa a janela para o Mtodo de Acesso do R/3.

12

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 9. Janela Informaes Adicionais do Usurio para o Mtodo de Acesso do R/3.

Essa a primeira janela para o Mtodo de Acesso do PeopleSoft.

Figura 10. Primeira janela Informaes Adicionais do Usurio para o Mtodo de Acesso do PeopleSoft.

Essa a segunda janela para o Mtodo de Acesso do PeopleSoft.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

13

Figura 11. Segunda janela Informaes Adicionais do Usurio para o Mtodo de Acesso do PeopleSoft.

Essa a janela para o Mtodo de Acesso do z/OS.

Figura 12. Janela Informaes Adicionais do Usurio para o Mtodo de Acesso do z/OS.

8.

Insira as informaes necessrias e clique em Next para continuar. Uma janela de informaes de resumo exibida. A Figura 13 na pgina 15 mostra um exemplo de informaes de resumo para a instalao do mtodo de acesso para o R/3.

14

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 13. Janela Resumo da Instalao.

9. Clique em Next para continuar. O processo de instalao comea a instalar os mtodos de acesso selecionados no computador. Uma janela mostrando o andamento da instalao exibida.

Figura 14. A Janela Andamento da Instalao.

Quando a instalao estiver concluda, a seguinte janela ser exibida, perguntando se deseja executar o Editor de Opes. Esse um editor de arquivos baseado em Java que permite definir opes para os mtodos de acesso instalados. Se voc optar por no executar o Editor de Opes agora, ser possvel faz-lo a qualquer momento.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

15

Figura 15. Janela Ativao do Editor de Opes

10.

Clique no boto de opes apropriado se desejar executar o Editor de Opes imediatamente ou no e selecione Next para continuar. Se voc clicar em Yes, o Editor de Opes ser exibido e voc poder definir as opes para os mtodos instalados. Consulte Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 para aprender como utilizar o Editor de Opes. Ao terminar de usar o Editor de Opes, ou se tiver selecionado No na janela anterior, a janela de sada da instalao ser exibida.

Figura 16. A janela Sada do Assistente de Instalao.

11. Selecione Finish para sair do assistente de instalao.

16

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

O log de instalao chamado TWS4APPS.LOG salvo no diretrio maestro.

Utilizando a Instalao Silenciosa


Esse mtodo fornece a opo para instalar o produto sem a utilizao do assistente de instalao do ISMP. Para instalar, utilizando esse mtodo, prepare um arquivo de opes com antecedncia e especifique seu nome com o comando de instalao. A utilizao do mtodo de instalao silenciosa permite instalar todos os mtodos de acesso simultaneamente. O log de instalao chamado TWS4APPS.LOG salvo no diretrio maestro. Formato: Para instalar o Tivoli Workload Scheduler para Aplicativos com o mtodo silencioso, utilize o seguinte comando: v No Windows
setup.exe -silent -options nome_e_caminho_do_arquivo_de_opes

v No Unix
setup.bin -silent -options nome_e_caminho_do_arquivo_de_opes

Parmetros: -silent Especifica que a instalao no direcionada por uma interface do usurio mas por um arquivo de opes. -options nome_e_caminho_do_arquivo_de_opes Fornece o caminho e o nome do arquivo que contm as opes de instalao. O arquivo de opes pode ser qualquer arquivo de texto com o nome e a extenso escolhida. As opes esto escritas individualmente por linha. Um gabarito para executar uma instalao silenciosa fornecido com o produto. O gabarito chamado silent.txt e est disponvel no diretrio RESPONSE_FILE no CD-ROM do produto. A tabela a seguir lista as opes que voc pode utilizar para orientar a instalao:
Tabela 3. Opes Necessrias para Instalao Silenciosa. Opo -P TWS4APPS.installLocation Descrio O caminho no qual deseja instalar o Tivoli Workload Scheduler para Aplicativos. Essa opo obrigatria. Um nome para essa instncia do Tivoli Workload Scheduler para Aplicativos. Essa opo obrigatria. Especifica que o mtodo e acesso para o Oracle eBusiness Suite vai ser instalado. Valor Um caminho absoluto.

-P TWS4APPS.name

Um nome. Colocar entre aspas duplas se o nome tiver espao em branco.

-P MCMAGENT_FEATURE.active

Verdadeiro ou Falso.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

17

Tabela 3. Opes Necessrias para Instalao Silenciosa. (continuao) Opo -W LJUSER_MCMAGENT_INPUT_BEAN.LJUSER Descrio O nome do usurio do Tivoli Workload Scheduler que vai executar o mtodo de acesso para o Oracle eBusiness Suite. Essa opo obrigatria se voc estiver instalando esse mtodo. Especifica que o mtodo de acesso para R/3 vai ser instalado. O nome do usurio do Tivoli Workload Scheduler que vai executar o mtodo de acesso para R/3. Essa opo obrigatria se voc estiver instalando esse mtodo. Especifica que o mtodo de acesso para z/OS vai ser instalado. O nome do usurio do Tivoli Workload Scheduler que vai executar o mtodo de acesso para o z/OS. Essa opo obrigatria se voc estiver instalando esse mtodo. Valor Um nome de usurio do Tivoli Workload Scheduler. Colocar entre aspas duplas se o nome tiver espao em branco.

-P R3BATCH_FEATURE.active

Verdadeiro ou Falso.

-W LJUSER_R3BATCH_INPUT_BEAN.LJUSER

Um nome de usurio do Tivoli Workload Scheduler. Colocar entre aspas duplas se o nome tiver espao em branco.

-P ZOSAGENT_FEATURE.active

Verdadeiro ou Falso.

-W LJUSER_ZOSAGENT_INPUT_BEAN.LJUSER

Um nome de usurio do Tivoli Workload Scheduler. Colocar entre aspas duplas se o nome tiver espao em branco.

-P PSAGENT_FEATURE.active

Especifica que o mtodo de Verdadeiro ou Falso. acesso para o PeopleSoft vai ser instalado. O nome do usurio do Tivoli Workload Scheduler que vai executar o mtodo de acesso para o PeopleSoft. Essa opo obrigatria se voc estiver instalando esse mtodo. Um nome de usurio do Tivoli Workload Scheduler. Colocar entre aspas duplas se o nome tiver espao em branco.

-W LJUSER_PSAGENT_INPUT_BEAN.LJUSER

18

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 3. Opes Necessrias para Instalao Silenciosa. (continuao) Opo Descrio Valor Ele pode ser um ou mais dos seguintes itens: PS70MR2 PeopleTools 7.0x e Merant NetExpress 2.x PS70MR3 PeopleTools 7.0x e Merant NetExpress 3.x PS70WB4 PeopleTools 7.0x e MF COBOL Workbench 4.x PS75MR2 PeopleTools 7.5x e Merant NetExpress 2.x PS75MR3 PeopleTools 7.5x e Merant NetExpress 3.x PS81 PS84 PeopleTools 8.1x PeopleTools 8.4x

-W LJUSER_PSAGENT_INPUT_BEAN.BEND_TYPE Especifica a verso do ambiente PeopleTools. Essa opo obrigatria se voc estiver instalando esse mtodo.

Vrias entradas devem ser separadas por ponto-e-vrgula. -W PS70MR2_CBLDIR.DIRNAME O caminho do diretrio COBOL para PeopleTools 7.0x e Merant NetExpress 2.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.0x e Merant NetExpress 3.x. Utilize somente se voc especificou esse ambiente. O caminho completo para esse diretrio, normalmente <PS_HOME>\cblbin.

-W PS70MR3_CBLDIR.DIRNAME

O caminho completo para esse diretrio, normalmente <PS_HOME>\cblbin.

-W PS70WB4_CBLDIR.DIRNAME

O caminho do diretrio O caminho completo para esse COBOL para PeopleTools diretrio, normalmente 7.0x e MF COBOL <PS_HOME>\cblbin. Workbench 4.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.5x e Merant NetExpress 2.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.5x e Merant NetExpress 3.x. Utilize somente se voc especificou esse ambiente. O caminho completo para esse diretrio, normalmente <PS_HOME>\cblbin.

-W PS75MR2_CBLDIR.DIRNAME

-W PS75MR3_CBLDIR.DIRNAME

O caminho completo para esse diretrio, normalmente <PS_HOME>\cblbin.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

19

Tabela 3. Opes Necessrias para Instalao Silenciosa. (continuao) Opo -W PS81_APIDIR.DIRNAME Descrio O caminho do diretrio do External APIs para PeopleTools 8.1x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio cliente do PeopleSoft para PeopleTools 8.4x. Utilize somente se voc especificou esse ambiente. Valor O caminho completo para esse diretrio, normalmente <EXT_API_DIR>\bin\client\ winx86_extapi. O caminho completo para esse diretrio, normalmente <PS_HOME>\bin\client\ winx86.

-W PS84_APIDIR.DIRNAME

Exemplos: O seguinte exemplo utiliza um arquivo de opes chamado silent_options.txt para instalar silenciosamente o Tivoli Workload Scheduler para Aplicativos em um computador com o Windows:
setup.exe silent options c:\tmp\silent_options.txt

O seguinte exemplo utiliza um arquivo de opes chamado silent_options.txt para instalar silenciosamente o Tivoli Workload Scheduler para Aplicativos em um computador com o Unix semX-Server disponvel:
setup.bin silent options /tmp/silent_options.txt

O seguinte exemplo um arquivo de opes utilizado para orientar a instalao do Tivoli Workload Scheduler para Aplicativos em um computador com Windows. Os mtodos de acesso para R/3 e para PeopleSoft so definidos como recursos de instalao.
# LOCALIZAO DA INSTALAO e NOME DA INSTNCIA -P TWS4APPS.installLocation=C:\win32app\maestro -P TWS4APPS.name=SILENT # DEFINIES DE R3BATCH -P R3BATCH_FEATURE.active=true -W LJUSER_R3BATCH_INPUT_BEAN.LJUSER=twsuser # DEFINIES DE PSAGENT -P PSAGENT_FEATURE.active=true -W LJUSER_PSAGENT_INPUT_BEAN.LJUSER=tws -W LJUSER_PSAGENT_INPUT_BEAN.BEND_TYPE=PS70MR2;PS75MR3 -W PS70MR2_CBLDIR.DIRNAME=M:\PSDIRS\PS70Merant2 -W PS75MR3_CBLDIR.DIRNAME=N:\PSDIRS\PS75Merant3

Utilizando o Tivoli Configuration Manager


Cada mtodo de acesso pode ser instalado por meio da distribuio de um SPB (bloco de pacote de software), utilizando o Tivoli Desktop ou o comando winstsp do componente de Distribuio de Software do IBM Tivoli Configuration Manager, verso 4.2. A distribuio e a instalao do Blocos de Pacote de Software podem ser executadas por meio de computadores que estejam executando o Tivoli Management Framework. Implementar o Tivoli Workload Scheduler para Aplicativos por meio desse formato de pacote fornece o seguinte conjunto de benefcios: v Implementao no apenas de arquivo e diretrios, mas tambm de elementos do ambiente, tais como INI, registros, cones e mais. v DESFAZER versus REMOVER para cada um dos elementos incorporados acima no pacote de software.

20

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v Utilizao de variveis (incorporadas, com destino especfico ou predefinido) no pacote. v Utilizao de condies no pacote de software por meio de sees especficas para plataformas especficas. v Utilizao ilimitada de programas de usurio genricos, para diferentes fases de execuo e gerenciamento personalizado dos cdigos de retorno do programa. v Reinicializao ou reincio de ns de extremidade durante a execuo de aes SP. Com esse mtodo voc pode instalar somente um mtodo de acesso por bloco de pacote de software. Se voc utilizar vrios SPBs para instalar mais mtodos de acesso, tenha cuidado ao usar nomes diferentes para os pacotes. Se voc optar por orientar o processo de instalao a partir do Tivoli Desktop e o seu mecanismo do Tivoli Workload Scheduler na estao de trabalho de destino for a verso 8.2, certifique-se de que saiba o nome do diretrio de instalao do mecanismo antes de iniciar. Para ser instalado por meio da distribuio de software, todos os SPBs do Tivoli Workload Scheduler para Aplicativos exigem as seguintes opes:
Tabela 4. Opes Exigidas para Instalar Todos os SPBs do Tivoli Workload Scheduler para Aplicativos por meio da Distribuio de Software. Opo INSTALL_DIR LJUSER Descrio O caminho para o diretrio maestro (que contm os mtodos) O nome do usurio do Tivoli Workload Scheduler que vai executar o mtodo de acesso.

De forma adicional, o SPB para o mtodo de acesso do PeopleSoft exige as seguintes opes:
Tabela 5. Opes adicionais exigidas para instalar o mtodo de acesso para o PeopleSoft SPB por meio da Distribuio de Software. Opo INSTALL_BEND Descrio Especifica a verso do ambiente PeopleTools. Ele pode ser um ou mais dos seguintes itens: PS70MR2 PeopleTools 7.0x e Merant NetExpress 2.x PS70MR3 PeopleTools 7.0x e Merant NetExpress 3.x PS70WB4 PeopleTools 7.0x e MF COBOL Workbench 4.x PS75MR2 PeopleTools 7.5x e Merant NetExpress 2.x PS75MR3 PeopleTools 7.5x e Merant NetExpress 3.x PS81 PS84 PeopleTools 8.1x PeopleTools 8.4x

Vrias entradas devem ser separadas por ponto-e-vrgula.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

21

Tabela 5. Opes adicionais exigidas para instalar o mtodo de acesso para o PeopleSoft SPB por meio da Distribuio de Software. (continuao) Opo PS70MR2_CBLDIR Descrio O caminho do diretrio COBOL para PeopleTools 7.0x e Merant NetExpress 2.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.0x e Merant NetExpress 3.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.0x e MF COBOL Workbench 4.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.5x e Merant NetExpress 2.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio COBOL para PeopleTools 7.5x e Merant NetExpress 3.x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio do External APIs para PeopleTools 8.1x. Utilize somente se voc especificou esse ambiente. O caminho do diretrio cliente do PeopleSoftpara PeopleTools 8.4x. Utilize somente se voc especificou esse ambiente.

PS70MR3_CBLDIR

PS70WB4_CBLDIR

PS75MR2_CBLDIR

PS75MR3_CBLDIR

PS81_APIDIR PS84_APIDIR

O produto inclui tambm um SPB contendo Java Virtual Machine. Isso til para instalar o Editor de opes com esse mtodo. Esteja ciente, contudo, de que essa Java Virtual Machine no pode substituir a Java Virtual Machine exigida para a execuo do produto PeopleSoft. Para instalar um pacote de software, voc deve executar as seguintes aes utilizando a linha de comandos ou o Tivoli Desktop: 1. Importe o SPB para um Perfil de Pacote de Software. Faa isso para o SPBs: v Dos mtodos de acesso que deseja instalar v Da JVM (Java Virtual Machine) v Do Editor de Opes (para execuo, necessrio que os outros dois SPBs j estejam instalados) 2. Instale o Perfil do Pacote de Software nos ns de extremidade gerenciados pelo Tivoli Framework. O seguinte exemplo mostra como instalar o SPB do mtodo de acesso do R/3 em uma estao de trabalho com o Windows. 1. Importe o arquivo do SBP TWS4APPS_R3BATCH_I386NT.SPB para um Perfil de Pacote de Software do Tivoli Framework chamado, por exemplo, TWS4APPS_R3BATCH_I386NT.8.2. Utilize o seguinte comando:
wimpspo -c PROFILE_MANAGER -f <SOURCE_PATH>/TWS4APPS_R3BATCH_I386NT.SPB -t build -p <DEST_PATH_LOCAL>/TWS4APPS_R3BATCH_I386NT.SPB TWS4APPS_R3BATCH_I386NT.8.2

Com esse comando, o arquivo SOURCE_PATH/TWS4APPS_R3BATCH_I386NT.SPB importado para o Perfil de Pacote de Software chamado TWS4APPS_R3BATCH_I386NT.8.2 que pertence ao gerenciador de perfil PROFILE_MANAGER do Tivoli Framework. O TWS4APPS_R3BATCH_I386NT.8.2 deve fazer referncia ao <DEST_PATH_LOCAL>/TWS4APPS_R3BATCH_I386NT.SPB como o arquivo local contendo as informaes necessrias.

22

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Nota: Para instalar uma instncia adicional desse SPB na mesma estao de trabalho, voc deve renomear o SPB. 2. Instale o Perfil de Pacote de Software TWS4APPS_R3BATCH_I386NT.8.2 em um computador com nome do host epw2000 (que tambm deve ser definido como um n de extremidade do Tivoli Framework). Utilize o seguinte comando:
winstsp -D INSTALL_DIR=TWShome -D LJUser=TWSuser TWS4APPS_R3BATCH_I386NT.8.2 epw2000

Quando o log de instalao, nesse caso um arquivo chamado $BINDIR/../swdis/work/TWS4APPS_R3BATCH_I386NT.log, mostra uma mensagem Operao Bem-sucedida, o processo de instalao pode ser considerado concludo. O seguinte exemplo mostra como instalar o SPB da JVM para AIX em um sistema AIX. Observe que um pacote de software JVM diferente existe para cada plataforma. 1. Importe o pacote de software chamado JRE131_AIX.SPB para um Perfil de Pacote de Software chamado JRE131AIX.8.2. Utilize o seguinte comando:
wimpspo -c PROFILE_MANAGER -f <SOURCE_PATH>/JRE131_AIX.SPB -t build -p <DEST_PATH_LOCAL>/JRE131_AIX.SPB JRE131AIX.8.2

2. Instale o Perfil de Pacote de Software JRE131AIX.8.2 em um computador com o nome do host epAIX. Utilize o seguinte comando:
winstsp -D INSTALL_DIR=TWShome -D LJUser=TWSuser JRE131AIX.8.2 epAIX

O seguinte exemplo mostra como instalar o SPB do Editor de Opes no mesmo sistema AIX. Observe que o SPB do Editor de Opes o mesmo para todas as plataformas. 1. Importe o pacote de software chamado OPTED.SPB para um Perfil de Pacote de Software chamado OPTED.8.2. Utilize o seguinte comando:
wimpspo -c PROFILE_MANAGER -f <SOURCE_PATH>/OPTED.SPB -t build -p <DEST_PATH_LOCAL>/OPTED.SPB OPTED.8.2

2. Instale o Perfil de Pacote de Software OPTED.8.2 em um computador com o nome do host epAIX. Utilize o seguinte comando:
winstsp -D INSTALL_DIR=TWShome -D LJUser=TWSuser OPTED.8.2 epAIX

Desinstalando o Produto
Desinstalar o Tivoli Workload Scheduler para Aplicativos de uma estao de trabalho requer que voc siga o mesmo procedimento usado para a instalao: v Se voc instalou por meio do ISMP, desinstale usando um mtodo ISMP compatvel. v Se voc instalou por meio da distribuio de software, desinstale utilizando o mesmo mtodo. Se voc planeja desinstalar o mtodo de acesso para o Oracle eBusiness suite, esteja ciente de que voc ter que concluir a remoo do produto, manualmente. Consulte Completando a Remoo do Mtodo de Acesso para Oracle e-Business Suite na pgina 24. Em certas condies, quando voc desinstala o produto totalmente, um diretrio chamado _xauninst pode ser esquecido pelo processo de desinstalao. Caso isso ocorra, remova-o manualmente.

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

23

Removendo uma Instalao por meio do ISMP


Para desinstalar o produto seguindo um instalao ISMP: v No Windows: 1. Selecione Adicionar/Remover Programas no Painel de Controle. 2. Localize IBM Tivoli Workload Scheduler para Aplicativos (nome do usurio). 3. Clique em Remover. Uma janela Desinstalador aberta. Nela possvel escolher se deseja excluir o produto inteiro ou um ou mais dos mtodos de acesso que foram instalados como recursos do produto. v No Unix: 1. V para o diretrio <TWShome>/methods. 2. Execute o seguinte comando :
../_xauninst/uninstaller

Uma janela Desinstalador aberta. Nela possvel escolher se deseja excluir o produto inteiro ou um ou mais dos mtodos de acesso que foram instalados como recursos do produto.

Removendo uma Instalao por meio do Tivoli Configuration Manager


Para desinstalar o produto utilizando a distribuio de software, use o Tivoli Desktop ou o comando wremovsp. Para ver uma lista de pacotes instalados no computador por meio da distribuio de software, use um dos dois procedimentos a seguir: v Utilize o Tivoli Inventory, includo no Tivoli Configuration Manager, verso 4.2, para executar a consulta chamada CM_STATUS_QUERY e listar qual mtodo de acesso que est instalado em qual estao de trabalho. Consulte a documentao do Tivoli Inventory para obter referncias. v Visualize os arquivos de log da Distribuio de Software no computador. Cada pacote de distribuio de software tem seu prprio arquivo de log um arquivo de texto que registra o histrico de instalao e desinstalao do pacote. Por exemplo, o arquivo de log em um sistema AIX do pacote de mtodo de acesso do R/3, r3batch_tws_aix.log, armazenado no diretrio $BINDIR/../swdis/work (em que $BINDIR um caminho do ambiente do Tivoli Framework inicializado pela execuo do comando /etc/Tivoli/setup_env.sh). Consulte a documentao do Tivoli Software Distribution para obter detalhes.

Completando a Remoo do Mtodo de Acesso para Oracle e-Business Suite


Depois finalizar o processo de desinstalao, execute as seguintes etapas: 1. Restaure APPLSYS.env para o seu contedo original, removendo a cadeia MCM das variveis APPLSHAR e APPLFUL. Por exemplo:
APPLSHAR=ALR FF MCM

deve ser
APPLSHAR=ALR FF

2. Remova os seguintes arquivos: v <TWShome>/methods/MCMAGENT v <TWShome>/catalog/C/mcm.cat v MCMLJ, MCMSTAT e MCMTJ localizados no diretrio $MCM_TOP/bin

24

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v MCMprod.txt localizado no diretrio $APPL_TOP/admin v Todos os arquivos de opes

Captulo 2. Instalando o IBM Tivoli Workload Scheduler para Aplicativos

25

26

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 3. Definindo Opes com o Editor de Opes


Um arquivo de opes um arquivos de texto que contm um conjunto de opes de configuraes necessrio para executar um agente estendido. As opes so gravadas uma por linha e tm o seguinte formato:
OPTION=VALUE

sem espao antes, depois ou entre as palavras-chave. As opes so utilizadas para alterar as propriedades de tempo de execuo do mtodo de acesso, tais como a senha necessria para conectar-se a um sistema externo (como SAP R/3) ou o nome de login para essa conexo. Todos os mtodos de acesso usam dois tipos de arquivos de opes. So eles: Arquivo de Opes Globais Um arquivo de configurao comum para uma instncia particular de um mtodo de acesso, cujas definies afetam todas as estaes de trabalho do agente estendido, definidas nessa instncia. Ele lista as opes, como LJuser (que fornece o nome do usurio que executa o mtodo de acesso) e IFuser (que fornece o nome do usurio que executa o mtodo para recuperar informaes do job), que so, em parte, inseridas no momento da instalao. O nome desse arquivo <nome_do_mtodo_de_acesso>.opts. Por exemplo, para uma instalao do mtodo de acesso para R/3, o nome do arquivos de opes globais r3batch.opts. Arquivo de Opes Locais Um arquivo de configurao que especfico para cada estao de trabalho de agente estendido dentro de uma instncia particular de um mtodo de acesso. Toda estao de trabalho de agente estendido, exceto para z/OS, deve ter um arquivo de opes locais com suas prprias opes de configurao. O nome desse arquivo nome da estao de trabalho_<nome_do_mtodo_de_acesso>.opts. Por exemplo, se uma instalao do mtodo de acesso para R/3 incluir duas estaes de trabalho de agente estendido, CPU1 e CPU2, os nomes dos arquivos de opes locais sero, respectivamente, CPU1_r3batch.opts e CPU2_r3batch.opts. Os arquivos devem estar localizados no subdiretrio methods da instalao do Tivoli Workload Scheduler e so lidos quando o agente estendido e inicializado. As opes so especficas para cada mtodo de acesso. Para saber as opes de cada mtodo de acesso, consulte: v Captulo 8, Referncia do Arquivo de Opes MCMAGENT, na pgina 53 para Oracle v Captulo 11, Tarefas de Ps-Instalao, na pgina 65 para PeopleSoft v Captulo 20, Arquivos de Opes do Mtodo de Acesso do R/3, na pgina 119 para R/3 v Captulo 25, Configurao e Operao, na pgina 151 para z/OS Voc pode gravar os arquivos de opes com um editor de texto de sua escolha ou cri-los com o Editor de Opes fornecido com o produto.
Copyright IBM Corp. 2000, 2003

27

Antes de concluir a instalao, o Tivoli Workload Scheduler para Aplicativos opcionalmente inicia o Editor de Opes para que voc defina as opes locais, enquanto alguns dos valores digitados durante o processo so usados para criar um arquivo de opes globais. Para iniciar o Editor de Opes posteriormente, v para o subdiretrio methods da instalao do Tivoli Workload Scheduler e execute o arquivo opted.exe (Windows) ou o comando opted.bin (Unix). Se voc instalou o produto por meio do Tivoli Configuration Manager, inicie o Editor de Opes com um destes comandos: v TWShome\methods\opted\opted.bat no Windows v TWShome/methods/opted/opted.sh no Unix O Editor de Opes carrega automaticamente todos os arquivos de opes globais e locais existentes. Alm de editar arquivos existentes, voc pode criar arquivos de opes locais para as estaes de trabalho de agente estendido definidas recentemente. O Editor de Opes fornece trs visualizaes possveis de um arquivo de opes: Simples Exibe as opes como uma seqncia de guias e permite editar uma opo por vez. Para visualizar ou editar uma opo, selecione a guia com o nome da opo para exibir o campo para o valor. Esse o modo mais fcil de editar opes, pois voc v apenas o valor real que ser usado no arquivo. Valores herdados ou padro no so exibidos. As opes obrigatrias esto em amarelo e so marcadas por um asterisco(*). Tabela Fornece uma exibio em tabela de todas as opes para um arquivo selecionado. Para cada opo, as seguintes colunas so exibidas: Valor O valor especificado no arquivo.

Valor Padro O valor usado pelo mtodo se nenhum outro valor estiver disponvel. Valor Herdado O valor obtido do arquivo de opes globais, se a herana for suportada pelo mtodo. Valor Real O valor usado realmente no tempo de execuo. A ordem de uso : valor, se disponvel; valor herdado, se suportado; valor padro. As opes obrigatrias esto no plano de fundo amarelo. Texto Exibe um arquivo de opes no formato comum, apresentando somente as opes que tm um valor. Essa exibio geralmente usada como objetivos de visualizao, como arquivos mostrados com especificao somente leitura. Os campos de senha so mostrados no formato criptografado.

A janela do Editor de Opes composta por trs reas principais, como mostrado em Figura 17 na pgina 29. So elas: rvore de Arquivos de Opes Mostra a lista de todos os arquivos de opes existentes, agrupados por mtodo. Descritor de Opes Fornece uma descrio da seleo atual.

28

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Exibio de Opes de Arquivos Exibe as opes de um arquivo selecionado em qualquer uma das trs exibies disponveis.

Figura 17. O Editor de Opes

Certifique-se de que o Editor de Opes no esteja em execuo antes de incluir ou atualizar os recursos ou as instncias de uma instalao do Tivoli Workload Scheduler para Aplicativos existente. Voc deve restringir o acesso ao executvel do Editor de Opes. Se voc tiver vrias instalaes de um agente estendido, possvel aumentar a segurana, mantendo somente uma cpia do Editor de Opes (na estao de trabalho mestre, por exemplo). Utilizando o FTP, voc pode gerenciar todos os arquivos de opes criptografados de um nico local.

Criando um Arquivo de Opes Locais


Enquanto os arquivos de opes globais so gerados sempre que voc instala uma instncia de um mtodo, voc pode criar arquivos de opes locais no momento em que desejar, antes ou depois de definir uma estao de trabalho de agente estendido. Para fazer isso com o Editor de Opes: 1. Clique em FileNew na barra de menu. A janela Novo Arquivo de Opes exibida.

Captulo 3. Definindo Opes com o Editor de Opes

29

2. Grave o nome de uma estao de trabalho de agente estendido que voc acabou de definir ou que planeja definir. 3. Selecione um mtodo de acesso a partir daqueles instalados no menu drop-down. O novo arquivo de opes ter o nome : <nome_da_estao_de_trabalho_de_agente_estendido>_<nome_do_mtodo>.opts. 4. Comece a inserir os valores para as opes.

Herana de Valor da Opo


Essa propriedade est disponvel atualmente apenas para r3batch. Ela implica que os arquivos de opes locais podem herdar valores existentes de opes semelhantes no arquivo de opes globais (r3batch.opts). De fato, para um mtodo de acesso, as opes so listadas duas vezes: uma como global e outra como local. Se a opo local no listar seu prprio valor, ento aquela global equivalente utilizada. Por outro lado, se ela existir, o valor local ser sempre mandatrio em relao ao valor global. Por exemplo, voc deseja definir o mesmo usurio e a mesma senha do R/3 para todos os sistema do R/3. Utilizando essa propriedade, em vez de gravar o mesmo valor em cada arquivo de opes locais, voc pode grav-lo uma vez no arquivo de opes globais.

30

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 4. Definindo as Estaes de Trabalho de Agente Estendido


Uma definio de estao de trabalho de agente estendido necessria para cada entidade do mtodo de acesso pela qual o Tivoli Workload Scheduler ir planejar e ativar os jobs. As estaes de trabalho de agente estendido so definidas no modo padro e incluem o nome do host do agente estendido e o nome do mtodo. Para ativar um job em uma estao de trabalho de agente estendido, o Tivoli Workload Scheduler executa o mtodo de acesso, transmitindo as informaes sobre o job. O mtodo de acesso comunica-se com a instncia do sistema z/OS, R/3, PeopleSoft ou Oracle em particular e monitora o job at a concluso, gravando as informaes de progresso e de status do job no arquivo de lista padro de job.

Criando uma Estao de Trabalho com o Job Scheduling Console


Para definir uma estao de trabalho de agente estendido com o Job Scheduling Console, siga estas etapas: 1. Na janela principal, selecione o cone Nova Estao de Trabalho na barra de ferramentas superior ou clique com o boto direito do mouse no nome do mecanismo do Tivoli Workload Scheduler e selecione Nova Estao de Trabalho no menu drop down. A janela Propriedades - Estao de Trabalho no Banco de Dados exibida.

Figura 18. Definindo uma Estao de Trabalho com o Job Scheduling Console

2. Complete os campos utilizando as informaes na Tabela 6 na pgina 32. 3. Clique em OK para salvar e fechar a janela.

Copyright IBM Corp. 2000, 2003

31

A tabela a seguir mostra como completar os campos da janela de propriedades da estao de trabalho, dependendo da estao de trabalho de agente estendido que voc deseja definir.
Tabela 6. Como Completar os Campos da Janela Propriedades - Estao de Trabalho no Banco de Dados Campo PeopleSoft Nome Descrio por Mtodo de Acesso z/OS Oracle eBusiness Suite R/3

O nome para a estao de trabalho de agente estendido. Para todos os mtodos de acesso (exceto aquele para o z/OS que sempre limitado para 8), o nome pode conter at 8 ou 16 caracteres alfanumricos, dependendo da utilizao expandida ou no expandida dos bancos de dados. Isso pode incluir caracteres de trao e sublinhado, mas ele deve comear com uma letra. Para todos os mtodos de acesso, esse nome deve ser consistente com o nome do arquivo de opes associado estao de trabalho. Isto , se o arquivo de opes (normalmente criado com o Editor de Opo) for chamado de <mycpu>_<mymethod>.opts, ento mycpu e o Nome devem ser iguais.

null.

O nome do n ou o null. endereo IP do sistema z/OS. Nomes de domnio completamente qualificados so aceitos. O endereo TCP Qualquer nmero (nmero da porta) do diferente de 0. gateway do z/OS no sistema z/OS. Insira o mesmo valor como na varivel SYSTSIN PORT descrita em Tabela 21 na pgina 145. Selecione OTHER.

null.

Porta TCP

Qualquer nmero diferente de 0.

Qualquer nmero diferente de 0.

Sistema Operacional Domnio

O nome do domnio do Tivoli Workload Scheduler da estao de trabalho do host. Se voc precisar de ajuda para encontr-lo, clique na elipse (...) para obter uma lista dos domnios existentes. Clique em Utilizar Master, se voc souber que a estao de trabalho do host est no mesmo domnio que o gerenciador de domnio do master. Se a rede do Tivoli Workload Scheduler estiver utilizando a opo Fuso Horrio, selecione o fuso horrio apropriado na lista drop down. Deixe o campo em branco se esse no for o caso. Uma descrio textual de formato livre da estao de trabalho (at 40 caracteres). No utilizada em estaes de trabalho de agente estendido. No utilizada em estaes de trabalho de agente estendido. No utilizada em estaes de trabalho de agente estendido. Selecione Agente Estendido. No utilizada em estaes de trabalho de agente estendido. Selecione essa opo somente se quiser que o Tivoli Workload Scheduler ignore essa definio de estao de trabalho. Essa opo til se desejar predefinir fluxos de job, jobs e objetos para um sistema ainda no chegou. No utilizada em estaes de trabalho de agente estendido.

Fuso Horrio

Descrio Comunicao SSL Atrs do Firewall Porta Segura Tipo de Estao de Trabalho AutoLink Ignorar

Status Completo

32

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 6. Como Completar os Campos da Janela Propriedades - Estao de Trabalho no Banco de Dados (continuao) Campo PeopleSoft Resolver Dependncias Servidor Mtodo de Acesso psagent Descrio por Mtodo de Acesso z/OS Oracle eBusiness Suite R/3

No utilizada em estaes de trabalho de agente estendido. No utilizada em estaes de trabalho de agente estendido. Dependendo da interface de planejamento do job; uma das seguintes: mvsca7 Para ativar e monitorar os jobs do z/OS por meio do CA-7. mvsjes Para ativar e monitorar os jobs do z/OS por meio do JES2 ou do JES3. mvsopc Para ativar e monitorar os jobs do z/OS por meio do OPC ou do Tivoli Workload Scheduler para z/OS. Nota: O nome faz distino de maisculas e minsculas (deve estar em letra minscula) no Unix. MCMAGENT Nota: O nome faz distino de maisculas e minsculas e deve estar em letra maiscula. r3batch Nota: O nome faz distino de maisculas e minsculas (deve estar em letra minscula) no Unix.

Host

O nome do sistema de host do Tivoli Workload Scheduler. Esse o agente tolerante a falhas do Tivoli Workload Scheduler ou o agente padro no qual o agente estendido est instalado. Clique em elipse (...) para ver uma lista de hosts existentes.

Criando uma Estao de Trabalho da Linha de Comando


As definies de estao de trabalho de agente estendido podem ser feitas na linha do comando do Tivoli Workload Scheduler, utilizando o programa composer. O exemplo a seguir mostra uma definio para a estao de trabalho de agente estendido chamada MVSCPU que utiliza o mtodo de acesso do mvsjes.
cpuname MVSCPU description "zOS extended agent" os other node mvsesa36.rome.tivoli.com tcpaddr 5000 domain masterdm for maestro

Captulo 4. Definindo as Estaes de Trabalho de Agente Estendido

33

type x-agent host ROCIOUS access mvsjes end

Consulte IBM Tivoli Workload Scheduler - Guia de Referncia para obter mais detalhes sobre como definir as estao de trabalho com o composer.

Definindo Estaes de Trabalho para Planejamento Ponto a Ponto


Planejar em um ambiente ponto a ponto significa que no Tivoli Workload Scheduler para z/OS voc est planejando e monitorando jobs executados fisicamente em estaes de trabalho do Tivoli Workload Scheduler. Para esse ponto, as estaes de trabalho de agente estendido devem ser definidas adequadamente como o estao de trabalho tolerante falha no Tivoli Workload Scheduler para z/OS. Uma estao de trabalho tolerante falha uma definio de Tivoli Workload Scheduler para z/OS de um agente do Tivoli Workload Scheduler existente na rede distribuda. O agente do Tivoli Workload Scheduler o local em que o job associado estao de trabalho tolerante falha ser executado na rede distribuda. Para definir a estao de trabalho de agente estendido no Tivoli Workload Scheduler para z/OS, voc deve: 1. Definir a estao de trabalho na instruo de inicializao do CPUREC. 2. Incluir a mesma definio de estao de trabalho no banco de dados por meio do ISPF ou do Job Scheduling Console. Para obter uma descrio sobre como definir a estao de trabalhando utilizando o Job Scheduling Console, consulte o Guia do Usurio Tivoli Job Scheduling Console.

Criando a Instruo CPUREC


Primeiro, crie a instruo CPUREC para a estao de trabalho na instruo de inicializao TOPOLOGY. A instruo de inicializao TOPOLOGY utilizada para definir parmetros listados topologia de rede conectada ao Tivoli Workload Scheduler. Tal instruo de topologia de rede constituda de uma ou mais instrues (uma para cada domnio) DOMREC que descrevem a topologia de rede distribuda e por vrias instrues CPUREC, uma para cada estao de trabalho tolerante falha. O exemplo a seguir mostra uma instruo CPUREC para a estao de trabalho de agente estendido do R/3 chamada R3XA. O agente estendido hospedado por um agente do Tivoli Workload Scheduler chamado TWSA, que tambm o gerenciador de domnio do DOMAIN1.
****************TPLGINFO MEMBER *************************** /*********************************************************************/ /* DOMREC: Domain definition */ /*********************************************************************/ DOMREC DOMAIN(DOMAIN1) DOMMNGR(TWSA) DOMPARENT(MASTERDM) /*********************************************************************/ /* CPUREC: Extended agent workstation definition */ /*********************************************************************/ CPUREC CPUNAME(R3XA) CPUOS(OTHER) CPUNODE(NODE1)

34

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

CPUDOMAIN(DOMAIN1) CPUHOST(TWSA) CPUTYPE(XAGENT) CPUACCESS(r3batch) CPUUSER(TWSuser) CPUTZ(Europe/Rome) /*********************************************************************/ /* CPUREC: Domain manager workstation definition */ /*********************************************************************/ CPUREC CPUNAME(TWSA) CPUNODE(NODE1) CPUAUTOLINK(ON) CPUDOMAIN(DOMAIN1) CPUTYPE(FTA) CPUUSER(TWSuser) CPUTZ(Europe/Rome)

As seguintes palavras-chave definem o R3XA como um agente estendido: CPUACCESS O mtodo de acesso de agente estendido. Para R/3, r3batch. CPUHOST O nome da estao de trabalho do Tivoli Workload Scheduler que hospeda o agente estendido. No pode ser outro agente padro ou agente estendido. CPUTYPE O tipo de estao de trabalho. Para um agente estendido, ele deve ser XAGENT. Para obter informaes adicionais sobre o CPUREC, consulte Personalizao e Ajuste do Tivoli Workload Scheduler para z/OS.

Definindo a Estao de Trabalho com ISPF


O Figura 19 na pgina 36 mostra a definio do ISPF para o R3XA. No ISPF (ou no Job Scheduling Console), defina a estao de trabalho como computador automtico e defina o campo Estao de Trabalho FT para Y. a instruo CPUREC com trs palavras-chave descrita na seo anterior que fornece a especificao do agente estendido. Nota: Certifique-se de gravar a instruo CPUREC antes de definir o ISPF ou o Job Scheduling Console, pois eles sozinhos no tm efeito sem a instruo CPUREC.

Captulo 4. Definindo as Estaes de Trabalho de Agente Estendido

35

-------------- CRIANDO INFORMAES GERAIS SOBRE UMA ESTAO DE TRABALHO -------------Command ===> Insira o comando R para recursos acima ou insira os dados abaixo: WORK STATION NAME DESCRIPTION WORK STATION TYPE REPORTING ATTR ===> ===> ===> ===> A para disponibilidade ou M para mtodo de acesso

FT Work station PRINTOUT ROUTING planejamento dirio SERVER USAGE ===> N Opes: SPLITTABLE JOB SETUP STARTED TASK, STC WTO DESTINATION Padres: TRANSPORT TIME DURATION

R3XA Agente estendido para o mtodo de acesso do R/3____________________ C G Geral, C Computador, P Impressora A A Automtico, S Inicializao e concluso manual C Concluso apenas, N No relatado ===> Y Estao de trabalho FT, Y ou N ===> SYSPRINT O ddname do conjunto de dados de impresso de Utilizao do servidor paralelo C , P , B ou N

===> ===> ===> ===> ===>

N Interrupo de operao permitida, Y ou N N Edio de JCL permitida, Y ou N N Suporte tarefa iniciado, Y ou N N WTO automtico, Y ou N ________ Nome do destino Hora a estao de trabalho anterior HH.MM Durao de uma operao normal HH.MM.SS

===> 00.00 ===> ________

Figura 19. Definindo uma Estao de Trabalho de Agente Estendido

36

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 5. Definindo os Jobs de Agente Estendido


Este captulo explica como definir os jobs do Tivoli Workload Scheduler associados aos jobs externos que voc deseja executar por meio dos agentes estendidos. Para executar e monitorar um job do PeopleSoft, R/3, Oracle ou z/OS com o Tivoli Workload Scheduler, o agente estendido (ou o mtodo de acesso) requer a definio de job do Tivoli Workload Scheduler, em que voc especifica o job externo que pretende planejar, a estao de trabalho (tambm definida no Tivoli Workload Scheduler) na qual ele deve ser executado e as aes de recuperao desejadas. Para definir o job, voc pode utilizar: v O Tivoli Job Scheduling Console v A linha de comandos do Tivoli Workload Scheduler Se voc estiver fazendo o planejamento em um ambiente ponto a ponto, para definir o job ser necessrio utilizar os dilogos ISPF do Tivoli Workload Scheduler para z/OS. Alm disso, voc deve criar um membro no SCRIPTLIB com uma instruo JOBREC para o job. Os jobs de agente estendido so includos nos fluxos de job e planejados como qualquer outro job no Tivoli Workload Scheduler e no Tivoli Workload Scheduler para z/OS.

Definindo Jobs com o Job Scheduling Console


As etapas descritas aqui para definir um job de agente estendido so comuns a todos os mtodos de acesso. Alm disso, o mtodo de acesso para o R/3 fornece recursos complementares se voc utilizar as etapas alternativas descritas em Utilizando Janelas Especficas do SAP do Job Scheduling Console na pgina 102. Para todos os mtodos de acesso, siga estas etapas: 1. Na lista Aes da janela principal do Job Scheduling Console, selecione Nova Definio de Job. 2. Selecione um mecanismo do Tivoli Workload Scheduler e, a partir da lista resultante, clique em Tarefa de Agentes Estendidos. A pgina Geral da janela Propriedades - Definio de Job exibida.

Copyright IBM Corp. 2000, 2003

37

Figura 20. Pgina Geral da janela Propriedades - Definio de Job.

3. Nessa pgina, voc fornece informaes sobre o job do Tivoli Workload Scheduler que ir orientar o job externo. Complete os campos nessa janela com a ajuda da tabela a seguir.
Tabela 7. A Pgina Geral da Janela Propriedades - Definio de Job (Descrio dos Campos). Campo Tipo de Tarefa Nome Descrio Esse um campo somente-leitura e pode declarar Tarefa de Agente Estendido. O nome do job do Tivoli Workload Scheduler que voc est definindo. Esse job ir orientar o job de aplicativo externo, cujo nome ser fornecido na prxima pgina desta janela. O nome pode conter at 8 caracteres alfanumricos, se o banco de dados no estiver expandido ou 40 se estiver expandido. Ele pode incluir traos e caracteres de sublinhado, mas deve ser iniciado com uma letra. Espaos embutidos no so permitidos. Ele pode ser o mesmo do nome do job externo, to longo quanto for vlido no Tivoli Workload Scheduler. O nome da estao de trabalho do agente estendido na qual o job deve ser executado. Voc pode clicar no boto de elipse (...) para exibir a janela Localizar e selecionar uma estao de trabalho disponvel. Uma descrio em texto do job de at 64 caracteres alfanumricos. Esse campo opcional.

Estao de Trabalho

Descrio

38

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 7. A Pgina Geral da Janela Propriedades - Definio de Job (Descrio dos Campos). (continuao) Campo Login Descrio O nome do usurio necessrio para executar o job no Tivoli Workload Scheduler. Normalmente, esse o valor do parmetro LJuser, especificado durante a instalao do Tivoli Workload Scheduler para Aplicativos, que est no arquivo de opes para o mtodo. Deve ser um usurio vlido na estao de trabalho do host do Tivoli Workload Scheduler que deve ser capaz de acessar o produto externo. necessrio planejar o job no Tivoli Workload Scheduler para que ele seja mostrados nas exibies do Tivoli Workload Scheduler. De modo alternativo, clique em Incluir Parmetro para incluir quaisquer parmetros definidos ao ID de logon. Opes de Recuperao A resposta automtica do Tivoli Workload Scheduler se o job terminar de forma anormal. O padro Parar. Para obter informaes sobre opes de recuperao, consulte o Tivoli Workload Scheduler - Guia de Referncias do . Um texto de mensagem ou um aviso opcional que exibido quando o job termina de forma anormal. Nenhum aviso predefinido aceito aqui. O nome de um job de recuperao que iniciado automaticamente quando o job termina de forma anormal. Clique em elipse (...) para exibir a janela Localizar e listar os jobs existentes. O nome da estao de trabalho que tem o job de recuperao.

Mensagem

Job

Estao de Trabalho

4. Clique em Tarefa para continuar na prxima pgina. A pgina Tarefa da janela exibida.

Figura 21. A pgina Tarefa da janela Propriedades - Definio de Job.

Captulo 5. Definindo os Jobs de Agente Estendido

39

5. Nessa pgina voc fornece informaes sobre o job externo (ou tarefa) que ser orientado pelo job definido na pgina anterior. Observe que a tarefa deve ter sido definida no aplicativo externo. Complete os campos nessa janela com a ajuda da tabela a seguir.
Tabela 8. A pgina Tarefa da janela Propriedades - Definio de Job (Descrio dos Campos). Campo Tipo de Tarefa Comando Descrio Esse um campo somente-leitura e pode declarar Tarefa de Agente Estendido. As especificaes para o job externo (tarefa). Cada aplicativo externo tem um conjunto de parmetros diferente: v Para jobs de Aplicativos Oracle, consulte Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications na pgina 49. v Para jobs do Peoplesoft, consulte Parmetros de Cadeia de Tarefas para Jobs do PeopleSoft na pgina 77. v Para jobs do R/3, consulte Parmetros da Cadeia de Tarefas para Jobs do R/3 na pgina 110. v Para jobs do z/OS, consulte Sintaxe de Definio de Tarefas para Jobs do z/OS Planejados com o Tivoli Workload Scheduler na pgina 153. Grave os parmetros em uma cadeia com o seguinte formato -parameter1 value1 -parameter2 value2...-parametern valuen Clicar em Incluir Parmetro... exibe a janela Localizar Parmetros, em que voc pode listar e incluir parmetros predefinidos do Tivoli Workload Scheduler no campo Comando. Expresso de Uma expresso lgica que define quais cdigos de retorno fazem Mapeamento de Cdigo com que a tarefa seja bem-sucedida. Voc pode utilizar de Retorno operadores de comparao e lgicos. Por exemplo, a expresso RC6 indica que um cdigo de retorno maior ou igual a 6 significa que a tarefa foi bem-sucedida.

6. Clique em OK para salvar a definio do job.

Definindo Jobs com a Linha de Comandos do Tivoli Workload Scheduler


Os jobs tambm podem ser definidos no linha de comando composer do Tivoli Workload Scheduler. O seguinte exemplo relata um job do Tivoli Workload Scheduler chamadoorajob2 executado em uma estao de trabalho de agente estendido de aplicativos Oracle chamada ora002. Ele conecta-se ao UNIX como orajobs e ativa um job nos aplicativos Oracle. O job de aplicativos Oracle chamado poxacr e seu proprietrio global. Se for necessria a recuperao, o Tivoli Workload Scheduler executar o job recov2 e continuar o processo.
ora002#orajob2 streamlogon orajobs scriptname "-user global -job fnd application developer po poxacr -prn ps4 2 -v1 abc" descrio "oracle apps job #2" recuperao continua aps recov2

40

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Observe que os argumentos do nome_da_cadeia so diferentes de acordo com o aplicativo. Para obter referncia, consulte: v Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications na pgina 49. v Parmetros de Cadeia de Tarefas para Jobs do PeopleSoft na pgina 77. v Parmetros da Cadeia de Tarefas para Jobs do R/3 na pgina 110. v Sintaxe de Definio de Tarefas para Jobs do z/OS Planejados com o Tivoli Workload Scheduler na pgina 153. Para obter informaes adicionais sobre a utilizao da linha de comando para definir jobs, consulte o Tivoli Workload Scheduler - Guia de Referncias.

Definindo Jobs para Planejamento Ponto a Ponto


Os jobs de agente estendido planejados para serem executados em um ambiente ponto a ponto no podem ser definidos por meio do Job Scheduling Console ou da linha de comando do Tivoli Workload Scheduler. Eles devem ser includos em SCRIPTLIB do Tivoli Workload Scheduler para z/OS. No painel ISPF de OPERAES do Tivoli Workload Scheduler para z/OS, os jobs de agente estendido so definidos como qualquer outro job, mas a escolha da estao de trabalho do job de agente estendido denota seu tipo. O seguinte exemplo mostra a definio de um job chamado SAPJOB. Esse o job do Tivoli Workload Scheduler para z/OS que orientar a execuo de um job do R/3 (chamado BAPRINT46B conforme pode ser visto no exemplo a seguir). Ele mostra como um job de agente estendido, apenas por que a estao de trabalho associada uma estao de trabalho de agente estendido chamada R3XA.
--------------------------------- OPERAES -----------------Row 1 a 1 de 1 Comando ===> Scroll ===> PAGE Insira/Altere os dados nas linhas e/ou insira qualquer um dos seguintes comando de linha: I(nn) - Inserir, R(nn),RR(nn) - Repetir, D(nn),DD - Excluir S - Selecionar os detalhes da operao, J - Editar JCL Digite o comando TEXT acima para incluir o texto da operao na lista ou digite o comando GRAPH para visualizar a lista em forma de grfico. Aplicativo : APLL1 FTW appl

Row Oper Durao Nome do job Processadores internos Morepreds cmd ws no. HH.MM.SS -IntExt R3XA 001 00.00.01 SAPJOB___ ___ ___ ___ ___ ___ ___ ___ ___ 0 0 ******************************* Base do dados ********************************

Figura 22. Definindo um Job de Agente Estendido para Planejamento Ponto a Ponto .

Para cada job, um membro deve ser criado em SCRIPTLIB do Tivoli Workload Scheduler para z/OS com detalhes sobre o job em uma instruo JOBREC. Um membro SAPJOB foi criado para o job no exemplo anterior. Ele contm uma instruo JOBREC como esta:
JOBREC JOBCMD(/-job BAPRINT46B -user MAESTRO -i 14160001 -c C) JOBUSR(twsila)

A cadeia em JOBCMD lida e interpretada pelo mtodo de acesso antes da execuo do job. O job desse exemplo, BAPRINT46B, foi definido anteriormente em R/3 e atribudo com um ID de 14160001, manualmente transcrito em JOBCMD.
Captulo 5. Definindo os Jobs de Agente Estendido

41

O seguinte exemplo para um job do PeopleSoft. Observe que a cadeia inteira que segue a palavra-chave JOBCMD deve estar entre aspas duplas em vez de simples. Isso verdadeiro somente quando os jobs do PeopleSoft esto envolvidos, pois as aspas simples tambm so utilizadas na cadeia.
JOBREC JOBCMD("/-operator PS -process XRFWIN -type SQR Report -runcontrol TWS") JOBUSR(PsBuild)

Os argumentos do JOBCMD so diferentes de acordo com o aplicativo. Para obter referncia, consulte: v Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications na pgina 49. v Parmetros de Cadeia de Tarefas para Jobs do PeopleSoft na pgina 77. v Parmetros da Cadeia de Tarefas para Jobs do R/3 na pgina 110. v Sintaxe de Definio de Tarefas para Jobs do z/OS Planejados com o Tivoli Workload Scheduler na pgina 153.

42

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 2. Mtodo de Acesso do Oracle e-Business Suite

Copyright IBM Corp. 2000, 2003

43

44

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 6. Introduo
O IBM Tivoli Workload Scheduler para Aplicativos do Oracle e-Business Suite oferece a habilidade de planejar os jobs do Oracle e-Business Suite, utilizando o recurso de planejamento de job sofisticado do Tivoli Workload Scheduler. Neste manual, os Aplicativos Oracle e o Oracle e-Business Suite so usados alternadamente para fazer referncia ao nome do mesmo produto. O host do Tivoli Workload Scheduler, o agente estendido do Tivoli Workload Scheduler para Oracle e-Business Suite, e a instncia do Oracle e-Business Suite devem ser instalados no mesmo n fsico.

Recursos
v Utilize as dependncias de job padro do Tivoli Workload Scheduler (exceto as dependncias de Abrir Arquivo). v Planeje os jobs do Oracle e-Business Suite para serem executados em dias e horas especificados e em uma ordem predeterminada. v Defina a interdependncia dos jobs de Aplicativos Oracle e dos jobs executados em sistemas diferentes, como R/3 e PeopleSoft. v Defina a interdependncia dos jobs de Aplicativos Oracle e dos jobs executados em plataformas diferentes. v Personalize os cdigos de retorno de execuo do job.

Requisitos de Software
Para instalar e utilizar o IBM Tivoli Workload Scheduler para Aplicativos do Oracle e-Business Suite, necessrio: v Um dos seguintes sistemas operacionais suportados: HP-UX 11.0, 11.i Solaris Operating Environment Verses 7, 8, 9 IBM AIX 4.3.3, 5.1 v O seguinte software instalado: IBM Tivoli Workload Scheduler 7.0 ou superior Oracle Applications 10.7 ou Oracle e-Business Suite 11.0 ou 11.i Para usurio do AIX e da HP apenas, o compilador gcc para a respectiva plataforma. Os binrios do compilador gcc podem ser recuperados de vrias fontes na Web. Para obter a lista mais recente de plataformas suportadas, entre em contato com o Atendimento ao Cliente local.

Tarefas de Ps-instalao
Depois de instalar o produto como explicado em Captulo 2, Instalando o IBM Tivoli Workload Scheduler para Aplicativos, na pgina 5, execute as seguintes etapas para concluir a instalao do mtodo de acesso para o Oracle e-Business Suite:
Copyright IBM Corp. 2000, 2003

45

1. Efetue logon como um usurio do Oracle Applications no Unix, que tem acesso a todos os arquivos no diretrio Oracle Application Top. 2. Alterne para o diretrio instalado:
cd <TWShome>/methods/OracleTMP

Nota: Se voc estiver executando o banco de dados de demonstrao do Oracle Applications, substitua o arquivo APPDEMO.env nas etapas 3 e 4. 3. Modifique o arquivo APPLSYS.env do Oracle Applications como se segue: a. Adicione MCM s variveis APPLSHAR e APPLFULL.
APPLSHAR=ALR FF MCM APPLFUL=FND AD AX AK GL RG INV OP MCM

b. Defina e exporte a varivel shell MCM_TOP:


MCM_TOP=$APPL_TOP/mcm/integration export MCM_TOP

c. Inclua $MCM_TOP/bin na varivel PATH, inserindo as seguintes linhas na parte inferior do arquivo APPLSYS.env:
PATH=$PATH:$MCM_TOP/bin export PATH

4. Execute o arquivo APPLSYS.env para definir o ambiente:


. APPLSYS.env

Nota: Certifique-se de que o logon do Oracle Applications tenha permisses para gravao nos diretrios TWShome e methods. 5. Altere a propriedade de usurio e de grupo dos arquivos instalados para o proprietrio do Oracle Application. 6. Altere o diretrio para /temp/usrxit. 7. Apenas para usurios de AIX e HP: v Devido ao formato dos objetos MCMxxx.o, voc precisa utilizar o compilador gcc na plataforma para executar as seguintes etapas. Os binrios do compilador gcc podem ser transferidos de vrias fonte na Internet. v Apenas para usurios do AIX: Personalize o script adrelink fornecido pela Oracle para as opes de novo vnculo do gcc: a. Localize a seguinte linha:
AIXRIOS) LDFLAGS=-s -H512 -T512 -bhalt:4 -brtl -L$(ORACL ....

b. Exclua
-H512 -T512 -bhalt:4 -brtl

da linha, para que ela seja semelhante a :


AIXRIOS) LDFLAGS=-s -L$(ORACL ....

v Certifique-se de que o compilador gcc esteja configurado no caminho do ambiente do Proprietrio do Aplicativo. Como uma opo alternativa, voc pode editar o arquivo mcm.mk enviado com o produto para gravar o caminho completo do gcc na linha
CC="gcc".

Nota: O IBM Tivoli Workload Scheduler para Aplicativos do Oracle e-Business Suite suporta somente a verso 2.x do compilador gcc. A verso 3.x no suportada. 8. Execute o script de instalao mcminstall a partir do diretrio temporrio. Utilize o seguinte comando:

46

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

sh mcminstall

Uma tela do Oracle Tivoli exibida. 9. Responda s solicitaes na tela de acordo com as definies do Oracle Applications e da instalao do Tivoli Workload Scheduler. O processo de instalao tenta um novo vnculo com os executveis do Tivoli Workload Scheduler para Aplicativos, utilizando as bibliotecas compartilhadas do Oracle Applications. Depois da concluso bem-sucedida do processo de vnculos, voc encontrar os seguintes executveis no diretrio $MCM_TOP/bin: v MCMLJ v MCMSTAT v MCMTJ Esses arquivos binrio so criados pelo utilitrio adrelink para o Oracle Applications. Esse utilitrio tambm registrar o MCM com um mdulo no AOL. Se encontrar problemas durante o processo de vnculo, voc dever corrigi-los e executar novamente a etapa correspondente, pois essa etapa responsvel por criar os arquivos binrios que ativam o Tivoli Workload Scheduler para Aplicativos para que ele interaja com o Oracle Concurrent Manager, no envio e na monitorao de jobs. 10. Edite o arquivo de opes. Consulte Captulo 8, Referncia do Arquivo de Opes MCMAGENT, na pgina 53 e Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 para obter detalhes. Agora a instalao est concluda. Consulte a documentao do IBM Tivoli Workload Scheduler para saber como iniciar o Batchman, como definir estaes de trabalho e jobs e outras operaes do Tivoli Workload Scheduler.

Interface Software
A interface entre Tivoli Workload Scheduler e Oracle e-Business Suite composta dos seguintes softwares: MCMAGENT O mtodo de acesso do IBM Tivoli Workload Scheduler para Aplicativos do Oracle e-Business Suite. MCMLJ Envia um job para o OCM (Oracle Concurrent Manager). MCMSTAT Monitora o status de um job enviado. MCMTJ Finaliza o job enviado, mediante o recebimento de um sinal de eliminao do Tivoli Workload Scheduler. mcm.mk Um utilitrio de criao de arquivo para vincular os programas acima com o Oracle Applications. MCMAGENT.opts Um arquivo de opes global que contm definies de configurao para o mtodo de acesso. Ele criado pelo processo de instalao do Tivoli Workload Scheduler para Aplicativos com alguns dos valores inseridos
Captulo 6. Introduo

47

durante a instalao. Consulte Captulo 8, Referncia do Arquivo de Opes MCMAGENT, na pgina 53 e Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 para obter detalhes. <WORKSTATION_ NAME>_MCMAGENT.opts Um arquivo de opes local que contm as definies de configurao para o agente estendido. Um arquivo exigido para cada estao de trabalho de agente estendido definida. Consulte Captulo 8, Referncia do Arquivo de Opes MCMAGENT, na pgina 53 e Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 para obter detalhes.

48

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 7. Informaes de Definio do Job


Este captulo fornece informaes para definir jobs do Oracle Applications no Tivoli Workload Scheduler.

Definindo Jobs no Oracle Applications


No Oracle Applications, jobs que devem ser planejados com o Tivoli Workload Scheduler so definidos da mesma maneira que outros jobs do Oracle Applications (e podem ser enviados ao OCM). Quando voc estiver enviando o job no OCM, especifique as informaes de planejamento e de reenvio. Quando estiver enviando um job por meio do Tivoli Workload Scheduler, o Tivoli Workload Scheduler cuidar das informaes de planejamento e reenvio. Para definir um job, utilize os executveis e os formatos do Define Concurrent Program e preencha as informaes de dados gerais para o job. Agora o job est disponvel para planejamento a partir do Tivoli Workload Scheduler (e pode tambm ser enviado no OCM).

Executando um nico Job Simultaneamente


Se um job do Oracle Applications for planejado para ser executado mais de uma vez no Tivoli Workload Scheduler e se o Tivoli Workload Scheduler ativ-lo simultaneamente, os jobs sero executados normalmente. Contudo, se o usurio do Oracle Applications especificar que o job no pode ser executado simultaneamente, o segundo job apresentar um estado de WAIT at que o primeiro job seja concludo.

Definindo Jobs do Oracle Applications no Tivoli Workload Scheduler


As definies de job do Tivoli Workload Scheduler so necessrias para cada job do Oracle Applications que voc pretende planejar. Os jobs do Oracle Applications so definidos no Tivoli Workload Scheduler como outros jobs e incluem o nome do job, o nome do usurio e as opes de recuperao. Consulte Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37.

Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications


Esta seo descreve os parmetros da cadeia de tarefas que regem a execuo de jobs do Oracle Applications. Voc deve especific-los nos seguintes locais ao definir os jobs do Tivoli Workload Scheduler associados: v No campo Comando da pgina Tarefas da janela Propriedades - Definio do Job, se estiver usando o Job Scheduling Console. v Como argumentos da palavra-chave nome_do_script na instruo de definio do job, se estiver usando a linha de comando do Tivoli Workload Scheduler. v Como argumentos da palavra-chave JOBCMD na instruo JOBREC no SCRIPTLIB do Tivoli Workload Scheduler para z/OS, se voc estiver planejando em um ambiente ponto a ponto.

Copyright IBM Corp. 2000, 2003

49

Os parmetros so descritos na tabela a seguir.


Tabela 9. Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications. Parmetro -user appslogin -job jobspecs Descrio O nome de um usurio vlido do Oracle Applications (Apps login). Os atributos de job do Oracle Applications. H quatro atributos de job que devem ser especificados na seguinte ordem: v O nome de um mdulo do Applications utilizado para conectar-se ao Oracle Applications (por exemplo, FND). v Uma responsabilidade vlida para o mdulo do Applications (por exemplo, o Desenvolvedor de Aplicativos). Esse parmetro deve ser escrito entre aspas simples. v O nome de um aplicativo que registrou o job (por exemplo, PO). v O nome do job (por exemplo, POXACR). O nome do job deve ser escrito em letras maisculas. Por exemplo: -job FND Desenvolvedor de Aplicativo PO POXACR -prn printopts As duas opes de impressora para o job. Elas devem ser inseridas na seguinte ordem: v O nome da impressora (opcional). Se omitido, a impressora padro especificada no arquivo de opes ser utilizada. v O nmero de cpias. Por exemplo: -prn ps4 2

50

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 9. Parmetros da Cadeia de Tarefas para Jobs do Oracle Applications. (continuao) Parmetro [-vn (valor|null|:parmetro)] Descrio Os parmetros do job, se houver. Essa cadeia ser opcional se nenhum parmetro for especificado para o job no Oracle Applications. v n o nmero do parmetro (v1, v2, etc.). v Um dos seguintes: valor Um valor real. Escreva o valor entre aspas simples se ele possuir caracteres especiais.

:parmetro O nome de um parmetro do Tivoli Workload Scheduler j definido. Consulte o Tivoli Workload Scheduler Guia de Referncia para obter informaes adicionais sobre os parmetros do Tivoli Workload Scheduler. O mtodo de acesso incluir automaticamente todos os parmetros que voc no especificar na definio com um valor null. Estes so dois exemplos: -v4 abc -v15 :p1

Este um exemplo de uma especificao de cadeia de tarefas completa:


-user GLOBAL -job FND Desenvolvedor de Aplicativo PO POXACR -prn ps4 2 -v1 abc

Estados do Job do Tivoli Workload Scheduler e do Oracle Applications


Quando um job do Oracle Applications for ativado pelo Tivoli Workload Scheduler, voc poder monitorar seu andamento com o conman. A transio de estado no Tivoli Workload Scheduler e os estados do Oracle Applications correspondentes so listados a seguir.
Estados do Oracle Concurrent Manager Falha na Solicitao ou solicitao no Encontrada Inativo Pendente Pendente Normal Em Execuo Normal Concluda Normal Aviso de Concluso Concludo com Erro Concludo com Finalizao Concludo Cancelado Estados do Tivoli Workload Scheduler UT (tarefa no suportada) SUSP WAIT ADD EXEC SUCC SUCC ABEND ABEND ABEND

Captulo 7. Informaes de Definio do Job

51

Para obter informaes adicionais sobre o gerenciamento de job, consulte o Tivoli Workload Scheduler - Manual de Referncia.

52

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 8. Referncia do Arquivo de Opes MCMAGENT


Esta seo fornece informaes de referncia detalhadas sobre o arquivo de opes do IBM Tivoli Workload Scheduler para Aplicativos do Oracle e-Business Suite.

O Arquivo de Opes
Cada instncia instalada do mtodo de acesso do Oracle deve ter um arquivo de opes de correspondncia. Voc pode cri-lo durante ou depois da instalao do mtodo de acesso com o Editor de Opes (consulte Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27) ou com qualquer editor de texto comum. A conveno de nomenclatura de cada arquivo de opes deve ser <WORKSTATION_NAME>_MCMAGENT.opts e deve estar localizada no diretrio TWShome/methods. Se voc no criar um, o agente utilizar, por padro, o arquivo de opes globais chamado MCMAGENT.opts.

Sintaxe de Entrada
A tabela a seguir lista as opes para o mtodo de acesso MCMAGENT.
Tabela 10. Opes de MCMAGENT. Opo ORACLE_HOME ORACLE_SID Descrio O diretrio do Unix em que o software do Oracle foi instalado. O identificador do sistema Oracle da instncia do banco de dados ao qual est se conectando. Isso corresponde ao valor da varivel $ORACLE_SID do Oracle Applications. O diretrio do Unix em que o Oracle Applications est instalado. O diretrio FND top em que est localizada a Biblioteca de Objetos de Aplicativos. A definio da varivel PATH, incluindo, o caminho existente, o caminho para o diretrio bin do Oracle Applications, o caminho para o diretrio include no diretrio FND Top e outros, conforme necessrio. O arquivo de ambiente a ser executado. Cada instncia do Oracle Applications tem seu prprio arquivo de ambiente (APPLSYS.env ou APPDEMO.env). O nome do arquivo .env fornecido aqui ser utilizado para definir o ambiente dinamicamente quando o Tivoli Workload Scheduler executar jobs no Oracle Applications x-agent. Um id do usurio do banco de dados que tem acesso a todos os Mdulos no Oracle Applications. Ele deve ser capaz de ativar, gerenciar e finalizar jobs no Oracle Applications. A senha para o ID do usurio selecionado. Para obter o valor criptografado, use o utilitrio enigma enviado com o produto. Consulte Criptografando as Senhas de Usurios do Oracle Applications na pgina 54. O id da impresso padro.

ORA_APP_TOPDIR FND_TOPDIR PATH

ENV

USERID

PASSWORD

PRINTER_NAME

Copyright IBM Corp. 2000, 2003

53

Tabela 10. Opes de MCMAGENT. (continuao) Opo MIN_TIME Descrio O nmero de segundos a ser includo no intervalo de polling anterior, depois do qual a verificao do status do job deve ser executada. O nmero de segundos depois do qual o intervalo de polling no ser incrementado.

MAX_TIME

Todas as opes so exigidas e devem ser gravados uma por linha no formato:
OPTION=VALUE

sem espaos em branco.

Exemplo
O arquivo HP113_MCMAGENT.opts um arquivo de opes de amostra:
ORACLE_HOME=/general/ora716 ORACLE_SID=DEMO106 ORA_APP_TOPDIR=/apps106 FND_TOPDIR=$APPL_TOP/fnd/* PATH=$PATH:$ORACLE_HOME/bin:$FND_TOP/include ENV=$APPL_TOP/APPDEMO106.env USERID=APPS_US PASSWORD=APPS_US PRINTER_NAME=PRINTER1 MIN_TIME=10 MAX_TIME=200

Criptografando as Senhas de Usurios do Oracle Applications


Quando voc faz inseres no arquivo de opes, o valor de senha automaticamente criptografado, antes de ser gravado no arquivo. Se voc modificar o arquivo com um editor de texto, ser necessrio executar o programa enigma para criptografar a senha antes de grav-la no arquivo. Execute o programa enigma como descrito abaixo:
enigma [senha]

Voc pode incluir a senha na linha de comando ou inseri-la como resposta a um prompt. O programa retorna uma verso criptografada que pode se inserida no arquivo de opes.

54

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 3. Mtodo de Acesso do PeopleSoft

Copyright IBM Corp. 2000, 2003

55

56

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 9. Introduo
O IBM Tivoli Workload Scheduler para Aplicativos do PeopleSoft permite que voc execute e monitore os jobs do PeopleSoft a partir de um ambienteTivoli Workload Scheduler. Esses jobs podem ser executados como parte de um planejamento ou enviados para um processamento de job ad-hoc. Os jobs de agente estendido do PeopleSoft podem ter todas as dependncias e as opes de recuperao como outros jobs do Tivoli Workload Scheduler. Os jobs do PeopleSoft devem ser relatados no Tivoli Workload Scheduler para que sejam executados e controlados no ambiente Tivoli Workload Scheduler.

Recursos
v O agentes estendido para as verses 7.0, 7.5 e 8.x do PeopleSoft foram certificadas pelo PeopleSoft no Windows NT 4.0 com Service Pack 6 e no Windows 2000. v Suporte ao PeopleSoft 8.x. v Utilize as dependncias do job padro do Tivoli Workload Scheduler nos jobs do PeopleSoft. v Planeje os jobs do PeopleSoft para serem executados em dias e horas especificados e em uma ordem predeterminada. v Defina a interdependncia dos jobs do PeopleSoft e dos jobs do Tivoli Workload Scheduler executados em diferentes aplicativos, como o R/3 e o Oracle. v Defina a interdependncia dos jobs do PeopleSoft e dos jobs executados jobs em diferentes plataformas. v Personalize os cdigos de retorno de execuo do job.

Viso Geral Funcional


O Tivoli Workload Scheduler pode ativar e monitorar jobs no programador de processos do PeopleSoft, utilizando uma estao de trabalho de agente estendido. O agente estendido do PeopleSoft definido em uma definio de estao de trabalho do Tivoli Workload Scheduler padro. Essa definio um nome de estao de trabalho lgica e especifica o mtodo de acesso como psagent. O mtodo de acesso utilizado para comunicar solicitaes de job ao programador de processo do PeopleSoft. Para ativa um job do PeopleSoft, Tivoli Workload Scheduler executa o mtodo psagent, transmitindo as informaes sobre o job. Um arquivo de opes fornece o mtodo com o caminho, o executvel e outras informaes sobre o programador de processo do PeopleSoft e o servidor de aplicativos usado para ativar o job. O agente estendido pode acessar a tabela de solicitaes de processo do PeopleSoft e fazer uma entrada na tabela para ativar o job. O progresso do job e as informaes de status so gravadas no arquivo de lista padro do job.

Jobs do Programador de Processo do PeopleSoft


O programador de processo do PeopleSoft utiliza as entradas da tabela Solicitao de Processo (PSPRCSRQST) para orientar as decises de trabalho. Essas entradas descrevem os processos que o agente do servidor Programador de Processo ativar. Eles tambm contm as informaes necessrias para determinar o status do
Copyright IBM Corp. 2000, 2003

57

processo. O mtodo de acesso para o PeopleSoft pode inserir entrada, consultar o contedo e modificar as informaes de status nessa tabela(PSPRCSRQST). Ao documentar um job do PeopleSoft no Tivoli Workload Scheduler, o usurio est realmente definindo para que uma solicitao de processo seja inserida na tabela Solicitao de Processo (PSPRCSRQST). Uma solicitao de processo no Tivoli Workload Scheduler deve conter trs partes de dados vlidas: v Uma definio de processo tendo duas partes: Tipo de Processo Nome do Processo v Um ID do operador (desnecessrio na execuo no PeopleSoft 8.x) v Um ID de controle de execuo Todos esses itens so exigidos para que um job do PeopleSoft seja executado. O mtodo de acesso para o PeopleSoft atualiza diretamente a tabela PSPRCSRQST para o PeopleSoft 7.x (conexo de nvel 2), enquanto que para o PeopleSoft 8.x ele explora o servidor de aplicativo PeopleSoft por meio da interface exposta pela interface do componente PROCESSREQUEST (conexo de nvel 3). Observe que o programador de processo e o servidor de aplicativos executado no Unix e nas estaes de trabalho do Windows FTA, enquanto o agente estendido executado apenas no Windows NT ou no Windows 2000.

Rastreamento de Job do PeopleSoft no Tivoli Workload Scheduler


Um job no PeopleSoft uma coleo de processos que so executados juntos como uma nica unidade. Os jobs do Tivoli Workload Scheduler podem ser definidos de uma das seguintes formas: v Como jobs do PeopleSoft, isto , como uma coleo de processos do PeopleSoft. Nesse caso, o status do job do PeopleSoft rastreado e no o status de processos individuais dentro do job. v Como processos do PeopleSoft. Nesse casso, o status de um processo individual rastreado e os planejamentos do Tivoli Workload Scheduler podem ser definidos para criar interdependncias complexas e opes de recuperao entre os processos do PeopleSoft.

Segurana
A segurana para os jobs do PeopleSoft tratada por padro pela segurana do Tivoli Workload Scheduler.

Notas sobre o Suporte ao PeopleSoft verso 8.x


O suporte ao PeopleTools 8.x tem algumas alteraes que voc deve saber, se planejar utilizar o mtodo x-agent no seu ambiente. v A palavra-chave -operator utilizada nas especificaes de job do Tivoli Workload Scheduler e em seus parmetros de correspondncia so ignoradas atualmente pelo mtodo psagent e pelo tempo de execuo. Como conseqncia, os jobs sero enviados e executados com o mesmo ID do operador PS, usado para conexes com o PeopleSoft. Voc no deve alterar as definies de job do Tivoli Workload Scheduler, se desejar migrar do PeopleTools 7.x para o

58

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

PeopleTools 8.x. A diferena que todos os jobs enviados ao x-agent do PeopleSoft 8.x ser executado no mesmo ID especificado no arquivo <CPU_NAME>_psagent.opts. v No h necessidade de instalar a conectividade com o banco de dados no FTAs hospedando os agentes estendidos do PeopleSoft, pois o mtodo utiliza uma arquitetura de nvel 3 do PeopleSoft, atualmente. voc ter que configurar pelo menos um Servidor de Aplicativos PeopleSoft para que o agente estendido funcione. O Servidor de aplicativos deve ser ativado para que os jobs sejam enviados com sucesso para o programador de processo do PeopleSoft. v No ser necessrio carregar TVPUPSFT.dms no banco de dados do PeopleSoft 8.x ao trabalhar no modo de nvel 3. v Para o PeopleSoft 8.1x, o mtodo exige a instalao do suporte ao PeopleSoft External Api no FTA que est hospedando o mtodo de agente estendido. O diretrio de instalao da API externa utilizado durante os processo de instalao e configurao do agente estendido ao ser necessrio especificar o diretrio inicial do PeopleSoft ou o diretrio raiz do COBOL. Para instalar a API externa, utilize o executvel setup.exe localizado no diretrio de servidor de arquivos do PeopleSoft 8.1x, chamado: <PS_HOME>\setup\PsExtAPI. A instalao do PeopleSoft External API deve ser executada antes da instalao do Tivoli Workload Scheduler para Aplicativos. Verifique a instalao da API externa como orientado pelas instrues no PeopleSoft: utilizando a ferramenta jnitest.exe localizada no diretrio de instalao do PS External API. Ser necessrio reinicializar a estao de trabalho antes de utilizar a instalao do PsExtAPI com sucesso. Se houver falha na inicializao, voc ver uma janela pop-up no TVPUPSFT.exe, dizendo:
"Houve uma falha ao inicializar o aplicativo de forma adequada (0xc0000005). Clique em OK para finalizar o aplicativo."

Captulo 9. Introduo

59

60

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 10. Planejamento de Implementao


PeopleSoft Verso 7.5 ou Anterior
Esta seo descreve o planejamento de implementao para o agente estendido com o PeopleSoft 7.5 ou anterior.

Requisitos do Host
A estao de trabalho que hospeda o agente estendido exige os seguintes requisitos: v Ele deve ser um FTA (agente tolerante a falhas) do Tivoli Workload Scheduler ou um SA (agente padro) que execute uma verso suportada do Windows. v Ele deve ter acesso de rede ao banco de dados do PeopleSoft. v Ele deve ser capaz de se tornar uma estao de trabalho do PeopleSoft. v Ele deve ter acesso s bibliotecas de suporte do PeopleSoft e do COBOL. O suporte para COBOL deve ser compatvel com o compilador utilizado para o ambiente do programador de processo do NT.

Requisitos de Software
IBM Tivoli Workload Scheduler para Aplicativos do PeopleSoft exige os seguintes requisitos de software: v Windows NT 4.0 com Service Pack 6 ou Windows 2000 com service pack 2. v IBM Tivoli Workload Scheduler verso 7.0 ou posterior v PeopleSoft verso 7.0, 7.5 v Compilador PeopleSoft COBOL Notas: 1. O agente estendido para as verses 7.0 e 7.5 do PeopleSoft est disponvel no MicroFocus NetExpress 2.1 e no MicroFocus NetExpress 3.1. 2. O agente estendido para o PeopleSoft, verso 7.0, tambm foi compilado com o Micro Focus COBOL workbench Compiler, verso 4.1 3. Para o Peoplesoft verses 7.x, necessrio recompilar o programador de processo do Peoplesoft para Windows se voc estiver usando-o para os jobs gerenciados com o Tivoli Workload Scheduler.

Instalao para Usurio do Windows


v Crie um ID do usurio local ou de domnio com autoridade para acessar o software PeopleSoft e Tivoli Workload Scheduler ou para instalar o usurio existente para permitir o acesso ao software PeopleSoft e ao Tivoli Workload Scheduler. Consulte Configurao do Usurio para Windows na pgina 65 para obter detalhes. v Efetue logon como o novo usurio. v Conecte-se s unidades apropriadas para o PeopleSoft. Certifique-se de selecionar Reconectar no Logon. A letra da unidade deve ser a mesma que foi especificada como PSDRIVE em psagent.opts. v Execute a instalao do PeopleSoft. Siga as instrues fornecidas no software do PeopleSoft.

Copyright IBM Corp. 2000, 2003

61

Verificando o Ambiente PeopleSoft


Certifique-se de que o ambiente PeopleSoft esteja configurado corretamente e que os jobs do PeopleSoft possam ser executados com sucesso pelo programador do processo. Notas: 1. Verifique a conectividade dos bancos de dados para os bancos de dados do PeopleSoft utilizando o ID do Usurio do Windows criado anteriormente. Conexo pode ser verificada com a execuo de um comando de banco de dados, usando qualquer utilitrio ODBC. 2. Verifique o acesso ao servidor de arquivos do Peoplesoft ou a disponibilidade da cpia local dos executveis.

Criando um ID de Processamento de Batch no PeopleSoft


Voc deve criar um ID do operador no PeopleSoft dedicado ao planejamento do batch. Todos os jobs enviados pelo Tivoli Workload Scheduler devem usar esse ID do operador.

Arquivos Instalados
Os seguintes arquivos so instalados no Tivoli Workload Scheduler e em diretrios do PeopleSoft durante a instalao do Tivoli Workload Scheduler para Aplicativos:
Destino TWShome \methods\PeopleSoft Arquivos v TVPUPSFT7xx.dms, em que xxespecifica o release do PeopleSoft, verso 7. v PTCUDCOP.cbl TWShome\methods v psagent.exe v enigma.exe <PSDRIVE_PSVER>\cblbin v TVPUPSFT.exe v TVPUPSFT.gnt Usurio Tivoli Workload Scheduler Proprietrio do PTPUPRCS.exe Proprietrio Usurio Tivoli Workload Scheduler

Nota: TWShome indica o nome do diretrio em que o Tivoli Workload Scheduler foi instalado.

PeopleSoft Verso 8.x


Esta seo descreve o planejamento de implementao para o agente estendido com o PeopleSoft verso 8.x.

Requisitos do Host
A estao de trabalho que hospeda o agente estendido deve ser um agente do Tivoli Workload Scheduler tolerante a falhas ou um agente padro em uma plataforma Windows suportada. Se seu site tiver vrios servidores de processo para um nico banco de dados do PeopleSoft, ser possvel configurar ou estender uma estao de trabalho do agente estendido (usando vrios arquivos de opes) para processar jobs em vrios servidores de processo.

62

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Requisitos de Software
IBM Tivoli Workload Scheduler para Aplicativos do PeopleSoft exige os seguintes requisitos de software: v Windows NT 4.0 com Service Pack 6 ou Windows 2000 com service pack 2. v IBM Tivoli Workload Scheduler verso 7.0 ou superior. v PeopleSoft verso 8.1x ou 8.4x. v Para o PeopleSoft verso 8.1x: PeopleTools External APIs verso 8.1x. v Para o PeopleSoft verso 8.4x: acesso ao PeopleSoft File Server 8.4x ou disponibilidade de uma cpia local dos executveis.

Criando um ID de Processamento de Batch no PeopleSoft


Voc deve criar um ID do operador no PeopleSoft dedicado ao planejamento do batch. O ID do operador deve conceder autoridade para utilizar a Interface do componente no ambiente PeopleTools. Todos os jobs enviados pelo IBM Tivoli Workload Scheduler devem usar esse ID do operador.

Arquivos Instalados
Os seguintes arquivos so instalados no IBM Tivoli Workload Scheduler e em diretrios do PeopleSoft durante a instalao do IBM Tivoli Workload Scheduler para Aplicativos do PeopleSoft:
Destino TWShome\methods Arquivos v psagent.exe v enigma.exe PSAPI_dir TVPUPSFT.exe Proprietrio Usurio Tivoli Workload Scheduler Usurio Tivoli Workload Scheduler

Nota: TWShome indica o nome do diretrio em que o Tivoli Workload Scheduler foi instalado.

Captulo 10. Planejamento de Implementao

63

64

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 11. Tarefas de Ps-Instalao


Este captulo descreve tarefas importantes que devem ser feitas aps a instalao do mtodo de acesso.

Configurao do Usurio para Windows


Quando um cliente PeopleSoft utilizado para enviar jobs com o IBM Tivoli Workload Scheduler para Aplicativos do PeopleSoft no ambiente de nvel trs, usando um compartilhamento em um servidor de arquivos PeopleSoft, o streamlogon especificado no envio do job deve ser conhecido no cliente que enviou e no servidor de arquivos PeopleSoft. Ele tambm deve ser: v Um usurio de domnio v Um usurio local definido no cliente e no servidor de arquivos PeopleSoft com o mesmo nome e a mesma senha. O usurio deve ento ser definido no banco de dados do Tivoli Workload Scheduler. Se essa condio no for atendida, os seguintes sintomas sero produzidos: v Jobs sero classificados como abend v Duas mensagens de erro do sistema operacional sero enviadas para a stdlist do job, dizendo:
Falha no logon: nome de usurio desconhecido ou senha incorreta. procwork.cpp(328): O canal foi finalizado.

O usurio deve fazer parte do Grupo do Administrador no cliente PeopleSoft. Se essa condio no for atendida, os seguintes sintomas sero produzidos: v Os jobs iro para o estado INTRO (e um sinal de adio + ser includo para indicar um job ativo) v Uma janela popup ser exibida na estao de trabalho do Tivoli Workload Scheduler que hospeda o agente estendido, como o ttulo psagent.exe - Erro de Aplicativo, dizendo:
Houve uma falha ao inicializar o aplicativo de forma adequada (0xc0000005). Clique em OK para finalizar o aplicativo.

v Depois de clicar no boto OK os jobs iro para o estado abend, e a stdlist do job mostrar somente o banner do programa JOBLNCH.

Criando o Arquivo de Opes


Os arquivos de opes de agente estendido do PeopleSoft especificam, entre outros itens, o usurio do banco de dados com o qual o mtodo se conecta ao banco de dados do PeopleSoft. Eles tambm so usados para especificar a taxa de polling para o mdulo do PeopleSoft para verificao do status do job. Esse arquivo deve estar localizado no computador do host para o agente estendido no diretrio TWShome\methods. Para criar um arquivo de opes voc pode utilizar o Editor de Opes disponvel com esse produto ou qualquer outro editor de texto. Consulte Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 para obter detalhes sobre a criao ou a edio de arquivos de opes com o Editor de Opes e

Copyright IBM Corp. 2000, 2003

65

Editando Manualmente os Arquivos de Opes na pgina 68 para obter exemplos de arquivos de opes para esse mtodo de acesso. A tabela a seguir descreve as opes para o mtodo de acesso psagent:
Tabela 11. Opes Psagent. Opo LJuser Descrio O ID de um usurio do Windows que ativa os jobs do IBM Tivoli Workload Scheduler. Esse usurio do Windows deve ser um usurio vlido do Tivoli Workload Scheduler na estao de trabalho do host. O ID de um usurio do Windows que executa um arquivo de verificao. O valor padro deve corresponder ao valor de Usurio de Ativao do Job. O intervalo de tempo entre as verificaes do status ao monitorar a solicitao do processo. O valor padro 2 minutos. Utilize a opo CheckIntervalUnits para alterar de minutos para segundos. Especifica que o Intervalo de Verificao do Status est em segundos (valor=1) em vez de estar em minutos (valor=60). Um valor de 1 ativa a execuo de rastreamento. Um valor de 0 desativa essa execuo. A letra da unidade do Windows para os arquivos do PeopleSoft (por exemplo, N:). O diretrio inicial para os arquivos do PeopleSoft (por exemplo, \PT7.5 ou \PT8) para todas as verses do PeopleSoft, exceto 8.1x. Nesse caso, o diretrio em que o arquivo TVPUPSFT.exe est instalado (por exemplo, \PT817\bin\client\winx86_extapi) Para o PeopleSoft 7.x: o caminho para o diretrio de base para as bibliotecas do Micro Focus COBOL (por exemplo, N:\PT7.5). Para o PeopleSoft 8.x: o caminho para o diretrio de base para o PeopleSoft External APIs. Ele o mesmo que o Diretrio inicial do PeopleSoft.

CFuser

CheckInterval

CheckIntervalUnits PSXA_TRACE PSDRIVE PSVER

COBROOT

66

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 11. Opes Psagent. (continuao) Opo CONNECT Descrio Uma cadeia que contm as seguintes entradas: Tipo de conexo O tipo do sistema PeopleSoft RDBMS. Escolha um dos exemplos a seguir: v APPSERV (PeopleSoft 8.x apenas) v ORACLE v MICROSFT (Microsoft SQL Server) v DB2 (DB2 para MVS) v DB2UNIX v SQLBASE v DB2ODBC v DB2400 v INFORMIX v SYBASE v DB2MDI Nome do servidor de banco de dados O Nome do servidor de banco de dados. Esse para Informix e Sybase apenas. No utilizado para o PeopleSoft verso 8.x. Nome do servidor O nome do servidor (endereo IP) especificado como Tipo de conexo. Para APPSERV, essa entrada deve ser o endereo IP:porta TCP ou o nome IP. Voc pode especificar vrias entradas desde que estejam separadas por vrgulas. ID do Operador O ID do operador para conexo com o banco de dados do PeopleSoft. v Para o PeopleSoft verso 7.x, todos os jobs no sero executados como esse ID, mas como o ID especificado na definio do job do Tivoli Workload Scheduler. v Para o PeopleSoft verso 8.x, todos os jobs sero executados como esse ID. Senhas do operador A senha criptografada para o ID do operador. Se utilizar um editor comum para gravar os arquivos de opes, voc dever utilizar primeiro a ferramenta Enigma para criptograf-lo. Se voc utilizar o Editor de Opes, ele far isso para voc. Servidor de processo padro O servidor de processo padro que executa jobs no PeopleSoft. As entradas so separadas por barras (/), para que a cadeia esteja neste formato item1/item2/.../item6 e devem ser listadas na seqncia exibida nessa explicao. Todas as entradas so obrigatrias com exceo do Nome do servidor de banco de dados.
Captulo 11. Tarefas de Ps-Instalao

67

Tabela 11. Opes Psagent. (continuao) Opo Descrio

TWSXA_PT84_JVMPATH O caminho para a Java Virtual Machine. Essa opo est disponvel para ser utilizada somente pelo PeopleTools verso 8.4x. UTF8cmdline Se definido para 0, significa que o mtodo de agente estendido espera que o Tivoli Workload Scheduler envie os dados necessrio para ativar o job na pgina de cdigo local. Caso contrrio, ele espera que os dados estejam no formato UTF8. O valor padro 1 (por exemplo, formato UTF8). A pgina de cdigo que o mtodo de agente estendido utiliza ao se comunicar com o aplicativo externo. Se a opo estiver ausente ou se tiver um valor invlido, a pgina de cdigo local ser utilizada. A pgina de cdigo que o mtodo de agente estendido utiliza para gerar a sada padro. Se a opo estiver ausente ou se tiver um valor invlido, a pgina de cdigo local ser utilizada. O idioma que o mtodo de agente estendido utiliza para a sada padro (isto , o catlogo de mensagens especificado ser aberto). Se a opo estiver ausente ou se tiver um valor invlido, o idioma local ser utilizado. No suportado para o agente estendido do PeopleSoft.

TWSXA_CP

TWSMETH_CP

TWSMETH_LANG

TWSXA_LANG

Os nomes de opo fazem distino entre maisculas e minsculas e devem ser escritos como mostrado na coluna esquerda da tabela 11. Antes de utilizar o arquivo de opes criado manualmente, verifique se todos os nomes de opo esto escritos corretamente. As opes que no estiverem de acordo sero ignoradas.

Editando Manualmente os Arquivos de Opes


Alm do Editor de Opes, voc pode utilizar qualquer editor comum para criar ou alterar manualmente um arquivo de opes. Abaixo esto dois arquivos de opes de exemplo. Esses exemplos vo ajud-lo a determinar os requisitos especficos do site. Seu arquivo de opes pode ser diferente dos arquivos abaixo. Lembre-se de salvar o arquivo no diretrio TWShome\methods

Exemplo para o PeopleSoft 7.x


LJuser=TwsUsr CFuser=TwsUsr PSDRIVE=N: PSVER=\PS750 COBROOT=N:\PS750 CONNECT=ORACLE/HR75/PSUSA/#oqola4O7lxp5refgbAreV/PSNT CheckInterval=15 CheckIntervalUnits=1 PSXA_TRACE=0

Exemplo para PeopleSoft 8.1x


LJuser=TwsUsr CFuser=TwsUsr CheckInterval=15 PSDRIVE=D:

68

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

PSVER=\pt81x\bin\client\winx86_extapi COBROOT=D:\pt81x\bin\client\winx86_extapi CONNECT=AppServ/PSOFT81X:9000/PSDEV/jp5l83nlWe7wh5jxk46qeV/PSUNX CheckIntervalUnits=1 PSXA_TRACE=1

Conectando Mais de um Banco de Dados do PeopleSoft


Pode ser necessrio que o mtodo psagent conecte-se a mais de um banco de dados do PeopleSoft. Por exemplo, uma instalao simples do PeopleSoft pode ter um ambiente TEST, DEMO e PRODUCTION, cada um com um banco de dados separado. Isso requer que o mtodo psagent utilize uma cadeia de conexo separada para cada banco de dados. Para suportar isso, voc pode configurar vrias estaes de trabalho de agente estendido do PeopleSoft que se conectam ao mesmo mtodo mas utilizam arquivos de opes diferentes. Quando uma estao de trabalho inicia o mtodo, ela procura primeiro o arquivo de opes com o nome da estao de trabalho de agente estendido includo no psagent.opts. Por exemplo, um agente estendido do PeopleSoft chamado jupiter ter o seguinte arquivo de opes:
jupiter_psagent.opts

O mtodo psagent pesquisa primeiro um arquivo de opes com o nome da estao de trabalho de agente estendido e depois pelo arquivo padro psagent.opts. Isso permite que o usurio configure o agente estendido para cada banco de dados do PeopleSoft. Para conectar-se a apenas um banco de dados, utilize o nome padro para o arquivo de opes psagent.opts.

Configurando o Ambiente PeopleSoft para a Verso 7.5 ou Anterior


A seo a seguir explica como configurar o ambiente PeopleSoft se voc estiver utilizando o agente estendido com o PeopleSoft verso 7.5 ou anterior.

Personalizando o Servidor de Processo


Independentemente do tipo do sistema operacional em que voc est planejando os jobs do Tivoli Workload Scheduler, necessrio personalizar o executvel do servidor de processo correspondente utilizando a fonte COBOL PTCUDCOP.cbl fornecida pela IBM. Voc deve substituir o arquivo PTCUDCOP.cbl fornecido pelo PeopleSoft pelo arquivo equivalente fornecido pela IBM e compilar o programador de processo novamente. Orientao completas sobre como compilar o programador de processo novamente podem ser encontradas no manual de instalao do PeopleSoft. Ao receber os patches do PeopleSoft, voc ter que repetir o processo de personalizao do servidor de processo, se o arquivo PTCUDCOP.cbl for substitudo durante a instalao do patch. A seguir esto as explicaes sobre como executar as etapas de personalizao no Windows e no UNIX.

Personalizando no Windows
Se o programador de processo do PeopleSoft estiver em execuo no Windows, consulte a seo Configurando o Ambiente Batch no Windows NT/2000 no
Captulo 11. Tarefas de Ps-Instalao

69

manual de instalao do PeopleSoft para obter informaes atualizadas. Voc deve ter instalado um compilador COBOL no servidor batch e compilado dessa localizao. O computador que executa a compilao deve ter um compilador COBOL instalado e deve ter de gravar o acesso ao servidor de arquivos. Para criar o servidor de processo em um computador com o Windows: 1. Abra uma janela do prompt de comando do DOS. 2. Configure duas variveis de ambiente, PS_HOME e COBROOT, no computador no qual est planejando compilar o COBOL. Use estes comandos:
set PS_HOME=n:\PS750 set COBROOT=c:\netexpress\base

3. Certifique-se de que o diretrio de compilao c:\temp\compile exista; ele j pode estar presente se voc tiver executado CBLBLD.BAT. Se ele existir, remova quaisquer arquivos existentes l, apenas por precauo. Se ele no existir, ser necessrio cri-lo com o seguinte comando:
mkdir c:\temp\compile

Nota: Certifique-se de ter permisses de gravao para o diretrio de compilao pois o processo de compilao ocorrer nesse local. 4. Altere para o diretrio <PS_HOME>\setup. 5. Execute o seguinte comando para copiar todos os arquivos de origem COBOL do diretrio <PS_HOME> para o diretrio de compilao:
cblsrc <source directory> <compilation directory>

em que <source directory> a unidade e o diretrio em que o arquivo de origem est (deve ser o mesmo que <PS_HOME>) e<compilation directory> a unidade e o diretrio para o qual os arquivos de origem sero copiados. Por exemplo, o seguinte comando pegar os arquivos de origem COBOL do <PS_HOME> e copiar todos os arquivos necessrios para o local em que o processo de compilao ocorrer.
cblsrc <PS_HOME> c:\temp\compile

6. Copie o arquivo PTCUDCOP.cbl fornecido pela IBM para o diretrio de compilao com o seguinte comando:
copy <TWS_HOME>\PeopleSoft\PTCUDCOP.cbl c:\temp\compile

7. Depois de concluir o CBLSRC, altere o diretrio atual para o diretrio de compilao com o seguinte comando:
cd c:\temp\compile

8. Compile utilizando o seguinte comando:


CBLMAKE.BAT PTPUPRCS EXE LIST

Se houver algum problema de compilao, analise o arquivo PTPUPRCS.lis para obter detalhes e tente executar o comando depois de solucionar os problemas. 9. Depois de concluir o CBLMAKE.BAT, copie os arquivos EXE, GNT ou INT para o diretrio <PS_HOME>\cblbin, utilizando os seguintes comandos:
copy PTPUPRCS.exe <PS_HOME>\cblbin copy PTPUPRCS.gnt <PS_HOME>\cblbin

Personalizando no UNIX
Se o programador de processo do PeopleSoft estiver em execuo no UNIX, consulte a seo Configurando o Ambiente Batch no UNIX no manual de instalao do PeopleSoft para obter informaes atualizadas. Voc deve ter

70

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

instalado um compilador COBOL no servidor batch e executado a compilao dessa localizao. O computador que executa a compilao deve ter um compilador COBOL instalado e deve gravar o acesso ao diretrio <PS_HOME>/cblbin. Para criar o servidor de processo em uma mquina com o UNIX: 1. Efetue logon no servidor UNIX. 2. Altere o diretrio atual para o diretrio inicial do PeopleSoft. 3. Execute o script psconfig.sh. 4. Altere os diretrios para o diretrio $PS_HOME/src/cbl. 5. Renomeie o PTCUDCOP.cbl para PTCUDCOP.old utilizando o seguinte comando:
mv PTCUDCOP.cbl PTCUDCOP.old

6. Copie o PTCUDCOP.cbl do agente estendido (twshome/PeopleSoft) utilizando o FTP. 7. Execute os seguintes comandos:
cd ../../install pscbl.mak PTPUPRCS LIST

8. Depois da concluso do script, verifique os diretrios de destino para os arquivos criados recentemente em
<PS_HOME>/src/cbl/int <PS_HOME>/src/cbl/lst <PS_HOME>/cblbin

Eles devem ter um comprimento maior que zero bem como data e hora atuais. Se houver algum problema durante a compilao, analise o arquivo PTPUPRCS.lis para verificar os erros, corrija-os e tente executar a etapa de compilao novamente.

Configurando o Cliente
Para executar o mtodo de acesso do PeopleSoft para o ambiente PeopleTools 7.x, voc tem que executar em um ambiente PeopleSoft de nvel 2, utilizando uma estao de trabalho com conectividade adequada para o banco de dados. Voc deve instalar um software cliente para o banco de dados de sua escolha na estao de trabalho que hospeda o agente estendido e configur-lo para comunicaes adequadas ODBC. Teste a conectividade utilizando ferramentas de teste ODBC fornecidas com o software cliente (por exemplo, teste ODBC 32bit para Oracle). Voc precisa acessar o Servidor de Arquivos do PeopleSoft. Mapeie o compartilhamento do servidor de arquivos para uma unidade de rede na estao de trabalho Windows. Para uma instalao de estao de trabalho para um ambiente PeopleSoft 7.x: 1. Acesse \\<fileserver>\<share> como a unidade compartilhada <d>: no seu computador. 2. Defina PS_HOME para o diretrio adequado na nova unidade compartilhada, utilizando este comando:
set PS_HOME=<d>:\PS750

3. Execute:
%PS_HOME%\bin\CLIENT\WINX86\pscfg.exe
Captulo 11. Tarefas de Ps-Instalao

71

4.

Uma janela de configurao, como aquela mostrada em Figura 23, exibida. Selecione a guia Client Setup e preencha os valores necessrios, certificando-se de ter selecionado a caixa de opes Install PeopleSoft ODBC Driver. Se voc estiver executando o SQL Server, ser necessrio selecionar a caixa de opes Install ODBC Driver Manager 3.0. Nota: O sinalizador Install PeopleSoft ODBC Drive instala um nome de origem de dados do usurio. Se voc precisar acessar a origem de dados de outro perfil de usurio, voc ter que criar uma origem de dados correspondente, utilizando Control Panel-> ODBC (Data Source) na mquina com o WinNT/2000 ou executar novamente a etapa de personalizao para todos os outros usurios que deseja utilizar para enviar jobs de agente estendido do Tivoli Workload Scheduler.

Figura 23. Janela Configurao do Manager 7.5.

Depois da concluso, voc dever ter no menu Iniciar/Programas um novo item rotulado PeopleSoft 7.5.

72

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Executando o Script do Data Mover


Depois da concluso da instalao, o PeopleSoft Data Mover utilizado para mover os procedimentos armazenados para o agente estendido do PeopleSoft no local. Para obter informaes adicionais sobre o script do Data Mover, consulte a documentao do Peoplesoft. 1. Clique no cone do DataMover no grupo PeopleSoft. A janela Peoplesoft Signon exibida.

Figura 24. Janela PeopleSoft Signon.

2. Selecione o banco de dados apropriado e clique em OK. A janela de logon do PeopleSoft exibida. 3. Preencha os campos de logon e clique em OK. A janela do Data Mover exibida. 4. No menu File na janela do Data Mover, selecione o comando Open. Abra o seguinte arquivo na janela do Data Mover:
TWShome\PeopleSoft\TVPUPSFT.dms

5. Assim que carregar os scripts na janela do Data Mover, execute-os. A janela do Data Mover divida em duas partes. A seo superior mostra as instrues do script do Data Mover. A parte inferior mostra o status das instrues do script, conforme so executados. 6. Verifique se o script est sendo executado com sucesso.

Captulo 11. Tarefas de Ps-Instalao

73

Figura 25. Janela DataMover

Se houver falha nas instrues, verifique se os valores da janela de inicializao, Nome do Banco de Dados, ID de Login e Senha, esto corretos e repita o processo. Se o script do Data Mover continuar a falhar, consulte o DBA para determinar se h algum problema no banco de dados. Nota: O script do Data Mover deve ser executado em cada banco de dados que o agente estendido para PeopleSoft ir utilizar. Para executar os scripts em outro banco de dados, altere o nome do banco de dados e/ou RDBMS na seqncia de login.

Configurando o Ambiente PeopleSoft para Verso 8.1x


A seo a seguir explica como configurar o ambiente PeopleSoft se voc estiver utilizando o agente estendido com o PeopleSoft verso 8.1x.

Personalizando o Servidor de Aplicativos


O mtodo de acesso que suporta o PeopleTools 8.1x pode funcionar somente em conjunto com a arquitetura de nvel 3 doPeopleSoft. Isso implica que voc precisar implementar a arquitetura de nvel 3 de PeopleSoft de acordo com as instrues do PeopleSoft. Enquanto necessrio uma implementao completa da arquitetura do PeopleSoft com pelo menos um servidor de aplicativo e um servidor de processo do PeopleSoft, esse procedimento reduz os requisitos de software e as dependncias na estao de trabalho de agente estendido. No h necessidade de instalar a conectividade do banco de dados na estao de trabalho que hospeda o agente estendido. Alm disso, no h requisitos de personalizao para o servidor de processo, como era para o PeopleTools verso 7.x, e no haver a necessidade de executar scripts do Data Mover adicionais para a personalizao do banco de dados. O servidor de aplicativos deve ser ativado para que os jobs sejam enviados com sucesso para o programador de processo do PeopleSoft. Para configurar adequadamente o mtodo de acesso, voc precisar obter as seguintes informaes do administrador do PeopleSoft:

74

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v Nome do host (ou endereo IP) do servidor de aplicativos v Porta Jolt do servidor de aplicativos (normalmente 9000) v Nome do servidor de processo O ID do operador deve conceder autoridade para utilizar a Interface do componente no ambiente PeopleTools.

Configurando o Cliente
Para executar o agente estendido com o ambiente PeopleTools 8.1x, necessrio instalar o suporte ao PeopleSoft External API na estao de trabalho do Tivoli Workload Scheduler que hospeda o agente estendido. A instalao do PeopleSoft External API deve ser executada antes da instalao do Tivoli Workload Scheduler para Aplicativos para PeopleSoft. O manual de instalao do PeopleSoft contm informaes sobre essa etapa da instalao. Consulte a documentao adequada do PeopleSoft para obter instrues atualizadas, dependendo da verso real do PeopleSoft. Para o PeopleTools 8.17 voc dever chamar o executvel setup.exe localizado no diretrio do servidor de arquivos do PeopleSoft 8, chamado %PS_HOME%\setup\PsExtAPI. Anote o diretrio em que voc instalou o External API, pois ele ser necessrio durante a instalao do agente estendido e durante a configurao, quando dever informar o diretrio PSHome ou quando ser perguntado sobre o diretrio raiz COBOL. Antes utilizar o External API, verifique a instalao como orientado pelas instrues do PeopleSoft, utilizando a ferramenta jnitest.exe localizada no diretrio do External API. A ferramenta jnitest.exe verifica se voc possui o MicroSoft Java Virtual Machine para Java 3.2 verso 5.00.3167 ou superior. Se jnitest.exe encontrar a verso aceitvel, o MicroSoft Java Virtual Machine poder ser carregado. Caso contrrio, voc ter dificuldade para carreg-lo adequadamente. O External API no funcionar a menos que a verso correta do MicroSoft Java Virtual Machine esteja presente. Ser necessrio reinicializar a estao de trabalho antes de utilizar a instalao do PeopleSoft External API, com sucesso. Se houver falhas nesse procedimento, sempre que o job do PeopleSoft for enviado por meio do ITWS, uma janela popup do VPUPSFT.exe ser exibida, dizendo:
"Houve uma falha ao inicializar o aplicativo de forma adequada (0xc0000005). Clique em OK para finalizar o aplicativo."

Configurando o Ambiente PeopleSoft para a Verso 8.4x


Para o PeopleTools verso 8.4x, no h mais uma instalao separada do PeopleSoft External APIs, que era fornecido como parte do cliente Windows padro; ele pode ser acessado por meio do servidor de arquivos do PeopleSoft no diretrio chamando PS_HOME\bin\client\winx86. Adicionalmente, de acordo com o ID de Resoluo do PeopleSoft 704309, voc deve: v Ser capaz de acessar o diretrio chamado PS_HOME\class contendo o arquivo psjoa.jar. v Ter acesso a uma JVM (Java Virtual Machine) vlida.

Captulo 11. Tarefas de Ps-Instalao

75

Nota: A JVM fornecida com esse produto no vlida para esse propsito. Voc deve utilizar uma JVM suportada pelo PeopleSoft. O mtodo psagent.exe tomar conta das variveis de ambiente de definio/atualizao CLASSPATH e PS_HOME se elas no forem definidas no ambiente em que o job ativado. Se o ambiente do caminho de sistema contiver um acesso vlido para jvm.dll, ento voc poder precisar de uma configurao de ambiente adicional. Caso contrrio, voc deve especificar uma nova opo no arquivo psagent.opts com um editor de texto, para que o psagent.exe possa atualizar o caminho para o local em a JVM est. Para fazer isso, inclua a seguinte linha no arquivo de opes:
TWSXA_PT84_JVMPATH=<path to jvm.dll>

As JVMs vlidas so fornecidas pelo PeopleSoft com os servidores de aplicativo que suportam a arquitetura PIA, como BEA WebLogic Server (no subdiretrio jdk131\jre\bin\classic ou jdk131\jre\bin\hotspot) ou IBM WebSphere Application Server (no subdiretrio Java13\jre\bin\classic). Por exemplo, voc pode atualizar o arquivo de opes com: v TWSXA_PT84_JVMPATH=D:\Program Files\IBM\Java13\jre\bin\classic v TWSXA_PT84_JVMPATH=D:\bea\jdk131\jre\bin\classic v TWSXA_PT84_JVMPATH=D:\bea\jdk131\jre\bin\hotspot Se voc no tiver essa palavra-chave ou se no tiver um caminho de sistema vlido para jvm.dll, voc ver uma destas mensagens: v AWS140020078E Exceo obtida no arquivo TVPUPSFT.cpp(#) durante funo Principal v AWS140020076E O problema encontrado pode estar listado s definies do ambiente:
verifique o seguinte: 1) Seu caminho contm um diretrio vlido da Java Virtual Machine ou o arquivo de opes contm TWSXA_PT84_JVMPATH 2) A varivel de ambiente CLASSPATH contm uma caminho vlido para psjoa.jar 3) O servidor de aplicativo de destino est ativo e em execuo 4) Voc definiu a varivel de ambiente PS_HOME

76

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 12. Definindo os Jobs do PeopleSoft


Este captulo fornece informaes sobre a definio do job, utilizando o agente estendido para o PeopleSoft.

Criando Definies de Job do Peoplesoft no Tivoli Workload Scheduler


As definies de job do Tivoli Workload Scheduler so necessrias para cada job do Peoplesoft que voc pretende controlar. Um job do Tivoli Workload Scheduler est associado ao job do Peoplesoft definido, e a s suas definies incluem: v Nome do job v Nome do proprietrio v Especificaes do arquivo de script v Opes de recuperao Consulte Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37 para obter referncia.

Parmetros de Cadeia de Tarefas para Jobs do PeopleSoft


Esta seo descreve os parmetros da cadeia de tarefas que regem a execuo de jobs do PeopleSoft. Voc deve especific-los nos seguintes locais ao definir os jobs do Tivoli Workload Scheduler associados: v No campo Comando da pgina Tarefas da janela Propriedades - Definio do Job, se estiver usando o Job Scheduling Console. v Como argumentos da palavra-chave nome_do_script na instruo de definio do job, se estiver usando a linha de comando do Tivoli Workload Scheduler. v Como argumentos da palavra-chave JOBCMD na instruo JOBREC no SCRIPTLIB do Tivoli Workload Scheduler para z/OS, se voc estiver planejando em um ambiente ponto a ponto. Observe que nesse caso a cadeia inteira, seguindo a palavra-chave JOBCMD, deve ser escrita entre aspas duplas. A tabela a seguir lista os parmetros.
Tabela 12. Parmetros da Cadeia de Tarefas para Jobs do PeopleSoft. Parmetro -operator -process -type Descrio O ID do operador do PeopleSoft que ativa o job. O nome do processo para o job do PeopleSoft. O tipo de processo para o job do PeopleSoft. Essa entrada deve ser escrita entre aspas simples. O ID de controle de execuo para o PeopleSoft. O destino da sada do job do PeopleSoft. Verso do PeopleTools 7.x, 8.1x 7.x, 8.1x, 8.4x 7.x, 8.1x, 8.4x

-runcontrol -outputdest

7.x, 8.1x, 8.4x 8.1x, 8.4x

Copyright IBM Corp. 2000, 2003

77

Tabela 12. Parmetros da Cadeia de Tarefas para Jobs do PeopleSoft. (continuao) Parmetro -outputtype Descrio O tipo de sada do job do PeopleSoft. Os valores vlidos so: 0 (qualquer um) 1 (Nenhum) 2 (Arquivo) 3 (Impressora) 4 (Janela) 5 (E-mail) 6 (Web) 7 (Padro) O formato de sada do job do PeopleSoft. Os valores vlidos so: Nenhum CSV DOC Padro HP HTM LPOTHERPDFPS RPT RTF SPF TXT WKS XLS O programador de processo do PeopleSoft envolvido no processamento do job do PeopleSoft. O nome da pasta de relatrio utilizada para esse job. A pasta deve ter sido criada com o uso do PeopleSoft Report Manager. Verso do PeopleTools 8.1x, 8.4x

-outputformat

8.1x, 8.4x

-runlocationdescr

8.1x, 8.4x

-foldername

8.4x

Nota: Nenhuma verificao de sintaxe executada nos valores de controle de sada (outputdest, outputtype, outputformat e foldername). Se os valores no forem reconhecidos, os padres sero utilizados. Este um exemplo de uma especificao de cadeia de tarefa completa para um job do Peoplesoft 8.1x:
-operator PS -process XRFWIN -type SQR Report -runcontrol 1 -runlocationdescr PSNT

Configurando o Opens Dependencies 7.x Apenas


Voc pode configurar as dependncias abertas do Tivoli Workload Scheduler nos jobs do PeopleSoft. As dependncias abertas do Tivoli Workload Scheduler so mapeadas para o comando select count do SQL com uma clusula where no banco de dados do PeopleSoft. O SQL verifica basicamente se os valores selecionados existem no banco de dados. Se as entradas especificadas existirem no banco de dados, a conta ser retornada com um valor e o job ser executado. Se as entradas especificadas no existirem no banco de dados, a conta ser retornada com um 0 e o job no poder ser executado. Um resultado de zero falso; qualquer outro valor verdadeiro.

78

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Nota: Ao criar a dependncia aberta no Console de Planejamento do Job, a tabela listada abaixo da caixa de texto do arquivo e a coluna e os dados so listados como qualificadores na caixa de texto dos qualificadores. Por exemplo:
opens /PSSERVERSTAT

resulta no seguinte comando do SQL:


select count(*) from PSSERVERSTAT;

Isso retorna uma conta das linhas em PSSERVERSTAT. Um resultado de zero falso; qualquer outro valor verdadeiro. Outro exemplo :
opens /PSSERVERSTAT ("SERVERNAME = PSNT AND SERVERSTATUS = 3")

Isso resulta no seguinte comando do SQL:


select count(*) from PSSERVERSTAT where SERVERNAME = PSNT AND SERVERSTATUS = 3;

Isso retorna uma conta das linhas no PSSERVERSTAT para o servidor PSNT em que o status (em execuo). Para configurar as dependncias abertas em um job: 1. Edite o fluxo do job no qual deseja incluir uma dependncia aberta no modo da linha de comando. 2. Inclua a seguinte cadeia de comando no job:
cpu#job opens /tabela(coluna = dados)

em que: tabela Especifica o nome da tabela do PeopleSoft que deseja abrir.

coluna Especifica o nome da coluna que voc est procurando. dados Especifica os dados dentro daquela coluna que corresponde pesquisa. 3. Salve as alteraes feitas e feche o fluxo do job. Nota: Os dados da tabela que voc est procurando devem estar escritos entre aspas duplas.

Exemplo de Dependncias Abertas


Os seguintes fluxo de job tm exemplos de dependncias abertas. Aqui est o primeiro exemplo:
SCHEDULE PS_CPU#TEST01 ON EVERYDAY : PS_CPU#XRFWIN1 PS_CPU#XRFAPF1 PS_CPU#XRFPNP1 FOLLOWS XRFAPF1 PS_CPU#SYSAUDT1 FOLLOWS XRFWIN1 PS_CPU#PTPTEDT1 OPENS /PSPRCSRQST ("PRCSTYPE = SQR Report AND RUNSTATUS = 9") PS_CPU#XRFILD1 FOLLOWS XRFPNP1,PTPTEDT1 PS_CPU#DDDAUDT1 FOLLOWS PTPTEDT1,TEST02.@ PS_CPU#TLS7011 FOLLOWS TEST02.@,DDDAUDT1 END

Aqui est outro exemplo:


Captulo 12. Definindo os Jobs do PeopleSoft

79

SCHEDULE PS_CPU#TEST02 ON EVERYDAY AT 1330 : PS_CPU#XRFWIN2 OPENS /PSSERVERSTAT ("SERVERNAME = PSNT AND SERVERSTATUS = 3") PS_CPU#XRFAPF2 FOLLOWS TEST01.XRFAPF1 PS_CPU#XRFPNP2 FOLLOWS XRFAPF2 PS_CPU#SYSAUDT2 FOLLOWS XRFWIN2 PS_CPU#PTPTEDT2 OPENS /PSPRCSRQST ("PRCSTYPE = SQR Report AND RUNSTATUS = 9 AND PRCSNAME = DDDAUDIT") PS_CPU#XRFILD2 FOLLOWS XRFPNP2,PTPTEDT2 PS_CPU#DDDAUDT2 END

IBM Tivoli Workload Scheduler e o Mapeamento de Status do Job do PeopleSoft


Quando um job do PeopleSoft ativado pelo Tivoli Workload Scheduler, voc pode monitorar seu progresso com o Console de Planejamento do Job. A transio de estado no IBM Tivoli Workload Scheduler e os estados do PeopleSoft correspondentes so listados a seguir.
Status do PeopleSoft CANCEL Status do IBM Tivoli Workload Scheduler CANCEL/ABEND Descrio Um operador do PeopleSoft ou o mtodo marcou a solicitao do processo para cancelamento. O mtodo ser cancelado em resposta a uma tarefa do TJ. Um operador do PeopleSoft marcou a solicitao do processo para excluso. Houve falha na tentativa de ativar algumas razes. Nesse caso, a solicitao de processo nunca iniciar a execuo realmente. O processo inadequado para ativao. Isso pode ocorrer devido s dependncias no atendidas. Pronto para ativar. Tentando ativar. Processo em execuo. Processo cancelado. Execuo bem-sucedida. Falha na execuo.

DELETE ERROR

CANCEL FAIL

HOLD

HOLD

QUEUED INITIATED PROCESSING CANCELLED SUCCESSFUL NOT SUCCESSFUL

READY INIT EXEC CANCEL/ABEND* SUCC ABEND

Notas: 1. Os processos cancelados no PeopleSoft sero interrompidos se j estiverem em execuo. O mapeamento de status do IBM Tivoli Workload Scheduler deve refletir isso. Um processo cancelado que ainda no foi iniciado deve estar marcado como CANCEL no Tivoli Workload Scheduler. Um processo que foi iniciado deve estar marcado como ABEND. 2. Uma solicitao de processo marcada para excluso no programador de processo no pode ser adequada para ativao. O registro eliminado da tabela

80

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

durante um processo de manuteno normal. Com objetivos de processamento do jnextday, tais solicitaes devem ser consideradas inexistentes.

Captulo 12. Definindo os Jobs do PeopleSoft

81

82

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 4. Mtodo de Acesso do R/3

Copyright IBM Corp. 2000, 2003

83

84

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 13. Introduo


O IBM Tivoli Workload Scheduler para Aplicativos do R3 fornece a habilidade para criar, planejar e controlar jobs do R/3 utilizando os recursos de planejamento de job do Tivoli Workload Scheduler.

Recursos
Com o IBM Tivoli Workload Scheduler para Aplicativos do R3, voc pode fazer o seguinte: v Utilizar as dependncias do job padro do Tivoli Workload Scheduler e os controles nos jobs do R/3. v Criar jobs do R/3 utilizando a interface do Tivoli Workload Scheduler. v Planejar jobs do R/3 para serem executados em dias e horas especificados e em uma ordem predeterminada. v Definir uma interdependncia dos jobs do PeopleSoft e dos jobs do Tivoli Workload Scheduler executados em diferentes aplicativos, como o PeopleSoft e o Oracle. v Definir uma interdependncia dos jobs do R/3 e dos jobs executados em diferentes plataformas. v Definir as opes de suporte a idiomas nacionais. v Definir como utilizar as funcionalidades do R/3 Business Warehouse Support. v Personalizar os cdigos de retorno de execuo do job. v Utilizar os grupos de logon do R/3 para equilbrio de carga e tolerncia a falhas. v Trabalhar com variantes e marcadores do R/3. v Explorar o suporte da interface do BC-XBP 2.0.

Planejando o Processo para o Agente Estendido do R/3


Tivoli Workload Scheduler ativa os jobs no R/3 como os jobs definidos para serem executados na estao de trabalho de agente estendido do Tivoli Workload Scheduler. Uma estao de trabalho de agente estendido do R/3 definida como uma estao de trabalho do Tivoli Workload Scheduler que hospedada por um FTA ou por uma estao de trabalho mestre que utiliza o mtodo de acesso do r3batch. A estao de trabalho de agente estendido do R/3 utiliza o mtodo de acesso do r3batch para transmitir informaes especficas do job do R/3 para predefinir as instncias do R/3. O mtodo de acesso utiliza as informaes fornecidas no arquivo de opes, discutido posteriormente neste guia, para conectar e ativar jobs em uma instncia do R/3. Vrias estaes de trabalho de agente estendido podem ser definidas para utilizar o mesmo host; isso feito com o uso de vrias entradas de opes ou vrios arquivos de opes. Os jobs do R/3 definidos no Tivoli Workload Scheduler devem corresponder aos jobs existentes no ambiente R/3. Com a utilizao do nome do agente estendido do R/3 como uma chave, o r3batch utilizar o arquivo de opes de correspondncia para determinar quais instncias do R/3 executaro o job. Ele far uma cpia de um job de gabarito no R/3 e o marcar como ativo para execuo, com uma data de incio incio imediato. Finalmente, ele monitora o job at sua concluso, gravando as informaes de andamento e de status do job em uma lista padro de job localizada na estao de trabalho do host.

Copyright IBM Corp. 2000, 2003

85

Para obter informaes adicionais sobre o gerenciamento do job, consulte o Guia de Referncia do IBM Tivoli Workload Scheduler SH19-4556.

Suporte Interface do XBP 2.0


O Tivoli Workload Scheduler para Aplicativos do R3 suporta completamente a Interface do XBP 2.0. Isso fornece as seguintes vantagens: v Rastreamento de jobs filhos. Um job do Tivoli Workload Scheduler permanece no status EXEC at que toda a rvore do job do R/3 seja concluda. Os logs do job do R/3 so recuperados e armazenados no Tivoli Workload Scheduler stdlist, juntamente com as listas de spool de todas as etapas do ABAP. v Interceptao de jobs do R/3. Os jobs planejados por usurios do R/3 podem ser interceptados antes da execuo baseada nos atributos do job. Um job do Coletor de Interceptao planejado periodicamente como um comando do Unix ou do Windows. Em cada execuo, ele coleta jobs do R/3 interceptados e os envia ao plano atual com base em um gabarito. v Todos os atributos de job so mantidos quando os jobs so executados novamente. As limitaes envolvendo os parmetros de impresso/arquivamento e classes de job em conjunto com o uso de cpias antigas de jobs executados novamente so removidas. v Etapas de comandos externos. Consulte Utilizando o Suporte a XBP 2.0 na pgina 98 para obter detalhes.

86

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 14. Instalao


Esta seo contm as informaes sobre a instalao do IBM Tivoli Workload Scheduler para Aplicativos do R3.

Requisitos de Software
Para instalar o IBM Tivoli Workload Scheduler para Aplicativos do R3, necessrio que os seguintes itens estejam em execuo: v IBM Tivoli Workload Scheduler verso 7.0 ou posterior ou o IBM Tivoli Workload Scheduler para z/OS com ponto a ponto. v R/3 verso 3.1g, 3.1h, 3.1i, 4.0x, 4.5x, 4.6x, 4.7, 6.10 ou 6.20. v Para as verses mais antigas que 6.20, o R/3 Support Package adequado como descrito na seguinte tabela:
Tabela 13. R/3 Support Packages. Verses do R/3 R/3 3.1x R/3 4.0x R/3 4.5x R/3 4.6x R/3 4.7 R/3 6.10 Notas do R/3 393708, 430087, 357924, 517672 393708, 430087, 111696, 357924, 517672 148436, 172245, 326202, 326752, 393708, 399449, 357924, 517672 326752, 352606, 399449, 453135, 435111, 357924, 517672, 610480 610480 399449, 435111, 453135, 357924, 517672, 610480

Nota: As notas 399449 e 430087 do R/3 resolvem os problemas do parmetro de impresso. As notas 357924, 517672 e 519137 so independentes do release.

Viso Geral da Instalao


A seguir est uma viso geral do Tivoli Workload Scheduler para os Aplicativos para as etapas de instalao do mtodo de acesso R/3. Antes de instalar o mtodo de acesso, certifique-se de que o Tivoli Workload Scheduler esteja instalado corretamente na estao de trabalho do host. 1. No sistema que ser o host o agente estendido para o R/3, execute as seguintes etapas: a. Se a plataforma em que estiver instalando for Compaq Tru64, siga as instrues descritas em Instalando em Plataformas de Nvel 2 na pgina 88. Caso contrrio, siga as instrues descritas em Captulo 2, Instalando o IBM Tivoli Workload Scheduler para Aplicativos, na pgina 5. 2. Instale os ABAPs do r3batch no sistema R/3. Para fazer isso: a. Efetue login na instncia do R/3 como um administrador ou um usurio bsico com as autorizaes corretas. b. Importe os arquivos de correo e transporte.

Copyright IBM Corp. 2000, 2003

87

Instalando em Plataformas de Nvel 2


1. Efetue logon como raiz e v para o diretrioTWShome. 2. No CD_ROM de instalao extraia o software: tar xvf cd_path/TWS4APPS_R3BATCH_OSF.TAR em que cd_path o nome de caminho da unidade de CD-ROM. 3. Verifique se r3setup e r3btar.Z foram extrados com sucesso no diretrio atual. 4. Execute o script r3setup para descompactar os arquivos, execute a instalao inicial e cria o arquivo r3options:
/bin/sh r3setup -new|-update

em que: -new Especifica uma nova instalao. -update Especifica que voc est instalando sobre uma verso instalada anteriormente. Ser necessrio especificar as informaes listadas abaixo. Consulte a seo Captulo 20, Arquivos de Opes do Mtodo de Acesso do R/3, na pgina 119 para obter mais detalhes. v O nome do usurio do Tivoli Workload Scheduler se for diferente do valor padro (o padro: maestro). v O diretrio em que o agente estendido deve estar instalado (digite o caminho para TWShome). v O Usurio de Ativao LJuser (padro: maestro). Esse o nome do usurio do Tivoli Workload Scheduler que executa o r3batch . Deve ser uma conta do UNIX vlida. v O Usurio de Informaes IFuser (padro: maestro). Esse o nome do usurio do Tivoli Workload Scheduler que recupera informaes de job. IFuser deve ser o mesmo que LJuser. v O tipo de definio de job JobDef (padro: r3batch). Esse o tipo de interface de definio do job do Tivoli Workload Scheduler. Pode ser: a. r3batch (padro). Ele fornece uma interface de definio de job especfica para os jobs do R/3. b. maestrogen ou em branco. Ele fornece uma interface de definio de job padro sem campos de entrada especficos do R/3. v O nome da CPU do host para a definio de agente estendido do Tivoli Workload Scheduler. v O nome do host do servidor de aplicativos R/3. v Se quiser especificar um gateway host do R/3 separado, digite NO. v O ID do sistema R/3 de trs caracteres (por exemplo: OSS ou TRN). v O nmero da instncia do R/3 de dois dgitos (por exemplo: 00 ou 01). v O nmero do cliente R/3 de trs dgitos (por exemplo: 100 ou 900). v O ID do usurio do R/3 para chamadas de RFC (por exemplo: rfcuser) v A senha para o ID do usurio RFC do R/3. v O nvel de auditoria de interface do R/3 (padro: 0) v Se quiser definir o idioma de login do SAP R/3 para o agente estendido nesse sistema R/3 (padro No)

88

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v Se quiser definir outra instncia do agente estendido. Se voc responder Sim, ser necessrio fornecer outro conjunto de parmetros. Uma entrada adicional inserida no arquivo de opes do R/3. 5. Abra o Tivoli Job Scheduling Console ou o programa Composer e crie uma definio de estao de trabalho no Tivoli Workload Scheduler para cada instncia do R/3.

Criptografando Senhas de Usurio do R/3


Ao incluir entradas no arquivo de opes, o valor de r3pass criptografado automaticamente antes de ser gravado no arquivo. Se voc modificar o arquivo com um editor de texto, ser necessrio executar oprograma enigma para criptografar a senha antes de grav-la no arquivo. Execute o comando de criptografia como se segue: enigma [senha] Voc pode incluir a senha na linha de comando ou inseri-la como resposta a um prompt. O programa retorna uma verso criptografada que pode ser inserida no arquivo de opes.

Captulo 14. Instalao

89

90

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 15. Configurao do R/3


Para comunicar e controlar a execuo do job em sistemas R/3 utilizando o mtodo de acesso para o R/3, voc precisar executar as seguintes etapas de configurao no ambiente R/3. As etapas descritas neste captulo exigiro um Administrador de BASE do R/3.

Viso Geral
Aqui est uma viso geral do procedimento de personalizao: 1. Crie um novo ID do usurio do RFC no R/3 para Tivoli Workload Scheduler. 2. Crie um perfil de autorizao como descrito em Criando o Perfil de Autorizao para o Usurio do Tivoli Workload Scheduler. 3. Copie os arquivos de correo e transporte do servidor Tivoli Workload Scheduler para o servidor R/3. 4. Importe os arquivos de correo e de transporte para o R/3 e verifique a instalao. Nota: O procedimento de importao inclui somente novos mdulos de funo ABAP/4 e vrias tabelas internas no sistema R/3. Ele no modifica nenhum dos objetos existentes.

Criando um Usurio RFC do IBM Tivoli Workload Scheduler


Para o Tivoli Workload Scheduler se comunicar com o R/3, voc deve criar um ID do usurio no R/3 para o processamento do batch do Tivoli Workload Scheduler. Por razes de segurana, utiliza um novo ID do usurio em vez de um existente. 1. Crie um novo ID do usurio RFC. 2. Fornea a esse novo ID do usurio RFC os seguintes atributos: v Um tipo de usurio do CPIC ou Comunicaes, dependendo do release do R/3. v Uma senha com seis caracteres no mximo. O Tivoli Workload Scheduler exige essa senha para iniciar ou monitorar os jobs do R/3. Se essa senha for alterada no R/3, voc dever atualizar o arquivo de opes utilizado pelo r3batch com a nova senha. v Atribua os perfis de segurana apropriados, dependendo da verso do R/3.

Criando o Perfil de Autorizao para o Usurio do Tivoli Workload Scheduler


H duas formas para executar essa tarefa: v Utilizando a transao SU02 e criando manualmente o perfil. v Utilizando o Gerador de Perfil (transao PFCG).

Utilizando a Transao SU02 e Criando Manualmente o Perfil


Faa o seguinte: 1. Grave um nome de perfil, por exemplo Z_TWS, e uma descrio.
Copyright IBM Corp. 2000, 2003

91

2. Inclua manualmente as autorizaes de acordo com a tabela a seguir:


Objeto S_ADMI_FCD S_BTCH_ADM Descrio Autorizaes do Sistema Autorizao S_ADMI_ALL

Processo em segundo plano: S_BTCH_ADM administrador de plano de fundo Processo em segundo plano: S_BTCH_ALL Operaes em jobs de plano de fundo Processo em segundo plano: S_BTCH_ALL nome do usurio de plano de fundo ABAP: programa que executa verificaes Verificao de autorizao para acesso do RFC pool: Aes Spool: Autorizaes de dispositivo Autorizaes de acesso interno para o log XMI Autorizao para interfaces de gerenciamento externo (XMI) S_ABAP_ALL

S_BTCH_JOB

S_BTCH_NAM

S_PROGRAM

S_RFC S_SPO_ACT S_SPO_DEV S_XMI_LOG S_XMI_PROD

S_RFC_ALL S_SPO_ALL S_SPO_DEV_AL S_XMILOG_ADM S_XMI_ADMIN

As autorizaes esto localizadas na classe de objeto Basis: Administration. Dependendo da verso do R/3, possvel que a autorizao S_RFC_ALL esteja localizada na classe de objeto objeto de Autorizao de Vrios Aplicativo ou objetos de Autorizao No Especficos ao Aplicativo. 3. Salve o perfil. 4. V para a janela de manuteno do usurio e atribua o perfil ao usurio do R/3 do Tivoli Workload Scheduler. 5. Salve os dados do usurio.

Utilizando a Transao PFCG (Gerador de Perfil)


Faa o seguinte: 1. Grave um nome, por exemplo ZTWS, em Nome da Funo. 2. Clique em Criar Funo e grave uma descrio para a funo, como Funo para o usurio do TWS. 3. Salve a funo. 4. Selecione a guia Autorizaes. 5. Clique em Alterar Dados da Autorizao. 6. No pop-up exibido, selecione Gabaritos. 7. Inclua manualmente os seguintes objetos de autorizao:
Objeto S_ADMI_FCD Descrio Autorizaes do Sistema

92

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Objeto S_BTCH_ADM S_BTCH_JOB S_BTCH_NAM S_PROGRAM S_RFC S_SPO_ACT S_SPO_DEV S_XMI_LOG S_XMI_PROD

Descrio Processo em segundo plano: administrador de plano de fundo Processo em segundo plano: Operaes em jobs de plano de fundo Processo em segundo plano: nome do usurio de plano de fundo ABAP: programa que executa verificaes Verificao de autorizao para acesso do RFC pool: Aes Spool: Autorizaes de dispositivo Autorizaes de acesso interno para o log XMI Autorizao para interfaces de gerenciamento externo (XMI)

8. Preencha os valores de acordo com o seguinte esquema:


S_ADMI_FCD Autorizaes do Sistema v Funes de administrao de sistema: Autorizao total S_BTCH_ADM Processo em segundo plano: administrador de plano de fundo v ID do administrador de plano de fundo: Autorizao total S_BTCH_JOB Processo em segundo plano: Operaes em jobs de plano de fundo v Operaes de job: Autorizao total v Resumo dos jobs para um grupo: Autorizao total S_BTCH_NAM Processo em segundo plano: nome do usurio de plano de fundo v Nome do usurio de plano de fundo para verificao de autorizao: Autorizao total S_PROGRAM ABAP: programa que executa verificaes v Programa ABAP/4 de ao do usurio: Autorizao total v Programa ABAP/4 de grupo de autorizao: Autorizao total S_RFC Verificao de autorizao para acesso do RFC v Atividade: Autorizao total v Nome do RFC a ser protegido: Autorizao total v Tipo de objeto RFC a ser protegido: Autorizao total S_SPO_ACT Spool: Aes v Campo Autorizao para aes de spool: Autorizao total v Valor para a verificao de autorizao: Autorizao total

Captulo 15. Configurao do R/3

93

S_SPO_DEV

Spool: Autorizaes de dispositivo v Spool - nomes de dispositivo longos: Autorizao total

S_XMI_LOG

Autorizaes de acesso interno para o log XMI v Mtodo de Acesso para o log XMI: Autorizao total

S_XMI_PROD

Autorizao para interfaces de gerenciamento externo (XMI) v Log XMI - Nome da companhia: TIVOLI* v Log XMI - Nome do programa: MAESTRO* v ID da interface: Autorizao total

9. Salve as autorizaes. 10. 11. 12. 13. Gere um perfil. Utilize o mesmo nome gravado em Nome da Funo. Saia da janela de gerenciamento de autorizao e selecione a guia Usurio. Inclua o usurio do Tivoli Workload Scheduler na funo. Salve a funo.

Copiar os Arquivos de Correo e de Transporte


O arquivo de configurao carrega dois arquivo de correo e de transporte no diretrio inicial do Tivoli Workload Scheduler. Voc deve copiar esses arquivos de correo e de transporte no servidor R/3 e import-los para o banco de dados do R/3, como se segue: 1. No servidor de banco de dados do R/3, efetue logon no sistema R/3 como administrador. 2. Copie o arquivo de controle e o arquivo de dados do diretrio TWShome\methods para os seguintes diretrios no servidor de banco de dados do R/3: copiar controlfile /usr/sap/trans/cofiles/ copiar datafile /usr/sap/trans/data/ Os nomes de controlfile e datafile variam de release para release. Os arquivos so instalados no diretrio TWShome\methods e tm os seguintes nomes de arquivo e formatos: K000xxx.TV1 (arquivo de controle) e R000xxx.TV1 (arquivo de dados), em que xxx um valor listado ao release.

Importar Mdulos ABAP/4 para R/3


Esse procedimento gera, ativa e envolve novos mdulos de funo ABAP/4 no sistema R/3 e vrias novas tabelas internas. Nenhum objeto do sistema R/3 existente modificado. 1. Altere para o seguinte diretrio:
cd /usr/sap/trans/bin

2. Inclua o arquivo de transporte no buffer: tp addtobuffer transport sid em que: transport o arquivo de solicitao de transporte. sid o ID do sistema R/3.

94

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

No diretrio TWShome\methods, voc pode localizar um arquivo chamado K000xxx.TV1, ento a solicitao de transporte ser tv1K000xxx. 3. Execute o comando tp tst para testar a importao: tp tst transport sid Aps a execuo desse comando, analise os arquivos de log no diretrio /user/sap/trans/log para verificar a existncia de mensagens de erro. Avisos de nvel de gravidade 4 so normais. Se voc encontrou erros, converse com um tcnico em correo e transporte ou tente utilizar modos incondicionais para realizar a importao. 4. Execute o seguinte comando para importar todos os arquivo para o buffer: tp import transport sid Esse comando gera os novos mdulos ABAP/4 e os coloca no banco de dados do R/3. Eles se tornam ativos automaticamente. Aps a execuo desse comando, analise os arquivos de log no diretrio /user/sap/trans/log para verificar a existncia de mensagens de erro. Avisos de nvel de gravidade 4 so normais. Se voc encontrar um problema, utilize modos incondicionais ao executar essa etapa: tp import transport sid U126 5. Quando a importao estiver concluda, verifique os arquivos de log para verificar se a importao foi bem-sucedida. Os arquivos de log esto no diretrio /usr/sap/trans/log.

Instalando os Mdulos ABAP do r3batch no Sistema R/3


Instalar os mdulos ABAP do r3batch no sistema R/3. Para obter detalhes sobre a instalao de mdulos ABAP do r3batch, consulte Captulo 15, Configurao do R/3, na pgina 91. Este captulo inclui instrues para a criao de um usurio RFC e sobre a instalao dos seguintes mdulos ABAP:
J_1O1_BDC_STATUS J_1O1_DATE_TIME J_1O1_JOB_ABAP_STEP_MODIFY J_1O1_JOB_ADD_ABAP_STEP J_1O1_JOB_ADD_EXTPGM_STEP J_1O1_JOB_CLOSE J_1O1_JOB_COPY J_1O1_JOB_DEFINITION_GET J_1O1_JOB_DELETE J_1O1_JOB_EXTPGM_STEP_MODFY J_1O1_JOB_FIND J_1O1_JOB_FINDALL J_1O1_JOB_HAS_EXTENDED_VARIANT J_1O1_JOB_LOG J_1O1_JOB_LOG_READ J_1O1_JOB_OPEN J_1O1_JOB_START J_1O1_JOB_STATUS J_1O1_JOB_STATUS_CHECK J_1O1_JOB_STOP J_1O1_RAISE_EVENT J_1O1_REPORT_ALL_SELECTIONS J_1O1_REPORT_DYNSEL_GET_DEF J_1O1_REPORT_GET_TEXTPOOL J_1O1_TABLE_GET_NAMETAB J_1O1_VARIANT_COPY J_1O1_VARIANT_COPY_4X J_1O1_VARIANT_CREATE J_1O1_VARIANT_CREATE_NEW
Captulo 15. Configurao do R/3

95

J_1O1_VARIANT_DELETE J_1O1_VARIANT_DELETE_NEW J_1O1_VARIANT_EXISTS J_1O1_VARIANT_GET_DEFINITION J_1O1_VARIANT_GET_DEF_NEW J_1O1_VARIANT_GET_HELP_VALUES J_1O1_VARIANT_INFO_GET J_1O1_VARIANT_MAINTAIN_CNT_TBL J_1O1_VARIANT_MAINTAIN_SEL_TBL J_1O1_VARIANT_MODIFY J_1O1_VARIANT_MODIFY_NEW

Resoluo de Problemas
Se voc no puder enviar jobs do R/3 utilizando o Tivoli Workload Scheduler aps a configurao do R/3, execute os seguintes testes: v Verifique se possvel executar ping no sistema R/3 a partir do sistema Tivoli Workload Scheduler. Isso mostrar a conectividade bsica da rede. v Observe que a utilizao de roteadores do R/3 para acessar o sistema R/3 pode exceder o tamanho do buffer interno da biblioteca RFC utilizada para armazenar o nome do host do sistema R/3. Quando isso ocorre, o nome do host fica truncado causando uma falha na conexo para o sistema R/3. Para solucionar esse problema, no qualifique o nome dos roteadores do R/3 totalmente ou, de modo alternativo, utilize os endereos IP. v Execute o seguinte comando telnet para verificar a conectividade: telnet systemname 33xx em que systemname o nome do sistema ou o endereo IP do servidor R/3 e xx a instncia do R/3. v Efetue logon no sistema R/3 como um administrador e verifique se o usurio RFC do Tivoli Workload Scheduler (criado em Criando um Usurio RFC do IBM Tivoli Workload Scheduler na pgina 91) existe. v Crie um novo job do IBM Tivoli Workload Scheduler a ser executado no R/3 e inclua as seguintes opes avanadas:
-debug -trace

Essas opes so selecionadas com o uso de botes de opes na pgina Propriedades - Tarefa de Definio de Job no Console de Planejamento do Job. Utilizando a opo -debug, informaes adicionais de depurao so includas no arquivo de job stdlist (em Tivoli Workload Scheduler). Quando voc utiliza a opo -trace, um arquivo de rastreamento criado no diretrio inicial do Tivoli Workload Scheduler. No UNIX, esse arquivo de rastreamento chamado dev_rfc. No Windows, o arquivo chamado rfcxxxxx_xxxxx.trc. Verifique se voc excluiu a opo de rastreamento do job depois de executar os procedimentos de depurao. O arquivo de rastreamento pode tornar-se muito grande e impossvel de gerenciar. Nota: Normalmente essas opes so para depurao do agente estendido e no devem ser utilizadas na produo padro. v Se por alguma razo o gateway do R/3 truncar a cadeia de conexo, substitua o nome IP pelo endereo IP. v Se estiver instalando em um sistema AIX que no utiliza o idioma ingls americano, ser necessrio instalar o Ambiente de Idioma Americano na estao de trabalho do IBM Tivoli Workload Scheduler e do banco de dados R/3. Caso contrrio, o erro BAD TEXTENV (ou uma mensagem de erro semelhante) pode ser exibido no arquivo de rastreamento dev_rfc e as conexes para o R/3 iro falhar.

96

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Alterando a Senha de ID do Usurio RFC do Tivoli Workload Scheduler


Se a senha de ID do usurio RFC do Tivoli Workload Scheduler for modificada aps a instalao inicial, o arquivo de opes utilizado pelo r3batch dever ser atualizado com essa alterao. No UNIX, efetue logon como raiz no sistema em que o Tivoli Workload Scheduler est instalado. No Windows, efetue logon como um administrador e inicie o shell do DOS no sistema em que o Tivoli Workload Scheduler estiver instalado, como se segue: 1. Gere uma verso criptografada da nova senha utilizando o comando enigma em TWShome/methods. Para fazer isso em um shell de comando, digite: enigma newpass em que newpass a nova senha para o ID do usurio RFC do Tivoli Workload Scheduler. O comando enigma emite uma verso criptografada da senha. 2. Copie a senha criptografada no arquivo de opes, que est localizado no diretrioTWShome/methods. O arquivo pode ser editado com qualquer editor de texto. Certifique-se de copiar a senha de forma exata, preservando letras maisculas, minsculas e a pontuao. A senha criptografada semelhante a:
#TjM-pYm#-z82G-rB

Se a senha criptografada for digitada de forma incorreta, o Tivoli Workload Scheduler no poder iniciar ou monitorar os jobs do batch do R/3.

Migrando de Verses Anteriores


Essa verso do agente estendido do Tivoli Workload Scheduler para o R/3 suporta todas as verses do R/3 listada na Tabela 13 na pgina 87. Para obter a certificao XBP do R/3 para as verses 4.0 e 4.5 do R/3, algumas alteraes devem ser feitas no agente de planejamento. O agente estendido do Tivoli Workload Scheduler para a verso 4.x do R/3 utiliza interfaces RFC do R/3 oficiais para o planejamento do job. So elas: v A interface SXMI_XBP para as verses 3.1g a 4.0x do R/3 v A interface BAPI_XBP desde a verso 4.5a Para evitar conflitos com outros fornecedores os mdulo ABAP do Tivoli Workload Scheduler pertencem, agora, ao espao de nomes do parceiro do Tivoli Workload Scheduler J_1O1_xxx. Aps a concluso da importao como descrito em Importar Mdulos ABAP/4 para R/3 na pgina 94, os mdulos de funo RFC J_1O1_xxx so instalados no sistema. Se houver uma instalao anterior do agente estendido do Tivoli Workload Scheduler para R/3 no sistema, voc poder excluir os seguintes mdulos de funo do sistema R/3:
Z_MAE2_BDC_STATUS Z_MAE2_DATE_TIME Z_MAE2_JOB_COPY Z_MAE2_JOB_DELETE Z_MAE2_JOB_FIND Z_MAE2_JOB_FINDALL Z_MAE2_JOP_OPEN
Captulo 15. Configurao do R/3

97

Z_MAE2_JOB_LOG Z_MAE2_JOB_START Z_MAE2_JOB_STATUS Z_MAE2_JOB_STOP

Essas so verses antigas de funes do Tivoli ABAP, que pertencem ao espao de nomes do cliente. Voc tambm pode excluir o grupo de funo YMA3. No necessrio excluir os mdulos de funo e o grupo de funes, mas voc pode fazer isso se desejar limpar o sistema.

Utilizando o Suporte a XBP 2.0


A interface SAP para planejamento de job externo (BC-XBP) foi estendida recentemente para remover as limitaes relatadas por clientes e parceiros. Ela fornecido pelo Basis Support Packages para todos os releases do R/3, comeando do WAS 4.6B. As seguintes limitaes foram removidas: v A classe de job no mais limitada a C v Todos os parmetros de impresso esto disponveis Os seguintes recursos foram includos: v Relacionamento pai-filho v Interceptao de job v Suporte para jobs com etapas de comando externo Verifique e aplique as seguintes notas SAP antes de utilizar a interface XBP 2.0 : v 602683 v 612564 v 604496

Criando o Perfil de Autorizao para o Usurio do Tivoli Workload Scheduler


H duas formas alternativas de incluir o objeto de autorizao listado no perfil de autorizao do usurio do Tivoli Workload Scheduler: v Utilizando a Transao SU02 v Utilizando o Gerador de Perfil

Utilizando a Transao SU02


Inclua o seguinte objeto:
Objeto S_RZL_ADM Descrio CCMS: Administrao de Sistema Autorizao S_RZL_ALL

Utilizando o Gerador de Perfil


Faa o seguinte: 1. Inclua manualmente o seguinte objeto:
Objeto S_RZL_ADM Descrio CCMS: Administrao de Sistema

2. Defina o valor do campo de atividade para Autorizao Total.

98

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Imprimir Parmetros e Problemas de Classe Job


O agente estendido para R/3 utiliza a interface RFC oficial do R/3 Verses 4.x 6.20 para planejamento de job. Ao migrar de verses anteriores do R/3, pode haver problemas para imprimir parmetros nos jobs ativados pelo Tivoli Workload Scheduler. Isso ocorre devido limitaes nas interfaces RFC. Estas limitaes no so mais verdadeiras com XBP 2.0. A tabela a seguir mostra os parmetros de impresso suportados pelo API XBP 1.0.
Parmetros de Impresso dispositivo de sada imprimir imediatamente excluir aps sada nmero de cpias modo de arquivamento autorizao pgina de capa de seleo pgina de capa sap perodo de reteno de spool destinatrio linhas colunas 4.5x e posterior 3.1x U U U U U U x U U x x x 4.0x U U U U U U U U U x x x U U U U U U U U U U U U

Para resolver a perda dos parmetros de impresso durante a cpia do job, instale o Support Package apropriado para o R/3, como declarado nas notas do R/3 399449 e 430087. O mesmo se aplica classe de job. As interfaces oficiais do R/3 permitem somente jobs de classe C. Instalar o Support Package para R/3 tambm resolve esse problema.

Captulo 15. Configurao do R/3

99

100

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 16. Definindo Jobs de Agente Estendido do R/3


Para controlar a execuo do job na estao de trabalho do R/3 a partir do Tivoli Workload Scheduler voc deve definir o seguinte: v Jobs no R/3 que voc deseja executar sob o controle do Tivoli Workload Scheduler. Voc pode definir esses jobs utilizando as ferramentas padro do R/3 ou as janelas especficas do SAP do Job Scheduling Console. v Jobs no Tivoli Workload Scheduler que correspondem aos jobs no R/3. As definies de job do Tivoli Workload Scheduler so utilizadas no planejamento e na definio de dependncias, mas os jobs do R/3 so realmente executados.

Definindo um Job no R/3


Para criar jobs do R/3 que so controlados pelo Tivoli Workload Scheduler, utilize o seguinte: v As ferramentas do R/3 padro para definir jobs v As janelas especficas do SAP do Job Scheduling Console. Consulte a documentao do R/3 para obter informaes sobre como criar jobs com as ferramentas do R/3. Ao criar jobs no R/3, no atribua uma hora de incio e no especifique nenhuma dependncia. Elas so controladas e especificadas no Tivoli Workload Scheduler. O job identificado no Tivoli Workload Scheduler pelo seu nome de job do R/3 e pelo ID de job. O mesmo job pode ser planejado para ser executado repetidamente pelo Tivoli Workload Scheduler sem ter que redefini-lo mais de uma vez no R/3. Nota: Para os jobs do R/3 controlados pelo Tivoli Workload Scheduler, a sada de log do job no R/3 encontrada abaixo do nome do usurio definido na opo r3user do arquivo de opes.

Definindo um Job no Tivoli Workload Scheduler


Para definir o job do Tivoli Workload Scheduler, voc pode utilizar: v O Tivoli Job Scheduling Console. v A linha de comando do Tivoli Workload Scheduler. v Os dilogos ISPF do Tivoli Workload Scheduler para z/OS, se voc deseja planejar o job em um ambiente ponto a ponto. Consulte Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37 para obter referncia. Os procedimentos descritos no Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37 so comuns a todos os agentes estendidos do Tivoli Workload Scheduler. O agente estendido para R/3 fornece um adicional por meio do Job Scheduling Console. No Job Scheduling Console, quando voc seleciona o tipo de tarefa para uma nova definio de job, possvel escolher entre dois tipos: Tarefa de Agente Estendido Ela comum a todos os agentes estendidos. Se voc selecionar essa opo:

Copyright IBM Corp. 2000, 2003

101

v O job do R/3 associado dever ser definido no banco de dados do R/3 e voc precisa saber o nome dele. v Voc pode utilizar o campo Comando em uma das janelas de definio do job para inserir parmetros para executar o job do R/3. v As estaes de trabalho de agente estendido definidas para o R/3 (especificando r3batch como o mtodo de acesso) so listadas como estaes de trabalho de agente estendido genrico. SAP especfico para jobs de agente estendido do R/3. Se voc selecionar essa opo: v Voc pode definir ou atualizar o job do R/3, bem como as variantes ou os parmetros SAP para executar o job, a partir das janelas do Job Scheduling Console, como se estive operando no R/3. v As estaes de trabalho agente estendido do R/3 so consideradas estaes de trabalho R/3. Elas no so mostradas nas listas de estaes de trabalho de agente estendido genricas exibidas quando voc clica na elipse prxima do campo Estao de Trabalho. Voc deve saber o nome para grav-lo em um campo.

Para que o SAP seja exibido como uma tarefa opcional no Job Scheduling Console, voc deve definir a opo jobdef para o r3batch no arquivo de opes r3batch.opts (localizado no subdiretrio methods de TWShome ) do master do Tivoli Workload Scheduler. Para aprender como definir um job de agente estendido do R/3, utilizando a janelaTarefa de Agente Estendido, consulte Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37. Para aprender como definir um job de agente estendido do R/3 utilizando a janela de tarefas SAP, consulte a prxima seo.

Utilizando Janelas Especficas do SAP do Job Scheduling Console


Para criar uma definio de job no banco de dados do Tivoli Workload Scheduler para um job do R/3, execute as seguintes etapas: 1. Na lista Aes da janela principal do Console de Planejamento de Job, selecione Nova Definio de Job. 2. Selecione um mecanismo do Tivoli Workload Scheduler e, a partir da lista resultante, clique em SAP. A janela Propriedades - Definio de Job exibida.

102

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 26. Propriedades - Definio de Job

3. Na pgina geral, voc define o job do Tivoli Workload Scheduler que direcionar o job do R/3. Complete os seguintes campos: a. No campo Nome, insira o nome do Tivoli Workload Scheduler para o job do R/3. O nome pode contar oito ou 40 caracteres alfanumricos, se voc estiver utilizando a opo de banco de dados expandida. O nome do job deve comear com uma letra. b. No campo Estao de Trabalho, clique no boto de elipse (...) para abrir a janela Localizar e selecione uma estao de trabalho disponvel. c. No campo Descrio, digite uma descrio para o job. Esse campo uma descrio de texto opcional do job e pode conter at 64 caracteres alfanumricos. d. No campo Login, insira o ID de logon do Tivoli Workload Scheduler usado para executar o job. e. Clique em Incluir Parmetro para incluir os parmetros predefinidos para o ID de logon . f. No campo Opes de Recuperao, especifique quaisquer opes de recuperao para o job do R/3. Consulte o IBM Tivoli Workload Scheduler Guia de Referncia para obter informaes sobre as opes de recuperao. 4. Selecione Tarefa. A pgina Tarefa exibida.

Captulo 16. Definindo Jobs de Agente Estendido do R/3

103

Figura 27. Tarefa Propriedades - Definio de Job

Nessa pgina, insira as especificaes do job do R/3 que sero direcionadas pelo job do Tivoli Workload Scheduler definido nas pginas anteriores. Voc pode utilizar essa pgina para criar os jobs do R/3 padro(mas no InfoPackages ou Process Chains) no sistema SAP . 5. Para especificar um job do R/3 existente: a. Na pgina Tarefa, especifique o tipo de job e clique na elipse (...) prxima ao campo Nome do Job. A janela SAP Pick List exibida. b. Utilize a pick list para localizar e selecionar um job do R/3 e clique em OK. As informaes do job so exibidas nos seguintes itens de volta na pgina Tarefa: v campo Nome do Job v campo ID do Job v boto Tipo de Job do R/3 Se o tipo de job for o Job do R/3 Padro, voc poder edit-lo e ver seus detalhes e o status. Se o tipo de job for Business Warehouse Info Package ou Process Chain, voc poder ver somente os detalhes. 6. Para criar um job do R/3 padro: a. Na pgina Tarefa, selecione Job do R/3 Padro e clique em Novo. A pgina Job do R/3 da janela Definio de Job do SAP exibida.

104

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 28. A pgina Job do R/3 da janela Definio de Job do SAP.

b. Na pgina Job do R/3, insira as informaes sobre o job que voc est criando: 1) Digite um nome para o job do R/3 no campo Nome do Job. 2) Deixe o campo ID do Job em branco. Um ID ser atribudo pelo sistema R/3 quando voc salvar a definio de job. 3) Digite o nome da estao de trabalho R/3 em que esse job ser executado no campo Host de Destino. 4) Clique em Etapas para abrir a seguinte pgina.

Captulo 16. Definindo Jobs de Agente Estendido do R/3

105

Figura 29. A pgina Etapas da janela Definio de Job do SAP.

c. Na pgina Etapas voc pode especificar um ou mais ABAPs ou programas externos para o job do R/3. Repita as seguintes etapas para o nmero de etapas a serem definidas: 1) Clique no boto Incluir Linha para incluir uma linha na tabela de etapas. 2) D um clique duplo no campo Tipo e selecione se ele um ABAP ou um programa externo. 3) No campo Nome, digite um nome do ABAP ou um caminho e um nome de arquivo totalmente qualificado para um programa externo. 4) No campo Usurio, digite o nome do usurio do R/3 que executa essa etapa.

106

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

5) No campo Var/Parm, digite um nome de variante ou um parmetro, se necessrio. As variantes so utilizadas com os ABAPs e os parmetros com os programas externos, mas ambos so opcionais. Nem todos os ABAPs exigem variantes e nem todos os programas externos exigem parmetros. Um boto de elipse (...) est disponvel prximo ao campo para exibir a lista de variantes associadas com o ABAP. Voc pode utilizar essa lista para selecionar uma variante bem como para criar ou alterar definies de variante. Consulte Definindo ou Atualizando Variantes do R/3 a partir do Job Scheduling Console para obter detalhes. 6) No campo Host de Destino, insira a estao de trabalho R/3 em que esta etapa est sendo executada. Os hosts de destino so necessrios somente para os programas externos. 7) Insira os parmetros de impresso e as especificaes de sinalizadores de controle de acordo com os requisitos do R/3. d. Quando voc concluir a criao das etapas de ABAP ou de programas externos, clique em OK. A definio de job do R/3 salva no banco de dados do R/3 e a janela fechada. Se os jobs do R/3 forem salvos com sucesso no banco de dados do R/3, a pgina Propriedades - Tarefa de Definio de Job dever exibir um ID de job do R/3. 7. Clique em OK na janela Propriedades - Definio de Job para salvar a definio do job no banco de dados do Tivoli Workload Scheduler.

Definindo ou Atualizando Variantes do R/3 a partir do Job Scheduling Console


A ao de clicar na elipse ao lado do campo Var/Parm na janela Definio de Job do SAP exibe uma janela Lista de Variantes. Essa janela lista todas as variantes associadas ao ABAP fornecido no campo Nome na Definio de Job do SAP e lembrada na seguinte figura.

Captulo 16. Definindo Jobs de Agente Estendido do R/3

107

Figura 30. A janela Lista de Variantes.

Nessa janela, alm das outras aes, voc pode criar ou atualizar variantes. Para fazer isso, clique em Novo ou em Editar. Uma janela Estrutura de Variante semelhante a essa exibida (se voc estiver fazendo edies, os campos e as selees no ficaro vazios):

108

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Figura 31. A pgina Informaes da Variante da janela Lista de Variantes.

Na pgina Informaes da Variante faa o seguinte: 1. Insira/modifique o nome e a descrio da variante. 2. Opcionalmente, verifique a caixa Propriedades: Plano de Fundo A variante pode ser utilizada somente em processamento em segundo plano. Protegida A variante est protegida contra alteraes feitas por outros usurios. Invisvel A variante no ser exibida na lista de valor F4 na GUI do SAP. Estendido Permite o uso de marcadores e cronmetros como valores de variante. Se voc marcar essa caixa, o boto cronmetro estar disponvel. Para as variantes estendidas, voc pode usar marcadores e cronmetros que eliminam a tarefa error-prone de valores de ajuste e portanto minimiza automaticamente o esforo para a manuteno da variante. Os marcadores e os cronmetros so pr-processados pelo Tivoli Workload Scheduler e os valores so automaticamente ajustados quando o job ativado. Os marcadores e os cronmetros suportados so:
Tabela 14. Marcadores e Cronmetros para Variantes Estendidas. Smbolo $S $D $_D Significado Data e hora Dia do ms Data Sintaxe AAAAMMDDHHMM DD AAAAMMDD

Captulo 16. Definindo Jobs de Agente Estendido do R/3

109

Tabela 14. Marcadores e Cronmetros para Variantes Estendidas. (continuao) Smbolo $M $Y $_Y $H $T $_T $Nx $(date expression) $[arithmetic expression] Significado Ms Ano Ano Hora Minuto Hora Cronmetros Expresso de date Expresso aritmtica Sintaxe MM AA AAAA HH MM HHMMSS 10 cronmetros: $N0 - $N9 ($N = $N0) Como o comando datecalc. Entre o sinal $( e ). As expresses aritmticas permitem operaes de +, , *, e / entre nmeros inteiros e de cronmetro.

Na pgina Valores da Variante, os campos e os valores so criados dinamicamente por meio do r3batch dependendo das caractersticas da variante ou da etapa e so idnticos queles contidos no janela SAP equivalente.

Parmetros da Cadeia de Tarefas para Jobs do R/3


Esta seo descreve os parmetros da cadeia de tarefas que regem a execuo de jobs do R/3. Voc deve especific-los nos seguintes locais ao definir os jobs do Tivoli Workload Scheduler associados: v No campo Comando da pgina Tarefa da janela Propriedades - Definio de Job, voc utilizar o Job Scheduling Console e Tarefa de Agente Estendido (e no SAP) para uma nova definio de job. v Como argumentos da palavra-chave nome_do_script na instruo de definio do job, se estiver usando a linha de comando do Tivoli Workload Scheduler. v Como argumentos da palavra-chave JOBCMD na instruo JOBREC no SCRIPTLIB do Tivoli Workload Scheduler para z/OS, se voc estiver planejando em um ambiente ponto a ponto. A sintaxe da cadeia a seguinte:
-job job_name ( -user user_name | -i (job_id|ipack_|pchain_) ) [-client def_client] [-exec_client exec_client] [-debug] [-trace]

Os parmetros so descritos na tabela a seguir.


Tabela 15. Parmetros da Cadeia de Tarefas para Jobs do R/3. Parmetro -job job_name Descrio O nome da tarefa que deve ser executada. o nome do job do R/3, o nome do campo do tcnico do InfoPackage ou o nome do ProcessChain. Esse parmetro obrigatrio.

110

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 15. Parmetros da Cadeia de Tarefas para Jobs do R/3. (continuao) Parmetro -user user_name Descrio O usurio do R/3 que possui o job de destino. Esse parmetro pode ser utilizado somente quando um sistema R/3 de destino tem um job com o nome especificado para o usurio determinado. Ele no tem efeito nos jobs InfoPackage ou ProcessChain, nem se um ID de job tiver sido especificado no definio do job. Um dos seguintes: v Um ID de job do R/3 exclusivo, se o job de destino for padro. v ipack_, se o job de destino for InfoPackage. v pchain_, se o job de destino for ProcessChain. Os parmetros -user, -client e -exec_client no tero efeito, se voc especificar um ID de job. Para os jobs de InfoPackage e de ProcessChain, esse parmetro obrigatrio. -client def_client O nmero identificando o cliente R/3 em que a definio do job deve ser encontrada, independentemente do nmero do cliente definido pela chave r3client no arquivo de opes. Esse parmetro no tem efeito com jobs de InfoPackage ou de ProcessChain, nem se um ID de job tiver sido especificado na definio de job. O nmero identificando o cliente R/3 em que o job deve ser executado, independentemente do nmero do cliente definido pela chave r3client no arquivo de opes. Esse parmetro no tem efeito com jobs de InfoPackage ou de ProcessChain, nem se um ID de job tiver sido especificado na definio de job. Ativa o rastreamento mais verboso do r3batch. Ativa o rastreamento de SAP RFC.

-i job_id

-exec_client exec_client

-debug -trace

Notas: 1. Voc pode especificar -i e -user na mesma definio de job, porm o nome do usurio ser ignorado. 2. Ao especificar o ID do job, -client e -exec_client so ignorados, pois o ID exclusivo para o sistema R/3 inteiro. Este um exemplo para um job do R/3 chamado BVTTEST com ID 03102401 e usurio myuser:
-job BVTTEST i 03102401 -debug

Captulo 16. Definindo Jobs de Agente Estendido do R/3

111

Este um exemplo para o job do InfoPackage cujo nome tcnico do campo ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY:
-job ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY -i ipak_

Os Estados de Job do Tivoli Workload Scheduler e do R/3


Quando um job do R/3 for ativado pelo Tivoli Workload Scheduler, voc poder monitorar seu progresso. A transio de status no Tivoli Workload Scheduler (status interno) e o status do R/3 correspondente so listados na tabela a seguir.
Estado do Job do Tvoli Workload Scheduler INTRO WAIT EXEC SUCC ABEND Estado do Job do R/3 N/D Pronto Ativo Concludo Cancelado

O estado INTRO indica que o Tivoli Workload Scheduler est no processo de introduo do job, mas no R/3, o job ainda no est no estado Pronto. Como ele leva algum tempo para colocar o job em fila e na coluna pronto, o estado INTRO pode demorar alguns minutos se o sistema R/3 estiver particularmente ocupado. Embora um job possa ser concludo no R/3, o Tivoli Workload Scheduler o manter no estado EXEC se as sesses BDC no estiverem concludas e se voc no tiver selecionado a opo Disable BDC Wait. Para utilizar essa opo, consulte Captulo 21, BDC Wait, na pgina 127.

112

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 17. Executando Jobs Novamente


Antes de executar um job R/3 novamente com o Tivoli Workload Scheduler, voc pode optar por fornecer um nome de etapa para o job. Ao fazer isso, o r3batch ser afetado da seguinte maneira: se o nome da etapa tiver o formato xnnnnnn ou nnnnnnn (em que x um caractere sem dgito e n um caractere de dgito), ento ele utilizado como o nmero da etapa de incio para a nova execuo do job do R/3. Em todos os outros casos, esse valor no ter efeito na nova execuo do job. O job executado novamente, iniciando da primeira etapa. Somente quando o r3batch executa novamente um job a partir da primeira etapa, porque o usurio o especificou como a etapa de incio ou porque no foi especificada nenhuma etapa de incio, ele utiliza o recurso nova cpia, se aplicvel. Se a etapa de incio for maior que essa, ento o r3batch utilizar a cpia antiga para executar o job novamente. A seo a seguir explica a principal diferena entre a cpia nova e a antiga de um job executado novamente.

Cpia Antiga e Cpia Nova de um Job Executado Novamente


Quando um mtodo de acesso para o R/3 precisa lanar um job, ele faz uma cpia de um job de gabarito e o executa. O recurso de nova cpia est disponvel para as verses 3.1i ou posterior do R/3. Ele copia um job junto, preservando as etapas, a classe do job e todos os parmetros de impresso e arquivamento. Ele executado com o uso de um novo mdulo de funes do R/3 que est includo no R/3 Support Package, como declarado nas notas do R/3 399449 e 430087. Ao contrrio, o recurso de cpia antiga, baseado nos mdulos de funo do R/3 padro, cria um novo job do R/3 e inclui as etapas com um loop iniciado a partir do nome ou nmero da etapa especificada. Certifique-se de que, exceto se voc tiver suporte para XBP 2.0 : v A cpia antiga no preserva todos os parmetros de impresso e arquivamento. v A classe do job da cpia est definida sempre como a classe C. Consulte a seo Imprimir Parmetros e Problemas de Classe Job na pgina 99 para aprender como resolver o problema de perda dos parmetros da classe do job, de impresso e de arquivamento.

Copyright IBM Corp. 2000, 2003

113

114

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 18. Business Information Warehouse


Business Information Warehouse Support - InfoPackages
O BIW (Business Information Warehouse) uma soluo de armazm de dados especfica para o R/3. Ela permite o relato dos negcios e o suporte decises.

Autorizaes do Usurio
O Tivoli Workload Scheduler para Aplicativos do R3 pode gerenciar o R/3 BIW Info Packages e o Process Chains. Para utilizar a funcionalidade do R/3 BIW, necessrio definir um usurio do Tivoli Workload Scheduler R/3 dentro do R/3 que necessite as seguintes autorizaes adicionais: As autorizaes na tabela abaixo so necessrias somente se voc desejar utilizar as funcionalidades do Business Warehouse para o agente estendido.
Objeto S_DEVELOP Texto ABAP Workbench Autorizao E_ABAP_ALL

Nota: Alm do perfil Z_MAESTRO, o perfil S_RS_ALL precisa ser includo no usurio do Tivoli Workload Scheduler.

Componentes do Business Warehouse


O R/3 suporta dois componentes principais do BIW, InfoPackages e Process Chains. Um InfoPackage um ponto de entrada para o processo de carga de um determinado InfoSource (um continer lgico de origem de dados, genericamente chamado de InfoObject). Tecnicamente, um InfoPackage um job SAP real cujo objetivo carregar os dados. Como qualquer outro job do R/3 job, ele contm parmetros especficos para job como hora de incio, dependncias e mais. Um Process Chain uma cadeia complexa de diferentes processo e relacionamentos. Os processos dentro de uma cadeia de processo no so limitados aos processos de carga de dados, ou InfoPackages, mas tambm incluem: v Execuo de Atributo/Alterao de Hierarquia v Agregar rollup v Programa ABAP v Outra cadeia de processo v Processo de compilao de cliente

Definindo os Jobs de Agente Estendido para BIW


Os InfoPackages e os Process Chains podem ser criados somente a partir do ambiente R/3. Contudo, o nvel de recurso 1.3 do Job Scheduling Console suporta listas de pico dos InfoPackages e dos Process Chains, para que voc possa definir os jobs de agente estendido do Tivoli Workload Scheduler tambm para esses objetos.

Copyright IBM Corp. 2000, 2003

115

Consulte Utilizando Janelas Especficas do SAP do Job Scheduling Console na pgina 102 para saber como definir jobs de agente estendido por meio de janelas SAP do Job Scheduling Console. Consulte Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37 para saber como definir jobs de agente estendido por meio da janela Tarefa de Agente Estendido do Job Scheduling Console ou pelo Composer. Consulte Parmetros da Cadeia de Tarefas para Jobs do R/3 na pgina 110 para conhecer os parmetros de cadeia de tarefas para especificao dos InfoPackages e dos Process Chains ao definir um job de agente estendido por meio da janela Tarefa de Agente Estendido do Job Scheduling Console ou pelo Composer.

Opes de Planejamento do R/3 de um InfoPackage


Para poder planejar InfoPackages por meio do IBM Tivoli Workload Scheduler, as opes de planejamento do InfoPackage devem ser ajustadas como segue: v Tipo de incio deve ser definido para Iniciar posteriormente em processo de plano de fundo. v Hora de incio deve ser imediato

116

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 19. Conectando-se ao Sistema R/3


O Tivoli Workload Scheduler para Aplicativos do R3 utiliza a biblioteca SAP RFC (chamada de conexo remota) para conectar-se ao sistema R/3. O endereo de conexo para um sistema R/3 indicado como uma cadeia de conexo.

Conexes para um Servidor de Aplicativos Especfico


Na sua forma bsica, uma cadeia de conexo consiste em um nome de host (ou nome de um IP) do servidor de aplicativos R/3; por exemplo:
/H/hemlock.tivlab.raleigh.ibm.com

Esse tipo de cadeia de conexo funciona somente em ambientes de rede simples, em que todos os servidores de aplicativos podem ser alcanados diretamente por meio de TCP/IP. Normalmente, as empresas modernas usam topologias de rede mais complexas, com inmeras pequenas sub-redes, que no podem se comunicar diretamente por meio de TCP/IP. Para suportar esse tipo de rede, a biblioteca SAP RFC suporta os roteadores SAP, que so colocados nos limites das sub-redes e agem como proxies. Para esse tipo de rede, a cadeia de conexo um conjunto de cadeias de conexo bsicas para cada roteador SAP, seguida por uma cadeia de conexo bsica para o sistema R/3 de destino; por exemplo:
/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com

Alm disso, possvel garantir a segurana dos roteadores SAP com senhas, para evitar acesso no autorizado. Nesse caso, a cadeia de conexo bsica para esse roteador SAP seguida por /P/ e a senha do roteador. Nota: A biblioteca SAP RFC limita o comprimento da cadeia de conexo at 128 caracteres no mximo. Essa uma limitao real em ambientes de rede complexos. Como uma soluo alternativa, recomendado utilizar nomes de host simples, sem um nome de domnio sempre que possvel. Voc tambm pode utilizar endereos IP, mas isso no recomendado, pois ele muito difcil de ser mantido. O Tivoli Workload Scheduler para Aplicativos do R3 suporta ambos os tipos de cadeias de conexo, bsica e em conjunto, em que: r3host a cadeia de conexo. r3instance o nmero de instncias do R/3. r3sid o ID do sistema R/3.

Por exemplo:
r3host=/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com r3instance=00 r3sid=TV1

Copyright IBM Corp. 2000, 2003

117

Grupos de Logon
Em grandes instalaes de R/3, os servidores de aplicativos so normalmente configurados em grupos de logon com propsitos de equilbrio de carga e tolerncia a falhas. O equilbrio de carga feito por um servidor dedicado, chamado Servidor de Mensagens. O servidor de mensagens atribui usurios, automaticamente, ao servidor de aplicativos com a ltima carga de trabalho do grupo de logon que ele controla. Defina as seguintes opes para configurar o r3batch para conectar-se ao grupo de logon: r3host O nome do host do servidor de mensagens. r3group O nome do grupo de logon. r3sid O ID do sistema R/3.

Por exemplo:
r3host=pwdf0647.wdf.sap-ag.de r3group=PUBLIC r3sid=QB6

118

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 20. Arquivos de Opes do Mtodo de Acesso do R/3


Os arquivos de opes para o mtodo de acesso do R/3 so os seguintes: r3batch.opts Um arquivo de configurao comum para o mtodo de acesso do r3batch, cujas definies afetam todas as instncias do r3batch. Ele funciona como um arquivo de configurao global. CPUNAME_r3batch.opts Um arquivo de configurao que especfico para cada estao de trabalho de agente estendido do IBM Tivoli Workload Scheduler - chamado genericamente de CPUNAME - utilizando o mtodo de acesso do r3batch. Suas opes afetam somente a instncia do r3batch utilizada pela estao de trabalho particular. Ela funciona como um arquivo de configurao local. Por exemplo, se voc desejar definir dois agentes estendidos chamados wkst1 e wkst2 que acessaro dois Sistemas R/3 - SAP1 e SAP2 - com o mtodo de acesso do r3batch, voc dever definir os trs arquivos de configurao a seguir: v O arquivo r3batch.opts global v O arquivo wkst1_r3batch.opts local v O arquivo wkst2_r3batch.opts local Nota: Se o r3batch encontrar o arquivo de configurao local para um agente estendido, ele ir ignorar as informaes contidas no r3options.

Opes de Configurao
Esta seo descreve as opes que voc deseja configurar no r3batch.opts e no CPUNAME_r3batch.opts.

Opes Globais
A tabela a seguir lista as opes que voc deve colocar no arquivo de configurao global r3batch.opts. Essas opes tm efeito somente quando estiverem executando o agente estendido do Tivoli Workload Scheduler em um ambiente Unix. Nota: Essas opes tero efeito somente se forem colocadas no arquivo r3batch.opts.
Tabela 16. Opes de Configurao Global do R3batch. Opo job_sem_proj var_sem_proj Descrio O ID do projeto para o semforo do job. O ID do projeto para o semforo de variante. O ID do projeto para o semforo de interceptao do job.

icp_sem_proj

Copyright IBM Corp. 2000, 2003

119

As opes job_sem_project e var_sem_project so definies avanadas que permitem personalizar a sincronizao entre os jobs. O sistema R/3 sincroniza o acesso ao banco de dados, utilizando um sistema de gerenciamento de trava. Quando o Tivoli Workload Scheduler para Aplicativos do R3 est em execuo no sistema R/3, os mdulos de funo de ABAP correspondentes travam e destravam objetos diferentes no banco de dados, automaticamente. Ao tentar travar um objeto, o sistema de gerenciamento de trava permite aguardar somente um perodo de tempo limitado antes de a tentativa de travamento ser rejeitada com uma falha. Quando isso acontece, o mdulo de funo atual interrompido. O perodo de tempo mximo, em segundos, para cada tentativa de travamento especificado no parmetro do sistema enque/delay_max. O cdigo de retorno do mdulo de funo muito geral para distinguir o overrun do tempo de espera de travamento mximo a partir de outros erros do banco de dados. Ento, o mtodo de acesso para o R/3 no pode processar e relatar um erro. Se isso acontecer durante a execuo de um job do R/3, o job ser colocado no estado abort. Essa situao piora quando o Tivoli Workload Scheduler inicia uma quantidade de jobs simultaneamente. Dependendo do tempo de espera de travamento mximo, vrios jobs sero interrompidos devido expirao das tentativas de travamento. Para resolver esse problema, o Tivoli Workload Scheduler para Aplicativos do R3 utiliza semforos no nvel do S.O. para sincronizar as chamadas do mdulo de funo ABAP. Isso evita efetivamente os problemas descritos. Ele utiliza um semforo para as tarefas listadas ao job e outro para tarefas listadas manuteno da variante. Para encontrar a mesma estrutura IPC em um ambiente UNIX, os parceiros de comunicao tm que concordar com um identificador dessa estrutura. H vrios modos para escolher esse identificador. O Tivoli Workload Scheduler para Aplicativos do R3 utiliza dois parmetros: um nome da caminho e um ID de projeto (que um valor de caractere). O parmetro de nome do caminho levado do caminho absoluto para o arquivo de opes. O ID do projeto tirado das opes descritas em Tabela 16 na pgina 119. Se essas opes forem omitidas, o Tivoli Workload Scheduler para Aplicativos do R3 utilizar os valores padro, que funcionaro bem na maioria das instalaes.

Opes Locais
A tabela a seguir lista as opes que voc deve colocar nos arquivos de configurao local.
Tabela 17. Opes de Configurao Local do R3batch. Opo r3client r3gateway r3group r3gwservice r3host Descrio O nmero do cliente R/3. Essa opo necessria. O nome do host do gateway R/3. O nome do grupo de logon do R/3. O nmero do servio do gateway R/3. O nome do host do servidor de mensagem do R/3, ao utilizar os grupos de logon, ou os nome do host do servidor de aplicativos em todos os outros casos. Essa opo necessria.

120

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 17. Opes de Configurao Local do R3batch. (continuao) Opo r3instance r3password Descrio O nmero da instncia do R/3. Essa opo necessria. A senha para o r3user. O valor faz distino entre maisculas e minsculas. Essa opo necessria. O ID do sistema R/3. Essa opo necessria. O nome do usurio do R/3 com o qual o mtodo de acesso conectado ao sistema R3. Essa opo necessria. Fora o mtodo de acesso a funcionar somente em sistemas R/3 com verso especificada. Utilize essa opo com cuidado. Fora o mtodo de acesso a funcionar somente em sistemas R/3 que suportam uma verso do XBP especificada. Utilize essa opo com cuidado.

r3sid r3user

r3version

xbpversion

Opes Gerais
A tabela a seguir lista as opes adicionais que voc pode colocar no arquivo de configurao.
Tabela 18. Opes de Configurao Geral do R3batch. Opo r3auditlevel short_interval Descrio O nvel de auditoria para o XBP. Um nmero de 0 a 3. O pequeno intervalo, em segundos, para a verificao do status. Um valor maior que 10 segundos. O longo intervalo, em segundos, para a verificao do status. Um valor menor que 3600 segundos. A codificao que o r3batch deve utilizar para abrir as conexes RFC com sistemas R/3. Pode ser um destes valores: v 1100 v 1103 v 8000 v 8300 v 8400 Padro 3 10

long_interval

3600

twsxa_cp

1100

Captulo 20. Arquivos de Opes do Mtodo de Acesso do R/3

121

Tabela 18. Opes de Configurao Geral do R3batch. (continuao) Opo twsxa_lang Descrio O idioma utilizado para efetuar login nos sistemas R/3. Pode ser: v DE para alemo v EN para ingls v JA para japons twsmeth_cp A codificao que o r3batch A pgina de cdigo local deve utilizar para gravar sua sada. Pode ser qualquer uma das pginas de cdigo TIS existentes. O idioma utilizado para relatar as mensagens. Um valor, 0 ou 1, que especifica se r3batch ir aguardar parmetros estendidos codificados no UTF-8. Um valor 1 indica que ir aguardar. A nova tentativa de contagem para as chamadas do mdulo de funo do R/3. Um nmero maior que 0. Definio de permisso/proibio de novos jobs do R/3 por meio do Tivoli Workload Scheduler GUI. Fora o mtodo de acesso a utilizar um modo antigo de copiar jobs. Especifique um valor diferente de zero para ativar. O idioma local 1 Padro EN

twsmeth_lang utf8cmdline

retry

nojobdefs

oldcopy

old_picklist_mode

Essa opo se aplica somente 0 s verses 4.5 e posterior do R/3. Se essa opo estiver desativada (valor 0), a PickList dos jobs ser recuperada por meio do mdulo de funo BAPI_XBP_JOB_SELECT. Se ela estiver ativada (valor diferente de zero), a PickList dos jobs ser recuperada por meio do mdulo de funo BAPI_XBP_JOB_COUNT. Essa opo deve ser desativa, pois o mdulo de funo BAPI_XBP_JOB_COUNT pode ser executado com problemas.

122

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 18. Opes de Configurao Geral do R3batch. (continuao) Opo rfc_open_retry Descrio A nova tentativa de contagem para o abertura de uma conexo RFC para o sistema R/3. O valor um nmero maior que 0 para limitar o nmero de tentativas, -1 usado para no limitar o nmero de tentativas. Padro 5

rfc_open_delay

O mximo de tempo, em 1800 segundos, para aguarda entre duas chamadas consecutivas antes de abrir uma conexo RFC. Se ativado, ele faz com que o OFF mtodo de acesso grave as entradas mais recentes a partir do syslog do R/3 para o arquivo de rastreamento, quando um RFC retornado com um erro geral. Especifique ON para ativar e OFF para desativar. Ativa os recursos de mapeamento RC do Tivoli Workload Scheduler para Aplicativos do R3. Especifique ON para ativar e OFF para desativar. ON

log_r3syslog

rcmap

max_name_counter

O valor mximo do 40 cronmetro de nome da variante. Se o cronmetro de nome pesquisar o valor especificado, ele ser iniciado por 0. Critrio do cronmetro de nome: step O cronmetro de nome aumentado a cada etapa. O cronmetro de nome aumentado uma vez para o job. job

name_counter_policy

job

max_n0_counter

Valor mximo do cronmetro 2^15 - 1 N0. Se o cronmetro N0 pesquisar o valor especificado, ele ser iniciado do 0.

Captulo 20. Arquivos de Opes do Mtodo de Acesso do R/3

123

Tabela 18. Opes de Configurao Geral do R3batch. (continuao) Opo n0_counter_policy Descrio Critrio do cronmetro N0: step O cronmetro N0 aumentado a cada etapa. O cronmetro N0 aumentado uma vez para o job. Padro job

job

Utilizao das Opes de Configurao


O formato do arquivo de configurao CPUname_r3batch.opts o seguinte:
option1=value1 option2=value2 option3=value3 ...

sem espao antes da opo e depois do valor, nem entre eles e entre caracteres iguais. Em r3batch.opts voc pode colocar todas as informaes comuns, como as opes LJuser, IFuser, JobDef e LogFileName, enquanto coloca em um arquivo de configurao local (por exemplo, wkst1_r3batch.opts) dados personalizados para o sistema R/3 de destino do agente estendido (por exemplo, SAP1). Voc pode colocar uma opo local em um arquivo de configurao global se quiser fornecer a mesma opo a todas as instncias do r3batch. Se o nome do usurio do R/3 for o mesmo em todos os sistemas R/3, voc poder colocar a opo r3user no arquivo global sem duplicar as informaes em todos os arquivos de configurao local. Observe que esses arquivos de configurao no so criados durante o processo de instalao. Uma opo global, como job_sem_proj, tem efeito somente no arquivo de configurao global; se voc coloc-la em um arquivo local file, ela no ter efeito. O r3batch l o arquivo de configurao global primeiro e, em seguida, o arquivo local. Ento cada opo (exceto as opes globais) contida no arquivo de configurao local substituir os arquivos globais. Por exemplo, se os arquivos de configurao global e local contiverem a opo r3user, o r3batch utilizar o arquivo local. H seis opes obrigatrias que o r3batch exige; voc pode coloc-las no arquivo de configurao local ou espalh-las entre os arquivos global e local. Por exemplo, voc pode colocar r3user e r3password no arquivo de configurao global e r3sid, r3instance, r3client e r3host no arquivo local. A opo r3user local obrigatria. Ela deve ser colocada no arquivo de configurao global ou no arquivo local.

124

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Migrao de Arquivos de Configurao


Esta seo fornece um exemplo de migrao de arquivos de configurao do r3options para vrios arquivos .opts locais (CPU_r3batch.opts). De um arquivo r3options com o seguinte contedo:
xacpu1 sap1 tv1 00 100 maestro 2QGp4-7JU5-MY2A-mX 30 300 2 xacpu1 sap2 d04 10 200 tws z57I-U5MY-2Amp-4X 30 100 2

Voc pode criar dois arquivos locais, xacpu1_r3batch.opts e xacpu2_r3batch.opts. A seguir est o contedo do xacpu1_r3batch.opts:
R3host=sap1 R3sid=tv1 R3instance=00 R3client=100 R3user=maestro R3password=2QGp4-7JU5-MY2A-mX short_interval=30 long_interval=300 R3auditlevel=2

A seguir est o contedo do xacpu2_r3batch.opts:


R3host=sap2 R3sid=d04 R3client=200 R3instance=10 R3user=tws R3password=z57I-U5MY-2Amp-4X short_interval=30 long_interval=100 R3auditlevel=2

O script Perl a seguir fornece um exemplo para uma migrao automtica. Iniciando com o arquivo r3options, ele produz arquivos de configurao locais.
$r3options = "r3options"; unless (-e $r3options) { die "Error: file $r3options not found\n"; } unless (-r $r3options) { die "Error: file $r3options unreadible \n"; } format OPTSFORMAT = R3host=@<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< $host R3sid=@<<< $sid R3instance=@<< $inst R3client=@<<< $client R3user=@<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< $user R/3password=@<<<<<<<<<<<<<<<<< $passwd short_interval=@<<<< $sint long_interval=@<<<< $lint R3auditlevel=@<< $audit . open (INPUT, "<$r3options");
Captulo 20. Arquivos de Opes do Mtodo de Acesso do R/3

125

while (<INPUT>) { if(!/^#/ && !/^(\s)+$/) { ($cpu,$host,$sid,$inst,$client,$user,$passwd,$sint,$lint,$audit)=split(/ /); $optsfile = $cpu . "_r3batch.opts"; open (OPTSFORMAT,">$optsfile") || die "can not create $optsfile file"; write (OPTSFORMAT); close OPTSFORMAT; } } close INPUT;

Para utilizar essa amostra: 1. Instale um interceptador PERL no seu computador. 2. Copie a amostra em um arquivo aleatrio chamado migrate.pl e armazene-o no diretrio<TWShome>/methods. 3. Execute perl migrate.pl. Os arquivos de configurao locais sero criados no diretrio <TWShome>/methods.

126

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 21. BDC Wait


Com a opo Batch Data Collector (BDC) wait, voc pode especificar que um job do R/3 ativado pelo IBM Tivoli Workload Scheduler no ser considerado concludo at que todas as sesses BDC tenham sido concludas. Isso evita que outros jobs do IBM Tivoli Workload Scheduler, que so dependentes do job do R/3, sejam ativados at que todas as sesses BDC listadas para o job do R/3 tenham sido concludas. Para utilizar a opo, um job do R/3 deve gravar mensagens informativas no joblog. Esse procedimento pode ser feito, incluindo uma instruo de mensagem no relatrio BDCREXX fornecido pela SAP, como descrito a seguir, utilizando o nome da sesso BDC (at 12 caracteres) ou o ID da fila BDC (at 20 caracteres). Vrias mensagens podem ser gravadas para permitir a monitorao de vrias sesses BDC. Alternativamente, se voc no quiser fazer modificaes do R/3, voc poder tambm copiar BDCRECXX com outro nome, por exemplo ZBDCRECXX, fazer as alteraes na cpia e inclu-la em todos os programas que geram sesses BDC. Voc ter que fazer isso manualmente para cada job. Se as sesses BDC no forem criadas com o uso da transao SM35, mas diretamente pelo componente SAP, elas no podero usar o relatrio BDCRECXX. Nesse caso, voc pode fazer modificaes no mdulo de funo fornecido pela SAPBDC_OPEN_GROUP, como descrito a seguir. Observe que voc deve modificar o relatrio BDCRECXX (ou seu cpia ZBDCRECXX) ou o mdulo de funo BDC_OPEN_GROUP. Voc no deve modificar ambos os objetos. Nota: O status de concluso de um job do R/3 ativado pelo IBM Tivoli Workload Scheduler, se SUCC ou ABEND, baseado totalmente no status de execuo do job do batch. Ele no est listado ao sucesso ou falha de quaisquer sesses BDC, que so consideradas concludas independentemente de erros encontrados durante o processamento de BDC. Se voc quiser reagir em relao aos erros de uma sesso BDC, voc pode utilizar o recurso de mapeamento do cdigo de retorno do Tivoli Workload Scheduler, como descrito em Captulo 28, A Biblioteca de Mapeamento do Cdigo de Retorno, na pgina 179.

Utilizando Nomes de Sesso BDC


Para utilizar nomes de sesso BDC, modifique o formato open_group no objeto BDCRECXX do R/3 como se segue: v Para releases do SAP anteriores a 4.6c:
formato open_group. if session = X. skip. write: /(20) Create group(i01), group. skip. * open batchinput group call function BDC_OPEN_GROUP exporting client = sy-mandt group = group user = user keep = keep
Copyright IBM Corp. 2000, 2003

127

holddate = holddate. message i001(92) with group. write: /(30) BDC_OPEN_GROUP(i02), (12) returncode:(i05), sy_subrc. endif. endform.

v Para releases do SAP 4.6c e posterior:


formato open_group. skip. write: /(20) Create group(i01), group. skip. * open batchinput group call function BDC_OPEN_GROUP exporting client = sy-mandt group = group user = user keep = keep holddate = holddate. message i001(92) with group. write: /(30) BDC_OPEN_GROUP(i02), (12) returncode:(i05), sy_subrc. endform.

Quando as sesses BDC forem especificadas por nome, o Tivoli Workload Scheduler no aguardar a sesso BDC nomeada a ser concluda, se houver outras sesses BDC com o mesmo nome sendo concludas. Exemplo Um job do R/3 ativado pelo Tivoli Workload Scheduler inicia trs sesses BDC com o nome ORD2 e emite a seguinte mensagem BDCWAIT:
BDCWAIT:ORD2

Aps a concluso da primeira sesso ORD2, o status do job do R/3 mostrado como SUCC no Tivoli Workload Scheduler. O r3batch no sabe a diferena entre BDCs no exclusivos (isto , chamados BDCs). Outro problema da utilizao de sesses BDC com nomes a questo das diferentes horas do sistema em um ambiente R/3 distribudo. O r3batch varre as sesses BDC com os nomes especificados gerados durante o tempo de execuo do job de criador. Se o job do criador no fizer nada alm de iniciar sesses BDC, o tempo de execuo pode ser muito curto. Se no houver sincronizao de horrio instalada, a hora do sistema de diversas estaes de trabalho normalmente sero diferentes no ambiente R/3. Essa diferena de hora pode ser maior que o tempo de execuo do job. Portanto, possvel que o intervalo de tempo incorreto seja eliminado e as sesses BDC no sejam detectadas. Portanto, recomendado utilizar o mtodo de ID da fila BDC, descrito nas sees a seguir.

Utilizando IDs da Fila BDC com o Relatrio BDCRECXX


Para resolver os problemas causados quando as sesses BDC so especificadas por nome, voc pode especific-las pelo ID de fila, o identificador de sesso BDC de 20 dgitos. Como cada ID de fila atribudo ao R/3 exclusivo, uma mensagem BDCWAIT deve ser emitida para cada ID de fila separado a ser monitorado. Para determinar o ID de fila, modifique o formato open_group no objeto BDCRECXX do R/3 como se segue:

128

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

v Para releases do SAP anteriores a 4.6c:


formato open_group. if session = X. skip. write: /(20) Create group(i01), group. skip. * open batchinput group call function BDC_OPEN_GROUP exporting client = sy-mandt group = group user = user keep = keep holddate = holddate importing qid = myquid. message i001(92) with myqid. write: /(30) BDC_OPEN_GROUP(i02), (12) returncode:(i05), sy_subrc. endif. endform.

v For SAP releases 4.6c and later:


form open_group. skip. write: /(20) Create group(i01), group. skip. * open batchinput group call function BDC_OPEN_GROUP exporting client = sy-mandt group = group user = user keep = keep holddate = holddate importing qid = myquid. message i001(92) with myqid. write: /(30) BDC_OPEN_GROUP(i02), (12) returncode:(i05), sy_subrc. endform.

No se esquea de definir a varivel myqid no BDCRECXX. Com esse mtodo, voc vai obter uma alterao global no sistema R/3.

Utilizando IDs da fila BDC com FM BDC_OPEN_GROUP


As sesses que no forem criadas pela transao SM35, mas por um componente do SAP, pode no utilizar o relatrio BDCREXX. Nesse caso, a melhor soluo para monitorar essas sesses BDC modificar o mdulo de funo do SAP BDC_OPEN_GROUP, como se segue:
FUNCTION BDC_OPEN_GROUP. ... CALL BDC_OPEN_GROUP ID CLIENT FIELD CLIENT ID GROUP FIELD GROUP ID USER FIELD USER ID KEEP FIELD KEEP ID HOLDDATE FIELD HOLDDATE ID DESTINATION FIELD DEST ID QID FIELD QID ID RECORD FIELD RECORD ID PROG FIELD PROG. * IF SY-SUBRC EQ 0. BQID = QID. BUSER = SY-MSGV1. BGROUP = GROUP. * CALL FUNCTION DB_COMMIT.
Captulo 21. BDC Wait

129

CALL FUNCTION ENQUEUE_BDC_QID EXPORTING DATATYP = BDC GROUPID = BGROUP QID = BQID EXCEPTIONS FOREIGN_LOCK = 98 SYSTEM_FAILURE = 99. IF SY-SUBRC EQ 0. message i001(92) with qid. ENDIF. ENDIF. * PERFORM FEHLER_BEHANDLUNG USING SY-SUBRC. * * ENDFUNCTION.

Observe que os parmetros reais da chamada da funo C (CALL BDC_OPEN_GROUP ID ...) podem variar dependendo do nmero do release do SAP. Com esse mtodo, voc vai obter uma alterao global no sistema R/3.

130

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 22. Recursos de Interceptao de Job e Pais-filhos


Este captulo descreve como os recursos de Interceptao de Job e Pais-filhos do BC-XBP 2.0 so suportados pelo Tivoli Workload Scheduler para Aplicativos.

Interceptao de Job
A interceptao de job um recurso da interface do BC-XBP 2.0. Ele permite que o Tivoli Workload Scheduler tenha um controle sofisticado sobre os jobs ativados pelos usurios do R/3 a partir da interface grfica SAP. O mecanismo de interceptao de job torna-se ativo quando programador de job do R/3 est para iniciar o job do R/3 (isto , o momento em que as condies de incio de um job do R/3 forem atendidas). Ele verifica os parmetros do job(nome do job, criador, cliente) nas entradas na tabela do R/3 TBCICPT1 e, quando os parmetros de job atendem aos critrio, o job do R/3 definido para o status planejado e marcado com um sinalizador especial, indicando que o job foi interceptado. Se o Tivoli Workload Scheduler foi configurado para indicar a interceptao do job, ele executar periodicamente seu prprio job para recuperar a lista de jobs interceptados e replanej-los. Esse job pode ser referido como o job do coletor de interceptao. Implemente as seguintes etapas para configurar o Tivoli Workload Scheduler para que ele indique a interceptao de job em um ambiente R/3: 1. Instale a interface do BC-XBP 2.0. 2. Ative o recurso de interceptao de job da interface do BC-XBP 2.0. 3. Defina um job do Tivoli Workload Scheduler para coletar, periodicamente, os jobs do R/3 interceptados. 4. Especifique os critrios de interceptao no sistema R/3. 5. Especifique os critrios de interceptao no Tivoli Workload Scheduler. Observe que os jobs ativados pelo Tivoli Workload Scheduler ou por outro programador externo, com o uso da interface BC-XBP, no podem ser interceptados. Isso ocorre devido ao design do mecanismo de interceptao, que considera somente os jobs cujas condies de incio foram atendidas dentro da restries de tempo ou de evento SAP.

Implementando a Interceptao de Jobs


Esta seo descreve qual ao necessria para implementar a interceptao de job.

Ativando o Recurso de Interceptao de Jobs


Consulte a nota SAP 604496 para saber se o sistema R/3 possui a interface BC-XBP 2.0 ou para saber qual support package SAP instalar para ativ-la. Para ativar o recurso de interceptao de job, execute o relatrio do ABAP INITXBP2. Esse relatrio mostra o status atual dos recursos de interceptao de job e pais-filhos e permite alternar o status de ambos os recursos.

Copyright IBM Corp. 2000, 2003

131

Coletando Jobs Interceptados Periodicamente


Como os jobs interceptados permanecem no status scheduled at que sejam ativados novamente, voc precisar definir um job do Tivoli Workload Scheduler a ser coletado e o reinici-lo. Esta a sintaxe da definio do job para o coletor de interceptao no Tivoli Workload Scheduler:
CPUNAME#JOBNAME SCRIPTNAME "TWShome/methods/r3batch -HIJ -c CPUNAME" DESCRIPTION "Collects intercepted jobs on SAP XA CPUNAME" STREAMLOGON TWSuser RECOVERY STOP

em que: CPUNAME o nome da estao de trabalho de agente estendido. JOBNAME o nome que ser utilizado para o job do Tivoli Workload Scheduler. TWShome o caminho completo para a instalao do Tivoli Workload Scheduler. TWSuser o nome do usurio do Tivoli Workload Scheduler que iniciar o mtodo de acesso. O job do coletor de interceptao deve ser executado em intervalos peridicos; por exemplo, a cada 10 min. Ele ir recuperar todos os jobs que foram interceptados, desde a ltima execuo do coletor de interceptao e ir ativ-los de acordo com um gabarito, como descrito a seguir.

Configurando um Critrio de Interceptao no Sistema R/3


No R/3, os critrios de interceptao esto contidos na tabela TBCICPT1. Somente os jobs que atenderem aos critrios dessa tabela sero interceptados, quando suas condies de incio forem atendidas. Todos os outros jobs sero executados normalmente. Voc pode manter as entradas nessa tabela, utilizando a transaose16. Aqui voc pode definir o seguinte: v Nmero do cliente v Mscara do job v Mscara do usurio.

Configurando os Critrios de Interceptao no Tivoli Workload Scheduler


No Tivoli Workload Scheduler, os critrios de interceptao so definidos e usados por meio de: v Arquivos de critrios de interceptao v Arquivos de gabarito Utilizando Arquivos de Critrios de Interceptao: Os critrios de interceptao para cada sistema R/3 so armazenados em um arquivo separado chamado CPUNAME_r3batch.icp que est localizado no diretrio TWShome/methods/r3batch_icp do host do Tivoli Workload Scheduler. Esse arquivo lido pelo r3batch quando ele executa o job do coletor de interceptao.

132

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Cada linha no arquivo considerada um critrio de interceptao e caracterizada pela seguinte sintaxe:
client job_mask user_mask template

em que client, job_mask e user_mask correspondem s colunas da tabela TBCICPT1, enquanto template o nome do gabarito que deve ser utilizado pelo coletor de interceptao para reativar o job do R/3. Os parmetros so separados por um ou mais espaos. Voc pode utilizar qualquer editor de texto para manter o contedo desse arquivo. Utilizando Arquivos de Gabarito: Um gabarito um arquivo com extenso .jdf localizado no mesmo diretrio (TWShome/methods/r3batch_icp) que o arquivos de critrio de interceptao. O arquivo de gabarito contm instrues para o coletor de interceptao sobre como executar o job interceptado do R/3 sob o controle do Tivoli Workload Scheduler. Sua sintaxe corresponde sintaxe do docommand no conman. Voc pode utilizar qualquer editor de texto para manter esse arquivo. Se o arquivo de gabarito do usurio estiver vazio, um arquivo de gabarito chamadodefault.jdf ser utilizado. Se default.jdf no existir, as seguintes instrues sero utilizadas:
alias=SAP_$RUN_$JOBNAME_$JOBCOUNT

Isso significa que os jobs interceptados do R/3 devem ser reiniciados imediatamente, devido ausncia da opo de job at=. Os nomes do Tivoli Workload Scheduler so compostos de uma cadeia SAP_, o nmero de execuo atual do coletor de interceptao e o nome e o ID do job do R/3. Portanto, o conjunto de instrues para iniciar um job interceptado do R/3 recuperado na seguinte ordem: 1. Do arquivo de gabarito, se um gabarito existente for especificado no arquivo de critrio de interceptao. 2. Do arquivo de gabarito padro, se o gabarito for especificado no arquivo de critrios de interceptao, mas no existir, ou se o gabarito no for especificado no arquivo de critrios de interceptao. 3. Do conjunto de instrues padro, se o arquivo de gabarito padro no existir. Exemplo de Interceptao de Job: A tabela de critrios de interceptao no R/3 contm a seguinte entrada:
000 * fa*

O arquivo de critrios de interceptao no Tivoli Workload Scheduler contm a seguinte entrada:


000 * fa* at1700

O arquivo de gabarito at1700.jdf contm a seguinte entrada:


alias;at=1700

Isso indica que todos os jobs, iniciados no cliente 000 pelos usurios do R/3 cujo nome de usurio comea com fa, sero interceptados. O coletor de interceptao reiniciar os jobs utilizando as instrues do arquivo de gabarito at1700.jdf. Os jobs do R/3 sero iniciados s 17:00 com um nome aleatrio, devido ao comando alias. Utilizando Marcadores: Nos arquivos de gabarito voc pode utilizar uma quantidade de marcadores que substituem o coletor de interceptao no tempo de
Captulo 22. Recursos de Interceptao de Job e Pais-filhos

133

execuo. Eles esto listados na tabela a seguir.


Tabela 19. Marcadores para Arquivos de Gabarito de Interceptao de Job. Marcador $CPU $CLIENT $JOBNAME $JOBCOUNT $USER $JOBNUM $RUN $SCHED $RAND Descrio O nome da estao de trabalho de agente estendido no qual o coletor de interceptao executado. O nmero do cliente do job interceptado do R/3. O nome do job interceptado do R/3. O ID do job interceptado do R/3. O nome do usurio que ativou o job do R/3. O nmero do job do coletor de interceptao. O nmero de execuo atual do coletor de interceptao. O nome de planejamento do coletor de interceptao. Nmero aleatrio.

Portanto, o gabarito
alias=ICP_$RAND_$JOBNAME_$JOBCOUNT_$CLIENT;at=1000

fornecer a instruo para que o coletor de interceptao reinicie o job do R/3 chamado DEMO_JOB com ID de job 12345678 no cliente 100 s 10:00 como o job do Tivoli Workload Scheduler
ICP_1432_DEMO_JOB_12345678_100

Recursos Pais-filhos
Em algumas situaes, um job do R/3 produz dinamicamente uma quantidade de outros jobs; por exemplo, para distribuir a carga de trabalho aos servidores de aplicativo livres. Um exemplo proeminente so os jobs de atividade em massa do componente FI-CA do R/3. Antes do BC-XBP 2.0, era difcil para os programadores externos lidarem com essa situao, pois o processo de negcios no era normalmente concludo com a finalizao do job inicial (job pai), mas com a finalizao de todos os subjobs (jobs filhos). A interface do BC-XBP 2.0 permite determinar se um job tem subjobs ativados, seus nomes e IDs para que seja possvel rastre-los. Para ativar esse recurso, utilize o relatrio INITXBP2 do ABAP, que tambm pode ser utilizado para alternar do status de interceptao do job. Quando o recurso pais-filhos est ativo, o Tivoli Workload Scheduler considera um job do R/3 como concludo depois da finalizao de todos os jobs filhos; em outras palavras, o status do job do Tivoli Workload Scheduler permanece como EXEC durante a execuo do job pai ou de qualquer um dos jobs filhos. O status do job do Tivoli Workload Scheduler torna-se SUCC se o job pai e todos os jobs filhos forem finalizados com sucesso. Se qualquer um dos jobs for finalizado por um erro, o status do job do Tivoli Workload Scheduler torna-se ABEND. Observe que o recurso pais-filhos pode interferir na interceptao do job, embora o job pai no possa ser interceptado, qualquer um dos jobs filhos pode ser

134

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

interceptado se ele atender aos critrios de interceptao. Nesse caso, o job do Tivoli Workload Scheduler permanece no status EXEC at que o job filho interceptado seja reativado e concludo. Os joblogs dos jobs filhos so conectados ao stdlist do Tivoli Workload Scheduler aps o joblog do job pai.

Captulo 22. Recursos de Interceptao de Job e Pais-filhos

135

136

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 23. Suporte Nacional a Idiomas


Utilizando o novo esquema de arquivos de configurao, com arquivos de configurao local e global, voc pode configurar o r3batch para utilizar diferentes pginas de cdigos ou idiomas para sada e conexo com o sistema R/3 remoto. Esse recurso permite que voc instale o r3batch na estao de trabalho localizada do Tivoli Workload Scheduler e utilize caracteres localizados para os nomes de job, fluxos de job e variantes SAP do Tivoli Workload Scheduler. Nota: Certifique-se das configuraes suportadas e das limitaes desse recurso.

Opes de Suporte Nacional a Idiomas


A opo TWSXA_CP afeta a pgina de cdigo utilizada para abrir a conexo entre o r3batch e o sistema R/3 de destino. Seu valor pode ser uma das pginas de cdigo R/3 instaladas no sistema R/3; o valor padro a pgina de cdigo SAP 1100, semelhante ao padro ISO8859-1. TWSXA_LANG afeta o idioma que o r3batch utiliza para efetuar login; ele pode ser um dos itens a seguir: 1. EN (Ingls, o valor padro) 2. GE (Alemo) 3. JA (Japons) TWSMETH_CP a pgina de cdigo que o r3batch utiliza para sua sada. Essa uma opo avanada e pode alterar a sada e o arquivo de log. Seu valor padro a pgina de cdigo usada pela estao de trabalho do Tivoli Workload Scheduler que hospeda o r3batch. Recomendamos o uso dessa opo com cautela. Nota: Isso verdadeiro se voc utilizar o nvel de recurso 1.2 do Job Scheduling Console. O nvel de recurso 1.3 interage com o r3batch por meio do UTF-8, portanto essa limitao no existe mais. TWSMETH_LANG afeta o idioma do catlogo utilizado pelo r3batch. Essa verso contm somente o catlogo de mensagens em ingls, portanto essa opo no tem efeitos reais.

Pginas de Cdigo Suportadas pelo R/3


O Tivoli Workload Scheduler para Aplicativos do R3 pode comunicar-se com o R/3 utilizando as seguintes pginas de cdigo:
Tabela 20. Pgina de Cdigo Suportadas pelo R/3 Pgina de Cdigo do R/3 1100 1103 8000 8300 8400 Descrio 8859-1, o valor padro MS 850 SJIS: Shift JIS BIG5: Chins Tradicional GBK: Chins Simplificado

Copyright IBM Corp. 2000, 2003

137

Configuraes Suportadas e Limitaes


O seguinte se aplica se voc estiver utilizando o nvel de recurso 1.2 do Job Scheduling Console. O nvel de recurso 1.3 interage com o r3batch por meio do UTF-8, portanto essa limitao no existe mais. O Tivoli Workload Scheduler para Aplicativos do R3 deve ser instalado em uma estao de trabalho que utiliza uma pgina de cdigo compatvel com aquela nos sistemas R/3 de destino. Por exemplo, se desejar utilizar o sistema R/3 japons, que usa a pgina de cdigos SAP 8000, voc dever instalar o r3batch em uma estao de trabalho que utilize a pgina de cdigo do japons, como SJIS ou MS932. Se desejar recuperar a sada do r3batch com o Job Scheduling Console, voc deve executar o Job Scheduling Console em um sistema que utilize a mesma pgina de cdigo da estao de trabalho do Tivoli Workload Scheduler, na qual r3batch est instalado. Se o agente de hospedagem utilizar MS932, ento voc dever executar o Job Scheduling Console em um sistema em japons com aquela pgina de cdigo.

138

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 5. Mtodo de Acesso do z/OS

Copyright IBM Corp. 2000, 2003

139

140

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 24. Introduo


O IBM Tivoli Workload Scheduler para Aplicativos do z/OS fornece a habilidade de planejar e controlar os jobs do OS/390 ou do z/OS, utilizando recursos de planejamento de job sofisticados do Tivoli Workload Scheduler. Nota: Neste manual, o termo z/OS utilizado para fazer referncia s verses suportadas do OS/390. Consulte a seo de requisitos de software.

Recursos
v Utilizar o Tivoli Workload Scheduler para planejar jobs do z/OS a serem executados em horrios especficos e na ordem predeterminada. v Definir as dependncias entre os jobs do Tivoli Workload Scheduler em execuo em diferentes plataformas de sistemas. v Definir dependncias para os jobs do Tivoli Workload Scheduler com base na concluso do jobs do z/OS que no foram ativados pelo Tivoli Workload Scheduler. v Definir dependncias para os jobs do Tivoli Workload Scheduler com base na existncia de arquivos em um sistema z/OS.

Requisitos de Software
O IBM Tivoli Workload Scheduler para Aplicativos requer o seguinte software:
Requisitos de Software IBM Tivoli Workload Scheduler Sistema Operacional TCP/IP Verses 7.0 ou superior. OS390 2.10 ou superior ou z/OS. Um dos seguintes: IBM 3.1 ou superior; Interlink 3.1 ou superior; Open Connect 2.3 ou superior. v JES2 ou JES3. v interface OPC: OPC 2.3.0 ou IBM Tivoli Workload Scheduler para z/OS. v interface CA7: qualquer verso suportada atualmente.

Interface de Planejamento de Job

Viso Geral da Instalao


O software IBM Tivoli Workload Scheduler para Aplicativos do z/OS consiste no mtodo de acesso do z/OS que deve estar localizado no host do Tivoli Workload Scheduler e no software de gateway localizado no z/OS. O software de gateway pode ser instalado a partir de um cartucho de fita 3480 ou do CD-ROM do IBM Tivoli Workload Scheduler para Aplicativos. Antes de instalar o mtodo de acesso, certifique-se de que o Tivoli Workload Scheduler esteja instalado corretamente na estao de trabalho do host. 1. No sistema que ser o host do mtodo de acesso para z/OS, se a plataforma em que estiver instalando for uma das seguintes:
Copyright IBM Corp. 2000, 2003

141

v Compaq Tru64 v SGI Irix v IBM Sequent Dynix siga as instrues descritas em Instalando em Plataformas de Nvel 2. Caso contrrio, siga as instrues descritas em Captulo 2, Instalando o IBM Tivoli Workload Scheduler para Aplicativos, na pgina 5. 2. Instale o software de gateway no z/OS. 3. Defina as autorizaes necessrias no z/OS.

Instalando em Plataformas de Nvel 2


O software do mtodo de acesso do z/OS para plataformas de nvel 2 fornecido como um arquivo tar no CD. Siga estas etapas para instal-lo: 1. Pare o Tivoli Workload Scheduler na estao de trabalho em que voc est instalando o mtodo. 2. Efetue logon como raiz e altere o diretrio para twshome/methods. 3. Monte o CD de instalao e restaure o arquivo tar com o seguinte comando:
tar xvf cd_folder/tarfile

em que:
parmetro tar cd_folder tarfile Descrio o nome da unidade ou da pasta de CD. o arquivo TAR dependendo da plataforma de destino. Pode ser um dos seguintes: v TWS4APPS_ZOSAGENT_DYNIX.TAR para IBM Sequent Dynix v TWS4APPS_ZOSAGENT_IRIX.TAR para SGI Irix v TWS4APPS_ZOSAGENT_OSF.TAR para Compaq True 64

4. Execute o seguinte comando no diretrio twshome/methods:


./mvsinstall.sh -user twsuser

Instalando no z/OS
O mdulo de gateway fornecido em dois tipos de mdia: v Um cartucho de fita 3480 que foi gravado no formato no-IDRC (descompactado). v O CD-ROM doIBM Tivoli Workload Scheduler para Aplicativos. Ambas as mdias contm os dois arquivos a seguir: v A biblioteca de carga. v As amostras dos dois procedimentos. Voc pode escolher como far o download dos arquivos, que so idnticos no contedo.

Descarregando os Arquivos do CD-ROM


Os arquivos de gateway so armazenados no diretrio ZOS do CD-ROM do produto e so chamados: v LOADLIB v SAMPLES

142

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Para descarregar os arquivos no sistema z/OS: 1. No emulador da sesso TSO, selecione o shell de comando ISPF (comando TSO) e use o utilitrio Transferncia de Arquivos (Enviar ao Host) para transferir o membro da biblioteca LOADLIB e de SAMPLES do CD-ROM para o sistema z/OS, definindo a transferncia para um comprimento de registro lgico de 80 e um formato de registro fixo. 2. Receba os membros nos conjuntos de dados de sada, utilizando a opo INDSN. Esse procedimento descarregar 11 mdulos de carda na biblioteca de sada e 2 amostras na biblioteca de amostras.

Descarregando os Arquivos da Fita


Modifique e envie um JCL que seja semelhante ao que se segue para descarregar a fita. Personalize a placa do job e modifique os prximos dois parmetros de acordo com os padres do ambiente: v Insira um nome de job apropriado. v Identifique um dispositivo de fita 3480.
//MVSXAUNL JOB (876903,D07),OPCL3,MSGLEVEL=(1,1), // MSGCLASS=A,CLASS=A,NOTIFY=&SYSUID //********************************************************************** //* * //* THIS IS THE JOB THAT UNLOADS THE TIVOLI WORKLOAD SCHEDULER FOR * //* APPLICATIONS z/OS Access Method Version 8.2.0 TO CUSTOMIZE * //* * //********************************************************************** //STEP01 EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //INDD DD DSN=TWSX.V8R2M0.SAMPLES, // DISP=(OLD,PASS),UNIT=600, // VOL=SER=IBM001, // LABEL=(1,SL) //OUTDD DD DSN=TWSX.V8R2M0.SAMPLES, // DISP=(NEW,CATLG), // SPACE=(32760,(2,2,10)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // UNIT=3390,VOL=SER=OPC00C //SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSIN DD * COPY OUTDD=OUTDD,INDD=((INDD,R)) //STEP02 EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //INDD DD DSN=TWSX.V8R2M0.SERVICE.APFLIB1, // DISP=(OLD,PASS),UNIT=600, // VOL=SER=IBM001, // LABEL=(2,SL) //OUTDD DD DSN=TWSX.V8R2M0.SERVICE.APFLIB1, // DISP=(NEW,CATLG), // SPACE=(32760,(50,50,50)), // DCB=(RECFM=U,BLKSIZE=32760), // UNIT=3390,VOL=SER=OPC00C //SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSIN DD * COPY OUTDD=OUTDD,INDD=((INDD,R)) //*

Viso Geral da Instalao


Os componentes do programa z/OS do gateway do Tivoli Workload Scheduler so: EEWTCP02 Esse programa estabelece que o Tivoli Workload Scheduler est rastreando o sistema z/OS. Esse programa iniciado pelo job EEWSPACE.
Captulo 24. Introduo

143

EEWTCP00 Esse o programa de gateway que gerencia as comunicaes TCP/IP entre o Tivoli Workload Scheduler e o sistema z/OS. iniciado pelo job EEWSERVE. O EEWTCP00 converte os comandos do Tivoli Workload Scheduler para comandos equivalentes do z/OS, roteia as informaes de volta para o Tivoli Workload Scheduler e executa as converses de dados EBCDIC-ASCII. Ambos os programas so executados como tarefas de incio, com um parmetro TIME=NOLIMIT. O EEWTCP02 iniciado primeiro sempre, seguido pelo EEWTCP00. Se os programas forem finalizados por algum motivo, eles devem ser parados e no cancelados, para garantir que sejam encerrados sem causar impacto em outros programas que utilizam a Sada IEFU84.

Definindo Autorizaes no z/OS


Depois de instalar o produto no z/OS, autorize a biblioteca de carga. Isso pode ser feito: 1. Emitindo um comando SETPROG do log do console. Por exemplo:
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1, VOL=xxxxxx

em que: xxxxxxx o nmero de srie do volume em que a biblioteca de carga est localizada ou:
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1,VOL=SMS

que indica um volume sob o controle do SMS. 2. Atualize o membro PROGxx do SYS1.PARMLIB ou a autorizao ser perdida no prximo IPL. 3. Inclua EEWTCP00 na seo AUTCHCMD NAMES do SYS1.PARMLIB(IKJTSOxx).

Observaes Adicionais
As sees a seguir fornecem informaes adicionais sobre o funcionamento do agente estendido.

Sada IEFU84
O agente estendido para os fluxos de job de trilha do z/OS utilizam a sada IEFU84. Essa sada dever ser ativada no membro do parmetro SMF no SYS1.PARMLIB. A IBM distribui uma sada IEFU84 de dummy com o sistema operacional que um programa IEFBR14. O job EEWSPACE (discutido posteriormente) ser encadeado dinamicamente sada IEFU84. Se a sada IEFU84 estiver em uso, o EEWSPACE ser de front-end para a sada IEFU84, obter as informaes necessrias e ramificar a sada do usurio existente. Quando o EEWSPACE for finalizado, ele ser removido da cadeia e a cadeia ser restaurada para o seu status original. importante notar que o EEWSPACE no ter efeito na sada IEFU84 existente, que continuar a ser executada normalmente.

Segurana
A segurana reforada em vrias reas, normalmente, RACF, Top Secret, ACF2, etc. O job EEWSERVE (discutido posteriormente) deve ter a habilidade de enviar jobs que so executados sob IDs de usurio fornecidos no JCL a ser enviado. O JCL no deve conter senhas. Isso pode ser autorizado com o uso de recursos de classe SURROGAT no RACF e os equivalentes no ACF2 e no Top Secret. Os recursos de classe PROPCNTL no RACF devem ser usados para evitar que jobs enviados sejam executados sob um ID do usurio EEWSERVE. Equivalentes do ACF2 e Top Secret

144

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

tambm podem ser usados. A classe de recurso JESJOBS no RACF, e os equivalentes do ACF2 ou do Top Secret, pode ser usada para controlar quais os nomes e ID de usurio de jobs (com ou sem senhas) que podem ser enviados pelo EEWSERVE. Note que o Tivoli Workload Scheduler no suporta o uso da segurana do CA-7.

Segurana do Console
O job EEWSERVE (discutido posteriormente) envolve completamente o console ao exibir os fluxos de job e ao emitir comandos de modificao para CA-7. Ele deve ter autoridade para utilizar um console estendido. Consulte o administrador de segurana para garantir que esse seja o caso. Note que o CA-7 deve ser configurado para permitir que usurios emitam comandos de modificao por meio do master ou de consoles estendidos. OPERCMDS deve ser modificado para permitir essa funcionalidade, se ainda no tiver sido permitida. Consulte tambm Variveis SYSTSIN para obter informaes sobre como especificar um ID de usurio de autoridade. Segurana externa (consulte Segurana acima) pode ser utilizada para autorizar o usurio do CA-7 especificado para EEWSERVE, desde que o Workload Scheduler no suporte o fornecimento de uma senha com o nome do usurio.

Iniciar
Sigas estas etapas: 1. Personalize e inicie o procedimento EEWSPACE (seguindo as instrues contidas aqui) para iniciar o Gateway Data Space do agente estendido. O job deve ser uma tarefa de incio e no deve ser cancelado. Consulte Variveis SYSTSIN para obter uma descrio das definies de parmetro. O EEWSPACE ir criar o Data Space e instalar a sada IEFU84. Para finalizar o job, utilize o comando STOP EEWSPACE a partir de qualquer console do z/OS. Notas: a. EEWSPACE deve estar ativo antes de o EEWSERVE ser iniciado. b. Para encerrar, pare o EEWSERVE antes de parar o EEWSPACE. 2. Personalize e inicie o procedimento EEWSERVE, seguindo as instrues contidas aqui. Consulte Variveis SYSTSIN para obter uma descrio das definies de parmetro. 3. Para finalizar o job, utilize o comando STOP EEWSERVE de qualquer console do z/OS.

Variveis SYSTSIN
As variveis SYSTSIN so descritas abaixo. Voc pode modificar as definies conforme necessrio para a configurao do site. As definies padro esto entre parnteses.
Tabela 21. Variveis SYSTSIN. Varivel CA7INTERFACE(CONSOLE) Descrio CONSOLE a nica interface suportada para CA-7 e o valor padro para essa varivel. Defina para NO se no quiser utilizar essa interface. O nome do espao de endereo da regio de controle do CA-7. Ignorada se o CA-7 no for utilizado.
Captulo 24. Introduo

CA7NAME(CA7ONL)

145

Tabela 21. Variveis SYSTSIN. (continuao) Varivel CA7OPTIONS(X32) Descrio As opes de release do CA-7. O padro determinado por meio da entrada da tabela do vetor de subsistema do CA-7 e voc no deve alter-lo a menos que orientado para fazer isso pelo Suporte Tcnico da IBM. Essa varivel se aplica exclusivamente interface do CA7. O nmero representa o intervalo mnimo (em hora e minutos) depois do qual possvel ativar do Tivoli Workload Scheduler o mesmo job sem especificar um SCHID diferente. O padro intencionalmente definido para 9999, um valor invlido, para que seja possvel distinguir o caso em que a varivel no utilizada. Se especificado, ele deve ser um nmero de 4 dgitos no formato HHMM. Por exemplo: v CA7SPAN(0010) significa 10 minutos. v CA7SPAN(0130) significa 1 hora e 30 minutos. Consulte Outras Dicas do CA-7 na pgina 159 para obter mais detalhes. O intervalo mnimo em minutos (quatro dgitos) aps o qual possvel ativar o mesmo job do Tivoli Workload Scheduler sem especificar um SCHID diferente. Ignorar se voc definir CA7INTERFACE igual a NO. CA7SUBSYSTEM(UC07) CA7USER(CA7CNSL) O nome do subsistema CA-7. O ID do usurio utilizado para emitir comandos do CA-7. Ignorada se o CA-7 no for utilizado.

CA7SPAN(9999)

146

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 21. Variveis SYSTSIN. (continuao) Varivel COMPLETIONCODE(LASTSTEP/MAXSTEP) Descrio A opo de cdigo de concluso do job de multi-etapas do JES padro. LASTSTEP, o padro, indica que o cdigo de concluso para um job multi-etapas do JES determinado pela ltima etapa executada no job. MAXSTEP indica que o cdigo de concluso determinado pelo cdigo de concluso mais alto de qualquer etapa executada no job. Essa varivel define o padro para os jobs que no tm a opo de substituio na configurao do Tivoli Workload Scheduler para o job. Se definido para YES, ela far com que o gateway produza mensagens de diagnstico. Utilize somente de acordo com o Suporte Tcnico da IBM. O nome do subsistema utilizado pela pilha Interlink TCPIP. Ignorada se o Interlink no estiver sendo usado como a pilha TCPIP. O caractere de reconhecimento do comando do job. O padro definido para o sinal de dlar ($) para sistemas JES2 e asterisco (*) para sistemas JES3. Essa varivel deve ser alterada somente se um caracter de reconhecimento de comando diferente estiver sendo utilizado. A quantidade mxima de tempo, em centsimos de segundo, para aguardar uma resposta aos comandos. Ignorar se voc definir CA7INTERFACE igual a NO. A quantidade de armazenamento, em megabytes, utilizada pelo console estendido e pelo gateway. Ignorar se voc definir CA7INTERFACE igual a NO. PIF a nica interface suportada para OPC ou Tivoli Workload Scheduler para z/OS e o valor padro para essa varivel. Defina para NO se no quiser utilizar essa interface.

DEBUG(NO)

INTERLINKSUBSYSTEM(ACSS)

JESCMDCHR($)

MAXWAIT(500)

MCSSTORAGE(3)

OPCINTERFACE(PIF)

Captulo 24. Introduo

147

Tabela 21. Variveis SYSTSIN. (continuao) Varivel OPCMSGCLASS(*) Descrio A classe de mensagem para os logs de mensagem alocados dinamicamente, utilizados pelo OPC ou pelo Tivoli Workload Scheduler para z/OS. O asterisco faz com que a classe seja definida como sendo a mesma de EEWSERVE. Ignorada se OPC ou Tivoli Workload Scheduler para z/OS no estiverem sendo utilizados. O nome do subsistema utilizado para comunicaes com a regio de controle do OPC ou do Tivoli Workload Scheduler para z/OS. O padro, 0 0 0 0, permite o acesso por qualquer host. Para obter melhor segurana, insira o endereo IP do host do Workload Scheduler do z/OS x-agent. Observao: No inclua . (ponto) entre os 0s no cdigo. Os pontos sero ativados na exibio! O nmero da porta TCP utilizada pelo Tivoli Workload Scheduler e o gateway para comunicaes. Esse deve ser o mesmo valor inserido no campo Endereo TCP da definio de estao de trabalho do z/OS x-agent. Quando definida para YES, ela direciona as informaes de rastreamento para DDNAME SYSTSPRT. O nmero mximo de mensagens a serem colocadas em fila no console estendido. O prefixo utilizado pelo agente estendido para z/OS como os primeiros quatro caracteres dos nomes de console estendidos. Ela tambm usada como os primeiros quatro caracteres da leitora interna DDNAMES. Faa as alteraes somente de acordo com o Suporte Tcnico da IBM. Quando definida para YES, os abends causaro um dump do SVC. Utilize somente de acordo com o Suporte Tcnico da IBM. O fornecedor da pilha TCPIP (IBM, INTERLINK ou OPENCONNECT).

OPCSUBSYSTEM(OPCS)

PEERADDRESS(0 0 0 0)

PORT(5000)

PUTLINE(YES)

QLIMIT(2000)

SUBSYS(UNIS)

SVCDUMP(NO)

TCPIPSTACK(IBM)

148

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tabela 21. Variveis SYSTSIN. (continuao) Varivel TCPNAME(TCPIP) Descrio O nome do espao de endereo TCPIP quando a verso da pilha TCPIP da IBM utilizada. O caractere de finalizao da transao. No faa alteraes no padro a menos que orientado para fazer isso pelo Suporte Tcnico da IBM. Quando definida para YES, ela direciona as informaes de rastreamento para SYSLOG como uma informao gravada para o programador. Isso pode ser utilizado se SYSTSPRT no atender s suas necessidades. Quando utilizar o CA-7, PUTLINE(YES) e WTP(NO) so exigidos se DEBUG(YES). ZOSV1R2(NO) Defina para YES se estiver utilizando a interface JES3 com o z/OS V1R2 ou posterior. Esse parmetro ignorado se voc no estiver usando a interface JES3, pois: v Se voc estiver utilizando a interface JES2, o nvel do sistema operacional no far diferena para o produto. v Se voc estiver utilizando o CA7 ou o Tivoli Workload Scheduler para interfaces z/OS, o suporte do z/OS V1R2 ou posterior est assegurado, pelo tempo em que o release do subsistema correspondente suport-lo.

TERMINATOR(X25)

WTP(NO)

Verses de Gateway do z/OS


A verso do EEWSERVE (e EEWSPACE) exibida na primeira linha do log EEWSERVE (e EEWSPACE). Por exemplo:
EEWTCP10 VERSION RELEASE MODIFICATION LEVEL = VxRyMz

em que VxRyMz contm os nveis de verso, release e modificao.

Captulo 24. Introduo

149

150

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 25. Configurao e Operao


O Tivoli Workload Scheduler ativa os jobs em um agente estendido para estao de trabalho z/OS. O agente estendido para o z/OS configurado na definio de estao de trabalho do Tivoli Workload Scheduler padro, que fornece um nome a ele e identifica o mtodo de acesso a ser utilizado. O agente estendido para a estao de trabalho z/OS uma definio de estao de trabalho vinculada a uma instncia do sistema z/OS. Para ativar um job em um agente estendido para a estao de trabalho z/OS, o Tivoli Workload Scheduler executa o mtodo de acesso, transmitindo informaes sobre o job. O mtodo de acesso comunica-se com a instncia do host do z/OS e monitora o job at a concluso, gravando as informaes de progresso e status do job no arquivo de lista padro de job. Este captulo descreve como: v Criar um arquivo de opes para selecionar opes para um mtodo. v Definir um agente estendido para o job do z/OS v Planejar um agente estendido para o job do z/OS Consulte Captulo 4, Definindo as Estaes de Trabalho de Agente Estendido, na pgina 31 para saber como definir uma estao de trabalho de agente estendido no Tivoli Workload Scheduler.

Arquivos de Opes de Mtodo


Em todas as plataformas suportadas, exceto Compaq Tru64, SGI Irix e IBM Sequent Dynix, utilize o Editor de Opes para criar os arquivos de opes necessrios. Consulte Captulo 3, Definindo Opes com o Editor de Opes, na pgina 27 para obter referncia.

Arquivos de Opes de Mtodo em Plataformas de Nvel 2


No Compaq Tru64, SGI Irix e IBM Sequent Dynix, crie um arquivo de opes para selecionar opes para um mtodo. O arquivo deve ter o mesmo nome de caminho que o mtodo e a extenso opts. Por exemplo, crie os seguintes arquivos no UNIX (assumindo que o diretrio inicial do Tivoli Workload Scheduler seja /usr/lib/tws):
/usr/lib/tws/methods/mvsca7.opts /usr/lib/tws/methods/mvsjes.opts /usr/lib/tws/methods/mvsopc.opts

Ou crie os seguintes arquivos no Windows (assumindo que o Tivoli Workload Scheduler esteja instalado no caminho C:\WIN32APP\tws):
c:\win32app\tws\methods\mvsca7.opts c:\win32app\tws\methods\mvsjes.opts c:\win32app\tws\methods\mvsopc.opts

Copyright IBM Corp. 2000, 2003

151

Para mvsca7, mvsjes e mvsopc as entradas do arquivo de opes so:


Entradas do Arquivo de Opes LJuser=name Descrio Atribua um nome de usurio utilizado pelo mtodo de acesso para ativar jobs. Deve ser um usurio vlido do UNIX ou do Windows que envie jobs locais e possa conectar-se ao gateway do z/OS do Tivoli Workload Scheduler no sistema z/OS. O padro parmetro de login na definio do job. (Necessrio) Atribua o nome do usurio utilizado pelo mtodo de acesso para verificar as dependncias do arquivo. Ele pode ser o mesmo do LJuser. (Opcional) Atribua o nome do usurio utilizado pelo mtodo de acesso para verificar jobs no ativados pelo Tivoli Workload Scheduler no z/OS, usados como dependncias. O padro raiz. (Opcional) Define a taxa de polling, em minutos, para verificao do status dos jobs do z/OS que foram ativados pelo mtodo. Valores fracionados so aceitos; por exemplo 0.5 para 30 segundos ou 1.5 para um minuto e 30 segundos. O padro 2. Ao verificar os jobs que no foram ativados pelo Tivoli Workload Scheduler no z/OS, usados como dependncias, o mtodo utiliza a opo local do Tivoli Workload Scheduler status de verificao bm em vez de CheckInterval para determinar a taxa de polling. BlockTime=min (Opcional) Define a quantidade de tempo, em minutos, que o mtodo aguardar para obter uma resposta para uma verificao de status antes expirao de tempo. Esse valor deve ser menor que o valor de CheckInterval (descrito acima) e da opo local do Tivoli Workload Scheduler status de verificao bm. Valores fracionados so aceitos; por exemplo 0.5 para 30 segundos ou 1.5 para um minuto e 30 segundos. O padro 2. (Opcional) Define o nmero de vezes da tentativa de verificao de status antes de o Tivoli Workload Scheduler gravar uma mensagem para um arquivo de stdlist do job e marc-lo no estado abend. Consulte CheckInterval eBlockTime acima para obter informaes adicionais. O padro 10.

CFuser=name

GSuser=name

CheckInterval=min

RetryCount=count

Definindo Jobs no z/OS


No z/OS, os jobs planejados com o Tivoli Workload Scheduler so definidos como predeterminados para JES, CA-7 e OPC ou Tivoli Workload Scheduler para z/OS.

Definindo Jobs do z/OS no Tivoli Workload Scheduler


As definies de job do Tivoli Workload Schedulerso necessrias para cada job z/OS que voc deseja planejar e ativar com o Tivoli Workload Scheduler. Eles so definidos como outros jobs do Tivoli Workload Scheduler e incluem o nome do job, o nome do usurio, as opes de nome de script especial e as opes de recuperao opcionais.

152

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Consulte Captulo 5, Definindo os Jobs de Agente Estendido, na pgina 37 para obter referncia.

Sintaxe de Definio de Tarefas para Jobs do z/OS Planejados com o Tivoli Workload Scheduler
A seguir esto descries de sintaxe de definio de tarefas (linha de comando scriptname) para os jobs do z/OS que o Tivoli Workload Scheduler planeja e ativa por meio de estaes de trabalho de agente estendido, utilizando os mtodos mvsjes (jobs do JES2/3), mvsca7 (jobs do CA-7) ou mvsopc (jobs do OPC ou do IBM Tivoli Workload Scheduler para z/OS). Voc especifica esses parmetros de cadeia de tarefas nos seguintes locais quando definir os jobs do Tivoli Workload Scheduler associados: v No campo Comando da pgina Tarefa da janela Propriedades - Definio de Job, se estiver usando o Job Scheduling Console. v Como argumentos da palavra-chave nome_do_script na instruo de definio do job, se estiver usando a linha de comando do Tivoli Workload Scheduler. v Como argumentos da palavra-chave JOBCMD na instruo JOBREC no SCRIPTLIB do Tivoli Workload Scheduler para z/OS, se voc estiver planejando em um ambiente ponto a ponto.

Para jobs do JES:


A sintaxe :
dataset [<|= condcode]

em que: dataset O nome do conjunto de dados do job do JES ou do conjunto de dados particionado. condcode O cdigo de condio que indica a concluso bem-sucedida do job. Se antecedido por <, o cdigo de condio deve ser menor ou igual a esse valor. Se antecedido por =, o cdigo de condio deve ser igual a esse valor. Se omitido, = 0000 ser utilizado. Observe que deve haver um espao nos dois lados do operador (< ou =). Exemplo:
gold.apayable.cntl(apayjob1) = 0004

Para jobs do CA-7:


A sintaxe :
jobname [SCHID(nnn)] [CC(nnnn) [RO(EQ|LT|GT|GE|LE|NE|#S|IG|NO) [SET(SKP|NTR|NDB) ] [...] ] ]

em que: jobname O nome do job no CA-7. SCHID O ID de planejamento (um nmero de 1 a 255) a ser atribudo ao job. CC O cdigo de condio utilizado com o RO que indica a concluso bem-sucedida do job.
Captulo 25. Configurao e Operao

153

RO SET

O operador relacional para o cdigo de condio CC. Define as opes do job para ignorar a prxima execuo planejada (SKP), desativa o acionamento padro do job (NTR) ou ignora o carregamento do banco de dados na concluso (NDB).

Para obter uma descrio completa dos parmetros, consulte o Guia de Comandos do CA-7. Exemplo:
ARCVJOB SCHID(203) CC(0001) RO(EQ) SET(NDB)

Para jobs do OPC ou do Tivoli Workload Scheduler para z/OS:


A sintaxe :
appl [IA(yymmddhhmm)|IATIME(hhmm) [PRIORITY(pri) [CPDEPR(Y|N|P|S) ] [...] ] ] [DEADLINE(yymmddhhmm)|DEADLINETIME(hhmm) ]

em que: appl IA O nome do aplicativo OPC ou Tivoli Workload Scheduler para z/OS a ser inserido no plano atual. A data e a hora de chegada da entrada no formulrio: aammddhhmm .

IATIME A hora de chegada da entrada no formulrio: hhmm. DEADLINE A data e a hora de chegada do prazo final no formulrio: aammddhhmm. DEADLINETIME A hora de chegada do prazo final no formulrio: hhmm. PRIORITY A prioridade (1-9) na qual o aplicativo ser executado.. CPDEPR A seleo de resoluo de dependncia do plano atual. Y N P S Inclui todas as dependncias sucessoras e predecessoras. No inclui nenhuma dependncia. (O padro.) Inclui dependncias predecessoras. Inclui dependncias sucessoras.

Para obter uma descrio completa dos parmetros, consulte a documentao do OPC ou do Tivoli Workload Scheduler para z/OS. Exemplo:
PREFABJOB44 IA(0202181000) PRIORITY(5) CPDEPR(Y)

Sintaxe de Definio de Tarefas para Outros Jobs do z/OS


A seguir esto descries da sintaxe de definio de tarefas (linha de comando scriptname) para jobs do z/OS que no foram ativados pelo Tivoli Workload Scheduler, mas que devem ser monitoras para concluso. A concluso desses jobs do z/OS pode ser utilizada como dependncias follows para os jobs ativados

154

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

pelo Tivoli Workload Scheduler. Os jobs no ativados pelo Tivoli Workload Scheduler podem ser JES, CA-7, OPC ou Tivoli Workload Scheduler para z/OS. A sintaxe bsica :
tws-job follows xagent::"mvs-job"

em que: tws-job O nome do job do Tivoli Workload Scheduler que depende da concluso do job do z/OS especificado. xagent O nome da estao de trabalho x-agent do Tivoli Workload Scheduler associado ao programador de job do z/OS isto , um x-agent definido com o mtodo mvsjes, mvsca7 ou mvsopc. Observe que os dois-pontos so delimitadores necessrios. mvs-job A identificao do job do z/OS. Observe que essa cadeia deve estar entre aspas. Consulte as descries de sintaxe abaixo.

Para jobs do JES:


A sintaxe :
"jobname[<|= condcode]"

em que: jobname O nome do job no JES. condcode O cdigo de condio que indica a concluso bem-sucedida do job. Se antecedido por <, o cdigo de condio deve ser menor ou igual a esse valor. Se antecedido por =, o cdigo de condio deve ser igual a esse valor. Se omitido, = 0000 ser utilizado. Observe que deve haver um espao nos dois lados do operador (< ou =). Exemplo:
job5 follows jesworkstation::"apayable = 0004"

Para jobs do CA-7:


A sintaxe :
"jobname [SCHID(nnn) [DATE(*|*yyddd)} [SPAN( {* }) {scope } {date } {(startdate,starttime,scope) } {(startdate,starttime,enddate,endtime) } ] [...]" ] ]

em que: jobname O nome do job no CA-7. SCHID O ID de planejamento (um nmero de 1 a 255) do job. DATE Uma data de log especfica a ser pesquisada para o job.

Captulo 25. Configurao e Operao

155

SPAN A extenso dos registros de log a ser pesquisada para o job. Para obter descries completas dos parmetros, consulte oGuia de Comandos do CA-7. Por exemplo:
joba follows workstation::"arcvjob schid(203) span(12)"

Consulte tambm Outras Dicas do CA-7 na pgina 159

Para jobs do OPC ou do Tivoli Workload Scheduler para z/OS:


A sintaxe :
"application[IA(yymmddhhmm)|IATIME(hhmm)][...]" [JOBNAME(jobname) [OPNO(num) ] ]

em que: application O nome do aplicativo OPC ou Tivoli Workload Scheduler para z/OS (fluxo de job) no plano atual. IA A data e a hora de chegada da entrada.

IATIME A hora de chegada da entrada. JOBNAME O nome do job do z/OS. OPNO O nmero da operao (1-255). Se incluso, o aplicativo ser considerado concludo quando ele atingir esse nmero de operao. Para obter uma descrio completa dos parmetros, consulte a documentao doOPC ou do Tivoli Workload Scheduler para z/OS. Por exemplo:
joba follows opcworkstation::"PREFABJOB44 IA(0202181000) JOBNAME(PFJ3)"

Sintaxe de Dependncias de arquivo (OPENS) em arquivos do z/OS


O job e os fluxos de job do Tivoli Workload Scheduler podem utilizar arquivos do z/OS como dependncias. A sintaxe bsica :
tws-job opens xagent#"hlq1.hlq2.hlq3"

em que: tws-job O nome do job do Tivoli Workload Scheduler que depende do arquivo especificado do z/OS. xagent O nome da estao de trabalho x-agent do Tivoli Workload Scheduler associado ao programador de job do z/OS isto , um x-agent definido com o mtodo mvsjes, mvsca7 ou mvsopc. Observe que um sinal # um delimitador obrigatrio. hlq1.hlq2.hlq3 A identificao do arquivo do z/OS em termos de qualificador de nvel alto. Observe que essa cadeia deve estar entre aspas. Consulte Verificando Arquivos no z/OS na pgina 161 para informaes adicionais.

156

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 26. Informaes de Referncia


Viso Geral Tcnica
Este captulo descreve os estados do job ao operar o JES, CA-7 e OPC ou o Tivoli Workload Scheduler para z/OS no ambiente Tivoli Workload Scheduler.

Operao com o JES


O que se segue aplicado ao operar com JES.

Ativando Jobs do JES


Para ativar e monitorar um job do JES, o Tivoli Workload Scheduler transmite o nome do conjunto de dados do JCL ou pds que ele deseja executar para o gateway do z/OS, que, conseqentemente, o envia ao JES. As submisses ocorrem com a utilizao de leitoras internas alocadas dinamicamente no JES. O gateway aloca uma leitora interna no incio de cada tarefa e, em seguida, envia o job para a leitora. Quando um job enviado, o nome dele e o ID do Job do JES tambm so inseridos no espao de tabelas. Quando um registro do SMF, contendo dados de um planejamento de job relevante, transmitido por meio da sada IEFU84, as informaes do job e do cdigo de condies so disponibilizadas para o Tivoli Workload Scheduler. Como o Workload Scheduler manter uma monitorao do nome do job e do ID do Job do JES, ele permite verificar o job especfico enviado. (Atualmente o gateway utiliza registros SMF Tipo 30 e tambm os subtipos 1,4,5.) O Tivoli Workload Scheduler verifica os jobs enviados periodicamente para ver se eles esto ativos. Se um job enviado do Tivoli Workload Scheduler no estiver ativo e nenhuma informao sobre ele for encontrada por meio da sada IEFU84, o job ser marcado como abend na exibio do Tivoli Workload Scheduler. Essa situao pode ocorrer se um job falhar por razes de segurana ou por problemas de sintaxe do JCL. Estados do Job do JES: A tabela a seguir lista os estados de job do JES com relao ao Tivoli Workload Scheduler.
Estado do Job do Tivoli Workload Scheduler Estado do Job do JES intro wait wait n/a Em fila n/a Se o job permanecer nesse estado, pode ser devido violao de segurana no z/OS. Verifique o job no sistema z/OS. O job est em execuo. O cdigo de condio do job atende aos critrios de concluso da definio de job do Tivoli Workload Scheduler.

Comentrios O Workload Scheduler est iniciando o mtodo.

exec succ

Em execuo Concludo

Copyright IBM Corp. 2000, 2003

157

Estado do Job do Tivoli Workload Scheduler Estado do Job do JES abend Concludo

Comentrios O cdigo de condio do job no atende aos critrios de concluso da definio de job do Tivoli Workload Scheduler ou ocorreu um abend de sistema ou de usurio. Os cdigos de abend do sistema, em hex, possuem o prefixo S; os cdigos de abend do usurio, em decimal, possuem um prefixo U. Ambos os tipos de cdigo so gravados no arquivo stdlist do job. Status desconhecido. Pode ocorrer somente ao verificar um job que utilizado como uma dependncia.

extrn

n/a

Verificando os Jobs do JES: Para verificar um job do JES que no foi ativado pelo Tivoli Workload Scheduler, o nome do job e transmitido pelo Tivoli Workload Scheduler para o Gateway. Como o Tivoli Workload Scheduler no enviou o job, o ID do Job do JES no est disponvel. O Gateway insere o nome no Espao de tabela e aguarda informaes sobre o job exibidas nos registros do SMF, transmitidas pela sada IEFU84.

Operao com o CA-7


O que se segue aplicado ao operar com o CA-7.

Ativando Jobs do CA-7


Para ativar e monitorar um job do CA-7, o Tivoli Workload Scheduler transmite o nome do job e, opcionalmente, o schedID de CA-7, que deseja executar para o Gateway do z/OS. No momento da solicitao de envio, o Gateway recebe o Nmero do Job do CA-7 que utilizado para rastrear todas as atividades subseqentes do job. importante observar que o prprio CA-7 deve ser autorizado para aceitar comandos a partir de um console para que o mecanismo funcione. Consulte a documentao do CA-7 para obter informaes adicionais sobre os comandos Modify e Login e sobre os recursos.

Estados do Job do CA-7


A tabela a seguir lista os estados de job do CA-7 com relao ao Tivoli Workload Scheduler.
Estado do Job do Tivoli Workload Scheduler intro wait

Estado do Job do CA-7 n/a Fila Solicitao ou Fila Pronto

Comentrios O Workload Scheduler est iniciando o mtodo. O estado wait pode indicar tambm que o job foi movido da fila Ativa para a fila Solicitao como resultado de um abend. O job permanece na fila Solicitao, com um prompt de reincio, at que o operador reinicie ou cancele o job.

exec succ

Fila Ativo Concludo O cdigo de condio do job atende aos critrios de concluso da definio de job do Tivoli Workload Scheduler.

158

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Estado do Job do Tivoli Workload Scheduler abend

Estado do Job do CA-7 n/a

Comentrios O cdigo de condio do job no atende aos critrios de concluso da definio de job do Tivoli Workload Scheduler. Leia a nota abaixo. Status desconhecido. Pode ocorrer somente ao verificar um job que utilizado como uma dependncia. Leia a nota abaixo.

extrn

n/a

Nota: Se o job permanecer nos estados abend ou extrn, pode ser devido violao de segurana no z/OS. Verifique o job no sistema z/OS.

Verificando os Jobs do CA-7


Para verificar um job do CA-7 que no foi ativado pelo Tivoli Workload Scheduler, o nome do job transmitido pelo Tivoli Workload Scheduler para o Gateway. Para ver se o job est sendo planejado ou executado, atualmente, pelo CA-7, o Gateway procura as seguintes filas do CA-7, nesta ordem: fila Solicitao, fila Pronto e fila Ativo. Se o job no for encontrado, o Tivoli Workload Scheduler verificar novamente a taxa definida pelo valor do status de verificao bm no arquivo de Opes Locais.

Outras Dicas do CA-7


v Ao utilizar o CA-7, o CA7USER tambm deve ser um ID do UNIX vlido. v A limitao que nas verses anteriores do produto forava os usurios a identificar ocorrncias, exclusivamente, ao definir os jobs do CA-7 no Tivoli Workload Scheduler (isto , incluindo os operandos SCHID e/ou SPAN) foram removidas graas aos novos parmetros de inicializao do CA7SPAN. A lgica por detrs da implementao do CA7SPAN a seguinte: se SPAN for especificado na definio do Tivoli Workload Scheduler de um job, ento o CA7SPAN ser ignorado. Se o SPAN no for especificado (ou no puder ser especificado, como no caso dos jobs ativados pelo Tivoli Workload Scheduler), ento o CA7SPAN ser considerado e seu valor ser utilizado nas consultas para o CA7 como o SPAN. Isso evita a limitao de acordo com a qual cada ocorrncia deve ser identificada exclusivamente e torna possvel ativar, do Tivoli Workload Scheduler, o mesmo job com o mesmo SCHID, com apenas uma condio em que o intervalo entre 2 envios deve ser maior que o valor especificado com o CA7SPAN. importante saber que, se especificado, o valor do CA7SPAN ser utilizado em todas as consultas no CA7 (se elas se referirem aos jobs ativados pelo Tivoli Workload Scheduler ou se elas forem emitidas para verificar as dependncias entre as redes para os jobs no ativados pelo Tivoli Workload Scheduler) com somente a exceo daqueles jobs que foram especificados na definio do Tivoli Workload Scheduler. v Se voc executar produtos como AFOPER que substituem as mensagens do console, certifique-se de eles no substituam as mensagens do CA-7.

Operao com OPC ou Tivoli Workload Scheduler para z/OS


O que se segue aplicado ao operar com o OPC ou com o Tivoli Workload Scheduler para z/OS.

Captulo 26. Informaes de Referncia

159

Ativando os Jobs do OPC ou do Tivoli Workload Scheduler para z/OS


Para ativar e monitorar um job do OPC ou do Tivoli Workload Scheduler para z/OS, o Tivoli Workload Scheduler transmite o nome do aplicativo e os outros parmetros opcionais que deseja executar para o Gateway do z/OS. Se ele existir no banco de dados do OPC ou do Tivoli Workload Scheduler para z/OS, o aplicativo ser inserido no plano atual. Os parmetros de resoluo de chamada de entrada, chegada de prazo final, prioridade de dependncia automtica, se includo, substituem qualquer valor especificado no no OPC ou Tivoli Workload Scheduler para z/OS. Na taxa definida pelo valor CheckInterval no arquivo de opes do mtodo, o Tivoli Workload Scheduler verifica o status da ocorrncia (aplicativo) no OPC ou no Tivoli Workload Scheduler para z/OS.

Estados das Operaes do OPC ou do Tivoli Workload Scheduler para z/OS


A tabela a seguir lista os estados da operao do OPC ou do Tivoli Workload Scheduler para z/OS com relao ao Tivoli Workload Scheduler.
Estado do Job do Tivoli Workload Scheduler wait wait wait wait exec succ abend abend abend abend extrn Estado da Operao do OPC ou do Tivoli Workload Scheduler para z/OS pendente no decidido em espera pronto iniciado concludo interrompido erro excludo n/a n/a

Estados de Ocorrncia do OPC ou do Tivoli Workload Scheduler para z/OS


A tabela a seguir lista os estados de ocorrncia de operaes do OPC ou do Tivoli Workload Scheduler para z/OS com relao ao Tivoli Workload Scheduler.
Estado do Fluxo de Job do Estado de Ocorrncia do OPC ou do Tivoli Workload Tivoli Workload Scheduler Scheduler para z/OS wait wait exec succ abend abend abend pendente no decidido iniciado concludo erro excludo N/D

160

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Estado do Fluxo de Job do Estado de Ocorrncia do OPC ou do Tivoli Workload Tivoli Workload Scheduler Scheduler para z/OS extrn Status N/A desconhecido. Pode ocorrer somente ao verificar um job que utilizado como uma dependncia. Leia a nota abaixo.

Verificando Jobs do OPC ou do Tivoli Workload Scheduler para z/OS


Para verificar um job do OPC ou do Tivoli Workload Scheduler para z/OS que no foi ativado pelo Tivoli Workload Scheduler, o nome do aplicativo, e opcionalmente a operao, transmitido para o Gateway. Uma verificao feita para ver se a ocorrncia ou a operao est no plano atual. Se ele no for encontrado, o Tivoli Workload Scheduler verificar novamente a taxa definida pelo valor do status de verificao bm no arquivo de Opes Locais.

Verificando Arquivos no z/OS


A existncia de um arquivo pode ser usada como uma dependncia de job no Tivoli Workload Scheduler. Para verificar a existncia de uma arquivo no z/OS, o Tivoli Workload Scheduler transmite o nome do arquivo para o Gateway. O nome do arquivo alocado com o DISP=OLD e considerado existente se as seguintes condies se aplicarem: v Os dados esto catalogados v Ele est alocado v Ele no est sendo usado por outra tarefa Se no houver um conjunto de banco de dados, o Tivoli Workload Scheduler continuar aguardando e verificando arquivos no intervalo predeterminado. Observe que o Tivoli Workload Scheduler pode utilizar somente nomes de conjuntos de bancos de dados totalmente qualificados para arquivos no particionados. Se o nome do Grupo de Dados Gerado for utilizado, ele dever ser um nome totalmente qualificado e no um nome relativo (por exemplo xxxxx.xxxxx(-1) no pode ser utilizado).

Consideraes de Sincronizao
Ao verificar jobs do z/OS que no foram ativados pelo Tivoli Workload Scheduler, alguns problemas de sincronizao podem ser crticos para assegurar que as dependncias de job associadas estejam corretamente resolvidas. Esses problemas surgem como o resultado da concepo do Tivoli Workload Scheduler de um dia de processamento. Uma discusso completa pode ser encontrada no Tivoli Workload Scheduler - Guia de Referncia. Em resumo, o Tivoli Workload Scheduler gera seu planejamento de produo cada dia at o presente momento; por exemplo, 6:00 toda manh. Para manter um relacionamento de trabalho entre os jobs em execuo no z/OS e os jobs em execuo no Tivoli Workload Scheduler, necessria a sincronizao entre os dois ambientes. Se, por exemplo, um job do z/OS job for iniciado fora do Tivoli Workload Scheduler e concludo antes do incio do dia de processamento do Tivoli Workload Scheduler, ele no ser visvel para o Tivoli Workload Scheduler e no dever ser utilizado em uma dependncia de job do Tivoli Workload Scheduler. O Tivoli Workload Scheduler no tenta determinar o status dos jobs concludos antes do incio do dia. Se a sincronizao no for considerada, como discutido acima, o Tivoli Workload Scheduler poder aguardar, por tempo indeterminado, para resolver uma dependncia do job. Um problema semelhante pode ocorrer como resultado de
Captulo 26. Informaes de Referncia

161

uma falha na comunicao entre os ambientes z/OS e Tivoli Workload Scheduler evitando que o Tivoli Workload Scheduler determine o status de um job do z/OS para atender a uma dependncia do job.

Informaes de Diagnstico
Os jobs do z/OS enviados pelo Tivoli Workload Scheduler podem falhar na concluso devido a inmeras razes. A etapa no processo de envio, no qual h uma falha do job, determina quantas informaes esto disponveis e quantas so fornecidas pelo Tivoli Workload Scheduler como se segue: v Se um job falhar antes de ser iniciado realmente (normalmente o resultado de um JCL ou um problema de segurana), o Tivoli Workload Scheduler ir reconhecer que ele no existe mais e o marcar como em abend na exibio do Console Manager (Conman). Nenhuma informao adicional fornecida. v Se um job falha depois de ser iniciado, o Tivoli Workload Scheduler: 1. Obtm seu cdigo de condio e o cdigo de abend do usurio, se houver. 2. Grav-os no arquivo de lista padro do job 3. Marca o job como abend na exibio do Console Manager (Conman) ou do Job Scheduling Console As listas de job padro podem ser exibidas com o Console Manager (Conman) e com o Job Scheduling Console.

Mensagens de Gateway
As mensagens informativas so criadas dinamicamente pelo programa de gateway do z/OS. Alm das informaes especficas para a condio, as mensagens podem incluir: v Data e hora no formato aammdd hhmmss v Nome do mdulo v Rtulo dentro do mdulo v Nome da macro v Cdigo de razo (registro 0) v Cdigo de retorno (registro 15) As mensagens de gateway do z/OS esto listadas abaixo. Para os nomes de mdulo (mdulo), veja abaixo.
EEWI01E aammdd hhmmss mdulo COM FALHA, MACRO macro PRXIMO AO RTULO rtulo COM CDIGO DE RETORNO = cdigo & CDIGO DE RAZO = cdigo EEWI02E ammdd hhmmss mdulo COM FALHA, MACRO macro PRXIMO AO RTULO rtulo COM CDIGO DE RETORNO = cdigo & NMERO DO ERRO = erro EEWI03I aammdd hhmmss mdulo EMITIDO, MACRO macro PRXIMO AO RTULO OBTER O DESCRITOR DE SOCKET = desc rtulo PARA

EEWI04I aammdd hhmmss mdulo EMITIDO, MACRO macro PRXIMO AO RTULO rtulo PARA OBTER O NOME DO HOST = host EEWI05I aammdd hhmmss mdulo ENDEREO TCPIP = endereo ip EEWI06I aammdd hhmmss nome do mdulo = nome EEWI07I aammdd hhmmss mdulo EMITIDO, MACRO macro PRXIMO AO RTULO rtuloPARA A MENSAGEM DE CARACTERE num = msg EEWI08S aammdd hhmmss mdulo COM FALHA NO DESLOCAMENTO deslocamento

162

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

EEWI09E aammdd hhmmss mdulo COM FALHA, MACRO macro PRXIMO AO RTULO rtulo COM CDIGO DE RETORNO = cdigo EEWI10S aammdd hhmmss mdulo EM ABEND COM CDIGO DE RAZO ASSOCIADO cdigo EEWI11I aammdd hhmmss mdulo CONSOLE nome ATIVADO COM O ID DOCONSOLE id EEWI12I aammdd hhmmss mdulo SUBTAREFA nome CONCLUDA COM O CDIGO DE CONCLUSO cdigo EEWI13I aammdd hhmmss mdulo CHAMAR PARA "nome" PRXIMO AO RTULO rtulo CONCLUDO COM O CDIGO DE CONCLUSO cdigo EEWI14S aammdd hhmmss mdulo ESPAO DE DADOS INVLIDO ENCONTRADO PRXIMO AO RTULO rtulo EEWI15E aammdd hhmmss mdulo DATASET "dset" DDNAME "dd" COM FALHA NA ABERTURA PRXIMO AO RTULO rtulo EEWI16I aammdd hhmmss mdulo JOB ENVIADO "job" COM A IDENTIFICAO DE JES "id" EEWI17I aammdd hhmmss mdulo PEERADDRESS = endereo ip EEWI18E aammdd hhmmss mdulo TERMINADOR INVLIDO term EEWI19E aammdd hhmmss mdulo PRXIMO AO RTULO label VALOR INVLIDO ENCONTRADO nome = valor EEWI20E aammdd hhmmss mdulo PRXIMO AO RTULO rtulo COM FALHA AO ENCONTRAR A SADA SMF IEFU84 ATIVA EEWI21E aammdd hhmmss errmsg EEWI22I aammdd hhmmss TAREFA tarefa MDULO mdulo EMITIDO, MACRO macro PRXIMO AO RTULO rtulo PARA FECHAR O DESCRITOR DE SOQUETE soquete EEWI24E aammdd hhmmss mdulo PRXIMO AO RTULO rtulo EEWI25I aammdd hhmmss mdulo PRXIMO AO RTULO rtulo APLICATIVO appl FOI INSERIDO NO PLANO ATUAL COM A DATA E A HORA DE CHEGADA DE ENTRADA iadatetime EEWI26I aammdd hhmmss mdulo PRXIMO AO RTULO rtulo JOB nome_do_job(id_do_job) EEWI27I aammdd hhmmss APLICATIVO appl FOI INSERIDO NO PLANO ATUAL COM A DATA E A HORA DE CHEGADA DE ENTRADA iadatetime EEWI28W aammdd hhmmss APLICATIVO appl NO FOI INSERIDO NO PLANO ATUAL COM A DATA E A HORA DE CHEGADA DE ENTRADA iadatetime EEWI29I aammdd hhmmss TAREFA tarefa MDULO mdulo EMITIDO, MACRO macro PRXIMO DO RTULO rtulo COM O CDIGO DE RETORNO = cdigo E O NMERO DO ERRO = erro EEWI30S aammdd hhmmss mdulo CA7SPAN DEVE SER DE 4 DGITOS NO FORMATO HHMM

Os nomes do mdulos so:


Nome do Mdulo EEWPRE84 EEWTCP00 EEWTCP01 EEWTCP02 EEWTCP05 EEWTCP07 EEWTCP08 EEWTCP10 EEWTCP15 EEWTCP20 Descrio Anterior a sada SMF Rotina de processamento principal Veculo de teste do servidor Rotina de construo do espao de dados principal Estabelece a rotina ESTAE para emitir mensagens de falha Localiza o nome do conjunto de dados associado abertura de ACB/DCB Localiza o nome do conjunto de dados associado ao DDNAME Inicializa e analisa as variveis Localiza e inicializa os bloqueios de controle Localiza e inicializa os bloqueios de controle

Captulo 26. Informaes de Referncia

163

Nome do Mdulo EEWTCP21 EEWTCP22 EEWTCP23 EEWTCP25 EEWTCP26 EEWTCP27 EEWTCP30 EEWTCP31 EEWTCP32 EEWTCP84 EEWTCP87 EEWTCP88 EEWTCP89 EEWTCP90 EEWTCP91 EEWTCP92 EEWTCP93 EEWTCP94 EEWTCP95 EEWTCP96 EEWTCP97 EEWTCP98 EEWTCP99 EEWTCPC7 EEWTCPCA EEWTCPCF EEWTCPCJ EEWTCPCO EEWTCPCV EEWTCPED EEWTCPEJ EEWTCPFJ EEWTCPIA EEWTCPIE EEWTCPKJ EEWTCPKO EEWTCPL7 EEWTCPLJ EEWTCPLO

Descrio Veculo de teste do cliente Veculo de teste do cliente Veculo de teste do cliente Servidor simultneo Fornecedor de Interlink TCPIP do servidor simultneo Servidor simultneo para a pilha Openconnect TCPIP Tarefa de servidor filho Tarefa de servidor filho para a pilha Interlink TCPIP Tarefa de servidor filho Sada de registro SMF para SMFEWTM Interface OPC Lanamento de interface OPC CA7 BTI Emite comando e aguarda a resposta Emite TERROR para formatar as mensagens e emite WTOS Localiza a subcadeia dentro da cadeia Emite o comando do CA-7 e aguarda a resposta Sada STIMER para lanar o ECB past no parmetro Chama o IKJEFF02 para extrair o buffer usando EEWTCP99 Rotina ESTAE para emitir mensagens de falha Chama o IKJEFF19 (DAIRFAIL/VSAMFAIL) para emitir mensagens Chama o IKJEFF02 para emitir mensagens do EEWTCP99 Tabela de mensagens Verifica o job do CA7 Verifica a rotina de tratamento de solicitao do aplicativo Verifica a rotina de tratamento do arquivo Verifica a rotina de tratamento da solicitao do job Verifica a rotina de tratamento de solicitao da operao Enumera o job Criptografia/descriptografia de cadeia Enumera a rotina de tratamento da solicitao do job Libera a rotina de tratamento da solicitao do job Insere o aplicativo Inicializao de cadeia Elimina a rotina de tratamento da solicitao do job Exclui o aplicativo OPC Ativa a rotina de tratamento da solicitao do job do CA-7 Ativa a rotina de tratamento do job do CA-7 Insere o aplicativo OPC

164

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Nome do Mdulo EEWTCPQ7 EEWTCPQJ EEWTCPQO EEWTCPQS EEWTCPRC EEWTCPSC EEWTCPSE EEWTCPUC EEWTCPWT EEWTCPXX

Descrio Consulta a rotina de tratamento da solicitao do job do CA-7 Consulta a rotina de tratamento da solicitao do job Consulta o aplicativo OPC Consulta a rotina de tratamento da solicitao do subsistema Cdigo de retorno Abend do sistema Criptografia/descriptografia de cadeia Abend de usurio Aguarda um valor de tempo especificada Rotina de tratamento da solicitao invlida

Para ajudar na soluo de problemas, certifique-se de obter o log do JES para as tarefas iniciadas EEWSPACE e EEWSERVE. Esse procedimento ajudar na determinao do contexto no qual a mensagem foi emitida. Dependendo da interface de planejamento do job utilizada, algumas informaes teis podem ser obtidas de outros logs. Por exemplo, se utilizar CA-7, voc deve obter o seguinte: v v v v O O O O log do CA-7 log do console para o intervalo que abrange o perodo de teste log do job que resultou em erro (se esse for o caso) arquivo de script do UNIX listado quele job

Captulo 26. Informaes de Referncia

165

166

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 6. Capacidade de Servios Comuns

Copyright IBM Corp. 2000, 2003

167

168

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 27. Referncia do Agente Estendido


Este captulo descreve a interface do agente estendido e fornece informaes para programadores que precisam criar mtodos de acesso personalizados.

O que So Agentes Estendidos?


Agentes estendidos so utilizado para estender as funes de planejamento de job do Tivoli Workload Scheduler para outros sistemas e aplicativos. Um agente estendido definido como uma estao de trabalho que tem um host e um mtodo de acesso. O host qualquer outra estao de trabalho, exceto outro agente estendido. O mtodo de acesso um script ou programa fornecido pelo usurio ou pela IBM que executado pelo host sempre que o agente estendido referido no plano de produo. Por exemplo, para lanar um job em um agente estendido, o host executa o mtodo de acesso, transmitindo a ele detalhes do job como opes da linha de comandos. O mtodo de acesso comunica-se com o sistema externo ou aplicativo para lanar o job e retornar o status do job.

Definio de Estao de Trabalho


Cada agente estendido deve ter uma definio de estao de trabalho lgica. Essa estao de trabalho lgica deve ser hospedada por uma estao de trabalho fsica Tivoli Workload Scheduler seja master, gerenciador de domnio ou FTA. A definio de estao de trabalho do agente estendido faz referncia ao nome do mtodo de acesso e da estao de trabalho do host. Quando jobs so lanados na estao de trabalho do agente estendido, o mtodo de acesso chamado e transmite as informaes do job ao sistema externo.

Interface do Mtodo de Acesso


A interface entre o Tivoli Workload Scheduler e um mtodo de acesso consiste em informaes transmitidas ao mtodo na linha de comandos e em mensagens retornadas para o programador em stdout.

Sintaxe da Linha de Comandos do Mtodo


O host do planejador executa um mtodo de acesso utilizando a seguinte sintaxe da linha de comandos: methodname -t task options -- taskstring em que: methodname Especifica o nome do arquivo do mtodo de acesso. Todos os mtodos de acesso deve ser armazenados no diretrio: TWShome/methods -t task Especifica a tarefa a ser executada, onde task uma das seguintes: LJ MJ Lana um job. Gerencia um job lanado anteriormente. Utilize essa opo para sincronizar novamente se uma tarefa LJ anterior tiver terminado inesperadamente.

Copyright IBM Corp. 2000, 2003

169

CF GS

Verifica a disponibilidade de um arquivo. Utilize essa opo para verificar as dependncias opens. Obtm o status de um job. Utilize essa opo para verificar as dependncias follows do job.

options Especifica as opes associadas tarefa. Consulte Opes de Tarefas para obter informaes adicionais. taskstring Uma cadeia de at 255 caracteres associada tarefa. Consulte Opes de Tarefas.

Opes de Tarefas
As opes de tarefas so listadas na tabela a seguir. Um X significa que a opo vlida para a tarefa.
Tarefa -t LJ MJ CF GS -c X X X X -n X X X X -p X X X X X X -r X X -s X X Opes -d X X -l X X -o X X -j X X X X -q -w -S X ljstring mjstring cfstring gsstring Cadeia da Tarefa

-c xagent,host,master Especifica os nomes do agente estendido, do host e do gerenciador de domnio principal do planejador, separados por vrgulas. -n nodename Especifica o nome de n do computador associado ao agente estendido, se houver. Isso definido no campo N da definio de estao de trabalho do agente estendido. -p portnumber Especifica o nmero da porta TCP associada ao agente estendido, se houver. Isso definido no campo Endereo do TCP da definio de estao de trabalho do agente estendido. -r currentrun,specificrun Especifica o nmero de execuo atual do planejador e o nmero de execuo especfico associado ao job, separados por uma vrgula. Os nmeros de execuo atual e especfico podero ser diferentes se o job tiver sido transportado de uma execuo anterior. -s jstream Especifica o nome do fluxo do job. -d scheddate,epoch Especifica a data de planejamento (aammdd) e o perodo equivalente, separados por uma vrgula. -l user Especifica o nome de usurio do job. Isso definido no campo Logon da definio de job. -o stdlist Especifica o nome completo do caminho do arquivo de listagem padro do job. Qualquer sada do job dever ser gravada nesse arquivo.

170

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

-j jobname,id Especifica o nome do job e o identificador exclusivo atribudo pelo planejador, separados por uma vrgula. O nome definido no campo Nome do Job da definio de job. -q qualifier Especifica o qualificador a ser utilizado em um comando de teste emitido pelo mtodo junto ao arquivo. -w timeout Especifica o perodo de tempo, em segundos, que o planejador aguarda para obter uma resposta em um job externo antes de enviar um sinal SIGTERM para o mtodo de acesso. O padro 300. -S novo nome Especifica que o job reexecutado utilizando esse nome no lugar do nome de job original. Como um script de job, voc pode usar o comando jobinfo para retornar o nome do job e executar o script de forma diferente para cada situao. Consulte a descrio do comando conman rerun no Guia de Referncia do IBM Tivoli Workload Scheduler para obter informaes adicionais. -- ljstring Utilizado com a tarefa LJ. A cadeia do campo Arquivo de Script ou Comando da definio de job. -- mjstring Utilizado com a tarefa MJ. As informaes fornecidas ao planejador pelo mtodo em uma resposta %CJ a uma tarefa LJ. Em geral, isso identifica o job que foi lanado. Por exemplo, um mtodo Unix pode fornecer o PID (identificao do processo) do job lanado, que enviado pelo programador como parte de uma tarefa MJ. -- cfstring Utilizado com a tarefa CF. Para a dependncia opens de um arquivo, a cadeia do campo Opens Files da definio do fluxo de job. -- gsstring Utilizado com a tarefa GS. Especifica o job cujo status foi verificado. O formato o seguinte: followsjob[,jobid] em que: followsjob A cadeia da lista Follows Sched/Job da definio do fluxo de job. jobid Um identificador de job opcional recebido pelo planejador em uma resposta %CJ a uma tarefa GS anterior.

Mensagens de Resposta do Mtodo


Os mtodos retornam informaes ao Tivoli Workload Scheduler em mensagens gravadas no stdout. Toda linha comeando com um sinal de porcentagem (%) e terminando com uma nova linha, interpretada como uma mensagem. As mensagens possuem o seguinte formato: %CJ state [mjstring | jobid] %JS [cputime]
Captulo 27. Referncia do Agente Estendido

171

%RC rc %UT [errormessage] em que: CJ Altera o estado do job. state O estado para o qual o job alterado. Todos os estados de job do planejador so vlidos, exceto hold e ready. Para a tarefa GS, os seguintes estados tambm so vlidos: ERROR Ocorreu um erro. EXTRN Status desconhecido. mjstring Uma cadeia de at 255 caracteres que o planejador incluir em qualquer tarefa MJ associada ao job. Consulte 171. jobid Uma cadeia de at 64 caracteres que o planejador incluir em qualquer tarefa GS associada ao job. Consulte 171.

JS [cputime] Indica a concluso bem-sucedida de um job e fornece seu tempo de execuo decorrido em segundos. RC rc rc um nmero interpretado pelo Tivoli Workload Scheduler como o cdigo de retorno do job de agente estendido. O cdigo de retorno ser considerado somente se uma condio de cdigo de retorno for especificada na definio do job de agente estendido. Se esse no for o caso, ele ser ignorado e a concluso bem-sucedida do job de agente estendido ser indicada pela presena da mensagem %JS [cputime]. Da mesma forma, se o mtodo no enviar a mensagem %RC, ento a concluso bem-sucedida do job de agente estendido ser indicada pela presena da mensagem %JS [cputime].

UT [errormessage] Indica que a tarefa solicitada no suportada pelo mtodo. Exibe uma cadeia de at 255 caracteres que o planejador incluir em sua mensagem de erro.

Arquivo de Opes do Mtodo


possvel utilizar um arquivo de opes do mtodo para especificar informaes especiais de logon e outras opes. O planejador ler o arquivo, se existir, antes de executar um mtodo. Se o arquivo for modificado depois que o planejador for iniciado, as alteraes sero efetivadas quando ele for parado e reiniciado. O arquivo pode conter opes do planejador e qualquer outra informao sobre o mtodo. As opes reconhecidas pelo planejador so as seguintes: LJuser=username CFuser=username GSuser=username GStimeout=seconds

172

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

em que: LJuser=username Especifica o logon a ser utilizado para as tarefas LJ e MJ. O padro o logon da definio de job. CFuser=username Especifica o logon a ser utilizado para a tarefa CF. O padro raiz para Unix, e para o Windows o nome do usurio da conta na qual o programador foi instalado. GSuser=username Especifica o logon a ser utilizado para as tarefas GS. O padro raiz para Unix, e para o Windows o nome do usurio da conta na qual o programador foi instalado. GStimeout=seconds Especifica o perodo de tempo, em segundos, que o planejador aguarda por uma resposta antes de eliminar o mtodo de acesso. O padro 300 segundos. Nota: Se o host do agente estendido for um computador do Windows, estes usurios devero ser definidos como objetos do usurio do programador. O arquivo de opes deve ter o mesmo nome de caminho de seu mtodo de acesso, com uma extenso de arquivo .opts. Por exemplo, o nome do caminho do Windows de um arquivo de opes para um mtodo chamado netmth : v TWShome\methods\netmth.opts (global). v TWShome\methods\<CPUname>_netmth.opts (local).

Execuo do Mtodo
Os tpicos a seguir descrevem o intercmbio entre o Tivoli Workload Scheduler e um mtodo de acesso.

Tarefa LJ (Lanar Job)


A tarefa LJ orienta o mtodo do agente estendido para lanar um job em um sistema ou aplicativo externo. Antes de executar o mtodo, o Tivoli Workload Scheduler estabelece um ambiente de execuo. O parmetro LJuser lido a partir do arquivo de opes do mtodo para determinar a conta do usurio com a qual executar o mtodo. Se o parmetro no estiver presente ou o arquivo de opes no existir, a conta do usurio especificada no campo Logon da definio do job ser utilizada. Alm disso, as seguintes variveis de ambiente so definidas: HOME O diretrio pessoal do usurio de logon. LOGNAME O nome do usurio de logon. PATH No Unix, ele definido como /bin:/usr/bin. No Windows, ele definido como %SYSTEM%\SYSTEM32. TZ O fuso horrio.

Se o mtodo no puder ser executado, o job ser colocado no estado fail. Depois de um mtodo ser executado, ele grava mensagens em seu stdout que indica o estado do job no sistema externo. As mensagens so resumidas na tabela a
Captulo 27. Referncia do Agente Estendido

173

seguir.
Tarefa LJ e MJ Resposta do Mtodo %CJ state [mjstring] Ao do Tivoli Workload Scheduler Define o estado do job como state. Inclui mjstring em qualquer tarefa MJ subseqente. Define o estado do job como succ.

%JS [cputime]

Cdigo de sada=diferente de Define o estado do job como abend. zero %UT [errormessage] e Cdigo de sada=2 Define o estado do job como abend e exibe errormessage.

Uma seqncia comum consiste em uma ou mais mensagens %CJ indicando alteraes no estado do job e, em seguida, uma mensagem %JS antes do mtodo sair para indicar que o job terminou com xito. Se o job no for bem-sucedido, o mtodo dever sair sem gravar a mensagem %JS. Um mtodo que no suporta a tarefa LJ grava uma mensagem %UT no stdout e sai com um cdigo de sada 2.

Tarefa MJ (Gerenciar Job)


A tarefa MJ ser utilizada para sincronizar com um job lanado anteriormente se o planejador determinar que a tarefa LJ terminou inesperadamente. O planejador configura o ambiente da mesma maneira que para a tarefa LJ e transmite a mjstring.Consulte Tarefa LJ (Lanar Job) na pgina 173 para obter informaes adicionais. Se o mtodo localizar o job especificado, ele responder com as mesmas mensagens de uma tarefa LJ. Se o mtodo no conseguir localizar o job, ele sair com um cdigo de sada diferente de zero, fazendo com que o planejador coloque o job no estado abend.

Como Eliminar um Job


Enquanto uma tarefa LJ ou MJ est sendo executada, o mtodo deve detectar um sinal SIGTERM (sinal 15). O sinal enviado quando um operador emite um comando Kill atravs do gerenciador de console do planejador. No recebimento do sinal, o mtodo deve tentar parar (kill) o job e sair sem gravar uma mensagem %JS.

Tarefa CF (Verificar Arquivo)


A tarefa CF solicita o mtodo do agente estendido para verificar a disponibilidade de um arquivo no sistema externo. Antes de executar o mtodo, o planejador estabelece um ambiente de execuo. O parmetro CFuser lido a partir do arquivo de opes do mtodo para determinar a conta do usurio com a qual executar o mtodo. Se o parmetro no estiver presente ou o arquivo de opes no existir, o usurio raiz ser utilizado no Unix e, no Windows, ser utilizado o nome do usurio da conta na qual o programador foi instalado. Se o mtodo no puder ser executado, o arquivo que abre a dependncia ser marcado como falha, isto , o status do arquivo ser definido como NO e qualquer job ou fluxo de job dependente no ter permisso para ser executado. Durante a execuo, o mtodo executa um comando de teste, ou equivalente, no arquivo que est utilizando o qualificador transmitido a ele na opo -q da linha de comandos. Se o teste do arquivo for verdadeiro, o mtodo sair com um cdigo de sada zero. Se o teste do arquivo for falso, o mtodo sair com um cdigo de sada diferente de zero. Isso resumido na tabela a seguir.

174

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Tarefa CF

Resposta do Mtodo Cdigo de sada=0 Cdigo de sada=diferente de zero

Ao do Tivoli Workload Scheduler Define o estado do arquivo como SIM. Define o estado do arquivo como NO.

%UT [errormessage] e Cdigo Define o estado do arquivo como NO. de sada=2

Um mtodo que no suporta a tarefa CF grava uma mensagem %UT no stdout e sai com um cdigo de sada 2.

Tarefa GS (Obter Status)


A tarefa GS informa ao mtodo do agente estendido para verificar o status de um job. Isso necessrio quando outro job depende da concluso bem-sucedida de um job externo. Antes de executar o mtodo, o parmetro GSuser lido a partir do arquivo de opes do mtodo para determinar a conta de usurio com a qual executar o mtodo. Se o parmetro no estiver presente ou o arquivo de opes no existir, o usurio raiz ser utilizado no Unix e, no Windows, ser utilizado o nome do usurio da conta na qual o programador foi instalado. Se o mtodo no puder ser executado, o job ou fluxo de job dependente no ter permisso para executar. Se um jobid estiver disponvel a partir de uma tarefa GS anterior, ele ser transmitido para o mtodo. O mtodo verifica o estado do job especificado e o retorna em uma mensagem %CJ gravada no stdout. Em seguida, sai com um cdigo de sada zero. Em uma taxa definida pela opo local status de verificao de bm, o mtodo executado novamente com uma tarefa GS at que um dos seguintes estados de job sejam retornados: abend O job terminou de forma anormal. succ cancl done fail error extrn O job foi concludo com xito. O job foi cancelado. O job terminou, mas seu xito ou falha no foi indicado. O job no pde ser executado. Ocorreu um erro no mtodo durante a verificao do status do job. A verificao do job falhou ou o status do job no pde ser determinado.

Observe que GStimeout no arquivo de opes do mtodo especifica quanto tempo o planejador aguardar por uma resposta antes de eliminar o mtodo. Consulte Arquivo de Opes do Mtodo na pgina 172 para obter informaes adicionais. As respostas dos mtodos so resumidas na tabela a seguir:
Tarefa GS Resposta do Mtodo %CJ state [jobid] Ao do Tivoli Workload Scheduler Define o estado do job como state e inclui jobid em qualquer tarefa GS subseqente.

%UT [errormessage] e Cdigo O estado do job fica inalterado. de sada=2

Um mtodo que no suporta a tarefa GS grava uma mensagem %UT no stdout e sai com um cdigo de sada 2.
Captulo 27. Referncia do Agente Estendido

175

O Comando cpuinfo
O comando cpuinfo pode ser utilizado em um mtodo de acesso para retornar informaes de uma definio de estao de trabalho. Consulte o Guia de Referncias do IBM Tivoli Workload Scheduler para obter informaes de comando completas.

Resoluo de Problemas
Os tpicos a seguir so fornecidos para ajud-lo a detectar e depurar problemas do agente estendido e do mtodo de acesso.

Mensagens de Erro da Lista Padro de Jobs


Todas as mensagens de sada de um mtodo de acesso, exceto as iniciadas com um sinal de porcentagem (%), so gravadas no arquivo de lista padro de jobs (stdlist). Para as tarefas GS e CF no associadas a jobs do planejador, as mensagens so gravadas no arquivo de lista padro do planejador. Para obter informaes relativas a qualquer tipo de problema, verifique esses arquivos.

Mtodo No Executvel
Se um mtodo de acesso no puder ser executado, ocorrer o seguinte: v Para as tarefas LJ e MJ, o job ser colocado no estado fail. v Para a tarefa CF, a dependncia de arquivo ficar sem soluo e o job dependente permanecer no estado hold. v Para a tarefa GS, a dependncia de job ficar sem soluo e o job dependente permanecer no estado hold. Para obter informaes adicionais, reveja os arquivos de lista padro (stdlist) do job e do planejador.

Mensagens do Gerenciador de Console


Esta mensagem de erro ser exibida se voc emitir um comando start, stop, link ou unlink para um agente estendido:
Erro na execuo do comando: No implementado para agentes estendidos. [2202.58]

Esse erro no ser exibido se um agente estendido for selecionado como resultado da utilizao de caracteres curinga.

Mensagens do Composer e do Compiler


As mensagens de erro a seguir so geradas quando o Composer encontra sintaxe invlida em uma definio de estao de trabalho:
MTODO DE ACESSO sintaticamente invlido [1116.45] Palavra-chave de ACESSO duplicada [1116.46] MTODO DE ACESSO ausente ou invlido [1116.47]

Se um agente estendido for definido com um mtodo de acesso, mas sem um host, a seguinte mensagem ser exibida:
"O mtodo precisa de uma CPU do Host"

Mensagens do Jobman
Para agentes estendidos, as mensagens de erro, de aviso e informativas so gravadas no arquivo stdlist do Jobman.

176

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

O lanamento bem-sucedido de um job gera a seguinte mensagem:


Job jobname lanado para wkstation, #Jjobid para usurio username.

O lanamento mal sucedido de um job gera a seguinte mensagem:


Erro ao lanar jobname para wkstation: errortext

Falha em uma tarefa de verificao de arquivo gera a seguinte mensagem:


Erro ao chamar methodname para wkstation: errortext

Falha em uma tarefa de gerenciamento de job gera a seguinte mensagem:


Erro ao gerenciar jobname para wkstation utilizando methodname: errortext

Quando um mtodo envia uma mensagem para o Jobman, mas no reconhecida, gerada a seguinte mensagem:
Erro: mensagem invlida para jobname, #jjobnumber para wkstation usando methodname. "primeiros 64 caracteres da mensagem afetada"

Captulo 27. Referncia do Agente Estendido

177

178

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 28. A Biblioteca de Mapeamento do Cdigo de Retorno


A funcionalidade do mapeamento do cdigo de retorno fornece um modo padro de mapear mensagens em valores de cdigo de retorno. Alm disso, o mapeamento do cdigo de retorno pode ser personalizado pelos usurios. Essa funcionalidade est disponvel nos mtodos de acesso para: v Oracle eBusiness Suite v Peoplesoft v R/3 Essa funcionalidade fornece mais granularidade na definio dos critrios de sucesso/falha dos jobs e flexibilidade aprimorada no controle dos fluxos de execuo do job com base nos resultados da execuo. O mapeamento do cdigo de retorno do job fornece os seguintes recursos: v Os usurios podem definir um status de finalizao do job (bem-sucedido ou com falha) baseado na condio do cdigo de retorno da execuo do programa/script do job. v O cdigo de retorno tambm pode ser fornecido para recuperar o job que est associado definio de job. Isso faz com que o job de recuperao execute processos diferentes com base no cdigo de retorno.

O Arquivo de Mapeamento do Cdigo de Retorno


Esse arquivo permite que voc personalize seus prprios cdigos de retorno em relao a determinadas condies que podem afetar um job quanto ele for executado. Nesse arquivo possvel definir a condio de sucesso do job da qual o Tivoli Workload Scheduler pode ser avaliado, se o job for concludo com sucesso ou se houver erro. O cdigo de retorno enviado ao Tivoli Workload Scheduler na forma de uma mensagem %RC nnnn. Se essa mensagem for recebida, o estado do job ser atualizado de acordo.

Formato
A sintaxe do arquivo de mapeamento do cdigo de retorno a seguinte:
[#] pattern1 pattern2...patternn = RC value

Parmetros
# Comentrio opcional. Todas as linhas que se iniciam com esse smbolo (#) no so utilizadas para o mapeamento.

patternn As cadeias padro delimitadas por aspas duplas ( e ). Se voc utilizar somente uma cadeia padro, possvel omitir as aspas duplas. Se a cadeia padro contiver um caractere de aspas duplas, ele deve ser substitudo por uma barra invertida (\). A cadeia pode conter os seguintes caracteres curinga ou caracteres especiais: Asterisco (*) Corresponde a um nmero arbitrrio de caracteres. Ponto de interrogao (?) Corresponde a um nico caractere.
Copyright IBM Corp. 2000, 2003

179

Barra invertida (\) Caractere de substituio. Valor RC O valor do cdigo de retorno. Esse valor enviado pelo mtodo para o Tivoli Workload Scheduler por meio de uma mensagem %RC nnnn.

Exemplos
No seguinte exemplo de um arquivo de mapeamento do cdigo de retorno, os nmeros das linhas em negrito no pertencem ao arquivo mas so mostrado para referncia:
1. 2. 3. 4. 5. 6. 7. # Esse um arquivo de mapeamento do RC para o joblog. Usurio * inexistente = 102 \*\*\* = 103 Usurio \ * \ inexistente = 102

em que: v A linha 1 um comentrio e no utilizada para mapeamento. v A linha 2 est em branco e ignorada. Todos os espaos em branco, anteriores ou posteriores a uma cadeia padro so ignorados, bem como esses entre o sinal de igual e o valor do cdigo de retorno. v A linha 3 corresponde a toda mensagem iniciando com a cadeiaUsurio e terminando com a cadeia inexistente. v A linha 4 corresponde a toda mensagem iniciando com trs asteriscos (*) seguidos de um espao em branco. Quando voc utiliza o asterisco com mostrado acima e no como um caractere curinga, necessrio substitu-lo por uma barra invertida. v As linhas de 5 a 7 contm um padro de vrias linhas. Ele corresponde as mesmas mensagens que o padro da linha 3.

Comentrios
Observe os seguintes fatos: v A ordem das linhas padro importante, pois a primeira correspondncia de linha padro utilizada para criar o valor do cdigo de retorno. v As cadeias padro vazias () so ignoradas pelo procedimento de correspondncia de padres. Por exemplo, a seguir mostrada uma seqncia de padres vlida. A primeira linha mais restritiva que a segunda linha.
625 Usurio * inexistente = 104 Usurio * inexistente = 102

A seqncia padro a seguir formalmente vlida, mas a segunda linha padro nunca utilizada; como a primeira linha mais geral, ela sempre encontra correspondncia primeiro.
Usurio * inexistente = 102625 Usurio * inexistente = 104

Mapeamento de Cdigo de Retorno para Psagent e MCMAGENT


Para o mtodo de acesso para o PeopleSoft e o Oracle e-Business Suite, voc pode gravar os arquivos de mapeamento do cdigo de retorno associados ao estado interno listado em Tabela 22 na pgina 181 e em Tabela 23 na pgina 181.

180

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Quando nenhum arquivo de mapeamento do cdigo de retorno for definido ou quando uma cadeia retornada pelo mtodo de acesso no corresponder aos padres do arquivo de mapeamento, os mtodos utilizaro os respectivos cdigos de retorno padro listados nas mesmas tabelas.
Tabela 22. Estados de Job e Cdigos de Retorno do Mtodo de Acesso para PeopleSoft. Estado do Job do Psoft CANCEL DELETE ERROR HOLD QUEUED INITIATED PROCESSING CANCELLED SUCCESS NO SUCCESSPOSTED POSTED NOT POSTED RESEND POSTING GENERATED Cdigo de Retorno do Psoft 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

Tabela 23. Estados de Job e Cdigos de Retorno do Mtodo de Acesso paraOracle e-Business Suite. Estado do Job de MCMAGENT RUNNING PENDING COMPLETE INACTIVE NORMAL TERMINATING PAUSED RESUMING STANDBY SCHEDULED WAITING WARNING ERROR TERMINATED DELETED ON HOLD DISABLED NO MANAGER Cdigo de Retorno do MCMAGENT 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16 17 18 19

Captulo 28. A Biblioteca de Mapeamento do Cdigo de Retorno

181

Tabela 23. Estados de Job e Cdigos de Retorno do Mtodo de Acesso paraOracle e-Business Suite. (continuao) Estado do Job de MCMAGENT SUSPENDED TEST FAILURE NOT FOUND Cdigo de Retorno do MCMAGENT 20 21 22

182

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Exemplos: O agente estendido para o Oracle e-Business Suite retorna a cadeia TERMINATED. O cdigo de retorno resultante ser o seguinte, dependendo dessa condies: v No existe nenhum arquivo de mapeamento do cdigo de retorno. Nesse caso, o mtodo envia um valor de cdigo de retorno de 15 ,como mostrado em Tabela 23 na pgina 181. v O arquivo de mapeamento do cdigo de retorno existe e
"NORMAL"=0 "TERMINATED","DELETED"=1

Nesse caso, o mtodo encontra o padro de correspondncia e envia um valor de cdigo de retorno de 1. v O arquivo de mapeamento do cdigo de retorno
"NORMAL"=0 "ERROR","DELETED"=1

Nesse caso, o mtodo no encontra o padro de correspondncia e envia um valor de cdigo de retorno de 15, como mostrado em Tabela 23 na pgina 181.

Captulo 28. A Biblioteca de Mapeamento do Cdigo de Retorno

183

Nomes dos Arquivos de Mapeamento do Cdigo de Retorno


Cada mtodo tem seu prprio conjunto de arquivos para mapear as mensagens em valores de cdigo de retorno. Os arquivos de mapeamento pode ser globais ou locais para uma estao de trabalho. Os arquivos de mapeamento do cdigo de retorno, especficos para a estao de trabalho, so nomeados de acordo com o seguinte esquema:
<TWShome>/methods/rcm/<nome_do_mtodo>-<type>-<workstation>.rcm

Os arquivos de mapeamento global devem ter um nome de arquivo de acordo com o seguinte esquema:
<TWShome>/methods/rcm/<nome_do_mtodo>-<type>.rcm

Para os mtodos de acesso PeopleSoft e Oracle e-Business, type sempre igual a rcmap. Para o mtodo de acesso R/3, type como descrito na seguinte seo.

Nomes de Arquivos de Mapeamento do Cdigo de Retorno para r3batch


O mtodo para R3 utiliza os seguintes arquivos de mapeamento do cdigo de retorno global: <TWShome>/rcm/methods/r3batch-joblog.rcm Mapeia as mensagens do joblog de um job do R3 para os valores do cdigo de retorno. Se esse arquivo no estiver presente, as mensagens no joblog sero ignoradas. <TWShome>/rcm/methods/r3batch-pchainlog.rcm Mapeia as mensagens do protocolo da Cadeia de Processo para os valores do cdigo de retorno. Se esse arquivo no estiver presente, as mensagens no protocolo sero ignoradas. <TWShome>/rcm/methods/r3batch-spool.rcm Mapeia as mensagens na lista de spool do job de um job SAP para os valores do cdigo de retorno. Se esse arquivo no estiver presente, as mensagens na lista de spool sero ignoradas. <TWShome>/rcm/methods/r3batch-syslog.rcm Mapeia as mensagens no syslog de um sistema SAP para valores do cdigo de retorno. Se esse arquivo no estiver presente, as mensagens no syslog sero ignoradas. <TWShome>/rcm/methods/r3batch-msgrc.rcm Mapeia excees ABAP / cdigos de retorno BAPI dos mdulos de funo RFC para os valores do cdigo de retorno. Se esse arquivo no estiver presente, o mapeamento ser feito com uma tabela codificada.

184

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 29. Configurando o Utilitrio de Rastreamento


Todos os mtodos de acesso fornecem a possibilidade de configurar as opes de rastreamento. Para fazer isso, voc pode editar uma quantidade de propriedades de rastreamento no arquivo de configurao <nome_do_mtodo_de_acesso>.properties localizado no subdiretrio de mtodos do TWShome. As propriedades de rastreamento configurveis so: v Nvel de rastreamento (MIN,MID,MAX) v Localizao do arquivo de rastreamento (em termos de caminho absoluto) O exemplo a seguir um arquivo de configurao para o mtodo de acesso de R/3. Ele chamado r3batch.properties. As palavras-chave discutidas nesta seo esto realadas para facilidade de utilizao:
r3batch.organization=IBM r3batch.product=TWS4APPS r3batch.component=R3BATCH r3batch.trace.tracers.level=DEBUG_MIN r3batch.trace.tracers.listenerNames=r3batch.trace.handlers.traceFile r3batch.trace.handlers.traceFile.fileDir=home/maestro/methods r3batch.trace.handlers.traceFile.appending=true r3batch.trace.handlers.traceFile.formatterName=r3batch.trace.formatter

Com a palavra-chave level, o mecanismo de rastreamento suporta trs nveis de rastreamento: DEBUG_MIN Somente erros fatais so listados. Esse o padro. DEBUG_MID Mensagens informativas e avisos tambm so listados. DEBUG_MAX Um resultado de depurao mais verboso exibido. As definies do arquivo de propriedades afetam todas as execues do mtodo de acesso correspondente. Para especificar uma definio de rastreamento diferente para um determinado job, inclua a seguinte opo na definio do job:
-tracelvl=(1|2|3)

em que: v 1 = DEBUG_MIN v 2 = DEBUG_MID v 3 = DEBUG_MAX Somente para o mtodo de acesso R/3, voc pode marcar a caixa de opes Depurar na janela Definies das Propriedades do Job do Job Scheduling Console para definir o nvel de rastreamento para DEBUG_MAX de um job especfico. Observe que a caixa de opes Rastrear ativa o rastreamento de SAP RFC. Os rastreamentos so gravados no formato XML. Por padro, os arquivos de rastreamento so armazenados no diretrio de mtodos. Para alterar esse caminho,voc pode usar a palavra-chave fileDir. Certifique-se de que o novo
Copyright IBM Corp. 2000, 2003

185

caminho especificado j tenha sido criado como um caminho absoluto com os direitos de gravao. Sempre use barras (ou barras invertidas) ao especificar um novo caminho, mesmo se estiver no Windows. Os arquivos de rastreamento fornecem informaes sobre a execuo de mtodos para os nveis de detalhes desejados. O nvel de rastreamento mnimo est sempre ativado, para garantir o recurso de FFDC (Captura de Dados da Primeira Falha). O valor da chave anexando determina se um novo arquivo de rastreamento est anexado a outro mais velho (verdadeiro) ou se a sobrescreve (falso). Um valor verdadeiro recomendado para todas as situaes. De modo particular, ele no deve ser alterado para falso durante a execuo de jobs, pois isso poder causar perda de rastreamento.

186

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 30. Resoluo de Problemas


Este captulo lista alguns itens de problemas que voc pode enfrentar ao instalar ou utilizar o Tivoli Workload Scheduler para Aplicativos ou os mtodos de acesso.
Tabela 24. Itens de Soluo de Problemas rea Instalao: Descobrindo instncias do Tivoli Workload Scheduler Item Problema: se voc estiver no Unix e tiver vrias instalaes do Tivoli Workload Scheduler verses 7.0 ou 8.1 que no foram instaladas corretamente no diretrio inicial /home/TWSuser, o programa de instalao lista, aleatoriamente, somente uma das instncias e um dos nomes que ele <desconhece>. Soluo: para cada uma dessas instncias, crie um diretrio inicial adequado que aponte para o diretrio real da instalao do Tivoli Workload Scheduler. Faa o seguinte: 1. Na raiz, crie um diretrio chamado /home/TWSuser, que se vincula ao diretrio no qual o produto foi instalado. 2. No arquivo /usr/unison/components, inclua uma entrada chamada /home/TWSuser que se vincule entrada para a instncia em particular. Instalao: Instalando o psagent Problema: ao instalar o mtodo de acesso para o recurso do PeopleSoft, a mensagem pop-up a seguir pode ser exibida: O nmero 6654 no pde ser localizado na dll MFC42u.dll Isso ocorre porque uma verso antiga de MFC42u.dll foi localizada no diretrio do sistema do Windows. Soluo: Substitua o arquivo MFC42u.dll com uma verso mais recente para eliminar o problema. Uma verso mais recente da dll pode ser encontrada no diretrio inicial do PeopleSoft. r3batch: Planejando jobs do R/3 Problema: quando um job SAP criado, a seguinte mensagem exibida, ao tentar exibir os detalhes de uma variante do ABAP: AWSO0101E Rotina de ABAP inexistente. J_101_REPORT_ALL_SELECTIONS instale a rotina do ABAP mais recente para Maestro!! Soluo: esse defeito causado por um erro em um mdulo de funo da SAP. A SAP descreve esse problema e as possveis solues nas notas 0351293 e 0116354. Ambiente misto: Mensagens nos logs do job de psagent e zosagent Ambiente misto: cdigos de retorno de jobs de agente estendido Se o ambiente de planejamento consistir no Tivoli Workload Scheduler verso 8.1 e no Tivoli Workload Scheduler para Aplicativos verso 8.2, as mensagens nos logs do job dos mtodos de acesso para z/OS e PeopleSoft exibiro prefixos duplos: v AWSxxxx EEWIyyyy <texto da mensagem > para zosagent v AWSxxxx EEWNyyyy <texto da mensagem> para psagent Se o ambiente de planejamento consistir no Tivoli Workload Scheduler verso 8.2 e no Tivoli Workload Scheduler para Aplicativos verso 8.1.1, ento, o que exibido como o cdigo de retorno de um job de agente estendido enviado (por meio do Job Scheduling Console ou conman) ser na verdade o cdigo de sada desse job. Ele no deve ser interpretado como o cdigo de retorno.

Copyright IBM Corp. 2000, 2003

187

Resolvendo Problemas de Instalao do Mtodo de Acesso do PeopleSoft


A instalao desse mtodo de acesso requer um ambiente PeopleSoft especfico em termos de um diretrio que dependa de uma verso do PeopleSoft. Alguns executveis do mtodo de acesso so instalados nesse procedimento. A tabela a seguir lista os diretrios e os arquivos que voc deve procurar se estiver solucionando problemas na instalao.
Tabela 25. Caminhos do Ambiente PeopleSoft. Verso do PeopleSoft 7.x Nome do Diretrio <PS_HOME>\cblbin em que <PS_HOME> o diretrio inicial do servidor de arquivos do Peoplesoft e est acessvel local e remotamente de uma estao de trabalho executando o mtodo de acesso. 8.1x <EXT_API_DIR>\bin\client\winx86_extapi em que <EXT_API_DIR> o diretrio em que as APIs externas do PeopleSoft foram instaladas. 8.4x <PS_HOME>\\bin\client\winx86 em que <PS_HOME> o diretrio inicial do servidor de arquivos do Peoplesoft e est acessvel local e remotamente de uma estao de trabalho executando o mtodo de acesso. TVPUPSFT.exe pspiadapter.dll TVPUPSFT.exe pspiadapter.dll Procurar estes arquivos TVPUPSFT.execblrtss.dll

188

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Captulo 31. Arquivos Instalados


Este captulo fornece uma lista de arquivos que voc deve encontrar no sistema durante a instalao do Tivoli Workload Scheduler para Aplicativos. As informaes so fornecidas por plataforma e por recurso. No esto includos arquivos instalados para suporte a Java, alm daqueles necessrios para desinstalar o produto. A tabela a seguir lista os arquivos instalados no Windows.
Tabela 26. Arquivos instalados no Windows. Recurso Mtodo de Acesso do PeopleSoft Arquivos TWS_HOME\catalog\C\peoplesoft.cat TWS_HOME\methods\PeopleSoft\PTCUDCOP.bl TWS_HOME\methods\PeopleSoft\TVPUPSFT700.dms TWS_HOME\methods\PeopleSoft\TVPUPSFT750.dms TWS_HOME\methods\defs\psagent.def TWS_HOME\methods\enigma.exe TWS_HOME\methods\msvcrt.dll TWS_HOME\methods\oslayer.dll TWS_HOME\methods\psagent.exe TWS_HOME\methods\psagent.opts TWS_HOME\methods\psagent.properties Para o PeopleTools 7.0x e o Merant NetExpress 2: PSHOME70CBL2\cblbin\TVPUPSFT.exe PSHOME70CBL2\cblbin\TVPUPSFT.gnt Para o PeopleTools 7.0x e o Merant NetExpress 3: PSHOME70CBL3\cblbin\TVPUPSFT.exe PSHOME70CBL3\cblbin\TVPUPSFT.gnt PeopleTools 7.0x e MF COBOL Workbench 4.x: PSHOME70CWB4\cblbin\TVPUPSFT.exe PSHOME70CWB4\cblbin\TVPUPSFT.gnt Para o PeopleTools 7.5x e o Merant NetExpress 2: PSHOME75CBL2\cblbin\TVPUPSFT.exe PSHOME75CBL2\cblbin\TVPUPSFT.gnt Para o PeopleTools 7.5x e o Merant NetExpress 3: PSHOME75CBL3\cblbin\TVPUPSFT.exe PSHOME75CBL3\cblbin\TVPUPSFT.gnt Para o PeopleTools 8.1x: PSHOME81X\bin\client\winx86_extapi\TVPUPSFT.exe Para o PeopleTools 8.4x: PSHOME84X\bin\client\winx86\TVPUPSFT.exe

Copyright IBM Corp. 2000, 2003

189

Tabela 26. Arquivos instalados no Windows. (continuao) Recurso Mtodo de Acesso do R/3 Arquivos TWS_HOME\methods\K000443.TV1 TWS_HOME\methods\R000443.TV1 TWS_HOME\methods\r3batch.exe TWS_HOME\methods\r3batch.opts TWS_HOME\methods\r3batch.properties TWS_HOME\methods\r3batch_cp.map TWS_HOME\methods\librfc32.dll TWS_HOME\methods\enigma.exe TWS_HOME\methods\msvcrt.dll TWS_HOME\methods\msvbvm60.dll TWS_HOME\methods\msvcp60.dll TWS_HOME\methods\defs\r3batch.def TWS_HOME\catalog\C\r3batch.cat TWS_HOME\methods\mvsca7.exe TWS_HOME\methods\mvsca7.opts TWS_HOME\methods\mvsca7.properties TWS_HOME\methods\mvsjes.exe TWS_HOME\methods\mvsjes.opts TWS_HOME\methods\mvsjes.properties TWS_HOME\methods\mvsopc.exe TWS_HOME\methods\mvsopc.opts TWS_HOME\methods\mvsopc.properties TWS_HOME\methods\oslayer.dll TWS_HOME\methods\defs\mvsca7.def TWS_HOME\methods\defs\mvsjes.def TWS_HOME\methods\defs\mvsopc.def TWS_HOME\methods\msvcrt.dll TWS_HOME\catalog\C\mvs.cat TWS_HOME\methods\opted\jakarta-oro-2.0.6.jar TWS_HOME\methods\opted\opted.bat TWS_HOME\methods\opted\tws4apps.jar TWS_HOME\methods\opted\tws4appsbeans.jar TWS_HOME\methods\opted\uil.jar TWS_HOME\methods\opted\xercesImpl.jar TWS_HOME\methods\opted\xmlParserAPIs.jar TWS_HOME\methods\opted.exe TWS_HOME\methods\_xauninst\uninstall.dat TWS_HOME\methods\_xauninst\uninstall.jar TWS_HOME\methods\_xauninst\uninstaller.exe

Mtodo de Acesso do z/OS

Comum

Desinstalao

190

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

A tabela a seguir lista os arquivos instalados no Unix (Plataformas de nvel 1).


Tabela 27. Arquivos instalados no Unix (Plataformas de nvel 1). Recurso Mtodo de Acesso do Oracle e-Business Suite Arquivos TWS_HOME/catalog/C/mcm.cat TWS_HOME/methods/MCMAGENT.opts TWS_HOME/methods/MCMAGENT.properties TWS_HOME/methods/OracleTMP/MCMAGENT TWS_HOME/methods/OracleTMP/MCMLJ.o TWS_HOME/methods/OracleTMP/MCMSTAT.o TWS_HOME/methods/OracleTMP/MCMTJ.o TWS_HOME/methods/OracleTMP/MCMprod.txt TWS_HOME/methods/OracleTMP/libusr.a TWS_HOME/methods/OracleTMP/mcm.mk TWS_HOME/methods/OracleTMP/mcminstall TWS_HOME/methods/OracleTMP/mcmoptions TWS_HOME/methods/defs/MCMAGENT.def TWS_HOME/methods/enigma TWS_HOME/catalog/C/r3batch.cat TWS_HOME/methods/K000443.TV1 TWS_HOME/methods/R000443.TV1 TWS_HOME/methods/defs/r3batch.def TWS_HOME/methods/enigma TWS_HOME/methods/r3batch TWS_HOME/methods/r3batch.opts TWS_HOME/methods/r3batch.properties TWS_HOME/methods/r3batch_cp.map TWS_HOME/catalog/C/mvs.cat TWS_HOME/methods/defs/mvsca7.def TWS_HOME/methods/defs/mvsjes.def TWS_HOME/methods/defs/mvsopc.def TWS_HOME/methods/mvsca7 TWS_HOME/methods/mvsca7.opts TWS_HOME/methods/mvsca7.properties TWS_HOME/methods/mvsjes TWS_HOME/methods/mvsjes.opts TWS_HOME/methods/mvsjes.properties TWS_HOME/methods/mvsopc TWS_HOME/methods/mvsopc.opts TWS_HOME/methods/mvsopc.properties TWS_HOME/methods/opted.bin TWS_HOME/methods/opted/jakarta-oro-2.0.6.jar TWS_HOME/methods/opted/opted.sh TWS_HOME/methods/opted/tws4apps.jar TWS_HOME/methods/opted/tws4appsbeans.jar TWS_HOME/methods/opted/uil.jar TWS_HOME/methods/opted/xercesImpl.jar TWS_HOME/methods/opted/xmlParserAPIs.jar TWS_HOME/methods/_xauninst/uninstall.dat TWS_HOME/methods/_xauninst/uninstall.jar TWS_HOME/methods/_xauninst/uninstaller

Mtodo de Acesso do R/3

mtodo de Acesso do z/OS

Comum

Desinstalao

Captulo 31. Arquivos Instalados

191

192

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Parte 7. Apndices

Copyright IBM Corp. 2000, 2003

193

194

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Avisos
Estas informaes foram desenvolvidas para produtos e servios oferecidos nos Estados Unidos. possvel que a IBM no oferea os produtos, servios ou recursos discutidos nesta publicao em outros pases. Consulte um representante IBM local para obter informaes sobre produtos e servios disponveis atualmente em sua rea. Qualquer referncia a um produto, programa ou servio da IBM no tem a inteno de afirmar ou inferir que somente esse produto, programa ou servio possa ser utilizado. Qualquer produto, programa ou servio funcionalmente equivalente, que no infrinja nenhum direito de propriedade intelectual da IBM, poder ser utilizado em substituio a este produto, programa ou servio. Entretanto, a avaliao e verificao da operao de qualquer produto, programa ou servio no-IBM so de responsabilidade do Cliente. A IBM pode ter patentes ou solicitaes de patentes relativas a assuntos tratados neste documento. O fornecimento deste documento no garante ao Cliente nenhum direito sobre tais patentes. Voc pode enviar consultas sobre licena, por escrito, para: Gerncia de Relaes Comerciais e Industriais da IBM Brasil Av. Pasteur, 138 - 146, Botafogo Rio de Janeiro, RJ CEP 22290-240 Para pedidos de licena listados a informaes de DBCS (conjunto de caracteres de byte duplo), entre em contato com o Departamento de Propriedade Intelectual da IBM em seu pas ou envie pedidos de licena, por escrito, para: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan O pargrafo a seguir no se aplica ao Reino Unido ou a qualquer outro pas no qual tais provises sejam inconsistentes com leis locais: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAO NO ESTADO EM QUE SE ENCONTRA, SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA OU IMPLCITA, INCLUINDO, MAS NO SE LIMITANDO S GARANTIAS IMPLCITAS DE NO-VIOLAO, MERCADO OU ADEQUAO A UM DETERMINADO PROPSITO. Alguns pases no permitem a excluso de garantias expressas ou implcitas em certas transaes; portanto, esta disposio pode no se aplicar ao Cliente. Estas informaes podem incluir imprecises tcnicas ou erros tipogrficos. So feitas alteraes peridicas nas informaes aqui contidas; tais alteraes sero
Copyright IBM Corp. 2000, 2003

195

incorporadas em futuras edies desta publicao. A IBM pode fazer aperfeioamentos e/ou alteraes nos produtos ou programas descritos nesta publicao a qualquer momento sem aviso prvio. Referncias nestas informaes a web sites no-IBM so fornecidas apenas por convenincia e no representam de forma alguma um endosso a esses web sites. Os materiais contidos nesses Web sites no fazem parte dos materiais deste produto IBM e a utilizao desses Web sites de inteira responsabilidade do cliente. A IBM tem direito de utilizao ou distribuio das informaes da forma que julgar adequada, sem incorrer em obrigaes para com o Cliente. Licenciados deste programa que desejam obter informaes adicionais sobre este assunto com objetivo de permitir: (i) a troca de informaes entre programas criados independentemente e outros programas (incluindo este) e (ii) a utilizao mtua das informaes trocadas, devem entrar em contato com: Gerncia de Relaes Comerciais e Industriais da IBM Brasil Av. Pasteur, 138-146, Botafogo Rio de Janeiro, RJ CEP 22290-240 Tais informaes podem estar disponveis, sujeitas a termos e condies apropriadas, incluindo em alguns casos o pagamento de uma taxa. O programa licenciado descrito neste documento e todo o material licenciado disponvel so fornecidos pela IBM sob os termos do Contrato com o Cliente IBM, Contrato de Licena de Programao Internacional IBM ou qualquer outro contrato equivalente. Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto, os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas medidas podem ter sido feitas nos sistemas a nvel de desenvolvimento e no h garantias de que estas medidas sero as mesmas nos sistemas geralmente disponveis. Alm disso, algumas medidas podem ter sido estimadas por extrapolao. Os resultados reais podem variar. Os usurios deste documento devem verificar os dados aplicveis em seu ambiente especfico. Informaes relativas a produtos no-IBM foram obtidas junto aos fornecedores destes produtos, seus anncios publicados ou outras fontes pblicas disponveis. A IBM no efetuou testes nestes produtos e no pode confirmar a preciso de seu desempenho, compatibilidade ou qualquer outro requisito listado a produtos no-IBM. Dvidas sobre os recursos de produtos no-IBM devem ser dirigidas aos fornecedores destes produtos. Estas informaes contm exemplos de dados e relatrios utilizados em operaes de negcios dirias. Para ilustr-los o melhor possvel, os exemplos contm nomes de pessoas, empresas, marcas e produtos. Todos os nomes so fictcios e qualquer semelhana com nomes e endereos de empresas reais mera coincidncia.

196

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Se estas informaes estiverem sendo exibidas em cpia eletrnica, as fotografias e ilustraes coloridas podem no aparecer.

Marcas
IBM, o logotipo da IBM, Tivoli, AIX, AS/400, Dynix, MVS/ESA, OS/390, RACF, RS/6000, Sequent, z/OS e zSeries so marcas ou marcas registradas da International Business Machines Corporation nos Estados Unidos e/ou em outros pases. Microsoft e Windows NT so marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros pases. UNIX marca registrada da The Open Group nos Estados Unidos e em outros pases.

Java e todas as marcas e logotipos baseados em Java so marcas ou marcas registradas da Sun Microsystems, Inc. nos Estados Unidos e em outros pases.

Outros nomes de empresas, produtos e servios podem ser marcas ou marcas de servio de terceiros.

Avisos

197

198

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Glossrio A
Agente de rede. Um tipo de agente estendido utilizado para criar dependncias entre jobs e fluxos de job em redes separadas do Tivoli Workload Scheduler. Consulte tambm Dependncia INET (entre redes). Agente estendido. Os agentes estendidos so usados para integrar os recursos de controle do job do Tivoli Workload Scheduler a outros sistemas operacionais (por exemplo, MVS) e aplicativos (por exemplo, Oracle Applications, Peoplesoft e R/3). Os agentes estendidos utilizam scripts chamados mtodos de acesso, para se comunicarem com sistemas externos. Agente tolerante a falhas. Uma estao de trabalho do agente na rede do Tivoli Workload Scheduler capaz de resolver as dependncias locais e lanar seus jobs na ausncia de um gerenciador de domnio. agente X. Consulte Agente estendido. arquivo stdlist. Um arquivo de lista padro criado para cada job lanado pelo Tivoli Workload Scheduler. Os arquivos da lista padro contm cabealho e banners do trailer, comandos repetidos, erros e avisos. Estes arquivos podem ser utilizados para detectar problemas na execuo do job. Arquivo symphony. Este arquivo contm as informaes de planejamento necessrias pelo processo de Controle de Produo (batchman) para executar o plano. O arquivo criado e carregado durante a fase de pr-produo. Durante a fase de produo, ele , continuamente, atualizado para indicar o status atual de processamento de produo: trabalho concludo, trabalho em andamento, trabalho a ser executado. Para gerenciar o processamento de produo, o contedo do arquivo Symphony (plano) pode ser exibido e alterado com o Job Scheduling Console. Banco de dados expandido. Bancos de dados expandidos permitem nomes mais longos para objetos do banco de dados, tais como jobs, fluxos de job, estaes de trabalho, domnios e usurios. Os bancos de dados expandidos so configurados utilizando o comando dbexpand ou como uma opo durante a instalao. No expanda seu banco de dados antes de entender as implicaes e impacto deste comando. Batchman. Um processo iniciado no comeo de cada dia de processamento do Tivoli Workload Scheduler para lanar jobs de acordo com as informaes no arquivo Symphony.

C
Calendrio. Um objeto definido no banco de dados do Tivoli Workload Scheduler que contm uma lista de datas de planejamento. Como um objeto exclusivo definido no banco de dados, ele pode ser atribudo a vrios fluxos de job. Atribuir um calendrio a um fluxo de job faz com que o fluxo de job seja executado nos dias especificados no calendrio. Observe que um calendrio pode ser utilizado como um ciclo de execuo inclusivo ou exclusivo. Caracteres Curinga. Os caracteres curinga para Tivoli Workload Scheduler so: ? Substitui um caractere alfa. % Substitui um caractere numrico. * Substitui zero ou mais caracteres alfanumricos. Geralmente, os caracteres curinga so utilizados para redefinirem uma pesquisa para um ou mais objetos no banco de dados. Por exemplo, se desejar exibir todas as estaes de trabalho, possvel digitar o caractere curinga asterisco (*). Para obter uma listagem de estaes de trabalho site1 at site8, voc pode digitar site%. Ciclo de execuo. Um ciclo de execuo especifica os dias em que um fluxo de job planejado para execuo. No Tivoli Workload Scheduler, existem trs tipos de ciclos de execuo que voc pode especificar para um fluxo de job: um ciclo de execuo Simples, um ciclo de execuo Semanal ou um ciclo de execuo Calendrio (geralmente chamado de calendrio). Observe que cada tipo de ciclo de execuo pode ser inclusivo ou exclusivo. Isto , cada ciclo de execuo pode definir os dias que um fluxo de job includo no ciclo de produo ou os dias que um fluxo de job excludo do ciclo de produo. Quando voc definir vrios ciclos de execuo para um fluxo de job e os ciclos de execuo inclusivos e exclusivos especificam os mesmos dias, os ciclos de execuo exclusivos so antecedidos. Ciclo de execuo exclusivo. Um ciclo de execuo que especifica os dias que um fluxo de job no pode

B
Banco de Dados. O banco de dados contm todas as definies criadas para objetos de planejamento (por exemplo, jobs, fluxos de job, recursos, estaes de trabalho, etc). Alm disso, o banco de dados mantm outras informaes importantes tais como estatsticas do job e execuo do fluxo de job, informaes sobre o ID do usurio que criou um objeto e a ltima data modificada de um objeto. Em comparao, o plano contm somente estes jobs e fluxos de job (incluindo objetos dependentes) que so planejados para execuo na produo diria.

Copyright IBM Corp. 2000, 2003

199

ser executado. Os ciclos de execuo exclusivos antecedem os ciclos de execuo inclusivos. Ciclo de Execuo Inclusivo. Um ciclo de execuo que especifica os dias que um fluxo de job planejado ser executado. Os ciclos de execuo exclusivos antecedem os ciclos de execuo inclusivos. Ciclo de Execuo Semanal. Um ciclo de execuo que especifica os dias da semana que um fluxo de job executado. Por exemplo, um fluxo de job pode ser especificado para executar toda segunda-feira, quarta-feira e sexta-feira utilizando um ciclo de execuo semanal. Um ciclo de execuo semanal definido para um fluxo de job especfico e no pode ser utilizado por vrios fluxos de job. Para obter maiores informaes, consulte Ciclo de Execuo. Ciclo de Execuo Simples. Um conjunto especfico de dias definidos pelo usurio em que um fluxo de job executado. Um ciclo de execuo simples definido por um fluxo de job especfico e no pode ser utilizado por vrios fluxos de job. Para obter maiores informaes, consulte Ciclo de Execuo. Classe da estao de trabalho. Uma classe da estao de trabalho um grupo de estaes de trabalho. possvel colocar qualquer nmero de estaes de trabalho em uma classe. Os fluxos de job e jobs podem ser atribudos para serem executados em uma classe da estao de trabalho. Este cria a replicao de um job ou fluxo de job atravs de muitas estaes de trabalho acessveis. Comandos utilitrios. Um conjunto de executveis da linha de comandos para gerenciar o planejador. Composer. Um aplicativo existente da linha de comandos para gerenciamento de definies de seus objetos de planejamento no banco de dados. Conman. Conman (console manager) um aplicativo existente da linha de comandos para gerenciamento do ambiente de produo. O Conman executa as seguintes tarefas: inicia e pra os processos de produo, altera e exibe agendas e jobs no plano e controla a ligao da estao de trabalho em uma rede.

Dependncia seguinte. Uma dependncia onde um job ou fluxo de job no pode comear a execuo, at que outros jobs ou fluxos de job foram concludos com xito. Dependncias INET (entre redes). Uma dependncia entre jobs ou fluxos de jobs em redes separadas do Tivoli Workload Scheduler. Consulte tambm Agente de rede. Domnio. Um grupo nomeado de estaes de trabalho do Tivoli Workload Scheduler que consiste em um ou mais agentes e em um gerenciador de domnio que age como o hub de gerenciamento. Todos os domnios possuem um domnio pai, exceto para o domnio principal. Durao. O tempo previsto para a concluso do job. Na exibio Linha de Tempo de jobs no banco de dados, a durao representada por uma barra azul-clara no centro da barra de atividade, ou por um losango azul-claro.

E
Estao de trabalho. Geralmente, uma estao de trabalho um computador individual no qual jobs e fluxos de job so executados. Eles so definidos no banco de dados do Tivoli Workload Scheduler como um objeto exclusivo. requerida uma definio da estao de trabalho para todo computador que executa jobs ou fluxos de job na rede do Workload Scheduler. Exibio em rvore. A exibio no lado esquerdo do Job Scheduling Console que exibe o servidor do planejador, grupos de listas padro e grupos de listas criadas pelo usurio.

F
Fluxo de Job Final. O fluxo de job FINAL deve ser o ltimo fluxo de job executado em um dia de produo. Ele contm um job que executa o arquivo script Jnextday.

G
Gerenciador de Domnio. O hub de gerenciamento em um domnio do Tivoli Workload Scheduler. Todas as comunicaes para e dos agentes no domnio so roteadas atravs do gerenciador de domnio. Gerenciador de Domnio Principal. Em uma rede do Tivoli Workload Scheduler, o gerenciador de domnio principal mantm os arquivos utilizados para documentar os objetos de planejamento. Ele cria o plano no incio de cada dia e executa todo registro e relatrio da rede.

D
Dependncia. Um pr-requisito que deve ser satisfeito antes que a execuo de um job ou fluxo de job possa continuar. O nmero mximo de dependncias permitido para um job ou fluxo de job 40. Os quatro tipos de dependncias utilizados pelo Tivoli Workload Scheduler so as dependncias a seguir, dependncias de recursos, dependncias de arquivos e dependncias de prompts.

200

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

H
Hora de Incio Estimada. A hora antes da qual o job ou fluxo de job no pode ser iniciado. A hora de incio estimada aquela estimada baseada em experincias anteriores de execuo do job ou fluxo de job. No entanto, o job ou fluxo de job pode iniciar aps a hora especificada, desde que todas as outras dependncias estejam solucionadas. Na linha de tempo, a hora de incio representada pelo incio (canto esquerdo) da barra de atividade azul-marinho. Para ocorrncias de jobs, a hora de incio que o IBM Tivoli Workload Scheduler para z/OS calcula representado por uma barra azul-clara.Consulte tambmTempo de incio atual e Hora inicial planejada. Hora Inicial Planejada. A hora que o planejador estima que uma ocorrncia de job ser iniciada. Esta estimativa baseada nas horas de incio de execues anteriores. Host. Uma estao de trabalho do Workload Scheduler requerida por agentes estendidos. Pode ser qualquer estao de trabalho do planejador, exceto outro agente estendido.

Jobs interativos. Um job que , interativamente, executado em um desktop do Windows NT. Job Stream (Fluxo de Job). Uma lista de jobs que executada como uma unidade (tal como um aplicativo de backup semanal), junto com horas, prioridades e outras dependncias que determinam a ordem exata de execuo do job.

L
Limitador. O limitador de job um controle principal na execuo do job em uma estao de trabalho. O limitador de job um nvel de prioridade que uma prioridade do job ou do fluxo de job deve exceder antes de poder ser executado. Por exemplo, definir o limitador para 40 previne que jobs com prioridades 40 ou menos sejam lanados. Limite. Os limites do job fornecem uma maneira de alocar um nmero especfico de slots de job no qual o Tivoli Workload Scheduler tem permisso para lanar jobs. Um limite de job pode ser definido para cada fluxo de job e para cada estao de trabalho. Por exemplo, definir o limite de job da estao de trabalho como 25 permite que o planejador no tenha mais que 25 jobs sendo executados simultaneamente na estao de trabalho. Lista. Uma lista exibe objetos de planejamento de job. necessrio criar listas separadas para cada objeto de planejamento do job. Para cada objeto de planejamento do job, h dois tipos de listas: uma de definies no banco de dados e outra de ocorrncias no plano.

I J
Job . Uma unidade de trabalho que processada em uma estao de trabalho. A definio do job consiste em um nome de job exclusivo no banco de dados do planejador junto com outras informaes necessrias para executar o job. Quando voc inclui um job em um fluxo de job, possvel definir suas dependncias e suas restries de tempo tal como a hora de incio e o tempo final estimados. Job externo. Um job de um fluxo de job que um predecessor de um job de outro fluxo de job. Um job externo representado por um cone marcador de lugar na exibio de Grfico do fluxo do job. Job / Fluxo de Job INET (entre redes). Um job ou fluxo de job de uma rede remota do Tivoli Workload Scheduler que um predecessor de um job ou fluxo de job na rede local. Um job entre redes representado por um cone marcador de lugar na exibio de Grfico do fluxo de job. Consulte tambm Agente de rede. Job Jnextday. O processamento da produo anterior e posterior pode ser totalmente automatizado pelo planejamento do job Jnextday para execuo no final de cada dia. Um exemplo de job jnextday fornecido como TWShome\Jnextday. O job Jnextday faz o seguinte: configura o processamento do dia seguinte (contido no arquivo Symphony), imprime relatrios, transporta fluxos de job no concludos e encerra e reinicia o planejador.

M
Mtodo de acesso. Um mtodo de acesso um executvel usado por agente estendidos para conectar e controlar a execuo do job em outros sistemas operacionais (por exemplo, MVS) e aplicativos (por exemplo, Oracle Applications, Peoplesoft e R/3). O mtodo de acesso deve ser especificado na definio da estao de trabalho para o agente estendido.

N
Ocorrncia do fluxo de job. Um fluxo de job planejado para uma data de execuo especfica no plano. Consulte tambm Fluxo de job. Ocorrncia do Job. Um job planejado para uma data de execuo especfica no plano. Consulte tambm Job. Opes globais. As opes globais so definidas no gerenciador de domnio principal no arquivo globalopts e essas opes aplicam-se a todas as estaes de trabalho na rede do Tivoli Workload Scheduler. Consulte tambm Opes locais.
Glossrio

201

Opes locais. So definidas no arquivo localopts. Cada estao de trabalho na rede do Tivoli Workload Scheduler deve ter um arquivo localopts. As definies neste arquivo aplicam-se apenas a essa estao de trabalho. Consulte tambm Opes globais.

de fitas disponveis como uma dependncia. Os jobs com esta dependncia no podem ser executados concorrentemente, porque toda vez que um job executado, o recurso de fitas est em uso. Restries de tempo. Podem ser especificadas para jobs e fluxos de job. Uma hora pode ser especificada para a execuo comear ou uma hora pode ser especificada, aps a qual a execuo no ser tentada. Especificando ambas, voc pode definir uma janela dentro da qual um job ou fluxo de job ser executado. Para os jobs, voc tambm pode especificar uma taxa de repetio. Por exemplo, voc pode lanar no Tivoli Workload Scheduler o mesmo job a cada 30 minutos entre s 8:30 a.m. e 1:30 p.m.

P
Parmetro. Os parmetros so utilizados para substituir valores em seus jobs e fluxos de job. Ao utilizar um parmetro em um script de job, o valor ser substitudo na hora da execuo. Neste caso, o parmetro deve ser definido na estao de trabalho onde ser utilizado. Os parmetros no podem ser utilizados quando fazer um script de jobs de agentes estendidos. Plano. O plano contm toda atividade de planejamento de job planejada por um perodo de um dia. No Tivoli Workload Scheduler, o plano criado a cada 24 horas e consiste em todos os jobs, fluxos de job e objetos de dependncia que so planejados para serem executados nesse dia. Todos os fluxos de jobs para os quais foram criados ciclos de execuo, so planejados automaticamente e includos no plano. Como os progressos do ciclo de produo, os jobs e fluxos de job no plano so executados de acordo com suas restries de tempo e outras dependncias. Todos os jobs ou fluxos de jobs que no so executados com xito, so deixados no plano do dia seguinte. Predecessor. Um job que deve ser concludo com xito antes que os jobs do sucessor possam comear a execuo. Prioridade. O planejador possui um sistema de enfileiramento para jobs e fluxos de job no plano. Voc pode atribuir um nvel de prioridade para cada job e fluxo de job de 0 a 101. Uma prioridade 0 no ser executada. Prompt. Os prompts podem ser utilizados como dependncias para jobs e fluxos de job. Um prompt deve ser respondido positivamente para o job ou fluxo de job dependente a ser lanado. Existem dois tipos de prompts: predefinido e especial. Um prompt ad hoc definido dentro das propriedades de job ou fluxo de job e exclusivo para esse job ou fluxo de job. Um prompt predefinido definido no banco de dados do planejador e pode ser utilizado por qualquer job ou fluxo de job.

S
Status. Reflete o status atual do job ou fluxo de job dentro do Job Scheduling Console. O status do Job Scheduling Console comum para o Tivoli Workload Scheduler e IBM Tivoli Workload Scheduler para z/OS.Consulte tambm Status interno. Status do job. Consulte Status. Status interno. Reflete o status atual de jobs e fluxos de job no mecanismo do planejador. O status interno exclusivo para o Tivoli Workload Scheduler. Consulte tambm Status. Sucessor. Um job que no pode ser iniciado, at que todos os jobs do predecessor nos quais ele depende sejam concludos com xito.

T
Tempo final. O ltimo momento em que um job ou fluxo de job pode comear a execuo. Este corresponde Hora final no Maestro existente.

U
Usurio. Somente para o Windows NT, o nome do usurio especificado em um campo Logon de definio do job deve ter uma definio do usurio correspondente. As definies fornecem as senhas do usurio requeridas pelo planejador para lanar jobs.

W X

R
Recurso. Os recursos podem representar recursos fsicos ou lgicos em seu sistema. Uma vez definidos no banco de dados do Tivoli Workload Scheduler, eles podem ser utilizados como dependncias para jobs e fluxos de job. Por exemplo, voc pode definir um recurso nomeado fitas com um valor de unidade dois. Em seguida, definir jobs que requerem duas unidades

202

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

ndice Remissivo Caracteres Especiais


WORKSTATION NAME_MCMAGENT.opts 48 criando um job 102 criando um job no R/3 101 criando uma dependncia aberta 78 criptografando, senha do usurio do R/3 89 criptografando senhas do usurio 54 criptografia de senha 54 incluindo, programa externo 106 informaes de diagnstico 162 informaes iniciais 57 iniciar 145 instalao 149 instalando mdulos ABAP 91 INTERLINKSUBSYSTEM 147

A
acessibilidade xiii agente padro 45 tolerante a falhas 45 agente estendido definio de estao de trabalho 169 referncia 169 viso geral 169 alterado senha, usurio RFC 97 arquivo de controle 94 arquivo de dados 94 arquivo de opes 57 arquivo de opes, R3OPTIONS 85 Arquivo de Script 154 arquivo mcmagent.opts exemplo 54 sintaxe de entrada 53 viso geral 53 arquivo R3OPTIONS 85 arquivos de correo e de transporte 94 arquivos de opes psagent 65

D
DEBUG 147 definies de job 77 definindo jobs do Oracle Applications no Tivoli Workload Scheduler 49 definindo jobs no Oracle Applications 49 definindo jobs no Peoplesoft 57 definindo jobs no R/3 101 dependncia aberta 78 dependncia em jobs do zOS 154 dependncias de job do zOS 154 depurar 96

J
JCL para descarregar a fita 143 JESCMDCHR 147 joblog 127 jobs estados do job 112 jobs do CA7 153 jobs do JES 153 jobs do OPC 154 jobs do Oracle Applications definindo 49

L
LJuser 152

E
enigma 54 estados, job 112 estados de ocorrncia para o OPC estados do aplicativo para o OPC estados do job Maestro e Oracle Applications estados do job do R/3 112 estados do job para CA7 158 estados do job para JES 157 estados do job para o OPC 160 execuo de job 201 exemplo de dependncias abertas exemplos de dependncias abertas 160 160 51

M
manuais consultar publicaes ix, xii mapeamento de status do job 80 mapeando status, jobs 80 mapeando status do job 80 MAXWAIT 147 MCMAGENT 47 MCMAGENT.opts 47 MCSSTORAGE 147 mensagens 165 mensagens de erro 165 mensagens de gateway 165 mtodo 85 mtodo do R3BATCH 85 mdulos ABAP 106 mdulos ABAP, importando 94

B
bancos de dados do Peoplesoft, vrios 69 BDC wait 127

C
CA7INTERFACE 145 CA7NAME 145 CA7OPTIONS 146 CA7SPAN(9999) 146 CA7SUBSYSTEM 146 CA7USER 146 CFuser 152 CheckInterval 152 compatibilidade 87 COMPLETIONCODE 147 conectando vrios bancos de dados 69 conexo para R/3, soluo de problemas 96 conexo R/3 96 contato por e-mail xii controle de execuo do job 101 convenes tipo de caractere xiii convenes de tipo de caractere xiii criando jobs de agente estendido 77 criando o perfil de autorizao 91 Copyright IBM Corp. 2000, 2003

79 79

F
feedback sobre as publicaes xii

G
gateway do z/OS descarregando arquivos da fita descarregando arquivos do CD-ROM 142 143

N
nomes de caminho, notao xiv nomes de diretrio, notao xiv notao nomes de caminho xiv tipo de caractere xiv variveis de ambiente xiv

H
host de destino 105

O I
incluindo, ABAP 106 incluindo, etapas 106 opo BDC wait 96 OPCINTERFACE 147 OPCMSGCLASS 148 opes psagent 65

203

OPCSUBSYSTEM 148 OPERCMDS 145 Oracle Applications x-agent recursos 45

U
Usurio RFC 96

P
PEERADDRESS 148 perfil de autorizao, criando perfil RFC 91 pilha TCPIP 148 planejando agente viso geral 85 PORT 148 programa enigma 89 programa externo 106 psagent 57, 69 publicaes ix acessando on-line xii solicitando xii publicaes on-line acessando xii PUTLINE 148 91

V
variveis, notao de xiv variveis de ambiente, notao xiv variveis SYSTSIN 145 vrios bancos de dados do Peoplesoft 69 verso TCP/IP 141 viso geral 57 viso geral da operao CA7 158 viso geral da operao JES 157, 158 viso geral da operao OPC 159 viso geral de instalao 87 viso geral tcnica 157

W
WTP 149

Z Q
QLIMIT 148 ZOSV1R2 149

R
rastreio 96 recursos 45, 57, 141 requisitos de software 61, 63 requisitos do host 61

S
Sada IEFU84 144 segurana 144 segurana do console 145 senha do usurio RFC 97 sintaxe, arquivo mcmagent.opts 53 software componentes 47 requisitos 45 software de interface 47 solicitando publicaes xii soluo de problemas de conexo R/3 96 status de verificao bm 159, 161 SUBSYS 148 suporte ao cliente consulte suporte de software xiii suporte ao software entrando em contato xiii SVCDUMP 148

T
TCPIPSTACK 148 TCPNAME 149 TERMINATOR 149 Tivoli Software Information Center xii

204

IBM Tivoli Workload Scheduler para Aplicativos: Guia do Usurio

Impresso em Brazil

S517-7785-00