Guia do Usurio
V erso 8.2
S517-7785-00
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
. 31 . 33 . 34 . 34 . 35
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
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
83
. . 85 do . . 85 . . 86
iv
. . .
. . .
. . .
. . .
Captulo 29. Configurando o Utilitrio de Rastreamento . . . . . . . . . . 185 Captulo 30. Resoluo de Problemas 187
. 159 . 161
ndice
vi
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
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
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
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
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/
xii
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.
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.
xiv
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 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
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.
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.
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.
3.
4. Selecione o boto de opes para aceitar o acordo e clique em Next para continuar. A janela Escolher o Tipo de Instalao exibida.
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.
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
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.
11
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
Figura 10. Primeira janela Informaes Adicionais do Usurio para o Mtodo de Acesso do PeopleSoft.
13
Figura 11. Segunda janela Informaes Adicionais do Usurio para o Mtodo de Acesso do PeopleSoft.
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
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.
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.
15
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.
16
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
-P MCMAGENT_FEATURE.active
Verdadeiro ou Falso.
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
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
-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
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
20
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
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
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.
23
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.
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
25
26
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
Exibio de Opes de Arquivos Exibe as opes de um arquivo selecionado em qualquer uma das trs exibies disponveis.
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.
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.
30
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.
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
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
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.
33
Consulte IBM Tivoli Workload Scheduler - Guia de Referncia para obter mais detalhes sobre como definir as estao de trabalho com o composer.
34
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.
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
36
37
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
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.
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.
40
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.
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
43
44
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
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
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
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
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
49
50
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
51
Para obter informaes adicionais sobre o gerenciamento de job, consulte o Tivoli Workload Scheduler - Manual de Referncia.
52
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.
ENV
USERID
PASSWORD
PRINTER_NAME
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
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
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
55
56
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.
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.
Segurana
A segurana para os jobs do PeopleSoft tratada por padro pela segurana do Tivoli Workload Scheduler.
58
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
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.
61
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.
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
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.
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.
63
64
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.
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
COBROOT
66
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
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.
68
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.
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
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
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.
Depois da concluso, voc dever ter no menu Iniciar/Programas um novo item rotulado PeopleSoft 7.5.
72
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.
73
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.
74
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."
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
-runcontrol -outputdest
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
78
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
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 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)
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.
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
DELETE ERROR
CANCEL FAIL
HOLD
HOLD
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
durante um processo de manuteno normal. Com objetivos de processamento do jnextday, tais solicitaes devem ser consideradas inexistentes.
81
82
83
84
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.
85
Para obter informaes adicionais sobre o gerenciamento do job, consulte o Guia de Referncia do IBM Tivoli Workload Scheduler SH19-4556.
86
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.
87
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
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.
89
90
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.
91
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
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.
92
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)
93
S_SPO_DEV
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.
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
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.
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
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.
97
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.
98
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.
99
100
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.
102
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.
103
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
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.
105
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
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.
107
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
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
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.
110
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
111
Este um exemplo para o job do InfoPackage cujo nome tcnico do campo ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY:
-job ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY -i ipak_
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
113
114
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.
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.
116
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
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
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
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
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
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
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.
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
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
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
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
127
holddate = holddate. message i001(92) with group. write: /(30) BDC_OPEN_GROUP(i02), (12) returncode:(i05), sy_subrc. endif. 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.
128
No se esquea de definir a varivel myqid no BDCRECXX. Com esse mtodo, voc vai obter uma alterao global no sistema R/3.
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
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.
131
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.
132
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*
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
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
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.
135
136
137
138
139
140
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.
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.
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
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.
142
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.
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.
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
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
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)
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
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)
149
150
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
151
CFuser=name
GSuser=name
CheckInterval=min
RetryCount=count
152
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.
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
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)
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)
154
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.
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"
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.
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)"
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)"
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
exec succ
Em execuo Concludo
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.
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
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.
159
160
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.
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
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
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
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
165
166
167
168
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
-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.
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.
172
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.
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.
174
Tarefa CF
Ao do Tivoli Workload Scheduler Define o estado do arquivo como SIM. Define o estado do arquivo como NO.
Um mtodo que no suporta a tarefa CF grava uma mensagem %UT no stdout e sai com um cdigo de sada 2.
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.
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.
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.
Esse erro no ser exibido se um agente estendido for selecionado como resultado da utilizao de caracteres curinga.
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
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"
177
178
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
180
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
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
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.
183
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.
184
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
187
188
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
Comum
Desinstalao
190
Comum
Desinstalao
191
192
Parte 7. Apndices
193
194
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
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
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.
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
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
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
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
Impresso em Brazil
S517-7785-00