Vous êtes sur la page 1sur 230

IBM Tivoli Workload Scheduler for Applications

Guide dutilisation
V ersion 8.2

SC11-2011-00

IBM Tivoli Workload Scheduler for Applications

Guide dutilisation
V ersion 8.2

SC11-2011-00

Important Avant dutiliser le prsent document et le produit associ, prenez connaissance des informations gnrales figurant la section Remarques la page 197.

Premire dition - juillet 2003 Rf. US : SC32-1278-00 LE PRESENT DOCUMENT EST LIVRE EN LETAT. IBM DECLINE TOUTE RESPONSABILITE, EXPRESSE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE QUALITE MARCHANDE OU DADAPTATION A VOS BESOINS. Certaines juridictions nautorisent pas lexclusion des garanties implicites, auquel cas lexclusion ci-dessus ne vous sera pas applicable. Remarque : Les captures dcrans et les graphiques de cette brochure ne sont pas disponibles en franais la date dimpression. Ce document est mis jour priodiquement. Chaque nouvelle dition inclut les mises jour. Les informations qui y sont fournies sont susceptibles dtre modifies avant que les produits dcrits ne deviennent eux-mmes disponibles. En outre, il peut contenir des informations ou des rfrences concernant certains produits, logiciels ou services non annoncs dans ce pays. Cela ne signifie cependant pas quils y seront annoncs. Pour plus de dtails, pour toute demande dordre technique, ou pour obtenir des exemplaires de documents IBM, rfrez-vous aux documents dannonce disponibles dans votre pays, ou adressez-vous votre partenaire commercial. Vous pouvez galement consulter les serveurs Internet suivants : v http://www.fr.ibm.com (serveur IBM en France) v http://www.can.ibm.com (serveur IBM au Canada) v http://www.ibm.com (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualit Tour Descartes 92066 Paris-La Dfense Cedex 50 Copyright IBM France 2003. Tous droits rservs. Copyright International Business Machines Corporation 2002,2003. All rights reserved. Copyright International Business Machines Corporation 2000, 2003. All rights reserved.

Table des matires


Avis aux lecteurs canadiens . . . . . vii Avant-propos . . . . . . . . . . . . ix
A qui sadresse ce manuel ? . . . . . . . . Que contient ce manuel ? . . . . . . . . . Publications . . . . . . . . . . . . . Publications concernant IBM Tivoli Workload Scheduler . . . . . . . . . . . . . Publications concernant IBM Tivoli Workload Scheduler pour z/OS . . . . . . . . . Kit de collecte des versions lectroniques pour IBM Tivoli Workload Scheduler for z/OS . . Publications connexes . . . . . . . . . Accs en ligne aux publications . . . . . Commande de publications . . . . . . . Commentaires sur les publications . . . . Accessibilit . . . . . . . . . . . . . Contact du service de support dIBM . . . . . Conventions utilises dans ce manuel . . . . Conventions typographiques . . . . . . Variables et chemins dpendants du systme dexploitation . . . . . . . . . . . . ix . ix . xii . xii . xii . . . . xiii xiv xiv xiv . xv . xv . xv . xv . xv Dfinition de postes de travail pour une planification de bout en bout . . . . . . Cration de linstruction CPUREC . . . . Dfinition dun poste de travail avec ISPF . . . . . 34 . 34 . 35

Chapitre 5. Dfinition des travaux dagent tendu . . . . . . . . . . . 37


Dfinition des travaux avec Job Scheduling Console 37 Dfinition des travaux partir de la ligne de commande Tivoli Workload Scheduler . . . . . 40 Dfinition des travaux pour une planification de bout en bout . . . . . . . . . . . . . . 41

Partie 2. Mthode daccs Oracle e-Business Suite . . . . . . . . . 43


Chapitre 6. Introduction . . . . . . . 45
Fonctions . . . . . . . . Configuration logicielle requise . Tches post-installation . . . Programmes dinterface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 45 45 47

. xvi

Partie 1. Installation commune et tches de configuration . . . . . . . 1


Chapitre 1. Gnralits sur le produit . . 3 Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications . . 5
Procdures dinstallation . . . . . . . . . Utilisation de lassistant dinstallation . . . . Utilisation de linstallation automatique . . . Utilisation de Tivoli Configuration Manager . Dsinstallation du produit . . . . . . . . Suppression dune installation via ISMP . . . Suppression dune installation via Tivoli Configuration Manager . . . . . . . . Suppression manuelle des lments restants lors du retrait de la mthode daccs pour Oracle e-Business Suite . . . . . . . . . . . . 6 . 7 . 18 . 21 . 25 . 25 . 25

Chapitre 7. Informations sur la dfinition des travaux . . . . . . . . 49


Dfinition des travaux dans Oracle Applications . Excutions simultanes dun mme travail . . Dfinition des travaux Oracle Applications dans Tivoli Workload Scheduler . . . . . . . . Paramtres de chane de tches pour les travaux Oracle Applications . . . . . . . . . . Etats des travaux Tivoli Workload Scheduler et Oracle Applications . . . . . . . . . . . . 49 . 49 . 49 . 49 . 52

Chapitre 8. Informations de rfrence sur le fichier doptions MCMAGENT . . 53


Fichier doptions. . . Syntaxe des entres . Exemple . . . . Chiffrage des mots de Applications . . . . . . . . . . . . . . . . . . . . . passe utilisateur . . . . . . . . . . . . . . . Oracle . . . . 53 . 53 . 54 . 54

. 26

Chapitre 3. Dfinition des options laide de lEditeur doptions . . . . . . 27


Cration dun fichier doptions locales Hritage des valeurs des options . . . . . . . . . . . 30 . 30

Partie 3. Mthode daccs PeopleSoft . . . . . . . . . . . . 55


Chapitre 9. Introduction . . . . . . . 57
Fonctions . . . . . . . . . . . . . . Principes de fonctionnement . . . . . . . . Travaux du planificateur de traitements PeopleSoft Suivi des travaux PeopleSoft dans Tivoli Workload Scheduler . . . . . . . . . Scurit . . . . . . . . . . . . . . . Remarques sur le support PeopleSoft Version 8.x . . 57 . 57 58 . 58 . 58 . 58

Chapitre 4. Dfinition des postes de travail dagent tendu . . . . . . . . 31


Cration dun poste de travail Console. . . . . . . . Cration dun poste de travail commande . . . . . . avec Job Scheduling . . . . . . . . 31 partir de la ligne de . . . . . . . . 33

Copyright IBM Corp. 2000, 2003

iii

Chapitre 10. Planification dimplmentation . . . . . . . . . . 61


PeopleSoft version 7.5 ou antrieure . . . . Configuration requise pour lhte . . . . Configuration logicielle requise . . . . . Configuration de lutilisateur Windows . . Vrification de lenvironnement PeopleSoft . Cration dun ID de traitement par lots dans PeopleSoft . . . . . . . . . . . . Fichiers installs . . . . . . . . . . PeopleSoft version 8.x . . . . . . . . . Configuration requise pour lhte . . . . Configuration logicielle requise . . . . . Cration dun ID de traitement par lots dans PeopleSoft . . . . . . . . . . . . Fichiers installs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 61 61 61 62 62 62 62 62 63

Chiffrement des mots de passe utilisateur R/3

. 89

Chapitre 15. Configuration de lenvironnement R/3 . . . . . . . . . 91


Prsentation . . . . . . . . . . . . . . Cration de lutilisateur RFC pour IBM Tivoli Workload Scheduler . . . . . . . . . . . Cration du profil dautorisation pour lutilisateur Tivoli Workload Scheduler . . . . . . . . . Utilisation de la transaction SU02 pour la cration manuelle du profil . . . . . . . . Utilisation de la transaction PFCG (Gnrateur de profils) . . . . . . . . . . . . . . . Copie des fichiers de correction et de transfert . . . Importation de modules ABAP/4 dans R/3 . . . Installation des modules ABAP r3batch sur le systme R/3 . . . . . . . . . . . . . . Identification et rsolution des incidents . . . . . Modification du mot de passe de lID utilisateur RFC au niveau de Tivoli Workload Scheduler . . . . . . . . . . . . . . . Migration partir de versions prcdentes . . . . Utilisation du support dinterface XBP 2.0 . . . . Cration du profil dautorisation pour lutilisateur Tivoli Workload Scheduler . . . . Incidents dus aux paramtres dimpression et la classe de travail . . . . . . . . . . . . . 91 91 91 92 92 94 94 95 96

. 63 . 63

Chapitre 11. Tches post-installation


Configuration utilisateur pour Windows . . . . Cration du fichier doptions . . . . . . . Modification manuelle des fichiers doptions . Connexion plusieurs bases de donnes PeopleSoft . . . . . . . . . . . . . Configuration dun environnement PeopleSoft, version 7.5 ou antrieure . . . . . . . . . Personnalisation du serveur de processus . . Configuration du client . . . . . . . . Excution du script de loutil Dplacement de donnes . . . . . . . . . . . . . Configuration dun environnement PeopleSoft version 8.1x . . . . . . . . . . . . . Personnalisation du serveur dapplications . . Configuration du client . . . . . . . . Configuration dun environnement PeopleSoft version 8.4x . . . . . . . . . . . . .

65
. 65 . 65 . 68 . 69 . 69 . 69 . 71 . 72 . 74 . 74 . 75 . 75

97 97 98 99 99

Chapitre 16. Dfinition des travaux dagent tendu R/3 . . . . . . . . . 101


Dfinition dun travail dans R/3 . . . . . . Dfinition dun travail dans Tivoli Workload Scheduler. . . . . . . . . . . . . . Utilisation des fentres SAP de Job Scheduling Console . . . . . . . . . . . . . Paramtres de chane de tches pour les travaux R/3 . . . . . . . . . . . . Etats des travaux dans Tivoli Workload Scheduler et dans R/3 . . . . . . . . . . . . . . 101 . 101 . 102 . 109 . 111

Chapitre 12. Dfinition des travaux PeopleSoft . . . . . . . . . . . . . 77


Cration de dfinitions de travaux PeopleSoft dans Tivoli Workload Scheduler . . . . . . . . . Paramtres des chanes de tches des travaux PeopleSoft . . . . . . . . . . . . . . Configuration de dpendances OPENS 7.x uniquement . . . . . . . . . . . . . . Exemple de dpendances OPENS . . . . . . Mappage de statut des travaux IBM Tivoli Workload Scheduler et PeopleSoft . . . . . . . . . . 77

Chapitre 17. Rexcution de travaux


77 78 80 80 Ancienne et nouvelle copies dun travail rexcuter . . . . . . . . . . . . .

113
. 113

Chapitre 18. Business Information Warehouse . . . . . . . . . . . . 115


Prise en charge de Business Information Warehouse - InfoPackages . . . . . . . . Autorisations utilisateur . . . . . . . . Composants Business Information Warehouse . Dfinition des travaux dagent tendu pour BIW Options de planification R/3 dun InfoPackage . . 115 . 115 . 115 116 . 116

Partie 4. Mthode daccs R/3 . . . 83


Chapitre 13. Introduction . . . . . . . 85
Champ dapplication . . . . . . . . . . . 85 Processus de planification pour lagent tendu R/3 85 Support dinterface XBP 2.0 . . . . . . . . . 86

Chapitre 19. Connexion au systme R/3 . . . . . . . . . . . . 117


Connexions un serveur dapplications spcifique 117 Groupes de connexion . . . . . . . . . . 118

Chapitre 14. Installation . . . . . . . 87


Configuration logicielle requise . . . Gnralits sur linstallation . . . Installation sur des plateformes Tier2 . . . . . . . . . . . . . . 87 . 87 . 88

iv

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 20. Fichiers doptions de la mthode daccs R/3 . . . . . . . . 119


Options de configuration . . . . . Options globales . . . . . . . Options locales . . . . . . . . Options gnrales . . . . . . . Utilisation des options de configuration Migration des fichiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . . 119 119 120 121 123 124

Fonctionnement avec CA-7 . . . . . Autres conseils pour CA-7 . . . . . Fonctionnement avec linterface OPC ou Tivoli Workload Scheduler pour z/OS . Vrification des fichiers sur z/OS . . Considrations de dlais. . . . . . Informations relatives au diagnostic . . . Messages de la passerelle . . . . . .

. . . . avec . . . . . . . . . .

. 160 . 161 . . . . . 162 163 163 164 164

Chapitre 21. Attente BDC . . . . . . 127


Utilisation des noms de session BDC . . . . Utilisation des ID de file dattente BDC avec le rapport BDCRECXX . . . . . . . . . . Utilisation des ID de file dattente BDC avec le module fonctionnel BDC_OPEN_GROUP . . . . 127 . 128 . 129

Partie 6. Maintenabilit commune

169

Chapitre 27. Rfrence aux agents tendus . . . . . . . . . . . . . . 171


Que sont les agents tendus ? . . . . . . . . Dfinition de poste de travail . . . . . . . Interface de mthode daccs . . . . . . . . Syntaxe de la ligne de commande de la mthode . . . . . . . . . . . . . . Messages de rponse de mthode . . . . . Fichier doptions de mthode . . . . . . . Excution de mthode . . . . . . . . . . Tche de lancement dun travail (LJ) . . . . Tche de gestion du travail (MJ) . . . . . . Tche de vrification dun fichier (CF) . . . . Tche dobtention dun tat (GS) . . . . . . La commande cpuinfo . . . . . . . . . Identification et rsolution des incidents . . . . Messages derreur de la liste standard dun travail . . . . . . . . . . . . . . . Mthode non excutable . . . . . . . . . Messages du gestionnaire de consoles . . . . Messages du programme Composer et Compiler Messages de Jobman . . . . . . . . . . 171 171 171 171 174 175 175 176 176 177 177 178 178 178 179 179 179 179

Chapitre 22. Fonctions dinterception des travaux et fonctions parent-enfant 131


Interception des travaux . . . . . . . . . Implmentation de linterception de travaux . La fonction parent-enfant . . . . . . . . . 131 . 131 . 134

Chapitre 23. Support de la langue nationale . . . . . . . . . . . . . 137


Options de support de la langue nationale Pages de codes R/3 prises en charge . . Configurations prises en charge et limites . . . . . . . . 137 . 138 . 138

Partie 5. Mthode daccs z/OS


Fonctions . . . . . . . . . . . . . Configuration logicielle requise . . . . . Prsentation de linstallation . . . . . . Installation sur des plateformes de niveau 2 Installation sous z/OS . . . . . . . Dfinition des autorisations sous z/OS . . Remarques supplmentaires . . . . . Version de la passerelle z/OS . . . . . . . . . . . . .

139
. . . . . . . . 141 141 141 142 142 144 144 149

Chapitre 24. Introduction . . . . . . 141

Chapitre 28. Bibliothque de mappage de code retour . . . . . . . . . . . 181


Fichier de mappage du code retour . . . . . Mappage du code retour pour Psagent et MCMAGENT . . . . . . . . . . . Noms de fichier de mappage de code retour . 181 182 . 182 186

Chapitre 25. Configuration et fonctionnement . . . . . . . . . . 151


Fichiers doptions de mthode . . . . . . . Fichiers doptions de mthodes sur les plateformes de niveau 2 . . . . . . . . Dfinition de travaux dans z/OS . . . . . . Dfinition de travaux z/OS dans Tivoli Workload Scheduler. . . . . . . . . . . . . . Syntaxe de dfinition de tche pour les travaux z/OS planifis avec Tivoli Workload Scheduler Syntaxe de dfinition de tche pour les travaux z/OS . . . . . . . . . . . . . . Syntaxe des dpendances de fichier (OPENS) sur les fichiers z/OS . . . . . . . . . . 151 . 151 . 152 . 153 . 153 . 155 . 156

Chapitre 29. Configuration de lutilitaire de trace . . . . . . . . . 187 Chapitre 30. Identification et rsolution des incidents . . . . . . . 189
Identification des incidents lors de linstallation de la mthode daccs PeopleSoft . . . . . . . . 190

Chapitre 31. Fichiers installs . . . . 191

Partie 7. Annexes . . . . . . . . . 195


Remarques . . . . . . . . . . . . 197
Marques . . . . . . . . . . . . . . . 199

Chapitre 26. Informations de rfrence 159


Prsentation technique . . Fonctionnement sous JES . . . . . . . . . . . . . . . 159 . 159

Glossaire . . . . . . . . . . . . . 201
Table des matires

Index . . . . . . . . . . . . . . . 207

vi

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Avis aux lecteurs canadiens


Le prsent document a t traduit en France. Voici les principales diffrences et particularits dont vous devez tenir compte. Illustrations Les illustrations sont fournies titre dexemple. Certaines peuvent contenir des donnes propres la France. Terminologie La terminologie des titres IBM peut diffrer dun pays lautre. Reportez-vous au tableau ci-dessous, au besoin.
IBM France ingnieur commercial agence commerciale ingnieur technico-commercial inspecteur IBM Canada reprsentant succursale informaticien technicien du matriel

Claviers Les lettres sont disposes diffremment : le clavier franais est de type AZERTY, et le clavier franais-canadien de type QWERTY. OS/2 et Windows - Paramtres canadiens Au Canada, on utilise : v les pages de codes 850 (multilingue) et 863 (franais-canadien), v le code pays 002, v le code clavier CF. Nomenclature Les touches prsentes dans le tableau dquivalence suivant sont libelles diffremment selon quil sagit du clavier de la France, du clavier du Canada ou du clavier des tats-Unis. Reportez-vous ce tableau pour faire correspondre les touches franaises figurant dans le prsent document aux touches de votre clavier.

Copyright IBM Corp. 2000, 2003

vii

Brevets Il est possible quIBM dtienne des brevets ou quelle ait dpos des demandes de brevets portant sur certains sujets abords dans ce document. Le fait quIBM vous fournisse le prsent document ne signifie pas quelle vous accorde un permis dutilisation de ces brevets. Vous pouvez envoyer, par crit, vos demandes de renseignements relatives aux permis dutilisation au directeur gnral des relations commerciales dIBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance tlphonique Si vous avez besoin dassistance ou si vous voulez commander du matriel, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.

viii

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Avant-propos
Le manuel IBM Tivoli Workload Scheduler for Applications - Guide dutilisation explique comment installer, configurer et utiliser les mthodes daccs lapplication IBM Tivoli Workload Scheduler qui excutent et grent les travaux des applications suivantes : v Oracle e-Business Suite v PeopleSoft v R/3 v z/OS Ce guide aborde le contenu des manuels ci-dessous : v IBM Tivoli Workload Scheduler for Applications Version Oracle e-Business Suite v IBM Tivoli Workload Scheduler for Applications Version PeopleSoft v IBM Tivoli Workload Scheduler for Applications Version R/3 v IBM Tivoli Workload Scheduler for Applications Version z/OS

8.1.1 - Guide dutilisation pour 8.1.1 - Guide dutilisation pour 8.1.1 - Guide dutilisation pour 8.1.1 - Guide dutilisation pour

A qui sadresse ce manuel ?


Ce manuel est destin aux planificateurs de travaux qui souhaitent excuter et grer les travaux des applications cites plus haut laide dIBM Tivoli Workload Scheduler. Les lecteurs doivent possder des connaissances sur : v IBM Tivoli Workload Scheduler v Tivoli Job Scheduling Console v Lenvironnement propre lapplication

Que contient ce manuel ?


Ce manuel comprend les sections suivantes : 1re partie - Installation commune et tches de configuration La partie 1 comprend les chapitres suivants : v Chapitre 1, Gnralits sur le produit, la page 3 Ce chapitre dcrit le fonctionnement de base dun agent tendu. v Chapitre 2, Installation dIBM Tivoli Workload Scheduler for Applications, la page 5 Ce chapitre explique les diffrentes manires dinstaller et de dsinstaller le produit, ainsi que les plateformes prises en charge et les composants prrequis. v Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27 Ce chapitre explique comment utiliser lditeur doptions. v Chapitre 4, Dfinition des postes de travail dagent tendu, la page 31 Ce chapitre prsente la manire de dfinir les postes de travail dagent tendu pour toutes les mthodes daccs.
Copyright IBM Corp. 2000, 2003

ix

v Chapitre 5, Dfinition des travaux dagent tendu, la page 37 Ce chapitre explique comment dfinir des travaux dagent tendu pour toutes les mthodes daccs. 2me partie - Mthode daccs Oracle e-Business Suite La partie 2 comprend les chapitres suivants : v Chapitre 6, Introduction, la page 45 Ce chapitre dcrit les fonctions, la configuration requise pour le logiciel, les tches post-installation et le logiciel dinterface spcifiques de la mthode daccs Oracle e-Business Suite. v Chapitre 7, Informations sur la dfinition des travaux, la page 49 Ce chapitre fournit des informations pour la dfinition des travaux de Tivoli Workload Scheduler spcialement pour cette mthode daccs. v Chapitre 8, Informations de rfrence sur le fichier doptions MCMAGENT, la page 53 Ce chapitre dcrit les options utilises par cette mthode daccs. 3me partie - Mthode daccs PeopleSoft La partie 3 comprend les chapitres suivants : v Chapitre 9, Introduction, la page 57 Ce chapitre dcrit les fonctions, les fonctionnalits et dautres informations gnrales relatives la mthode daccs PeopleSoft. v Chapitre 10, Planification dimplmentation, la page 61 Ce chapitre prsente la configuration requise pour lhte et le logiciel ainsi que des informations relatives aux diffrentes versions de PeopleSoft prises en charge par cette mthode daccs. v Chapitre 11, Tches post-installation, la page 65 Ce chapitre prsente les tches post-installation pour cette mthode daccs. v Chapitre 12, Dfinition des travaux PeopleSoft, la page 77 Ce chapitre fournit des informations sur la dfinition des travaux de Tivoli Workload Scheduler spcialement pour cette mthode daccs. 4me partie - Mthode daccs R/3 La partie 4 comprend les chapitres suivants : v Chapitre 13, Introduction, la page 85 Ce chapitre dcrit les fonctions de la mthode daccs R/3. v Chapitre 14, Installation, la page 87 Ce chapitre fournit des informations concernant linstallation de cette mthode daccs et explique comment installer les plateformes de niveau 2. v Chapitre 15, Configuration de lenvironnement R/3, la page 91 Ce chapitre explique comment configurer cette mthode daccs pour quelle soit utilise avec R/3. v Chapitre 16, Dfinition des travaux dagent tendu R/3, la page 101 Ce chapitre fournit les informations sur la dfinition des travaux de Tivoli Workload Scheduler spcialement pour la mthode daccs R/3. v Chapitre 17, Rexcution de travaux, la page 113 Ce chapitre explique le mcanisme de rexcution des travaux.

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

v Chapitre 18, Business Information Warehouse, la page 115 Ce chapitre fournit des informations sur la manire dutiliser la mthode daccs avec lentrept de donnes mtier R/3. v Chapitre 19, Connexion au systme R/3, la page 117 Ce chapitre dcrit les connexions et les groupes de connexion R/3. v Chapitre 20, Fichiers doptions de la mthode daccs R/3, la page 119 Ce chapitre dcrit les options utilises par cette mthode daccs. v Chapitre 21, Attente BDC, la page 127 Ce chapitre fournit des informations dtailles sur lattente BDC. v Chapitre 22, Fonctions dinterception des travaux et fonctions parent-enfant, la page 131 Ce chapitre dcrit les fonctions parent-enfant et les fonctions dinterception de travaux de XBP 2.0. v Chapitre 23, Support de la langue nationale, la page 137 Ce chapitre dcrit le support de la langue nationale pour cette mthode daccs. 5me partie - Mthode daccs z/OS La partie 5 comprend les chapitres suivants : v Chapitre 24, Introduction, la page 141 Ce chapitre rpertorie les fonctions de la mthode daccs z/OS, explique comment installer lenvironnement rparti sur les plateformes de niveau 2 et comment installer le composant passerelle sur z/OS. v Chapitre 25, Configuration et fonctionnement, la page 151 Ce chapitre prsente les options de cette mthode daccs et fournit des informations concernant la dfinition des travaux pour cette mthode. v Chapitre 26, Informations de rfrence, la page 159 Ce chapitre fournit des informations de rfrence destination des planificateurs de travaux autoriss et rpertorie les messages relatifs la passerelle. 6me partie - Maintenabilit commune La partie 6 comprend les chapitres suivants : v Chapitre 27, Rfrence aux agents tendus, la page 171 Ce chapitre fournit des informations de rfrence pour le dveloppement dune mthode daccs Tivoli Workload Scheduler. v Chapitre 28, Bibliothque de mappage de code retour, la page 181 Ce chapitre explique comment utiliser lutilitaire de mappage de code retour. v Chapitre 29, Configuration de lutilitaire de trace, la page 187 Ce chapitre explique comment configurer lutilitaire de trace. v Chapitre 30, Identification et rsolution des incidents, la page 189 Ce chapitre fournit des informations gnrales sur lidentification des incidents. v Chapitre 31, Fichiers installs, la page 191 Ce chapitre rpertorie les fichiers installs en fonction de la plateforme et de la fonction.

Avant-propos

xi

Publications
Cette section rpertorie les publications dans la bibliothque IBM Tivoli Workload Scheduler et explique comment accder en ligne aux publications Tivoli, comment les commander et transmettre vos commentaires.

Publications concernant IBM Tivoli Workload Scheduler


Cette section rpertorie les publications prsentes dans la bibliothque de IBM Tivoli Workload Scheduler et dans les documents qui sy rapportent. Elle explique aussi comment accder aux publications Tivoli en ligne et comment les commander. v IBM Tivoli Workload Scheduler - Guide de planification et dinstallation, SC11-2008 Dcrit comment planifier un rseau Tivoli Workload Scheduler et comment installer et personnaliser Tivoli Workload Scheduler ainsi que le logiciel qui lui est associ. v IBM Tivoli Workload Scheduler - Guide de rfrence, SC11-2009 Explique la ligne de commande de Tivoli Workload Scheduler, le fonctionnement des agents tendus et des agents de rseau et lintgration de Tivoli Workload Scheduler dans NetView et dans Tivoli Business Systems Manager. v IBM Tivoli Workload Scheduler Troubleshooting and Error Messages, SC32-1275 Interprte les messages derreur de Tivoli Workload Scheduler et fournit des sources dinformation pour vous aider rsoudre les problmes relatifs cette application. v IBM Tivoli Workload Scheduler Job Scheduling Console - Notes ddition, SC11-2007 Fournit des informations sur la manire de travailler avec Tivoli Workload Scheduler partir dune interface graphique commune, quelle que soit la plateforme utilise. v IBM Tivoli Workload Scheduler Job Scheduling Console - Guide dutilisation, SC11-2006 Fournit des informations sur la manire de travailler avec Tivoli Workload Scheduler partir dune interface graphique commune, quelle que soit la plateforme utilise. v IBM Tivoli Workload Scheduler for Applications Release Notes, SC32-1279 Fournit les informations jour sur les agents tendus de Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler AS/400 Limited Fault-tolerant Agent Users Guide, SC32-1280 Dcrit linstallation, la configuration et lutilisation sur lAS/400 des agents de Tivoli Workload Scheduler tolrants aux pannes. v IBM Tivoli Workload Scheduler - Guide de lutilisateur du module Plus, SC11-2010 Explique comment configurer et utiliser le module Plus de Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler Release Notes, SC32-1277 Explique les informations jour sur Tivoli Workload Scheduler.

Publications concernant IBM Tivoli Workload Scheduler pour z/OS


Les documents ci-dessous sont disponibles dans la bibliothque dIBM Tivoli Workload Scheduler pour z/OS : v IBM Tivoli Workload Scheduler pour z/OS Customization and Tuning, SC32-1265

xii

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Explique comment personnaliser Tivoli Workload Scheduler pour z/OS. v IBM Tivoli Workload Scheduler pour z/OS Diagnosis Guide and Reference, SC32-1261 Fournit des informations daide au diagnostic et la correction des incidents lors de lutilisation du produit. v IBM Tivoli Workload Scheduler pour z/OS - Informations gnrales, SC11-2005 Prsente les avantages de la suite complte Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler pour z/OS Getting Started, SC32-1262 Dcrit les concepts et la terminologie dIBM Tivoli Workload Scheduler for z/OS et donne des instructions pour vous permettre de travailler avec le produit le plus rapidement possible. v IBM Tivoli Workload Scheduler pour z/OS Installation Guide, SC32-1264 Explique comment installer Tivoli Workload Scheduler pour z/OS. v IBM Tivoli Workload Scheduler pour z/OS Licensed Program Specifications, GI11-4208 Fournit des informations sur la planification concernant Tivoli Workload Scheduler pour z/OS. IBM Tivoli Workload Scheduler pour z/OS Managing the Workload, SC32-1263 Explique comment planifier la charge de travail et comment contrler et surveiller le plan actuel. IBM Tivoli Workload Scheduler pour z/OS Memo to Users, GI11-4209 Fournit un rsum des modifications pour ldition actuelle du produit. IBM Tivoli Workload Scheduler pour z/OS Messages and Codes, SC32-1267 Explique les messages et les codes. IBM Tivoli Workload Scheduler pour z/OS Program Directory, GI11-4203 Fourni par la bande dinstallation de Tivoli Workload Scheduler pour z/OS, il dcrit tous les supports dinstallation et donne des instructions dinstallation correspondant au niveau ddition du produit et au numro de la fonction. IBM Tivoli Workload Scheduler pour z/OS Programming Interfaces, SC32-1266 Fournit les informations permettant dcrire les programmes de lapplication.

v v v

v IBM Tivoli Workload Scheduler pour z/OS Quick Reference, SC32-1268 Fournit un moyen de rfrence facile et rapide pour consulter comment fonctionne le produit.

Kit de collecte des versions lectroniques pour IBM Tivoli Workload Scheduler for z/OS
Tous les manuels de la bibliothque, lexception des publications sous licence, peuvent tre affichs via leur version lectronique dans les kits de collecte suivants : v IBM Online Library Omnibus Edition OS/390 Collection Kit, SK2T-6700. v IBM Online Library z/OS Software Products Collection Kit, SK2T-4270. Vous pouvez la version lectronique des manuels sur CD-ROM laide de ces logiciels IBM sous licence : v Softcopy Reader v BookManager READ/2 v BookManager READ/DOS v BookManager READ/6000 Tous les logiciels de type BookManager requirent un ordinateur quip dun lecteur de CD-ROM (capable de lire des CD-ROM de norme ISO 9660), ainsi quun
Avant-propos

xiii

adaptateur et un cble correspondants. Pour plus dinformations concernant les matriels et les logiciels requis, reportez-vous la documentation concernant le produit BookManager spcifique que vous utilisez. Les mises jour des manuels intervenant entre deux ditions sont uniquement fournies sous forme de copie lectronique.

Publications connexes
Le glossaire des logiciels Tivoli (Tivoli Software Glossary) comprend les dfinitions de nombreux termes techniques relatifs aux logiciels Tivoli. Il est disponible ladresse suivante (en anglais uniquement) : http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

Accs en ligne aux publications


Le CD de documentation contient les publications prsentes dans la bibliothque du produit. Le format des publications est PDF, HTML ou les deux. Pour accder aux publications laide dun navigateur Web, ouvrez le fichier infocenter.html, qui se trouve dans le rpertoire des publications appropri sur le CD du produit. IBM cre des publications pour tous les nouveaux produits Tivoli et chaque nouvelle mise jour, et les met disposition sur le site Web Tivoli Software Information Center. Le Tivoli Software Information Center est situ ladresse suivante : http://publib.boulder.ibm.com/tividd/td/tdprodlist.html Cliquez sur le lien Tivoli Workload Scheduler pour accder la bibliothque de produits. Remarque : Si vous imprimez des documents PDF sur un format autre que le papier lettre, cochez la case Ajuster la page dans la fentre Imprimer dAdobe Acrobat. Cette option est disponible lorsque vous cliquez sur Fichier Imprimer. Loption Ajuster la page garantit que les dimensions dune page au format lettre simpriment sur le format de papier que vous utilisez.

Commande de publications
Vous pouvez commander en ligne un grand nombre de publications Tivoli sur le site Web suivant :
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi

Vous pouvez aussi passer votre commande par tlphone en appelant lun des numros suivants : v Aux Etats-Unis : (1)800-879-2755 v Au Canada : (1)800-426-4968 Pour les autres pays, consultez la liste des numros de tlphone sur le site Web ci-dessous : http://www.ibm.com/software/tivoli/order-lit/

xiv

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Commentaires sur les publications


Si vous avez des commentaires ou des suggestions concernant les produits Tivoli et leur documentation, rpondez ltude client disponible sur le site Web ladresse : http://www.ibm.com/software/sysmgmt/products/support

Accessibilit
Les fonctions daccessibilit permettent aux utilisateurs possdant un handicap physique, tel quune mobilit rduite ou une vision champ limit, dutiliser les produits logiciels de manire efficace. Grce ce produit, vous pouvez utiliser les technologies dassistance pour naviguer dans linterface. Vous pouvez galement utiliser le clavier de prfrence la souris pour excuter toutes les fonctions de linterface graphique. Pour plus dinformations, consultez lannexe relative laccessibilit dans le manuel IBM Tivoli Workload Scheduler Job Scheduling Console - Guide dutilisation.

Contact du service de support dIBM


Si vous rencontrez un problme avec un produit Tivoli, vous pouvez contacter le service de support dIBM. Consultez le IBM Software Support Guide sur le site Web suivant : http://techsupport.services.ibm.com/guides/handbook.html Ce guide vous indique comment contacter le service de support dIBM, en fonction de la gravit du problme et vous fournit les informations suivantes : v Inscription et validit v Les numros de tlphone et les adresses de courrier lectronique, en fonction du pays o vous vous trouvez v Les informations que vous devez avoir votre porte avant de contacter le service de support dIBM

Conventions utilises dans ce manuel


Ce manuel utilise plusieurs conventions concernant les actions et les termes spcifiques, ainsi que les chemins et les commandes spcifiques du systme dexploitation.

Conventions typographiques
Ce manuel utilise les conventions typographiques suivantes : Gras v Commandes en minuscules et utilisation de caractres majuscules et minuscules (sauf ceux qui sont tous en lettres majuscules) dont la distinction savrerait par ailleurs difficile partir du contexte v Contrles de linterface (cases cocher, boutons de fonction, boutons radio, slecteurs rotatifs, zones, dossiers, icnes, botes liste, lments compris dans les botes liste, listes multi-colonnes, conteneurs, options de menu, noms de menu,

Avant-propos

xv

onglets, feuilles de proprits), libells (tels que Conseil : et Considrations du systme dexploitation :) v En-ttes de colonnes dans un tableau v Mots cls et paramtres dans le texte Les commandes (sauf celles qui apparaissent en lettres majuscules) sont affiches en caractres gras. Italique v v v v v Citations (titres de manuels, disquettes et CD) Mots dfinis dans le texte Mise en vidence des mots (mots en tant que tels) Lettres en tant que telles Nouveaux termes dans le texte (sauf dans une liste de dfinition)

v Variables et valeurs fournir Espacement fixe v Exemples, exemples de code et rsultat v Noms de fichier, mots cls de programmation et autres lments difficiles distinguer en contexte v Texte et invites de messages destins lutilisateur v Texte que lutilisateur doit entrer v Valeurs pour les arguments ou les options de commande Les exemples de code, les rsultats, le texte que vous devez entrer et les messages systme sont affichs en police en espacement fixe. Barres de rvision Les modifications dordre technique apportes au texte sont indiques par une ligne verticale situe gauche de la modification.

Variables et chemins dpendants du systme dexploitation


Ce manuel utilise la convention UNIX pour spcifier les variables denvironnement et pour la notation des rpertoires. Lorsque vous utilisez la ligne de commande de Windows, remplacez $variable par % variable% pour les variables denvironnement, et remplacez chaque barre oblique (/) par une barre oblique inverse ( \) dans les chemins des rpertoires. Remarque : Si vous utilisez le shell bash sur un systme Windows, vous pouvez utiliser les conventions UNIX.

xvi

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 1. Installation commune et tches de configuration

Copyright IBM Corp. 2000, 2003

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 1. Gnralits sur le produit


Les agents tendus (XA) permettent dtendre les fonctions de planification de travaux de IBM Tivoli Workload Scheduler dautres systmes et applications. Un agent tendu est un poste de travail disposant dun hte et dune mthode daccs. Lhte est un agent tolrant aux pannes (FTA) ou un agent standard (SA) de Tivoli Workload Scheduler. La mthode daccs est un programme excut par le poste de travail hbergeant lorsque Tivoli Workload Scheduler doit interagir avec le systme externe, via sa ligne de commande ou via Tivoli Job Scheduling Console. Tivoli Workload Scheduler for Applications inclut les mthodes daccs suivantes : v mthode daccs pour Oracle e-Business Suite (MCMAGENT), v mthode daccs pour PeopleSoft (psagent), v mthode daccs pour R/3 (r3batch), v mthode daccs pour z/OS (mvsca7, mvsjes et mvsopc). Pour lancer et contrler un travail sur un agent tendu, lhte excute la mthode daccs en transmettant les informations relatives au travail sous la forme doptions de ligne de commande. La mthode daccs communique avec le systme externe pour lancer le travail et renvoie le statut de ce travail. Un poste de travail dagent tendu nest quune entit logique associe une mthode daccs hberge par le poste de travail physique Tivoli Workload Scheduler. Plusieurs postes de travail dagent tendu peuvent tre hbergs par le mme poste de travail Tivoli Workload Scheduler et utiliser la mme mthode daccs. Lagent tendu (ou x-agent) est dfini dans le cadre dune dfinition de poste de travail Tivoli Workload Scheduler standard, laquelle attribue un nom lagent tendu et identifie la mthode daccs. Le schma ci-aprs illustre comment ces lments interagissent dans le cas dune configuration type dagent tendu.

Copyright IBM Corp. 2000, 2003

Figure 1. Fonctionnement des agents tendus.

Pour lancer un travail dans un environnement externe, Tivoli Workload Scheduler excute la mthode daccs associe lagent tendu et fournit cette dernire le nom du poste de travail dagent tendu ainsi que les informations relatives au travail. La mthode analyse le fichier correspondant, nomm <NOM_POSTE_DE_TRAVAIL>_ <nom_mthode>.opts, pour dterminer linstance denvironnement externe laquelle elle se connectera. La mthode daccs peut alors lancer des travaux sur cette instance et les contrler tout au long de leur excution en crivant la progression du travail et les informations dtat dans le fichier stdlist du travail. Les agents tendus peuvent galement tre utiliss pour excuter des travaux dans un environnement semi-ferm, o la planification et le contrle des travaux seffectuent partir dun contrleur IBM Tivoli Workload Scheduler pour z/OS.

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications


Sur la plupart des plateformes prises en charge, toutes les mthodes daccs dIBM Tivoli Workload Scheduler for Applications dcrites dans ce guide sont installes via un processus dinstallation commun. Ce processus permet dinstaller une instance de Tivoli Workload Scheduler for Applications (o une instance correspond lassociation dau moins une mthode daccs une installation existante de Tivoli Workload Scheduler) et de slectionner une ou plusieurs mthodes daccs partir des composants dinstallation. Le processus dinstallation commun est disponible pour les plateformes suivantes, lorsque celles-ci sont prises en charge par une mthode daccs : v Microsoft Windows NT ou 2000, v IBM AIX, v HP-UX, v Environnement dexploitation Sun, v Linux pour Intel, v Linux/390. Pour les plateformes suivantes, le processus dinstallation reste identique celui dcrit dans la documentation des diffrentes mthodes, dans les chapitres suivants : v Compaq Tru64 v SGI Irix v IBM Sequent Dynix Le tableau ci-dessous rpertorie les plateformes prises en charge par cette version dIBM Tivoli Workload Scheduler for Applications :
Tableau 1. Plateformes prises en charge Mthode daccs Plateforme IBM OS/390 V2R10 et suprieures IBM z/OS V1R1 et suprieures IBM AIX Versions 4.3.3, 5.1, 5.2 IBM Sequent Dynix Version 4.5.1 Environnement dexploitation Solaris Versions 7, 8, 9 Hewlett Packard PA-RISC Versions 11.0, 11i z/OS (passerelle) X X X X X X X X X z/OS (serveur de transactions) R/3 PeopleSoft Oracle eBusiness Suite

Copyright IBM Corp. 2000, 2003

Tableau 1. Plateformes prises en charge (suite) Mthode daccs Plateforme SuSE Linux Enterprise Server Version 7 pour OS/390 et zSeries (noyau 2.4) RedHat Linux pour OS/390 et zSeries Version 7 RedHat Linux (Intel) Versions 7.2, 7.3 SuSE Linux (Intel) Enterprise Server Version 8 Microsoft Windows NT Version 4.0 avec Service Pack 6a Microsoft Windows 2000 avec Service Pack 3 Professional, Server, Advanced Compaq Tru64 Version 5.1 SGI Irix Version 6.5.x X z/OS (passerelle) z/OS (serveur de transactions) X R/3 X PeopleSoft Oracle eBusiness Suite

X X

X X

Procdures dinstallation
Vous avez le choix entre trois mthodes pour installer Tivoli Workload Scheduler for Applications : v Utiliser lassistant InstallShield Multi-Platform (ISMP), v Excuter loption dinstallation automatique dInstallShield, v Utiliser le composant Software Distribution de Tivoli Configuration Manager. Avant dinstaller le produit laide de lune des procdures susmentionnes, vrifiez que vous remplissez les conditions suivantes : v Vous devez avoir une installation valide dIBM Tivoli Workload Scheduler, Version 7.0 ou suprieure, sur votre ordinateur avant dinstaller lune des mthodes daccs. v Vous devez disposer de droits Root (sous Unix) ou Administrateur (sous Windows) pour excuter linstallation. v Vous devez arrter tous les services Tivoli Workload Scheduler avant de dmarrer le processus dinstallation. v Dans le cas de la mthode daccs destine PeopleSoft, linstallation de cette dernire requiert que le ou les environnements PeopleSoft correspondants soient dj installs et entirement accessibles partir du poste de travail o vous effectuez linstallation.

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

v Dans le cas de la mthode daccs pour Oracle eBusiness Suite, le serveur Oracle e-Business Suite doit tre situ sur le mme noeud physique que la mthode daccs et lhte Tivoli Workload Scheduler. v Vrifiez que le processus dinstallation na pas dj t lanc sur le poste de travail. Ce scnario peut se produire sur un rseau o plusieurs connexions Telnet ont t ouvertes sur une mme station Unix par des utilisateurs autoriss commander distance linstallation dune mthode daccs. Lancez la commande suivante pour dterminer si le processus dinstallation est dj actif sur lordinateur o vous voulez procder linstallation :
ps -ef | grep setup.bin

De mme, si votre poste de travail excute plusieurs instances de Tivoli Workload Scheduler, veillez ne pas excuter le processus dinstallation sur plus dune instance la fois. v Avant dinstaller des instances supplmentaires du produit ou de mettre jour des instances existantes, vrifiez que lEditeur doptions nest pas en cours dexcution, sinon linstallation pourrait chouer. Reportez-vous au Chapitre 31, Fichiers installs, la page 191 pour consulter la liste des fichiers que vous devriez trouver sur votre ordinateur lissue de linstallation.

Utilisation de lassistant dinstallation


Pour utiliser lassistant dinstallation ISMP sur votre ordinateur, votre systme dexploitation doit pouvoir excuter lenvironnement dexcution Java (JRE) Version 1.3.1. Certaines plateformes requirent des niveaux de maintenance pour prendre en charge JRE 1.3.1. Reportez-vous au tableau ci-dessous pour savoir si votre systme dexploitation doit (ou non) tre mis jour. Aucun correctif supplmentaire nest requis pour les plateformes prises en charge, non mentionnes dans ce tableau.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

Tableau 2. Correctifs requis pour excuter JRE 1.3.1 Systme dexploitation IBM AIX Version 4.3.3 IBM AIX Version 5.1 Correctif requis pour excuter JRE 1.3.1 Niveau de maintenance recommand AIX 433010. Niveau de maintenance recommand AIX 510002. Ce niveau de maintenance requiert que le correctif APAR IY19375 ait t prcdemment appliqu et valid. Si vous utilisez lun des paramtres locaux CKJ non-UTF8 pris en charge, vous devez disposer de lun des ensembles de fichiers suivants (disponibles sur le CD dAIX 5.1 base) : v X11.fnt.ucs.ttf (pour ja_JP ou Ja_JP) v X11.fnt.ucs.ttf_CN (pour zh_CN ou Zh_CN) v X11.fnt.ucs.ttf_KR (pour ko_KR) v X11.fnt.ucs.ttf_TW (pour zh_TW ou Zh_TW) Pour les utilisateurs japonais : si vous utilisez la mthode dentre propre au japonais, vous pouvez appliquer les PTF suivants pour viter certains incidents lis la mthode dentre : v jkit.Wnn6.base 2.2.0.2 (PTF U479697 ou APAR IY22917) (uniquement utilisateur de Wnn6), v X11.motif.lib 5.1.0.15 (PTF U479604 ou APAR IY22933) (uniquement utilisateur dAIX 5.1). Environnement dexploitation Solaris Versions 7, 8, 9 Hewlett Packard PA-RISC Versions 11.0, 11i Ensembles de correctifs dats du mois de janvier 2002 ou ultrieurs. Les correctifs du systme dexploitation doivent tre installs avant le produit. Pour dterminer les correctifs installer sur votre ordinateur, connectez-vous en tant que Root et excutez : /usr/sbin/swlist -l produit Pour prendre en charge JRE 1.3.1.05, vous devez avoir : v pour HP-UX 11.0, le Quality Pack QPK1100, v pour HP-UX 11i, le Quality Pack GOLDQPK11i.

Pour installer une ou plusieurs mthodes daccs de Tivoli Workload Scheduler for Applications sur votre ordinateur, procdez comme suit : 1. Arrtez tous les services Tivoli Workload Scheduler. 2. Excutez la commande dinstallation partir du CD du produit ou dune image, savoir : v setup.bin sous Unix, ou v setup.exe sous Windows. La fentre Bienvenue saffiche.

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Figure 2. Fentre Bienvenue.

3.

Cliquez sur Suivant pour continuer. La fentre Contrat de licence logicielle apparat.

Figure 3. Fentre Contrat de licence logicielle.

4. Slectionnez le bouton correspondant pour accepter le contrat et cliquez sur Suivant pour continuer. La fentre Slectionnez un type dinstallation apparat.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

Figure 4. Fentre Slectionnez un type dinstallation

5.

Dterminez si vous voulez procder une nouvelle installation de Tivoli Workload Scheduler for Applications ou mettre jour une installation existante. Si vous installez une mthode daccs supplmentaire, slectionnez Mettre jour une instance. v Si vous choisissez Crer une nouvelle instance, le programme dinstallation dtecte et numre toutes les installations de Tivoli Workload Scheduler prsentes sur votre ordinateur. v Si vous choisissez Mettre jour une instance, le programme dinstallation dtecte et numre toutes les installations de Tivoli Workload Scheduler for Applications prsentes sur votre ordinateur. Cliquez sur Suivant pour continuer. Si vous avez slectionn Crer une nouvelle instance, une fentre similaire la figure 5 la page 11 apparat.

10

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Figure 5. Fentre Instances installes de Tivoli Workload Scheduler.

Le programme dinstallation sonde le systme et rpertorie toutes les instances existantes de Tivoli Workload Scheduler. Remarques : a. Si le processus dexploration ne dtecte aucune instance existante, une fentre saffiche, vous permettant dentrer le chemin dinstallation et le nom dune instance. b. Si vous tes sous Unix et avez plusieurs installations de Tivoli Workload Scheduler, version 7.0 ou 8.1, qui nont pas t correctement installes dans un rpertoire de base /home/ utilisateur_TWS, la fentre affiche alors, au hasard, une seule de ces instances et lappelle <unknown>. Parmi ces instances, celle-ci sera la seule que vous pourrez marquer pour linstallation. Reportez-vous au tableau 24 la page 189 pour plus de dtails. Si vous avez slectionn Mettre jour une instance, une fentre similaire la figure 6 la page 12 apparat.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

11

Figure 6. Fentre Instances installes de Tivoli Workload Scheduler for Applications.

Le programme dinstallation sonde le systme et rpertorie toutes les instances existantes de Tivoli Workload Scheduler for Applications. 6. Slectionnez une ou plusieurs instances et cliquez sur Suivant pour continuer. Une fentre apparat, rpertoriant toutes les mthodes daccs dfinies dans Tivoli Workload Scheduler for Applications. La liste varie en fonction de la plateforme sur laquelle vous procdez linstallation : les installations sous Unix ne proposent pas la mthode daccs pour PeopleSoft, alors que les installations sous Windows ne proposent pas la mthode daccs pour Oracle. Voici un exemple dinstallation sous Windows.

Figure 7. Fentre de slection des composants Tivoli Workload Scheduler for Applications sous MS Windows.

12

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Voici un exemple dinstallation sous Unix.

Figure 8. Fentre de slection des composants Tivoli Workload Scheduler for Applications sous Unix.

7. Slectionnez la ou les mthodes daccs que vous voulez installer sur votre ordinateur et cliquez sur Suivant pour continuer. En fonction du nombre et des mthodes daccs que vous avez slectionnes, une ou plusieurs fentres supplmentaires apparatront, vous demandant dentrer des informations spcifiques lune ou lautre de ces mthodes, savoir : v Pour toutes les mthodes daccs : le nom de lutilisateur Tivoli Workload Scheduler qui excutera la mthode slectionne. Il peut sagir du mme nom que celui dfini lors de linstallation de Tivoli Workload Scheduler. v Pour la mthode daccs PeopleSoft : la version de lenvironnement PeopleTools ainsi que lun des chemins suivants : pour les versions PeopleSoft 7.0x ou 7.5x, le chemin du rpertoire dexcution COBOL (gnralement <racine_PS>\cblbin), pour la version PeopleSoft 8.1x, le chemin des API PeopleSoft externes (gnralement <REP_API_EXT>\bin\client\winx86_extapi), pour la version PeopleSoft 8.4x, le chemin du rpertoire client PeopleSoft (gnralement <racine_PS>\bin\client\winx86). Voici la fentre de la mthode daccs R/3.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

13

Figure 9. Fentre supplmentaire dinformations utilisateur pour la mthode daccs R/3.

Voici la premire fentre de la mthode daccs PeopleSoft.

Figure 10. Premire fentre supplmentaire dinformations utilisateur pour la mthode daccs PeopleSoft.

Voici la deuxime fentre de la mthode daccs PeopleSoft.

14

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Figure 11. Deuxime fentre supplmentaire dinformations utilisateur pour la mthode daccs PeopleSoft.

Voici la fentre de la mthode daccs z/OS.

Figure 12. Fentre supplmentaire dinformations utilisateur pour la mthode daccs z/OS.

8.

Entrez les informations requises et cliquez sur Suivant pour continuer. Une fentre dinformations rcapitulatives apparat. La figure 13 la page 16 reprsente un exemple dinformations rcapitulatives pour linstallation de la mthode daccs R/3.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

15

Figure 13. Fentre dinformations rcapitulatives pour linstallation.

9. Cliquez sur Suivant pour continuer. Le processus dinstallation commence installer les mthodes daccs slectionnes sur votre ordinateur. Une fentre de progression saffiche.

Figure 14. Fentre de progression de linstallation.

Une fois linstallation termine, la fentre suivante apparat, vous demandant si vous voulez (ou non) excuter lEditeur doptions. Il sagit dun diteur de fichiers Java qui permet de dfinir des options pour les mthodes daccs que vous avez installes. Si vous choisissez de ne pas excuter lEditeur doptions immdiatement, vous pourrez le faire, tout moment, ultrieurement.

16

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Figure 15. Fentre de lancement de lEditeur doptions .

10.

Cliquez sur le bouton doption appropri pour excuter (ou non) lEditeur doptions immdiatement et cliquez sur Suivant pour continuer. Si vous cliquez sur Oui, lEditeur doptions souvre, vous permettant de dfinir les options des mthodes que vous avez installes. Reportez-vous au Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27 pour plus de dtails sur lutilisation de lEditeur doptions. Lorsque vous avez fini dutiliser lEditeur doptions (ou que vous aviez slectionn Non dans la fentre prcdente), la fentre de fin dinstallation saffiche.

Figure 16. Fentre de fermeture de lassistant dinstallation.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

17

11. Cliquez sur Terminer pour quitter lassistant dinstallation. Le journal dinstallation, nomm TWS4APPS.LOG, est enregistr dans le rpertoire maestro.

Utilisation de linstallation automatique


Cette mthode permet dinstaller le produit sans recourir lassistant dinstallation ISMP. Pour installer via cette mthode, vous devez prparer auparavant un fichier doptions et spcifier son nom dans une commande dinstallation. La procdure dinstallation automatique vous permet dinstaller, si vous le souhaitez, toutes les mthodes daccs simultanment. Le journal dinstallation, nomm TWS4APPS.LOG, est enregistr dans le rpertoire maestro. Syntaxe : Pour installer Tivoli Workload Scheduler for Applications avec la mthode automatique, utilisez la commande suivante : v sous Windows
setup.exe -silent -options chemin_et_nom_du_fichier_options

v sous Unix
setup.bin -silent -options chemin_et_nom_du_fichier_options

Paramtres : -silent Spcifie que linstallation ne sexcute pas via une interface utilisateur, mais via un fichier doptions. -options chemin_et_nom_du_fichier_options Fournit le chemin ainsi que le nom du fichier contenant les options dinstallation. Ce fichier doptions est un fichier texte, du nom et de lextension de votre choix. Les options sont crites sparment, ligne par ligne. Un modle permettant dexcuter une installation automatique est livr avec le produit. Ce modle, appel silent.txt, se trouve dans le rpertoire RESPONSE_FILE du CD-ROM du produit. Le tableau suivant rpertorie les options disponibles pour piloter linstallation :
Tableau 3. Options requises pour la procdure dinstallation automatique. Option -P TWS4APPS.installLocation Description Chemin o vous souhaitez installer Tivoli Workload Scheduler for Applications. Cette option est obligatoire. Valeur Chemin absolu.

-P TWS4APPS.name

Nom de cette instance de Tivoli Nom, inclure entre des Workload Scheduler for guillemets sil contient un Applications. Cette option est blanc. obligatoire. Spcifie que la mthode daccs True ou False. pour Oracle eBusiness Suite doit tre installe.

-P MCMAGENT_FEATURE.active

18

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 3. Options requises pour la procdure dinstallation automatique. (suite) Option -W LJUSER_MCMAGENT_INPUT_BEAN.LJUSER Description Nom de lutilisateur de Tivoli Workload Scheduler qui doit excuter la mthode daccs pour Oracle eBusiness Suite. Cette option est obligatoire si vous installez cette mthode. Valeur Nom dutilisateur de Tivoli Workload Scheduler, inclure entre des guillemets sil contient un blanc.

-P R3BATCH_FEATURE.active -W LJUSER_R3BATCH_INPUT_BEAN.LJUSER

Spcifie que la mthode daccs True ou False. pour R/3 doit tre installe. Nom de lutilisateur de Tivoli Workload Scheduler qui doit excuter la mthode daccs pour R/3. Cette option est obligatoire si vous installez cette mthode. Nom dutilisateur de Tivoli Workload Scheduler, inclure entre des guillemets sil contient un blanc.

-P ZOSAGENT_FEATURE.active -W LJUSER_ZOSAGENT_INPUT_BEAN.LJUSER

Spcifie que la mthode daccs True ou False. pour z/OS doit tre installe. Nom de lutilisateur de Tivoli Workload Scheduler qui doit excuter la mthode daccs pour z/OS. Cette option est obligatoire si vous installez cette mthode. Nom dutilisateur de Tivoli Workload Scheduler, inclure entre des guillemets sil contient un blanc.

-P PSAGENT_FEATURE.active

Spcifie que la mthode daccs True ou False. pour PeopleSoft doit tre installe. Nom de lutilisateur de Tivoli Workload Scheduler qui doit excuter la mthode daccs pour PeopleSoft. Cette option est obligatoire si vous installez cette mthode. Nom dutilisateur de Tivoli Workload Scheduler, inclure entre des guillemets sil contient un blanc.

-W LJUSER_PSAGENT_INPUT_BEAN.LJUSER

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

19

Tableau 3. Options requises pour la procdure dinstallation automatique. (suite) Option -W LJUSER_PSAGENT_INPUT_BEAN.BEND_TYPE Description Spcifie la version de lenvironnement PeopleTools. Cette option est obligatoire si vous installez cette mthode. Valeur Il peut sagir de lun ou de plusieurs des environnements suivants : PS70MR2 PeopleTools 7.0x et Merant NetExpress 2.x PS70MR3 PeopleTools 7.0x et Merant NetExpress 3.x PS70WB4 PeopleTools 7.0x et MF COBOL Workbench 4.x PS75MR2 PeopleTools 7.5x et Merant NetExpress 2.x PS75MR3 PeopleTools 7.5x et Merant NetExpress 3.x PS81 PS84 PeopleTools 8.1x PeopleTools 8.4x

Les entres multiples doivent tre spares par des points-virgules. -W PS70MR2_CBLDIR.DIRNAME Chemin du rpertoire COBOL Chemin daccs complet pour PeopleTools 7.0x et ce rpertoire, gnralement Merant NetExpress 2.x. Utilisez <racine_PS>\cblbin. ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL Chemin daccs complet pour PeopleTools 7.0x et ce rpertoire, gnralement Merant NetExpress 3.x. Utilisez <racine_PS>\cblbin. ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL Chemin daccs complet pour PeopleTools 7.0x et ce rpertoire, gnralement MF COBOL Workbench 4.x. <racine_PS>\cblbin. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL Chemin daccs complet pour PeopleTools 7.5x et ce rpertoire, gnralement Merant NetExpress 2.x. Utilisez <racine_PS>\cblbin. ce chemin si vous avez spcifi cet environnement.

-W PS70MR3_CBLDIR.DIRNAME

-W PS70WB4_CBLDIR.DIRNAME

-W PS75MR2_CBLDIR.DIRNAME

20

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 3. Options requises pour la procdure dinstallation automatique. (suite) Option -W PS75MR3_CBLDIR.DIRNAME Description Valeur

Chemin du rpertoire COBOL Chemin daccs complet pour PeopleTools 7.5x et ce rpertoire, gnralement Merant NetExpress 3.x. Utilisez <racine_PS>\cblbin. ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire des API externes pour PeopleTools 8.1x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire client PeopleSoft pour PeopleTools 8.4x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin daccs complet ce rpertoire, gnralement <REP_API_EXT>\bin\client\ winx86_extapi. Chemin daccs complet ce rpertoire, gnralement <racine_PS>\bin\client\ winx86.

-W PS81_APIDIR.DIRNAME

-W PS84_APIDIR.DIRNAME

Exemples : Lexemple suivant utilise un fichier doptions appel silent_options.txt pour installer automatiquement Tivoli Workload Scheduler for Applications sur un ordinateur Windows :
setup.exe silent options c:\tmp\silent_options.txt

Lexemple suivant utilise un fichier doptions appel silent_options.txt pour installer automatiquement Tivoli Workload Scheduler for Applications sur une station Unix o X-Server nest pas disponible :
setup.bin silent options /tmp/silent_options.txt

Lexemple suivant est un fichier doptions utilis pour piloter linstallation de Tivoli Workload Scheduler for Applications sur un ordinateur Windows. Les mthodes daccs pour R/3 et pour PeopleSoft sont dfinies comme composants dinstallation.
# EMPLACEMENT DINSTALLATION et NOM DINSTANCE -P TWS4APPS.installLocation=C:\win32app\maestro -P TWS4APPS.name=SILENT # PARAMETRES R3BATCH -P R3BATCH_FEATURE.active=true -W LJUSER_R3BATCH_INPUT_BEAN.LJUSER=utilisateur_tws # PARAMETRES 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

Utilisation de Tivoli Configuration Manager


Il est galement possible dinstaller chaque mthode daccs en distribuant un groupe de logiciels (SPB), partir du bureau Tivoli ou de la commande winstsp du composant Software Distribution dIBM Tivoli Configuration Manager, Version 4.2. La distribution et linstallation des SPB peut seffectuer via des ordinateurs excutant Tivoli Management Framework. Le dploiement de Tivoli Workload Scheduler for Applications via un format regroup prsente les avantages suivants : v Dploiement non seulement de fichiers et de rpertoires, mais aussi dlments denvironnement, tels que fichiers INI, registres, icnes, etc.
Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

21

v Utilisation de la commande UNDO au lieu de REMOVE pour chacun des lments ci-dessus, intgrs au groupe de logiciels. v Utilisation de variables (intgres, spcifiques une cible ou prdfinies) dans le groupe de logiciels. v Utilisation de paramtres denvironnement dans le groupe de logiciels, via des sections spcifiques pour des plateformes spcifiques. v Utilisation illimite de programmes utilisateur gnriques, pour diffrentes phases dexcution, et gestion personnalise des codes retour des programmes. v Ramorage ou redmarrage un point de contrle durant lexcution des actions du groupe de logiciels. Ce format ne vous permet toutefois dinstaller quune seule mthode daccs par groupe de logiciels (SPB). Si vous utilisez plusieurs SPB pour installer dautres mthodes daccs, veillez attribuer des noms diffrents aux groupes de logiciels. Si vous choisissez de piloter le processus dinstallation partir du bureau Tivoli et que le moteur Tivoli Workload Scheduler du poste de travail cible est une version 8.2, vrifiez que vous connaissez le nom du rpertoire dinstallation du moteur avant de dmarrer. Pour tre installs par voie de distribution logicielle, tous les SPB de Tivoli Workload Scheduler for Applications requirent les options suivantes :
Tableau 4. Options requises pour installer tous les SPB de Tivoli Workload Scheduler for Applications via le module Software Distribution. Option INSTALL_DIR LJUSER Description Chemin daccs au rpertoire maestro (qui contient les mthodes). Nom de lutilisateur de Tivoli Workload Scheduler qui doit excuter la mthode daccs.

22

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

De plus, le SPB de la mthode daccs PeopleSoft requiert les options suivantes :


Tableau 5. Options supplmentaires requises pour installer la mthode daccs du SPB PeopleSoft via le module Software Distribution. Option INSTALL_BEND Description Spcifie la version de lenvironnement PeopleTools. Il peut sagir de lun ou de plusieurs des environnements suivants : PS70MR2 PeopleTools 7.0x et Merant NetExpress 2.x PS70MR3 PeopleTools 7.0x et Merant NetExpress 3.x PS70WB4 PeopleTools 7.0x et MF COBOL Workbench 4.x PS75MR2 PeopleTools 7.5x et Merant NetExpress 2.x PS75MR3 PeopleTools 7.5x and Merant NetExpress 3.x PS81 PS84 PeopleTools 8.1x PeopleTools 8.4x

Les entres multiples doivent tre spares par des points-virgules. PS70MR2_CBLDIR Chemin du rpertoire COBOL pour PeopleTools 7.0x et Merant NetExpress 2.x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL pour PeopleTools 7.0x et Merant NetExpress 3.x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL pour PeopleTools 7.0x et MF COBOL Workbench 4.x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL pour PeopleTools 7.5x et Merant NetExpress 2.x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire COBOL pour PeopleTools 7.5x et Merant NetExpress 3.x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire des API externes pour PeopleTools 8.1x. Utilisez ce chemin si vous avez spcifi cet environnement. Chemin du rpertoire client PeopleSoft pour PeopleTools 8.4x. Utilisez ce chemin si vous avez spcifi cet environnement.

PS70MR3_CBLDIR

PS70WB4_CBLDIR

PS75MR2_CBLDIR

PS75MR3_CBLDIR

PS81_APIDIR PS84_APIDIR

Le produit inclut galement un SPB contenant une machine virtuelle Java, fort utile pour installer lEditeur doptions avec cette mthode. Cette machine virtuelle Java ne peut toutefois pas remplacer celle requise pour lexcution du produit PeopleSoft. Pour installer un groupe de logiciels, vous devez excuter les actions suivantes, en utilisant soit une ligne de commande, soit le bureau Tivoli : 1. Importez le SPB dans un profil de groupe de logiciels. Procdez ainsi pour les SPB :
Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

23

v des mthodes daccs que vous voulez installer, v de la machine virtuelle Java (JVM), v de lEditeur doptions (requiert, pour lexcution, que les deux autres SPB aient t installs). 2. Installez le profil de groupe de logiciels sur les noeuds finaux grs par Tivoli Framework. Lexemple ci-dessous illustre comment installer le SPB de la mthode daccs R/3 sur un poste de travail Windows. 1. Importez le fichier SBP TWS4APPS_R3BATCH_I386NT.SPB dans un profil de groupe de logiciels de Tivoli Framework appel, par exemple, TWS4APPS_R3BATCH_I386NT.8.2. Utilisez la commande suivante :
wimpspo -c PROFILE_MANAGER -f <CHEMIN_SOURCE>/TWS4APPS_R3BATCH_I386NT.SPB -t build -p <CHEMIN_DEST_LOCAL>/TWS4APPS_R3BATCH_I386NT.SPB TWS4APPS_R3BATCH_I386NT.8.2

Dans cet exemple, le fichier CHEMIN_SOURCE/TWS4APPS_R3BATCH_I386NT.SPB est import dans un profil de groupe de logiciels appel TWS4APPS_R3BATCH_I386NT.8.2, lequel appartient un gestionnaire de profil PROFILE_MANAGER de Tivoli Framework. TWS4APPS_R3BATCH_I386NT.8.2 doit faire rfrence au fichier <CHEMIN_DEST_LOCAL>/TWS4APPS_R3BATCH_I386NT.SPB en tant que fichier local contenant les informations requises. Remarque : Pour installer une instance supplmentaire de ce SPB sur le mme poste de travail, vous devez renommer le SPB. 2. Installez le profil de groupe de logiciels TWS4APPS_R3BATCH_I386NT.8.2 sur un ordinateur ayant pour nom dhte epw2000 (qui doit galement tre dfini comme noeud final de Tivoli Framework). Utilisez la commande suivante :
winstsp -D INSTALL_DIR=racine_TWS -D LJUser=utilisateur_TWS TWS4APPS_R3BATCH_I386NT.8.2 epw2000

Lorsque le journal dinstallation, dans ce cas, un fichier nomm $BINDIR/../swdis/work/TWS4APPS_R3BATCH_I386NT.log, affiche le message Opration russie, le processus dinstallation peut tre considr comme termin. Lexemple ci-dessous illustre comment installer le SPB de la machine virtuelle Java pour AIX sur un systme AIX. Notez quil existe un groupe de logiciels JVM diffrent pour chaque plateforme. 1. Importez le groupe de logiciels ayant pour nom JRE131_AIX.SPB dans un profil de groupe de logiciels appel JRE131AIX.8.2. Utilisez la commande suivante :
wimpspo -c PROFILE_MANAGER -f <CHEMIN_SOURCE>/JRE131_AIX.SPB -t build -p <CHEMIN_DEST_LOCAL>/JRE131_AIX.SPB JRE131AIX.8.2

2. Installez le profil de groupe de logiciels JRE131AIX.8.2 sur un ordinateur ayant pour nom dhte epAIX. Utilisez la commande suivante :
winstsp -D INSTALL_DIR=racine_TWS -D LJUser=utilisateur_TWS JRE131AIX.8.2 epAIX

Lexemple suivant illustre comment installer le SPB de lEditeur doptions sur le mme systme AIX. Notez que le SPB de lEditeur doptions est le mme pour toutes les plateformes. 1. Importez le groupe de logiciels ayant pour nom OPTED.SPB dans un profil de groupe de logiciels appel OPTED.8.2. Utilisez la commande suivante :

24

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

wimpspo -c PROFILE_MANAGER -f <CHEMIN_SOURCE>/OPTED.SPB -t build -p <CHEMIN_DEST_LOCAL>/OPTED.SPB OPTED.8.2

2. Installez le profil de groupe de logiciels OPTED.8.2 sur un ordinateur ayant pour nom dhte epAIX. Utilisez la commande suivante :
winstsp -D INSTALL_DIR=racine_TWS -D LJUser=utilisateur_TWS OPTED.8.2 epAIX

Dsinstallation du produit
Pour dsinstaller Tivoli Workload Scheduler for Applications dun poste de travail, vous devez suivre la mme procdure que celle que vous avez utilise lors de linstallation : v Si vous avez utilis lassistant dinstallation ISMP, vous devez utiliser une mthode compatible ISMP pour la dsinstallation. v Si vous avez procd linstallation par voie de distribution logicielle, vous devez dsinstaller par la mme mthode. Si vous envisagez de dsinstaller la mthode daccs pour Oracle eBusiness suite, notez que vous devrez achever manuellement le retrait du produit. Reportez-vous la section Suppression manuelle des lments restants lors du retrait de la mthode daccs pour Oracle e-Business Suite la page 26. Dans certains cas, lorsque vous dsinstallez compltement le produit, le processus de dsinstallation peut laisser un rpertoire nomm _xauninst. Si tel est le cas, supprimez ce dernier manuellement.

Suppression dune installation via ISMP


Pour dsinstaller le produit suite une installation effectue via ISMP : v Sous Windows : 1. Slectionnez Ajout/Suppression de programmes dans le Panneau de configuration. 2. Recherchez IBM Tivoli Workload Scheduler for Applications (nom dutilisateur). 3. Cliquez sur Supprimer. Une fentre de dsinstallation souvre, vous proposant de supprimer le produit dans son intgralit, ou une ou plusieurs mthodes daccs qui avaient t installes en tant que fonction(s) du produit. v Sous Unix : 1. Accdez au rpertoire <racine_TWS>/methods. 2. Lancez la commande suivante :
../_xauninst/uninstaller

Une fentre de dsinstallation souvre, vous proposant de supprimer le produit dans son intgralit, ou une ou plusieurs mthodes daccs qui avaient t installes en tant que fonction(s) du produit.

Suppression dune installation via Tivoli Configuration Manager


Pour supprimer le produit suite une installation effectue par distribution de logiciels, utilisez le bureau Tivoli ou la commande wremovsp.

Chapitre 2. Installation dIBM Tivoli Workload Scheduler for Applications

25

Pour consulter la liste des groupes de logiciels installs sur lordinateur suite distribution, utilisez lune ou lautre des procdures suivantes : v Utilisez Tivoli Inventory, inclus dans la version 4.2 de Tivoli Configuration Manager, pour excuter la requte CM_STATUS_QUERY et rpertorier les mthodes daccs installes sur les postes de travail. Reportez-vous la documentation de Tivoli Inventory pour plus de dtails. v Affichez les fichiers journaux gnrs par Software Distribution sur lordinateur. Chaque groupe de logiciels distribu a son propre fichier journal, cest--dire un fichier texte qui enregistre lhistorique dinstallation et de dsinstallation de ce groupe. Par exemple, le fichier journal du groupe de logiciels de la mthode daccs R/3 sur un systme AIX, savoir r3batch_tws_aix.log, est enregistr dans le rpertoire $BINDIR/../swdis/work (o $BINDIR reprsente une variable denvironnement de Tivoli Framework qui est initialise via la commande /etc/Tivoli/setup_env.sh). Reportez-vous la documentation de Tivoli Software Distribution pour plus de dtails.

Suppression manuelle des lments restants lors du retrait de la mthode daccs pour Oracle e-Business Suite
Une fois le processus de dsinstallation termin, excutez les tapes suivantes : 1. Restaurez le contenu original dAPPLSYS.env en supprimant la chane MCM des variables APPLSHAR et APPLFUL. Par exemple :
APPLSHAR=ALR FF MCM

doit devenir
APPLSHAR=ALR FF

2. Supprimez les fichiers suivants : v <racine_TWS>/methods/MCMAGENT v v v v <racine_TWS>/catalog/C/mcm.cat MCMLJ, MCMSTAT et MCMTJ situs dans le rpertoire $MCM_TOP/bin MCMprod.txt situ dans le rpertoire $APPL_TOP/admin Tous les fichiers doptions

26

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 3. Dfinition des options laide de lEditeur doptions


Un fichier doptions est un fichier texte contenant un ensemble doptions de configuration requises pour excuter un agent tendu. Ces options sont crites raison dune par ligne et se prsentent sous le format suivant :
OPTION=VALEUR

sans espace autour des mots cls ou entre les mots cls. Les options sont utilises pour modifier les proprits dexcution de la mthode daccs, telles que le mot de passe requis pour se connecter un systme externe (par exemple, SAP R/3) ou le nom de connexion. Toutes les mthodes daccs utilisent deux types de fichiers doptions, savoir : Fichier doptions globales Il sagit dun fichier de configuration commun, propre une instance particulire dune mthode daccs, dont les paramtres affectent tous les postes de travail dagent tendu dfinis dans cette instance. Ce fichier contient des options qui sont, en partie, entres au moment de linstallation, par exemple : LJuser (qui fournit le nom de lutilisateur qui excute la mthode daccs) ou IFuser (qui fournit le nom de lutilisateur qui excute la mthode pour extraire les informations relatives aux travail). Le nom de ce fichier est <nom_mthode_accs>.opts. Par exemple, pour une installation de la mthode daccs R/3, le nom du fichier doptions globales est r3batch.opts. Fichier doptions locales Il sagit dun fichier de configuration, spcifique chaque poste de travail dagent tendu au sein dune instance particulire dune mthode daccs. Chaque poste de travail dagent tendu (sauf pour z/OS) doit avoir un fichier doptions locales avec ses propres options de configuration. Le nom de ce fichier est Nom du poste de travail_<nom_mthode_accs>.opts. Par exemple, si une installation de la mthode daccs R/3 comporte deux postes de travail dagent tendu, CPU1 et CPU2, les noms des fichiers doptions locales seront respectivement CPU1_r3batch.opts et CPU2_r3batch.opts. Les fichiers doivent rsider dans le sous-rpertoire methods dinstallation de Tivoli Workload Scheduler et sont lus lorsque lagent tendu est initialis. Les options sont spcifiques chaque mthode daccs. Pour connatre les options de chaque mthode daccs, reportez-vous aux chapitres suivants : v Chapitre 8, Informations de rfrence sur le fichier doptions MCMAGENT, la page 53 pour Oracle, v Chapitre 11, Tches post-installation, la page 65 pour PeopleSoft, v Chapitre 20, Fichiers doptions de la mthode daccs R/3, la page 119 pour R/3, v Chapitre 25, Configuration et fonctionnement, la page 151 pour z/OS.

Copyright IBM Corp. 2000, 2003

27

Vous pouvez crire les fichiers doptions laide dun diteur de texte de votre choix ou les crer avec lEditeur doptions fourni avec le produit. Avant de terminer linstallation, Tivoli Workload Scheduler for Applications vous propose de dmarrer lEditeur doptions pour vous permettre de dfinir des options locales, alors que certaines valeurs que vous avez entres durant le processus sont utilises pour crer un fichier doptions globales. Pour dmarrer lEditeur doptions tout autre moment, accdez au sous-rpertoire methods de votre installation Tivoli Workload Scheduler et excutez la commande (Windows) opted.exe ou (Unix) opted.bin. Si vous avez install le produit via Tivoli Configuration Manager, lancez lEditeur doptions laide de lune de ces commandes : v racine_TWS\methods\opted\opted.bat sous Windows, v racine_TWS/methods/opted/opted.sh sous Unix. LEditeur doptions charge automatiquement tous les fichiers doptions globales et locales existants. Vous pouvez ainsi modifier les fichiers existants et crer des fichiers doptions locales pour les postes de travail dagent tendu nouvellement dfinis. LEditeur doptions fournit trois vues possibles dun fichier doptions : Simple Affiche les options sous forme de squence donglets, vous permettant de modifier une option la fois. Pour afficher ou modifier une option, slectionnez longlet portant le nom de loption pour afficher la zone de la valeur. Il sagit de la mthode la plus aise pour modifier les options, puisque vous ne voyez que la valeur relle qui sera utilise dans le fichier. Les valeurs hrites et les valeurs par dfaut ne sont pas affiches. Les options obligatoires apparaissent en jaune et sont caractrises par un astrisque (*). Table Fournit une vue en forme de tableau de toutes les options dun fichier slectionn. Pour chaque option, les colonnes suivantes sont affiches : Valeur Valeur spcifie dans le fichier. Valeur par dfaut Valeur utilise par la mthode si aucune autre valeur nest disponible. Valeur hrite Valeur provenant du fichier doptions globales, si lhritage est pris en charge par la mthode. Valeur relle Valeur rellement utilise lors de lexcution. Lordre dutilisation est le suivant : valeur, si disponible ; valeur hrite, si prise en charge ; valeur par dfaut. Les options obligatoires sont affiches sur fond jaune. Texte Affiche les fichiers doptions dans un format classique, ne prsentant que les options ayant une valeur. Cette vue est gnralement utilise des fins de prvisualisation, car les fichiers sont affichs en mode Lecture seule. Les zones relatives aux mots de passe apparaissent sous forme code.

28

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

La fentre de lEditeur doptions se compose de trois zones principales, comme illustr la figure 17, savoir : Arborescence des fichiers doptions Affiche la liste de tous les fichiers doptions existants, regroups par mthode. Descripteur doptions Donne une description de la slection en cours. Vue du fichier doptions Affiche les options dun fichier slectionn dans lune des trois vues disponibles.

Figure 17. Editeur doptions

Vrifiez que lEditeur doptions nest pas en cours dexcution avant dajouter ou de mettre jour des paramtres ou des instances dune installation existante de Tivoli Workload Scheduler for Applications. Vous devez restreindre laccs au fichier excutable de lEditeur doptions. Dans le cas de multiples installations dun agent tendu, vous pouvez amliorer la scurit en ne conservant quune seule copie de lEditeur doptions (sur le poste de travail principal, par exemple). Grce FTP, vous pouvez grer tous les fichiers doptions chiffrs partir dun mme emplacement.

Chapitre 3. Dfinition des options laide de lEditeur doptions

29

Cration dun fichier doptions locales


Alors que les fichiers doptions globales sont gnrs automatiquement chaque installation dune instance de mthode daccs, vous pouvez crer des fichiers doptions locales tout moment, avant ou aprs avoir dfini un poste de travail dagent tendu. Pour crer un fichier doptions locales avec lEditeur doptions : 1. Cliquez sur FichierNouveau dans la barre de menus. La fentre Nouveau fichier doptions saffiche. 2. Entrez le nom dun poste de travail dagent tendu que vous venez de dfinir ou envisagez de dfinir. 3. Slectionnez une mthode daccs parmi celles proposes dans le menu droulant. Le nouveau fichier doptions aura pour nom : <nom_poste_de_travail_agent_tendu>_<nom_mthode>.opts. 4. Commencez entrer les valeurs des options.

Hritage des valeurs des options


Cette proprit nest actuellement disponible que pour r3batch. Elle permet aux fichiers doptions locales de pouvoir hriter, pour des options identiques, des valeurs existant dans le fichier doptions globales (r3batch.opts). En fait, pour une mme mthode daccs, les options sont listes deux fois : une fois en tant que globale, une autre fois en tant que locale. Si loption locale na pas de valeur propre, celle de loption globale est utilise. A linverse, si elle existe, la valeur de loption locale prvaut toujours sur la valeur globale. Par exemple, vous pouvez vouloir dfinir les mmes utilisateur et mot de passe R/3 pour tous vos systmes R/3. Grce cette proprit, au lieu dcrire les mmes valeurs dans chaque fichier doptions locales, il vous suffit de les entrer une fois dans le fichier doptions globales.

30

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 4. Dfinition des postes de travail dagent tendu


Une dfinition de poste de travail dagent tendu est requise pour chaque entit de mthode daccs utilise par Tivoli Workload Scheduler pour planifier et lancer des travaux. Les postes de travail dagent tendu sont dfinis de manire standard et incluent le nom de lhte de lagent tendu ainsi que le nom de la mthode. Pour lancer un travail sur un poste de travail dagent tendu, Tivoli Workload Scheduler excute la mthode daccs et transmet les informations relatives au travail. La mthode daccs communique avec linstance du systme considr (z/OS, R/3, PeopleSoft ou Oracle) et contrle le travail tout au long de son excution, consignant la progression de celui-ci et les informations dtat dans le fichier stdlist du travail.

Cration dun poste de travail avec Job Scheduling Console


Pour dfinir un poste de travail dagent tendu avec Job Scheduling Console, suivez les tapes ci-aprs : 1. Dans la fentre principale, slectionnez licne Nouveau poste de travail dans la barre doutils suprieure ou cliquez avec le bouton droit de la souris sur le nom du moteur Tivoli Workload Scheduler, puis slectionnez Nouveau poste de travail dans le menu droulant. La fentre Proprits - Poste de travail dans la base de donnes saffiche.

Figure 18. Dfinition dun poste de travail avec Job Scheduling Console

2. Compltez les zones en vous aidant des informations donnes dans le tableau 6 la page 32. 3. Cliquez sur OK pour enregistrer et fermer la fentre.

Copyright IBM Corp. 2000, 2003

31

Le tableau ci-aprs indique comment complter les zones de la fentre des proprits du poste de travail en fonction du poste de travail dagent tendu que vous voulez dfinir.
Tableau 6. Comment complter les zones de la fentre Proprits - Poste de travail dans la base de donnes Zone PeopleSoft Nom Description par mthode daccs z/OS Oracle eBusiness Suite R/3

Nom du poste de travail dagent tendu. Pour toutes les mthodes daccs (sauf pour la mthode z/OS pour laquelle il est toujours limit 8 caractres), le nom peut contenir jusqu 8 ou 16 caractres alphanumriques, en fonction des bases de donnes (tendues ou non tendues) que vous utilisez. Il peut contenir des tirets et des traits de soulignement, mais il doit commencer par une lettre. Pour toutes les mthodes daccs, ce nom doit tre cohrent avec celui du fichier doptions associ au poste de travail, cest--dire que, si le fichier doptions (que vous avez normalement cr avec lditeur doptions) sappelle <ma_cpu>_<ma_mthode>.opts, alors ma_cpu et le paramtre Nom doivent tre identiques.

Noeud

Non dfini.

Nom du noeud ou Non dfini. adresse IP du systme z/OS. Seuls les noms de domaine complets sont accepts. Adresse TCP (numro Tout nombre autre que de port) de la 0. passerelle z/OS dans le systme z/OS. Entrez la mme valeur que la variable SYSTSIN PORT dcrite dans le tableau 21 la page 146. Slectionnez AUTRE.

Non dfini.

Port TCP

Tout nombre autre que 0.

Tout nombre autre que 0.

Systme dexploitation Domaine

Nom du domaine Tivoli Workload Scheduler du poste de travail hte. Si vous avez besoin daide pour le trouver, cliquez sur les points de suspension (...) pour afficher la liste des domaines existants. Cliquez sur Utiliser le matre si vous savez que le poste de travail hte se situe dans le mme domaine que le gestionnaire de domaine principal. Si le rseau Tivoli Workload Scheduler utilise loption Fuseau horaire, slectionnez le fuseau appropri dans la liste droulante. Si ce nest pas le cas, laissez cette zone vide. Description textuelle facultative, format libre, du poste de travail (40 caractres maximum). Non utilis sur les postes de travail dagent tendu. Non utilis sur les postes de travail dagent tendu. Non utilis sur les postes de travail dagent tendu. Slectionnez Agent tendu. Non utilis sur les postes de travail dagent tendu. Slectionnez cette option uniquement si vous souhaitez que Tivoli Workload Scheduler ignore cette dfinition de poste de travail. Cette option permet de prdfinir les flux de travaux, les travaux et les objets dun systme qui nest pas encore oprationnel. Non utilis sur les postes de travail dagent tendu.

Fuseau horaire Description Communication SSL Pare-feu Port scuris Type de poste de travail Liaison automatique Ignorer

Statut intgral

32

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 6. Comment complter les zones de la fentre Proprits - Poste de travail dans la base de donnes (suite) Zone PeopleSoft Rsolution des dpendances Serveur Mthode daccs psagent Description par mthode daccs z/OS Oracle eBusiness Suite R/3

Non utilis sur les postes de travail dagent tendu. Non utilis sur les postes de travail dagent tendu. Lune des mthodes suivantes, en fonction de votre interface de planification des travaux : mvsca7 Pour lancer et contrler les travaux z/OS via CA-7. mvsjes Pour lancer et contrler les travaux z/OS via JES2 ou JES3. mvsopc Pour lancer et contrler les travaux z/OS via OPC ou Tivoli Workload Scheduler pour z/OS. Remarque : Le nom est sensible la casse sous UNIX (il doit tre en minuscules). MCMAGENT Remarque : Le nom est sensible la casse sous UNIX (il doit tre en minuscules). r3batch Remarque : Le nom est sensible la casse sous UNIX (il doit tre en minuscules).

Hte

Nom Tivoli Workload Scheduler du systme hte. Il sagit de lagent tolrant aux pannes ou de lagent standard Tivoli Workload Scheduler sur lequel lagent tendu est install. Cliquez sur les points de suspension (...) pour afficher la liste des htes existants.

Cration dun poste de travail partir de la ligne de commande


Les dfinitions de postes de travail dagent tendu peuvent galement tre cres partir de la ligne de commande de Tivoli Workload Scheduler via le programme Composer. Lexemple suivant illustre une dfinition de poste de travail dagent tendu z/OS, appel MVSCPU, qui utilise la mthode daccs mvsjes.
cpuname MVSCPU description "agent tendu zOS" os other node mvsesa36.rome.tivoli.com tcpaddr 5000 domain masterdm for maestro

Chapitre 4. Dfinition des postes de travail dagent tendu

33

type x-agent host ROCIOUS access mvsjes end

Consultez le manuel IBM Tivoli Workload Scheduler - Guide de rfrence pour plus de dtails sur la dfinition des postes de travail avec Composer.

Dfinition de postes de travail pour une planification de bout en bout


Planifier dans un environnement de bout en bout signifie que, dans Tivoli Workload Scheduler pour z/OS, vous planifiez et contrlez des travaux qui sexcutent physiquement sur des postes de travail Tivoli Workload Scheduler. Pour ce faire, les postes de travail dagent tendu doivent tre dfinis en tant que postes de travail tolrants aux pannes dans Tivoli Workload Scheduler pour z/OS. Un poste de travail tolrant aux pannes correspond la dfinition Tivoli Workload Scheduler pour z/OS dun agent Tivoli Workload Scheduler existant dans le rseau rparti. Lagent Tivoli Workload Scheduler se trouve l o le travail associ au poste de travail tolrant aux pannes sera rellement excut dans le rseau rparti. Pour dfinir un poste de travail dagent tendu dans Tivoli Workload Scheduler pour z/OS, vous devez : 1. Dfinir le poste de travail dans linstruction dinitialisation CPUREC. 2. Ajouter la mme dfinition de poste de travail la base de donnes, via ISPF ou Job Scheduling Console. Pour plus de dtails sur la procdure suivre pour dfinir un poste de travail laide de Job Scheduling Console, consultez le manuel Tivoli Job Scheduling Console - Guide dutilisation.

Cration de linstruction CPUREC


Commencez par crer linstruction CPUREC pour le poste de travail dans linstruction dinitialisation TOPOLOGY. Cette dernire est utilise pour dfinir les paramtres relatifs la topologie du rseau Tivoli Workload Scheduler connect. Une telle topologie est compose dune ou plusieurs instructions DOMREC (une pour chaque domaine) qui dcrivent la topologie du rseau rparti et de plusieurs instructions CPUREC (une pour chaque poste de travail tolrant aux pannes). Lexemple ci-aprs illustre une instruction CPUREC pour un poste de travail dagent tendu R/3 du nom de R3XA. Lagent tendu est hberg par un agent Tivoli Workload Scheduler appel TWSA, qui est galement le gestionnaire de domaine de DOMAINE1.
**************** MEMBRE TPLGINFO *************************** /*********************************************************************/ /* DOMREC : Dfinition du domaine */ /*********************************************************************/ DOMREC DOMAIN(DOMAINE1) DOMMNGR(TWSA) DOMPARENT(MAITREDM) /*********************************************************************/ /* CPUREC : Dfinition du poste de travail dagent tendu */ /*********************************************************************/ CPUREC CPUNAME(R3XA) CPUOS(OTHER) CPUNODE(NOEUD1) CPUDOMAIN(DOMAINE1) CPUHOST(TWSA)

34

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

CPUTYPE(XAGENT) CPUACCESS(r3batch) CPUUSER(utilisateur_TWS) CPUTZ(Europe/Rome) /*********************************************************************/ /* CPUREC : Dfinition du poste de travail gestionnaire de domaine */ /*********************************************************************/ CPUREC CPUNAME(TWSA) CPUNODE(NOEUD1) CPUAUTOLINK(ON) CPUDOMAIN(DOMAINE1) CPUTYPE(FTA) CPUUSER(utilisateur_TWS) CPUTZ(Europe/Rome)

Les mots cls suivants dfinissent R3XA comme agent tendu : CPUACCESS Mthode daccs associe lagent tendu. Pour R/3, il sagit de r3batch. CPUHOST Nom du poste de travail Tivoli Workload Scheduler hbergeant lagent tendu. Il ne peut pas sagir dun autre agent standard ou tendu. CPUTYPE Type de poste de travail, savoir XAGENT pour un agent tendu. Pour plus dinformations sur CPUREC, consultez le manuel Tivoli Workload Scheduler for z/OS Customization and Tuning.

Dfinition dun poste de travail avec ISPF


La figure 19 la page 36 illustre une dfinition ISPF pour R3XA. Dans ISPF (ou dans Job Scheduling Console), dfinissez le poste de travail comme Ordinateur Automatique, puis entrez Y dans la zone FT Work station. Cest linstruction CPUREC avec les trois mots cls dcrits dans la section prcdente qui fournit la spcification de lagent tendu.

Chapitre 4. Dfinition des postes de travail dagent tendu

35

Remarque : Veillez crire linstruction CPUREC avant de crer la dfinition ISPF ou Job Scheduling Console, car ni lun, ni lautre na deffet sans linstruction CPUREC.
-------------CREATION DINFORMATIONS GENERALES SUR UN POSTE DE TRAVAIL -------------Commande ===> Entrez la commande R pour ressources, A pour disponibilit ou M pour mthode daccs ci-dessus, ou entrez les donnes ci-dessous : WORK STATION NAME DESCRIPTION WORK STATION TYPE REPORTING ATTR FT Work station PRINTOUT ROUTING SERVER USAGE ===> ===> ===> ===> R3XA Agent tendu pour mthode daccs R/3____________________ C G Gnral, C Ordinateur, P Imprimante A A Automatique, S Dmarrage et excution manuels C Excution uniquement, N Pas de gnration dtats ===> Y Poste de travail FT, Y ou N ===> SYSPRINT Nom de domaine de lensemble des donnes du plan quotidien ===> N Utilisation des serveurs parallles C , P , B ou N

Options : SPLITTABLE ===> N Interruption dopration autorise, Y ou N JOB SETUP ===> N Modification de JCL autorise, Y ou N STARTED TASK, STC ===> N Support des tches en cours, Y ou N WTO ===> N WTO automatique, Y ou N DESTINATION ===> ________ Nom de la cible Valeurs par dfaut : TRANSPORT TIME ===> 00.00 Dlai partir du poste de travail prcdent DURATION ===> ________ Dure dune opration normale HH.MM.SS

HH.MM

Figure 19. Dfinition dun poste de travail dagent tendu

36

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 5. Dfinition des travaux dagent tendu


Ce chapitre explique comment dfinir les travaux Tivoli Workload Scheduler associs aux travaux externes que vous voulez excuter via des agents tendus. Pour excuter et contrler un travail PeopleSoft, R/3, Oracle ou z/OS avec Tivoli Workload Scheduler, lagent tendu (ou la mthode daccs) requiert une dfinition de travail Tivoli Workload Scheduler, o vous spcifiez le travail externe que vous envisagez de planifier, le poste de travail (galement dfini dans Tivoli Workload Scheduler) sur lequel il est supposer sexcuter ainsi que les actions de rcupration souhaites. Pour dfinir le travail, vous pouvez utiliser : v Tivoli Job Scheduling Console, v la ligne de commande Tivoli Workload Scheduler. Si vous planifiez dans un environnement de bout en bout, vous devez utiliser les botes de dialogue ISPF de Tivoli Workload Scheduler pour z/OS pour dfinir le travail. De plus, vous devez crer un membre dans le fichier SCRIPTLIB avec une instruction JOBREC pour le travail. Les travaux dagent tendu sont ajouts aux flux de travaux et planifis comme tout autre travail dans Tivoli Workload Scheduler et Tivoli Workload Scheduler pour z/OS.

Dfinition des travaux avec Job Scheduling Console


Les tapes dcrites ici pour dfinir un travail dagent tendu sont communes toutes les mthodes daccs. En outre, la mthode daccs pour R/3 propose des fonctions supplmentaires, si vous utilisez la procdure de substitution dcrite la section Utilisation des fentres SAP de Job Scheduling Console la page 102. Pour toutes les mthodes daccs, suivez les tapes ci-aprs : 1. Dans la liste Actions de la fentre principale de Job Scheduling Console, slectionnez Nouvelle dfinition de travail. 2. Slectionnez un moteur Tivoli Workload Scheduler et, dans la liste affiche, cliquez sur Tche dagent tendu. La page Gnral de la fentre Proprits Dfinition du travail saffiche.

Copyright IBM Corp. 2000, 2003

37

Figure 20. Page Gnral de la fentre Proprits - Dfinition du travail.

3. Cette page vous permet de fournir des informations sur le travail Tivoli Workload Scheduler qui grera le travail externe. Compltez les zones de cette fentre laide de la table suivante.
Tableau 7. Page Gnral de la fentre Proprits - Dfinition du travail (Description des zones). Zone Type de tche Nom Description Zone en lecture seule devant afficher Tche dagent tendu. Nom du travail Tivoli Workload Scheduler que vous dfinissez. Ce travail est destin grer le travail de lapplication externe dont vous spcifierez le nom dans la prochaine page de cette fentre. Le nom peut contenir jusqu 8 caractres alphanumriques si la base de donnes nest pas tendue, ou 40, si elle est tendue. Il peut inclure des tirets et des caractres de soulignement, mais doit dbuter par une lettre. Les espaces imbriqus ne sont pas autoriss. Il peut tre identique au nom du travail externe, dans la mesure o celui-ci est valide dans Tivoli Workload Scheduler. Nom du poste de travail dagent tendu sur lequel le travail est cens sexcuter. Vous pouvez cliquer sur les points de suspension (...) pour afficher une fentre de recherche et slectionner un poste de travail disponible. Description du travail ne devant pas excder 64 caractres alphanumriques. Cette zone est facultative.

Poste de travail

Description

38

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 7. Page Gnral de la fentre Proprits - Dfinition du travail (Description des zones). (suite) Zone Connexion Description Nom dutilisateur ncessaire lexcution du travail dans Tivoli Workload Scheduler. Normalement, il sagit de la valeur du paramtre LJuser, spcifie lors de linstallation de Tivoli Workload Scheduler for Applications, qui se trouve dans le fichier doptions de la mthode. Ce doit tre un utilisateur valide sur le poste de travail hte Tivoli Workload Scheduler, qui doit galement pouvoir accder au produit externe. Ce paramtre est requis pour planifier le travail dans Tivoli Workload Scheduler, o il apparat dans diffrents crans. Si ncessaire, cliquez sur Ajouter un paramtre pour ajouter des paramtres prdfinis lID de connexion. Options de rcupration Rponse automatique de Tivoli Workload Scheduler si le travail sarrte de manire anormale. La valeur par dfaut est Arrter. Pour plus dinformations sur les options de rcupration, reportez-vous au manuel Tivoli Workload Scheduler - Guide de rfrence. Message facultatif devant apparatre lorsque le travail sarrte de manire anormale. Aucun message prdfini nest accept ici. Nom du travail de rcupration devant dmarrer automatiquement lorsque le travail sarrte de manire anormale. Cliquez sur les points de suspension (...) pour afficher une fentre de recherche et rpertorier les travaux existants. Nom du poste de travail propritaire du travail de rcupration.

Message Travail

Poste de travail

4. Cliquez sur Tche pour accder la page suivante. La page Tche de la fentre apparat.

Figure 21. Page Tche de la fentre Proprits - Dfinition du travail.

5. Cette page vous permet de fournir des informations sur le travail (ou tche) externe qui sera gr par le travail dfini la page prcdente. Notez que la
Chapitre 5. Dfinition des travaux dagent tendu

39

tche doit dj avoir t dfinie dans lapplication externe. Compltez les zones de cette fentre laide de la table suivante.
Tableau 8. Page Tches de la fentre Proprits - Dfinition du travail (Description des zones). Zone Type de tche Commande Description Zone en lecture seule devant afficher Tche dagent tendu. Spcifications du travail externe (tche). Chaque application externe utilise un jeu de paramtres diffrents : v Pour les travaux Oracle Applications, reportez-vous la section Paramtres de chane de tches pour les travaux Oracle Applications la page 49. v Pour les travaux PeopleSoft, reportez-vous la section Paramtres des chanes de tches des travaux PeopleSoft la page 77. v Pour les travaux R/3, reportez-vous la section Paramtres de chane de tches pour les travaux R/3 la page 109. v Pour les travaux z/OS, reportez-vous la section Syntaxe de dfinition de tche pour les travaux z/OS planifis avec Tivoli Workload Scheduler la page 153. Ecrivez les paramtres dans une chane se prsentant sous le format suivant : -paramtre1 valeur1 -paramtre2 valeur2...-paramtren valeurn Cliquez sur Ajouter un paramtre... pour afficher une fentre de recherche de paramtres o vous pouvez rpertorier et ajouter des paramtres Tivoli Workload Scheduler prdfinis la zone Commande. Expression du mappage Expression logique dfinissant les codes retour qui indiquent la de code retour russite de la tche. Vous pouvez utiliser des oprateurs de comparaison et des oprateurs logiques. Par exemple, lexpression RC6 indique quun code retour suprieur ou gal 6 signifie que la tche a t excute avec succs.

6. Cliquez sur OK pour enregistrer la dfinition du travail.

Dfinition des travaux partir de la ligne de commande Tivoli Workload Scheduler


Il est galement possible de dfinir les travaux dans une ligne de commande Composer de Tivoli Workload Scheduler. Lexemple suivant illustre un travail Tivoli Workload Scheduler appel orajob2 qui sexcute sur un poste de travail dagent tendu Oracle Applications appel ora002. Il se connecte UNIX en tant que orajobs et lance un travail sous Oracle Applications. Le travail Oracle Applications est appel poxacr et son propritaire est global. En cas dincident, Tivoli Workload Scheduler excutera le travail de rcupration recov2, puis continuera le traitement.
ora002#orajob2 streamlogon orajobs scriptname "-user global -job fnd application developer po poxacr

40

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

-prn ps4 2 -v1 abc" description "oracle apps job #2" recovery continue after recov2

Notez que les arguments de scriptname diffrent dune application lautre. Pour rfrence, reportez-vous aux sections : v Paramtres de chane de tches pour les travaux Oracle Applications la page 49. v Paramtres des chanes de tches des travaux PeopleSoft la page 77. v Paramtres de chane de tches pour les travaux R/3 la page 109. v Syntaxe de dfinition de tche pour les travaux z/OS planifis avec Tivoli Workload Scheduler la page 153. Pour plus dinformations sur la dfinition des travaux via une ligne de commande, reportez-vous au manuel Tivoli Workload Scheduler - Guide de rfrence.

Dfinition des travaux pour une planification de bout en bout


Les travaux dagent tendu planifis pour sexcuter dans un environnement de bout en bout ne peuvent pas tre dfinis via une ligne de commande Job Scheduling Console ou Tivoli Workload Scheduler. Ils doivent tre ajouts au fichier SCRIPTLIB de Tivoli Workload Scheduler pour z/OS. Dans lcran ISPF OPERATIONS de Tivoli Workload Scheduler pour z/OS, les travaux dagent tendu sont dfinis comme tout autre travail, mais le choix dun poste de travail dagent tendu rvle leur type. Lexemple suivant illustre la dfinition dun travail appel SAPJOB. Il sagit du travail Tivoli Workload Scheduler pour z/OS destin grer lexcution dun travail R/3 (appel BAPRINT46B comme vous le verrez dans lexemple suivant). Il savre tre un travail dagent tendu, uniquement parce que le poste de travail associ est un poste de travail dagent tendu appel R3XA.
--------------------------------- OPERATIONS -----------------Row 1 to 1 of 1 Command ===> Scroll ===> PAGE Enter/Change data in the rows, and/or enter any of the following row commands: I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete S - Select operation details, J - Edit JCL Enter the TEXT command above to include operation text in this list, or, enter the GRAPH command to view the list graphically. Application : APLL1 FTW appl

Row Oper Duration Job name Internal predecessors Morepreds cmd ws no. HH.MM.SS -IntExt R3XA 001 00.00.01 SAPJOB___ ___ ___ ___ ___ ___ ___ ___ ___ 0 0 ******************************* Bottom of data ********************************

Figure 22. Dfinition dun travail dagent tendu dans le cadre dune planification de bout en bout.

Pour chaque travail, un membre doit tre cr dans le fichier SCRIPTLIB de Tivoli Workload Scheduler pour z/OS, les dtails relatifs au travail tant spcifis dans une instruction JOBREC. Un membre SAPJOB a t cr pour le travail de lexemple prcdent, avec une instruction JOBREC se prsentant comme suit :
JOBREC JOBCMD(/-job BAPRINT46B -user MAESTRO -i 14160001 -c C) JOBUSR(twsila)
Chapitre 5. Dfinition des travaux dagent tendu

41

La chane incluse dans JOBCMD est lue et interprte par la mthode daccs, pralablement lexcution du travail. Le travail de cet exemple, BAPRINT46B, a t prcdemment dfini dans R/3 et associ lID 14160001, manuellement transcrit dans JOBCMD. Lexemple suivant concerne un travail PeopleSoft. Notez que la chane qui suit le mot cl JOBCMD doit figurer entre des guillemets doubles plutt quentre des guillemets simples. Ceci ne sapplique que dans le cas de travaux PeopleSoft complexes, o des guillemets simples sont dj utiliss dans la chane.
JOBREC JOBCMD("/-operator PS -process XRFWIN -type SQR Report -runcontrol TWS") JOBUSR(PsBuild)

Les arguments de JOBCMD diffrent dune application lautre. Pour rfrence, reportez-vous aux sections : v Paramtres de chane de tches pour les travaux Oracle Applications la page 49. v Paramtres des chanes de tches des travaux PeopleSoft la page 77. v Paramtres de chane de tches pour les travaux R/3 la page 109. v Syntaxe de dfinition de tche pour les travaux z/OS planifis avec Tivoli Workload Scheduler la page 153.

42

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 2. Mthode daccs Oracle e-Business Suite

Copyright IBM Corp. 2000, 2003

43

44

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 6. Introduction
IBM Tivoli Workload Scheduler for Applications pour Oracle e-Business Suite vous permet de planifier des travaux Oracle e-Business Suite grce aux fonctions de planification volues de Tivoli Workload Scheduler. Tout au long de ce manuel, les termes Oracle Applications et Oracle e-Business Suite sont utiliss indiffremment pour se rfrer au mme produit. Lhte Tivoli Workload Scheduler, lagent tendu Tivoli Workload Scheduler pour Oracle e-Business Suite et linstance Oracle e-Business Suite doivent tre installs sur le mme noeud physique.

Fonctions
v Utiliser les dpendances de travail standard de Tivoli Workload Scheduler ( lexception des dpendances Open File). v Planifier des travaux Oracle e-Business Suite devant sexcuter des jours et heures spcifiques, dans un ordre dtermin. v Dfinir des interdpendances entre les travaux Oracle Applications et ceux sexcutant sur des systmes diffrents, tels que R/3 et PeopleSoft. v Dfinir des interdpendances entre les travaux Oracle Applications et ceux sexcutant sur des plateformes diffrentes. v Personnaliser les codes retour dexcution des travaux.

Configuration logicielle requise


Pour installer et utiliser IBM Tivoli Workload Scheduler for Applications pour Oracle e-Business Suite, vous devez disposer des lments suivants, savoir : v Un des systmes dexploitation pris en charge suivant : HP-UX 11.0 ou 11.i, Environnement dexploitation Solaris Versions 7, 8 ou 9, IBM AIX 4.3.3 ou 5.1. v Les logiciels installs suivants &: IBM Tivoli Workload Scheduler version 7.0 ou suprieure, Oracle Applications 10.7 ou Oracle e-Business Suite version 11.0 ou 11.i, Pour les utilisateurs AIX et HP uniquement, le compilateur gcc pour la plateforme considre. Les fichiers binaires du compilateur gcc peuvent tre tlchargs partir de diffrentes sources sur le Web. Pour obtenir une liste mise jour des plateformes prises en charge, contactez le service dassistance la clientle.

Tches post-installation
Une fois le produit install selon la procdure dcrite au Chapitre 2, Installation dIBM Tivoli Workload Scheduler for Applications, la page 5, excutez les tapes suivantes pour terminer linstallation de la mthode daccs pour Oracle e-Business Suite :
Copyright IBM Corp. 2000, 2003

45

1. Connectez-vous avec un ID dutilisateur Unix Oracle Applications ayant accs tous les fichiers dans le rpertoire principal dOracle Applications. 2. Accdez au rpertoire dinstallation :
cd <racine_TWS>/methods/OracleTMP

Remarque : Si vous utilisez la base de donnes de dmonstration dOracle Applications, remplacez le fichier indiqu aux tapes 3 et 4 par APPDEMO.env. 3. Modifiez le fichier Oracle Applications APPLSYS.env comme suit : a. Ajoutez MCM aux variables APPLSHAR et APPLFULL.
APPLSHAR=ALR FF MCM APPLFUL=FND AD AX AK GL RG INV OP MCM

b. Dfinissez et exportez la variable de shell MCM_TOP :


MCM_TOP=$APPL_TOP/mcm/integration export MCM_TOP

c. Ajoutez $MCM_TOP/bin la variable PATH en entrant les lignes suivantes au bas du fichier APPLSYS.env :
PATH=$PATH:$MCM_TOP/bin export PATH

4. Excutez le fichier APPLSYS.env pour dfinir lenvironnement :


. APPLSYS.env

Remarque : Vrifiez que la connexion Oracle Applications dispose des droits requis pour crire dans les rpertoires racine_TWS et methods. 5. Modifiez les caractristiques de proprit Utilisateur et Groupe des fichiers installs en leur attribuant celles du propritaire Oracle Applications. 6. Accdez au rpertoire /temp/usrxit. 7. Pour les utilisateurs AIX et HP uniquement : v Etant donn le format des objets MCMxxx.o, vous devez utiliser le compilateur gcc pour que votre plateforme puisse excuter les tapes suivantes. Les fichiers binaires du compilateur gcc peuvent tre tlchargs partir de diffrentes sources sur Internet. v Pour les utilisateurs AIX uniquement : personnalisez le script adrelink fourni par Oracle pour les options de rdition de liens gcc : a. Localisez la ligne suivante :
AIXRIOS) LDFLAGS=-s -H512 -T512 -bhalt:4 -brtl -L$(ORACL ....

b. Supprimez lexpression
-H512 -T512 -bhalt:4 -brtl

de cette ligne, afin quelle se prsente comme suit :


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

v Vrifiez que le compilateur gcc est configur dans le chemin daccs lenvironnement du propritaire de lapplication. Vous pouvez galement modifier le fichier mcm.mk fourni avec le produit en y insrant le chemin daccs complet gcc dans la ligne
CC="gcc"

Remarque : IBM Tivoli Workload Scheduler for Applications pour Oracle e-Business Suite prend uniquement en charge la version 2.x du compilateur gcc. La version 3.x nest pas prise en charge.

46

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

8. Excutez le script dinstallation mcminstall partir du rpertoire Temp. Utilisez la commande suivante :
sh mcminstall

Un cran Tivoli Oracle apparat. 9. Rpondez aux questions de lcran en fonction de vos paramtres Oracle Applications et de ceux de votre installation Tivoli Workload Scheduler. Le processus dinstallation tente prsent de crer des liens entre les excutables Tivoli Workload Scheduler for Applications et les bibliothques partages dOracle Applications. Une fois le processus ddition des liens termin, les excutables ci-dessous doivent se trouver dans le rpertoire $MCM_TOP/bin : v MCMLJ v MCMSTAT v MCMTJ Ces fichiers binaires sont crs par lutilitaire adrelink pour Oracle Applications, qui enregistre galement MCM comme module dans AOL. Si vous rencontrez des problmes lors de ldition des liens, vous devez absolument les corriger et rexcuter ltape, car celle-ci est essentielle pour la cration des fichiers binaires qui permettent Tivoli Workload Scheduler for Applications dinteragir avec Oracle Concurrent Manager au niveau de la soumission et du contrle des travaux. 10. Editez le fichier doptions. Reportez-vous au Chapitre 8, Informations de rfrence sur le fichier doptions MCMAGENT, la page 53 et au Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27 pour plus de dtails. Linstallation est prsent termine. Consultez la documentation IBM Tivoli Workload Scheduler pour plus de dtails sur le dmarrage de Batchman, la dfinition des postes de travail, des travaux et des autres oprations Tivoli Workload Scheduler.

Programmes dinterface
Linterface entre Tivoli Workload Scheduler et Oracle e-Business Suite comprend les programmes suivants : MCMAGENT Mthode daccs dIBM Tivoli Workload Scheduler for Applications pour Oracle e-Business Suite. MCMLJ Soumet un travail Oracle Concurrent Manager (OCM). MCMSTAT Surveille ltat du travail soumis. MCMTJ Termine le travail soumis, lorsque Tivoli Workload Scheduler envoie un signal kill. mcm.mk Utilitaire makefile permettant de lier les programmes ci-dessus avec Oracle Applications.

Chapitre 6. Introduction

47

MCMAGENT.opts Fichier doptions globales contenant les paramtres de configuration de la mthode daccs. Ce fichier est cr par le processus dinstallation de Tivoli Workload Scheduler for Applications, avec certaines valeurs que vous avez entres durant linstallation. Reportez-vous au Chapitre 8, Informations de rfrence sur le fichier doptions MCMAGENT, la page 53 et au Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27 pour plus de dtails. <NOM_POSTE_DE_TRAV AIL>_MCMAGENT.opts Fichier doptions locales contenant les paramtres de configuration de lagent tendu. Ce fichier est obligatoire pour chaque poste de travail dagent tendu que vous dfinissez. Reportez-vous au Chapitre 8, Informations de rfrence sur le fichier doptions MCMAGENT, la page 53 et au Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27 pour plus de dtails.

48

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 7. Informations sur la dfinition des travaux


Ce chapitre fournit des informations sur la dfinition des travaux Oracle Applications dans Tivoli Workload Scheduler.

Dfinition des travaux dans Oracle Applications


Dans Oracle Applications, les travaux qui doivent tre planifis via Tivoli Workload Scheduler sont dfinis de la mme manire que les autres travaux Oracle Applications (et peuvent tre soumis dans OCM). Lorsque vous soumettez un travail dans OCM, vous devez spcifier les informations de planification et de resoumission. Lorsque vous soumettez le travail via Tivoli Workload Scheduler, celui-ci prend en charge les informations de planification et de resoumission. Pour dfinir un travail, utilisez les excutables et les formulaires Define Concurrent Program et entrez les informations gnrales sur le travail. Le travail peut alors tre planifi partir de Tivoli Workload Scheduler ; il peut galement tre soumis dans OCM.

Excutions simultanes dun mme travail


Si un travail Oracle Applications est planifi pour sexcuter plusieurs fois dans Tivoli Workload Scheduler et que Tivoli Workload Scheduler lance les diffrentes instances en parallle, les travaux sexcuteront normalement. Toutefois, si lutilisateur Oracle Applications a spcifi que plusieurs instances du travail ne pouvaient pas sexcuter simultanment, le deuxime travail sera mis en attente (tat WAIT) jusqu ce que le premier travail soit termin.

Dfinition des travaux Oracle Applications dans Tivoli Workload Scheduler


Une dfinition de travail Tivoli Workload Scheduler est requise pour chaque travail Oracle Applications que vous envisagez de planifier. Les travaux Oracle Applications sont dfinis dans Tivoli Workload Scheduler comme tout autre travail ; ils incluent un nom de travail, un nom dutilisateur et des options de rcupration. Reportez-vous au Chapitre 5, Dfinition des travaux dagent tendu, la page 37.

Paramtres de chane de tches pour les travaux Oracle Applications


Cette section dcrit les paramtres des chanes de tches qui grent lexcution des travaux Oracle Applications. Vous devez les spcifier aux emplacements suivants lorsque vous dfinissez les travaux Tivoli Workload Scheduler qui leur sont associs : v Dans la zone Commande de la page Tche de la fentre Proprits - Dfinition du travail, si vous utilisez Job Scheduling Console. v En tant quarguments du mot cl scriptname dans linstruction de dfinition du travail, si vous utilisez la ligne de commande Tivoli Workload Scheduler. v En tant quarguments du mot cl JOBCMD dans linstruction JOBREC du fichier SCRIPTLIB de Tivoli Workload Scheduler pour z/OS, si vous planifiez dans un environnement de bout en bout.
Copyright IBM Corp. 2000, 2003

49

Ces paramtres sont dcrits dans le tableau ci-aprs.


Tableau 9. Paramtres de chane de tches pour les travaux Oracle Applications. Paramtre -user appslogin -job jobspecs Description Nom dun utilisateur Oracle Applications valide (Appslogin). Attributs du travail Oracle Applications. Quatre attributs doivent tre spcifis dans lordre suivant, savoir : v le nom du module Applications utilis pour se connecter Oracle Applications (par exemple, FND), v une autorit valide pour le module Applications (par exemple, dveloppeur dapplications, inclure entre des guillemets simples), v le nom de lapplication qui a enregistr le travail (par exemple, PO), v le nom du travail (par exemple, POXACR). Le nom du travail doit tre en majuscules. Par exemple : -job FND dveloppeur dapplications PO POXACR -prn printopts Options dimpression du travail, au nombre de deux. Ces options doivent tre entres dans lordre suivant : v nom de limprimante (facultatif). En cas domission, limprimante par dfaut spcifie dans le fichier doptions sera utilise, v nombre de copies. Par exemple : -prn ps4 2

50

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 9. Paramtres de chane de tches pour les travaux Oracle Applications. (suite) Paramtre [-vn (valeur|null|:paramtre)] Description Paramtres du travail, sils existent. Cette chane est facultative si aucun paramtre nest spcifi pour le travail dans Oracle Applications. v n correspond au numro du paramtre (v1, v2, etc.), v lune des options suivantes : valeur Valeur relle. Faites figurer la valeur entre des guillemets simples si elle contient des caractres spciaux.

:paramtre Nom dun paramtre Tivoli Workload Scheduler dj dfini. Pour plus dinformations sur les paramtres Tivoli Workload Scheduler, reportez-vous au manuel Tivoli Workload Scheduler - Guide de rfrence. La mthode daccs ajoutera automatiquement tous les paramtres que vous navez pas spcifis dans la dfinition en leur associant la valeur null. Voici deux exemples : -v4 abc -v15 :p1

Voici, titre dexemple, comment peut se prsenter une chane de tches complte :
-user GLOBAL -job FND Dveloppeur dapplications PO POXACR -prn ps4 2 -v1 abc

Chapitre 7. Informations sur la dfinition des travaux

51

Etats des travaux Tivoli Workload Scheduler et Oracle Applications


Lorsquun travail Oracle Applications est lanc par Tivoli Workload Scheduler, vous pouvez surveiller sa progression grce Conman. Les transitions dtat utilises dans Tivoli Workload Scheduler et leurs correspondances dans Oracle Applications sont rpertories ci-dessous.
Etats dOracle Concurrent Manager Request Failure ou Request not Found Inactive Pending Pending Normal Running Normal Completed Normal Completed Warning Completed Error Completed Terminated Completed Canceled Etats de Tivoli Workload Scheduler UT (unsup. task - tche non prise en charge) SUSP WAIT ADD EXEC SUCC SUCC ABEND ABEND ABEND

Pour plus dinformations sur la gestion des travaux, reportez-vous au manuel Tivoli Workload Scheduler - Guide de rfrence.

52

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 8. Informations de rfrence sur le fichier doptions MCMAGENT


Cette section fournit des informations de rfrence dtailles sur le fichier doptions IBM Tivoli Workload Scheduler for Applications pour Oracle e-Business Suite.

Fichier doptions
Toute instance installe de la mthode daccs Oracle doit avoir un fichier doptions ddi. Celui-ci peut tre cr au cours ou lissue de linstallation de la mthode daccs, avec lEditeur doptions (voir Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27) ou un quelconque diteur de texte. Il doit, en outre, rpondre la convention de dnomination <NOM_POSTE_DE_TRAVAIL>_MCMAGENT.opts et tre situ dans le rpertoire racine_TWS/methods. Si vous ne crez pas de fichier doptions, lagent utilisera, par dfaut, le fichier doptions globales appel MCMAGENT.opts.

Syntaxe des entres


Le tableau suivant rpertorie les options de la mthode daccs MCMAGENT.
Tableau 10. Options MCMAGENT. Option ORACLE_HOME ORACLE_SID Description Rpertoire Unix o le logiciel Oracle est install. Identificateur systme Oracle de linstance de base de donnes laquelle vous vous connectez. Correspond la valeur de la variable Oracle Applications $ORACLE_SID. Rpertoire Unix o Oracle Applications est install. Rpertoire principal FND o rside la bibliothque Application Object. Paramtre de la variable PATH, incluant le chemin existant, le chemin du rpertoire bin dOracle Applications, le chemin du rpertoire include en aval du rpertoire principal FND et dautres, le cas chant. Fichier denvironnement excuter. Chaque instance dOracle Applications a son propre fichier denvironnement (APPLSYS.env ou APPDEMO.env). Le nom de fichier .env attribu ici sera utilis pour dfinir dynamiquement lenvironnement lorsque Tivoli Workload Scheduler excutera des travaux sur lagent tendu Oracle Applications. ID utilisateur de base de donnes ayant accs tous les modules Oracle Applications. Cet ID doit pouvoir lancer, grer et terminer des travaux dans Oracle Applications. Mot de passe associ lID utilisateur slectionn. Pour obtenir la valeur code, utilisez lutilitaire enigma fourni avec le produit. Reportez-vous la section Chiffrage des mots de passe utilisateur Oracle Applications la page 54. ID de limprimante par dfaut.

ORA_APP_TOPDIR FND_TOPDIR PATH

ENV

USERID

PASSWORD

PRINTER_NAME

Copyright IBM Corp. 2000, 2003

53

Tableau 10. Options MCMAGENT. (suite) Option MIN_TIME Description Nombre de secondes ajouter au prcdent dlai dinvitation mettre, lissue duquel le statut du travail doit tre contrl. Nombre de secondes lissue duquel le dlai dinvitation mettre ne sera pas incrment.

MAX_TIME

Toutes les options sont obligatoires et doivent tre crites raison dune par ligne, selon le format :
OPTION=VALEUR

sans aucun espace.

Exemple
Le fichier HP113_MCMAGENT.opts est un exemple de fichier doptions :
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

Chiffrage des mots de passe utilisateur Oracle Applications


Lorsque vous entrez des paramtres dans le fichier doptions, la valeur du mot de passe est automatiquement chiffre avant dtre crite dans le fichier. Si vous modifiez le fichier avec un diteur de texte, vous devez excuter le programme enigma pour chiffrer le mot de passe avant de lcrire dans le fichier. Excutez le programme enigma comme suit :
enigma [mot_de_passe]

Vous pouvez inclure le mot de passe dans la ligne de commande ou lentrer dans une rponse une invite. Le programme renvoie une version chiffre que vous pouvez alors entrer dans le fichier doptions.

54

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 3. Mthode daccs PeopleSoft

Copyright IBM Corp. 2000, 2003

55

56

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 9. Introduction
IBM Tivoli Workload Scheduler for Applications pour PeopleSoft vous permet dexcuter et de contrler des travaux PeopleSoft partir de lenvironnement Tivoli Workload Scheduler. Ces travaux peuvent tre excuts dans le cadre dun calendrier ou soumis en vue dun traitement ponctuel. Les travaux dagent tendu PeopleSoft peuvent bnficier des mmes dpendances et options de rcupration que les autres travaux Tivoli Workload Scheduler. Les travaux PeopleSoft doivent tre documents dans Tivoli Workload Scheduler pour tre excuts et contrls dans lenvironnement Tivoli Workload Scheduler.

Fonctions
v Lagent tendu pour les versions 7.0, 7.5 et 8.x de PeopleSoft a t certifi par PeopleSoft sous Windows NT 4.0 avec le Service Pack 6 et sous Windows 2000. v Prise en charge de PeopleSoft 8.x. v Utiliser les dpendances de travail Tivoli Workload Scheduler standard pour les travaux PeopleSoft. v Planifier des travaux PeopleSoft devant sexcuter des jours et heures spcifiques, dans un ordre dtermin. v Dfinir des interdpendances entre les travaux PeopleSoft et les travaux Tivoli Workload Scheduler sexcutant sur des applications diffrentes, telles que R/3 et Oracle. v Dfinir des interdpendances entre les travaux PeopleSoft et ceux sexcutant sur des plateformes diffrentes. v Personnaliser les codes retour dexcution des travaux.

Principes de fonctionnement
Tivoli Workload Scheduler peut lancer et contrler des travaux dans le planificateur de traitement PeopleSoft partir dun poste de travail dagent tendu PeopleSoft. Lagent tendu PeopleSoft est dcrit dans une dfinition de poste de travail Tivoli Workload Scheduler standard. Cette dfinition est un nom de poste de travail logique qui spcifie la mthode daccs en tant que psagent. La mthode daccs est utilise pour communiquer les demandes de travaux au planificateur de traitement PeopleSoft. Pour lancer un travail PeopleSoft, Tivoli Workload Scheduler excute la mthode psagent et lui transmet les informations relatives au travail. Un fichier doptions fournit la mthode avec le chemin, lexcutable et dautres informations sur le planificateur de traitement PeopleSoft et le serveur dapplications utilis pour lancer le travail. Lagent tendu peut alors accder la table des demandes de traitement PeopleSoft et insrer une entre dans la table pour lancer le travail. La progression du travail et les informations de statut sont reportes dans le fichier Stdlist du travail.

Copyright IBM Corp. 2000, 2003

57

Travaux du planificateur de traitements PeopleSoft


Le planificateur de traitements PeopleSoft utilise les entres de la table des demandes de traitement (PSPRCSRQST) pour grer ses dcisions. Ces entres dcrivent les traitements qui seront lancs par lagent serveur du planificateur de traitements. Elles contiennent galement les informations requises pour dterminer le statut du traitement. La mthode daccs PeopleSoft peut insrer des entres, interroger le contenu et modifier les informations de statut lintrieur de cette table (PSPRCSRQST). Lorsquil documente un travail PeopleSoft dans Tivoli Workload Scheduler, lutilisateur dfinit de fait une demande de traitement qui sera insre dans la table des demandes de traitement (PSPRCSRQST). Une demande de traitement manant de Tivoli Workload Scheduler doit contenir trois lments de donnes valides : v une dfinition de traitement avec deux paramtres : type de traitement, nom du traitement, v un ID oprateur (non requis pour une excution sous PeopleSoft 8.x), v un ID de contrle dexcution. Tous ces lments sont requis pour quun travail PeopleSoft puisse sexcuter. La mthode daccs PeopleSoft met directement jour la table PSPRCSRQST pour PeopleSoft 7.x (connexion 2 niveaux), alors que pour PeopleSoft 8.x elle exploite le serveur dapplications PeopleSoft via linterface expose par linterface du composant PROCESSREQUEST (connexion 3 niveaux). Notez que le planificateur de traitements et le serveur dapplications sexcutent sous Unix et sur les postes de travail FTA Windows pris en charge, alors que lagent tendu ne sexcute que sous Windows NT ou sous Windows 2000.

Suivi des travaux PeopleSoft dans Tivoli Workload Scheduler


Dans PeopleSoft, un travail est constitu dune collection de traitements qui sexcutent ensemble en tant quunit unique. Les travaux Tivoli Workload Scheduler peuvent tre dfinis laide de lune des mthodes suivantes : v En tant que travaux PeopleSoft, cest--dire sous forme de collection de traitements PeopleSoft. Dans ce cas, le systme effectue le suivi du statut du travail PeopleSoft, et non de chaque traitement constituant le travail. v En tant que traitement PeopleSoft. Dans ce cas, le suivi du statut de chaque traitement est effectu et les calendriers Tivoli Workload Scheduler peuvent tre dfinis de manire crer des interdpendances complexes et des options de rcupration entre les traitements PeopleSoft.

Scurit
La scurit des travaux PeopleSoft est traite au niveau de la scurit Tivoli Workload Scheduler standard.

Remarques sur le support PeopleSoft Version 8.x


Le support PeopleTools 8.x comporte quelques modifications que vous devriez connatre si vous envisagez dutiliser la mthode x-agent dans votre environnement.

58

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

v Le mot cl -operator utilis dans les spcifications de travaux Tivoli Workload Scheduler et le paramtre correspondant sont actuellement ignors par la mthode psagent et le contexte dexcution. En consquence, les travaux seront soumis et sexcuteront avec le mme ID doprateur PS que celui utilis pour la connexion avec PeopleSoft. Vous navez pas modifier vos dfinitions de travaux Tivoli Workload Scheduler si vous migrez de PeopleTools 7.x vers PeopleTools 8.x. La seule diffrence sera que tous les travaux soumis un agent tendu PeopleSoft 8.x sexcuteront sous le mme ID que celui spcifi dans le fichier <NOM_CPU>_psagent.opts. v Il nest pas ncessaire dinstaller la connectivit de base de donnes sur les agents tolrants aux pannes hbergeant des agents tendus PeopleSoft, tant donn que la mthode utilise actuellement larchitecture PeopleSoft 3 niveaux. Toutefois, vous devrez configurer au moins un serveur dapplications PeopleSoft pour que lagent tendu fonctionne. Le serveur dapplications doit tre actif afin de pouvoir soumettre les travaux au planificateur de traitements PeopleSoft. v Il est inutile de charger TVPUPSFT.dms dans la base de donnes PeopleSoft 8.x lorsque vous travaillez en mode 3 niveaux. v Pour PeopleSoft 8.1x, la mthode requiert linstallation du support dAPI externe PeopleSoft sur lagent tolrant aux pannes qui hberge la mthode dagent tendu. Le rpertoire dinstallation de lAPI externe est utilis durant les traitements dinstallation et de configuration de lagent tendu, lorsque vous devez spcifier le rpertoire de base PeopleSoft ou le rpertoire racine COBOL. Pour installer lAPI externe, utilisez lexcutable setup.exe situ dans le rpertoire du serveur de fichiers PeopleSoft 8.1x appel : <racine_PS>\setup\PsExtAPI. Linstallation de lAPI externe PeopleSoft doit seffectuer avant celle de Tivoli Workload Scheduler for Applications. Vrifiez linstallation de lAPI externe selon les instructions de PeopleSoft, savoir en utilisant loutil jnitest.exe situ dans le rpertoire dinstallation de lAPI externe PS. Vous devrez redmarrer votre poste de travail avant de pouvoir utiliser linstallation de PsExtAPI. Si vous ne redmarrez pas votre poste de travail, vous verrez apparatre une fentre (gnre par TVPUPSFT.exe) avec le message suivant :
"The application failed to initialize properly (0xc0000005). Click on OK to terminate the application"

Chapitre 9. Introduction

59

60

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 10. Planification dimplmentation


PeopleSoft version 7.5 ou antrieure
Cette section dcrit la planification dimplmentation de lagent tendu avec PeopleSoft version 7.5 ou antrieure.

Configuration requise pour lhte


Le poste de travail hbergeant lagent tendu doit rpondre aux exigences suivantes, savoir : v Etre un agent tolrant aux pannes (FTA) ou un agent standard (SA) de Tivoli Workload Scheduler sexcutant dans une version prise en charge de Windows. v Disposer dun accs rseau la base de donnes PeopleSoft. v Pouvoir tre un poste de travail PeopleSoft. v Avoir accs aux bibliothques de support PeopleSoft et COBOL. Le support COBOL doit tre compatible avec le compilateur utilis pour lenvironnement du planificateur de traitements NT.

Configuration logicielle requise


IBM Tivoli Workload Scheduler for Applications pour PeopleSoft requiert les logiciels suivants : v Windows NT 4.0 avec Service Pack 6 ou Windows 2000 avec Service Pack 2, v IBM Tivoli Workload Scheduler version 7.0 ou ultrieure, v PeopleSoft version 7.0 ou 7.5, v Compilateur COBOL PeopleSoft. Remarques : 1. Lagent tendu pour PeopleSoft versions 7.0 et 7.5 est disponible avec MicroFocus NetExpress 2.1 et MicroFocus NetExpress 3.1. 2. Lagent tendu pour PeopleSoft version 7.0 tait galement compil avec le compilateur COBOL MicroFocus version 4.1. 3. Pour les versions Peoplesoft 7.x, vous devez recompiler le planificateur de traitements PeopleSoft sous Windows si vous voulez lutiliser pour les travaux grs via Tivoli Workload Scheduler.

Configuration de lutilisateur Windows


v Crez un ID utilisateur de domaine, ou local, ayant accs la fois au logiciel PeopleSoft et Tivoli Workload Scheduler, ou configurez lutilisateur existant pour quil puisse accder au logiciel PeopleSoft et Tivoli Workload Scheduler. Reportez-vous la section Configuration utilisateur pour Windows la page 65 pour plus de dtails. v Connectez-vous avec ce nouvel ID. v Connectez-vous aux units appropries pour PeopleSoft et vrifiez que loption Se reconnecter louverture de session est slectionne. Lindicatif dunit doit tre identique celui que vous avez spcifi pour PSDRIVE dans le fichier psagent.opts . v Effectuez la configuration au niveau de PeopleSoft. Suivez les instructions fournies avec votre logiciel PeopleSoft.
Copyright IBM Corp. 2000, 2003

61

Vrification de lenvironnement PeopleSoft


Vrifiez que votre environnement PeopleSoft est correctement configur et que les travaux PeopleSoft peuvent tre excuts sans incident par le planificateur de traitements. Remarques : 1. Vrifiez la connectivit avec la base de donnes PeopleSoft laide de lID utilisateur Windows cr prcdemment. Pour tester la connexion, excutez une commande de base de donnes partir dun quelconque utilitaire ODBC. 2. Vrifiez laccs au serveur de fichiers PeopleSoft ou la prsence dune copie locale des excutables.

Cration dun ID de traitement par lots dans PeopleSoft


Vous pouvez crer, dans PeopleSoft, un ID doprateur ddi la planification des lots. Tous les travaux soumis par Tivoli Workload Scheduler peuvent utiliser cet ID doprateur.

Fichiers installs
Les fichiers suivants sont installs dans les rpertoires Tivoli Workload Scheduler et PeopleSoft lors de linstallation de Tivoli Workload Scheduler for Applications :
Destination racine_TWS \methods\PeopleSoft Fichiers v TVPUPSFT7xx.dms, o xx spcifie ldition de PeopleSoft version 7. v PTCUDCOP.cbl racine_TWS\methods v psagent.exe v enigma.exe <PSDRIVE_PSVER>\cblbin v TVPUPSFT.exe v TVPUPSFT.gnt Utilisateur Tivoli Workload Scheduler Propritaire de PTPUPRCS.exe Propritaire Utilisateur Tivoli Workload Scheduler

Remarque : racine_TWS reprsente le nom du rpertoire o vous avez install Tivoli Workload Scheduler.

PeopleSoft version 8.x


Cette section dcrit le planning dimplmentation de lagent tendu avec PeopleSoft version 8.x.

Configuration requise pour lhte


Le poste de travail hbergeant lagent tendu doit tre un agent tolrant aux pannes (FTA) ou un agent standard (SA) de Tivoli Workload Scheduler sexcutant sur une plateforme Windows prise en charge. Si votre site compte plusieurs serveurs de processus pour une seule base de donnes PeopleSoft, vous pouvez configurer un poste de travail dagent tendu (avec plusieurs fichiers doptions) pour traiter les travaux sur les diffrents serveurs de processus.

62

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Configuration logicielle requise


IBM Tivoli Workload Scheduler for Applications pour PeopleSoft requiert les logiciels suivants : v Windows NT 4.0 avec Service Pack 6 ou Windows 2000 avec Service Pack 2, v IBM Tivoli Workload Scheduler version 7.0 ou suprieure, v PeopleSoft version 8.1x ou 8.4x, v Pour PeopleSoft version 8.1x : API externes de PeopleTools version 8.1x. v Pour PeopleSoft version 8.4x : accs PeopleSoft File Server 8.4x ou prsence dune copie locale des excutables.

Cration dun ID de traitement par lots dans PeopleSoft


Vous pouvez crer, dans PeopleSoft, un ID doprateur ddi la planification des lots. Cet ID doprateur doit pouvoir utiliser linterface de composants dans lenvironnement PeopleTools. Tous les travaux soumis par IBM Tivoli Workload Scheduler peuvent utiliser cet ID doprateur.

Fichiers installs
Les fichiers suivants sont installs dans les rpertoires IBM Tivoli Workload Scheduler et PeopleSoft lors de linstallation de IBM Tivoli Workload Scheduler for Applications pour PeopleSoft :
Destination racine_TWS\methods Fichiers v psagent.exe v enigma.exe rpertoire PSAPI TVPUPSFT.exe Propritaire Utilisateur Tivoli Workload Scheduler Utilisateur Tivoli Workload Scheduler

Remarque : racine_TWS reprsente le nom du rpertoire o vous avez install Tivoli Workload Scheduler.

Chapitre 10. Planification dimplmentation

63

64

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 11. Tches post-installation


Ce chapitre dcrit les tches importantes qui doivent suivre linstallation de la mthode daccs.

Configuration utilisateur pour Windows


Lorsquun client PeopleSoft est utilis pour soumettre des travaux via IBM Tivoli Workload Scheduler for Applications pour PeopleSoft dans lenvironnement trois niveaux, laide dune ressource partage sur un serveur de fichiers PeopleSoft, la connexion au flux (Streamlogon) spcifie lors de la soumission du travail doit tre connue la fois du client soumettant le travail et du serveur de fichiers PeopleSoft. Ce doit donc tre : v Soit un utilisateur de domaine. v Soit un utilisateur local dfini sur le serveur de fichiers PeopleSoft et sur le client PeopleSoft avec les mmes nom et mot de passe. Lutilisateur doit alors tre dfini dans la base de donnes Tivoli Workload Scheduler. Si cette condition nest pas respecte, les vnements suivants se produiront : v Les travaux sarrteront de manire anormale. v Deux messages derreur avec le texte suivant seront envoys par le systme dexploitation au fichier Stdlist du travail :
Logon failure: unknown user name or bad password. procwork.cpp(328): The pipe has ended.

Lutilisateur doit galement faire partie du groupe Administrateur sur le client PeopleSoft. Si tel nest pas le cas, les vnements suivants se produiront : v Les travaux passeront ltat INTRO (et un signe Plus + sera ajout, indiquant un travail actif). v Une fentre en incrustation apparatra sur le poste de travail Tivoli Workload Scheduler hbergeant lagent tendu, avec le titre psagent.exe - Application Error et le texte suivant :
The application failed to initialize properly (0xc0000005). Click on OK to terminate the application.

v Une fois que vous aurez cliqu sur le bouton OK, les travaux passeront ltat ABEND et le fichier Standlist du travail affichera uniquement la bannire du programme JOBLNCH.

Cration du fichier doptions


Les fichiers doptions dagent tendu PeopleSoft spcifient, entre autres, lutilisateur avec lequel la mthode se connecte la base de donnes PeopleSoft. Ils sont galement utiliss pour spcifier la frquence dinterrogation applique au module PeopleSoft pour la vrification du statut des travaux. Ce fichier doit rsider sur lordinateur hte de lagent tendu, dans le rpertoire racine_TWS\methods.

Copyright IBM Corp. 2000, 2003

65

Pour crer un fichier doptions, vous pouvez utiliser soit le programme Editeur doptions fourni avec ce produit, soit un diteur de texte de votre choix. Reportez-vous au Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27 pour plus de dtails sur la cration ou la modification de fichiers doptions avec lEditeur doptions et la section Modification manuelle des fichiers doptions la page 68 pour consulter des exemples de fichiers doptions propres cette mthode daccs. Le tableau suivant dcrit les options de la mthode daccs psagent :
Tableau 11. Options Psagent. Option LJuser Description ID de lutilisateur Windows qui lance les travaux IBM Tivoli Workload Scheduler. Cet utilisateur Windows doit tre un utilisateur Tivoli Workload Scheduler valide sur le poste de travail hte. ID de lutilisateur Windows qui excute un contrle de fichiers. La valeur par dfaut correspond celle de LJuser. Intervalle de temps entre les vrifications de statut lors du contrle dune demande de traitement. La valeur par dfaut est de 2 minutes. Utilisez loption CheckIntervalUnits pour passer de minutes en secondes. Spcifie que lintervalle entre les vrifications de statut est en secondes (valeur = 1) ou en minutes (valeur = 60). Entrez la valeur 1 pour activer lexcution de la trace ou 0 pour la dsactiver. Identificateur dunit Windows pour les fichiers PeopleSoft (par exemple, N:). Rpertoire de base des fichiers PeopleSoft (par exemple, \PT7.5 ou \PT8) pour toutes les version PeopleSoft, sauf 8.1x. Dans ce cas, il sagit du rpertoire o le fichier TVPUPSFT.exe est install (par exemple, \PT817\bin\client\winx86_extapi). Pour PeopleSoft 7.x : chemin daccs au rpertoire principal des bibliothques COBOL Micro Focus (par exemple, N:\PT7.5). Pour PeopleSoft 8.x : chemin daccs au rpertoire principal des API externes PeopleSoft, qui est identique au rpertoire de base PeopleSoft.

CFuser CheckInterval

CheckIntervalUnits PSXA_TRACE PSDRIVE PSVER

COBROOT

66

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 11. Options Psagent. (suite) Option CONNECT Description Chane contenant les entres suivantes : Type de connexion Type de SGBDR PeopleSoft. Choisissez lune des options suivantes : v APPSERV (PeopleSoft 8.x uniquement) v ORACLE v MICROSFT (Microsoft SQL Server) v DB2 (DB2 for MVS) v DB2UNIX v SQLBASE v DB2ODBC v DB2400 v INFORMIX v SYBASE v DB2MDI Nom du serveur de bases de donnes Nom du serveur de bases de donnes, uniquement pour Informix et Sybase. Nest pas utilis pour PeopleSoft Version 8.x. Nom du serveur Nom (adresse IP) du serveur spcifi comme Type de connexion. Pour APPSERV, cette entre doit tre, soit adresse IP:port TCP, soit le nom IP. Vous pouvez spcifier plusieurs entres, dans la mesure o elles sont spares par des virgules. ID doprateur ID doprateur utilis pour la connexion avec la base de donnes PeopleSoft. v Pour PeopleSoft version 7.x, les travaux ne seront pas excuts sous cet ID, mais sous lID spcifi dans la dfinition du travail Tivoli Workload Scheduler. v Pour PeopleSoft version 8.x, tous les travaux seront excuts sous cet ID. Mot de passe oprateur Mot de passe chiffr pour lID doprateur. Si vous utilisez un diteur classique pour crire le fichier doptions, vous devez dabord utiliser loutil Enigma pour chiffrer ce mot de passe. Si vous utilisez lEditeur doptions, celui-ci sen charge votre place. Serveur de processus par dfaut Serveur de processus par dfaut excutant les travaux dans PeopleSoft. Les entres sont spares par des barres obliques (/), de manire ce que la chane se prsente sous la forme item1/item2/.../item6, et doivent tre rpertories dans lordre o elles ont t dcrites dans cette page. Toutes les entres sont obligatoires, lexception du Nom du serveur de bases de donnes. TWSXA_PT84_JVMPATH Chemin daccs Java Virtual Machine. Cette option nest disponible quavec PeopleTools version 8.4x.

Chapitre 11. Tches post-installation

67

Tableau 11. Options Psagent. (suite) Option UTF8cmdline Description Si la valeur est 0, cela signifie que la mthode dagent tendu attend de Tivoli Workload Scheduler quil envoie les donnes ncessaires au lancement du travail dans la page de codes locale. Sinon, elle attend les donnes au format UTF8. La valeur par dfaut est 1 (par exemple, format UTF8). Page de codes utilise par la mthode dagent tendu pour communiquer avec lapplication externe. Si cette option est absente ou comporte une valeur non valide, la page de codes locale sera utilise. Page de codes utilise par la mthode dagent tendu pour gnrer la sortie standard. Si cette option est absente ou comporte une valeur non valide, la page de codes locale sera utilise. Langue utilise par la mthode dagent tendu pour la sortie standard ( savoir, le catalogue de messages spcifi qui sera ouvert). Si cette option est absente ou comporte une valeur non valide, la langue locale sera utilise. Non pris en charge pour lagent tendu PeopleSoft.

TWSXA_CP

TWSMETH_CP

TWSMETH_LANG

TWSXA_LANG

Les noms doption tiennent compte de la diffrence Maj./min. et doivent tre crits, tels quils apparaissent dans la colonne de gauche du tableau 11. Avant dutiliser un fichier doptions cr manuellement, vrifiez que tous les noms doption sont crits correctement. Les options non conformes seront ignores.

Modification manuelle des fichiers doptions


Outre lEditeur doptions, vous pouvez utiliser un diteur de texte classique pour crer ou modifier un fichier doptions. Voici deux exemples de fichier doptions, destins vous aider dterminer les exigences spcifiques votre site. Votre fichier doptions peut diffrer des exemples ci-dessous. Noubliez pas denregistrer le fichier dans le rpertoire racine_TWS\methods.

Exemple pour PeopleSoft 7.x


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

Exemple pour PeopleSoft 8.1x


LJuser=TwsUsr CFuser=TwsUsr CheckInterval=15 PSDRIVE=D: PSVER=\pt81x\bin\client\winx86_extapi COBROOT=D:\pt81x\bin\client\winx86_extapi CONNECT=AppServ/PSOFT81X:9000/PSDEV/jp5l83nlWe7wh5jxk46qeV/PSUNX CheckIntervalUnits=1 PSXA_TRACE=1

68

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Connexion plusieurs bases de donnes PeopleSoft


La mthode psagent doit parfois se connecter plusieurs bases de donnes PeopleSoft. Par exemple, une mme installation de PeopleSoft peut avoir un environnement TEST, DEMONSTRATION et PRODUCTION, chacun avec une base de donnes spare, ce qui implique que la mthode psagent utilise une chane de connexion distincte pour chaque base de donnes. Afin de prendre en charge cette connexion multiple, vous pouvez configurer plusieurs postes de travail dagent tendu PeopleSoft qui se connectent la mme mthode, mais utilisent diffrents fichiers doptions. Lorsquun poste de travail dmarre la mthode, il commence par rechercher le fichier doptions avec le nom du poste de travail dagent tendu prcdant psagent.opts. Par exemple, un agent tendu PeopleSoft nomm jupiter sera associ au fichier doptions :
jupiter_psagent.opts

La mthode psagent recherche dabord un fichier doptions avec le nom du poste de travail dagent tendu, puis le fichier par dfaut psagent.opts. Ceci permet lutilisateur de configurer un agent tendu pour chaque base de donnes PeopleSoft. Pour vous connecter une seule base de donnes, utilisez le nom par dfaut du fichier doptions, savoir psagent.opts.

Configuration dun environnement PeopleSoft, version 7.5 ou antrieure


La section ci-aprs explique comment configurer lenvironnement PeopleSoft si vous utilisez lagent tendu avec PeopleSoft version 7.5 ou antrieure.

Personnalisation du serveur de processus


Indpendamment du type de systme dexploitation sur lequel les travaux Tivoli Workload Scheduler seront excuts, vous devez personnaliser lexcutable du serveur de processus correspondant laide du source COBOL PTCUDCOP.cbl fourni par IBM. Vous devez remplacer le fichier PTCUDCOP.cbl fourni par PeopleSoft par son quivalent fourni par IBM et recompiler le planificateur de traitements. Vous trouverez des instructions compltes sur la recompilation du planificateur de traitements dans les manuels dinstallation PeopleSoft. Lorsque vous recevrez des correctifs de PeopleSoft, vous devrez peut-tre rpter le processus de personnalisation du serveur, si le fichier PTCUDCOP.cbl est cras lors de linstallation du correctif. Vous trouverez, ci-aprs, la procdure suivre pour personnaliser le serveur de processus sous Windows et sous UNIX.

Personnalisation sous Windows


Si le planificateur de traitements PeopleSoft sexcute sous Windows, reportez-vous la section Configuration de lenvironnement de traitement par lots sous Windows NT/2000 dans le manuel dinstallation PeopleSoft, pour accder des informations mises jour. Vous devez avoir install un compilateur COBOL sur votre serveur de lots et compiler partir de cet emplacement. Lordinateur excutant la compilation doit disposer dun compilateur COBOL et pouvoir accder en criture au serveur de fichiers.
Chapitre 11. Tches post-installation

69

Pour configurer un serveur de processus sous Windows : 1. Ouvrez une fentre avec une invite de commande DOS. 2. Dfinissez deux variables denvironnement, PS_HOME et COBROOT, sur lordinateur partir duquel vous envisagez de compiler le source COBOL. Utilisez les commandes suivantes :
set PS_HOME=n:\PS750 set COBROOT=c:\netexpress\base

3. Vrifiez que le rpertoire de compilation c:\temp\compile existe ; il doit dj exister si vous avez excut CBLBLD.BAT. Sil existe, supprimez les fichiers qui y rsident, par mesure de scurit. Sil nexiste pas, crez-le laide de la commande suivante :
mkdir c:\temp\compile

Remarque : Assurez-vous que vous avez accs en criture au rpertoire de compilation puisque le processus de compilation seffectuera cet emplacement. 4. Accdez au rpertoire <racine_PS>\setup. 5. Excutez la commande suivante pour copier tous les fichiers du source COBOL, du rpertoire <racine_PS> vers le rpertoire de compilation :
cblsrc <rpertoire_source> <rpertoire_compilation>

o <rpertoire_source> reprsente lunit et le rpertoire o rside la source (qui doit tre identique <racine_PS>) et <rpertoire_compilation> reprsente lunit et le rpertoire o les fichiers source doivent tre copis. Par exemple, la commande suivante prendra la source COBOL de <racine_PS> et copiera tous les fichiers ncessaires lemplacement o le processus de compilation seffectuera.
cblsrc <racine_PS> c:\temp\compile

6. Copiez le fichier PTCUDCOP.cbl fourni par IBM dans le rpertoire de compilation laide de la commande suivante :
copy <racine_TWS>\PeopleSoft\PTCUDCOP.cbl c:\temp\compile

7. Une fois la commande CBLSRC termine, accdez au rpertoire de compilation laide de la commande suivante :
cd c:\temp\compile

8. Compilez laide de la commande suivante :


CBLMAKE.BAT PTPUPRCS EXE LIST

En cas dincident lors de la compilation, consultez le fichier PTPUPRCS.lis pour plus de dtails et relancez la commande aprs avoir trait lincident. 9. Une fois la commande CBLMAKE.BAT termine, copiez les fichiers EXE, GNT ou INT dans le rpertoire <racine_PS>\cblbin laide des commandes suivantes :
copy PTPUPRCS.exe <racine_PS>\cblbin copy PTPUPRCS.gnt <racine_PS>\cblbin

Personnalisation sous UNIX


Si le planificateur de traitements PeopleSoft sexcute sous UNIX, reportez-vous la section Configuration de lenvironnement de traitement par lots sous UNIX dans le manuel dinstallation PeopleSoft, pour accder des informations mises jour. Vous devez avoir install un compilateur COBOL sur votre serveur de lots et

70

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

compiler partir de cet emplacement. Lordinateur excutant la compilation doit disposer dun compilateur COBOL et doit pouvoir accder en criture au rpertoire <racine_PS>/cblbin. Pour crer le serveur de processus sous UNIX : 1. Connectez-vous au serveur UNIX. 2. Accdez au rpertoire principal PeopleSoft. 3. Excutez le script psconfig.sh. 4. Accdez au rpertoire $PS_HOME/src/cbl. 5. Renommez le fichier PTCUDCOP.cbl en PTCUDCOP.old laide de la commande suivante :
mv PTCUDCOP.cbl PTCUDCOP.old

6. Copiez PTCUDCOP.cbl depuis lagent tendu (racine_tws/PeopleSoft) via FTP. 7. Excutez les commandes suivantes :
cd ../../install pscbl.mak PTPUPRCS LIST

8. Une fois lexcution du script termine, vrifiez la prsence des nouveaux fichiers dans les rpertories de destination
<racine_PS>/src/cbl/int <racine_PS>/src/cbl/lst <racine_PS>/cblbin

Ils doivent avoir une longueur suprieure zro ainsi quun horodatage correspondant aux paramtres horaires en cours. En cas dincident lors de la compilation, consultez le fichier PTPUPRCS.lis pour prendre connaissance des erreurs, corrigez-les et relancez ltape de compilation.

Configuration du client
Pour excuter la mthode daccs PeopleSoft pour un environnement PeopleTools 7.x, vous devez travailler dans un environnement PeopleSoft deux niveaux et utiliser un poste de travail avec une connectivit approprie votre base de donnes. Vous devez installer le logiciel client de votre base de donnes sur le poste de travail hbergeant lagent tendu et devez le configurer pour quil puisse communiquer en mode ODBC. Testez votre connexion laide des outils de test ODBC accompagnant votre logiciel client (par exemple test 32 bits ODBC pour Oracle). Vous devez galement pouvoir accder au serveur de fichiers PeopleSoft. Mappez la ressource partage du serveur de fichiers une unit rseau de votre poste de travail Windows. Pour installer un poste de travail pour un environnement PeopleSoft 7.x: 1. Accdez \\<serveur_fichiers>\<partage> en tant quunit partage <d>: sur votre ordinateur. 2. Dfinissez PS_HOME comme rpertoire appropri sur la nouvelle unit partage, laide de la commande :
set PS_HOME=<d>:\PS750

3. Excutez :
%PS_HOME%\bin\CLIENT\WINX86\pscfg.exe

Chapitre 11. Tches post-installation

71

Une fentre de configuration, comme celle reprsente la figure 23, souvre. 4. Slectionnez longlet Configuration du client, spcifiez les valeurs requises et vrifiez que la case Installer le pilote ODBC PeopleSoft est coche. Si vous excutez SQL Server, vous devez galement cocher la case Installer le gestionnaire de pilotes ODBC 3.0. Remarque : Loption Installer le pilote ODBC PeopleSoft installe un nom de source de donnes utilisateur. Si vous avez besoin daccder la source de donnes dun autre profil utilisateur, vous devrez crer une source de donnes systme correspondante (via Panneau de configuration-> Sources de donnes ODBC) sur votre poste WinNT/2000, ou excuter nouveau ltape de personnalisation pour tous les autres utilisateurs que vous voulez utiliser pour soumettre des travaux dagent tendu Tivoli Workload Scheduler.

Figure 23. Fentre du gestionnaire de configuration 7.5.

Une fois lopration termine, le menu Dmarrer/Programmes de votre ordinateur devrait compter une nouvelle entre (intitule PeopleSoft 7.5).

Excution du script de loutil Dplacement de donnes


Une fois la squence dinstallation termine, loutil Dplacement de donnes PeopleSoft est utilis pour mettre ne place les procdures stockes pour lagent

72

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

tendu PeopleSoft. Pour plus dinformations sur le script de loutil Dplacement de donnes, consultez votre documentation Peoplesoft. 1. Cliquez sur licne Outil Dplacement de donnes dans le groupe PeopleSoft. La fentre de connexion Peoplesoft apparat.

Figure 24. Fentre de connexion PeopleSoft.

2. Slectionnez la base de donnes approprie et cliquez sur OK. Une fentre de connexion souvre. 3. Compltez les zones et cliquez sur OK. La fentre de loutil Dplacement de donnes saffiche. 4. Dans le menu Fichier de cette fentre, slectionnez la commande Ouvrir. Ouvrez le fichier suivant dans la fentre de loutil Dplacement de donnes :
racine_TWS\PeopleSoft\TVPUPSFT.dms

5. Excutez les scripts, aprs les avoir chargs dans la fentre de loutil Dplacement de donnes. La fentre de loutil Dplacement de donnes est scinde en deux sections. La section suprieure affiche les instructions du script de loutil Dplacement de donnes. La section infrieure affiche le statut des instructions du script, telles quelles sexcutent. 6. Vrifiez que le script sexcute correctement.

Chapitre 11. Tches post-installation

73

Figure 25. Fentre de loutil Dplacement de Donnes

Si certaines instructions chouent, vrifiez que les valeurs indiques dans la fentre de dmarrage pour le nom de la base de donnes, lID de connexion et le mot de passe sont correctes, puis rptez le processus. Si le script de loutil Dplacement de donnes ne sexcute toujours pas correctement, contactez votre administrateur de base de donnes pour dterminer si le problme ne rside pas dans votre base de donnes. Remarque : Le script de loutil Dplacement de donnes doit tre excut sur chaque base de donnes que lagent tendu PeopleSoft doit utiliser. Pour excuter les scripts sur une autre base de donnes, modifiez le nom de la base de donnes et/ou le SGBDR dans la squence de connexion.

Configuration dun environnement PeopleSoft version 8.1x


La section ci-aprs explique comment configurer lenvironnement PeopleSoft si vous utilisez lagent tendu avec PeopleSoft version 8.1x.

Personnalisation du serveur dapplications


La mthode daccs prenant en charge PeopleTools 8.1x ne peut fonctionner quavec une architecture PeopleSoft 3 niveaux. Vous devez donc dployer une architecture PeopleSoft 3 niveaux conformment aux instructions PeopleSoft. Du fait du dploiement complet de larchitecture PeopleSoft, avec au moins un serveur dapplications PeopleSoft et un serveur de processus, les contraintes en termes de configuration logicielle et de dpendances seront rduites sur le poste de travail dagent tendu. Il nest pas ncessaire dinstaller la connectivit de la base de donnes sur le poste de travail hbergeant lagent tendu. De plus, il nest pas ncessaire de personnaliser le serveur de processus, comme cela tait le cas avec PeopleTools version 7.x, ni dexcuter des scripts supplmentaires de loutil Dplacement de donnes pour personnaliser la base de donnes. Le serveur dapplications doit tre actif afin de pouvoir soumettre les travaux au planificateur de traitements PeopleSoft.

74

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Pour configurer correctement la mthode daccs, vous devez obtenir les informations suivantes de votre administrateur PeopleSoft : v Nom dhte (ou adresse IP) du serveur dapplications, v Port Jolt du serveur dapplications (gnralement 9000), v Nom du serveur de processus. LID doprateur doit avoir les droits requis pour utiliser linterface de composants dans lenvironnement PeopleTools.

Configuration du client
Pour excuter lagent tendu dans un environnement PeopleTools 8.1x, vous devez installer le support dAPI externe PeopleSoft sur le poste de travail Tivoli Workload Scheduler hbergeant lagent tendu. Linstallation de lAPI externe PeopleSoft doit seffectuer avant celle de Tivoli Workload Scheduler for Applications pour PeopleSoft. Les manuels dinstallation PeopleSoft contiennent des informations sur cette tape dinstallation. Reportez-vous la documentation PeopleSoft approprie pour prendre connaissance des instructions les plus rcentes, en fonction de votre version de PeopleSoft. Pour PeopleTools 8.17, vous devez appeler lexcutable setup.exe situ dans le rpertoire %PS_HOME%\setup\PsExtAPI du serveur dapplications PeopleSoft 8. Notez le nom du rpertoire o vous installez lAPI externe, car vous en aurez besoin lors de linstallation de lagent tendu et lors de la configuration, quand le systme vous demandera le rpertoire PSHome ou le rpertoire racine Cobol. Avant dutiliser lAPI externe, vrifiez votre installation conformment aux instructions de PeopleSoft, laide de lutilitaire jnitest.exe situ dans le rpertoire de lAPI externe. Lutilitaire jnitest.exe vrifie que vous avez MicroSoft Java Virtual Machine for Java 3.2, version 5.00.3167 ou suprieure. Si jnitest.exe dtecte une version acceptable, vous pouvez charger MicroSoft Java Virtual Machine. Sinon, vous pouvez avoir des difficults le charger correctement. LAPI externe ne fonctionnera pas tant que vous naurez pas une version correcte de MicroSoft Java Virtual Machine. Vous devrez galement redmarrer votre poste de travail avant de pouvoir utiliser linstallation de lAPI externe PeopleSoft. Dans le cas contraire, lorsquun travail PeopleSoft sera soumis via ITWS, vous verrez apparatre une fentre (gnre par TVPUPSFT.exe) avec le message suivant :
"The application failed to initialize properly (0xc0000005). Click on OK to terminate the application."

Configuration dun environnement PeopleSoft version 8.4x


Dans le cas de PeopleTools version 8.4x, il nest plus ncessaire dinstaller sparment les API externes de PeopleSoft, celles-ci faisant partie intgrante du client Windows standard ; vous pouvez y accder via le rpertoire racine_PS\bin\client\winx86 du serveur de fichiers PeopleSoft. De plus, conformment lID de rsolution 704309 de PeopleSoft, vous devez : v Pouvoir accder au rpertoire racine_PS\class contenant le fichier psjoa.jar. v Avoir accs une JVM valide.

Chapitre 11. Tches post-installation

75

Remarque : La JVM fournie avec ce produit nest pas valide dans le prsent cas. Vous devez utiliser une JVM prise en charge par PeopleSoft. La mthode psagent.exe se chargera de dfinir/mettre jour les variables denvironnement CLASSPATH et PS_HOME, si elles ne le sont pas dj dans lenvironnement o le travail est lanc. Si votre environnement de variables systme contient dj un accs valide jvm.dll, vous navez pas besoin dy ajouter dautres dtails. Sinon, vous devez spcifier une nouvelle option dans le fichier psagent.opts laide dun diteur de texte, afin que le fichier psagent.exe puisse mettre jour le chemin daccs la JVM. Pour ce faire, ajoutez la ligne suivante au fichier doptions :
TWSXA_PT84_JVMPATH=<chemin daccs jvm.dll>

Les JVM valides sont dj fournies par PeopleSoft avec les serveurs dapplications qui prennent en charge larchitecture PIA, tels que BEA WebLogic Server (dans le sous-rpertoire jdk131\jre\bin\classic ou jdk131\jre\bin\hotspot) ou IBM WebSphere Application Server (dans le sous-rpertoire Java13\jre\bin\classic). Par exemple, vous pouvez mettre jour le fichier doptions laide de lune des commandes suivantes : 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 Si vous navez pas ce mot cl, ni une variable systme valide permettant daccder jvm.dll, vous obtiendrez lun des messages suivants : v AWS140020078E Exception caught in file TVPUPSFT.cpp(#) during function Main v AWS140020076E The problem encountered may be related to the environment settings:
please verify the following: 1) Your path contains a valid Java Virtual Machine directory or options file contains TWSXA_PT84_JVMPATH 2) Your CLASSPATH environment variable contains a valid path to psjoa.jar 3) Your target Application Server is up and running 4) you have defined PS_HOME environment variable

76

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 12. Dfinition des travaux PeopleSoft


Ce chapitre fournit des informations sur la dfinition des travaux utilisant lagent tendu PeopleSoft.

Cration de dfinitions de travaux PeopleSoft dans Tivoli Workload Scheduler


Des dfinitions de travaux Tivoli Workload Scheduler sont requises pour chaque travail PeopleSoft que vous envisagez de contrler. Un travail Tivoli Workload Scheduler est associ un travail PeopleSoft dj dfini ; sa dfinition inclut : v le nom du travail, v le nom du propritaire, v les spcifications de fichier script, v les options de rcupration. Pour plus de dtails, reportez-vous au Chapitre 5, Dfinition des travaux dagent tendu, la page 37.

Paramtres des chanes de tches des travaux PeopleSoft


Cette section dcrit les paramtres des chanes de tches qui rglent lexcution des travaux PeopleSoft. Vous devez les spcifier aux emplacements suivants lorsque vous dfinissez les travaux Tivoli Workload Scheduler qui leurs sont associs : v Dans la zone Commande de la page Tche de la fentre Proprits - Dfinition du travail, si vous utilisez Job Scheduling Console. v En tant quarguments du mot cl scriptname dans linstruction de dfinition du travail, si vous utilisez la ligne de commande Tivoli Workload Scheduler. v En tant quarguments du mot cl JOBCMD dans linstruction JOBREC du fichier SCRIPTLIB de Tivoli Workload Scheduler pour z/OS, si vous planifiez dans un environnement de bout en bout. Notez que, dans ce cas, lintgralit de la chane suivant le mot cl JOBCMD doit figurer entre guillemets (). Le tableau ci-aprs liste les paramtres.
Tableau 12. Paramtres de chane de tches pour les travaux PeopleSoft. Paramtre -operator -process -type Description ID de loprateur PeopleSoft qui lance le travail. Nom du traitement dans le travail PeopleSoft. Type de traitement dans le travail PeopleSoft. Cette entre doit tre place entre guillemets simples (). ID de contrle dexcution du travail PeopleSoft. Destination de la sortie du travail PeopleSoft. Version PeopleTools 7.x, 8.1x 7.x, 8.1x, 8.4x 7.x, 8.1x, 8.4x

-runcontrol -outputdest

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

Copyright IBM Corp. 2000, 2003

77

Tableau 12. Paramtres de chane de tches pour les travaux PeopleSoft. (suite) Paramtre -outputtype Description Type de sortie du travail PeopleSoft. Les valeurs correctes sont les suivantes : 0 (Toutes) 1 (Aucune) 2 (Fichier) 3 (Imprimante) 4 (Fentre) 5 (Courrier lectronique) 6 (Web) 7 (valeur par dfaut) Format de sortie du travail PeopleSoft. Les valeurs correctes sont les suivantes : None CSV DOC Default HP HTM LP OTHER PDF PS RPT RTF SPF TXT WKS XLS Planificateur de traitements PeopleSoft en charge du traitement du travail PeopleSoft. Nom du dossier des rapports utilis pour ce travail. Ce dossier doit dj avoir t cr via le gestionnaire de rapports PeopleSoft. Version PeopleTools 8.1x, 8.4x

-outputformat

8.1x, 8.4x

-runlocationdescr

8.1x, 8.4x

-foldername

8.4x

Remarque : Aucune vrification de syntaxe nest effectue sur les valeurs de contrle des sorties (outputdest, outputtype, outputformat et foldername). Si ces valeurs ne sont pas reconnues, les valeurs par dfaut sont utilises. Voici un exemple dune chane de tches complte dun travail PeopleSoft 8.1x :
-operator PS -process XRFWIN -type SQR Report -runcontrol 1 -runlocationdescr PSNT

Configuration de dpendances OPENS 7.x uniquement


Vous pouvez dfinir des dpendances OPENS Tivoli Workload Scheduler pour les travaux PeopleSoft. Les dpendances OPENS Tivoli Workload Scheduler sont mappes une commande SQL select count avec une clause where adresse la base de donnes PeopleSoft. Cette commande SQL vrifie, en gros, que les

78

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

valeurs slectionnes existent dans la base de donnes. Si les entres spcifies existent dans la base de donnes, le nombre renvoy sera une valeur diffrente de zro et le travail sexcutera. A linverse, si les entres spcifies nexistent pas dans la base de donnes, le nombre renvoy sera zro et le travail ne pourra pas sexcuter. Un rsultat de zro est considr comme faux ; toute autre valeur est considre comme vraie. Remarque : Lorsque vous crez une dpendance OPENS dans Job Scheduling Console, la table est liste sous la zone de texte Fichier et les qualifiants colonne et donnes sont lists dans la zone de texte Qualifiants. Par exemple :
opens /PSSERVERSTAT

se traduit par la commande SQL suivante :


select count(*) from PSSERVERSTAT;

Cette commande renvoie le nombre de lignes dans PSSERVERSTAT. Un rsultat de zro est considr comme faux ; toute autre valeur est considre comme vraie. Voici un autre exemple :
opens /PSSERVERSTAT ("SERVERNAME = PSNT AND SERVERSTATUS = 3")

se traduit par la commande SQL suivante :


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

Cette commande renvoie le nombre de lignes dans PSSERVERSTAT pour le serveur PSNT dont le statut est 3 (en cours dexcution). Pour dfinir une dpendance OPENS pour un travail : 1. Editez le flux de travaux auquel vous voulez ajouter une dpendance OPENS en mode ligne de commande. 2. Ajoutez la chane de commande suivante au travail :
cpu#job opens /table(colonne = donnes)

o : table colonne Spcifie le nom de la colonne que vous recherchez. donnes Spcifie les donnes de cette colonne correspondant votre recherche. 3. Enregistrez les modifications que vous venez deffectuer et fermez le flux de travaux. Remarque : Les donnes que vous recherchez doivent tre places entre des guillemets (). Spcifie le nom de la table PeopleSoft que vous voulez ouvrir.

Chapitre 12. Dfinition des travaux PeopleSoft

79

Exemple de dpendances OPENS


Les flux de travaux suivants illustrent des exemples de dpendances OPENS. Voici un premier exemple :
SCHEDULE PS_CPU#TEST01 ON EVERYDAY : PS_CPU#XRFWIN1 PS_CPU#XRFAPF1 PS_CPU#XRFPNP1 FOLLOWS XRFAPF1 PS_CPU#SYSAUDT1 FOLLOWS XRFWIN1 PS_CPU#PTPTEDT1 OPENS /PSPRCSRQST ("PRCSTYPE = SQR Report AND RUNSTATUS = 9") PS_CPU#XRFILD1 FOLLOWS XRFPNP1,PTPTEDT1 PS_CPU#DDDAUDT1 FOLLOWS PTPTEDT1,TEST02.@ PS_CPU#TLS7011 FOLLOWS TEST02.@,DDDAUDT1 END

Voici un autre exemple :


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

Mappage de statut des travaux IBM Tivoli Workload Scheduler et PeopleSoft


Lorsquun travail PeopleSoft est lanc par Tivoli Workload Scheduler, vous pouvez surveiller sa progression laide de Job Scheduling Console. Les transitions dtat utilises dans IBM Tivoli Workload Scheduler et leurs correspondances dans PeopleSoft sont rpertories ci-dessous.
Statut PeopleSoft CANCEL Statut IBM Tivoli Workload Scheduler CANCEL/ABEND Description Un oprateur PeopleSoft ou la mthode a demand lannulation de la demande de traitement. La mthode agit ainsi en rponse une tche TJ. Un oprateur PeopleSoft a demand la suppression de la demande de traitement. La tentative de lancement a chou pour une raison quelconque. Dans ce cas, la demande de traitement na jamais rellement dmarr lexcution. Le traitement ne peut pas tre lanc, peut-tre en raison de dpendances non respectes. Prt tre lanc.

DELETE

CANCEL

ERROR

FAIL

HOLD

HOLD

QUEUED

READY

80

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Statut PeopleSoft INITIATED PROCESSING CANCELLED SUCCESSFUL NOT SUCCESSFUL

Statut IBM Tivoli Workload Scheduler INIT EXEC CANCEL/ABEND* SUCC ABEND

Description Tentative de lancement. Traitement en cours dexcution. Traitement annul. Excution russie. Echec de lexcution.

Remarques : 1. Les traitements annuls dans PeopleSoft seront abandonns sils taient dj en cours dexcution. Le mappage de statut IBM Tivoli Workload Scheduler doit le reflter. En dautres termes, un traitement annul qui navait pas encore t initialis, aura le statut CANCEL dans Tivoli Workload Scheduler. Un traitement qui avait t initialis aura le statut ABEND. 2. Une demande de traitement dont la suppression a t demande dans le planificateur de traitements ne pourra jamais tre lance. Lenregistrement est, en effet, effac de la table lors dun processus de maintenance normal. En ce qui concerne le traitement jnextday, de telles requtes doivent tre considres comme non existantes.

Chapitre 12. Dfinition des travaux PeopleSoft

81

82

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 4. Mthode daccs R/3

Copyright IBM Corp. 2000, 2003

83

84

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 13. Introduction


IBM Tivoli Workload Scheduler for Applications pour R3 vous permet de crer, planifier et contrler des travaux R/3 grce aux fonctions de planification de Tivoli Workload Scheduler.

Champ dapplication
IBM Tivoli Workload Scheduler for Applications pour R3 vous permet deffectuer les oprations suivantes : v Utiliser les dpendances de travail et les contrles Tivoli Workload Scheduler standard pour les travaux R/3. v Crer des travaux R/3 laide de linterface Tivoli Workload Scheduler. v Planifier des travaux R/3 devant sexcuter des jours et heures spcifiques, dans un ordre dtermin. v Dfinir des interdpendances entre les travaux R/3 et les travaux Tivoli Workload Scheduler sexcutant sur des applications diffrentes, telles que PeopleSoft et Oracle. v Dfinir des interdpendances entre les travaux R/3 et ceux sexcutant sur des plateformes diffrentes. v Dfinir les options de support de langue nationale. v Dfinir comment utiliser les fonctionnalits du support Business Warehouse R/3. v Personnaliser les codes retour dexcution des travaux. v Utiliser les groupes de connexion R/3 pour lquilibrage de la charge et la tolrance aux pannes. v Travailler avec des marques de rservation et des variables R/3. v Exploiter le support dinterface BC-XBP 2.0.

Processus de planification pour lagent tendu R/3


Tivoli Workload Scheduler lance des travaux dans R/3 par lintermdiaire de travaux dfinis pour sexcuter sur un poste de travail dagent tendu Tivoli Workload Scheduler. Un poste de travail dagent tendu R/3 est dfini en tant que poste de travail Tivoli Workload Scheduler hberg par un agent FTA ou un poste de travail principal utilisant la mthode daccs r3batch. Le poste de travail dagent tendu R/3 utilise la mthode daccs r3batch pour transmettre les informations spcifiques au travail R/3 des instances R/3 prdfinies. La mthode daccs utilise les informations fournies dans un fichier doptions, objet dune discussion ultrieure dans ce guide, pour se connecter et lancer des travaux sur une instance R/3. Vous pouvez dfinir plusieurs postes de travail dagent tendu utilisant le mme hte, en paramtrant diffrentes entres ou diffrents fichiers doptions. Les travaux R/3 dfinis dans Tivoli Workload Scheduler doivent correspondre des travaux existant dans lenvironnement R/3. Utilisant le nom dagent tendu R/3 comme une cl, r3batch se base sur le fichier doptions correspondant pour dterminer linstance R/3 qui excutera le travail. Il fait une copie dun modle de travail dans R/3 et le marque comme excutable avec, comme heure de dpart, Dmarrage immdiat. Ensuite, il contrle le travail jusqu son terme, consignant la progression de celui-ci et les informations sur son tat dans une liste de sortie des instances, sur le poste de travail hte.

Copyright IBM Corp. 2000, 2003

85

Pour plus dinformations sur la gestion des travaux, reportez-vous au manuel IBM Tivoli Workload Scheduler - Guide de rfrence SH19-4556.

Support dinterface XBP 2.0


Tivoli Workload Scheduler for Applications pour R3 prend intgralement en charge linterface XBP 2.0. Vous bnficiez ainsi des avantages suivants : v Suivi des travaux enfant. Un travail Tivoli Workload Scheduler reste ltat EXEC jusqu ce que toute son arborescence de travaux R/3 ait t excute. Les journaux des travaux R/3 sont extraits et stocks dans le fichier stdlist de Tivoli Workload Scheduler, avec les listes de spoule de toutes les tapes ABAP. v Interception des travaux R/3. Les travaux planifis par les utilisateurs R/3 peuvent tre intercepts avant leur excution, sur la base des attributs du travail. Un travail de collecte des interceptions est planifi priodiquement sous forme de commande Unix ou Windows. Lors de chaque excution, ce travail collecte les travaux R/3 intercepts et les soumet au plan en cours, sur la base dun modle. v Tous les attributs de travaux sont conservs lors de la rexcution des travaux. Les limitations dues lutilisation danciennes copies de travaux rexcuts, affectant les paramtres darchivage ou dimpression ainsi que la classe de travail, sont supprimes. v Etapes de commande externes. Pour plus de dtails, reportez-vous la section Utilisation du support dinterface XBP 2.0 la page 98.

86

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 14. Installation


Cette section contient des informations sur linstallation dIBM Tivoli Workload Scheduler for Applications pour R3.

Configuration logicielle requise


Pour installer IBM Tivoli Workload Scheduler for Applications pour R3, vous devez excuter les logiciels suivants : v IBM Tivoli Workload Scheduler version 7.0 ou ultrieure, ou IBM Tivoli Workload Scheduler pour z/OS dans un environnement de bout en bout. v R/3 Version 3.1g, 3.1h, 3.1i, 4.0x, 4.5x, 4.6x, 4.7, 6.10 ou 6.20. v Pour les versions antrieures 6.20, le Support Package R/3 appropri, tel quindiqu dans le tableau ci-dessous :
Tableau 13. Support Packages R/3. Versions 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 Notes 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

Remarque : Les notes R/3 399449 et 430087 rsolvent les problmes de paramtres dimpression. Les notes 357924, 517672 et 519137 sont indpendantes de la version.

Gnralits sur linstallation


Cette section prsente les tapes dinstallation de la mthode daccs Tivoli Workload Scheduler for Applications pour R/3. Avant dinstaller la mthode daccs, vrifiez que Tivoli Workload Scheduler est correctement install sur le poste de travail hte. 1. Sur le systme qui hbergera lagent tendu R/3, excutez les tapes suivantes : a. Si la plateforme sur laquelle vous effectuez linstallation est Compaq Tru64, suivez les instructions dcrites la section Installation sur des plateformes Tier2 la page 88. Sinon, suivez les instructions dcrites au Chapitre 2, Installation dIBM Tivoli Workload Scheduler for Applications, la page 5. 2. Installez les modules ABAP r3batch sur le systme R/3. Pour ce faire : a. Connectez-vous linstance R/3 en tant quadministrateur systme de base ou utilisateur disposant des autorisations requises. b. Importez les fichiers de correction et de transfert.

Copyright IBM Corp. 2000, 2003

87

Installation sur des plateformes Tier2


1. Connectez-vous en tant que root et accdez au rpertoire racine_TWS. 2. A partir du CD-ROM dinstallation, extrayez le logiciel : tar xvf chemin_cd/TWS4APPS_R3BATCH_OSF.TAR o chemin_cd reprsente le nom du chemin de lunit de CD-ROM. 3. Vrifiez que r3setup et r3btar.Z ont t extraits dans le rpertoire en cours. 4. Excutez le script r3setup pour dcompresser les fichiers, effectuer linstallation initiale et crer le fichier r3options :
/bin/sh r3setup -new|-update

o : -new spcifie une nouvelle installation. -update spcifie que vous installez sur une version prexistante. Vous serez ensuite invit entrer les informations ci-dessous. Pour plus de dtails, reportez-vous au Chapitre 20, Fichiers doptions de la mthode daccs R/3, la page 119. v Le nom dutilisateur Tivoli Workload Scheduler si celui-ci est diffrent de la valeur par dfaut, savoir maestro. v Le rpertoire o lagent tendu doit tre install (cest--dire le chemin daccs racine_TWS). v Lutilisateur_excution LJuser (par dfaut, maestro). Il sagit du nom de lutilisateur Tivoli Workload Scheduler qui excute r3batch. Ce doit tre un compte UNIX valide. v Lutilisateur_info IFuser (par dfaut, maestro). Il sagit du nom de lutilisateur Tivoli Workload Scheduler qui extrait les informations relatives au travail. IFuser doit tre identique LJuser. v Le type de dfinition des travaux JobDef (par dfaut, r3batch). Il sagit du type dinterface utilis pour la dfinition des travaux Tivoli Workload Scheduler. Vous pouvez choisir : a. r3batch (valeur par dfaut) qui fournit une interface de dfinition des travaux spcifique aux travaux R/3. b. maestrogen ou rien, qui fournit une interface de dfinition des travaux standard, sans zone dentre spcifique R/3. v Le nom de cpu de lhte pour la dfinition de lagent tendu Tivoli Workload Scheduler. v Le nom dhte du serveur dapplications R/3. v Si vous voulez spcifier un hte passerelle R/3 distinct, tapez NO. v LID systme R/3 trois caractres (par exemple, OSS ou TRN). v Le numro dinstance R/3 deux chiffres (par exemple, 00 ou 01). v Le numro de client R/3 trois chiffres (par exemple, 100 ou 900). v LID utilisateur R/3 pour les appels RFC (par exemple, rfcuser). v Le mot de passe associ lID utilisateur RFC R/3. v Le niveau daudit de linterface R/3 (par dfaut, 0). v Si vous souhaitez dfinir la langue de connexion SAP R/3 pour lagent tendu sur ce systme R/3 (par dfaut, No).

88

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

v Si vous souhaitez dfinir une autre instance de lagent tendu. Si vous agrez, vous serez invit fournir un autre jeu de paramtres. Une entre supplmentaire est insre dans le fichier doptions R/3. 5. Ouvrez Tivoli Job Scheduling Console ou le programme Composer et crez une dfinition de poste de travail dans Tivoli Workload Scheduler pour chaque instance de R/3.

Chiffrement des mots de passe utilisateur R/3


Lorsque vous ajoutez des entres votre fichier doptions, la valeur de r3pass est automatiquement code avant dtre crite dans le fichier. Si vous modifiez le fichier avec un diteur de texte, vous devez excuter le programme enigma pour chiffrer le mot de passe avant de lcrire dans le fichier. Pour ce faire, excutez la commande suivante : enigma [mot_de_passe] Vous pouvez inclure le mot de passe dans la ligne de commande ou lentrer en rponse une invite. Le programme renvoie une version code que vous pouvez alors entrer dans le fichier doptions.

Chapitre 14. Installation

89

90

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 15. Configuration de lenvironnement R/3


Pour communiquer et contrler lexcution des travaux sur des systmes R/3 laide de la mthode daccs pour R/3, vous devez excuter les tapes de configuration suivantes sur lenvironnement R/3. Les tapes dcrites dans ce chapitre requirent un administrateur systme de base R/3.

Prsentation
Vous trouverez, ci-aprs, un rsum de la procdure de personnalisation : 1. Cration dun nouvel ID utilisateur RFC dans R/3 pour Tivoli Workload Scheduler. 2. Cration du profil dautorisation, comme dcrit la section Cration du profil dautorisation pour lutilisateur Tivoli Workload Scheduler. 3. Copie des fichiers de correction et de transfert, du serveur Tivoli Workload Scheduler vers le serveur R/3. 4. Importation des fichiers de correction et de transfert dans R/3 et vrification de linstallation. Remarque : La procdure dimportation ajoute uniquement de nouveaux modules fonctionnels ABAP/4 et de nouvelles tables internes au systme R/3. Elle ne modifie pas les objets existants.

Cration de lutilisateur RFC pour IBM Tivoli Workload Scheduler


Pour que Tivoli Workload Scheduler puisse communiquer avec R/3, vous devez crer un ID utilisateur dans R/3 pour le traitement par lots Tivoli Workload Scheduler. Pour des raisons de scurit, utilisez plutt un nouvel ID utilisateur quun ID existant. 1. Crez un nouvel ID utilisateur RFC. 2. Attribuez ce nouvel ID utilisateur RFC les attributs suivants : v Un type utilisateur CPIC ou Communications, en fonction de la version de R/3. v Un mot de passe dune longueur dau moins six caractres. Tivoli Workload Scheduler requiert ce mot de passe pour dmarrer et contrler les travaux R/3. Si ce mot de passe est modifi dans R/3, vous devrez mettre jour le fichier doptions utilis par r3batch en consquence. v Attribuez les profils de scurit appropris, en fonction de votre version de R/3.

Cration du profil dautorisation pour lutilisateur Tivoli Workload Scheduler


Vous pouvez utiliser lune des deux mthodes ci-aprs pour excuter cette tche : v Utiliser la transaction SU02 et crer manuellement le profil. v Utiliser le gnrateur de profils (transaction PFCG).

Copyright IBM Corp. 2000, 2003

91

Utilisation de la transaction SU02 pour la cration manuelle du profil


Procdez comme suit : 1. Saisissez un nom de profil, par exemple Z_TWS, et une description. 2. Ajoutez manuellement les autorisations conformment la table suivante :
Objet S_ADMI_FCD S_BTCH_ADM Description Autorisations systme Autorisation S_ADMI_ALL

Traitement en arrire-plan : S_BTCH_ADM Administrateur du traitement en arrire-plan Traitement en arrire-plan : S_BTCH_ALL Oprations sur des travaux en arrire-plan Traitement en arrire-plan : S_BTCH_ALL Nom de lutilisateur darrire-plan ABAP : Contrles de lexcution du programme Contrle des autorisations pour laccs RFC Spoule : Actions Spoule : Autorisations des priphriques S_ABAP_ALL

S_BTCH_JOB

S_BTCH_NAM

S_PROGRAM

S_RFC S_SPO_ACT S_SPO_DEV S_XMI_LOG S_XMI_PROD

S_RFC_ALL S_SPO_ALL S_SPO_DEV_AL

Autorisations daccs S_XMILOG_ADM interne pour le journal XMI Autorisation pour les interfaces de gestion externes (XMI) S_XMI_ADMIN

Les autorisations sont situes dans la classe dobjets Systme de base : Administration. En fonction de la version de R/3, il est possible que lautorisation S_RFC_ALL se trouve dans la classe Objets dautorisation inter-applications ou Objets dautorisation non spcifiques de lapplication. 3. Enregistrez le profil. 4. Accdez la fentre de gestion des utilisateurs et attribuez le profil lutilisateur R/3 Tivoli Workload Scheduler. 5. Enregistrez les donnes utilisateur.

Utilisation de la transaction PFCG (Gnrateur de profils)


Procdez comme suit : 1. Entrez un nom, par exemple ZTWS, dans Nom du rle. 2. Cliquez sur Crer rle et tapez une description du rle, par exemple, Rle de lutilisateur TWS. 3. Enregistrez le rle. 4. Slectionnez longlet Autorisations. 5. Cliquez sur Modifier donnes dautorisation. 6. Dans la fentre suivante, slectionnez Modles.

92

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

7. Ajoutez manuellement les objets dautorisation suivants :


Objet S_ADMI_FCD 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 Description Autorisations systme Traitement en arrire-plan : Administrateur du traitement en arrire-plan Traitement en arrire-plan : Oprations sur des travaux darrire-plan Traitement en arrire-plan : nom de lutilisateur darrire-plan ABAP : Contrles de lexcution du programme Contrle des autorisations pour laccs RFC Spoule : Actions Spoule : Autorisations des priphriques Autorisations daccs interne pour le journal XMI Autorisation pour les interfaces de gestion externes (XMI)

8. Entrez les valeurs conformment au schma suivant :


S_ADMI_FCD Autorisations systme v Fonction dadministration systme : Autorisation globale S_BTCH_ADM Traitement en arrire-plan : Administrateur du traitement en arrire-plan v ID administrateur du traitement en arrire-plan : Autorisation globale S_BTCH_JOB Traitement en arrire-plan : Oprations sur des travaux darrire-plan v Oprations sur les travaux : Autorisation globale v Rcapitulatif des travaux dun groupe : Autorisation globale S_BTCH_NAM Traitement en arrire-plan : Nom de lutilisateur darrire-plan v Nom de lutilisateur darrire-plan pour le contrle des autorisations : Autorisation globale S_PROGRAM ABAP : Contrles de lexcution du programme v Programme ABAP/4 sur les actions utilisateur : Autorisation globale v Programme ABAP/4 sur les groupes dautorisations : Autorisation globale S_RFC Contrle des autorisations pour laccs RFC v Activit : Autorisation globale v Nom du RFC protger : Autorisation globale v Type dobjet RFC protger : Autorisation globale

Chapitre 15. Configuration de lenvironnement R/3

93

S_SPO_ACT

Spoule : Actions v Zone dautorisation pour les actions de spoule : Autorisation globale v Valeur pour le contrle des autorisations : Autorisation globale

S_SPO_DEV

Spoule : Autorisations des priphriques v Spoule - Noms de priphrique longs : Autorisation globale

S_XMI_LOG

Autorisations daccs interne pour le journal XMI v Mthode daccs pour le journal XMI : Autorisation globale

S_XMI_PROD

Autorisation pour les interfaces de gestion externes (XMI) v Journalisation XMI - Nom de lentreprise : TIVOLI* v Journalisation XMI - Nom du programme : MAESTRO* v ID interface : Autorisation globale

9. Enregistrez les autorisations. 10. Gnrez un profil. Utilisez le mme nom que celui que vous avez entr dans la zone Nom du rle. 11. Fermez la fentre de gestion des autorisations et slectionnez longlet Utilisateur. 12. Ajoutez lutilisateur Tivoli Workload Scheduler au rle. 13. Enregistrez le rle.

Copie des fichiers de correction et de transfert


Le fichier dinstallation charge deux fichiers de correction et de transfert dans le rpertoire de base Tivoli Workload Scheduler. Vous devez copier ces fichiers sur le serveur R/3 et les importer dans la base de donnes R/3, comme suit : 1. Sur le serveur de base de donnes R/3, connectez-vous votre systme R/3 en tant quadministrateur. 2. Copiez le fichier de commandes et le fichier de donnes, du rpertoire racine_TWS \methods vers les rpertoires de votre serveur de base de donnes R/3 suivants : copiez fichier_commandes /usr/sap/trans/cofiles/ copiez fichier_donnes /usr/sap/trans/data/ Les noms fichier_commandes et fichier_donnes varient dune version lautre. Les fichiers sont installs dans le rpertoire racine_TWS\methods et ont les noms de fichier et format suivants : K000xxx.TV1 (fichier de commandes) et R000xxx.TV1 (fichier de donnes), o xxx est une valeur fonction de la version.

Importation de modules ABAP/4 dans R/3


Cette procdure gnre, active et valide de nouveaux modules fonctionnels ABAP/4 sur votre systme R/3 ainsi que de nouvelles tables internes. Aucun objet systme R/3 existant nest modifi. 1. Accdez au rpertoire suivant :
cd /usr/sap/trans/bin

94

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

2. Ajoutez le fichier de transfert au tampon : tp addtobuffer sid transfert o : transfert reprsente le fichier de demande de transfert. sid reprsente votre ID systme R/3. Sous le rpertoire racine_TWS\methods, se trouve fichier nomm K000xxx.TV1 ; la demande de transfert est donc tv1K000xxx. 3. Excutez la commande tp tst pour tester limportation : tp tst sid transfert Aprs lexcution de cette commande, consultez les messages derreur des fichiers journaux dans le rpertoire /user/sap/trans/log. Les avertissements dun niveau de svrit 4 sont normaux. Sil y a des erreurs, demandez lavis dune personne exprimente en matire de correction et de transfert, ou essayez dutiliser les modes inconditionnels pour effectuer limportation. 4. Excutez la commande suivante pour importer tous les fichiers dans le tampon : tp import sid transfert Cette commande gnre les nouveaux modules ABAP/4 et les valide dans la base de donnes R/3. Ils sont automatiquement activs. Aprs lexcution de cette commande, consultez les messages derreur des fichiers journaux dans le rpertoire /user/sap/trans/log. Les avertissements dun niveau de svrit 4 sont normaux. Si vous rencontrez un problme, utilisez un mode inconditionnel pour excuter cette tape : tp import sid transfert U126 5. Une fois la procdure termine, examinez les fichiers journaux pour vrifier que limportation a russi. Les fichiers journaux se trouvent dans le rpertoire /usr/sap/trans/log.

Installation des modules ABAP r3batch sur le systme R/3


Installez les modules ABAP r3batch sur le systme R/3. Pour plus de dtails sur linstallation des modules ABAP r3batch, reportez-vous au Chapitre 15, Configuration de lenvironnement R/3, la page 91. Ce chapitre contient des instructions pour la cration dun utilisateur RFC et linstallation des modules ABAP suivants :
J_1O1_BDC_STATUS J_1O1_DATE_TIME J_1O1_JOB_ABAP_STEP_MODIFY J_1O1_JOB_ADD_ABAP_STEP J_1O1_JOB_ADD_EXTPGM_STEP J_1O1_JOB_CLOSE J_1O1_JOB_COPY J_1O1_JOB_DEFINITION_GET J_1O1_JOB_DELETE J_1O1_JOB_EXTPGM_STEP_MODFY J_1O1_JOB_FIND J_1O1_JOB_FINDALL J_1O1_JOB_HAS_EXTENDED_VARIANT J_1O1_JOB_LOG J_1O1_JOB_LOG_READ
Chapitre 15. Configuration de lenvironnement R/3

95

J_1O1_JOB_OPEN J_1O1_JOB_START J_1O1_JOB_STATUS J_1O1_JOB_STATUS_CHECK J_1O1_JOB_STOP J_1O1_RAISE_EVENT J_1O1_REPORT_ALL_SELECTIONS J_1O1_REPORT_DYNSEL_GET_DEF J_1O1_REPORT_GET_TEXTPOOL J_1O1_TABLE_GET_NAMETAB J_1O1_VARIANT_COPY J_1O1_VARIANT_COPY_4X J_1O1_VARIANT_CREATE J_1O1_VARIANT_CREATE_NEW 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

Identification et rsolution des incidents


Si vous ne pouvez pas soumettre de travaux R/3 via Tivoli Workload Scheduler aprs avoir configur R/3, effectuez les tests suivants : v Vrifiez que vous pouvez excuter une commande Ping sur le systme R/3 partir du systme Tivoli Workload Scheduler. Ceci prouvera une connectivit rseau de base. v Notez que lutilisation de routeurs R/3 pour accder au systme R/3 peut excder la taille des tampons internes de la bibliothque RFC utilise pour stocker le nom dhte du systme R/3. Si tel est le cas, le nom dhte est tronqu, ce qui entrane lchec de la connexion R/3. Pour contourner ce problme, nutilisez pas le nom qualifi complet des routeurs R/3, ou utilisez les adresses IP. v Utilisez la commande telnet suivante pour vrifier la connectivit : telnet nom_systme 33xx o nom_systme correspond au nom du systme ou ladresse IP du serveur R/3 et xx correspond linstance R/3. v Connectez-vous R/3 en tant quadministrateur et vrifiez que lutilisateur RFC Tivoli Workload Scheduler (cr la section Cration de lutilisateur RFC pour IBM Tivoli Workload Scheduler la page 91) existe. v Crez un nouveau travail IBM Tivoli Workload Scheduler excuter sous R/3 et ajoutez les options avances suivantes :
-debug -trace

Vous pouvez slectionner ces options via les boutons doption correspondant dans la page Proprits - Dfinition du travail de Job Scheduling Console. Loption -debug permet dinclure des informations de dbogage supplmentaires dans le fichier stdlist du travail (dans Tivoli Workload Scheduler).

96

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Lorsque vous utilisez loption -trace, un fichier de trace est cr dans le rpertoire de base Tivoli Workload Scheduler. Sous UNIX, ce fichier sappelle dev_rfc, sous Windows, il sappelle rfcxxxxx_xxxxx.trc. Veillez supprimer loption -trace du travail aprs avoir excut les procdures de dbogage. Le fichier de trace peut, en effet, devenir trs volumineux et ingrable. Remarque :En rgle gnrale, ces options sont destines au dbogage de lagent tendu et ne doivent pas tre utilises dans la production standard. v Si, pour une raison quelconque, la passerelle R/3 tronque la chane de connexion, remplacez le nom IP par ladresse IP. v Si vous effectuez linstallation sur un systme AIX qui nutilise pas langlais U.S., vous devez installer lenvironnement de langue U.S. sur le poste de travail IBM Tivoli Workload Scheduler et sur celui hbergeant la base de donnes R/3. Sinon, lerreur BAD TEXTENV (ou un message derreur similaire) apparatra dans le fichier de trace dev_rfc et les connexions R/3 choueront.

Modification du mot de passe de lID utilisateur RFC au niveau de Tivoli Workload Scheduler
Si le mot de passe de lID utilisateur RFC Tivoli Workload Scheduler a t modifi aprs linstallation initiale, le fichier doptions utilis par r3batch doit tre mis jour en consquence. Sous UNIX, connectez-vous en tant que root au systme o Tivoli Workload Scheduler est install. Sous Windows, connectez-vous en tant quadministrateur et ouvrez un shell DOS sur le systme o Tivoli Workload Scheduler est install, en procdant comme suit : 1. Gnrez une version code du nouveau mot de passe en excutant la commande enigma dans racine_TWS/methods. Pour ce faire, tapez dans le shell de commandes : enigma nouveau_mot o nouveau_mot correspond au nouveau mot de passe de lID utilisateur RFC Tivoli Workload Scheduler. La commande enigma renvoie une version code du mot de passe. 2. Copiez le mot de passe cod dans le fichier doptions qui se trouve dans le rpertoire racine_TWS/methods. Ce fichier peut tre modifi dans un nimporte quel diteur de texte. Veillez recopier le mot de passe correctement, en respectant les majuscules, les minuscules et les signes de ponctuation. Voici un exemple de mot de passe cod :
#TjM-pYm#-z82G-rB

Si le mot de passe cod est mal saisi, Tivoli Workload Scheduler ne pourra ni lancer, ni contrler les travaux par lots R/3.

Migration partir de versions prcdentes


Cette version de lagent tendu Tivoli Workload Scheduler pour R/3 prend en charge toutes les versions R/3 listes au tableau 13 la page 87. Pour rpondre aux exigences de la certification XBP R/3 intgre aux versions 4.0 et 4.5 de R/3, quelques modifications ont t apportes lagent de planification. Lagent tendu
Chapitre 15. Configuration de lenvironnement R/3

97

Tivoli Workload Scheduler pour R/3 version 4.x utilise les interfaces officielles RFC R/3 pour la planification des travaux, savoir : v Linterface SXMI_XBP pour les versions 3.1g 4.0x de R/3 ; v Linterface BAPI_XBP partir de la version 4.5a. Pour viter les conflits avec dautres fournisseurs, les modules ABAP pour Tivoli Workload Scheduler appartiennent dsormais lespace annuaire J_1O1_xxx des partenaires Tivoli Workload Scheduler. Ds que les procdures dimportation dcrites la section Importation de modules ABAP/4 dans R/3 la page 94 ont t excutes, les modules de fonction RFC J_1O1_xxx sont installs sur votre systme. Si vous avez dj install lagent tendu Tivoli Workload Scheduler pour R/3 sur votre systme, vous pouvez supprimer les modules suivants de votre systme R/3 :
Z_MAE2_BDC_STATUS Z_MAE2_DATE_TIME Z_MAE2_JOB_COPY Z_MAE2_JOB_DELETE Z_MAE2_JOB_FIND Z_MAE2_JOB_FINDALL Z_MAE2_JOP_OPEN Z_MAE2_JOB_LOG Z_MAE2_JOB_START Z_MAE2_JOB_STATUS Z_MAE2_JOB_STOP

Il sagit danciennes versions des modules ABAP Tivoli, qui appartiennent lespace annuaire de lutilisateur. Vous pouvez galement supprimer le groupe fonctionnel YMA3. Il nest pas obligatoire de supprimer ces lments, mais vous pouvez le faire pour nettoyer votre systme.

Utilisation du support dinterface XBP 2.0


Linterface SAP pour la planification des travaux externes (BC-XBP) a t rcemment tendue de manire remdier aux limitations mises en vidence par les clients et les partenaires. Elle est fournie par Basis Support Packages pour toutes les versions de R/3, compter de WAS 4.6B. Les limitations suivantes ont t supprimes : v La classe de travail nest plus limite C, v Tous les paramtres dimpression sont disponibles. Les fonctionnalits suivantes ont t ajoutes : v Relation parent-enfant, v Interception des travaux, v Prise en charge des travaux laide dtapes de commandes externes. Consultez et appliquez les notes SAP suivantes avant dutiliser linterface XBP 2.0: v 602683 v 612564 v 604496

98

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Cration du profil dautorisation pour lutilisateur Tivoli Workload Scheduler


Il existe deux mthodes pour ajouter lobjet dautorisation correspondant au profil dautorisations de lutilisateur Tivoli Workload Scheduler : v Utilisation de la transaction SU02, v Utilisation du gnrateur de profils.

Utilisation de la transaction SU02


Ajoutez lobjet suivant :
Objet S_RZL_ADM Description CCMS : Administration systme Autorisation S_RZL_ALL

Utilisation du gnrateur de profils


Procdez de la manire suivante : 1. Ajoutez manuellement lobjet suivant :
Objet S_RZL_ADM Description CCMS : Administration systme

2. Attribuez la zone Activit la valeur Autorisation globale.

Incidents dus aux paramtres dimpression et la classe de travail


Lagent tendu R/3 utilise les interfaces RFC officielles des versions R/3 4.x 6.20 pour la planification des travaux. Lorsque vous migrez de prcdentes versions de R/3, il peut y avoir des problmes au niveau des paramtres dimpression dans les travaux lancs par Tivoli Workload Scheduler, et ce, en raison des limitations dues aux interfaces RFC. Ces limitations nexistent plus avec XBP 2.0. Le tableau ci-aprs indique les paramtres dimpression pris en charge par BAPI XBP 1.0.
Paramtre dimpression unit de sortie impression immdiate suppression aprs sortie nombre de copies mode darchivage autorisation slection de la page de garde page de garde SAP priode de rtention du spoule 4.5x et ultrieure 3.1x U U U U U U x U U 4.0x U U U U U U U U U U U U U U U U U U

Chapitre 15. Configuration de lenvironnement R/3

99

Paramtre dimpression destinataire lignes colonnes

4.5x et ultrieure 3.1x x x x 4.0x x x x U U U

Pour rsoudre la perte des paramtres dimpression durant la copie dun travail, installez le Support Package R/3 appropri comme indiqu dans les notes R/3 399449 et 430087. Il en va de mme pour la classe de travail. Les interfaces R/3 officielles ne prennent en charge que les travaux de la classe C. Linstallation du Support Package R/3 rsout galement cet incident.

100

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 16. Dfinition des travaux dagent tendu R/3


Pour contrler lexcution de travaux sur un poste de travail R/3 partir de Tivoli Workload Scheduler, vous devez dfinir : v Des travaux R/3 que vous voulez excuter sous le contrle de Tivoli Workload Scheduler. Vous pouvez dfinir ces travaux laide des outils R/3 standard ou des fentres SAP de Job Scheduling Console. v Des travaux Tivoli Workload Scheduler qui correspondent des travaux R/3. Les dfinitions de travaux Tivoli Workload Scheduler sont utilises pour la planification et la dfinition des dpendances, mais ce sont les travaux R/3 qui sont excuts.

Dfinition dun travail dans R/3


Pour crer des travaux R/3 contrls par Tivoli Workload Scheduler, vous pouvez utiliser : v les outils R/3 standard pour la dfinition des travaux, ou v les fentres SAP de Job Scheduling Console. Reportez-vous la documentation R/3 pour plus dinformations sur la cration des travaux avec les outils R/3. Lorsque vous crez des travaux dans R/3, ne spcifiez ni lheure de dbut, ni leurs dpendances. Ces paramtres sont spcifis et contrls dans Tivoli Workload Scheduler. Le travail est identifi dans Tivoli Workload Scheduler par son nom et son ID de travail R/3. Le mme travail peut tre planifi pour tre excut plusieurs reprises par Tivoli Workload Scheduler, sans quil y ait besoin de le redfinir chaque fois dans R/3. Remarque : Pour les travaux R/3 contrls par Tivoli Workload Scheduler, la sortie dans le journal des travaux R/3 se trouve sous le nom dutilisateur dfini dans loption r3user du fichier doptions.

Dfinition dun travail dans Tivoli Workload Scheduler


Pour dfinir un travail Tivoli Workload Scheduler, vous pouvez utiliser : v Tivoli Job Scheduling Console. v La ligne de commande Tivoli Workload Scheduler. v Les botes de dialogue ISPF de Tivoli Workload Scheduler pour z/OS, si vous envisagez de planifier le travail dans un environnement de bout en bout. Pour plus de dtails, reportez-vous au Chapitre 5, Dfinition des travaux dagent tendu, la page 37. Les procdures dcrites au Chapitre 5, Dfinition des travaux dagent tendu, la page 37 sont communes tous les agents tendus Tivoli Workload Scheduler. Lagent tendu pour R/3 propose une procdure supplmentaire via Job Scheduling Console. Dans Job Scheduling Console, lorsque vous slectionnez le type de tche pour une nouvelle dfinition de travail, vous pouvez choisir entre deux types :

Copyright IBM Corp. 2000, 2003

101

Tche dagent tendu Ce type de tche est commun tous les agents tendus. Si vous choisissez cette option : v Le travail R/3 associ doit tre dj dfini dans la base de donnes R/3 et vous devez connatre son nom. v Vous pouvez utiliser la zone Commande dans lune des fentres de dfinition du travail pour entrer les paramtres ncessaires lexcution du travail R/3. v Les postes de travail dagent tendu que vous avez dfinis pour R/3 (en spcifiant r3batch comme mthode daccs) sont lists comme postes de travail gnriques dagent tendu. SAP Ce type de tche est spcifique aux travaux dagent tendu R/3. Si vous choisissez cette option : v Vous pouvez dfinir ou mettre jour le travail R/3 ainsi que les variables SAP ou les paramtres dexcution du travail partir des fentres Job Scheduling Console, comme si vous opriez dans R/3. v Les postes de travail dagent tendu R/3 sont considrs comme des postes de travail R/3. Ils napparaissent pas dans les listes de postes de travail gnriques dagent tendu qui saffichent lorsque vous cliquez sur les points de suspension en regard de la zone Poste de travail. Vous devez connatre le nom pour pouvoir lentrer dans la zone.

Pour que SAP soit affich comme tche optionnelle dans Job Scheduling Console, vous devez attribuer la valeur r3batch loption jobdef dans le fichier doptions r3batch.opts (situ dans le sous-rpertoire methods de racine_TWS) du poste matre Tivoli Workload Scheduler. Pour savoir comment dfinir un travail dagent tendu R/3 via les fentres Tche dagent tendu, reportez-vous au Chapitre 5, Dfinition des travaux dagent tendu, la page 37. Pour savoir comment dfinir un travail dagent tendu R/3 via les fentres de tche SAP, accdez la section suivante.

Utilisation des fentres SAP de Job Scheduling Console


Pour crer une dfinition de travail R/3 dans la base de donnes Tivoli Workload Scheduler, excutez les tapes suivantes : 1. Dans la liste Actions de la fentre principale de Job Scheduling Console, slectionnez Nouvelle dfinition de travail. 2. Slectionnez un moteur Tivoli Workload Scheduler et, dans la liste affiche, cliquez sur SAP. La fentre Proprits - Dfinition du travail saffiche.

102

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Figure 26. Fentre Proprits - Dfinition du travail

3. Dans la page Gnral, dfinissez le travail Tivoli Workload Scheduler qui pilotera le travail R/3. Renseignez les zones suivantes : a. Dans la zone Nom, entrez un nom Tivoli Workload Scheduler pour le travail R/3. Ce nom peut contenir jusqu huit caractres alphanumriques, ou quarante si vous utilisez une base de donnes tendue. Il doit commencer par une lettre. b. Dans la zone Poste de travail, cliquez sur les points de suspension (...) pour ouvrir une fentre de recherche et slectionnez un poste de travail disponible. c. Dans la zone Description, entrez une description du travail. Il sagit dune zone optionnelle qui peut comporter jusqu 64 caractres alphanumriques. d. Dans la zone Connexion, entrez lID de connexion Tivoli Workload Scheduler utilis pour excuter le travail. e. Cliquez sur Ajouter un paramtre pour ajouter des paramtres prdfinis lID de connexion. f. Dans les zones Options de rcupration, spcifiez les options de rcupration pour le travail R/3. Pour plus de dtails sur les options de rcupration, reportez-vous au manuel IBM Tivoli Workload Scheduler - Guide de rfrence. 4. Slectionnez Tche. La page Tche saffiche.

Chapitre 16. Dfinition des travaux dagent tendu R/3

103

Figure 27. Proprits - Dfinition du travail : Tches

Cette page vous permet de fournir des informations sur le travail R/3 qui sera gr par le travail Tivoli Workload Scheduler dfini la page prcdente. Vous pouvez galement utiliser cette page pour crer des travaux R/3 standard (mais non des InfoPackages ou des chanes de processus) dans le systme SAP. 5. Pour spcifier un travail R/3 existant : a. Dans la page Tche, spcifiez le type de travail et cliquez sur les points de suspension ...) en regard de la zone Nom du travail. La fentre Liste de rquisition SAP apparat. b. Utilisez la liste de rquisition pour trouver et slectionner un travail R/3 et cliquez sur OK. Les informations sur le travail sont affiches dans les zones de la page Tche prcdente : v zone Nom du travail, v zone ID de travail, v bouton Type de travail R/3. Si le type de travail est Travail R/3 standard, vous pouvez le modifier et afficher ses dtails et son statut. Si le type de travail est Business Warehouse InfoPackage ou Chane de processus, vous ne pouvez afficher que ses dtails. 6. Pour crer un travail R/3 standard : a. Dans la page Tche, slectionnez Travail R/3 standard et cliquez sur Nouveau. La page Travail R/3 de la fentre Dfinition du travail SAP saffiche.

104

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Figure 28. Page Travail R/3 de la fentre Dfinition du travail SAP.

b. Dans la page Travail R/3, entrez les informations relatives au travail crer : 1) Entrez le nom du travail dans la zone Nom du travail. 2) Laissez la zone ID du travail vide. Un ID sera attribu par le systme R/3 lorsque vous enregistrerez la dfinition du travail. 3) Tapez le nom du poste de travail R/3 o ce travail doit sexcuter dans la zone Hte cible. 4) Cliquez sur Etapes pour accder la page suivante.

Chapitre 16. Dfinition des travaux dagent tendu R/3

105

Figure 29. Page Etapes de la fentre Dfinition du travail SAP.

c. Dans la page Etapes, vous pouvez spcifier un ou plusieurs module(s) ABAP ou des programme externe pour le travail R/3. Rptez les tapes suivantes autant de fois que vous avez dtapes dfinir : 1) Cliquez sur le bouton Ajouter une ligne pour ajouter une ligne la table des tapes. 2) Double-cliquez dans la zone Type et choisissez sil sagit dun module ABAP ou dun programme externe. 3) Dans la zone Nom, entrez le nom dun module ABAP ou le chemin complet dun programme externe. 4) Dans la zone Utilisateur, entrez le nom de lutilisateur R/3 qui excute cette tape. 5) si ncessaire, dans la zone Var/Parm, entrez un nom de variable ou un paramtre. Les variables sont utilises avec les modules ABAP, et les paramtres avec les programmes externes, mais tous deux sont facultatifs. Certains modules ABAP ne requirent pas de variables, tout comme certains programmes externes ne requirent pas de paramtres. Des points de suspension (...) sont disponibles en regard de la zone. Ils

106

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

permettent dafficher la liste des variables associes au module ABAP. Vous pouvez utiliser cette liste pour slectionner une variable ou pour crer ou modifier des dfinitions de variables. Reportez-vous la section Dfinition ou mise jour des variables R/3 dans Job Scheduling Console pour plus de dtails. 6) Dans la zone Hte cible, entrez le poste de travail R/3 o doit sexcuter cette tape. Les htes cible ne sont obligatoires que pour les programmes externes. 7) Entrez les spcifications des paramtres dimpression et des indicateurs de contrle, conformment aux exigences de R/3. d. Une fois que vous avez paramtr les diffrentes tapes de module ABAP ou de programme externe, cliquez sur OK. La dfinition du travail R/3 est alors enregistre dans la base de donnes R/3 et la fentre se ferme. Si le travail R/3 a t correctement enregistr dans la base de donnes R/3, la page Tche de la fentre Proprits - Dfinition du travail doit prsent afficher un ID de travail R/3. 7. Cliquez sur OK dans la fentre Proprits - Dfinition du travail pour enregistrer la dfinition du travail dans la base de donnes Tivoli Workload Scheduler.

Dfinition ou mise jour des variables R/3 dans Job Scheduling Console
Si vous cliquez sur les points de suspension en regard de la zone Var/Parm dans la fentre Dfinition du travail SAP, la fentre Liste des variantes apparat. Cette fentre liste toutes les variables associes au module ABAP indiqu dans la zone Nom de la fentre Dfinition du travail SAP et ressemble celle reprsente ci-dessous.

Figure 30. Fentre Liste des variantes.

Dans cette fentre, en plus des autres actions, vous pouvez crer ou mettre jour des variables. Pour ce faire, cliquez sur Nouveau ou sur Editer. Une fentre Cadre
Chapitre 16. Dfinition des travaux dagent tendu R/3

107

de variante, similaire celle illustre ici, souvre (si vous tes en phase de modification, les zones et les slections ne seront pas vides) :

Figure 31. Page Informations sur la variante de la fentre Liste des variantes.

Dans la page Informations sur la variante, procdez comme suit : 1. Entrez/modifiez le nom et la description de la variable. 2. Si ncessaire, dans la zone Proprits, cochez lune des cases suivantes : Arrire-plan La variable ne peut tre utilise que dans un traitement en arrire-plan. Protg La variable ne peut tre modifie par aucun autre utilisateur. Invisible La variable napparatra pas dans la liste appele par la touche F4, dans linterface utilisateur SAP. Etendu Autorise lutilisation de marques de rservation et de compteurs comme variables. Si vous cochez cette case, le bouton Compteur devient actif. Pour les variables tendues, vous pouvez utiliser des marques de rservation et des compteurs qui liminent le rglage des valeurs comportant souvent des erreurs et rduisent considrablement la gestion des variables. Les marques de rservation et les compteurs sont traits lavance par Tivoli Workload Scheduler et les valeurs sont automatiquement ajustes lorsque le travail est lanc. Les marques de rservation et les compteurs pris en charge sont les suivants :
Tableau 14. Marques de rservation et compteurs pour les variables tendues. Symbole $S $D $_D $M $Y $_Y Signification Horodatage Jour du mois Date Mois Anne Anne Syntaxe AAAAMMJJHHMM JJ AAAAMMJJ MM AA AAAA

108

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 14. Marques de rservation et compteurs pour les variables tendues. (suite) Symbole $H $T $_T $Nx $(expression_date) $[expression_arithmtique] Signification Heure Minute Heure Compteurs Expression date Expression arithmtique Syntaxe HH MM HHMMSS 10 compteurs : $N0 - $N9 ($N = $N0) Identique commande datecalc, au format $(...). Expressions arithmtiques autorisant des oprations +, , * et / entre des entiers et des compteurs.

Dans la page Valeurs de variante, les zones et les valeurs sont cres de manire dynamique par r3batch en fonction des caractristiques de la variable ou de ltape et sont identiques celles contenues dans la fentre SAP quivalente.

Paramtres de chane de tches pour les travaux R/3


Cette section dcrit les paramtres des chanes de tches qui grent lexcution des travaux R/3. Vous devez les spcifier aux emplacements suivants lorsque vous dfinissez les travaux Tivoli Workload Scheduler qui leur sont associs : v Dans la zone Commande de la page Tche de la fentre Proprits - Dfinition du travail, si vous utilisez Job Scheduling Console et slectionnez Tche dagent tendu (et non SAP) lors de la dfinition dun nouveau travail. v En tant quarguments du mot cl SCRIPTNAME dans linstruction de dfinition du travail, si vous utilisez la ligne de commande Tivoli Workload Scheduler. v En tant quarguments du mot cl JOBCMD dans linstruction JOBREC du fichier SCRIPTLIB de Tivoli Workload Scheduler pour z/OS, si vous planifiez dans un environnement de bout en bout. La syntaxe de la chane est la suivante :
-job nom_travail ( -user nom_utilisateur | -i (id_travail|ipack_|pchain_) ) [-client client_dfinition] [-exec_client client_excution] [-debug] [-trace]

Ces paramtres sont dcrits dans le tableau ci-aprs.


Tableau 15. Paramtres de chane de tches pour les travaux R/3. Paramtre -job nom_travail Description Nom de la tche excuter. Il sagit soit dun de nom de travail R/3, dun nom de zone technique InfoPackage ou dun nom de chane de processus (ProcessChain). Ce paramtre est obligatoire. Utilisateur R/3 propritaire du travail cible. Ce paramtre ne peut tre utilis que lorsque le systme R/3 cible na quun seul travail du nom spcifi, pour lutilisateur spcifi. Il na aucun effet sur des travaux de type InfoPackage ou ProcessChain, ni si un ID de travail a t spcifi dans la dfinition du travail.
Chapitre 16. Dfinition des travaux dagent tendu R/3

-user nom_utilisateur

109

Tableau 15. Paramtres de chane de tches pour les travaux R/3. (suite) Paramtre -i id_travail Description Lun des ID suivants : v ID de travail R/3 unique, si le travail cible est un travail standard. v ipack_, si le travail cible est un InfoPackage. v pchain_, si le travail cible est une chane de processus. Les paramtres -user, -client et -exec_client nauront aucun effet si vous spcifiez un ID de travail. Pour les travaux InfoPackage et ProcessChain, ce paramtre est obligatoire. -client client_dfinition Numro identifiant le client R/3 o doit se trouver la dfinition du travail, indpendamment du numro de client dfini par le mot cl r3client dans le fichier doptions. Ce paramtre na aucun effet sur des travaux de type InfoPackage ou ProcessChain, ni si un ID de travail a t spcifi dans la dfinition du travail. Numro identifiant le client R/3 o le travail doit sexcuter, indpendamment du numro de client dfini par le mot cl r3client dans le fichier doptions. Ce paramtre na aucun effet sur des travaux de type InfoPackage ou ProcessChain, ni si un ID de travail a t spcifi dans la dfinition du travail. Active la trace r3batch la plus explicite. Active la trace RFC SAP.

-exec_client client_excution

-debug -trace

Remarques : 1. Vous pouvez spcifier la fois -i et -user dans une mme dfinition de travail, mais le nom dutilisateur sera ignor. 2. Lorsque vous spcifiez un ID de travail, -client et -exec_client sont ignors puisque lID est le mme pour lensemble du systme R/3. Voici un exemple de travail R/3 appel BVTTEST, ayant pour ID 03102401 et pour utilisateur mon_utilisateur :
-job BVTTEST i 03102401 -debug

Voici un exemple de travail InfoPackage dont le nom de zone technique est ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY :
-job ZPAK_3LZ3JRF29AJDQM65ZJBJF5OMY -i ipak_

110

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Etats des travaux dans Tivoli Workload Scheduler et dans R/3


Lorsquun travail R/3 est lanc par Tivoli Workload Scheduler, vous pouvez surveiller sa progression. Les transitions dtat utilises dans Tivoli Workload Scheduler (statut interne) et les statuts correspondants utiliss dans R/3 sont lists dans le tableau ci-dessous.
Etat du travail dans Tivoli Workload Scheduler INTRO WAIT EXEC SUCC ABEND Etat du travail dans R/3 N/A Prt Actif Termin Annul

Ltat INTRO indique que Tivoli Workload Scheduler est en train dintroduire le travail mais que le travail nest pas encore considr comme prt dans R/3,. Etant donn quil peut prendre un certain temps pour quun travail soit mis en file dattente et plac dans la colonne Prt, ltat INTRO peut durer quelques minutes si le systme R/3 est trs occup. Bien quun travail puisse tre termin dans R/3, Tivoli Workload Scheduler le gardera avec ltat EXEC si ses sessions BDC ne sont pas acheves ou que vous navez pas slectionn loption Dsactivation de lattente BDC. Pour utiliser cette option, reportez-vous au Chapitre 21, Attente BDC, la page 127.

Chapitre 16. Dfinition des travaux dagent tendu R/3

111

112

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 17. Rexcution de travaux


Avant de rexcuter un travail R/3 avec Tivoli Workload Scheduler, vous avez la possibilit de prciser le nom dune tape de ce travail. Si vous procdez ainsi, cela influe sur r3batch de la manire suivante : si le nom de ltape se prsente sous le format xnnnnnn ou nnnnnnn (o x reprsente un caractre non numrique et n un caractre numrique), il est alors utilis comme numro dtape de dmarrage pour la rexcution du travail R/3. Dans tous les autres cas, cette valeur na aucun effet sur la rexcution du travail, qui est rexcut partir de sa premire tape. Ce nest que lorsque r3batch rexcute un travail partir de sa premire tape, soit parce que lutilisateur a spcifi celle-ci comme tape de dmarrage, soit quil na rien spcifi du tout, quil utilise la fonction de nouvelle copie (si la version de R/3 le permet). Si ltape de dmarrage est suprieure un, alors r3batch utilise lancienne copie pour rexcuter le travail. La section ci-dessous explique la principale diffrence entre la nouvelle et lancienne copie dun travail rexcuter.

Ancienne et nouvelle copies dun travail rexcuter


Lorsque la mthode daccs R/3 doit lancer un travail, elle effectue une copie dun modle de travail et lexcute. La fonction Nouvelle copie est disponible partir des versions 3.1i de R/3. Elle copie un travail entirement, tout en prservant les tapes, la classe de travail et tous les paramtres dimpression et darchivage. Elle utilise un nouveau module fonctionnel R/3 qui fait partie du Support Package R/3, comme indiqu dans les notes R/3 399449 et 430087. A linverse, la fonction dancienne copie, base sur les modules fonctionnels R/3 standard, cre un nouveau travail R/3 et ajoute les tapes avec une boucle qui dmarre partir du nom ou du numro de ltape que vous avez spcifi. Notez que, sauf si vous disposez du support XBP 2.0 : v Lancienne copie ne prserve pas tous les paramtres dimpression et darchivage. v La classe de travail de la copie est toujours C. Reportez-vous la section Incidents dus aux paramtres dimpression et la classe de travail la page 99 pour savoir comment rsoudre les problmes de perte des paramtres dimpression et darchivage et de la classe de travail.

Copyright IBM Corp. 2000, 2003

113

114

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 18. Business Information Warehouse


Prise en charge de Business Information Warehouse - InfoPackages
Business Information Warehouse (BIW) est une solution de Data Warehousing conue spcialement pour R/3. Elle facilite le contrle de gestion et la prise de dcisions.

Autorisations utilisateur
Tivoli Workload Scheduler for Applications pour R3 permet de grer les InfoPackages BIW R/3 ainsi que les chanes de traitement. Afin de pouvoir utiliser la fonctionnalit BIW R/3, vous devez dfinir un utilisateur Tivoli Workload Scheduler R/3 avec les autorisations supplmentaires suivantes : Les autorisations du tableau ci-dessous ne sont requises que si vous envisagez dutiliser les fonctionnalits BIW de lagent tendu.
Objet S_DEVELOP Texte ABAP Workbench Autorisation E_ABAP_ALL

Remarque : En plus du profil Z_MAESTRO, le profil S_RS_ALL doit tre ajout lutilisateur Tivoli Workload Scheduler.

Composants Business Information Warehouse


R/3 prend en charge deux composants BIW principaux, les InfoPackages et les chanes de traitement. Un InfoPackage constitue le point dentre du processus de chargement dune InfoSource spcifique (cest--dire un conteneur logique de source de donnes, gnriquement appel InfoObject). Techniquement, un InfoPackage est un travail SAP concret ayant pour tche de charger les donnes. Comme tout autre travail R/3, il contient des paramtres spcifiques au travail, tels que lheure de dbut, les dpendances, etc. Une chane de traitement est une chane complexe de diffrents processus et de leurs relations. Les processus dune chane ne se limitent pas des processus de chargement de donnes ou des InfoPackages, mais peuvent galement inclure : v lexcution de modifications dattributs ou de hirarchie, v le cumul dagrgats, v le programme ABAP, v une autre chane de traitement, v lintgration de clients.

Copyright IBM Corp. 2000, 2003

115

Dfinition des travaux dagent tendu pour BIW


Les InfoPackages et les chanes de traitement ne peuvent tre crs qu partir de lenvironnement R/3. Toutefois, le niveau 1.3 de Job Scheduling Console prend en charge les listes de slection dInfoPackages et de chanes de traitement, si bien que vous pouvez ds prsent dfinir des travaux dagent tendu Tivoli Workload Scheduler pour ces objets. Pour savoir comment dfinir des travaux dagent tendu via les fentres SAP de Job Scheduling Console, reportez-vous la section Utilisation des fentres SAP de Job Scheduling Console la page 102. Pour savoir comment dfinir des travaux dagent tendu via les fentres Tche dagent tendu de Job Scheduling Console ou via le programme Composer, reportez-vous au Chapitre 5, Dfinition des travaux dagent tendu, la page 37. Pour connatre les paramtres de chane de tches utiliss pour la spcification des InfoPackages et des chanes de traitement lorsque vous dfinissez des travaux dagent tendu via les fentres Tche dagent tendu de Job Scheduling Console ou via le programme Composer, reportez-vous la section Paramtres de chane de tches pour les travaux R/3 la page 109.

Options de planification R/3 dun InfoPackage


Pour pouvoir planifier des InfoPackages via IBM Tivoli Workload Scheduler, les options de planification dInfoPackage doivent tre configures comme suit : v Le type de dmarrage doit avoir pour valeur Dmarrage ultrieur en arrire-plan. v Lheure de dmarrage doit tre dfinie comme Immdiat.

116

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 19. Connexion au systme R/3


Tivoli Workload Scheduler for Applications pour R3 utilise la bibliothque RFC (appel de connexion distante) de SAP pour se connecter au systme R/3. Ladresse de connexion dun systme R/3 est appele chane de connexion.

Connexions un serveur dapplications spcifique


Dans sa forme primaire, une chane de connexion est constitue du nom dhte (ou nom IP) dun serveur dapplications R/3, par exemple :
/H/hemlock.tivlab.raleigh.ibm.com

Ce type de chane de connexion fonctionne uniquement dans des environnements rseau trs simples, dans lesquels tous les serveurs dapplications sont directement accessibles via TCP/IP. Gnralement, les entreprises modernes utilisent des topologies rseau plus complexes, avec un certain nombre de sous-rseaux qui ne peuvent pas communiquer directement via TCP/IP. Pour pouvoir prendre en charge ce type de rseau, la bibliothque RFC de SAP utilise des dispositifs appels routeurs SAP, qui sont placs la limite des sous-rseaux et font office de proxys. Dans ce cas, la chane de connexion finale est compose des chanes de connexion de base de chaque routeur SAP, auxquelles sajoute la chane de connexion de base du systme R/3 cible, par exemple :
/H/litespeed/H/amsaix33/H/hemlock.tivlab.raleigh.ibm.com

De plus, il est possible de protger les routeurs SAP par des mots de passe afin dviter les tentatives daccs non autorises. Dans ce cas, la chane de connexion de base du routeur SAP est suivie de /P/ et du mot de passe du routeur. Remarque : La bibliothque RFC de SAP limite la longueur de la chane de connexion un maximum de 128 caractres, ce qui constitue une relle restriction dans les environnements rseau complexes. Pour contourner cet obstacle, il est recommand dutiliser des noms dhte simples, sans nom de domaine lorsque cest possible. Vous pouvez galement utiliser les adresses IP, bien que ce ne soit pas recommand du fait de la lourdeur de gestion quelles imposent. Tivoli Workload Scheduler for Applications pour R3 prend en charge les deux types de chanes de connexion, de base et compose, o : r3host Est la chane de connexion. r3instance Est le numro de linstance R/3. r3sid Est lID systme R/3.

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

Copyright IBM Corp. 2000, 2003

117

Groupes de connexion
Dans les installations R/3 plus vastes, les serveurs dapplications sont gnralement configurs en groupes de connexion des fins dquilibrage de la charge et de tolrance aux pannes. Lquilibrage de la charge est effectu par un serveur ddi, appel serveur de messages. Ce serveur affecte automatiquement les utilisateurs au serveur dapplications ayant la charge la plus faible du groupe de connexion quil contrle. Dfinissez les options suivantes pour configurer r3batch dans le cadre dun groupe de connexion : r3host Nom dhte du serveur de messages. r3group Nom du groupe de connexion. r3sid ID systme R/3.

Par exemple :
r3host=pwdf0647.wdf.sap-ag.de r3group=PUBLIC r3sid=QB6

118

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 20. Fichiers doptions de la mthode daccs R/3


Les fichiers doptions de la mthode daccs R/3 sont les suivants : r3batch.opts Fichier de configuration commun pour la mthode daccs r3batch, dont les paramtres affectent toutes les instances r3batch. Il fonctionne comme un fichier de configuration global. NOM_CPU_r3batch.opts Fichier de configuration propre chaque poste de travail dagent tendu IBM Tivoli Workload Scheduler - nomm de manire gnriqueNOM_CPU - laide de la mthode daccs r3batch. Ses options affectent uniquement linstance r3batch utilise par ce poste de travail en particulier. Il fonctionne comme un fichier de configuration local. Par exemple, si vous souhaitez dfinir deux agents tendus nomms wkst1 et wkst2 qui accderont deux systmes R/3 - SAP1 et SAP2 - avec la mthode daccs r3batch, vous devez dfinir les fichiers de configuration suivants : v Le fichier global r3batch.opts v Le fichier local wkst1_r3batch.opts v Le fichier local wkst2_r3batch.opts Remarque : Si r3batch trouve le fichier de configuration local dun agent tendu, il ignore les informations contenues dans r3options.

Options de configuration
Cette section dcrit les options configurer dans r3batch.opts et dans NOM_CPU_r3batch.opts.

Options globales
Le tableau suivant rpertorie les options que vous devez dfinir dans le fichier de configuration global r3batch.opts. Ces options nont deffet que lors de lexcution dun agent tendu Tivoli Workload Scheduler dans un environnement Unix. Remarque : Ces options ne prennent effet que si elles sont dfinies r3batch.opts.
Tableau 16. Options de configuration globale R3batch. Option job_sem_proj var_sem_proj icp_sem_proj Description ID projet du smaphore du travail. ID projet du smaphore de la variante. ID projet du smaphore dinterception du travail.

Les options job_sem_project et var_sem_project sont deux paramtres avancs qui vous permettent de personnaliser la synchronisation des travaux. Le systme R/3 synchronise laccs la base de donnes laide dun systme de gestion du verrouillage. Lorsque Tivoli Workload Scheduler for Applications pour R3
Copyright IBM Corp. 2000, 2003

119

fonctionne dans le systme R/3, les modules de la fonction ABAP correspondante verrouillent et dverrouillent diffrents objets dans la base de donnes. Lorsque vous essayez de verrouiller un objet, le systme de gestion du verrouillage ne permet dattendre que pendant un temps limit avant le rejet de la tentative de verrouillage assorti dun message derreur. Lorsque ce cas se produit, le module de la fonction courante est galement abandonn. Le temps maximal en secondes allou chaque tentative de verrouillage est indiqu dans le paramtre systme enque/delay_max. Le code retour du module de fonction est trop gnral pour distinguer le dpassement du temps dattente maximal du verrouillage des autres erreurs de la base de donnes. Par consquent, la mthode daccs pour R/3 ne peut pas continuer et signale une erreur. Si ce cas se produit pendant lexcution dun travail R/3, celui-ci est ltat abort. Cette situation saggrave lorsque Tivoli Workload Scheduler dmarre plusieurs travaux simultanment. En fonction du temps dattente maximal, certains dentre eux doivent tre abandonns en raison de lexpiration des tentatives de verrouillage. Pour rsoudre cet incident, Tivoli Workload Scheduler for Applications pour R3 utilise des smaphores au niveau dOS pour synchroniser les appels des modules de fonctions ABAP importantes. Cette mthode permet dviter rellement lincident dcrit. Un smaphore est utilis pour les tches associes au travail et un autre pour les tches lies la maintenance de variante. Afin de se donner rendez-vous sur la mme structure IPC dans un environnement UNIX, les deux parties doivent se mettre daccord sur un identificateur pour cette structure. Il existe plusieurs faons de choisir cet identificateur. Tivoli Workload Scheduler for Applications pour R3 utilise deux paramtres : un nom de chemin et un ID projet (valeur de type caractre). Le nom du chemin est transmis du chemin absolu au fichier doptions. LID projet est lune des options dcrites dans le tableau 16 la page 119. Si ces options sont omises, Tivoli Workload Scheduler for Applications pour R3 utilise les valeurs par dfaut, lesquelles conviennent la majorit des installations.

Options locales
Le tableau suivant rpertorie les options dfinir dans les fichiers de configuration locaux.
Tableau 17. Options de configuration locale de R3batch. Option r3client r3gateway r3group r3gwservice r3host Description Numro du client R/3. Cette option est requise. Nom dhte de la passerelle R/3. Nom du groupe de connexion R/3. Numro de service de la passerelle R/3. Nom dhte du serveur de messages R/3 lorsque vous utilisez des groupes de connexion ou le nom dhte du serveur dapplications dans tous les autres cas. Cette option est requise. Numro dinstance R/3. Cette option est requise.

r3instance

120

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 17. Options de configuration locale de R3batch. (suite) Option r3password Description Mot de passe associ r3user. Cette valeur doit respecter la casse. Cette option est requise. ID systme R/3. Cette option est requise. Nom de lutilisateur R/3 avec lequel la mthode daccs se connecte au systme R3. Cette option est requise. Oblige la mthode daccs fonctionner uniquement avec les systmes R/3 comportant la version indique. Utilisez cette option avec prcaution. Oblige la mthode daccs fonctionner avec les systmes R/3 prenant en charge la version XBP indique. Utilisez cette option avec prcaution.

r3sid r3user

r3version

xbpversion

Options gnrales
Le tableau suivant rpertorie les options supplmentaires que vous pouvez dfinir dans lun des fichiers de configuration.
Tableau 18. Options de configuration gnrale R3batch. Option r3auditlevel short_interval Description Par dfaut

Niveau daudit de XBP. 3 Nombre compris entre 0 et 3. Intervalle court, en secondes, 10 pour les vrifications dtat. Valeur suprieure 10 secondes. Intervalle long en secondes, pour les vrifications dtat. Valeur infrieure 3600 secondes. Codage que r3batch doit utiliser pour ouvrir les connexions RFC avec les systmes R/3. Il peut sagir de lune des valeurs suivantes : v 1100 v 1103 v 8000 v 8300 v 8400 3600

long_interval

twsxa_cp

1100

twsxa_lang

Langue utilise pour la EN connexion aux systmes R/3. Vous pouvez choisir : v DE pour lallemand v EN pour langlais v JA pour le japonais
Chapitre 20. Fichiers doptions de la mthode daccs R/3

121

Tableau 18. Options de configuration gnrale R3batch. (suite) Option twsmeth_cp Description Codage que r3batch doit utiliser pour crire sa sortie R/3. Il peut sagir de lune des pages de code TIS existantes. Par dfaut Page de code locale

twsmeth_lang utf8cmdline

Langue utilise pour signaler Langue locale les messages. Valeur gale 0 ou 1 et qui 1 indique si r3batch doit attendre des paramtres tendus cods en UTF-8. La valeur 1 signifie une rponse affirmative. Nombre de relances dappels 5 de module de fonction R/3. Nombre suprieur 0. Autoriser/interdire la dfinition de nouveaux travaux R/3 par linterface graphique de Tivoli Workload Scheduler. Oblige la mthode daccs utiliser lancienne mthode de copie. Indiquez une valeur diffrente de zro pour activer cette option. 0

retry

nojobdefs

oldcopy

old_picklist_mode

Cette option sapplique 0 uniquement aux versions 4.5 et ultrieures de R/3. Si cette option est dsactive (valeur 0), la liste de slection des travaux est extraite par le module de fonction BAPI_XBP_JOB_SELECT. Si elle est active (valeur diffrente de zro), elle est extraite par le module de fonction BAPI_XBP_JOB_COUNT. Cette option doit tre dsactive car le module de fonction BAPI_XBP_JOB_COUNT connat des incidents lors de son excution. Nombre de relances pour 5 louverture dune connexion RFC avec le systme R/3. La valeur est suprieure 0 pour limiter le nombre de relances et -1 pour un nombre illimit de relances. Temps dattente maximal en secondes entre deux appels conscutifs avant louverture dune connexion RFC. 1800

rfc_open_retry

rfc_open_delay

122

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 18. Options de configuration gnrale R3batch. (suite) Option log_r3syslog Description Par dfaut

Si cette option est active, la OFF mthode daccs crit les dernires entres de R/3 syslog dans son fichier de trace lorsquun RFC renvoie un message derreur gnrale. Indiquez ON pour activer loption et OFF pour la dsactiver. Active les capacits de mappage RC de Tivoli Workload Scheduler for Applications pour R3. Indiquez ON pour activer loption et OFF pour la dsactiver. Valeur maximale du compteur de noms de variante. Si le compteur de noms atteint la valeur indique, il recommence partir de 0. Rgles du compteur de noms : step Le compteur de noms est augment chaque tape. Le compteur de noms est augment une fois pour le travail. 2^15 - 1 ON

rcmap

max_name_counter

40

name_counter_policy

travail

job

max_n0_counter

Valeur maximale du compteur N0. Si celui-ci atteint la valeur indique, il recommence partir de 0. Rgles du compteur N0 : step Le compteur N0 est augment chaque tape. Le compteur N0 est augment une fois pour le travail.

n0_counter_policy

travail

job

Utilisation des options de configuration


Le format du fichier de configuration nom_CPU_r3batch.opts est le suivant :
option1=valeur1 option2=valeur2 option3=valeur3 ...

sans espace avant loption et aprs la valeur, ni entre elles et le signe gal.
Chapitre 20. Fichiers doptions de la mthode daccs R/3

123

Dans r3batch.opts, vous pouvez inscrire toutes les informations communes, telles que les optionsLJuser, IFuser, JobDef et LogFileName, tandis que vous pouvez inscrire dans un fichier de configuration local (par exemple, wkst1_r3batch.opts) des donnes personnalises pour le systme R/3 cible de lagent tendu (par exemple, SAP1). Vous pouvez indiquer une option locale dans le fichier de configuration global si vous devez indiquer la mme option pour toutes les instances r3batch. Si le nom dutilisateur R/3 est identique dans tous les systmes R/3, vous pouvez dfinir loption r3user dans le fichier global sans dupliquer ces informations dans les fichiers de configuration locaux. Notez que ces fichiers de configuration ne sont pas crs au cours de linstallation. Une option globale, telle que job_sem_proj, na deffet que dans le fichier de configuration global. Si vous la dfinissez dans un fichier local, elle naura aucun effet. r3batch lit dabord le fichier de configuration global, puis le fichier local. Par consquent, toutes les options (sauf les options globales) contenues dans le fichier de configuration local remplacent celles des fichiers globaux. Par exemple, si les deux fichiers de configuration contiennent loption r3user, r3batch utilise le fichier local. r3batch ncessite six options obligatoires ; vous pouvez les dfinir toutes dans le fichier de configuration local ou les rpartir entre le fichier global et le fichier local. Par exemple, vous pourriez dfinir r3user et r3password dans le fichier de configuration global et r3sid, r3instance, r3client et r3host dans le fichier local. Loption r3user est la fois locale et obligatoire. Elle doit tre dfinie dans le fichier de configuration global ou dans le fichier local.

Migration des fichiers de configuration


Cette section donne un exemple de migration dun fichier de configuration de r3options dans plusieurs fichiers .opts locaux (CPU_r3batch.opts). Dans un fichier r3options avec le contenu suivant :
xacpu1 sap1 tv1 00 100 maestro 2QGp4-7JU5-MY2A-mX 30 300 2 xacpu1 sap2 d04 10 200 tws z57I-U5MY-2Amp-4X 30 100 2

vous pouvez crer deux fichiers locaux, xacpu1_r3batch.opts et xacpu2_r3batch.opts. Voici le contenu de 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

124

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Voici le contenu de xacpu2_r3batch.opts :


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

Le script Perl offre un exemple de migration automatique. A partir du fichier r3options, il produit les fichiers de configuration locaux.
$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"); 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;

Pour utiliser ce modle : 1. Installez un interprteur PERL sur votre ordinateur. 2. Copiez le modle dans un fichier nomm migrate.pl et stockez-le dans le rpertoire<racine_TWS>/methods. 3. Excutez perl migrate.pl. Les fichiers de configuration locaux sont crs dans le rpertoire <racine_TWS>/methods.

Chapitre 20. Fichiers doptions de la mthode daccs R/3

125

126

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 21. Attente BDC


Grce loption dattente (Batch Data Collector), vous pouvez spcifier quun travail R/3 lanc par IBM Tivoli Workload Scheduler ne sera pas considr comme achev tant que toutes ses sessions BDC ne seront pas termines. Ceci vite que dautres travaux IBM Tivoli Workload Scheduler dpendant du mme travail R/3 ne soient lancs tant que les sessions BDC associes ce travail ne sont pas termines. Pour utiliser cette option, un travail R/3 doit crire des messages dinformation dans le journal des travaux. Pour ce faire, il convient dajouter une instruction de message au rapport BDCREXX fourni par SAP (voir exemple ci-dessous), soit en utilisant un nom de session BDC (12 caractres maximum), soit en utilisant un ID de file dattente BDC (20 caractres maximum). Plusieurs messages peuvent tre crits pour permettre le contrle de plusieurs sessions BDC. Si vous ne voulez pas apporter de modifications R/3, vous pouvez galement copier BDCRECXX sous un autre nom, par exemple ZBDCRECXX, faire les modifications dans cette copie et inclure celle-ci dans tous vos programmes gnrant des sessions BDC. Vous devez le faire manuellement pour chaque travail. Si vos sessions BDC ne sont pas cres laide de la transaction SM35, mais directement par un composant SAP, elles ne peuvent pas utiliser le rapport BDCRECXX. Dans ce cas, vous pouvez effectuer les modifications dans le module fonctionnel BDC_OPEN_GROUP fourni par SAP, comme dcrit ci-dessous. Notez que vous devez modifier le rapport BDCRECXX (ou sa copie ZBDCRECXX) ou le module fonctionnel BDC_OPEN_GROUP, mais pas les deux objets. Remarque : Ltat dachvement dun travail R/3 lanc par IBM Tivoli Workload Scheduler, que ce soit SUCC ou ABEND, est entirement bas sur le statut dexcution du travail. Il ne dpend aucunement du succs ou de lchec de lune des sessions BDC, qui sont considres comme termines, indpendamment du fait quil y ait eu (ou non) des erreurs durant le traitement BDC. Si vous voulez ragir aux erreurs dune session BDC, vous pouvez utiliser la fonction de mappage des codes retour de Tivoli Workload Scheduler, comme dcrit au Chapitre 28, Bibliothque de mappage de code retour, la page 181.

Utilisation des noms de session BDC


Pour utiliser les noms de session BDC, modifiez le formulaire open_group dans lobjet R/3 BDCRECXX comme suit : v Pour les versions SAP antrieures 4.6c :
form open_group. if session = X. skip. write: /(20) Create group(i01), group. skip. * open batchinput group call function BDC_OPEN_GROUP exporting client = sy-mandt group = group user = user keep = keep
Copyright IBM Corp. 2000, 2003

127

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

v Pour les versions SAP 4.6c et ultrieures :


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

Lorsque des sessions BDC sont spcifies par leur nom, Tivoli Workload Scheduler nattend pas quune session BDC soit termine sil y a dautres sessions BDC de mme nom en cours. Exemple Un travail R/3 lanc par Tivoli Workload Scheduler dmarre trois sessions BDC avec le nom ORD2 et met le message BDCWAIT suivant :
BDCWAIT:ORD2

Une fois la premire session ORD2 termine, le travail R/3 a pour statut SUCC dans Tivoli Workload Scheduler. r3batch ne fait pas la diffrence entre les sessions BDC de mme nom. Un autre problme de lutilisation des noms de sessions BDC rside probablement dans les diffrentes heures systme dun environnement R/3 rparti.r3batch analyse les sessions BDC avec les noms spcifis, gnrs lors de lexcution du travail crateur. Si le travail crateur ne fait rien dautre que de dmarrer des sessions BDC, le temps dexcution peut tre trs court. Sil ny a aucune synchronisation temporelle, lheure systme des diffrents postes de travail diffre gnralement dans un environnement R/3 rparti. Cette diffrence peut tre suprieure au temps dexcution du travail. Il est donc possible quun intervalle de temps erron soit pris en compte et que des sessions BDC ne soient jamais dtectes. Il est donc vivement recommand dutiliser la mthode des ID de file dattente BDC dcrite dans les sections suivantes.

Utilisation des ID de file dattente BDC avec le rapport BDCRECXX


Pour rsoudre les problmes causs par lidentification des sessions BDC par leur nom, vous pouvez spcifier celles-ci par un ID de file dattente 20 chiffres. Etant donn que chaque ID de file dattente R/3 est unique, un message BDCWAIT doit tre mis pour chaque ID de file dattente contrler.

128

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Pour dterminer lID de file dattente, modifiez le formulaire open_group dans lobjet R/3 BDCRECXX comme suit : v Pour les versions SAP antrieures 4.6c :
form open_group. if session = X. skip. write: /(20) Create group(i01), group. skip. * open batchinput group call function BDC_OPEN_GROUP exporting client = sy-mandt group = group user = user keep = keep holddate = holddate importing qid = myquid. message i001(92) with myqid. write: /(30) BDC_OPEN_GROUP(i02), (12) returncode:(i05), sy_subrc. endif. endform.

v Pour les versions SAP 4.6c et ultrieures :


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

Noubliez pas de dfinir la variable myqid dans BDCRECXX. Avec cette approche, vous modifiez de manire totale votre systme R/3.

Utilisation des ID de file dattente BDC avec le module fonctionnel BDC_OPEN_GROUP


Les sessions BDC non cres par la transaction SM35 mais par un composant SAP, ne peuvent pas utiliser le rapport BDCREXX. Dans ce cas, la meilleure solution pour suivre ces sessions BDC consiste modifier le module fonctionnel SAP BDC_OPEN_GROUP comme suit :
FUNCTION BDC_OPEN_GROUP. ... CALL BDC_OPEN_GROUP ID CLIENT FIELD CLIENT ID GROUP FIELD GROUP ID USER FIELD USER ID KEEP FIELD KEEP ID HOLDDATE FIELD HOLDDATE ID DESTINATION FIELD DEST ID QID FIELD QID ID RECORD FIELD RECORD ID PROG FIELD PROG. * IF SY-SUBRC EQ 0.
Chapitre 21. Attente BDC

129

BQID = QID. BUSER = SY-MSGV1. BGROUP = GROUP. * CALL FUNCTION DB_COMMIT. 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.

Notez que les paramtres rels de lappel de la fonction C (CALL BDC_OPEN_GROUP ID ...) peuvent dpendre du numro de la version SAP. Avec cette approche, vous modifiez de manire totale votre systme R/3.

130

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 22. Fonctions dinterception des travaux et fonctions parent-enfant


Ce chapitre explique comment les fonctions dinterception des travaux et les fonctions parent-enfant de BC-XBP 2.0 sont prises en charge par Tivoli Workload Scheduler for Applications.

Interception des travaux


Linterception des travaux est une fonction de linterface BC-XBP 2.0. Elle permet Tivoli Workload Scheduler de contrler trs troitement les travaux lancs par les utilisateurs R/3 partir de linterface graphique de SAP. Le mcanisme dinterception devient actif lorsque le planificateur de travaux R/3 est sur le point de dmarrer un travail R/3 ( savoir, lorsque les conditions start dun travail R/3 sont remplies). Il compare les paramtres du travail (job name, creator et client) aux entres du tableau R/3 TBCICPT1, et, ds que ces paramtres rpondent aux critres, le travail R/3 est ramen ltat scheduled et marqu par un indicateur prcisant quil a t intercept. Si Tivoli Workload Scheduler a t dfini pour grer linterception de travaux, il excute de temps en temps son propre travail pour extraire la liste des travaux intercepts et les replanifie. Ce travail peut tre appel collecte dinterception. Pour configurer Tivoli Workload Scheduler de faon traiter linterception de travaux dans un environnement R/3 : 1. Installez linterface BC-XBP 2.0. 2. Activez la fonction dinterception de linterface BC-XBP 2.0. 3. Dfinissez un travail Tivoli Workload Scheduler pour collecter de temps en temps les travaux R/3 intercepts. 4. Indiquez les critres dinterception dans le systme R/3. 5. Indiquez ces mmes critres sur Tivoli Workload Scheduler. Notez que les travaux lancs par Tivoli Workload Scheduler ou par tout autre planificateur externe utilisant linterface BC-XBP ne peuvent pas tre intercepts. Cela est d au mcanisme dinterception qui ne prend en compte que les travaux dont les conditions ont t remplies, en raison des restrictions de temps ou dvnement SAP.

Implmentation de linterception de travaux


Cette section dcrit laction effectuer pour implmenter linterception de travaux.

Activation de la fonction dinterception de travaux


Reportez-vous la note SAP 604496 pour savoir si votre systme R/3 comporte dj linterface BC-XBP 2.0 ou quel est le module de support SAP installer pour lactiver. Afin dactiver la fonction dinterception, excutez le rapport ABAP INITXBP2. Ce rapport indique ltat actuel des fonctions dinterception de travaux et parent-enfant et vous permet de basculer entre les tats des deux fonctions.

Copyright IBM Corp. 2000, 2003

131

Collecte priodique des travaux intercepts


Puisque les travaux intercepts restent ltat scheduled jusqu ce quils soient relancs, vous devez dfinir un travail Tivoli Workload Scheduler pour les collecter et les dmarrer. Voici la syntaxe de la dfinition de travail pour la collecte dinterception dans Tivoli Workload Scheduler :
NOM_CPU#NOM_TRAVAIL SCRIPTNAME "racine_TWS/methods/r3batch -HIJ -c NOM_CPU" DESCRIPTION "Collecte les travaux intercepts sur SAP XA NOM_CPU" STREAMLOGON utilisateur_TWS RECOVERY STOP

o : NOM_CPU Nom du poste de travail dagent tendu. NOM_TRAVAIL Nom que vous souhaitez utiliser pour le travail Tivoli Workload Scheduler. racine_TWS Chemin daccs complet votre installation Tivoli Workload Scheduler. utilisateur_TWS Nom de lutilisateur de Tivoli Workload Scheduler qui doit dmarrer la mthode daccs. Le programme de collecte dinterception doit tre excut priodiquement, par exemple toutes les 10 minutes. Il extrait tous les travaux qui ont t intercepts depuis la dernire excution du programme de collecte dinterception et les relance daprs un modle sous la forme dun texte dcrit.

Configuration des critres dinterception sur le systme R/3


Sur R/3, les critres dinterception figurent dans le tableau TBCICPT1. Seuls les travaux rpondant aux critres de ce tableau sont intercepts lorsque leurs conditions start sont remplies. Tous les autres travaux sont excuts normalement. Vous pouvez grer les entres de ce tableau laide de la transaction se16. Vous pouvez dfinir les valeurs suivantes : v Numro de client v Masque de travail v Masque dutilisateur

Configuration des critres dinterception sur Tivoli Workload Scheduler


Sur Tivoli Workload Scheduler, les critres dinterception sont dfinis et utiliss par lune des valeurs suivantes : v Fichiers des critres dinterception v Fichiers modle Utilisation des fichiers des critres dinterception : Les critres dinterception de chaque systme R/3 sont stocks dans un fichier spar nomm NOM_CPU_r3batch.icp et situs dans le rpertoire racine_TWS/methods/r3batch_icp de lhte Tivoli Workload Scheduler. Ce fichier est lu par r3batch lors de lexcution du programme de collecte dinterception.

132

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chaque ligne du fichier est considre comme un critre dinterception et caractrise par la syntaxe suivante :
client masque_travail masque_utilisateur modle

o client, masque_travail et masque_utilisateur correspondent aux colonnes du tableau TBCICPT1, tandis que modle est le nom du modle utiliser par le programme de collecte dinterception pour excuter le travail R/3. Les paramtres sont spars par un ou plusieurs espaces. Vous pouvez utiliser nimporte quel diteur de texte pour grer le contenu de ce fichier. Utilisation des fichiers modle : Un modle est un fichier comportant lextension .jdf et situ dans le mme rpertoire(racine_TWS/methods/r3batch_icp) que le fichier des critres dinterception. Le fichier modle contient des instructions pour le programme de collecte dinterception sur lexcution du travail R/3 intercept sous le contrle de Tivoli Workload Scheduler. Sa syntaxe correspond celle de docommand dans conman. Vous pouvez utiliser nimporte quel diteur de texte pour grer ce fichier. Si le fichier modle de lutilisateur est vide, un fichier modle nomm default.jdf est utilis. Si default.jdf nexiste pas, les instructions suivantes sont utilises :
alias=SAP_$RUN_$JOBNAME_$JOBCOUNT

Par consquent, les travaux R/3 doivent tre relancs immdiatement, en raison de labsence de loption de travailat=. Leurs noms Tivoli Workload Scheduler sont composs de la chane SAP_, du numro dexcution actuel du programme de collecte dinterception et du nom et de lID du travail R/3. Par consquent, lensemble des instructions permettant de relancer un travail R/3 doit tre extrait comme suit : 1. A partir du fichier modle si un modle existant est indiqu dans le fichier des critres dinterception. 2. A partir du fichier modle par dfaut si le modle est indiqu dans le fichier des critres dinterception mais nexiste pas ou si le modle nest pas indiqu dans le fichier des critres dinterception. 3. A partir de lensemble dinstructions par dfaut si le fichier modle par dfaut nexiste pas. Exemple dinterception des travaux : Les critres dinterception des travaux sur R/3 contiennent lentre suivante :
000 * fa*

Les critres dinterception des travaux sur Tivoli Workload Scheduler contiennent lentre suivante :
000 * fa* at1700

Le fichier modle at1700.jdf contient lentre suivante :


alias;at=1700

En consquence, tous les travaux dmarrs dans le client 000 par des utilisateurs R/3 dont les noms dutilisateur commencent par fa seront intercepts. Le programme de collecte dinterception redmarrera les travaux laide des instructions du fichier modle at1700.jdf. Les travaux R/3 seront redmarrs 17h00 avec un nom au hasard, en raison de la commande alias.

Chapitre 22. Fonctions dinterception des travaux et fonctions parent-enfant

133

Utilisation des marques de rservation : Dans les fichiers modle, vous pouvez utiliser un certain nombre de marques de rservation remplaces par le programme de collecte dinterception lors de lexcution. Elles sont rpertories dans le tableau suivant.
Tableau 19. Marques des fichiers modle dinterception de travaux. Marque de rservation $CPU $CLIENT $JOBNAME $JOBCOUNT $USER $JOBNUM $EXECUTION $SCHED $RAND Description Nom du poste de travail dagent tendu sur lequel le programme de collecte dinterception sexcute. Numro client du travail R/3 intercept. Nom du travail R/3 intercept. ID du travail R/3 intercept. Nom de lutilisateur qui a lanc le travail R/3. Numro de travail du programme de collecte dinterception. Numro dexcution actuel du programme de collecte dinterception. Nom de planification du programme de collecte dinterception. Nombre au hasard.

Par consquent, le modle


alias=ICP_$RAND_$JOBNAME_$JOBCOUNT_$CLIENT;at=1000

dit au programme dinterception de redmarrer le travail R/3 nomm DEMO_JOB avec lID de travail 12345678 sur le client 100 10h00 en tant que travail Tivoli Workload Scheduler
ICP_1432_DEMO_JOB_12345678_100

La fonction parent-enfant
Dans certaines situations, un travail R/3 engendre de manire dynamique un certain nombre dautres travaux, par exemple, pour distribuer la charge de travail aux serveurs dapplications libres. Les travaux dactivit de masse du composant FI-CA R/3 constituent un exemple difiant. Avant BC-XBP 2.0, cette situation tait difficile grer pour les planificateurs externes, car le processus mtier ne se termine en gnral pas avec la fin du travail initial (travail parent), mais avec la fin de tous les travaux enfant. Linterface BC-XBP 2.0 permet de dterminer si un travail a lanc des travaux enfant, ainsi que leur nom et leur ID, si bien quil est dsormais possible den effectuer le suivi. Pour activer cette fonction, utilisez le rapport INITXBP2 ABAP, qui sert galement modifier ltat dinterception des travaux. Lorsque la fonction parent-enfant est active, Tivoli Workload Scheduler considre un travail R/3 comme termin uniquement aprs la fin de tous ses travaux enfant ; en dautres termes, ltat dun travail Tivoli Workload Scheduler reste EXEC tant que le travail parent ou lun de ses travaux enfant est en cours dexcution.

134

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Ltat du travail Tivoli Workload Scheduler devient SUCC si le travail parent et tous les travaux enfant sont termins. Si lun des travaux sest termin par une erreur, ltat du travailTivoli Workload Scheduler devient ABEND. Notez que la fonction parent-enfant peut interfrer avec linterception des travaux, car, mme si le travail parent ne peut pas intercept, tous ses travaux enfant correspondant aux critres dinterception peuvent ltre. Dans ce cas, le travail Tivoli Workload Scheduler reste ltat EXEC jusqu ce que le travail enfant intercept ait t relanc et soit termin. Les journaux des travaux enfant sont ajouts dans le fichier stdlist Tivoli Workload Scheduler aprs le journal du travail parent.

Chapitre 22. Fonctions dinterception des travaux et fonctions parent-enfant

135

136

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 23. Support de la langue nationale


Grce au nouveau schma de fichiers de configuration comprenant des fichiers de configuration locaux et globaux, vous pouvez configurer r3batch pour utiliser des pages de codes et des langues diffrentes pour la sortie et la connexion avec un systme R/3 distant. Cette fonction permet dinstaller r3batch sur un poste de travail Tivoli Workload Scheduler localis et dutiliser des caractres localiss pour les noms de travail Tivoli Workload Scheduler, les flux de travaux et les variantes SAP. Remarque : Tenez compte des configurations prises en charge et des limites de cette fonction.

Options de support de la langue nationale


Loption TWSXA_CP affecte la page de codes utilise pour tablir la connexion entre r3batch et le systme R/3 cible. La valeur de loption peut correspondre lune des pages de codes R/3 installes sur le systme R/3. La valeur par dfaut correspond la page de codes SAP 1100 (similaire la page de codes ISO8859-1 standard). TWSXA_LANG affecte la langue utilise par r3batch pour la connexion. Les valeurs possibles sont les suivantes : 1. Anglais (par dfaut, EN) 2. Allemand (GE) 3. Japonais (JA) TWSMETH_CP reprsente la page de codes utilise par r3batch pour la sortie. Cette option avance peut modifier la sortie et le fichier journal. La valeur par dfaut correspond la page de codes utilise par le poste de travail Tivoli Workload Scheduler qui hberge r3batch. Il est recommand dutiliser cette option avec prcaution. Remarque : Cela sapplique si vous utilisez le niveau 1.2 de Job Scheduling Console. Le niveau 1.3 interagit avec r3batch via UTF-8, cette limite nest donc plus valable. TWSMETH_LANG affecte la langue de catalogue utilise par r3batch. Cette version contient le catalogue de messages anglais. Par consquent, cette option na pas deffet.

Copyright IBM Corp. 2000, 2003

137

Pages de codes R/3 prises en charge


Tivoli Workload Scheduler for Applications pour R3 peut communiquer avec R/3 grce aux pages de codes suivantes :
Tableau 20. Pages de codes R/3 prises en charge Pages de codes R/3 1100 1103 8000 8300 8400 Description 8859-1 (par dfaut) MS 850 SJIS (Shift-Japanese Industrial Standard) BIG5 (chinois traditionnel) GBK (chinois simplifi)

Configurations prises en charge et limites


Les remarques suivantes sappliquent si vous utilisez le niveau 1.2 de Job Scheduling Console. Le niveau 1.3 interagit avec r3batch via UTF-8, cette limite nest donc plus valable. Tivoli Workload Scheduler for Applications pour R3 doit tre install sur un poste de travail utilisant une page de codes compatible avec lun des systmes R/3 cible. Par exemple, si vous souhaitez utiliser un systme R/3 japonais qui utilise la page de codes SAP 8000, vous devez installer r3batch sur un poste de travail qui utilise une page de codes japonaise comme SJIS ou MS932. Si vous souhaitez rcuprer la sortie r3batch avec Job Scheduling Console, vous devez excuter Job Scheduling Console sur un systme qui utilise la mme page de codes que le poste de travail Tivoli Workload Scheduler sur lequel r3batch est install. Si lagent dhbergement utilise MS932, vous devez excuter Job Scheduling Console sur un systme japonais utilisant cette page de codes.

138

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 5. Mthode daccs z/OS

Copyright IBM Corp. 2000, 2003

139

140

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 24. Introduction


IBM Tivoli Workload Scheduler for Applications pour z/OS vous permet de planifier et de contrler des travaux OS/390 ou z/OS grce aux fonctions de planification volues de Tivoli Workload Scheduler. Remarque : Dans tout le manuel, le terme z/OS est galement utilis pour faire rfrence aux versions prises en charge dOS/390. Reportez-vous la section sur la configuration logicielle requise.

Fonctions
v Utilisez Tivoli Workload Scheduler pour planifier lexcution des travaux z/OS des heures spcifiques et dans un ordre dfini. v Dfinissez des dpendances entre des travaux Tivoli Workload Scheduler excuts sur des plateformes et des systmes diffrents. v Dfinissez des dpendances pour les travaux Tivoli Workload Scheduler en fonction de lexcution de travaux z/OS qui nont pas t lancs par Tivoli Workload Scheduler. v Dfinissez des dpendances pour les travaux Tivoli Workload Scheduler en fonction de lexistence de fichiers sur un systme z/OS.

Configuration logicielle requise


IBM Tivoli Workload Scheduler for Applications ncessite la configuration logicielle suivante :
Configuration logicielle requise IBM Tivoli Workload Scheduler Systme dexploitation TCP/IP Versions 7.0 ou version ultrieure. OS390 2.10 ou version ultrieure, ou z/OS. Lune des versions suivantes : IBM 3.1 ou version ultrieure ; Interlink 3.1 ou version ultrieure ; Open Connect 2.3 ou version ultrieure. v JES2 ou JES3. v Interface OPC : OPC 2.3.0 ou IBM Tivoli Workload Scheduler pour z/OS. v Interface CA7 : toute version actuellement prise en charge.

Interface de planification des travaux

Prsentation de linstallation
Le logiciel IBM Tivoli Workload Scheduler for Applications pour z/OS comprend la mthode daccs z/OS qui doit rsider sur lhte Tivoli Workload Scheduler et le logiciel passerelle qui rside sur z/OS. Le logiciel passerelle peut tre install partir dune cartouche de bande 3480 ou du CD-ROM dIBM Tivoli Workload Scheduler for Applications. Avant dinstaller la mthode daccs, vrifiez que Tivoli Workload Scheduler est correctement install sur le poste de travail hte.
Copyright IBM Corp. 2000, 2003

141

1. Le systme qui hbergera la mthode daccs pour z/OS, si la plateforme o vous effectuez linstallation est lune des suivantes : v Compaq Tru64 v SGI Irix v IBM Sequent Dynix suivez les instructions de la section Installation sur des plateformes de niveau 2. Sinon, suivez les instructions du Chapitre 2, Installation dIBM Tivoli Workload Scheduler for Applications, la page 5. 2. Installez le logiciel passerelle sur z/OS. 3. Dfinissez les autorisations requises sur z/OS.

Installation sur des plateformes de niveau 2


Le logiciel de la mthode daccs z/OS pour les plateformes de niveau 2 est fourni sous la forme dun fichier tar sur CD. Pour linstaller, procdez comme suit : 1. Arrtez Tivoli Workload Scheduler sur le poste de travail o vous installez la mthode. 2. Connectez-vous avec des droits racine et changez votre rpertoire en racine_tws/methods. 3. Montez le CD dinstallation et restaurez le fichier tar avec la commande suivante :
tar xvf dossier_cd/fichier_tar

o :
Paramtre tar dossier_cd fichier_tar Description Chemin daccs de votre unit de CD ou de votre dossier. Fichier TAR en fonction de la plateforme cible. Il peut sagir de lun des suivants : v TWS4APPS_ZOSAGENT_DYNIX.TAR pour IBM Sequent Dynix v TWS4APPS_ZOSAGENT_IRIX.TAR pour SGI Irix v TWS4APPS_ZOSAGENT_OSF.TAR pour Compaq True 64

4. Excutez la commande suivante partir du rpertoire racine_tws/methods :


./mvsinstall.sh -user utilisateur_tws

Installation sous z/OS


Le module passerelle est fourni sur les deux supports suivants : v Une cartouche de bande 3480 qui a t crit au format non-IDRC (non condens) v Le CD-ROM dIBM Tivoli Workload Scheduler for Applications. Les deux supports contiennent les deux fichiers suivants : v La bibliothque de chargement v Les modles des deux procdures Il vous appartient de choisir le support de tlchargement des fichiers, les deux supports tant identiques.

142

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tlchargement des fichiers partir du CD-ROM


Les fichiers passerelle sont stocks dans le rpertoire ZOS du CD-ROM du produit et sont nomms : v LOADLIB v SAMPLES Pour dcharger les fichiers sur votre systme z/OS : 1. A partir de votre mulateur de session TSO, slectionnez le shell de commande ISPF (commande TSO) et utilisez lutilitaire File Transfer (Send to Host) pour transfrer la bibliothque LOADLIB et le membre SAMPLES du CD-ROM au systme z/OS, en dfinissant le transfert pour une longueur denregistrement logique de 80 et un format denregistrement fixe. 2. Recevez les membres dans des fichiers de sortie laide de loption INDSN. 11 modules de chargement sont ainsi chargs dans la bibliothque de sortie et 2 exemples dans lexemple de bibliothque.

Tlchargement des fichiers partir de la bande


Modifiez et soumettez un JCL semblable au suivant pour tlcharger la bande. Personnalisez la carte de travail et modifiez les deux paramtres suivants en fonction de vos normes denvironnement : v Entrez un nom de travail appropri. v Identifiez une unit de bande 3480.
//MVSXAUNL JOB (876903,D07),OPCL3,MSGLEVEL=(1,1), // MSGCLASS=A,CLASS=A,NOTIFY=&SYSUID //********************************************************************** //* * //* THIS IS THE JOB THAT UNLOADS THE TIVOLI WORKLOAD SCHEDULER FOR * //* APPLICATIONS z/OS Access Method Version 8.2.0 TO CUSTOMIZE * //* * //********************************************************************** //STEP01 EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //INDD DD DSN=TWSX.V8R2M0.SAMPLES, // DISP=(OLD,PASS),UNIT=600, // VOL=SER=IBM001, // LABEL=(1,SL) //OUTDD DD DSN=TWSX.V8R2M0.SAMPLES, // DISP=(NEW,CATLG), // SPACE=(32760,(2,2,10)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // UNIT=3390,VOL=SER=OPC00C //SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSIN DD * COPY OUTDD=OUTDD,INDD=((INDD,R)) //STEP02 EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //INDD DD DSN=TWSX.V8R2M0.SERVICE.APFLIB1, // DISP=(OLD,PASS),UNIT=600, // VOL=SER=IBM001, // LABEL=(2,SL) //OUTDD DD DSN=TWSX.V8R2M0.SERVICE.APFLIB1, // DISP=(NEW,CATLG), // SPACE=(32760,(50,50,50)), // DCB=(RECFM=U,BLKSIZE=32760), // UNIT=3390,VOL=SER=OPC00C //SYSUT3 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSUT4 DD UNIT=SYSDA,SPACE=(TRK,(20,1,10)) //SYSIN DD * COPY OUTDD=OUTDD,INDD=((INDD,R)) //*
Chapitre 24. Introduction

143

Prsentation de linstallation
Les deux composants du programme z/OS de la passerelle Tivoli Workload Scheduler sont : EEWTCP02 Ce programme permet Tivoli Workload Scheduler dassurer le suivi sur le systme z/OS. Il est dmarr par le travail EEWSPACE. EEWTCP00 Programme passerelle qui gre les communications TCP/IP entre Tivoli Workload Scheduler et le systme z/OS. Il est dmarr par le travail EEWSERVE. EEWTCP00 convertit les commandes Tivoli Workload Scheduler dans leurs quivalents sur z/OS, rachemine les informations z/OS vers Tivoli Workload Scheduler et effectue des conversions de donnes EBCDIC-ASCII. Les deux programmes sont excuts comme des tches dmarres avec un paramtre TIME=NOLIMIT. EEWTCP02 est toujours dmarr en premier, suivi par EEWTCP00. Si les programmes doivent tre interrompus pour une raison quelconque, ils doivent tre arrts, et non annuls, pour garantir un arrt sans incident et sans incidence sur les autres programmes utilisant la sortie IEFU84.

Dfinition des autorisations sous z/OS


Aprs avoir install le produit sous z/OS, autorisez la bibliothque de chargement. Pour ce faire, procdez comme suit : 1. Excutez la commande SETPROG dans le journal. Par exemple :
SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1, VOL=xxxxxx

, o : xxxxxxx est le numro de srie du volume o se trouve la bibliothque de chargement, ou :


SETPROG APF,ADD,DSN=twsx.SERVICE.APFLIB1,VOL=SMS

qui indique un volume sous le contrle de SMS. 2. Mettez jour le membre PROGxx de SYS1.PARMLIB, sinon lautorisation sera perdue lors de la prochaine procdure de chargement initial. 3. Ajoutez EEWTCP00 la section AUTCHCMD NAMES de SYS1.PARMLIB(IKJTSOxx).

Remarques supplmentaires
Les sections fournissent des informations supplmentaires pour le fonctionnement de lagent tendu.

Sortie IEFU84
Lagent tendu de z/OS effectue le suivi des flux de travaux laide de la sortie IEFU84. Cette sortie doit tre active dans le membre paramtre SMF de SYS1.PARMLIB. IBM distribue avec le systme dexploitation une sortie IEFU84 qui est un programme IEFBR14. Le travail EEWSPACE (trait plus tard) se relie de manire dynamique la sortie IEFU84. Si la sortie IEFU84 est en cours dutilisation, EEWSPACE la devance, obtient les informations ncessaires et se connecte aux sorties utilisateur existantes. Lorsque lexcution du travail EEWSPACE est termine, il se retire de la chane et la restaure dans son tat initial. Il est important de remarquer quEEWSPACE na aucun effet sur les sorties IEFU84 existantes, lesquelles continuent fonctionner normalement.

144

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Scurit
La scurit est assure dans plusieurs domaines, gnralement RACF, Top Secret, ACF2, etc. Le travail EEWSERVE (trait plus tard) doit pouvoir soumettre des travaux excuts sous les ID utilisateur fournis dans le JCL soumettre. Le JCL ne doit pas contenir de mot de passe. Pour autoriser les mots de passe, vous pouvez utiliser les ressources de classe SURROGAT dans RACF, ainsi que les quivalents dans ACF2 et Top Secret. Les ressources de classe PROPCNTL dans RACF doivent tre utilises pour empcher lexcution des travaux soumis sous lID utilisateur EEWSERVE. Les quivalents ACF2 et Top Secret doivent galement tre utiliss. La classe de ressources JESJOBS dans RACF et ses quivalents ACF2 ou Top Secret permettent de dterminer quels sont les noms de travaux et les ID utilisateur (avec ou sans mot de passe) qui peuvent tre soumis par EEWSERVE. Tivoli Workload Scheduler ne prend pas en charge lutilisation de la scurit CA-7.

Scurit de la console
Le travail EEWSERVE (trait plus tard) est entirement propritaire de la console lors de laffichage du flux de travaux et de lenvoi de commandes CA-7. Il doit tre autoris utiliser une console tendue. Contactez votre administrateur de scurit pour vous en assurer. Notez que CA-7 doit tre configur pour permettre des utilisateurs dmettre des commandes modify via les consoles principales ou tendues. OPERCMDS doit tre modifi pour permettre cette fonctionnalit, si ce nest dj fait. Reportez-vous galement la section Variables SYSTSIN pour plus dinformations sur lindication dun ID utilisateur dautorit. La scurit externe (voir Scurit ci-dessus) permet dautoriser lutilisateur CA-7 indiqu pour EEWSERVE, car Workload Scheduler ne prend pas en charge lutilisation dun mot de passe avec le nom dutilisateur.

Dmarrage
Excutez les tapes suivantes : 1. Personnalisez et lancez la procdure EEWSPACE (en suivant les instructions commentes incluses) pour dmarrer lagent tendu Gateway Data Space. Le travail doit tre une tche dmarre et ne doit pas tre annul. Reportez-vous la section Variables SYSTSINpour une description des paramtres. EEWSPACE cre lespace mmoire et installe la sortie IEFU84. Pour terminer le travail, utilisez la commande STOP EEWSPACE partir de nimporte quelle console z/OS. Remarques : a. EEWSPACE doit tre en fonctionnement avant le dmarrage dEEWSERVE. b. Arrtez EEWSERVE avant darrter EEWSPACE. 2. Personnalisez et lancez la procdure EEWSERVE en suivant les instructions commentes incluses. Reportez-vous la section Variables SYSTSIN pour une description des paramtres. 3. Pour terminer le travail, utilisez la commande STOP EEWSERVE partir de nimporte quelle console z/OS.

Variables SYSTSIN
Les variables SYSTSIN sont dcrites ci-dessous. Vous pouvez modifier les paramtres en fonction de la configuration de votre site. Les paramtres par dfaut sont indiqus entre parenthses.

Chapitre 24. Introduction

145

Tableau 21. Variables SYSTSIN Variable CA7INTERFACE(CONSOLE) Description CONSOLE, seule interface prise en charge pour CA-7, est la valeur par dfaut de cette variable. Attribuez-lui la valeur Non pour ne pas utiliser cette interface. Nom de lespace adresse de la rgion de contrle CA-7. Ignor si CA-7 nest pas utilis. Options de ldition CA-7. La valeur par dfaut est dtermine par lentre du tableau des vecteurs du sous-systme CA-7 et ne doit pas tre modifie sauf sur indication du personnel de maintenance dIBM. Cette variable sapplique uniquement linterface CA7. Le nombre reprsente lintervalle minimal (en heures et minutes) au-del duquel il est possible de lancer le mme travail partir de Tivoli Workload Scheduler sans indiquer de valeur diffrente pour SCHID. La valeur par dfaut est dfinie volontairement sur 9999, valeur incorrecte, de faon pouvoir distinguer les cas o la variable nest pas utilise. Le cas chant, elle doit tre indique au format HHMM. Par exemple : v CA7SPAN(0010) signifie 10 minutes. v CA7SPAN(0130) signifie 1 heure 30 minutes. Pour plus dinformations, reportez-vous la section Autres conseils pour CA-7 la page 161. Intervalle minimal en minutes (quatre chiffres) au-del duquel il est possible de lancer le mme travail partir de Tivoli Workload Scheduler sans indiquer de valeur diffrente pour SCHID. Ignorez cette variable si vous attribuez CA7INTERFACE la valeur NO. CA7SUBSYSTEM(UC07) CA7USER(CA7CNSL) Nom du sous-systme CA-7. ID utilisateur utilis pour excuter des commandes CA-7. Il est ignor si CA-7 nest pas utilis.

CA7NAME(CA7ONL)

CA7OPTIONS(X32)

CA7SPAN(9999)

146

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 21. Variables SYSTSIN (suite) Variable COMPLETIONCODE(LASTSTEP/MAXSTEP) Description Option de code dachvement de travail plusieurs tapes JES. LASTSTEP, valeur par dfaut, indique que le code dachvement dun travail plusieurs tapes JES est dtermin par la dernire tape excute du travail. MAXSTEP indique que le code dachvement est dtermin par le code dachvement le plus lev de toutes les tapes excutes du travail. Cette variable dtermine la valeur par dfaut des travaux dont loption nest pas remplace dans la configuration Tivoli Workload Scheduler. Si cette variable a la valeur YES, la passerelle met des messages de diagnostic. Utilise uniquement avec le personnel de maintenance IBM. Nom du sous-systme utilis par la pile TCPIP Interlink. Ignor si Interlink nest pas utilis comme pile TCPIP. Caractre de reconnaissance de commande de travail. La valeur par dfaut est le symbole du dollar ($) pour les systmes JES2 et un astrisque (*) pour les systmes JES3. Cette variable doit tre modifie uniquement si un caractre de reconnaissance de commande diffrent est utilis. Temps dattente maximal dune rponse aux commandes en centimes de seconde. Ignorez cette variable si vous attribuez CA7INTERFACE la valeur NO. Quantit de mmoire, en mgaoctets, utilise par chaque console tendue elle-mme utilise par la passerelle. Ignorez cette variable si vous attribuez CA7INTERFACE la valeur NO. PIF, seule interface prise en charge pour OPC ou Tivoli Workload Scheduler pour z/OS est la valeur par dfaut de cette variable. Attribuez-lui la valeur NO pour ne pas utiliser cette interface.

DEBUG(NO)

INTERLINKSUBSYSTEM(ACSS)

JESCMDCHR($)

MAXWAIT(500)

MCSSTORAGE(3)

OPCINTERFACE(PIF)

Chapitre 24. Introduction

147

Tableau 21. Variables SYSTSIN (suite) Variable OPCMSGCLASS(*) Description Classe de message pour les journaux de messages allous de manire dynamique et utiliss par OPC ou Tivoli Workload Scheduler pour z/OS. Lastrisque permet de dfinir la classe de manire identique EEWSERVE. Ignor si OPC ou Tivoli Workload Scheduler pour z/OS nest pas utilis. Nom de sous-systme utilis pour les communications avec la rgion de contrle OPC ou Tivoli Workload Scheduler pour z/OS. La valeur par dfaut, 0 0 0 0, permet laccs par nimporte quel hte. Pour une meilleure scurit, entrez ladresse IP de lhte Workload Scheduler de z/OS x-agent. Remarque : Nincluez pas le . (point) entre les 0 dans votre code. Les points apparaissent laffichage ! Numro de port TCP utilis par Tivoli Workload Scheduler et la passerelle pour les communications. Il doit tre identique la valeur entre dans la zone Adresse TCP de la dfinition du poste de travail z/OS x-agent. Lorsque cette variable a la valeur YES, les informations de trace sont achemines dans DDNAME SYSTSPRT. Nombre maximal de messages mettre en file dattente dans une console tendue. Prfixe utilis par lagent tendu de z/OS sous la forme des quatre premiers caractres des noms de console tendus. Il est galement utilis sous la forme des quatre premiers caractres du programme de lecture interne DDNAMES. Ne le modifiez que sur instruction du personnel de maintenance IBM. Lorsque cette variable a la valeur YES, les fins anormales entranent un vidage SVC. Utilise uniquement avec le personnel de maintenance IBM. Fournisseur de pile TCPIP (IBM, INTERLINK ou OPENCONNECT).

OPCSUBSYSTEM(OPCS)

PEERADDRESS(0 0 0 0)

PORT(5000)

PUTLINE(YES)

QLIMIT(2000)

SUBSYS(UNIS)

SVCDUMP(NO)

TCPIPSTACK(IBM)

148

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 21. Variables SYSTSIN (suite) Variable TCPNAME(TCPIP) Description Nom de lespace adresse TCPIP lorsque la version IBM de la pile TCPIP est utilise. Caractre de rsiliation de transaction. Ne modifiez pas la valeur par dfaut, sauf sur instruction du personnel de maintenance IBM. Lorsque cette variable a la valeur YES, les informations de trace sont achemines dans SYSLOG sous la forme dinformations WTP. Cela peut savrer utile si SYSTSPRT ne rpond pas vos besoins. Lorsque vous utilisez CA-7, PUTLINE(YES) et WTP(NO) sont ncessaires en cas de prsence de la variable DEBUG(YES). ZOSV1R2(NO) Dfinie sur la valeur YES si vous utilisez linterface JES3 avec z/OS V1R2 ou une version ultrieure. Ce paramtre est ignor si vous nutilisez pas linterface JES3 , car : v Si vous utilisez linterface JES2, le niveau du systme dexploitation na aucune incidence sur le produit. v Si vous utilisez les interfaces CA7 ou Tivoli Workload Scheduler pour z/OS, la prise en charge de z/OS V1R2 ou version ultrieure est assure si ldition du ou des sous-systmes correspondants le permet.

TERMINATOR(X25)

WTP(NO)

Version de la passerelle z/OS


La version dEEWSERVE (et EEWSPACE) apparat dans la premire ligne du journal EEWSERVE (et EEWSPACE). Par exemple :
EEWTCP10 VERSION RELEASE MODIFICATION LEVEL = VxRyMz

, o VxRyMz contient la version, ldition et les niveaux de modification.

Chapitre 24. Introduction

149

150

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 25. Configuration et fonctionnement


Tivoli Workload Scheduler lance les travaux sur un agent tendu pour poste de travail fonctionnant sous z/OS. Lagent tendu pour z/OS est dfini dans une dfinition de poste travail Tivoli Workload Scheduler standard, laquelle lui attribue un nom et identifie la mthode daccs utiliser. Lagent tendu pour poste de travail z/OS est une dfinition de poste de travail lie une instance du systme z/OS. Pour lancer un travail sur un agent tendu pour poste de travail z/OS, Tivoli Workload Scheduler excute la mthode daccs et transmet les informations relatives au travail. La mthode daccs communique avec linstance de lhte z/OS et contrle le travail jusqu la fin, en crivant les informations sur la progression et ltat du travail dans le fichier de liste standard du travail. Ce chapitre explique comment : v Crer un fichier doptions pour slectionner des options pour une mthode v Dfinir un agent tendu pour un travail z/OS v Planifier un agent tendu pour un travail z/OS. Reportez-vous au Chapitre 4, Dfinition des postes de travail dagent tendu, la page 31 pour savoir comment dfinir un poste de travail agent tendu dans Tivoli Workload Scheduler.

Fichiers doptions de mthode


Sur toutes les plateformes prises en charge, sauf Compaq Tru64, SGI Irix, et IBM Sequent Dynix, utilisez lditeur doption pour crer les fichiers doptions ncessaires. Pour plus de dtails, reportez-vous la section Chapitre 3, Dfinition des options laide de lEditeur doptions, la page 27.

Fichiers doptions de mthodes sur les plateformes de niveau 2


Sur Compaq Tru64, SGI Irix et IBM Sequent Dynix, crez un fichier doptions pour slectionner les options dune mthode. Le fichier doit prsenter le mme nom de chemin que la mthode, avec lextension opts. Par exemple, crez les fichiers suivants sous UNIX (en supposant que le rpertoire principal Tivoli Workload Scheduler est /usr/lib/tws) :
/usr/lib/tws/methods/mvsca7.opts /usr/lib/tws/methods/mvsjes.opts /usr/lib/tws/methods/mvsopc.opts

Sinon, crez les fichiers suivants sous Windows (en supposant que Tivoli Workload Scheduler est install dans le chemin C:\WIN32APP\tws) :
c:\win32app\tws\methods\mvsca7.opts c:\win32app\tws\methods\mvsjes.opts c:\win32app\tws\methods\mvsopc.opts

Copyright IBM Corp. 2000, 2003

151

Pour mvsca7, mvsjes et mvsopc, les entres du fichier doptions sont :


Entres du fichier doptions LJuser=nom Description Attribue le nom dutilisateur dont se sert la mthode daccs pour lancer des travaux. Il doit sagir dun utilisateur UNIX ou Windows qui soumet les travaux locaux et peut se connecter la passerelle z/OS de Tivoli Workload Scheduler sur le systme z/OS. La valeur par dfaut est le paramtre de connexion dans la dfinition de travail. (Obligatoire) Attribue le nom dutilisateur dont se sert la mthode daccs pour vrifier les dpendances de fichier. Peut tre identique LJuser. (Facultatif) Attribue le nom dutilisateur dont se sert la mthode daccs pour vrifier les travaux non lancs par Tivoli Workload Scheduler sur z/OS et qui servent de dpendances. La valeur par dfaut est root. (Facultatif) Dfinit la vitesse dinterrogation en minutes, permettant de vrifier ltat des travaux z/OS lancs par la mthode. Les valeurs virgule sont admises, par exemple, 0,5 pour 30 secondes ou 1,5 pour une minute et 30 secondes. La valeur par dfaut est 2. Lors de la vrification de travaux non lancs par Tivoli Workload Scheduler sur z/OS et utiliss comme dpendances, la mthode utilise loption locale de Tivoli Workload Scheduler bm check status au lieu de CheckInterval pour dterminer la vitesse dinterrogation. BlockTime=min (Facultatif) Dfinit le temps en minutes pendant lequel la mthode attend une rponse une vrification dtat avant dexpirer. Cette valeur doit tre infrieure la valeur de CheckInterval (dcrite ci-dessus) et loption locale de Tivoli Workload Scheduler bm check status. Les valeurs virgule sont admises, par exemple, 0,5 pour 30 secondes ou 1,5 pour une minute et 30 secondes. La valeur par dfaut est 2. (Facultatif) Dfinit le nombre de tentatives de vrification dtat avant que Tivoli Workload Scheduler crive un message de dpassement de dlai dans le fichier stdlist dun travail et linscrive ltat abend. Pour plus dinformations, reportez-vous CheckInterval et BlockTime ci-dessus. La valeur par dfaut est 10.

CFuser=nom

GSuser=nom

CheckInterval=min

RetryCount=nombre

Dfinition de travaux dans z/OS


Dans z/OS, les travaux planifis avec Tivoli Workload Scheduler sont dfinis comme prescrits pour JES, CA-7 et OPC ou Tivoli Workload Scheduler pour z/OS.

152

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Dfinition de travaux z/OS dans Tivoli Workload Scheduler


Des dfinitions de travaux Tivoli Workload Scheduler sont requises pour chaque travail z/OS que vous envisagez de planifier et de lancer avec Tivoli Workload Scheduler. Ils sont dfinis comme les autres travaux Tivoli Workload Scheduler et comprennent un nom de travail, un nom dutilisateur, des options de nom de script spcial et des options de rcupration facultatives. Pour plus de dtails, reportez-vous la section Chapitre 5, Dfinition des travaux dagent tendu, la page 37.

Syntaxe de dfinition de tche pour les travaux z/OS planifis avec Tivoli Workload Scheduler
Voici des descriptions de la syntaxe de dfinition de tche (ligne de commande scriptname) pour les travaux z/OS que Tivoli Workload Scheduler planifie et lance via les postes de travail dagent tendu laide des mthodes mvsjes (travaux JES2/3), mvsca7 (travaux CA-7) ou mvsopc (travaux OPC ou IBM Tivoli Workload Scheduler pour z/OS). Vous devez spcifier ces paramtres de chane de tche aux emplacements suivants lorsque vous dfinissez les travaux Tivoli Workload Scheduler qui leur sont associs : v Dans la zone Commande de la page Tche de la fentre Proprits - Dfinition du travail, si vous utilisez Job Scheduling Console v En tant quarguments du mot cl scriptname dans linstruction de dfinition du travail, si vous utilisez la ligne de commande Tivoli Workload Scheduler v En tant quarguments du mot cl JOBCMD dans linstruction JOBREC du fichier SCRIPTLIB de Tivoli Workload Scheduler pour z/OS, si vous procdez une planification dans un environnement de bout en bout

Pour les travaux JES :


La syntaxe est la suivante :
jeu_donnes [<|= code_cond]

o : jeu_donnes Nom du jeu de donnes JES ou du jeu de donnes partitionn. code_cond Code de condition qui indique laboutissement dun travail. Sil est prcd du signe <, le code de condition doit tre infrieur ou gal cette valeur. Sil est prcd du signe =, le code de condition doit tre gal cette valeur. Sil est omis, = 0000 est utilis. Notez que loprateur (< ou =) doit tre prcd et suivi dun espace. Exemple :
gold.apayable.cntl(apayjob1) = 0004

Pour les travaux CA-7 :


La syntaxe est la suivante :
nom_travail [SCHID(nnn)] [CC(nnnn) [RO(EQ|LT|GT|GE|LE|NE|#S|IG|NO) [SET(SKP|NTR|NDB) ] ] ] [...]

Chapitre 25. Configuration et fonctionnement

153

o : nom_travail Nom du travail dans CA-7. SCHID ID dagenda (nombre compris entre 1 et 255) affecter au travail. CC RO SET Code de condition utilis avec RO et indiquant laboutissement dun travail. Oprateur relationnel pour le code de condition CC. Dfinit des options de travail permettant dignorer la prochaine excution planifie (SKP), de dsactiver le dclenchement normal du travail (NTR) ou dignorer le chargement de la base de donnes lors de lexcution (NDB).

Pour avoir des descriptions compltes des paramtres, reportez-vous votre guide de commandes CA-7. Exemple :
ARCVJOB SCHID(203) CC(0001) RO(EQ) SET(NDB)

Pour les travaux OPC ou Tivoli Workload Scheduler pour z/OS :


La syntaxe est la suivante :
appl [IA(aammjjhhmm)|IATIME(hhmm) [PRIORITY(pri) [CPDEPR(Y|N|P|S) ] [...] ] ] [DEADLINE(aammjjhhmm)|DEADLINETIME(hhmm) ]

o : appl IA Nom de lapplication OPC ou Tivoli Workload Scheduler pour z/OS insrer dans le plan actuel. Date et heure darrive de lentre au format : aammjjhhmm .

IATIME Heure darrive de lentre au format : hhmm. DEADLINE Date et heure darrive du dlai au format : aammjjhhmm. DEADLINETIME Heure darrive du dlai au format : hhmm. PRIORITY Priorit (1-9) dexcution de lapplication. CPDEPR Slection de la rsolution de dpendance du plan actuel. Y N P S Ajouter toutes les dpendances successeurs et prdcesseurs. Ne pas ajouter de dpendances. (Valeur par dfaut.) Ajouter des dpendances prdcesseurs. Ajouter des dpendances successeurs.

Pour avoir une description complte des paramtres, reportez-vous votre documentation OPC ou Tivoli Workload Scheduler pour z/OS. Exemple :

154

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

PREFABJOB44 IA(0202181000) PRIORITY(5) CPDEPR(Y)

Syntaxe de dfinition de tche pour les travaux z/OS


Voici la description de la syntaxe de dfinition de tche (ligne de commande scriptname) pour les travaux z/OS qui nont pas t lancs par Tivoli Workload Scheduler, mais dont lexcution doit tre contrle. Lexcution des travaux z/OS peut tre utilise comme dpendance follows pour les travaux lancs par Tivoli Workload Scheduler. Les travaux non Tivoli Workload Scheduler peuvent tre JES, CA-7, OPC ou Tivoli Workload Scheduler pour z/OS. La syntaxe de base est la suivante :
travail_tws follows agent_tendu::"travail_mvs"

o : travail_tws Nom du travail Tivoli Workload Scheduler qui dpend de la fin du travail z/OS indiqu. agent_tendu Nom du poste de travail agent tendu Tivoli Workload Scheduler associ avec le planificateur dun travail z/OS savoir, agent dfini avec la mthode mvsjes, mvsca7 ou mvsopc. Notez que les deux signes deux-points sont un dlimiteur obligatoire. travail_mvs Identification du travail z/OS. Notez que cette chane doit tre dlimite par des guillemets. Reportez-vous aux descriptions de syntaxe ci-dessous.

Pour les travaux JES :


La syntaxe est la suivante :
"nom_travail[<|= code_cond]"

o : nom_travail Nom du travail dans JES. code_cond Code de condition qui indique laboutissement dun travail. Sil est prcd du signe <, le code de condition doit tre infrieur ou gal cette valeur. Sil est prcd du signe =, le code de condition doit tre gal cette valeur. Sil est omis, = 0000 est utilis. Notez que loprateur (< ou =) doit tre prcd et suivi dun espace. Exemple :
travail5 follows poste_travail_jes::"apayable = 0004"

Pour les travaux CA-7 :


La syntaxe est la suivante :
"nom_travail [SCHID(nnn) ] ] ] [...]" [DATE(*|*aajjj)} [SPAN( {* }) {porte } {date } {(date_dbut,heure_dbut,porte) } {(date_dbut,heure_dbut,porte) }
Chapitre 25. Configuration et fonctionnement

155

o : nom_travail Nom du travail dans CA-7. SCHID ID dagenda (nombre compris entre 1 et 255) du travail. DATE Date de journal spcifique rechercher pour le travail. SPAN Etendue des enregistrements de journal rechercher pour le travail. Pour obtenir une description complte des paramtres, reportez-vous votre guide de commandes CA-7. Par exemple :
travaila follows poste_travail::"arcvjob schid(203) span(12)"

Reportez-vous galement la section Autres conseils pour CA-7 la page 161

Pour les travaux OPC ou Tivoli Workload Scheduler pour z/OS :


La syntaxe est la suivante :
"application[IA(aammjjhhmm)|IATIME(hhmm)][...]" [JOBNAME(nom_travail) [OPNO(num) ] ]

o : application Nom de lapplication (flux de travaux) OPC or Tivoli Workload Scheduler pour z/OS du plan actuel. IA Date et heure darrive de lentre.

IATIME Heure darrive de lentre. JOBNAME Nom du travail z/OS. OPNO Numro dopration (1 255). Sil est inclus, lapplication est considre comme termine lorsquelle atteint ce nombre. Pour obtenir une description complte des paramtres, reportez-vous votre documentation OPC ou Tivoli Workload Scheduler pour z/OS. Par exemple
travaila follows poste_travail_opc::"PREFABJOB44 IA(0202181000) JOBNAME(PFJ3)"

Syntaxe des dpendances de fichier (OPENS) sur les fichiers z/OS


Les travaux et les flux de travaux Tivoli Workload Scheduler peuvent utiliser les fichiers z/OS comme dpendances. La syntaxe de base est la suivante :
travail_tws opens agent_tendu#"hlq1.hlq2.hlq3"

o : travail_tws Nom du travail Tivoli Workload Scheduler qui dpend du fichier z/OS indiqu. agentx Nom du poste de travail dagent tendu Tivoli Workload Scheduler associ

156

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

au planificateur dun travail z/OS savoir, agent dfini avec la mthode mvsjes, mvsca7 ou mvsopc. Notez que le signe # est un dlimiteur obligatoire. hlq1.hlq2.hlq3 Identification du fichier z/OS en termes de qualifiant de haut niveau. Notez que cette chane doit tre dlimite par des guillemets. Reportez-vous la section Vrification des fichiers sur z/OS la page 163 pour plus dinformations.

Chapitre 25. Configuration et fonctionnement

157

158

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 26. Informations de rfrence


Prsentation technique
Ce chapitre dcrit les tats des travaux pour un fonctionnement sous JES, CA-7, OPC ou Tivoli Workload Scheduler pour z/OS dans lenvironnement Tivoli Workload Scheduler.

Fonctionnement sous JES


Les informations ci-dessous sappliquent au fonctionnement sous JES.

Lancement des travaux JES


Pour lancer et contrler un travail JES, Tivoli Workload Scheduler transmet le nom des donnes JCL ou lensemble de donnes cloisonn excuter la passerelle z/OS, qui, en retour, le soumet JES. Les soumissions seffectuent laide de programmes de lecture interne attribus de manire dynamique dans JES. La passerelle attribue un programme de lecture interne au dmarrage de chaque tche, puis lui soumet le travail. Lors de la soumission dun travail, le nom du travail et lID de travail JES sont galement entrs dans lespace de table. Lorsquun enregistrement SMF contenant des donnes de planification pertinentes est transmis via la sortie IEFU84, les informations sur le code de condition et le travail sont rendues accessibles Tivoli Workload Scheduler. Or, dans la mesure o Workload Scheduler garde la trace du nom du travail et de lID de travail JES, il est mme de rechercher la tche spcifique quil a soumise. (La passerelle utilise actuellement des enregistrements SMF de type 30, ainsi que des sous-types 1,4 et 5.) Tivoli Workload Scheduler vrifie intervalles rguliers si les travaux soumis sont actifs. Si un travail soumis par Tivoli Workload Scheduler nest pas actif et quaucune information nest disponible son sujet par la sortie IEFU84, ce travail est marqu comme fin anormale sur les crans de Tivoli Workload Scheduler. Cette situation peut se produire si un travail choue pour des raisons de scurit ou de problmes de syntaxe JCL. Etats des travaux pour JES : Le tableau suivant rpertorie les tats des travaux JES relatifs Tivoli Workload Scheduler.
Etat des travaux de Tivoli Workload Scheduler intro wait wait

Etat des travaux JES na Queued na

Commentaire Workload Scheduler dmarre la mthode.

Si cet tat est maintenu pour ce travail, cela peut tre d une violation de la scurit dans z/OS. Vrifiez le travail dans le systme z/OS. Le travail est en cours dexcution. Le code de condition du travail rpond aux critres dexcution dans la dfinition du travail de Tivoli Workload Scheduler.

exec succ

En cours dexcution Termin

Copyright IBM Corp. 2000, 2003

159

Etat des travaux de Tivoli Workload Scheduler abend

Etat des travaux JES Termin

Commentaire Le code de condition du travail ne remplit pas les critres dexcution dans la dfinition du travail de Tivoli Workload Scheduler, ou bien une fin anormale lie au systme ou lutilisateur sest produite. Les codes de fin anormale du systme, en mode hexadcimal, ont pour prfixe S, tandis que les codes de fin anormale pour les utilisateurs, en mode dcimal, ont pour prfixe U. Les deux types de code sont crits dans le fichier stdlist du travail. Etat inconnu. Cet vnement ne peut se produire que lorsque la tche vrifie est utilise comme une dpendance.

extrn

na

Vrification des travaux JES : Pour vrifier un travail JES qui na pas t lanc par Tivoli Workload Scheduler, le nom de ce travail est transmis la passerelle par Tivoli Workload Scheduler. Dans la mesure o Tivoli Workload Scheduler na pas soumis le travail, lID de travail JES nest pas disponible. La passerelle entre le nom dans lespace de table et attend que les informations sur la tche apparaissent dans les enregistrements SMF transmis via la sortie IEFU84.

Fonctionnement avec CA-7


Les informations ci-dessous sappliquent au fonctionnement avec CA-7.

Lancement des travaux CA-7


Pour lancer et contrler un travail CA-7, Tivoli Workload Scheduler transmet le nom du travail, et accessoirement le schedID de CA-7, excuter sur la passerelle z/OS. Au moment de la demande de soumission, la passerelle reoit le numro de travail CA-7 utilis pour assurer le suivi de toutes les activits venir pour ce travail. Il est important de noter que CA-7 doit lui-mme tre autoris accepter les commandes provenant de la console pour que ce mcanisme puisse fonctionner. Reportez-vous la documentation sur CA-7 pour plus dinformations sur les commandes de modification et de connexion.

Etats des travaux pour CA-7


Le tableau suivant liste les tats des travaux CA-7 relatifs Tivoli Workload Scheduler.
Etat du travail de Tivoli Workload Scheduler intro wait

Etat du travail de CA-7 na Request Queue ou Ready Queue

Commentaire Workload Scheduler dmarre la mthode. Ltat wait peut aussi indiquer que le travail a t dplac de la file dattente Active la file dattente Request suite une fin anormale. Le travail reste dans la file dattente Request, avec une invite de redmarrage, jusqu ce que loprateur procde son redmarrage ou son annulation.

160

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Etat du travail de Tivoli Workload Scheduler exec succ

Etat du travail de CA-7 Active Queue Termin

Commentaire

Le code de condition du travail rpond aux critres dexcution dans la dfinition du travail de Tivoli Workload Scheduler. Le code de condition du travail ne remplit pas les critres dexcution dans la dfinition du travail de Tivoli Workload Scheduler. Prenez galement connaissance des remarques ci-aprs. Etat inconnu. Cet vnement ne peut se produire que lorsque la tche recherche est utilise comme une dpendance. Prenez galement connaissance des remarques ci-aprs.

abend

na

extrn

na

Remarque : Si ltat abend ou extrn est maintenu pour ce travail, cela peut tre d une violation de la scurit dans z/OS. Vrifiez le travail dans le systme z/OS.

Vrification des travaux CA-7


Pour vrifier un travail CA-7 qui na pas t lanc par Tivoli Workload Scheduler, le nom de ce travail, et accessoirement le schedID de CA-7, est transmis la passerelle par Tivoli Workload Scheduler. Pour voir si le travail est actuellement en cours de planification ou dexcution par CA-7, la passerelle recherche les files dattente suivantes, dans cet ordre : Request Queue, Ready Queue et Active Queue. Si le travail nest pas trouv, Tivoli Workload Scheduler procde une revrification une vitesse dfinie par la valeur bm check status dans son fichier doptions locales.

Autres conseils pour CA-7


v Lors de lutilisation de CA-7, CA7USER doit aussi correspondre un id UNIX valide. v La limitation qui, dans les versions prcdentes du produit, obligeait les utilisateurs identifier les occurrences de manire unique lors de la dfinition des travaux CA-7 dans Tivoli Workload Scheduler (cest--dire en ajoutant les oprandes SCHID et/ou SPAN) est dsormais supprime grce au nouveau paramtre dinitialisation CA7SPAN. La logique relative limplmentation de CA7SPAN est la suivante : si SPAN est spcifi dans la dfinition Tivoli Workload Scheduler dun travail, alors CA7SPAN est ignor. Si SPAN nest pas spcifi (ou ne peut pas tre spcifi, comme dans le cas des travaux lancs par Tivoli Workload Scheduler), alors CA7SPAN est pris en considration et sa valeur est utilise dans les interrogations de type SPAN CA7. Cela contourne la limitation selon laquelle chaque occurrence doit tre identifie de manire unique tout en gardant la possibilit de lancer le mme travail partir de Tivoli Workload Scheduler avec le mme oprateur SCHID, la seule condition que lintervalle entre 2 soumissions soit suprieur la valeur spcifie avec CA7SPAN. Il est important de savoir que, si elle est spcifie, la valeur de CA7SPAN sera utilise dans toutes les interrogations CA7 (si elles concernent des travaux dmarrs par Tivoli Workload Scheduler ou si elles sont mises pour vrifier les dpendances inter-rseau pour les travaux qui ne sont pas lancs par Tivoli
Chapitre 26. Informations de rfrence

161

Workload Scheduler) lexception des travaux pour lesquels SPAN est spcifi dans leur dfinition Tivoli Workload Scheduler. v Si vous excutez des produits qui suppriment les messages de la console (comme AFOPER), assurez-vous quils ne suppriment pas les messages CA-7.

Fonctionnement avec linterface OPC ou avec Tivoli Workload Scheduler pour z/OS
Les informations ci-dessous sappliquent au fonctionnement avec linterface OPC ou avec Tivoli Workload Scheduler pour z/OS.

Lancement dun travail OPC ou Tivoli Workload Scheduler pour z/OS


Pour Lancer et contrler un travail OPC ou Tivoli Workload Scheduler pour z/OS, Tivoli Workload Scheduler transmet le nom de lapplication et les autres paramtres facultatifs excuter sur la passerelle z/OS. Si lapplication existe dans la base de donnes OPC ou Tivoli Workload Scheduler pour z/OS, elle est insre dans le plan en cours. La date et lheure darrive entrs, lchance de la date et lheure darrive, le niveau de priorit et les paramtres de rsolution de dpendance automatiques, le cas chant, remplacent toutes valeurs spcifies dans OPC ou Tivoli Workload Scheduler pour z/OS. A une vitesse dfinie par la valeur CheckInterval du fichier doptions de la mthode, Tivoli Workload Scheduler vrifie ltat de loccurrence (application) dans OPC ou Tivoli Workload Scheduler pour z/OS.

Etats de fonctionnement dOPC et de Tivoli Workload Scheduler pour z/OS


Le tableau suivant rpertorie les diffrents tats de fonctionnement dOPC et de Tivoli Workload Scheduler pour z/OS relatifs au programme Tivoli Workload Scheduler.
Etat du travail Tivoli Workload Scheduler wait wait wait wait exec succ abend abend abend abend extrn Etat du fonctionnement dOPC ou de Tivoli Workload Scheduler pour z/OS suspendu indtermin wait prt lanc termin interrompu erreur supprim non disponible non disponible

Etats des occurrences dOPC et de Tivoli Workload Scheduler pour z/OS


Le tableau suivant liste les tats des occurrences de fonctionnement dOPC et de Tivoli Workload Scheduler pour z/OS relatifs au programme Tivoli Workload Scheduler.

162

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Etat du flux de travaux de Etat des occurrences dOPC ou de Tivoli Workload Tivoli Workload Scheduler Scheduler pour z/OS wait wait exec succ abend abend abend extrn suspendu indtermin lanc termin erreur supprim non disponible Etat non disponible inconnu. Ne peut se produire que lors de la vrification dun travail utilis comme une dpendance. Prenez galement connaissance des remarques ci-aprs.

Vrification de travaux OPC ou Tivoli Workload Scheduler pour z/OS


Pour vrifier un travail OPC ou Tivoli Workload Scheduler pour z/OS qui na pas t lanc par Tivoli Workload Scheduler, le nom de lapplication, et ventuellement lopration, est transmis la passerelle. Cette vrification permet de voir si loccurrence ou lopration se trouve dans le plan actuel. Si elle nest pas trouve, Tivoli Workload Scheduler procde une revrification une vitesse dfinie par la valeur bm check status dans son fichier doptions locales.

Vrification des fichiers sur z/OS


Un fichier peut tre utilis comme une dpendance dun travail dans Tivoli Workload Scheduler. Pour rechercher lexistence dun fichier sur z/OS, Tivoli Workload Scheduler transmet le nom de ce fichier la passerelle. Le nom de fichier se voit affecter la valeur DISP=OLD et est considr comme existant si les conditions ci-aprs sont remplies : v Les donnes sont inscrites dans le fichier catalogue. v Elles sont alloues. v Elles ne sont pas utilises par une autre tche. Si le fichier (ensemble des donnes) nexiste pas, Tivoli Workload Scheduler continue patienter et recherche le fichier intervalles prdfinis. Notez que Tivoli Workload Scheduler ne peut utiliser que des noms de fichier complets pour les fichiers non partitionns. Si un nom de groupe de fichiers de gnration doit tre utilis, le nom complet doit tre spcifi, par opposition au nom relatif (par ex. xxxxx.xxxxx(-1) ne peut pas tre utilis).

Considrations de dlais
Lors de la vrification de travaux z/OS qui nont pas t lancs par Tivoli Workload Scheduler, certaines questions de dlai sont essentielles pour garantir que les dpendances de travaux associs sont correctement rsolues. Ces questions sont la consquence de la conception par Tivoli Workload Scheduler dune journe de traitement. Des explications compltes se trouvent dans le manuel Tivoli Workload Scheduler - Guide de rfrence. En bref, Tivoli Workload Scheduler rgnre la planification de sa production quotidiennement une heure prdfinie ; par exemple, 6h00 tous les matins. Pour maintenir une relation entre les travaux excuts sous z/OS et ceux excuts sous Tivoli Workload Scheduler, une synchronisation entre les deux environnements simpose. Si, par exemple, un
Chapitre 26. Informations de rfrence

163

travail z/OS est dmarr en dehors de Tivoli Workload Scheduler et quil se termine avant le dbut de la journe de traitement de Tivoli Workload Scheduler, il ne sera pas visible dans Tivoli Workload Scheduler et ne devra pas tre utilis dans une dpendance de travail Tivoli Workload Scheduler. Tivoli Workload Scheduler nessaie pas de dterminer ltat des travaux qui se sont termins avant le dbut prdfini de sa journe. Si la synchronisation nest pas prise en compte, telle quelle est explique ci-dessus, Tivoli Workload Scheduler peut patienter indfiniment pour rsoudre une dpendance de travail. Un problme similaire peut se produire suite un chec de communication entre les environnements z/OS et Tivoli Workload Scheduler, empchant Tivoli Workload Scheduler de dterminer ltat dun travail z/OS pour rpondre une de ses dpendances.

Informations relatives au diagnostic


Les travaux z/OS soumis par Tivoli Workload Scheduler peuvent ne pas se terminer pour plusieurs raisons. Lors de lexcution de la soumission, ltape correspondant lchec dun travail dtermine la quantit dinformations disponible et fournie par Tivoli Workload Scheduler : v Si un travail choue avant davoir effectivement dmarr (ce qui est gnralement le rsultat dun problme JCL ou de scurit), Tivoli Workload Scheduler reconnat que ce travail nexiste plus et le marque comme termin anormalement dans les affichages du gestionnaire de console (Conman). Aucune information supplmentaire nest fournie. v Si un travail choue aprs avoir dmarr, Tivoli Workload Scheduler : 1. Obtient son code de condition et son code de fin anormale par lutilisateur, le cas chant 2. Les crit dans le fichier de liste standard du travail 3. Marque le travail comme abend dans le gestionnaire de console (Conman) ou dans les affichages de la Job Scheduling Console Les listes standard de travaux peuvent tre affiches dans le gestionnaire de console (Conman) et laide de Job Scheduling Console.

Messages de la passerelle
Des messages informatifs sont crs dynamiquement par le programme de passerelle pour z/OS. En plus des informations relatives la condition, ces messages peuvent comprendre : v Un horodatage au format aammjj hhmmss v Un nom de module v Un libell au sein du module v Le nom dune macro v Un code motif (registre 0) v Un code retour (registre 15) Les messages de passerelle z/OS sont rpertoris ci-dessous. Pour les noms de module (module), voir ci-dessous.
EEWI01E yymmdd hhmmss module FAILED, MACRO macro NEAR LABEL label WITH RETURN CODE = code & REASON CODE = code EEWI02E yymmdd hhmmss module FAILED, MACRO macro NEAR LABEL label WITH RETURN CODE = code & ERROR NUMBER = err

164

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

EEWI03I yymmdd hhmmss module ISSUED, MACRO macro NEAR LABEL label TO OBTAIN SOCKET DESCRIPTOR = desc EEWI04I yymmdd hhmmss module ISSUED, MACRO macro NEAR LABEL label TO OBTAIN HOSTNAME = host EEWI05I yymmdd hhmmss module TCPIP ADDRESS = ipaddress EEWI06I yymmdd hhmmss module name = name EEWI07I yymmdd hhmmss module ISSUED, MACRO macro NEAR LABEL label FOR num CHARACTER MESSAGE = msg EEWI08S yymmdd hhmmss module FAILED AT OFFSET offset EEWI09E yymmdd hhmmss module FAILED, MACRO macro NEAR LABEL label WITH RETURN CODE = code EEWI10S yymmdd hhmmss module ABENDED WITH ASSOCIATED REASON CODE code EEWI11I yymmdd hhmmss module CONSOLE name ACTIVATED WITH CONSOLE ID id EEWI12I yymmdd hhmmss module SUBTASK name COMPLETED WITH COMPLETION CODE code EEWI13I yymmdd hhmmss module CALL TO "name" NEAR LABEL label COMPLETED WITH COMPLETION CODE code EEWI14S yymmdd hhmmss module INVALID DATA SPACE FOUND NEAR LABEL label EEWI15E yymmdd hhmmss module DATASET "dset" DDNAME "dd" FAILED TO OPEN NEAR LABEL label EEWI16I yymmdd hhmmss module SUBMITTED JOB "job" WITH JES IDENTIFICATION "id" EEWI17I yymmdd hhmmss module PEERADDRESS = ipaddress EEWI18E yymmdd hhmmss module INVALID TERMINATOR term EEWI19E yymmdd hhmmss module NEAR LABEL label INVALID VALUE FOUND name = value EEWI20E yymmdd hhmmss module NEAR LABEL label FAILED TO FIND ACTIVE SMF IEFU84 EXIT EEWI21E yymmdd hhmmss errmsg EEWI22I yymmdd hhmmss TASK task MODULE module ISSUED, MACRO macro NEAR LABEL label TO CLOSE SOCKET DESCRIPTOR socket EEWI24E yymmdd hhmmss module NEAR LABEL label EEWI25I yymmdd hhmmss module NEAR LABEL label APPLICATION appl WAS INSERTED IN CURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME iadatetime EEWI26I yymmdd hhmmss module NEAR LABEL label JOB jobname(jobid) EEWI27I yymmdd hhmmss APPLICATION appl WAS INSERTED IN CURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME iadatetime EEWI28W yymmdd hhmmss APPLICATION appl WAS NOT INSERTED IN CURRENT PLAN WITH INPUT ARRIVAL DATE AND TIME iadatetime EEWI29I yymmdd hhmmss TASK task MODULE module ISSUED, MACRO macro NEAR LABEL label WITH RETURN CODE = code AND ERROR NUMBER = err EEWI30S yymmdd hhmmss module CA7SPAN MUST BE 4 DIGITS IN FORMAT HHMM

Les noms de module sont :


Nom du module EEWPRE84 EEWTCP00 EEWTCP01 EEWTCP02 EEWTCP05 EEWTCP07 Description Sortie SMF prcdente Routine de traitement principale Vhicule des tests serveur Routine principale pour la cration de lespace de donnes Fait mettre le message dchec par la routine ESTAE Recherche le nom de lensemble de donnes associ lACB/DCB ouvert

Chapitre 26. Informations de rfrence

165

Nom du module EEWTCP08 EEWTCP10 EEWTCP15 EEWTCP20 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

Description Recherche le nom de lensemble de donnes associ au nom de la dfinition des donnes Initialise et examine les variables Localise et initialise les blocs de contrle Localise et initialise les blocs de contrle Vhicule des tests client Vhicule des tests client Vhicule des tests client Serveur concurrent Fournisseur Interlink de protocole TCP/IP pour serveurs concurrents Serveur concurrent pour la pile TCP/IP Openconnect Tche du serveur enfant Tche du serveur enfant pour la pile TCP/IP Interlink Tche du serveur enfant Sortie de lenregistrement SMF pour SMFEWTM Interface OPC Affichage de linterface OPC CA7 BTI Emet la commande et attend la rponse Emet la commande TERROR pour mettre en forme les messages et met la commande WTOS Recherche une sous-chane au sein dune chane Emet la commande CA-7 et attend la rponse Sortie de STIMER pour soumettre ECB via un paramtre Appelle IKJEFF02 pour extraire la mmoire tampon laide dEEWTCP99 La routine ESTAE met un message dchec Appelle IKJEFF19 (DAIRFAIL/VSAMFAIL) pour mettre un message Appelle IKJEFF02 pour mettre un message partir de EEWTCP99 Tableau de messages Vrification du travail CA7 Vrification du gestionnaire de demandes dapplications Vrification du gestionnaire de demandes de fichiers Vrification du gestionnaire de demandes de travaux Vrification du gestionnaire de demandes doprations Enumration des travaux Chiffrement/dchiffrement de la chane Gestionnaire de demande dnumration de travaux Gestionnaire de demande de travaux gratuits

166

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Nom du module EEWTCPIA EEWTCPIE EEWTCPKJ EEWTCPKO EEWTCPL7 EEWTCPLJ EEWTCPLO EEWTCPQ7 EEWTCPQJ EEWTCPQO EEWTCPQS EEWTCPRC EEWTCPSC EEWTCPSE EEWTCPUC EEWTCPWT EEWTCPXX

Description Insertion dune application Initialisation dune chane Gestionnaire de demande de suppression des travaux Suppression de lapplication OPC Lancement du gestionnaire de demande de travaux CA-7 Lancement du gestionnaire de demande de travaux Insertion de lapplication OPC Interrogation du gestionnaire de demande de travaux CA-7 Interrogation du gestionnaire de demande de travaux Interrogation de lapplication OPC Interrogation du gestionnaire de demande de sous-systmes Code retour Fin anormale de lopration du systme Chiffrement/dchiffrement de la chane Fin anormale en raison de lutilisateur Attendre pendant le dlai spcifi Gestionnaire de demandes incorrect

Pour lidentification des incidents, faites en sorte dobtenir le journal JES pour les tches EEWSPACE et EEWSERVE lances. Cela vous aidera dterminer le contexte dans lequel un message a t mis. En fonction de linterface de planification des travaux que vous utilisez, vous pouvez obtenir dautres informations utiles partir dautres journaux. Par exemple, si vous utilisez CA-7, vous devez obtenir les lments suivants : v Le journal CA-7 v Le journal de lintervalle couvrant la priode de test v Le journal des travaux spcifiant le travail qui a provoqu lerreur (le cas chant) v Le fichier script UNIX relatif ce travail

Chapitre 26. Informations de rfrence

167

168

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 6. Maintenabilit commune

Copyright IBM Corp. 2000, 2003

169

170

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 27. Rfrence aux agents tendus


Ce chapitre dcrit linterface dagent tendu et fournit des informations aux programmeurs dsireux de crer des mthodes daccs personnalises.

Que sont les agents tendus ?


Les agents tendus permettent dtendre les fonctions de planification de travaux de Tivoli Workload Scheduler vers dautres systmes et vers dautres applications. Un agent tendu est un poste de travail disposant dun hte et dune mthode daccs. Lhte peut correspondre nimporte quel autre poste de travail lexception dun autre agent tendu. La mthode daccs correspond un script ou un programme fourni par lutilisateur ou par IBM, qui est excut par lhte chaque fois que lagent tendu est rfrenc dans le plan de production. Par exemple, pour lancer un travail sur un agent tendu, lhte excute la mthode daccs en transmettant les informations relatives au travail sous la forme doptions de ligne de commande. La mthode daccs communique avec le systme ou lapplication externe pour lancer le travail et renvoie le statut de ce travail.

Dfinition de poste de travail


Tous les agents tendus doivent prsenter une dfinition de poste de travail logique. Ce poste de travail logique doit tre hberg par un poste de travail physique Tivoli Workload Scheduler : un poste de travail matre, un poste de travail gestionnaire de domaine ou un poste de travail tolrant aux pannes. La dfinition du poste de travail de lagent tendu rfrence le nom de la mthode daccs ainsi que le nom du poste de travail de lhte. Lorsque des travaux sont lancs sur le poste de travail de lagent tendu, la mthode daccs est appele. Elle transmet les informations relatives aux travaux au systme externe.

Interface de mthode daccs


Linterface entre Tivoli Workload Scheduler et une mthode daccs est compose des informations transmises la mthode par la ligne de commande et des messages renvoys au planificateur dans stdout.

Syntaxe de la ligne de commande de la mthode


Lhte du planificateur excute une mthode daccs laide de la syntaxe de ligne de commande suivante : nommthode -t o : nommthode Dsigne le nom de fichier de la mthode daccs. Toutes les mthodes daccs doivent figurer dans le rpertoire : racine_TWS/methods -t tche Dsigne la tche effectuer, o tche correspond lune des tches suivantes : LJ
Copyright IBM Corp. 2000, 2003

tche options -- chanetche

Lance un travail.

171

MJ

Gre un travail lanc prcdemment. Cette option permet de se resynchroniser si une tche LJ prcdente sest arrte de manire inattendue. Vrifie la disponibilit dun fichier. Cette option permet de vrifier les dpendances opens de fichier. Obtient le statut dun travail. Cette option permet de vrifier les dpendances follows de fichier.

CF GS

options Dsigne les options associes la tche. Pour plus dinformations, reportez-vous la section Options de tche. chanetche Une chane comportant jusqu 255 caractres associe la tche. Reportez-vous la section Options de tche.

Options de tche
Les options de tache sont rpertories dans le tableau ci-aprs. Un X signifie que loption est admise pour la tche.
Tche -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 Options -d X X -l X X -o X X -j X X X X -q -w -S X ljstring mjstring cfstring gsstring Chane de la tche

-c agenttendu,hte,principal Dsigne les noms de planificateur de lagent tendu, de lhte et du gestionnaire de domaine principal, chacun tant spar par une virgule. -n nomnoeud Dsigne le nom de noeud de lordinateur associ lagent tendu, sil existe. Ce nom est dfini dans la zone Noeud de la dfinition de poste de travail de lagent tendu. -p numroport Dsigne le numro du port TCP associ lagent tendu, sil existe. Ce numro est dfini dans la zone Adresse TCP de la dfinition de poste de travail de lagent tendu. -r excutioncourante,excutionspcifique Dsigne le numro dexcution en cours du planificateur et le numro dexcution spcifique associ au travail, spars par une virgule. Les numros dexcution en cours et spcifiques peuvent tre distincts si le travail a t report depuis une excution antcdente. -s fluxtravaux Dsigne le nom du flux de travaux du travail. -d dateplanification,priode Dsigne la date de planification (aammjj) ainsi que la priode quivalente, spare par une virgule. -l utilisateur Dsigne le nom de lutilisateur du travail. Ce nom est dfini dans la zone Connexion de la dfinition du travail.

172

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

-o listestd Dsigne le chemin daccs complet du fichier de liste standard du travail. Toute sortie manant de ce travail doit figurer dans ce fichier. -j nomtravail,id Indique le nom du travail et lidentificateur unique affect par le planificateur, spars par une virgule. Ce nom est dfini dans la zone Nom du travail de la dfinition du travail. -q qualifiant Dsigne le qualifiant qui doit tre utilis dans une commande de test mise par une mthode pour un fichier. -w dlai Indique le temps, exprim en secondes, pendant lequel le planificateur attend une rponse sur un travail externe avant denvoyer un signal SIGTERM la mthode daccs. La valeur par dfaut est 300. -S nouveau nom Indique que le travail est rexcut laide de ce nom, la place du nom de travail dorigine. Dans un script de travail, vous pouvez utiliser la commande jobinfo pour revenir au nom du travail, puis excuter le script diffremment pour chaque itration. Pour plus dinformations, consultez la description de la commande conman rerun dans le manuel IBM Tivoli Workload Scheduler - Guide de rfrence. -- ljstring Utilis avec la tche LJ. La chane provenant de la zone Fichier Script ou la zone Commande de la dfinition du travail. -- mjstring Utilis avec la tche MJ. CDIl sagit des informations fournies au planificateur par la mthode dans une rponse %CJ une tche LJ. Gnralement, elles identifient le travail qui a t lanc. Par exemple, une mthode Unix peut fournir lID processus (PID) pour le travail quelle a lanc, qui est ensuite transmis par le planificateur comme faisant partie dune tche MJ. -- cfstring Utilis avec la tche CF. Pour une dpendance opens de fichier, correspond la chane figurant dans la zone Opens Files de la dfinition du flux de travaux. -- gsstring Utilis avec la tche GS. Dsigne le travail dont le statut est vrifi. Le format est le suivant : followsjob[,idtravail] o : followsjob Correspond la chane figurant dans la liste Follows Sched/Job de la dfinition de flux de travaux. idtravail Correspond un identificateur de travail facultatif reu par le planificateur dans une rponse %CJ une tche GS prcdente.

Chapitre 27. Rfrence aux agents tendus

173

Messages de rponse de mthode


Les mthodes renvoient des informations Tivoli Workload Scheduler sous la forme de messages crits dans stdout. Toutes les lignes commenant par le symbole de pourcentage (%) et finissant par une nouvelle ligne sont considres comme un message. Les messages prsentent le format suivant : %CJ statut [mjstring | idtravail] %JS [tempsuc] %RC cr %UT [messageerreur] o : CJ Change le statut du travail. statut Le statut par lequel le travail est chang. Tous les statuts de travaux du planificateur sont valides lexception de hold et ready. Pour la tche GS, les statuts suivants sont galement valides : ERROR Une erreur sest produite. EXTRN Le statut est inconnu. mjstring Chane pouvant comporter jusqu 255 caractres, que le planificateur inclut dans toute tche MJ associe au travail. Reportez-vous la page 173. idtravail Chane pouvant comporter jusqu 64 caractres, que le planificateur inclut dans toute tche GS associe au travail. Reportez-vous la page 173. JS [tempsuc] Indique quun travail a abouti et fournit la dure de son excution en secondes. RC cr cr est un nombre interprt par Tivoli Workload Scheduler comme code retour du travail de lagent tendu. Le code retour est pris en compte uniquement si une condition de code retour a t dfinie dans la dfinition du travail de lagent tendu. Si ce nest pas le cas, il est ignor et lexcution du travail de lagent tendu est indique par la prsence du message %JS [tempsuc]. Ainsi, si la mthode nenvoie pas le message %RC, laboutissement du travail de lagent tendu est indiqu par la prsence du message %JS [tempsuc].

UT [messageerreur] Indique que la tche requise nest pas supporte par la mthode. Affiche une chane pouvant comporter jusqu 255 caractres, que le planificateur inclura dans son message derreur.

174

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Fichier doptions de mthode


Un fichier doptions de mthode vous permet de spcifier des informations relatives la connexion ainsi que dautres options. Le planificateur lit le fichier, si ce dernier existe, avant dexcuter une mthode. Si ce fichier est modifi aprs le dmarrage du planificateur, les modifications ne prennent effet que lorsque celui-ci a t arrt puis relanc. Ce fichier peut contenir des options du planificateur ainsi que toute autre information relative la mthode. Les options reconnues par le planificateur sont les suivantes : LJuser=nomutilisateur CFuser=nomutilisateur GSuser=nomutilisateur GStimeout=secondes o : LJuser=utilisateur Dsigne la connexion utiliser pour les tches LJ et MJ. La valeur par dfaut correspond la connexion figurant dans la dfinition du travail. CFuser=nomutilisateur Dsigne la connexion utiliser pour la tche CF. La valeur par dfaut est root pour Unix ; pour Windows, il sagit du nom utilisateur du compte sur lequel le planificateur a t install. GSuser=nomutilisateur Dsigne la connexion utiliser pour les tches GS. La valeur par dfaut est root pour Unix ; pour Windows, il sagit du nom utilisateur du compte sur lequel le planificateur a t install. GStimeout=secondes Indique le temps, exprim en secondes, pendant lequel le planificateur attend une rponse avant de supprimer la mthode daccs. La valeur par dfaut est 300. Remarque : Si lhte de lagent tendu fonctionne sous Windows, lutilisateur doit tre dfini en tant quobjet utilisateur du planificateur. Le fichier doptions doit prsenter le mme nom de chemin que ses mthodes daccs, avec lextension de fichier .opts. Par exemple, pour Windows, le nom du chemin daccs dun fichier doptions pour une mthode intitule netmth est : v racine_TWS\methods\netmth.opts (global). v racine_TWS\methods\<nom_unit_centrale>_netmth.opts (local).

Excution de mthode
Les sections ci-aprs dcrivent les changes entre Tivoli Workload Scheduler et une mthode daccs.

Chapitre 27. Rfrence aux agents tendus

175

Tche de lancement dun travail (LJ)


La tche LJ charge la mthode de lagent tendu de lancer un travail sur une application ou un systme externe. Avant dexcuter la mthode, Tivoli Workload Scheduler cre un environnement dexcution. Le paramtre LJuser, lu partir du fichier doptions de la mthode, indique avec quel compte utilisateur la mthode doit tre excute. Si ce paramtre ne figure pas dans le fichier doptions ou que le fichier doptions nexiste pas, le compte utilisateur qui sera utilis correspond celui dfini dans la zone Connexion de la dfinition du travail. En outre, les variables denvironnement suivantes sont dfinies : HOME Le rpertoire principal de lutilisateur de la connexion. LOGNAME Le nom de lutilisateur de la connexion. PATH Pour Unix, il est dfini sur /bin:/usr/bin. Pour Windows, il est dfini sur %SYSTEM%\SYSTEM32. TZ Le fuseau horaire.

Si la mthode ne peut pas tre excute, le travail se voit affecter le statut fail. Lorsquune mthode est en cours dexcution, elle crit des messages son stdout pour indiquer le statut du travail sur le systme externe. Ces messages sont dcrits dans le tableau ci-aprs.
Tche LJ et MJ Rponse de la mthode %CJ statut [mjstring] %JS [tempsuc] Action Tivoli Workload Scheduler Affecte le statut state au travail. Inclut mjstring dans toute tche MJ ultrieure. Affecte le statut succ au travail.

Code de sortie = diffrent de Affecte le statut abend au travail. zro %UT [messageerreur ] et code de sortie = 2 Affecte le statut abend au travail et affiche messageerreur.

Une squence typique est constitue dun ou de plusieurs messages %CJ indiquant un changement dans ltat du travail, puis un message %JS avant que la mthode nexiste indiquant que le travail a abouti. Si le travail naboutit pas, la mthode doit exister sans crire le message %JS. Une mthode qui ne supporte pas la tche LJ crit un message %UTvers stdout et renvoie le code de sortie 2.

Tche de gestion du travail (MJ)


La tche MJ assure la synchronisation avec un travail prcdemment lanc dans le cas o le planificateur dtermine que la tche LJ sest acheve de faon inattendue. Le planificateur configure lenvironnement de la mme faon que pour la tche LJ et transmet mjstring. Pour plus dinformations, reportez-vous la section Tche de lancement dun travail (LJ). Si la mthode localise le travail indiqu, elle renvoie les mmes messages quune tche LJ. Si la mthode ne parvient pas localiser le travail, elle quitte lapplication avec un code de sortie diffrent de zro ; le planificateur affecte alors le statut abend au travail.

176

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Suppression dun travail


Lors de lexcution dune tche LJ ou MJ, la mthode doit capter un signal SIGTERM (signal 15). Ce signal est envoy lorsquun oprateur lance une commande Kill via le gestionnaire de console du planificateur. A la rception du signal, la mthode doit essayer de supprimer (kill) le travail et sortir sans quun message %JS ne soit gnr.

Tche de vrification dun fichier (CF)


La tche CF charge la mthode de lagent tendu de vrifier la disponibilit dun fichier sur le systme externe. Avant dexcuter la mthode, le planificateur cre un environnement dexcution. Le paramtre CFuser, lu partir du fichier doptions de la mthode, indique avec quel compte utilisateur la mthode doit tre excute. Si ce paramtre ne figure pas dans le fichier doptions ou si ce dernier nexiste pas, lutilisateur root est utilis sous Unix ; sous Windows, le nom de lutilisateur du compte sur lequel le planificateur a t install est utilis. Si la mthode ne peut pas tre excute, la dpendance opens du fichier est marque comme choue, cest--dire que le statut du fichier est dfini sur NO et quaucun flux de travaux ou travail dpendant nest autoris sexcuter. Lorsquelle est excute, la mthode excute une commande test ou son quivalent pour le fichier utilisant le qualifiant qui lui est transmis dans loption de ligne de commande -q. Si la valeur du fichier test est true, la mthode existe avec un code de sortie 0. Si la valeur du fichier test est false, la mthode existe avec un code de sortie diffrent de 0. Voir le tableau ci-dessous.
Tche CF Rponse de la mthode Code de sortie = 0 Action Tivoli Workload Scheduler Dfinit le statut du fichier YES.

Code de sortie = diffrent de Dfinit le statut du fichier NO. zro %UT [messageerreur ] et code Dfinit le statut du fichier NO. de sortie = 2

Une mthode qui ne supporte pas la tche CF crit un message %UT vers stdout et sort en renvoyant le code de sortie 2.

Tche dobtention dun tat (GS)


La tche GS charge la mthode de lagent tendu de vrifier le statut dun travail. Cette opration est ncessaire lorsque lexcution dun autre travail dpend du succs de lexcution dun travail externe. Avant lexcution de la mthode, le paramtre GSuser est lu partir du fichier doptions de la mthode pour dterminer le compte utilisateur avec lequel la mthode doit tre excute. Si ce paramtre ne figure pas dans le fichier doptions ou si ce dernier nexiste pas, lutilisateur root est utilis sous Unix ; sous Windows, le nom de lutilisateur du compte sur lequel le planificateur a t install est utilis. Si la mthode ne peut pas tre excute, le travail ou le flux de travaux dpendant ne peut pas tre excut. Si lidtravail dune prcdente tche GS est disponible, il est transmis la mthode. La mthode vrifie le statut du travail indiqu et le renvoie dans un message %CJ crit vers stdout. Elle existe alors avec le code de sortie 0. A une frquence dfinie par loption locale bm check status, la mthode est rexcute avec une tche GS jusqu ce que lun des statuts de travail suivant soit renvoy : abend Le travail sest arrt de manire anormale.
Chapitre 27. Rfrence aux agents tendus

177

succ cancl done fail error extrn

Le travail a abouti. Le travail a t annul. Le travail a t effectu sans savoir sil a abouti ou sil a chou. Le travail na pas pu tre excut. Une erreur sest produit dans la mthode lors de la vrification du statut du travail. La vrification du travail a chou ou le statut du travail na pas pu tre dtermin.

Notez que GStimeout dans le fichier doptions de la mthode indique le temps pendant lequel le planificateur attend une rponse avant de supprimer la mthode. Pour plus dinformations, reportez-vous la section Fichier doptions de mthode la page 175. Les rponses de mthode sont dcrites dans le tableau ci-aprs.
Tche GS Rponse de la mthode %CJ statut [idtravail] Action Tivoli Workload Scheduler Dfinit le statut du travail statut et inclut idtravail dans toute tche GS suivante.

%UT [messageerreur ] et code Le statut du travail est inchang. de sortie = 2

Une mthode qui ne supporte pas la tche GS crit un message %UT stdout et sort avec le code de sortie 2.

La commande cpuinfo
La commande cpuinfo peut tre utilise dans une mthode daccs pour renvoyer des informations partir dune dfinition de poste de travail. Pour obtenir des informations compltes sur la commande, consultez le manuel IBM Tivoli Workload Scheduler - Guide de rfrence.

Identification et rsolution des incidents


Les sections suivantes dcrivent comment identifier et dboguer des problmes survenus au niveau dagents tendus et de mthodes daccs.

Messages derreur de la liste standard dun travail


Tous les messages en sortie manant dune mthode daccs, excepts ceux commenant par un symbole de pourcentage (%), sont crits dans le fichier de la liste standard (stdlist) du travail. Pour les tches GS et CF qui ne sont pas associes aux travaux du planificateur, les messages sont crits dans le fichier de liste standard du planificateur. Pour obtenir des informations relatives tout problme, reportez-vous ces fichiers.

178

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Mthode non excutable


Si une mthode daccs ne peut pas tre excute, les vnements suivants se produiront : v Pour des tches LJ et MJ, le travail se voit affecter le statut fail. v Pour la tche CF, la dpendance par rapport un fichier nest pas rsolue et le travail dpendant conserve le statut hold. v Pour la tche GS, la dpendance par rapport un travail nest pas rsolue et le travail dpendant conserve le statut hold. Pour plus dinformations, consultez la liste des fichiers standard ( stdlist) pour le travail et le planificateur.

Messages du gestionnaire de consoles


Le message derreur ci-aprs saffiche si vous mettez une commande start, stop, link ou unlink pour un agent tendu :
Error executing command: Not implemented for extended agents. [2202.58]

Ce message derreur nest pas affich si des caractres gnriques ont t utiliss pour la slection dun agent tendu.

Messages du programme Composer et Compiler


Les messages derreur suivants sont gnrs lorsque le programme Composer rencontre une syntaxe non valide dans une dfinition de poste de travail :
ACCESS METHOD is syntactically invalid [1116.45] Duplicate ACCESS keyword [1116.46] Missing or invalid ACCESS METHOD [1116.47]

Si un agent tendu est dfini avec une mthode daccs mais sans hte, le message suivant saffiche :
"Method needs a Host CPU"

Messages de Jobman
Pour les agents tendus, les messages dinformation, davertissement ou derreur sont gnrs dans le fichier stdlist de Jobman. Un travail dont le lancement a abouti gnre le message suivant :
Launched job jobname for wkstation, #Jjobid for user username.

Un travail dont le lancement na pas abouti gnre le message suivant :


Error launching jobname for wkstation: errortext

Lchec dune tche de vrification de fichier gnre le message suivant :


Error invoking methodname for wkstation: errortext

Lchec dune tche de gestion de fichier gnre le message suivant :


Error managing jobname for wkstation using methodname: errortext

Lorsquun mthode envoie un message Jobman qui nest pas reconnu, le message suivant est gnr :
Error: message invalid for jobname, #jjobnumber for wkstation using methodname. "first 64 characters of the offending message"

Chapitre 27. Rfrence aux agents tendus

179

180

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 28. Bibliothque de mappage de code retour


La fonctionnalit de mappage du code retour fournit un moyen classique de mapper les messages dans des valeurs de code retour. De plus, le mappage du code retour peut tre personnalis par les utilisateurs. Cette fonctionnalit est disponible pour les mthodes daccs aux programmes suivants : v Oracle eBusiness Suite v Peoplesoft v R/3 Cette fonctionnalit offre une meilleure stratgie de dfinition des rgles de succs et dchec des travaux, ainsi quune meilleure flexibilit dans le contrle des flux dexcution de travaux sur la base des rsultats dexcution. Le mappage du code retour du travail offre les capacits suivantes : v Les utilisateurs peuvent dfinir un tat de rsiliation du travail (avec succs ou chec) bas sur une condition applique au code retour pour lexcution du programme ou du script du travail. v Le code retour peut galement tre fourni au travail de reprise associ la dfinition de ce travail. Cela implique que le travail de reprise effectue des traitements diffrents en fonction du code retour.

Fichier de mappage du code retour


Ce fichier vous permet de personnaliser vos propres codes retour en respectant certaines conditions pouvant affecter un travail en cours dexcution. Il est alors possible de dfinir la condition du succs du travail partir de laquelle Tivoli Workload Scheduler peut valuer si ce travail se termine avec succs ou si une erreur est gnre. Le code retour est envoy Tivoli Workload Scheduler sous la forme dun message %RC nnnn. Si ce message est reu, ltat du travail est mis jour en consquence.

Syntaxe
La syntaxe du fichier de mappage du code retour est la suivante :
[#] modle1 modle2...modlen = valeur RC

Paramtres
# Commentaire facultatif. Les lignes commenant par ce symbole (#) ne sont pas utilises pour le mappage.

modlen Chanes de mtacaractres dlimites par des guillemets doubles ( et ). Si vous nutilisez quune seule chane de mtacaractres, vous pouvez omettre les guillemets doubles. Si cette chane de mtacaractres comprend un symbole guillemet double, celui-ci doit tre prcd dune barre oblique inverse (\). La chane peut contenir les caractres gnriques et les caractres spciaux suivants : Lastrisque (*) Remplace plusieurs caractres. Le point dinterrogation (?) Remplace un seul caractre.

Copyright IBM Corp. 2000, 2003

181

La barre oblique inverse (\) Caractre dchappement. Valeur RC Valeur du code retour. Cette valeur est envoye par la mthode au Tivoli Workload Scheduler via un message %RC nnnn.

Exemples
Dans lexemple ci-dessous dun fichier de mappage de code retour, les numros de ligne en gras ne font pas partie du fichier ; ils sont indiqus titre de rfrence :
1. 2. 3. 4. 5. 6. 7. # Il sagit dun fichier de mappage RC pour le journal des travaux. Utilisateur * manquant \*\*\* = 103 Utilisateur \ * \ manquant = 102 = 102

o : v La ligne 1 est un commentaire, et, ce titre, elle nest pas utilise pour le mappage. v La ligne 2 est vide et donc ignore. Tous les blancs prcdant ou suivant une chane de mtacaractres sont ignors, de mme que ceux situs entre le signe gal et la valeur de code retour. v La ligne 3 prend en compte tous les messages qui commencent par la chane Utilisateur et qui se terminent par la chane manquant. v La ligne 4 prend en compte tous les messages qui commencent par trois astrisques (*) suivis par un caractre blanc. Lorsque vous utilisez lastrisque comme tel et non comme un caractre gnrique, vous devez le faire suivre dune barre oblique inverse. v Les lignes 5 7 contiennent une chane stalant sur plusieurs lignes. Cette chane prend en compte les mmes messages que le format de la ligne 3.

Commentaires
Prenez connaissance des informations suivantes : v Lordre des lignes de chanes est important car cest la premire ligne de chane concordante qui sert crer la valeur du code retour. v Les chanes de mtacaractres vides () sont ignores par la procdure de mise en correspondance des chanes. Par exemple, la squence de modles ci-dessous est correcte. La premire ligne est plus restrictive que la deuxime.
625 Utilisateur * manquant = 104 Utilisateur * manquant = 102

La squence de modles suivante est syntaxiquement correcte ; toutefois, le modle prsent en deuxime ligne nest jamais utilis car la premire ligne est toujours mise en correspondance avant la deuxime.
Utilisateur * manquant = 102 625 Utilisateur * manquant = 104

Mappage du code retour pour Psagent et MCMAGENT


Pour les mthodes daccs de PeopleSoft et Oracle e-Business Suite, vous pouvez crire des fichiers de mappage de code retour qui associent les tats internes rpertoris dans le tableau 22 la page 183 et dans le tableau 23 la page 184.

182

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Si aucun fichier de mappage de code retour na t dfini ou si une chane retourne par la mthode daccs ne rpond aucun des modles de correspondance du fichier de mappage, les mthodes utilisent les codes retour standard respectifs rpertoris dans les mmes tableaux.
Tableau 22. Etats des travaux et codes retour de la mthode daccs de PeopleSoft Etat du travail de Psoft CANCEL DELETE ERROR HOLD QUEUED INITIATED PROCESSING CANCELLED SUCCESS NO SUCCESSPOSTED POSTED NOT POSTED RESEND POSTING GENERATED Code retour de Psoft 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

Chapitre 28. Bibliothque de mappage de code retour

183

Tableau 23. Etats des travaux et codes retour de la mthode daccs dOracle e-Business Suite. Etat du travail MCMAGENT RUNNING PENDING COMPLETE INACTIVE NORMAL TERMINATING PAUSED RESUMING STANDBY SCHEDULED WAITING WARNING ERROR TERMINATED DELETED ON HOLD DISABLED NO MANAGER SUSPENDED TEST FAILURE NOT FOUND Code retour de MCMAGENT 1 2 3 4 5 6 7 8 9 10 11 13 14 15 16 17 18 19 20 21 22

184

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Exemples : Lagent tendu dOracle e-Business Suite retourne la chane TERMINATED. Le code retour qui en rsulte devrait tre le suivant, en fonction des conditions nonces : v Il nexiste pas de fichier de mappage de code retour. Dans ce cas, la mthode envoie la valeur de code retour 15, comme indiqu dans le tableau 23 la page 184. v Il existe un fichier de mappage de code ; il sagit de :
"NORMAL"=0 "TERMINATED","DELETED"=1

Dans ce cas, la mthode recherche le modle correspondant et envoie la valeur de code retour 1. v Le fichier de mappage du code retour est
"NORMAL"=0 "ERROR","DELETED"=1

Dans ce cas, la mthode ne recherche pas le modle correspondant ; elle envoie la valeur de code retour 15, comme indiqu dans le tableau 23 la page 184.

Chapitre 28. Bibliothque de mappage de code retour

185

Noms de fichier de mappage de code retour


Chaque mthode possde son propre ensemble de fichiers destin mapper les messages en valeurs de codes retour. Les fichiers de mappage peuvent tre locaux ou communs pour un poste de travail. Les fichiers de mappage des codes retour spcifiques un poste de travail sont nomms selon le schma suivant :
<racine_TWS>/methods/rcm/<nom_mthode>-<type>-<postetravail>.rcm

Le nom des fichiers communs de mappage doit suivre le schma suivant :


<racine_TWS>/methods/rcm/<nom_mthode>-<type>.rcm

Pour les mthodes daccs de PeopleSoft et dOracle e-Business, le type est toujours gal rcmap. Pour la mthode daccs R/3, le type correspond la description faite dans la section ci-aprs.

Noms de fichier de mappage de code retour pour r3batch


La mthode de R3 utilise les fichiers communs de mappage de code retour suivants : <racine_TWS>/rcm/methods/r3batch-joblog.rcm Permet de mapper les messages issus du journal des travaux dun travail R3 en valeurs de code retour. Si ce fichier est absent, les messages du journal des travaux sont ignors. <racine_TWS>/rcm/methods/r3batch-pchainlog.rcm Permet de mapper les messages issus du protocole dune chane de traitement en valeurs de code retour. Si ce fichier est absent, les messages de ce protocole sont ignors. <racine_TWS>/rcm/methods/r3batch-spool.rcm Permet de mapper les messages dans la liste de spoule dun travail SAP en valeurs de code retour. Si ce fichier est absent, les messages de la liste de spoule sont ignors. <racine_TWS>/rcm/methods/r3batch-syslog.rcm Permet de mapper les messages dans le syslog dun systme SAP en valeurs de code retour. Si ce fichier est absent, les messages du syslog sont ignors. <racine_TWS>/rcm/methods/r3batch-msgrc.rcm Permet de mapper les exceptions ABAP / codes retour BAPI des modules de la fonction dappel de fonction distante en valeurs de code retour. Si ce fichier est absent, le mappage seffectue laide dune table dfinie dans le code.

186

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 29. Configuration de lutilitaire de trace


Toutes les mthodes daccs offrent la possibilit de configurer les options de la fonction de trace. Vous pouvez ainsi modifier certaines proprits de traage dans le fichier de configuration <nom_mthode_accs>.properties situ dans le sous-rpertoire methods de racine_TWS. Vous pouvez configurer les proprits de trace suivantes : v Niveau de traage (MIN, MID, MAX), v Emplacement du fichier de trace (en termes de chemin absolu). Lexemple suivant reprsente un fichier de configuration pour la mthode daccs R/3, ayant pour nom r3batch.properties. Les mots-cls comments dans cette section sont mis en vidence par souci de lisibilit :
r3batch.organization=IBM r3batch.product=TWS4APPS r3batch.component=R3BATCH r3batch.trace.tracers.level=DEBUG_MIN r3batch.trace.tracers.listenerNames=r3batch.trace.handlers.traceFile r3batch.trace.handlers.traceFile.fileDir=home/maestro/methods r3batch.trace.handlers.traceFile.appending=true r3batch.trace.handlers.traceFile.formatterName=r3batch.trace.formatter

Grce au mot cl level, le mcanisme de traage prend en charge trois niveaux de trace : DEBUG_MIN Seules les erreurs fatales sont rpertories. Il sagit de loption par dfaut. DEBUG_MID Les messages dinformation et les avertissements sont galement rpertoris. DEBUG_MAX Un rsultat plus explicite en termes de dbogage est affich. Les paramtres du fichier de proprits affectent toutes les excutions de la mthode daccs correspondante. Pour dfinir un paramtre de trace diffrent dans le cadre dun travail particulier, ajoutez loption suivante dans la dfinition du travail :
-tracelvl=(1|2|3)

o : v 1 = DEBUG_MIN v 2 = DEBUG_MID v 3 = DEBUG_MAX Dans le cas de la mthode daccs R/3 (et uniquement dans ce cas), vous pouvez cocher la case Dbogage dans la fentre Proprits - Dfinition du travail de Job Scheduling Console pour dfinir le niveau de trace sur DEBUG_MAX pour un travail spcifique. Notez que la case Trace active la trace RFC SAP. Les traces sont crites au format XML. Par dfaut, les fichiers de trace sont stocks dans le rpertoire methods. Pour modifier ce chemin, vous pouvez utiliser le mot
Copyright IBM Corp. 2000, 2003

187

cl fileDir. Vrifiez que le nouveau chemin indiqu a dj t cr en tant que chemin absolu, avec des droits en criture. Utilisez toujours des barres obliques (ou des barres obliques inverses) lorsque vous spcifiez un nouveau chemin, mme si vous tes sous Windows. Les fichiers de trace donnent des informations sur lexcution de la mthode au niveau de dtails dsir. Le niveau de trace minimum est toujours actif, de manire garantir un outil de diagnostic de premier niveau (FFDC). La valeur de la cl appending dtermine si un nouveau fichier de trace est ajout lancien fichier (true) ou le remplace ( false). La valeur true est recommande dans tous les cas. En particulier, elle ne doit pas tre modifie en false lors de lexcution de travaux, tant donn que cela entranerait la perte des traces.

188

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 30. Identification et rsolution des incidents


Le prsent chapitre rpertorie les incidents que vous pouvez rencontrer lorsque vous installez ou utilisez Tivoli Workload Scheduler for Applications ou les mthodes daccs.
Tableau 24. Identification des incidents Zone Installation : Reconnaissance des instances Tivoli Workload Scheduler Incidents Incident : Si vous tes sous Unix et avez plusieurs installations de Tivoli Workload Scheduler, version 7.0 ou 8.1, qui nont pas t correctement installes dans un rpertoire de base /home/utilisateur_TWS, le programme dinstallation affiche alors, au hasard, une seule de ces instances et lappelle <unknown>. Solution : Pour chacune de ces instances, crez un rpertoire de base dsignant le rpertoire dinstallation courant de Tivoli Workload Scheduler. Procdez de la manire suivante : 1. Sur root, crez un rpertoire /home/utilisateur_TWS qui dsigne le rpertoire dans lequel le produit est install. 2. Dans le fichier /usr/unison/components, ajoutez lentre /home/utilisateur_TWS qui dsigne lentre de cette instance spcifique. Installation : Installation de psagent Incident : Lors de linstallation de la mthode daccs de la fonction PeopleSoft, le message instantan suivant peut safficher : Impossible de trouver le nombre ordinal 6654 dans la bibliothque DLL MFC42u.dll Ce message apparat si une ancienne version de MFC42u.dll a t trouve dans le rpertoire systme de Windows. Solution : Pour rsoudre lincident, vous devez remplacer la bibliothque DLL MFC42u.dll par une version plus rcente. Pour rcuprer une version plus rcente, consultez le rpertoire de base PeopleSoft. r3batch : Planification de travaux R/3 Incident : Lorsque vous crez un travail SAP, le message suivant apparat si vous tentez dafficher les dtails dune variante ABAP : AWSO0101E Sous-programme ABAP manquant. J_101_REPORT_ALL_SELECTIONS Veuillez installer la dernire version du sous-programme ABAP pour Maestro !! Solution : Cet incident est caus par une erreur du module de fonction SAP. SAP dcrit cet incident et les solutions possibles dans les notes SAP 0351293 et 0116354. Environnement mixte : Messages des journaux de travaux de psagent et zosagent Environnement mixte : Codes retour des travaux dagent tendu Si votre environnement de planification comprend Tivoli Workload Scheduler version 8.1 et Tivoli Workload Scheduler for Applications version 8.2, les messages des journaux de travaux des mthodes daccs pour z/OS et PeopleSoft affichent des prfixes doubles : v AWSxxxx EEWIaaaa <texte de message> for zosagent v AWSxxxx EEWNaaaa <texte de message> for psagent Si votre environnement de planification comprend Tivoli Workload Scheduler version 8.2 et Tivoli Workload Scheduler for Applications version 8.1.1, llment affich comme code retour dun travail dagent tendu soumis (via Job Scheduling Console ou conman) correspond en ralit au code de sortie du travail. Il ne doit pas tre interprt comme le code retour.

Copyright IBM Corp. 2000, 2003

189

Identification des incidents lors de linstallation de la mthode daccs PeopleSoft


Pour installer cette mthode daccs, vous devez dfinir lenvironnement PeopleSoft comme rpertoire dpendant de votre version de PeopleSoft. Certains fichiers excutables de mthode daccs sont installs ici. Le tableau suivant prsente les rpertoires et les fichiers que vous devez consulter si vous identifiez des incidents dans votre installation.
Tableau 25. Chemins de lenvironnement PeopleSoft. Version de PeopleSoft 7.x Nom de rpertoire <RACINE_PS>\cblbin o <RACINE_PS> reprsente le rpertoire de base du serveur de fichiers PeopleSoft. Il est accessible en local ou distance partir du poste de travail excutant la mthode daccs. 8.1x <REP_API_EXT>\bin\client\winx86_extapi o <REP_API_EXT> reprsente le rpertoire dans lequel les API externes PeopleSoft sont installes. 8.4x <RACINE_PS>\\bin\client\winx86 o <RACINE_PS> reprsente le rpertoire de base du serveur de fichiers PeopleSoft. Il est accessible en local ou distance partir du poste de travail excutant la mthode daccs. TVPUPSFT.exe pspiadapter.dll TVPUPSFT.exe pspiadapter.dll Fichiers rechercher TVPUPSFT.exe cblrtss.dll

190

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Chapitre 31. Fichiers installs


Ce chapitre fournit la liste des fichiers que vous devez trouver sur votre systme lissue de linstallation de Tivoli Workload Scheduler for Applications. Les informations sont classes par plateforme et fonction. Cette liste ninclut pas les fichiers installs pour le support Java, autres que ceux requis pour la dsinstallation du produit. Le tableau ci-aprs rpertorie les fichiers installs sous Windows.
Tableau 26. Fichiers installs sous Windows. Fonction Mthode daccs PeopleSoft Fichiers racine_TWS\catalog\C\peoplesoft.cat racine_TWS\methods\PeopleSoft\PTCUDCOP.bl racine_TWS\methods\PeopleSoft\TVPUPSFT700.dms racine_TWS\methods\PeopleSoft\TVPUPSFT750.dms racine_TWS\methods\defs\psagent.def racine_TWS\methods\enigma.exe racine_TWS\methods\msvcrt.dll racine_TWS\methods\oslayer.dll racine_TWS\methods\psagent.exe racine_TWS\methods\psagent.opts racine_TWS\methods\psagent.properties Pour PeopleTools 7.0x et Merant NetExpress 2 : PSHOME70CBL2\cblbin\TVPUPSFT.exe PSHOME70CBL2\cblbin\TVPUPSFT.gnt Pour PeopleTools 7.0x et Merant NetExpress 3 : PSHOME70CBL3\cblbin\TVPUPSFT.exe PSHOME70CBL3\cblbin\TVPUPSFT.gnt PeopleTools 7.0x et MF COBOL Workbench 4.x : PSHOME70CWB4\cblbin\TVPUPSFT.exe PSHOME70CWB4\cblbin\TVPUPSFT.gnt Pour PeopleTools 7.5x et Merant NetExpress 2 : PSHOME75CBL2\cblbin\TVPUPSFT.exe PSHOME75CBL2\cblbin\TVPUPSFT.gnt Pour PeopleTools 7.5x et Merant NetExpress 3 : PSHOME75CBL3\cblbin\TVPUPSFT.exe PSHOME75CBL3\cblbin\TVPUPSFT.gnt Pour PeopleTools 8.1x : PSHOME81X\bin\client\winx86_extapi\TVPUPSFT.exe Pour PeopleTools 8.4x : PSHOME84X\bin\client\winx86\TVPUPSFT.exe

Copyright IBM Corp. 2000, 2003

191

Tableau 26. Fichiers installs sous Windows. (suite) Fonction Mthode daccs R/3 Fichiers racine_TWS\methods\K000443.TV1 racine_TWS\methods\R000443.TV1 racine_TWS\methods\r3batch.exe racine_TWS\methods\r3batch.opts racine_TWS\methods\r3batch.properties racine_TWS\methods\r3batch_cp.map racine_TWS\methods\librfc32.dll racine_TWS\methods\enigma.exe racine_TWS\methods\msvcrt.dll racine_TWS\methods\msvbvm60.dll racine_TWS\methods\msvcp60.dll racine_TWS\methods\defs\r3batch.def racine_TWS\catalog\C\r3batch.cat racine_TWS\methods\mvsca7.exe racine_TWS\methods\mvsca7.opts racine_TWS\methods\mvsca7.properties racine_TWS\methods\mvsjes.exe racine_TWS\methods\mvsjes.opts racine_TWS\methods\mvsjes.properties racine_TWS\methods\mvsopc.exe racine_TWS\methods\mvsopc.opts racine_TWS\methods\mvsopc.properties racine_TWS\methods\oslayer.dll racine_TWS\methods\defs\mvsca7.def racine_TWS\methods\defs\mvsjes.def racine_TWS\methods\defs\mvsopc.def racine_TWS\methods\msvcrt.dll racine_TWS\catalog\C\mvs.cat racine_TWS\methods\opted\jakarta-oro-2.0.6.jar racine_TWS\methods\opted\opted.bat racine_TWS\methods\opted\tws4apps.jar racine_TWS\methods\opted\tws4appsbeans.jar racine_TWS\methods\opted\uil.jar racine_TWS\methods\opted\xercesImpl.jar racine_TWS\methods\opted\xmlParserAPIs.jar racine_TWS\methods\opted.exe racine_TWS\methods\_xauninst\uninstall.dat racine_TWS\methods\_xauninst\uninstall.jar racine_TWS\methods\_xauninst\uninstaller.exe

Mthode daccs z/OS

Installation commune

Dsinstallation

Le tableau ci-aprs rpertorie les fichiers installs sous Unix (plateformes de niveau 1).

192

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Tableau 27. Fichiers installs sous Unix (plateformes de niveau 1). Fonction Mthode daccs Oracle e-Business Suite Fichiers racine_TWS/catalog/C/mcm.cat racine_TWS/methods/MCMAGENT.opts racine_TWS/methods/MCMAGENT.properties racine_TWS/methods/OracleTMP/MCMAGENT racine_TWS/methods/OracleTMP/MCMLJ.o racine_TWS/methods/OracleTMP/MCMSTAT.o racine_TWS/methods/OracleTMP/MCMTJ.o racine_TWS/methods/OracleTMP/MCMprod.txt racine_TWS/methods/OracleTMP/libusr.a racine_TWS/methods/OracleTMP/mcm.mk racine_TWS/methods/OracleTMP/mcminstall racine_TWS/methods/OracleTMP/mcmoptions racine_TWS/methods/defs/MCMAGENT.def racine_TWS/methods/enigma racine_TWS/catalog/C/r3batch.cat racine_TWS/methods/K000443.TV1 racine_TWS/methods/R000443.TV1 racine_TWS/methods/defs/r3batch.def racine_TWS/methods/enigma racine_TWS/methods/r3batch racine_TWS/methods/r3batch.opts racine_TWS/methods/r3batch.properties racine_TWS/methods/r3batch_cp.map racine_TWS/catalog/C/mvs.cat racine_TWS/methods/defs/mvsca7.def racine_TWS/methods/defs/mvsjes.def racine_TWS/methods/defs/mvsopc.def racine_TWS/methods/mvsca7 racine_TWS/methods/mvsca7.opts racine_TWS/methods/mvsca7.properties racine_TWS/methods/mvsjes racine_TWS/methods/mvsjes.opts racine_TWS/methods/mvsjes.properties racine_TWS/methods/mvsopc racine_TWS/methods/mvsopc.opts racine_TWS/methods/mvsopc.properties racine_TWS/methods/opted.bin racine_TWS/methods/opted/jakarta-oro-2.0.6.jar racine_TWS/methods/opted/opted.sh racine_TWS/methods/opted/tws4apps.jar racine_TWS/methods/opted/tws4appsbeans.jar racine_TWS/methods/opted/uil.jar racine_TWS/methods/opted/xercesImpl.jar racine_TWS/methods/opted/xmlParserAPIs.jar racine_TWS/methods/_xauninst/uninstall.dat racine_TWS/methods/_xauninst/uninstall.jar racine_TWS/methods/_xauninst/uninstaller

Mthode daccs R/3

Mthode daccs z/OS

Installation commune

Dsinstallation

Chapitre 31. Fichiers installs

193

194

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Partie 7. Annexes

Copyright IBM Corp. 2000, 2003

195

196

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Remarques
Le prsent document peut contenir des informations ou des rfrences concernant certains produits, logiciels ou services IBM non annoncs dans ce pays. Pour plus de dtails, rfrez-vous aux documents dannonce disponibles dans votre pays, ou adressez-vous votre partenaire commercial IBM. Toute rfrence un produit, logiciel ou service IBM nimplique pas que seul ce produit, logiciel ou service puisse tre utilis. Tout autre lment fonctionnellement quivalent peut tre utilis, sil nenfreint aucun droit dIBM. Il est de la responsabilit de lutilisateur dvaluer et de vrifier lui-mme les installations et applications ralises avec des produits, logiciels ou services non expressment rfrencs par IBM. IBM peut dtenir des brevets ou des demandes de brevet couvrant les produits mentionns dans le prsent document. La remise de ce document ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous dsirez recevoir des informations concernant lacquisition de licences, veuillez en faire la demande par crit ladresse suivante : IBM EMEA Director of Licensing IBM Europe Middle-East Africa Tour Descartes La Dfense 5 2, avenue Gambetta 92066 - Paris-La Dfense CEDEX France Pour le Canada, veuillez adresser votre courrier : IBM Director of Commercial Relations IBM Canada Ltd. 3600 Steeles Avenue East Markham, Ontario L3R 9Z7 Canada Les informations sur les licences concernant les produits utilisant un jeu de caractres double octet peuvent tre obtenues par crit ladresse suivante : IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan Le paragraphe suivant ne sapplique ni au Royaume-Uni, ni dans aucun pays dans lequel il serait contraire aux lois locales : LE PRESENT DOCUMENT EST LIVRE EN LETAT. IBM DECLINE TOUTE RESPONSABILITE, EXPLICITE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE VALEUR MARCHANDE OU DADAPTATION A VOS BESOINS.

Copyright IBM Corp. 2000, 2003

197

Certaines juridictions nautorisent pas lexclusion des garanties implicites, auquel cas lexclusion ci-dessus ne vous sera pas applicable. Le prsent document peut contenir des inexactitudes ou des coquilles. Il est mis jour priodiquement. Chaque nouvelle dition inclut les mises jour. IBM peut modifier sans pravis les produits et logiciels dcrits dans ce document. Les rfrences des sites Web non IBM sont fournies titre dinformation uniquement et nimpliquent en aucun cas une adhsion aux donnes quils contiennent. Les lments figurant sur ces sites Web ne font pas partie des lments du prsent produit IBM et lutilisation de ces sites relve de votre seule responsabilit. IBM pourra utiliser ou diffuser, de toute manire quelle jugera approprie et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies. Les licencis souhaitant obtenir des informations permettant : (i) lchange des donnes entre des logiciels crs de faon indpendante et dautres logiciels (dont celui-ci), et (ii) lutilisation mutuelle des donnes ainsi changes, doivent adresser leur demande : IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Ces informations peuvent tre soumises des conditions particulires, prvoyant notamment le paiement dune redevance. Le logiciel sous licence dcrit dans ce document et tous les lments sous licence disponibles sy rapportant sont fournis par IBM conformment aux dispositions de lICA, des Conditions internationales dutilisation des logiciels IBM ou de tout autre accord quivalent. Les donnes de performance indiques dans ce document ont t dtermines dans un environnement contrl. Par consquent, les rsultats peuvent varier de manire significative selon lenvironnement dexploitation utilis. Certaines mesures values sur des systmes en cours de dveloppement ne sont pas garanties sur tous les systmes disponibles. En outre, elles peuvent rsulter dextrapolations. Les rsultats peuvent donc varier. Il incombe aux utilisateurs de ce document de vrifier si ces donnes sont applicables leur environnement dexploitation. Les informations concernant des produits non IBM ont t obtenues auprs des fournisseurs de ces produits, par lintermdiaire dannonces publiques ou via dautres sources disponibles. IBM na pas test ces produits et ne peut confirmer lexactitude de leurs performances ni leur compatibilit. Elle ne peut recevoir aucune rclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit tre adresse aux fournisseurs de ces produits. Le prsent document peut contenir des exemples de donnes et de rapports utiliss couramment dans lenvironnement professionnel. Ces exemples mentionnent des

198

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

noms fictifs de personnes, de socits, de marques ou de produits des fins illustratives ou explicatives uniquement. Toute ressemblance avec des noms de personnes, de socits ou des donnes relles serait purement fortuite. Si vous visualisez ces informations en ligne, il se peut que les photographies et illustrations en couleur napparaissent pas lcran.

Marques
IBM, le logo IBM, Tivoli, AIX, AS/400, Dynix, MVS/ESA, OS/390, RACF, RS/6000, Sequent, z/OS et zSeries sont des marques dInternational Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays. Microsoft et Windows NT sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays. UNIX est une marque enregistre de The Open Group aux Etats-Unis et/ou dans certains autres pays.

Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.

Dautres socits sont propritaires des autres marques, noms de produits ou logos qui pourraient apparatre dans ce document.

Remarques

199

200

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Glossaire A
agent tendu : Les agents tendus sont utiliss pour intgrer les fonctions de contrle des travaux de Tivoli Workload Scheduler dautres systmes dexploitation (par exemple MVS) et dautres applications (comme Oracle, Peoplesoft et R/3). Ils utilisent des scripts appels mthodes daccs pour communiquer avec des systmes externes. agent rseau : Type dagent tendu servant crer des dpendances entre les travaux et les flux de travaux de diffrents rseaux Tivoli Workload Scheduler. Voir aussi dpendances inter-rseaux (INET). agent tolrant aux pannes : Dans le rseau Tivoli Workload Scheduler, poste de travail capable de rsoudre des dpendances locales et de lancer ses travaux en labsence dun gestionnaire de domaine. dfini dans la base de donnes, il peut tre affect de multiples flux de travaux. Laffectation dun calendrier un flux de travaux permet lexcution de ce dernier aux dates indiques dans le calendrier. Notez quun calendrier peut tre utilis comme cycle dexcution inclusif ou exclusif. caractres gnriques : Les caractres gnriques accepts par Tivoli Workload Scheduler sont les suivants : ? Remplace un caractre alphabtique. % Remplace un caractre numrique. * Remplace zro ou plusieurs caractres alphanumriques. Les caractres gnriques servent gnralement affiner une recherche sur un ou plusieurs objets de la base de donnes. Par exemple, pour afficher tous les postes de travail, vous pouvez taper le caractre gnrique * (astrisque). Pour obtenir la liste de tous les postes de travail site1 site8, vous pouvez entrer site%. classe de poste de travail : Une classe de poste de travail correspond un groupe de postes de travail. Elle peut contenir un nombre illimit de postes. Des flux de travaux et des travaux peuvent lui tre affects en vue dexcution. Ainsi, la rplication dun travail ou dun flux de travaux travers plusieurs postes de travail en est facilite. Composer : Application en mode ligne de commande permettant de grer les dfinitions de vos objets de planification dans la base de donnes. Conman : Conman (Console Manager) est une application en mode ligne de commande qui permet la gestion de lenvironnement de production. Conman effectue les tches suivantes : dmarrage et arrt des processus de production, modification et affichage des calendriers et des travaux dans le plan, contrle de la connexion des postes de travail dans un rseau. cycle dexcution : Cycle dexcution prcisant les jours o un flux de travaux doit tre excut. Dans Tivoli Workload Scheduler, vous pouvez indiquer lun des trois types de cycles dexcution suivants pour un flux de travaux : cycle dexcution simple, cycle dexcution hebdomadaire ou cycle dexcution bas sur un calendrier (couramment appel calendrier). Notez que chaque type de cycle dexcution peut tre inclusif ou exclusif. En dautres termes, chaque cycle dexcution peut dfinir aussi bien les jours o le flux de travaux sera inclus dans le cycle de production que ceux o il en sera exclu. Lorsque vous dfinissez plusieurs cycles dexcution pour un flux de travaux et que les cycles dexcution inclusifs et exclusifs indiquent les mmes jours, les cycles exclusifs ont alors la priorit.

B
base de donnes : La base de donnes contient toutes les dfinitions que vous avez cres pour les objets de planification tels que les travaux, les flux de travaux, les ressources, les postes de travail, etc. La base de donnes contient galement dautres informations importantes, telles que les statistiques sur lexcution des travaux et des flux de travaux, lID de lutilisateur qui a cr un objet et la dernire date de modification dun objet. En revanche, le plan contient uniquement les travaux et les flux de travaux planifis des fins dexcution pour la production du jour, ainsi que les objets qui en dpendent. base de donnes tendue : Les bases de donnes tendues acceptent les noms longs pour les objets de base de donnes, tels que les travaux, les flux de travaux, les postes de travail, les domaines et les utilisateurs. Les bases de donnes tendues sont configures laide de la commande dbexpand ou sous forme doption lors de linstallation. Ne dveloppez pas votre base de donnes avant de comprendre les implications et les incidences de cette commande. batchman : Processus excut au dbut de chaque jour de traitement de Tivoli Workload Scheduler pour lancer des travaux conformment aux informations du fichier Symphony.

C
calendrier : Objet dfini dans la base de donnes Tivoli Workload Scheduler comprenant une liste de dates de planification. Sagissant dun objet unique
Copyright IBM Corp. 2000, 2003

201

cycle dexcution exclusif : Cycle dexcution indiquant les jours pendant lesquels un flux de travaux ne peut pas sexcuter. Les cycles dexcution exclusifs sont prioritaires par rapport aux cycles dexcution inclusifs. cycle dexcution hebdomadaire : Cycle dexcution prcisant les jours de la semaine o un flux de travaux doit tre excut. Par exemple, vous pouvez indiquer quun flux de travaux doit tre excut tous les lundis, mercredis et vendredis laide dun cycle dexcution hebdomadaire. Il est dfini pour un flux de travaux spcifique et ne peut tre utilis pour plusieurs flux de travaux. Pour plus de dtails, voir cycle dexcution. cycle dexcution inclusif : Cycle dexcution prcisant les jours o un flux de travaux doit tre excut. Les cycles dexcution exclusifs sont prioritaires par rapport aux cycles dexcution inclusifs. cycle dexcution simple : Ensemble de jours dfinis par lutilisateur pendant lesquels un flux de travaux est excut. Il est dfini pour un flux de travaux spcifique et ne peut tre utilis pour plusieurs flux de travaux. Pour plus de dtails, voir cycle dexcution.

E
chance : Heure au-del de laquelle un travail ou un flux de travaux ne peuvent plus tre excuts. Il sagit de lheure limite du module Maestro existant.

F
fichier stdlist : Fichier liste standard cr pour chaque travail lanc par Tivoli Workload Scheduler. Ces fichiers peuvent contenir des bannires den-tte et de fin, des commandes echo ainsi que des messages derreur et davertissement. Ils peuvent tre utiliss pour rsoudre les incidents survenus lors de lexcution de travaux. fichier Symphony : Fichier contenant les informations de planification ncessaires au processus de contrle de production (batchman) pour excuter le plan. Il est gnr et charg durant la phase de pr-production. Lors de la phase de production, il est mis jour en temps rel pour reflter le statut en cours du processus de production : travaux termins, travaux en cours, travaux restant effectuer. Pour grer le processus de production, le contenu du fichier Symphony (plan) peut tre affich et modifi laide de Job Scheduling Console. flux de travaux : Liste de travaux excuts comme un ensemble (application de sauvegarde hebdomadaire, par exemple), et accompagns des heures, des priorits et de toute autre dpendance dterminant lordre exact dexcution des travaux. flux de travaux FINAL : Dernier flux lanc lors dun jour de production, contenant un travail qui excute le fichier script Jnextday.

D
dpendance : Condition pralable lexcution dun travail ou dun flux de travaux. Le nombre maximal de dpendances admis pour un travail ou un flux de travaux est fix 40. Les quatre types de dpendances utilises par Tivoli Workload Scheduler sont les dpendances prdcesseur/successeur, les dpendances par rapport une ressource, les dpendances par rapport un fichier et les dpendances par rapport une invite. dpendances inter-rseaux (INET) : Dpendance entre les travaux et les flux de travaux dans les diffrents rseaux Tivoli Workload Scheduler. Voir aussi agent rseau. dpendances prdcesseur/successeur : Dpendance selon laquelle un travail ou un flux de travaux ne peut tre lanc tant que les autres travaux ou flux de travaux nont pas abouti. domaine : Groupe nomm de postes de travail Tivoli Workload Scheduler constitu dun ou de plusieurs agents et dun gestionnaire de domaine servant de concentrateur de gestion. Tous les domaines, lexception du domaine principal, ont un domaine parent. dure : Dlai prvu pour lexcution dun travail. Dans la vue Diagramme des travaux de la base de donnes, la dure est reprsente par une barre bleu clair situe au milieu de la barre dactivit ou par un losange bleu clair.

G
gestionnaire de domaine : Concentrateur de gestion dun domaine Tivoli Workload Scheduler. Toutes les communications destination et en provenance des agents du domaine sont achemines via le gestionnaire de domaine. gestionnaire de domaine principal : Dans un rseau Tivoli Workload Scheduler, le gestionnaire de domaine principal gre les fichiers servant documenter les objets de planification. Il cre le plan en dbut de journe et effectue lensemble des oprations de journalisation et de prsentation pour le rseau.

H
heure de dbut au plus tt : Heure avant laquelle le travail ou le flux de travaux ne peut pas tre lanc. Lheure de dbut au plus tt correspond une estimation base sur lexprience acquise lors de lexcution dun travail ou dun flux de travaux. Le travail ou le flux de travaux peut toutefois tre lanc

202

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

aprs lheure dfinie partir du moment ou toutes les autres dpendances sont respectes. Dans le diagramme, lheure de dbut est reprsente par le bord gauche de la barre dactivit bleu marine. Pour les instances de travaux, lheure de dbut calcule par IBM Tivoli Workload Scheduler pour z/OS est reprsente par une barre bleu clair. Voir aussi heure de dbut relle et heure de dbut prvue. heure de dbut prvue : Heure laquelle le planificateur estime quune instance de travail dbutera. Cette estimation se base sur lheure de dbut des excutions prcdentes. hte : Poste de travail Workload Scheduler requis par les agents tendus. Il peut sagir de nimporte quel poste de travail planificateur, lexception dun autre agent tendu.

M
mthode daccs : Une mthode daccs est un excutable utilis par les agents tendus pour connecter et contrler lexcution des travaux sur dautres systmes dexploitation (par exemple, MVS) et applications (par exemple, Oracle, Peoplesoft et R/3). La mthode daccs doit tre indique dans la dfinition de poste de travail de lagent tendu.

O
options globales : Les options globales sont dfinies sur le gestionnaire de domaine principal dans le fichier globalopts et sappliquent tous les postes de travail du rseau Tivoli Workload Scheduler. Voir aussi options locales. options locales : Les options locales sont dfinies dans le fichier localopts. Chaque poste de travail du rseau Tivoli Workload Scheduler doit avoir un fichier localopts. Les paramtres de ce fichier sappliquent uniquement ce poste de travail. Voir aussi options globales.

I
instance de flux de travaux : Flux de travaux planifi pour une date dexcution spcifique du plan. Voir aussi flux de travaux. instance de travail : Travail planifi pour une date dexcution particulire du plan. Voir aussi travail. invite : Les invites peuvent servir de dpendances pour les travaux et flux de travaux. Une rponse affirmative doit tre donne une invite pour que le travail ou le flux de travaux correspondant puisse tre lanc. Il existe deux types dinvites : prdfinies et ad hoc. Une invite ad hoc est dfinie dans les proprits dun travail ou dun flux de travaux et est spcifique ce travail ou ce flux de travaux. Une invite prdfinie est dfinie dans la base de donnes du planificateur et peut tre utilise par nimporte quel travail ou flux de travaux.

P
paramtre : Les paramtres permettent de remplacer des valeurs dans les travaux et les flux de travaux. Lorsque vous utilisez un paramtre dans un script de travail, la valeur de celui-ci est remplace au moment de lexcution. Dans ce cas, le paramtre doit tre dfini sur le poste de travail o il va tre utilis. Les paramtres ne peuvent pas tre utiliss dans les scripts des travaux dagent tendu. plan : Le plan contient toute lactivit de planification des travaux prvue pour une journe. Dans Tivoli Workload Scheduler, le plan est cr toutes les 24 heures et est constitu de tous les travaux, flux de travaux et dpendances dont lexcution est planifie pour cette journe. Tous les flux de travaux pour lesquels vous avez cr des cycles dexcution sont automatiquement planifis et intgrs dans le plan. Au fur et mesure de la progression du cycle dexcution, les travaux et flux de travaux du plan sont excuts conformment aux restrictions temporelles et autres dpendances les affectant. Tout travail ou flux de travaux ayant chou est intgr au plan du jour suivant. poste de travail : Un poste de travail est gnralement un ordinateur individuel sur lequel sont excuts les travaux et flux de travaux. Ils sont dfinis dans la base de donnes Tivoli Workload Scheduler en tant quobjet unique. Une dfinition de poste de travail est requise pour chaque ordinateur excutant des travaux ou des flux de travaux dans le rseau Workload Scheduler.

L
limite : La limite dun travail permet de dfinir le nombre spcifique de travaux que Tivoli Workload Scheduler est autoris lancer. Une limite de travail peut tre dfinie pour chaque flux de travaux et pour chaque poste de travail. Par exemple, avec une limite de 25, le planificateur peut excuter simultanment un maximum de 25 travaux sur un poste de travail. liste : Une liste affiche les objets de planification des travaux. Vous devez crer des listes distinctes pour chaque objet de planification des travaux. Pour chacun de ces objets, il existe deux types de listes : une liste de dfinitions dans la base de donnes et une liste dinstances dans le plan.

Glossaire

203

prdcesseur : Travail dont la russite est ncessaire lexcution des travaux successeurs. priorit : Le planificateur possde un systme de file dattente pour les travaux et les flux de travaux du plan. Vous pouvez associer un niveau de priorit chaque travail ou flux de travaux, de 0 101. Un travail avec une priorit de 0 ne sera pas excut. priorit limite : La priorit limite dun travail permet de contrler lexcution de celui-ci sur un poste de travail. Elle constitue galement un niveau de priorit quun travail ou un flux de travaux doit dpasser afin de pouvoir tre excut. Une priorit limite de 40, par exemple, empche le lancement des travaux dont la priorit est infrieure ou gale 40.

successeur : Travail ne pouvant pas tre lanc avant que tous les travaux prdcesseurs dont il dpend ne soient termins.

T
travail : Unit de travail traite sur un poste de travail. La dfinition du travail est constitue dun nom de travail unique dans la base de donnes du planificateur ainsi que dautres informations ncessaires lexcution du travail. Lorsque vous ajoutez un travail un flux de travaux, vous pouvez dfinir ses dpendances et ses restrictions temporelles, telles que lheure de dbut et lchance prvues. travail externe : Travail dun flux de travaux donn, prdcesseur dun travail dun autre flux de travaux. Un travail externe est reprsent par une icne de rserve dans la vue Graphe du flux de travaux. travail/flux de travaux inter-rseaux (INET) : Travail ou flux de travaux dun rseau Tivoli Workload Scheduler loign, correspondant au prdcesseur dun travail ou dun flux de travaux du rseau local. Un travail interrseau est reprsent par une icne de rserve dans la vue Graphe du flux de travaux. Voir aussi agent rseau. travail Jnextday : Le traitement de la pr et de la post-production peut tre entirement automatis en planifiant lexcution du travail Jnextday la fin de chaque journe. Un exemple de travail jnextday est fourni dans racine_TWS\Jnextday. Le travail Jnextday effectue les oprations suivantes : il configure le traitement du jour suivant (contenu dans le fichier Symphony), il imprime des tats, il reporte des flux de travaux non termins, il arrte et relance le planificateur. travaux interactifs : Travail excut de manire interactive sur un bureau Windows NT.

R
ressource : Les ressources peuvent reprsenter des ressources physiques ou logiques sur votre systme. Une fois dfinies dans la base de donnes Tivoli Workload Scheduler, elles peuvent servir de dpendances pour des travaux et flux de travaux. Par exemple, vous pouvez dfinir une ressource appele bandes avec une valeur dunit gale deux. Ensuite, dfinissez des travaux avec une dpendance requrant deux lecteurs de bandes disponibles. Les travaux lis cette dpendance ne pourront pas sexcuter en mme temps, car chaque fois quun travail est excut, la ressource bandes est utilise. restrictions temporelles : Des restrictions temporelles peuvent tre dfinies pour les travaux et les flux de travaux. Vous pouvez spcifier lheure de dbut dexcution des travaux ou celle aprs laquelle ils ne seront plus entrepris. En prcisant les deux, vous dfinissez un intervalle de temps pendant lequel un travail ou un flux de travaux doit tre excut. Vous pouvez galement indiquer la frquence de rptition des travaux. Par exemple, vous pouvez configurer Tivoli Workload Scheduler de sorte que le mme travail soit lanc toutes les 30 minutes entre 8 heures 30 et 13 heures 30.

U
utilisateur : Pour Windows NT uniquement, le nom dutilisateur indiqu dans la zone Connexion dune dfinition de travail doit correspondre une dfinition dutilisateur. Les dfinitions fournissent les mots de passe utilisateur requis par le planificateur pour lancer les travaux. utilitaires : Ensemble dexcutables de ligne de commande permettant la gestion du planificateur.

S
statut : Reflte ltat en cours du travail ou du flux de travaux dans Job Scheduling Console. Le statut de Job Scheduling Console est commun Tivoli Workload Scheduler et IBM Tivoli Workload Scheduler pour z/OS. Voir aussi statut interne. statut du travail : Voir statut. statut interne : Reflte ltat en cours des travaux et flux de travaux dans le moteur du planificateur. Le statut interne est propre Tivoli Workload Scheduler. Voir aussi statut.

V
vue Arborescence : Vue situe dans la partie gauche de Job Scheduling Console et dans laquelle saffiche le serveur du planificateur, les groupes de listes par dfaut et les groupes de listes cres par lutilisateur.

204

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

X
X-agent : Voir agent tendu.

Glossaire

205

206

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

Index Caractres spciaux


NOM_POSTE_DE_TRAV AIL_MCMAGENT.opts 48

D
dbogage 96 DEBUG 147 dfinition de travaux Oracle Applications dans Tivoli Workload Scheduler 49 dfinition des travaux dans Oracle Applications dfinition des travaux dans PeopleSoft 58 dfinition des travaux dans R/3 101 dfinitions de travaux 77 dmarrage 145 dpannage dune connexion R/3 96 dpendance OPENS 78 dpendance sur des travaux z/OS 155 dpendances de travail z/OS 155 dpendances OPENS, exemple 80

A
accessibilit xv agent standard 45 tolrance aux pannes 45 agent de planification prsentation 85 agent tendu dfinition de poste de travail 171 prsentation 171 rfrence 171 agent tendu Oracle Applications fonctions 45 Attente BDC 127

49

E
enigma 54 tapes, ajout 106 tats, travail 111 tats de lapplication OPC 162 tats de loccurrence pour OPC 162 tats des travaux Maestro et Oracle Applications 52 tats des travaux pour CA7 160 tats des travaux pour JES 159 tats des travaux pour OPC 162 tats des travaux R/3 111 excution dun travail 203 exemple de dpendances OPENS 80

B
bases de donnes Peoplesoft bm check status 161, 163 69

C
CA7INTERFACE 146 CA7NAME 146 CA7OPTIONS 146 CA7SPAN(9999) 146 CA7SUBSYSTEM 146 CA7USER 146 CFuser 152 CheckInterval 152 chiffrage des mots de passe 54 chiffrage des mots de passe utilisateur 54 commande de publications xiv commentaires sur les publications xv compatibilit 87 COMPLETIONCODE 147 configuration logicielle requise 61, 63 configuration requise pour lhte 61 connexion plusieurs bases de donnes 69 connexion R/3 96 connexion R/3, dpannage 96 contact par courrier lectronique xv contrle de lexcution des travaux 101 conventions typographiques xv conventions typographiques xv cration dun travail 102 cration dun travail dans R/3 101 cration dune dpendance OPENS 78 cration de travaux dagent tendu 77 cration du profil dautorisation 91

F
fichier doptions 57 fichier doptions, R3OPTIONS 85 fichier de commandes 94 fichier de donnes 94 fichier mcmagent.opts exemple 54 prsentation 53 syntaxe des entres 53 Fichier script 154 fichiers doptions psagent 65 fichiers de correction et de transfert fonctions 45, 57, 141

94

G
gnralits gnralits gnralits gnralits gnralits sur sur sur sur sur linstallation 87 le fonctionnement le fonctionnement le fonctionnement le fonctionnement avec avec avec avec CA7 160 JES 160 linterface JES 159 linterface OPC 162

H
hte cible 105 Copyright IBM Corp. 2000, 2003

207

I
informations relatives au diagnostic installation 149 installation des modules ABAP 91 INTERLINKSUBSYSTEM 147 introduction 57 164

J
JCL pour tlcharger la bande 143 JESCMDCHR 147 journal des travaux 127

L
LJuser 152 logiciel configuration requise 45

PEERADDRESS 148 pile TCPIP 148 PORT 148 prsentation 57 prsentation technique 159 profil dautorisation, cration 91 profil RFC 91 programme enigma 89 programme externe 106 programme externe, ajout 106 programmes composants 47 programmes dinterface 47 psagent 57, 69 publications xii accs en ligne xiv commande xiv publications en ligne accs xiv PUTLINE 148

M
manuels voir publications xii, xiv mappage de statut des travaux 80 MAXWAIT 147 MCMAGENT 47 MCMAGENT.opts 48 MCSSTORAGE 147 messages 167 messages derreur 167 messages de la passerelle 167 mthode 85 mthode R3BATCH 85 modification du mot de passe, utilisateur RFC 97 module ABAP, ajout 106 modules ABAP 106 modules ABAP, importation 94 mot de passe de lutilisateur RFC 97 mot de passe utilisateur R/3, chiffrement 89 multiples bases de donnes Peoplesoft 69

Q
QLIMIT 148

R
R3OPTIONS, fichier 85

S
scurit 145 scurit de la console 145 service dassistance la clientle voir service de support xv service de support contact xv sortie IEFU84 144 statut des travaux, mappage 80 SUBSYS 148 SVCDUMP 148 syntaxe, fichier mcmagent.opts 53

N
noms de chemin, notation xvi noms de rpertoire, notation xvi notation noms de chemin xvi typographie xvi variables denvironnement xvi

T
TCPIPSTACK 148 TCPNAME 149 TERMINATOR 149 Tivoli Software Information Center trace 96 travaux tats des travaux 111 travaux, mappage de statut 80 travaux CA7 153 travaux JES 153 travaux OPC 154 travaux Oracle Applications dfinition 49 xiv

O
OPCINTERFACE 147 OPCMSGCLASS 148 OPCSUBSYSTEM 148 OPERCMDS 145 option dattente BDC 97 options psagent 65

P
passerelle z/OS tlchargement des fichiers partir de la bande 143 tlchargement des fichiers partir du CD-ROM 143

U
utilisateur RFC 96

208

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

V
variables, notation des xvi variables denvironnement, notation variables SYSTSIN 145 version TCP/IP 141 xvi

W
WTP 149

Z
ZOSV1R2 149

Index

209

210

IBM Tivoli Workload Scheduler for Applications - Guide dutilisation

SC11-2011-00