Version 8.2 (révisée en décembre 2004) Guide de référence SC

Transcription

1 Tivoli IBM Tivoli Workload Scheduler Version 8.2 (révisée en décembre 2004) Guide de référence SC

2

3 Tivoli IBM Tivoli Workload Scheduler Version 8.2 (révisée en décembre 2004) Guide de référence SC

4 Remarques Avant d utiliser le présent document et le produit associé, prenez connaissance des informations figurant dans la section «Remarques», à la page 359. Troisième édition - décembre 2004 Réf. US : SC LE PRESENT DOCUMENT EST LIVRE EN L ETAT. 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 D ADAPTATION A VOS BESOINS. Certaines juridictions n autorisent pas l exclusion des garanties implicites, auquel cas l exclusion ci-dessus ne vous sera pas applicable. Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d être modifiées avant que les produits décrits ne deviennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu ils y seront annoncés. Pour plus de détails, pour toute demande d ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial. Vous pouvez également consulter les serveurs Internet suivants : v (serveur IBM en France) v (serveur IBM au Canada) v (serveur IBM aux Etats-Unis) Compagnie IBM France Direction Qualité Tour Descartes Paris-La Défense Cedex 50 Copyright IBM France Tous droits réservés. Copyright International Business Machines Corporation 1999, All rights reserved.

5 Table des matières Figures vii Tableaux ix Avis aux lecteurs canadiens xi A propos de ce guide xiii Nouveautés xiii A qui s adresse ce guide xiii Organisation de ce guide xiii Publications xiv Bibliothèque IBM Tivoli Workload Scheduler..xv Publications connexes xviii Accès aux publications en ligne xviii Commande de publications xix Commentaires sur les publications..... xix Accessibilité xix Formation technique Tivoli xix Informations sur le support xx Conventions de ce guide xx Conventions typographiques xx Chemins et variables dépendants du système d exploitation xxi Syntaxe des commandes xxi Chapitre 1. Mise en route rapide Création d un plan Gestion des travaux et des flux de travaux....6 Chapitre 2. Cycle de production Interfaces et processus principaux du produit...9 Interfaces utilisateur Commandes de préproduction et de postproduction Commandes de sécurité Processus de production Arborescence des processus sur les plateformes UNIX Arborescence des processus sur les plateformes Windows Automatisation du cycle de production Personnalisation du flux de travaux final...15 Ajout du flux de travaux final Démarrage d un cycle de production Gestion de l environnement de production Choix du début d une journée IBM Tivoli Workload Scheduler Modification du début de journée Création d un plan pour des dates passées ou à venir Utilisation d états Lancement des travaux Variables d environnement des travaux Script de configuration standard - jobmanrc..19 Script de configuration local - $HOME/.jobmanrc 21 Commandes de traitement de production Commande schedulr Commande compiler Commande stageman Commande logman Commande wmaeutil Chapitre 3. Référence au programme Composer Gestion des objets de planification Définitions de poste de travail Définitions de classe de postes de travail...43 Définitions de domaine Définitions de travail Définitions d utilisateur Définitions de calendrier Définitions de paramètre Définitions d invite Définitions de ressource Programme de ligne de commande Composer...63 Exécution du programme Composer Syntaxe des commandes Description des commandes add build continue create delete display, list, print edit exit modify new redo replace system command validate version Chapitre 4. Langage de planification.. 91 Syntaxe des flux de travaux Mots clés Dépendances Distinction majuscules/minuscules Description des mots clés at carryforward comments confirmed deadline end every except follows Copyright IBM Corp. 1999, 2004 iii

6 freedays job statement keyjob keysched limit needs on opens priority prompt schedule until Chapitre 5. Référence au programme Conman Exécution du programme Conman Exemples Caractères de commande Exécution des commandes système Invites utilisateur Sortie sur le terminal Sortie offline Sélection de l invite de commande Conman Syntaxe des commandes Caractères génériques Délimiteurs et caractères spéciaux Liste des commandes Sélection de travaux dans les commandes Syntaxe Arguments Sélection de flux de travaux dans les commandes 143 Syntaxe Arguments Description des commandes Traitement des commandes Conman adddep job adddep sched altpass altpri cancel job cancel sched confirm console continue deldep job deldep sched display exit fence help kill limit cpu limit sched link listsym recall redo release job release sched reply rerun resource setsym showcpus showdomain showfiles showjobs showprompts showresources showschedules shutdown start status stop stop ;progressive submit docommand submit file submit job submit sched switchmgr system tellop unlink version Chapitre 6. Commandes d utilitaire 237 Description des commandes Commandes at et batch caxtract cpuinfo datecalc dbexpand delete evtsize jbxtract jobinfo jobstdl maestro makecal metronome.pl morestdl parms paxtract prxtract r11xtr release rextract rmstdlist showexec StartUp version wmaeutil xrxtrct Commandes non prises en charge Chapitre 7. Présentation des commandes de génération d états Commandes de génération d états Résultat de la commande Commandes rep1 à rep4b Commande rep iv IBM Tivoli Workload Scheduler - Guide de référence

7 Commande rep Commande rep Commande reptr Commande xref Modèles d état Chapitre 8. Référence aux agents étendus Présentation des agents étendus Définition de poste de travail Interface vers les méthodes d accès Syntaxe de la ligne de commande des méthodes 303 Messages de réponse des méthodes Fichier d options de méthode Exécution des méthodes Tâche de lancement d un travail (LJ) Tâche de gestion du travail (MJ) Tâche de vérification d un fichier (CF) Tâche d obtention d un statut (GS) Commande cpuinfo Identification et résolution des incidents Messages d erreur de la liste standard d un travail Méthode non exécutable Messages du gestionnaire de console Messages des programmes Composer et compiler Messages du programme jobman Chapitre 9. Référence aux agents réseau Présentation Configuration d un poste de travail d agent réseau 313 Exemple de ligne de commande d agent réseau 315 Fichier d options Dépendances interréseau Création d une dépendance interréseau sur un flux de travaux Dépendances interréseau et Conman Chapitre 10. Configuration des définitions de sécurité utilisateur Centralisation de la sécurité Utilisation du fichier de sécurité Création du fichier de sécurité Modification du fichier de sécurité Syntaxe du fichier de sécurité Définitions d utilisateur Exemple de fichier de sécurité dumpsec makesec Annexe A. Informations sur le support 343 Recherche d un incident dans les bases de connaissances Recherche dans le centre d information à partir de votre système local ou du réseau Recherche dans l Information Center du site Web de support IBM Recherche sur Internet Recherche de correctifs Service de support logiciel IBM Détermination de l impact de l incident sur vos activités Description de l incident et collecte des informations pertinentes Soumission d un incident au service de support logiciel IBM Annexe B. Gestion des fuseaux horaires Activation de la fonction Fuseau horaire Exécution d un flux de travaux sans fuseau horaire activé alors que le gestionnaire de domaine maître avance par rapport à l agent à tolérance de pannes Exécution d un flux de travaux avec fuseau horaire activé alors que le gestionnaire de domaine maître avance par rapport à l agent à tolérance de pannes Exécution d un flux de travaux sans fuseau horaire activé alors que le gestionnaire de domaine maître retarde par rapport à l agent à tolérance de pannes Exécution d un flux de travaux avec fuseau horaire activé alors que le gestionnaire de domaine maître retarde par rapport à l agent à tolérance de pannes Soumission d un flux de travaux ad hoc caractérisé par une dépendance at Soumission d un flux de travaux caractérisé par une dépendance at survenant pendant l heure d été Liste des fuseaux horaires Annexe C. Fonction d audit Activation de la fonction d audit Format des journaux d audit En-tête du journal d audit Exemples d entrée du journal d audit Remarques Marques Glossaire Index Table des matières v

8 vi IBM Tivoli Workload Scheduler - Guide de référence

9 Figures 1. Arborescence des processus sur UNIX Arborescence des processus sur Windows Liaisons réseau Postes de travail réseau démarrés Postes de travail réseau arrêtés Postes de travail réseau non liés Réseaux local et distant Zones mortes Copyright IBM Corp. 1999, 2004 vii

10 viii IBM Tivoli Workload Scheduler - Guide de référence

11 Tableaux 1. Syntaxe de commande xxi 2. Variables d environnement des travaux Variables jobmanrc Liste des mots réservés Valeurs des systèmes d exploitation pris en charge Type de communication selon la valeur de securitylevel Opérateur de comparaison Opérateurs logiques Opérateur de comparaison Opérateurs logiques Attribut d objet Actions Actions (suite) Copyright IBM Corp. 1999, 2004 ix

12 x IBM Tivoli Workload Scheduler - Guide de référence

13 Avis aux lecteurs canadiens Le présent document a été traduit en France. Voici les principales différences et particularités dont vous devez tenir compte. Illustrations Les illustrations sont fournies à titre d exemple. Certaines peuvent contenir des données propres à la France. Terminologie La terminologie des titres IBM peut différer d un pays à l autre. Reportez-vous au tableau ci-dessous, au besoin. IBM France IBM Canada ingénieur commercial représentant agence commerciale succursale ingénieur technico-commercial informaticien inspecteur technicien du matériel Claviers Les lettres sont disposées différemment : le clavier français est de type AZERTY, et le clavier français-canadien de type QWERTY. OS/2 et Windows - Paramètres canadiens Au Canada, on utilise : v les pages de codes 850 (multilingue) et 863 (français-canadien), v le code pays 002, v le code clavier CF. Nomenclature Les touches présentées dans le tableau d équivalence suivant sont libellées différemment selon qu il s agit du clavier de la France, du clavier du Canada ou du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de votre clavier. Copyright IBM Corp. 1999, 2004 xi

14 Brevets Il est possible qu IBM détienne des brevets ou qu elle ait déposé des demandes de brevets portant sur certains sujets abordés dans ce document. Le fait qu IBM vous fournisse le présent document ne signifie pas qu elle vous accorde un permis d utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux permis d utilisation au directeur général des relations commerciales d IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7. Assistance téléphonique Si vous avez besoin d assistance ou si vous voulez commander du matériel, des logiciels et des publications IBM, contactez IBM direct au xii IBM Tivoli Workload Scheduler - Guide de référence

15 A propos de ce guide Nouveautés A qui s adresse ce guide Organisation de ce guide IBM Tivoli Workload Scheduler simplifie la gestion de systèmes dans des environnements distribués en intégrant des fonctions de gestion de systèmes. IBM Tivoli Workload Scheduler planifie, automatise et contrôle le traitement de la charge de production de votre entreprise dans son intégralité. Le document IBM Tivoli Workload Scheduler - Guide de référence fournit des informations détaillées sur l interface de ligne de commande, le langage de planification et les commandes d utilitaire d IBM Tivoli Workload Scheduler. Cette édition est une mise à jour du document anglais IBM Tivoli Workload Scheduler Reference Guide version 8.2, dernièrement mis à jour en avril Le présent document a été modifié comme suit : v Nous avons ajouté la section Informations complémentaires à la description des différentes commandes. v Nous avons illustré les commandes par un plus grand nombre d exemples. v Nous avons ajouté une nouvelle section au Chapitre 2. Elle décrit les interfaces et les processus du produit (voir «Interfaces et processus principaux du produit», à la page 9). v Nous avons ajouté le chapitre Initiation, qui s adresse tout particulièrement aux nouveaux utilisateurs. v Nous avons ajouté de nouvelles informations sur le fichier de sécurité (voir Chapitre 10, «Configuration des définitions de sécurité utilisateur», à la page 323). v Nous avons ajouté une nouvelle annexe, qui explique comment contacter le service de support logiciel IBM (voir Annexe A, «Informations sur le support», à la page 343). v Nous avons ajouté une nouvelle annexe, qui décrit la fonction Fuseau horaire (voir Annexe B, «Gestion des fuseaux horaires», à la page 347). v Le contenu du présent document a été mis à jour pour refléter les deux correctifs APAR IY58702 et IY Le présent document s adresse aux administrateurs et aux utilisateurs IBM Tivoli Workload Scheduler expérimentés. Ce manuel contient les chapitres suivants : v Chapitre 1, «Mise en route rapide», à la page 1 Présente aux nouveaux utilisateurs les procédures de base qu ils doivent suivre pour utiliser IBM Tivoli Workload Scheduler pour la première fois. Copyright IBM Corp. 1999, 2004 xiii

16 v Chapitre 2, «Cycle de production», à la page 9 Explique comment IBM Tivoli Workload Scheduler détermine à la fin de chaque journée les calendriers, qui doivent être exécutés le jour suivant selon le contenu de la base de données et les résultats du traitement de la journée de production courante. v Chapitre 3, «Référence au programme Composer», à la page 35 Détaille les objets de planification que vous pouvez définir dans la base de données IBM Tivoli Workload Scheduler et présente l utilisation et la syntaxe des commandes utilisées dans le programme Composer pour gérer les objets de la base de données. v Chapitre 4, «Langage de planification», à la page 91 Explique comment créer un flux de travaux selon les objets de planification définis dans la base de données IBM Tivoli Workload Scheduler en utilisant les commandes Composer. v Chapitre 5, «Référence au programme Conman», à la page 129 Décrit l interface de ligne de commande de Conman. Elle permet de surveiller et de gérer les travaux et les flux de travaux tout au long de la journée de production. v Chapitre 6, «Commandes d utilitaire», à la page 237 Décrit les commandes d utilitaire IBM Tivoli Workload Scheduler qui gèrent l environnement. v Chapitre 7, «Présentation des commandes de génération d états», à la page 289 Décrit comment imprimer différents types d état. v Chapitre 8, «Référence aux agents étendus», à la page 303 Explique comment créer et utiliser des agents étendus pour proposer les fonctions de planification de travaux du produit IBM Tivoli Workload Scheduler aux autres systèmes et applications, notamment les systèmes UNIX locaux ou distants, Peoplesoft, SAP R/3, z/os, OPC, Oracle CCM et VMS. v Chapitre 9, «Référence aux agents réseau», à la page 313 Explique comment créer et utiliser un poste de travail agent réseau pour gérer les dépendances interréseau de planification. v Chapitre 10, «Configuration des définitions de sécurité utilisateur», à la page 323 Explique comment gérer le fichier de sécurité. v Annexe A, «Informations sur le support», à la page 343 Détaille les différentes possibilités, qui permettent d obtenir de l aide sur les produits IBM. v Annexe B, «Gestion des fuseaux horaires», à la page 347 Répertorie les fuseaux horaires pris en charge par IBM Tivoli Workload Scheduler. v Annexe C, «Fonction d audit», à la page 353 Explique comment activer et utiliser l option d audit pour réaliser un suivi des modifications, qui ont été appliquées à la base de données et au plan. Publications La présente section répertorie toutes les publications de la bibliothèque Tivoli Workload Scheduler et autres documents associés. Elle explique également comment accéder en ligne aux publications Tivoli et comment les commander. xiv IBM Tivoli Workload Scheduler - Guide de référence

17 Bibliothèque IBM Tivoli Workload Scheduler Tout comme IBM Tivoli Workload Scheduler, la bibliothèque inclut plusieurs produits distincts, disponibles sur plusieurs plateformes : Bibliothèque d IBM Tivoli Workload Scheduling Suite Elle contient toutes les publications concernant IBM Tivoli Workload Scheduler pour toutes les plateformes et pour tous les produits pour toutes les plateformes et pour tous les produits. Bibliothèque distribuée d IBM Tivoli Workload Scheduler Elle comprend toutes les publications se référant à l utilisation d IBM Tivoli Workload Scheduler sur les plateformes autres que z/os. Bibliothèque d IBM Tivoli Workload Scheduler pour z/os Elle comprend toutes les publications qui ne concernent qu IBM Tivoli Workload Scheduler pour z/os. Bibliothèque d IBM Tivoli Workload Scheduler for Applications Elle comprend toutes les publications qui ne concernent qu IBM Tivoli Workload Scheduler for Applications. Bibliothèque d IBM Tivoli Workload Scheduler for Virtualized Data Centers Elle comprend toutes les publications qui ne concernent qu IBM Tivoli Workload Scheduler for Virtualized Data Centers. Bibliothèque d IBM Tivoli Workload Scheduling Suite Vous trouverez les publications suivantes dans la bibliothèque d IBM Tivoli Workload Scheduling Suite. Ces publications se rapportent à tous les produits, pour toutes les plateformes et tous les composants. v IBM Tivoli Workload Scheduler : Informations générales, SC Fournit des informations d ordre général sur tous les produits IBM Tivoli Workload Scheduler. Explique comment les faire fonctionner ensemble, afin d offrir des solutions de gestion de la charge de travail pour l ensemble de l entreprise. v IBM Tivoli Workload Scheduler : Job Scheduling Console - Guide d utilisation, SC Explique comment utiliser IBM Tivoli Workload Scheduler, quelle que soit la plateforme, à l aide d une interface utilisateur standard appelée Job Scheduling Console. v IBM Tivoli Workload Scheduler : Job Scheduling Console - Notes d édition, SC Fournit des informations de dernière minute sur Job Scheduling Console. v IBM Tivoli Workload Scheduler : Warehouse Enablement Pack Version Implementation Guide for Tivoli Enterprise Data Warehouse, Version 1.1, Fournit des informations sur l activation d IBM Tivoli Workload Scheduler pour Tivoli Data Warehouse. Remarque : Ce guide n est disponible que sur le CD du produit. Contrairement aux autres guides, il n est pas accessible en ligne (voir «Accès aux publications en ligne», à la page xviii). Bibliothèque distribuée d IBM Tivoli Workload Scheduler Vous trouverez les publications suivantes dans la bibliothèque distribuée d IBM Tivoli Workload Scheduler. Elles se réfèrent à l utilisation du produit sur toutes les plateformes, sauf z/os. A propos de ce guide xv

18 v IBM Tivoli Workload Scheduler : Notes sur l édition, SC Fournit des informations de dernière minute sur IBM Tivoli Workload Scheduler pour toutes les plateformes, sauf z/os. v IBM Tivoli Workload Scheduler : Guide de planification et d installation, SC Décrit la planification et l installation d IBM Tivoli Workload Scheduler sur des plateformes différentes de z/os, ainsi que l intégration d IBM Tivoli Workload Scheduler avec NetView, Tivoli Data Warehouse et IBM IBM Tivoli Business Systems Manager. v IBM Tivoli Workload Scheduler : Guide de référence, SC Décrit la ligne de commande IBM Tivoli Workload Scheduler utilisée sur des plateformes autres que z/os, ainsi que le fonctionnement des agents étendus et agents réseau. v IBM Tivoli Workload Scheduler : Troubleshooting and Error Messages, SC Fournit des informations sur l administration d IBM Tivoli Workload Scheduler sur des plateformes autres que z/os et sur la gestion des incidents. Ce guide inclut une rubrique d aide concernant de nombreux messages générés par les principaux composants d IBM Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler : Limited Fault-tolerant Agent for OS/400, SC Décrit l installation, la configuration et l utilisation d agents à tolérance de pannes limités IBM Tivoli Workload Scheduler sur AS/400. v IBM Tivoli Workload Scheduler : Guide d utilisation du module Plus, SC Permet de configurer et d utiliser le module IBM Tivoli Workload Scheduler Plus. Visitez le site pour une présentation du produit. Bibliothèque IBM Tivoli Workload Scheduler pour z/os Les documents ci-après sont disponibles dans la bibliothèque de Tivoli Workload Scheduler pour z/os : v IBM Tivoli Workload Scheduler for z/os : Getting Started, SC Permet de définir les données de votre installation IBM Tivoli Workload Scheduler pour z/os et de créer et de modifier des plans. v IBM Tivoli Workload Scheduler for z/os : Installation Guide Explique comment installer Tivoli Workload Scheduler pour z/os. v IBM Tivoli Workload Scheduler for z/os : Customization and Tuning, SC Explique comment personnaliser Tivoli Workload Scheduler pour z/os. v IBM Tivoli Workload Scheduler for z/os : Managing the Workload, SC Explique comment planifier la charge de travail et comment contrôler et surveiller le plan actuel. v IBM Tivoli Workload Scheduler for z/os : Quick Reference, SC Guide de référence facile à consulter et permettant d utiliser Tivoli Workload Scheduler pour z/os. v IBM Tivoli Workload Scheduler for z/os : Diagnosis Guide and Reference, SC Fournit des informations utiles pour identifier et résoudre les incidents pouvant survenir lors de l utilisation de Tivoli Workload Scheduler pour z/os. v IBM Tivoli Workload Scheduler for z/os : Messages and Codes, SC Explique les messages et les codes de Tivoli Workload Scheduler pour z/os. xvi IBM Tivoli Workload Scheduler - Guide de référence

19 v IBM Tivoli Workload Scheduler for z/os : Programming Interfaces, SC Fournit des informations sur l écriture des programmes d application de Tivoli Workload Scheduler pour z/os. v IBM Tivoli Workload Scheduler for z/os : Licensed Program Specifications, GI Explique comment planifier l utilisation de Tivoli Workload Scheduler pour z/os. v IBM Tivoli Workload Scheduler for z/os : Memo for program 5697-WSZ, GI Fournit un récapitulatif des modifications apportées à l édition actuelle du produit. v IBM Tivoli Workload Scheduler for z/os : Program Directory for program 5697-WSZ, GI Fourni avec la bande d installation de Tivoli Workload Scheduler pour z/os (programme 5697-WSZ), il décrit tous les éléments relatifs à l installation et fournit des instructions d installation spécifiques au niveau d édition ou au numéro du produit. v IBM Tivoli Workload Scheduler for z/os : Program Directory for program 5698-WSZ, GI Fourni avec la bande d installation de Tivoli Workload Scheduler pour z/os (programme 5698-WSC), il décrit tous les éléments relatifs à l installation et fournit des instructions d installation spécifiques au niveau d édition ou au numéro du produit. Visitez le site pour une présentation du produit. Bibliothèque d IBM Tivoli Workload Scheduler for Applications Les guides suivants sont disponibles dans la bibliothèque d IBM Tivoli Workload Scheduler for Applications : v IBM Tivoli Workload Scheduler for Applications : Release Notes, SC Fournit des informations de dernière minute sur les agents étendus IBM Tivoli Workload Scheduler. v IBM Tivoli Workload Scheduler for Applications : Guide d utilisation, SC Décrit l installation, l utilisation et les procédures de résolution des incidents se rapportant aux agents étendus IBM Tivoli Workload Scheduler. Visitez le site pour une présentation du produit. Bibliothèque d IBM Tivoli Workload Scheduler for Virtualized Data Centers Les guides suivants sont disponibles dans la bibliothèque d IBM Tivoli Workload Scheduler for Virtualized Data Centers : v IBM Tivoli Workload Scheduler for Virtualized Data Centers : Notes de mise à jour, SC Fournit des informations de dernière minute sur IBM Tivoli Workload Scheduler for Virtualized Data Centers. v IBM Tivoli Workload Scheduler for Virtualized Data Centers V8.2.0 : Guide d utilisation, SC Explique comment étendre les capacités d IBM Tivoli Workload Scheduler de façon à optimiser les charges de travail et l installation distribuée, en activant le contrôle des travaux IBM LoadLeveler et IBM Grid Toolbox. A propos de ce guide xvii

20 Publications Visitez le site Y614224T20392S50.html pour une présentation du produit. connexes N hésitez pas à consulter les documents suivants, qui réunissent des informations utiles : v IBM Redbooks : High Availability Scenarios with IBM Tivoli Workload Scheduler and IBM Tivoli Framework Ce Redbook IBM vous permet de concevoir et de créer des environnements IBM Tivoli Workload Scheduler et IBM Tivoli Management Framework (serveur TMR, noeuds gérés et noeuds finals) à haute disponibilité. Il présente également des études de cas HACMP (High Availability Cluster Multiprocessing) pour AIX et Microsoft Windows Cluster Service (MSCS). Il est disponible sur le site Web Redbooks, à l adresse v IBM Redbooks : Customizing IBM Tivoli Workload Scheduler for z/os V8.2 to Improve Performance Ce Redbook IBM traite des différentes techniques permettant d améliorer les performances de Tivoli Workload Scheduler pour z/os (y compris la planification complète). Il est disponible sur le site Web Redbooks, à l adresse v IBM Redbooks : End-to-End Scheduling with IBM Tivoli Workload Scheduler Version 8.2 Ce Redbook IBM vous permet de mettre au point une planification complète en utilisant des composants Tivoli Workload Scheduler version 8.2, tant en version répartie (précédemment connue sous le nom de Maestro) que grand système (précédemment appelée OPC). Il est disponible sur le site Web Redbooks, à l adresse Le glossaire des logiciels Tivoli contient les définitions de la plupart des termes techniques relatifs aux logiciels Tivoli. Il est disponible sur le site Web de la bibliothèque logicielle Tivoli : Accès aux publications en ligne Le CD du produit contient les publications figurant dans la bibliothèque du produit. Les publications sont disponibles au format PDF et/ou HTML. Pour y accéder par un navigateur Web, ouvrez le fichier infocenter.html. Le fichier se trouve dans le répertoire de la publication appropriée sur le CD du produit. IBM affiche sur le site Web Tivoli Software Information Center les publications liées à ce produit ainsi qu aux autres produits Tivoli dès qu elles sont disponibles ou mises à jour. Pour accéder à Tivoli Software Information Center, accédez d abord à la bibliothèque des logiciels Tivoli, à l adresse suivante : xviii IBM Tivoli Workload Scheduler - Guide de référence

21 Faites défiler les publications et cliquez sur le lien Product manuals. Dans la liste alphabétique des documents techniques consacrés aux produits Tivoli, cliquez sur le lien du produit Tivoli Workload Scheduler approprié pour accéder aux bibliothèques du produit, dans Tivoli Software Information Center. Toutes les publications de la bibliothèque de la suite IBM Tivoli Workload Scheduler, de la bibliothèque distribuée et de celle de z/os apparaissent sous l entrée IBM Tivoli Workload Scheduler. Remarque : Si vous imprimez des documents PDF sur un format de papier non standard, définissez cette option dans la fenêtre Fichier Imprimer d Adobe Reader ; cette fenêtre permet de définir une impression pour votre type de papier spécifique. Commande de publications Vous pouvez commander de nombreuses publications Tivoli en ligne sur le site Web suivant : pbi.cgi Vous pouvez aussi passer votre commande par téléphone en appelant l un des numéros suivants : v Aux Etats-Unis : v Au Canada : v Dans les autres pays, sélectionnez votre pays dans la page accessible par le lien ci-dessus et cliquez sur About this site pour obtenir la liste des numéros de téléphone de votre représentant local. Commentaires sur les publications Si vous avez des commentaires ou des suggestions concernant les produits Tivoli et leur documentation, répondez à l étude client disponible sur le site Web à l adresse : Accessibilité Les fonctions d accessibilité permettent aux personnes souffrant d un handicap physique (par exemple, une mobilité réduite ou une déficience visuelle) de pouvoir utiliser les logiciels. Avec ce produit, vous pouvez utiliser les technologies d assistance pour parcourir l interface à l aide de messages sonores. Vous pouvez également utiliser le clavier au lieu de la souris pour toutes les fonctions de l interface graphique. Formation technique Tivoli Pour plus d informations, consultez la section Accessibilité du manuel IBM Tivoli Job Scheduling Console - Guide d utilisation. Si vous souhaitez en savoir plus sur la formation technique Tivoli, consultez le site Web IBM Tivoli suivant : A propos de ce guide xix

22 Informations sur le support Conventions de ce guide Conventions Pour résoudre rapidement un incident lié à un logiciel IBM, IBM vous permet d obtenir l assistance que vous souhaitez de plusieurs manières : v En faisant des recherches dans les bases de connaissances : elles contiennent un grand nombre d incidents recensés et de solutions, de remarques d ordre technique et autres informations adéquates. v En vous procurant des correctifs : vous trouverez les versions les plus récentes disponibles pour votre produit. v En contactant le service de support logiciel IBM : si les deux solutions ci-dessus ne vous ont pas permis de résoudre votre incident, vous pouvez contacter directement un technicien IBM de plusieurs manières. Pour plus d informations sur ces trois manières de résoudre un incident, voir Annexe A, «Informations sur le support», à la page 343. Ce guide utilise plusieurs conventions concernant les actions et les termes spécifiques, les chemins et les commandes spécifiques au système d exploitation, la syntaxe de Conman et les graphiques des marges. typographiques Ce document utilise les conventions typographiques suivantes : Gras Italique v Commandes en minuscules et commandes en minuscules et majuscules difficiles à distinguer du reste du texte v Commandes d interface (cases à cocher, boutons de commande, boutons d option, sélecteurs rotatifs, zones, dossiers, icônes, zones de liste, éléments des zones de liste, listes à plusieurs colonnes, conteneurs, options de menu, noms de menu, onglets, fiches techniques), libellés (par exemple Conseil : et Remarques relatives au système d exploitation :) v Mot clés et paramètres dans le texte v Mot définis dans le texte v Insistance sur les mots (mots en tant que tels) v Nouveaux termes dans le texte (sauf dans une liste de définitions) v Variables et valeurs que vous devez fournir Espacement fixe v Exemples et exemples de code v Noms de fichiers, mots clés de programmation et autres éléments difficiles à distinguer du reste du texte v Invites et texte des messages destinés à l utilisateur v Texte à entrer par l utilisateur v Valeurs des arguments ou options de commande xx IBM Tivoli Workload Scheduler - Guide de référence

23 Chemins et variables dépendants du système d exploitation Pour les variables d environnement et la notation des répertoires, ce guide utilise la convention UNIX. Lorsque vous utilisez une ligne de commande Windows, remplacez $variable par %variable% pour les variables d environnement, et remplacez toutes les barres obliques (/) par des barres obliques inversées (\) dans les chemins d accès aux répertoires. Les noms des variables d environnement diffèrent parfois dans Windows et dans UNIX. Par exemple, %TEMP% sous Windows correspond à $tmp sous UNIX. Remarque : Si vous utilisez le shell bash sur un système Windows, vous pouvez utiliser les conventions UNIX. Syntaxe des commandes Lorsqu il décrit des commandes, le présent guide utilise la syntaxe suivante : Tableau 1. Syntaxe de commande Convention de syntaxe Description Crochets ([ ]) Les informations entre crochets ([ ]) sont facultatives. Toutes les autres informations doivent être fournies. Accolades ({ }) Les accolades ({ }) désignent un ensemble d options s excluant mutuellement, lorsqu une seule option est requise. Trait de soulignement ( _ ) Barre verticale ( ) Les traits de soulignement (_) relient plusieurs mots dans une variable. Les options s excluant mutuellement sont séparées par une barre verticale ( ). Vous pouvez entrer une seule des options séparées par la barre verticale au cours de la même utilisation de la commande. Une barre verticale peut être utilisée pour séparer les options facultatives ou obligatoires. Gras Le texte en gras désigne les informations qui doivent être entrées sur la ligne de commande exactement telles quelles. Cela s applique aux noms de commande et aux options invariables. Italique Le texte en italique est variable et doit être remplacé par les informations qu il représente. A propos de ce guide xxi

24 xxii IBM Tivoli Workload Scheduler - Guide de référence

25 Chapitre 1. Mise en route rapide Grâce à la suite IBM Tivoli Workload Scheduler, vous pouvez gérer l environnement de production et automatiser plusieurs activités de surveillance. IBM Tivoli Workload Scheduler prépare les travaux à exécuter, résout les interdépendances, lance et suit le déroulement de chaque travail. Dans la mesure où les travaux sont exécutés immédiatement après résolution des dépendances, le délai d inactivité est réduit tandis que la productivité est largement optimisée. Les travaux ne sont jamais désordonnés. Si un travail échoue, IBM Tivoli Workload Scheduler assure le traitement de reprise en sollicitant peu (voire pas du tout) l aide de l opérateur. Si vous souhaitez connaître les informations et les procédures de base pour implémenter IBM Tivoli Workload Scheduler dans votre environnement via l interface de ligne de commande, voir «Création d un plan», à la page 2. Sinon, vous pouvez utiliser le produit Job Scheduling Console pour réaliser les mêmes tâches. Pour plus d informations, voir Job Scheduling Console - Guide d utilisation. Dans IBM Tivoli Workload Scheduler, la planification de travaux implique deux concepts de base : Base de données Résidant sur le gestionnaire de domaine maître, elle renferme toutes les définitions des objets de planification (travaux, flux de travaux, ressources et postes de travail). Outre les statistiques d exécution des travaux et des flux de travaux, elle comprend également les identificateurs des utilisateurs qui ont créé un objet en indiquant si ledit objet a été dernièrement modifié. Pour gérer ses objets, la base de données utilise le programme Composer. Pour plus d informations, voir Chapitre 3, «Référence au programme Composer», à la page 35. Plan Il contient toutes les activités de planification des travaux prévues sur une période correspondant à une journée. Dans IBM Tivoli Workload Scheduler, le plan est créé sur le gestionnaire de domaine maître toutes les 24 heures. Il regroupe tous les travaux, flux de travaux et objets de dépendance dont l exécution est prévue pour le jour même. A l'issue de la journée de production, tous les flux de travaux dont le traitement s est mal déroulé, qui sont en cours ou en attente d exécution peuvent être reportés dans le plan du lendemain. Pour savoir comment le gestionnaire de domaine maître génère le plan, voir Chapitre 2, «Cycle de production», à la page 9. Appelé conman, le programme interagit avec le plan durant la journée de traitement. Pour plus d informations, voir Chapitre 5, «Référence au programme Conman», à la page 129. Dès que vous avez installé l environnement de planification conformément aux instructions du document IBM Tivoli Workload Scheduler - Guide de planification et d installation, vous pouvez créer un plan qui s exécutera tous les jours en exploitant les informations requises liées à votre environnement. Pour plus d informations, voir «Création d un plan», à la page 2. Copyright IBM Corp. 1999,

26 Création d un plan Pour créer un plan qui s exécutera tous les jours, procédez comme suit : Connexion à un shell du gestionnaire de domaine maître Connectez-vous en utilisant l ID utilisateur que vous avez communiqué au stade de l installation, puis exécutez la procédure suivante dans un shell. Démarrage des processus IBM Tivoli Workload Scheduler Depuis une ligne de commande, exécutez la commande Startup pour démarrer le processus de gestion réseau du planificateur. Pour plus d informations sur la commande Startup, voir «StartUp», à la page 276. Ajout des définitions dans la base de données pour décrire la topologie de l environnement de planification Nous pouvons diviser cette étape en plusieurs points : a. b. Définition des postes de travail dans votre environnement Généralement, un poste de travail correspond à un poste de travail physique sur lequel les travaux et les flux de travaux sont exécutés. Dans le cas des agents étendus, les postes de travail représentent toutefois les définitions logiques hébergées par un poste de travail physique. Définissez un poste de travail sur chaque machine appartenant à votre environnement de planification, à l exception du gestionnaire de domaine maître, qui est automatiquement défini pendant l installation du produit IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Définitions de poste de travail», à la page 37. Définition des domaines Exécutez cette tâche uniquement si vous souhaitez créer une arborescence hiérarchique du chemin entre les domaines. IBM Tivoli Workload Scheduler parcourt l arborescence, en aval pour distribuer le plan au début de la journée de production et en amont pour transmettre les informations au gestionnaire de domaine maître concernant les travaux et les flux de travaux exécutés sur les postes de travail cible. Pour plus d informations, voir «Définitions de domaine», à la page 45. Définition des utilisateurs autorisés à exécuter les travaux sur les postes de travail Windows Sur les postes de travail Windows uniquement, définissez tous les utilisateurs autorisés à exécuter les travaux via IBM Tivoli Workload Scheduler, en précisant leur nom d utilisateur et leur mot de passe. Pour plus d informations, voir «Définitions d utilisateur», à la page IBM Tivoli Workload Scheduler - Guide de référence

27 5. Définition des dépendances Les dépendances représentent des conditions qui doivent être remplies avant tout démarrage d un travail. Elles peuvent être définies pour le compte du flux de travaux proprement dit ou du travail d un flux de travaux (voire les deux). Un travail ou un flux de travaux ne peut pas comprendre plus de 40 dépendances. Pour plus d informations, voir Chapitre 4, «Langage de planification», à la page 91. Vous pouvez définir certaines dépendances : a. b. c. d. Dépendance horaire Définissez une dépendance horaire pour préciser la première ou la dernière heure à laquelle un travail ou un flux de travaux peut être lancé ou l heure à laquelle un travail ou un flux de travaux doit prendre fin. En outre, vous pouvez déterminer les jours pendant lesquels le flux de travaux ne doit pas être exécuté. Pour plus d informations, voir «Mots clés», à la page 92. Dépendance d ouverture de fichiers Définissez les dépendances d ouverture de fichiers pour répertorier les fichiers qui doivent être disponibles avant le lancement d un travail ou d un flux de travaux. Pour plus d informations, voir «opens», à la page 121. Dépendance de suivi Définissez une dépendance de suivi pour définir les autres travaux et flux de travaux qui doivent aboutir avant le lancement d un travail ou d un flux de travaux. Pour plus d informations, voir «follows», à la page 105. Ressource Définissez les ressources pour préciser les objets physiques ou logiques appartenant à un poste de travail et qui sont requis pour exécuter un travail sur le poste de travail en question. Comme le programme vérifie la disponibilité des ressources avant d exécuter les travaux sur un poste de travail spécifique, les ressources peuvent être utilisées sous la forme de dépendances pour gérer plus facilement les travaux et les flux de travaux. Par exemple, vous pouvez définir une ressource BANDES sur la valeur 2, en identifiant les deux unités de bande système, et définir deux travaux qui requièrent la disponibilité des deux unités de bande sous la forme d une dépendance. Les travaux comportant cette dépendance ne peuvent pas être exécutés simultanément, car la ressource BANDES est utilisée chaque fois qu un travail est exécuté. Pour plus d informations, voir «Définitions de ressource», à la page 62. Chapitre 1. Mise en route rapide 3

28 e. f. g. Invites Utilisez une invite si vous souhaitez associer un nom unique à un message textuel demandant une réponse de la part de l opérateur. Les invites servent de dépendances pour empêcher le lancement des travaux tant que le programme n aura pas reçu de réponse affirmative. Pour plus d informations, voir «Définitions d invite», à la page 60. Limite Définissez une limite permettant de préciser le nombre de travaux pouvant être exécutés simultanément dans un flux de travaux. Pour plus d informations, voir «limit», à la page 116. Priorité Utilisez cette dépendance pour définir la priorité d un travail ou d un flux de travaux. Pour plus d informations, voir «priority», à la page 123. Définition des travaux Un travail est une unité de travail qui s exécute sur les postes de travail, notamment un fichier exécutable, un programme ou une commande planifié(e) et lancé(e) par IBM Tivoli Workload Scheduler dans le cadre du traitement d un flux de travaux. Généralement, il comprend tous les programmes, liens, fichiers et instructions nécessaires au système d exploitation. Par contre, il ne comprend pas les dates et heures d exécution planifiées car tous ces paramètres sont définis sous la forme d arguments dans la définition des flux de travaux. Pour plus d informations, voir «Définitions de travail», à la page 47. Définition des flux de travaux Un flux de travaux constitue une séquence ordonnée de travaux à exécuter selon les dépendances établies. Les travaux peuvent être regroupés dans un flux de travaux parce qu ils sont tous exécutés le même jour ou partagent une fonction ou plusieurs dépendances communes. Pour plus d informations, voir Chapitre 4, «Langage de planification», à la page 91. Définition des calendriers Un calendrier permet de définir si un flux de travaux doit être exécuté et à quel moment. Par exemple, vous pouvez inclure ou exclure les jours de votre choix dans un cycle d exécution quotidien. Vous pouvez même affecter une définition de calendrier à un ou plusieurs flux de travaux. Pour plus d informations, voir «Définitions de calendrier», à la page IBM Tivoli Workload Scheduler - Guide de référence

29 Définition des paramètres représentant des variables dans des travaux ou des flux de travaux Par définition de paramètre, on recouvre la correspondance entre un nom et une valeur - celle d une variable utilisée dans un travail ou un flux de travaux d un argument spécifique. Les noms de paramètre sont remplacés par leurs valeurs correspondantes dans les définitions de travail ou de flux de travaux à l issue de la journée de traitement lorsque le plan de production est créé pour la journée de traitement suivante. Pour plus d informations, voir «Définitions de paramètre», à la page 58. Automatisation de la génération du plan à l issue de la journée de production courante Ajoutez le flux de travaux final à la base de données pour réaliser un traitement de préproduction et de postproduction, qui garantira l automatisation complète de la génération du plan à l issue de chaque journée de production courante. Pour plus d informations, voir «Automatisation du cycle de production», à la page 15. Génération du plan Exécutez la commande Jnextday pour générer le plan. Elle permet de lancer le traitement des informations de planification stockées dans la base de données et de créer le plan de la journée de production suivante. Si vous avez automatisé la génération du plan (voir étape 10), vous devez seulement exécuter la commande Jnextday la première fois. Le plan est stocké dans le fichier Symphony, qui est distribué par le gestionnaire de domaine maître par l intermédiaire des domaines enfant à l heure de début de journée (06:00, par défaut). Une fois la nouvelle journée de production débutée, toutes les modifications que vous apportez aux objets de la base de données n affectent pas le traitement de la journée de production courante, à l exception des travaux et des flux de travaux soumis via la commande conman sbj ou conman sbs. Pour plus d informations, voir Chapitre 2, «Cycle de production», à la page 9. Maintenant que vous avez exécuté cette procédure pas à pas, votre environnement de planification est prêt à fonctionner. Il traite par lots une séquence ordonnée de travaux et de flux de travaux, par rapport aux ressources définies sur un groupe de postes de travail. Par défaut, le nombre de travaux pouvant être exécutés simultanément sur un poste de travail est nul la première fois que vous exécutez la commande Jnextday. Par conséquent, vous devez augmenter la valeur en modifiant la limite du nombre de postes de travail pour autoriser l exécution des travaux sur le poste de travail (voir «limit cpu», à la page 175). Ce traitement par lots fonctionne sur un cycle de 24 heures et est généré une nouvelle fois à l issue de chaque journée de production par le gestionnaire de domaine maître. Chapitre 1. Mise en route rapide 5

30 Gestion des travaux et des flux de travaux Si vous souhaitez apporter quelques modifications au cours de la journée, utilisez le programme conman alors que le plan de la journée de production est déjà en cours de traitement. Vous pouvez définir ou modifier un travail avant de l ajouter au plan via la commande conman sbj uniquement si le travail est exécuté sur un poste de travail qui a déjà reçu le plan. Pour plus d informations sur le programme conman, voir Chapitre 5, «Référence au programme Conman», à la page 129. La liste suivante détaille les tâches que vous pouvez réaliser via la commande conman : Ajout ou suppression de dépendances Cette option permet d ajouter ou de supprimer des dépendances à un flux de travaux ou au travail d un flux de travaux. Pour savoir comment ajouter ou supprimer des dépendances, voir «Traitement des commandes Conman», à la page 150 et «deldep job», à la page 165. Modification de la limite Cette option permet de modifier le nombre limite de travaux pouvant être exécutés simultanément sur un poste de travail ou le nombre de travaux limite d un flux de travaux. Pour plus d informations, voir «limit cpu», à la page 175. Modification de la priorité Cette option permet de modifier la priorité d un travail ou d un flux de travaux. Pour plus d informations, voir «altpri», à la page 156. Modification de la priorité limite La priorité limite peut être définie sur tous les postes de travail. Si vous la définissez sur un poste de travail, le programme interdit toute exécution des travaux dont la priorité est inférieure ou égale à la valeur limite définie sur le poste de travail en question. Pour plus d informations, voir «fence», à la page 171. Libération d un travail ou d un flux de travaux Cette option permet de libérer certaines ou l ensemble des dépendances dans un travail ou un flux de travaux. Pour plus d informations, voir «release job», à la page 183. Annulation d un travail ou d un flux de travaux Cette option permet d annuler un travail ou un flux de travaux immédiatement ou après résolution de ses dépendances. Pour plus d informations, voir «cancel job», à la page 157. Interruption ou renouvellement de l exécution d un travail Cette option permet d interrompre l exécution d un travail via la commande kill. Pour plus d informations, voir «kill», à la page 174. Exécutez la commande rerun job pour réexécuter le travail. Pour plus d informations, voir «rerun», à la page 188. Remarque : Si vous réexécutez un travail, le programme le place dans le même flux de travaux que le travail initial et hérite de ses dépendances. Création ou suppression d une liaison vers les postes de travail de votre environnement de planification Cette option permet de connecter ou de déconnecter un poste de travail du réseau de planification. Comme IBM Tivoli Workload Scheduler utilise une technologie de stockage et de réacheminement pour gérer la cohérence et la tolérance aux pannes des systèmes sur le réseau, tous les messages sont consignés dans le fichier de messages avant d être envoyés en une seule 6 IBM Tivoli Workload Scheduler - Guide de référence

31 fois, dès que la liaison est rétablie, lorsque vous supprimez la liaison d un poste de travail. Cette commande n affecte pas les autres processus en cours d exécution sur le système. Pour savoir comment créer ou supprimer une liaison vers les postes de travail, voir «link», à la page 177 et «unlink», à la page 233. Arrêt, démarrage ou interruption des processus IBM Tivoli Workload Scheduler Cette option permet d agir sur les processus de production (notamment les processus IBM Tivoli Workload Scheduler), à l exception des processus de gestion réseau. La commande shutdown permet d arrêter tous les processus IBM Tivoli Workload Scheduler, y compris le processus de gestion réseau. Pour plus d informations, voir «stop», à la page 219, «start», à la page 216 et «shutdown», à la page 215. Soumission d une commande Cette option permet de soumettre une commande sur un poste de travail en tant que travail du planificateur. Si vous ne la précisez pas dans les options de soumission, le programme utilise respectivement une chaîne commençant par le nom de la commande et la chaîne JOBS comme nom du travail et du flux de travaux. En outre, le programme consigne dans la base de données tous les événements qui signalent le résultat de l exécution. Pour plus d informations, voir «submit docommand», à la page 222. Soumission d un travail Cette option permet de soumettre une commande, qui exécute dans un flux de travaux un travail défini dans la base de données au cours de la journée de production courante sur un poste de travail qui a préalablement reçu le plan. Si vous ne la précisez pas dans les options de soumission, le programme utilise la chaîne JOBS comme nom du flux de travaux. Cette commande peut seulement être exécutée sur le gestionnaire de domaine maître. En outre, le programme consigne dans la base de données tous les événements qui signalent le résultat de l exécution. Pour plus d informations, voir «submit job», à la page 226. Soumission d un flux de travaux Cette option permet de soumettre une commande, qui exécute un flux de travaux défini dans la base de données au cours de la journée de production courante sur un poste de travail qui a préalablement reçu le plan. Cette commande peut seulement être exécutée sur le gestionnaire de domaine maître. En outre, le programme consigne dans la base de données tous les événements qui signalent le résultat de l exécution. Pour plus d informations, voir «submit sched», à la page 228. Soumission d un fichier Cette option permet de soumettre un fichier script, qui sera exécuté en guise de travail dans un flux de travaux au cours de la journée de production courante sur un poste de travail qui a préalablement reçu le plan. Si vous ne la précisez pas dans les options de soumission, le programme utilise respectivement le nom de fichier et la chaîne JOBS comme nom du travail et du flux de travaux. En outre, le programme consigne dans la base de données tous les événements qui signalent le résultat de l exécution. Pour plus d informations, voir «submit file», à la page 224. Chapitre 1. Mise en route rapide 7

32 8 IBM Tivoli Workload Scheduler - Guide de référence

33 Chapitre 2. Cycle de production Le plan représente un pense-bête, qui rappelle à IBM Tivoli Workload Scheduler les travaux à exécuter et les dépendances qui doivent être résolues avant le lancement de chaque travail. Il couvre 24 heures. La période englobée par le plan est appelée jour ou journée de production. Le plan débute à l heure définie par l option globale start, qui est définie sur 06:00 par défaut. Le programme crée un nouveau plan au début de la journée de production et le place dans un fichier de contrôle de production baptisé Symphony. Une fois le plan créé, le programme transmet une copie de ce plan à tous les postes de travail secondaires. Les gestionnaires de domaine secondaires distribuent leur copie à tous les agents FTA de leur domaine et à tous les gestionnaires de domaine secondaires. Grâce à cela, les agents FTA du réseau peuvent continuer à traiter leurs opérations, même si la connexion réseau vers leur gestionnaire de domaine est inactive. Sur chaque agent FTA cible, les processus IBM Tivoli Workload Scheduler ouvrent la copie et lisent les instructions du fichier Symphony pour connaître les travaux à exécuter et passer des appels au système d exploitation, afin de lancer les travaux au moment opportun. Le système d exploitation exécute le travail et indique à IBM Tivoli Workload Scheduler, en retour, si le travail s est bien déroulé. Il stocke ensuite les informations dans le fichier Symphony pour refléter le statut du travail. Ainsi, le programme met continuellement à jour le statut des travaux dans le fichier Symphony (travaux à exécuter, en cours et terminés). Si son statut n est pas intégral, l agent FTA surveille uniquement le traitement de ses propres travaux. Dans le cas contraire, il surveille également les événements survenant dans son domaine et dans ses domaines enfant. Chaque agent FTA reçoit le même fichier Symphony et met à jour les sections du fichier Symphony qui le concernent, tandis que le gestionnaire de domaine maître (et sa sauvegarde) possède une copie du fichier Symphony comprenant toutes les mises à jour. Pour entamer une nouvelle journée, le programme configure le processus de préproduction du jour suivant, sans oublier de journaliser et de signaler le processus de postproduction du jour qui vient de s écouler. Le présent chapitre décrit les procédures et les commandes que vous utilisez pour effectuer ces tâches. Interfaces et processus principaux du produit La présente section décrit les interfaces et processus principaux utilisés par le produit IBM Tivoli Workload Scheduler. Copyright IBM Corp. 1999,

34 Interfaces utilisateur Pour exécuter IBM Tivoli Workload Scheduler, nous vous proposons une riche combinaison de programmes utilisant des interfaces de ligne de commande ou des interfaces graphiques. L interface de ligne de commande (CLI) est proposée par certaines fonctions avancées, qui ne sont pas disponibles dans l interface graphique (Job Scheduling Console). La liste suivante présente les interfaces utilisateur disponibles : Composer Ce programme de ligne de commande permet de définir des objets de planification et de composer des agendas. Conman Ce programme de ligne de commande permet de surveiller et de contrôler l environnement de production IBM Tivoli Workload Scheduler. Job Scheduling Console Cette interface graphique interactive permet de créer, de modifier et de supprimer les objets de la base de données et du plan. Commandes de préproduction et de postproduction Les commandes suivantes permettent de configurer la journée de traitement IBM Tivoli Workload Scheduler. Pour automatiser le processus, le programme place généralement les commandes dans un agenda qui est lancé quotidiennement, au début de la journée. schedulr Cette commande permet de sélectionner les agendas à exécuter. compiler Cette commande permet de compiler le fichier de contrôle de production. stageman Cette commande permet de reporter les agendas non terminés et d installer le fichier de contrôle de production. logman Cette commande permet de journaliser les statistiques des travaux. Commandes de sécurité Les commandes suivantes permettent de définir et de gérer les privilèges utilisateur : dumpsec Cette commande permet de créer une copie modifiable du fichier de sécurité. makesec Cette commande permet de compiler et d installer le fichier de sécurité. 10 IBM Tivoli Workload Scheduler - Guide de référence

35 Processus de production La liste suivante présente les processus de production IBM Tivoli Workload Scheduler : Netman Ce processus reçoit les demandes de service et appelle les programmes appropriés. Mailman Ce processus achemine les messages vers les postes de travail locaux ou distants. batchman Ce processus dialogue directement avec le plan et le met à jour. Jobman (sur Windows et UNIX), Jobmon (sur Windows), joblnch.exe (sur Windows) Ces processus contrôlent l exécution des travaux. Ils sont chargés de lancer et de suivre les travaux en utilisant les scripts jobmanrc et.jobmanrc. Pour plus d informations sur ces scripts, voir «Lancement des travaux», à la page 18. Writer Généré par Netman, ce processus établit la liaison entre les postes de travail du réseau IBM Tivoli Workload Scheduler. Arborescence des processus sur les plateformes UNIX La figure 1 illustre l arborescence des processus IBM Tivoli Workload Scheduler sur les plateformes UNIX : Chapitre 2. Cycle de production 11

36 Figure 1. Arborescence des processus sur UNIX 12 IBM Tivoli Workload Scheduler - Guide de référence

37 Arborescence des processus sur les plateformes Windows La figure 2 illustre l arborescence des processus IBM Tivoli Workload Scheduler sur les plateformes Windows : Chapitre 2. Cycle de production 13

38 Figure 2. Arborescence des processus sur Windows 14 IBM Tivoli Workload Scheduler - Guide de référence

39 Automatisation du cycle de production Vous pouvez automatiser les processus de préproduction et de postproduction en ajoutant à la base de données le flux de travaux final fourni avec le produit, ou un flux de travaux équivalent fourni par l utilisateur. Pour plus d informations, localisez la copie du flux de travaux fourni dans le fichier Sfinal du répertoire racine_tws/sfinal. Une copie du script de travail se trouve dans le répertoire racine_tws/jnextday. Il peut être utile d imprimer des copies pour une meilleure compréhension du processus de renouvellement. Le programme place le flux de travaux final en production tous les jours, ce qui se matérialise par l exécution d un travail appelé Jnextday avant le début de la nouvelle journée. Ce travail effectue les opérations suivantes : 1. Il exécute la commande schedulr pour sélectionner les flux de travaux du plan de production de la nouvelle journée. Pour plus d informations, voir «Commande schedulr», à la page Il exécute la commande compiler pour compiler le plan de production. Pour plus d informations, voir «Commande compiler», à la page Il exécute la commande reptr pour imprimer les états de préproduction. Pour plus d informations, voir «Commande reptr», à la page Il arrête le planificateur. 5. Il exécute la commande stageman pour reporter les flux de travaux non terminés, journaliser l ancien plan de production et installer le nouveau plan. Pour plus d informations, voir «Commande stageman», à la page Il exécute la commande wmaeutil pour arrêter toutes les instances de connecteur et les réexécute pour régénérer le fichier Symphony. Pour plus d informations, voir «Commande wmaeutil», à la page Il démarre le planificateur pour la nouvelle journée. 8. Il exécute la commande reptr pour imprimer les états de postproduction du jour précédent. Pour plus d informations, voir «Commande reptr», à la page Il exécute la commande logman pour consigner les statistiques des travaux du jour précédent. Pour plus d informations, voir «Commande logman», à la page 30. Personnalisation du flux de travaux final Avant d utiliser le flux de travaux final, vous pouvez le modifier pour l adapter à vos besoins ou créer un flux de travaux différent, que vous utiliserez à sa place. Si vous créez votre propre flux de travaux, appuyez-vous sur le modèle fourni avec le produit. Dans ce cas, prenez en considération les points suivants : v Si vous décidez de modifier la manière dont le processus stageman génère les noms de fichier journal, rappelez-vous que les commandes reptr et logman doivent utiliser les mêmes noms. v Si vous souhaitez imprimer les états de préproduction en avance, vous pouvez scinder le travail Jnextday en deux. Le premier travail exécutera les commandes schedulr, compiler et reptr. Quant au second travail, il arrêtera le planificateur, exécutera la commande run stageman et lancera le planificateur avant d exécuter les commandes reptr et logman. Le premier travail peut donc être programmé pour s exécuter à une heure quelconque avant la fin de la journée, tandis que le second est programmé pour s exécuter juste avant la fin de la journée. Chapitre 2. Cycle de production 15

40 Ajout du flux de travaux final Après avoir installé le gestionnaire de domaine maître, quelle que soit la méthode d installation utilisée, vous devez ajouter le flux de travaux final dans la base de données et exécuter le travail Jnextday. Le programme place le flux de travaux en production tous les jours, ce qui se matérialise par l exécution d un travail appelé Jnextday avant le début de la nouvelle journée. Le programme d installation crée sur le poste de travail un fichier Sfinal renfermant la définition du flux de travaux final. Vous pouvez utiliser le fichier Sfinal ou créer votre propre fichier, que vous pourrez personnaliser à votre guise. Pour plus d informations sur la personnalisation du flux de travaux final, voir IBM Tivoli Workload Scheduler Guide de planification et d installation. L exemple suivant illustre la configuration d un gestionnaire de domaine maître après installation : 1. Ouvrez une session en tant qu utilisateur TWS. 2. Exécutez le script tws_env pour installer ainsi l environnement IBM Tivoli Workload Scheduler : v Sous UNIX : sur un shell C, lancez source/racine_tws/tws_env.sh v Sous UNIX : sur un shell Korn, lancez source/racine_tws/tws_env.sh v Depuis une ligne de commande Windows : lancez \racine_tws\tws_env.cmd Où racine_tws représente le répertoire d installation Tivoli Workload Scheduler. 3. Exécutez la commande composer. 4. Ajoutez la définition du flux de travaux final à la base de données via la commande suivante : composer add Sfinal Si vous avez créé un nouveau fichier Sfinal plutôt que d utiliser celui qui est fourni avec le produit, remplacez Sfinal par le nom du nouveau fichier. Démarrage d un cycle de production Pour démarrer un cycle de production, procédez comme suit : 1. Ouvrez une session en tant qu utilisateur TWS sur le gestionnaire de domaine maître. 2. A l invite, exécutez le travail Jnextday via la commande suivante : Jnextday Le programme réalise le traitement de préproduction et lance les processus de production du planificateur. Remarque : Ne mettez pas à jour et ne compilez pas la base de données Tivoli Workload Scheduler tant que le travail Jnextday est en cours d exécution : vous risqueriez d endommager la base de données. 3. Lorsque le travail Jnextday est terminé, vérifiez le statut de l environnement IBM Tivoli Workload Scheduler : conman status Si l environnement IBM Tivoli Workload Scheduler a démarré correctement, le statut est Batchman=ACTIF. 16 IBM Tivoli Workload Scheduler - Guide de référence

41 4. Augmentez le nombre maximal de travaux de sorte que les travaux s exécutent. Par défaut, le nombre maximal de travaux est nul après installation. Cela signifie qu aucun travail ne sera exécuté ; vous pouvez donc augmenter ce nombre dès à présent. conman "limit;10" Gestion de l environnement de production La présente section explique comment modifier le début de journée IBM Tivoli Workload Scheduler et comment créer un plan pour traiter les opérations des jours passés ou à venir. Choix du début d une journée IBM Tivoli Workload Scheduler Trois options permettent de choisir le début de la journée de production : v Matin v Fin d après-midi v Minuit Voici quelques-unes des implications de la planification : Heure de début et dernière heure de début Les heures de début (mot clé at) sont toujours associées à l heure de début de la journée de production du planificateur. Vous devrez peut-être indiquer + 1 jour pour les flux de travaux qui s exécutent sur plusieurs jours de production. De même, vérifiez que la dernière heure de début (mot clé until) est postérieure à l heure de début courante. Mot clé on Les jours de production ne correspondent pas forcément aux jours calendaires. Si votre journée de production commence à 6 heures du matin (la valeur par défaut), 5 heures 59 correspondra à la dernière minute de la journée de production. Un flux de travaux défini pour s exécuter LE LUNDI (ON MONDAY) à 05:30 sera sélectionné le lundi et s exécutera le mardi à 05:30. Mot clé carryforward Si vous choisissez un début de journée proche de minuit pour respecter le jour calendaire, le nombre de flux de travaux reportés aura tendance à augmenter. Ceci risque de compliquer la gestion du centre de données. Echéance Le programme génère des notifications si les travaux et les flux de travaux ont atteint leur échéance mais n ont toujours pas démarré ou s ils n ont toujours pas terminé leur phase d exécution. Une échéance indique le temps nécessaire pour l achèvement d un travail ou d un flux de travaux. Modification du début de journée Le début de la journée IBM Tivoli Workload Scheduler correspond au moment où le flux de travaux final est exécuté et où les processus du planificateur sont arrêtés et redémarrés. Pour indiquer le début de journée pour le planificateur, procédez comme suit : 1. Modifiez l option start dans le fichier globalopts. Elle représente l heure de début de la journée de traitement au format 24 heures : hhmm ( ). Par défaut, l heure de début est 06:00. Chapitre 2. Cycle de production 17

42 2. Modifiez l heure de début (mot clé at) du flux de travaux final pour lancer son exécution une minute avant la fin de la journée. Création d un plan pour des dates passées ou à venir Vous pouvez créer un plan qui exécute un traitement normalement programmé pour une date passée ou à venir. Cette procédure recrée un jour de traitement spécifié. Vous pouvez utiliser cette procédure si vous avez perdu un jour de traitement en raison d une urgence. Utilisation 1. Supprimez toutes les liaisons et arrêtez tous les postes de travail de votre réseau planificateur. Tous les traitements au sein du réseau sont arrêtés. 2. Exécutez la commande schedulr en utilisant l option date pour créer un fichier prodsked : schedulr -date jjmmaaaa L option date vous permet de créer un plan basé sur un jour de traitement passé ou à venir. 3. Exécutez la commande compiler pour créer un fichier Symnew : compiler (-date jjmmaaaa) Vous pouvez associer l option date à la commande compiler pour désigner la date du jour même ou celle du jour que vous tentez de recréer. Cette option peut s avérer nécessaire si certains de vos flux de travaux contiennent des paramètres d entrée sensibles à la date. Le paramètre scheddate est décalé par rapport à la date précisée dans la commande compiler. 4. Lancez le gestionnaire de console pour arrêter les processus du planificateur : conman Si vous avez défini au moins un poste de travail en tant que behindfirewall dans IBM Tivoli Workload Scheduler version 8.2, vous devez entrer la commande suivante : conman stop ;progressive 5. Lancez stageman pour créer le nouveau fichier Symphony : stageman 6. Lancez le gestionnaire de console pour démarrer les processus du planificateur : conman start Lancement des travaux d états Les états vous aident dans la gestion du cycle de production. Pour plus d informations, voir Chapitre 7, «Présentation des commandes de génération d états», à la page 289 et «Commande reptr», à la page 296. Les travaux sont lancés sous la surveillance du processus de contrôle de production Batchman. Celui-ci résout toutes les dépendances de travail pour garantir le respect de l ordre d exécution, puis envoie un message de lancement de travail au processus Jobman. A son tour, Jobman génère un processus de surveillance des travaux qui définit un groupe de variables d environnement avant d exécuter le script de configuration standard (racine_tws/jobmanrc). Si l utilisateur est autorisé à utiliser un script de 18 IBM Tivoli Workload Scheduler - Guide de référence

43 configuration local et si le script $HOME/.jobmanrc existe, le script de configuration local est exécuté. Le travail est ensuite exécuté par le script de configuration standard ou local. Chacun des processus lancés par Jobman (scripts de configuration et travaux inclus) conserve le nom d utilisateur enregistré avec les données d ouverture de session du travail. Quant aux travaux soumis, ils conservent le nom de l utilisateur qui les a soumis. Pour exécuter les travaux sur l environnement de l utilisateur, ajoutez l environnement.profile de l utilisateur au script de configuration local. Variables d environnement des travaux Les variables du tableau suivant sont définies et exportées par le processus Jobman. Tableau 2. Variables d environnement des travaux Nom de la variable Valeur HOME Répertoire de noms de l utilisateur connecté LOGNAME Nom de l utilisateur connecté PATH Windows : %SYSTEMROOT\SYSTEM32. UNIX : /bin:/usr/bin TZ Fuseau horaire UNISON_SHELL Shell de connexion de l utilisateur UNISON_CPU Nom du poste de travail UNISON_HOST Nom du poste de travail maître/hôte UNISON_JOB Nom complet du travail : cpu#sched.job UNISON_JOBNUM Numéro du travail (ppid) UNISON_MASTER Nom du poste de travail maître UNISON_RUN Numéro d exécution du plan de production Tivoli Workload Scheduler courant UNISON_SCHED Nom de l agenda UNISON_SCHED_DATE Date de production Tivoli Workload Scheduler (aammjj) UNISON_SCHED_EPOCH Date de production Tivoli Workload Scheduler (exprimée au format époque) UNISON_SYM Numéro d enregistrement Symphony UNISON_EXEC_PATH Chemin complet du script jobmanrc TIVOLI_JOB_DATE Date planifiée d un travail Script de configuration standard - jobmanrc IBM Tivoli Workload Scheduler propose un modèle de script de configuration standard nommé racine_tws/config/jobmanrc. Il est installé automatiquement sous le nom racine_tws/jobmanrc. L administrateur système peut utiliser ce script pour établir l environnement de son choix avant l exécution de chaque travail. Si vous souhaitez modifier le script, faites-le uniquement dans la copie de travail (racine_tws/jobmanrc), sans manipuler le fichier modèle. Le fichier contient des variables que vous pouvez configurer et quelques commentaires qui vous aident à assimiler la méthodologie. Pour découvrir les variables jobmanrc, voir tableau 3. Chapitre 2. Cycle de production 19

44 Tableau 3. Variables jobmanrc Nom de la variable Valeur UNISON_JCL Nom du chemin d accès au fichier script du travail UNISON_STDLIST Nom du chemin d accès au fichier liste standard du travail UNISON_EXIT Si la variable est définie sur yes, le programme termine immédiatement le travail dès qu une commande renvoie un code de sortie non nul (variable configurable). Si elle est définie sur no, le programme continue l exécution du travail même si une commande renvoie un code de sortie non nul. Les autres valeurs sont interprétées comme étant définies sur no. LOCAL_RC_OK Si la variable est définie sur yes, le programme exécute le script de configuration local éventuel de l utilisateur et transmet $UNISON_JCL en guide de premier argument (variable configurable). Dans certains cas, l utilisateur peut ne pas être autorisé à utiliser cette option. Pour plus d informations, voir «Script de configuration local - $HOME/.jobmanrc», à la page 21. Si la variable est définie sur no, le programme ignore l existence d un script de configuration local et exécute $UNISON_JCL. Les autres valeurs sont interprétées comme étant définies sur no. MAIL_ON_ABEND Si la variable est définie sur yes, le programme envoie un message à la boîte aux lettres de l utilisateur connecté dès que le travail se termine avec un code de sortie non nul (variable configurable). Vous pouvez également définir la variable sur un ou plusieurs noms d utilisateur (préalablement séparés par des espaces), auquel cas le programme envoie un message à chacun d entre eux. Par exemple, vous pouvez taper root mis sam mary. Si la variable est définie sur no, le programme n envoie aucun message en cas de fin anormale du travail. Les messages d arrêt anormal utilisent le format suivant : cpu#sched.job fichier_jcl failed with code_sortie Please review nom_fichier_liste_standard 20 IBM Tivoli Workload Scheduler - Guide de référence

45 Tableau 3. Variables jobmanrc (suite) Nom de la variable Valeur SHELL_TYPE Si la variable est définie sur standard, le programme lit la première ligne du fichier JCL pour déterminer le shell qui sera utilisé pour exécuter le travail (variable configurable). Si la première ligne ne commence pas par le symbole #!, le programme utilise le répertoire /bin/sh pour exécuter le script de configuration local ou $UNISON_JCL. Les commandes sont répercutées sur le fichier liste standard du travail. Si la variable est définie sur user, le shell de connexion de l utilisateur ($UNISON_SHELL) exécute le script de configuration local ou $UNISON_JCL. Les commandes sont répercutées sur le fichier liste standard du travail. Si la variable est définie sur script, le programme exécute directement le script de configuration local ou $UNISON_JCL, sans répercuter les commandes, sauf si le script de configuration local ou $UNISON_JCL contient une commande set -x. Les autres valeurs sont interprétées comme étant définies sur standard. USE_EXEC Si la variable est définie sur yes, le programme exécute le travail ou le script de configuration local de l utilisateur via la commande exec - éliminant ainsi les processus supplémentaires (variable configurable). Cette option est remplacée si MAIL_ON_ABEND est également défini sur yes. Les autres valeurs sont interprétées comme étant définies sur no, auquel cas le travail ou le script de configuration local est exécuté par un autre processus du shell. Script de configuration local - $HOME/.jobmanrc Grâce au script de configuration local, vous pouvez établir l environnement de votre choix pour l exécution de vos propres travaux. Le programme exécute le script uniquement dans les situations suivantes : 1. Le script de configuration standard jobmanrc doit être installé et la variable d environnement LOCAL_RC_OK doit être définie sur yes (voir tableau 3). 2. Si le fichier racine_tws/localrc.allow existe, le nom d utilisateur doit apparaître dans le fichier. S il n existe pas, le nom d utilisateur n apparaîtra pas dans le fichier racine_tws/localrc.deny. Si aucun des fichiers n existe, l utilisateur est autorisé à utiliser un script de configuration local. 3. Le script de configuration local doit être installé dans le répertoire principal de l utilisateur (HOME/.jobmanrc) et doit disposer de droits en exécution. Chapitre 2. Cycle de production 21

46 Si vous envisagez d utiliser un script de configuration local, celui-ci doit au minimum exécuter le fichier script du travail ($UNISON_JCL). Le script de configuration standard jobmanrc fourni par Tivoli exécute votre script de configuration local comme suit : $EXECIT $USE_SHELL $HOME/.jobmanrc "$UNISON_JCL" $IS_COMMAND Le paramètre USE_SHELL est défini sur la valeur de la variable jobmanrc SHELL_TYPE (voir tableau 3, à la page 20). Quant au paramètre IS_COMMAND, il est défini sur yes si le travail a été planifié ou soumis via la structure docommand. Le paramètre EXECIT est défini sur exec si la variable USE_EXEC a pour valeur yes (voir tableau 3, à la page 20). Sinon, il est nul. Dans l exemple suivant, nous expliquons comment exécuter le fichier script d un travail ou une commande dans votre script de configuration local : #!/bin/ksh PATH=racine_TWS:racine_TWS/bin:$PATH export PATH /bin/sh -c "$UNISON_JCL" Dans l exemple suivant, le fichier.jobmanrc réalise le traitement selon le code de sortie du travail de l utilisateur : #!/bin/sh # PATH=racine_TWS:racine_TWS/bin:$PATH export PATH /bin/sh -c "$UNISON_JCL" #Ou utilisez eval "$UNISON_JCL" (guillemets obligatoires) RETVAL=$? if [ $RETVAL -eq 1 ] then echo "Code de sortie 1 : Erreur non bloquante" exit 0 elif [ $RETVAL -gt 1 -a $RETVAL -lt 100 ] then conman "tellop : Erreur de base de données. Contacter l administrateur de la base de données" elif [ $RETVAL -ge 100 ] then conman "Abandon du travail tellop. Contactez l administrateur" fi Commandes de traitement de production Les sections suivantes décrivent les commandes de traitement des processus de préproduction et de postproduction exécutées par le travail Jnextday. 22 IBM Tivoli Workload Scheduler - Guide de référence

47 Commande schedulr La commande schedulr sélectionne des flux de travaux pour une date spécifique dans le fichier de base de données mastsked et les copie dans un nouveau fichier de plan de production nommé prodsked. Vous devez avoir un droit d accès build aux fichiers de base de données du planificateur. Syntaxe schedulr -v -u schedulr [-date date -autodate] [-scheds {fichier-entrée -}] [ -prodsked {fichier-sortie -}] Arguments -u Permet d afficher des informations sur l utilisation de la commande et de quitter. -v Permet d afficher la version de la commande et de quitter. -date Sélectionne des flux de travaux pour une date spécifique. La date est entrée sous la forme mm/jj/[aa]aa. -autodate Sélectionne des flux de travaux pour la date système courante. -scheds Sélectionne, en plus de ceux sélectionnés le cas échéant par -date ou -autodate, les flux de travaux nommés dans fichier-entrée. Les noms des flux de travaux doivent apparaître dans ce fichier sous la forme [poste_travail#]flux_travaux, avec un nom par ligne. Si un tiret est entré à la place d un nom de fichier, schedulr requiert les noms de flux de travaux à stdin. -prodsked Dirige la sortie schedulr vers le fichier-sortie. Si un tiret est entré à la place d un nom de fichier, la sortie est dirigée vers stdout. Si l argument est omis, la sortie est écrite dans un fichier nommé prodsked. Description Si -autodate et -date sont omis, schedulr requiert une date. Si vous répondez à l invite en appuyant sur la touche Retour, les flux de travaux sont sélectionnés uniquement dans le fichier-entrée. Exemples Sélectionnez les flux de travaux pour la date du jour, ainsi que les flux de travaux nommés dans le fichier myskeds : schedulr -autodate -scheds myskeds Sélectionnez les flux de travaux pour la date du 15 février 2001 et ne demandez pas de flux de travaux supplémentaires. Ecrivez la sortie dans le fichier myprodsked : schedulr -date 2/15/01 -prodsked myprodsked Sélectionnez les flux de travaux pour la date du 15 février 2001 et demandez des flux de travaux supplémentaires : schedulr -date 2/15/2001 -scheds - Chapitre 2. Cycle de production 23

48 Demandez la date de production et des flux de travaux supplémentaires (remarque : agenda est synonyme de flux de travaux ) : schedulr Enter schedule date: 4/14/01 Enter a list of extra schedules Schedule name: site1#sked2 Schedule name: <Return> <liste des flux de travaux sélectionnés> End of Program 24 IBM Tivoli Workload Scheduler - Guide de référence

49 Commande compiler La commande compiler compile le fichier du plan de production et crée un plan de production intermédiaire. Syntaxe compiler -v -u compiler [-date date] [-input fichier-entrée] [-output fichier-sortie] Arguments -u Permet d afficher des informations sur l utilisation de la commande et de quitter. -v Permet d afficher la version de la commande et de quitter. -date Date de production devant être enregistrée dans le fichier du plan de production intermédiaire. La date est entrée sous la forme mm/jj/[aa]aa. -input Nom du fichier contenant le plan de production. Si cette option est omise, le nom par défaut est prodsked. -output Dirige la sortie compiler vers le fichier-sortie. Si l argument est omis, la sortie est écrite dans un fichier nommé Symnew. Description Si vous omettez l argument -date, la date affectée au fichier Symnew est la même que celle enregistrée dans le fichier du plan de production créé par schedulr. Si aucune date n est indiquée dans le fichier du plan de production, la date système courante est utilisée. La date indiquée dans Symnew est la date à laquelle le planificateur commencera à exécuter le plan de production. Vous pouvez entrer une date différente pour configurer le traitement pour une date passée ou à venir. Messages d absence d objets : Les messages suivants sont générés par compiler pour indiquer que des objets de planification sont manquants. Ces messages se trouvent normalement dans le fichier de liste standard du travail Jnextday. job Paramètre non défini dans "schedule" ; il ne sera pas remplacé. Un paramètre appelé dans un flux de travaux n existe pas dans la base de données du planificateur. Aucune substitution n est effectuée et la chaîne du paramètre est utilisée. AWSBIC102W... Le nom de travail est introuvable dans la base de données. Un travail fictif à l état FAIL a été ajouté. Un travail nommé dans un flux de travaux n existe pas dans la base de données du planificateur. Un travail fictif portant le même nom est placé dans le plan de production avec une priorité égale à zéro et avec l état FAIL. AWSBIC103W... Nom d invite introuvable. Nom d invite ajouté dans Symphony. Une invite nommée dans un flux de travaux n existe pas dans la base de données du planificateur. Une invite fictive contenant le texte suivant est utilisée à la place : Nom d invite introuvable dans la base de données. Il s agit de texte fictif. Voulez-vous poursuivre? (O/N). Chapitre 2. Cycle de production 25

50 AWSBIC104W... Nom de ressource introuvable pour nom de poste de travail dans la base de données. Ajout du nom de ressource avec 0 unité. Une ressource nommée dans un flux de travaux n existe pas dans la base de données du planificateur. Une ressource fictive avec zéro unité disponible est utilisée à la place : AWSBIC106W... Nom de poste de travail inexistant dans la base de données du poste de travail. L agenda est ignoré. Un flux de travaux est défini pour s exécuter sur un poste de travail qui n existe pas. Le flux de travaux est ignoré et n est pas placé dans le plan de production. Exemples Compilez prodsked dans Symnew : compiler Compilez prodsked dans Symnew et entrez le 15 mai 2002 comme date de production : compiler -date 5/15/02 Compilez le fichier mysked dans un fichier nommé mysym : compiler -input mysked -output mysym 26 IBM Tivoli Workload Scheduler - Guide de référence

51 Commande stageman La commande stageman reporte les flux de travaux non terminés, consigne l ancien plan de production et installe le nouveau. Le fichier du nouveau plan de production a pour nom Symphony. Une copie de Symphony, appelée Sinfonia, est également créée. Sinfonia est envoyé aux gestionnaires de domaine et aux agents dans le cadre du processus d initialisation de la nouvelle journée. Vous devez avoir un droit d accès build sur le fichier Symphony. Syntaxe stageman -v stageman [-carryforward {yes no all}] [-log fichier-journal - nolog] [symnew] Arguments -v Permet d afficher la version de la commande et de quitter. -carryforward Pour définir le type de report, procédez comme suit : no Aucun flux de travaux n est reporté. yes Seuls les flux de travaux non terminés activés pour le report sont reportés. all L activation du report dans les flux de travaux est ignorée ; tous les flux de travaux non terminés sont reportés. -log Consigne l ancien plan de production et affecte le nom de ce dernier au fichier journal. Pour plus d informations, voir «Nom des fichiers journaux», à la page 28. -nolog L ancien plan de production n est pas consigné. symnew Nom du fichier de plan de production intermédiaire créé par compiler. En cas d omission, le fichier Symnew est utilisé. Description Si vous omettez -carryforward, la valeur par défaut pour le report est déterminée par l option globale carryforward. Sur UNIX uniquement, le processus stageman détermine également les fichiers exécutables pouvant être supprimés pour les travaux soumis via les commandes at et batch. Il s agit de travaux qui n ont pas été reportés. Les fichiers sont effectivement supprimés lorsque le planificateur démarre au début d une nouvelle journée. Si les processus du planificateur sont toujours en cours d exécution et s ils accèdent au fichier Symphony, stageman affiche le message suivant : Impossible d obtenir l accès exclusif à Symphony. Arrêt de batchman et de mailman. Pour continuer, arrêtez le planificateur et réexécutez stageman. Si, pour quelque raison que ce soit, stageman se termine de façon anormale, vous devez réexécuter compiler et stageman. Chapitre 2. Cycle de production 27

52 Les utilisateurs qui accèdent au plan via l interface CLI alors que Symphony est en cours de remplacement reçoivent le message suivant : Le fichier Symphony est obsolète. Remplacement par un nouveau fichier Symphony. Agenda mm/jj/aa (nnnn) sur poste de travail, changement de Symphony. Certaines commandes utilisateur utilisées pendant le changement risquent de ne pas s exécuter correctement, car les travaux ou les flux de travaux cible n ont pas été reportés. Nom des fichiers journaux : Les fichiers de plan de production sont stockés dans le répertoire racine_tws /schedlog. La convention d appellation utilisée par stageman lorsque les arguments -log et -nolog sont omis, est la suivante : racine_tws/schedlog/maaaammjjhhtt Où aaaammjjhhtt désigne l année, le mois, le jour et l heure (minutes comprises) de création du fichier journal. Cette convention de dénomination est codée dans le script Jnextday fourni par Tivoli. Si vous le souhaitez, vous pouvez modifier la convention d appellation lorsque vous automatisez le cycle de production. Pour plus d informations, voir «Automatisation du cycle de production», à la page 15. Remarque : Veillez à contrôler l espace disque du répertoire schedlog et à supprimer les fichiers journaux obsolètes de façon régulière. Flux de travaux reportés : L option de report reste activée sur les flux de travaux ayant fait l objet d un report, de sorte qu ils peuvent être reportés une nouvelle fois. Si un flux de travaux en échec est reporté et s il continue à se terminer avec un état différent de SUCC, il peut être reporté indéfiniment, à moins qu il n expire dans le temps ou qu il ne soit annulé. Les flux de travaux reportés conservent leur date de production d origine en interne. Tout travail contenu dans ces flux de travaux qui utilise datecalc utilisera cette date de production avec le mot clé scheddate. Pour plus d informations, voir «datecalc», à la page 246 Pour que le report fonctionne correctement dans un réseau, le fichier du plan de production du gestionnaire de domaine maître, Symphony, doit être mis à jour avec le statut de flux de travaux le plus récent par ses agents et ses gestionnaires de domaine subordonnés. Pour ce faire, exécutez la commande suivante dans une invite de commande sur le gestionnaire de domaine maître avant d exécuter stageman : conman Nom des flux de travaux : Les flux de travaux qui sont reportés sont renommés comme suit : CFaadddnnxxxxxxxxx Où aa correspond aux deux derniers chiffres de l année, ddd à la date dans le calendrier julien, nn à une séquence de chiffres ou de lettres (00-99, AA-ZZ) et xxxxxxxxx est une chaîne alpha aléatoire. 28 IBM Tivoli Workload Scheduler - Guide de référence

53 Invites de report : Pour assurer la continuité lors du report des flux de travaux, stageman crée des invites spéciales dans le nouveau plan de production pour tenir compte des dépendances d aboutissement interrompues. Ces invites sont lancées après que le nouveau jour de traitement a commencé, lorsque le planificateur vérifie si le travail ou le flux de travaux est prêt pour le lancement ; les réponses ont la forme d invites standard. Voici un exemple d invite de report : INACT 12 (SYS1#CF9123AA) follows SYS1#SKED3 satisfied? Cette invite indique qu un flux de travaux du jour précédent a été reporté au titre de CF9123AA et qu il fait suite à un flux de travaux nommé sked3 qui n a pas été reporté. L état de l invite INACT dans le cas présent définit l état de la dépendance d aboutissement correspondante. Les différents états possibles sont les suivants : INACTIVE L invite n a pas été émise et la dépendance n est pas satisfaite. DEMANDEE L invite a été émise et attend une réponse. La dépendance n est pas satisfaite. NON Une réponse négative a été reçue, ou bien il a été constaté avant que le report ne s effectue que le flux de travaux sked3 ne s est pas achevé avec succès. La dépendance n est pas satisfaite. OUI Une réponse positive a été reçue, ou bien il a été constaté avant que le report ne s effectue que le flux de travaux sked3 s est achevé avec succès. La dépendance est satisfaite. Remarque : Le programme génère une invite si l agenda est reporté et s il possède une dépendance follows sur un autre agenda qui n a pas été reporté. En cas de dépendances interréseau, le programme génère une invite même si les deux agendas ont été reportés. En effet, aucun mécanisme ne permet de conserver la connexion des dépendances interréseau. En outre, le successeur n a aucun moyen de savoir si l agenda a été reporté et si la liaison de la dépendance a été perdue. Pour plus d informations, voir Chapitre 9, «Référence aux agents réseau», à la page 313. Exemples Procédez au report de tous les flux de travaux non terminés (quel que soit l état de l option Carry Forward), consignez l ancien fichier Symphony et créez le nouveau fichier Symphony : DATE= datecalc today pic AAAAMMJJHHTT stageman -carryforward all -log schedlog/m$date Procédez au report des flux de travaux non terminés conformément à l option globale carryforward, ne consignez pas l ancien fichier Symphony mais créez un nouveau fichier de contrôle de production nommé mysym : stageman -nolog mysym Chapitre 2. Cycle de production 29

54 Commande logman La commande logman consigne les statistiques de travaux depuis un fichier journal de plan de production. Syntaxe logman -v -u logman [-smooth pourcentage] [-minmax {elapsed cpu }] fichier-journal Arguments -u Permet d afficher des informations sur l utilisation de la commande et de quitter. -v Permet d afficher la version de la commande et de quitter. -smooth Un facteur de pondération est utilisé, qui favorise l exécution du travail le plus récent lors du calcul du temps d exécution normal (moyen) d un travail. Le résultat de ce calcul est exprimé sous la forme d un pourcentage. Par exemple, -smooth 40 applique un facteur de pondération de 40 % à l exécution du travail le plus récent, et de 60 % à la moyenne existante. La valeur par défaut est égale à zéro. -minmax Définit la façon dont sont consignés et rapportés les temps d exécution de travail minimal et maximal. elapsed Les temps d exécution minimal et maximal sont basés sur le temps écoulé. cpu Les temps d exécution minimal et maximal sont basés sur le temps du poste de travail. fichier-journal Nom du fichier de plan de production ou du fichier journal d où sont extraites les statistiques de travaux. Description Les travaux déjà consignés ne peuvent pas être consignés une nouvelle fois. Si vous tentez de le faire, le message d erreur 0 travaux consignés est généré. Temps écoulé et temps du poste de travail : L activité du système affecte de façon significative le temps écoulé, exprimé en minutes. Le temps écoulé inclut non seulement le temps qu a pris un travail lorsqu il a utilisé le poste de travail, mais aussi les intervalles de temps pendant lesquels il a dû attendre que d autres processus libèrent le poste de travail. Pendant les périodes d activité système élevée, par exemple, le temps écoulé pour un travail a pu être long alors que le temps du poste de travail n aura pas été plus long que dans les périodes d activité système basse. En revanche, le temps du poste de travail, exprimé en secondes, correspond au temps réel pendant lequel un travail a utilisé le poste de travail ; il n inclut pas les intervalles de temps pendant lesquels le travail a dû attendre. 30 IBM Tivoli Workload Scheduler - Guide de référence

55 Si vous exécutez logman avec l argument -minmax elapsed, les temps d exécution maximal et minimal et les dates sont basés uniquement sur le temps écoulé d un travail. Les valeurs sont mises à jour uniquement si le temps écoulé de l exécution de travail la plus récente est supérieur au maximum existant ou inférieur au minimum existant. Dans ce cas, les temps du poste de travail n indiqueront pas nécessairement leurs minima et leur maxima. Si vous exécutez logman avec l argument -minmax CPU, les temps d exécution maximal et minimal et les dates sont basés uniquement sur le temps du poste de travail d un travail. Les valeurs sont mises à jour uniquement si le temps du poste de travail de l exécution de travail la plus récente est supérieur au maximum existant ou inférieur au minimum existant. Dans ce cas, les temps écoulés n indiqueront pas nécessairement leurs minima et leur maxima. Si vous exécutez logman sans l argument -minmax, les valeurs de temps écoulé et de temps du poste de travail sont mises à jour indépendamment afin d indiquer leur maxima et leur minima, mais les dates d exécution correspondent uniquement aux valeurs de temps écoulé. Dans ce cas, aucun enregistrement des dates d exécution n est conservé pour les temps du poste de travail maximal et minimal. Exemples Consignez les statistiques de travaux à partir du fichier journal M : logman schedlog/m Consignez les statistiques de travaux à partir du fichier journal M$DATE en fonction du temps écoulé, en affectant aux exécutions de travail les plus récentes un facteur de pondération égal à 40 % lors du calcul des temps d exécution normaux (moyens) : logman -smooth 40 -minmax elapsed schedlog/m$date La variable $DATE contient l horodate utilisée par stageman pour créer le nom du fichier journal. Pour plus d informations, voir «Commande stageman», à la page 27. Chapitre 2. Cycle de production 31

56 Commande wmaeutil La commande wmaeutil permet d arrêter le serveur de connecteurs du plan, de la base de données et du moteur. La commande makesec ne s exécutera pas correctement sur les plateformes Windows tant que les connecteurs ne seront pas arrêtés. Remarque : Si vous recréez manuellement un fichier plan (sans utiliser le travail Jnextday), vous devrez arrêter les connecteurs via la commande wmaeutil et régénérer les vues dans l environnement Job Scheduling Console pour afficher le nouveau jour de production. Sinon, les vues dans Job Scheduling Console resteront sur la journée de production précédente. Syntaxe UNIX : wmaeutil.sh nom_instance [-stop DB PL EG * ] [-version DB PL EG * ] [-dbinfo DB PL] [-sethome] [-gethome] [ALL -stop] Windows : wmaeutil.cmd nom_instance [-stop DB PL EG * ] [-version DB PL EG * ] [-dbinfo DB PL] [-sethome] [-gethome] [ALL -stop] Arguments nom_instance Nom de l instance du planificateur. Il s agit du nom de l instance que vous avez indiqué lors de l installation du moteur du planificateur et du connecteur. -stop DB PL EG * Cette option permet d arrêter le serveur de connecteurs indiqué. Vous pouvez utiliser l astérisque (*) pour arrêter les trois serveurs de connecteurs. -version DB PL EG * Cette option permet d obtenir le numéro de version du serveur de connecteurs pour le plan, la base de données et le moteur installés sur le système. L astérisque (*) permet d obtenir les versions des trois serveurs de connecteurs immédiatement. -dbinfo DB PL Cette option permet de savoir si la base de données du planificateur et le plan auxquels ce connecteur est lié sont étendus ou non. Sous IBM Tivoli Workload Scheduler version 8.2, les bases de données et les plans sont toujours développés, mais cette option permet une compatibilité amont. -sethome Cette option permet de définir l attribut racine_tws des objets du planificateur (moteur, base de données et plan) dans la base de données des objets Tivoli. Cette valeur d attribut lie des connecteurs pour l instance d objet en question au produit de base du planificateur. Elle considère le nom complet du répertoire principal du planificateur comme un argument. De même, la chaîne de nom de chemin d accès doit être placée entre guillemets simples afin d éviter toute interprétation de shell. 32 IBM Tivoli Workload Scheduler - Guide de référence

57 -gethome Cette option ne requiert aucun argument et imprime la valeur de l attribut racine_tws pour les instances d objets du moteur, de la base de données et du plan comme défini dans la base de données d objets. ALL -stop Cette option arrête les serveurs de connecteurs pour toutes les instances de connecteurs connectées à l installation courante du planificateur, c est-à-dire qu elle arrête les serveurs de connecteurs pour toutes les instances dont l attribut racine_tws correspond au répertoire principal de l installation planificateur utilisée. Remarques Définition des variables d environnement : Pour exécuter correctement la commande wmaeutil, vous devez exécuter le fichier suivant en vue de définir l environnement de la structure. Windows : c: \> %SystemRoot%\system32\drivers\etc\Tivoli\setup_env.cmd UNIX : $. /etc/tivoli/setup_env.sh Vous pouvez mettre à jour votre profil UNIX pour lancer le fichier sans exécuter la commande manuellement. Remarques relatives à la commande makesec : La commande wmaeutil.sh doit être exécutée avant la commande makesec. La commande makesec ne s exécutera pas correctement sur les plateformes Windows tant que les connecteurs ne seront pas arrêtés. Vous devez également arrêter les connecteurs lorsque vous utilisez la commande makesec sur UNIX. Nom d instance IBM Tivoli Workload Scheduler : Si vous n êtes pas sûr du nom d instance entré à l installation, exécutez les étapes suivantes : 1. Localisez les variables d environnement Tivoli :. /etc/tivoli/setup_env.sh (pour UNIX) C:\winnt\system32\drivers\etc\Tivoli\setup_env.cmd (pour Windows) 2. Exécutez la commande wlookup pour obtenir le nom de l instance du planificateur : wlookup -ar MaestroEngine maestro #Maestro::Engine# où maestro2 est le nom de l instance du planificateur. Chapitre 2. Cycle de production 33

58 Exemples Arrêtez les connecteurs de la base de données, du plan et du moteur pour une instance appelée maestro : wmaeutil.sh maestro -stop ALL Arrêtez les connecteurs de la base de données pour une instance appelée tws : wmaeutil.sh tws -stop ALL DB Arrêtez les versions de connecteurs de la base de données, le plan et le moteur pour une instance appelée maestro2 : wmaeutil.sh maestro2 -version * 34 IBM Tivoli Workload Scheduler - Guide de référence

59 Chapitre 3. Référence au programme Composer Le programme de ligne de commande Composer permet de gérer les objets de planification dans la base de données IBM Tivoli Workload Scheduler. Les objets de planification sont des postes de travail, des classes de postes de travail, des domaines, des travaux, des flux de travaux, des ressources, des invites, des calendriers et des paramètres. Le présent chapitre détaille les points suivants : v Gestion des objets de planification v Programme de ligne de commande Composer v Description des commandes Gestion des objets de planification Gérés par le programme Composer, les objets de planification sont stockés dans la base de données du planificateur. Composer utilise des fichiers d édition pour mettre à jour la base de données de planification. Pour plus d informations sur le format du fichier d édition utilisé pour un objet spécifique, consultez la définition appropriée à la fin du présent chapitre. Si vous ajoutez un nouvel objet, vous devez par exemple noter sa définition dans un fichier d édition. Ensuite, vous pouvez utiliser le programme de ligne de commande Composer pour créer ou modifier l objet en complétant le fichier d édition qui renferme la définition, que Composer analyse pour vérifier la syntaxe. Si la syntaxe est parfaite, le programme ajoute la définition à la base de données. Selon le type des objets que vous souhaitez gérer via le programme de ligne de commande Composer, vous pouvez gérer certains objets individuellement dans la base de données ou parcourir la liste des objets du même type défini dans la base de données et modifier l entrée de la liste qui représente l objet en question. Vous pouvez accéder aux entrées de base de données relatives aux flux de travaux, aux travaux, aux utilisateurs, aux postes de travail, aux domaines et aux classes de postes de travail puis gérer ces entrées individuellement. Pour modifier une définition de travail existante, vous devez par exemple utiliser l option create du programme de ligne de commande Composer pour copier la définition du travail de la base de données dans un fichier d édition. Ensuite, vous devez modifier le fichier d édition et utiliser l option modify du programme de ligne de commande Composer pour modifier la définition du travail. Composer contrôle alors la syntaxe du fichier d édition et recopie la définition dans la base de données, en écrasant la définition existante si la syntaxe est parfaite. La gestion des entrées de base de données relatives aux calendriers, aux paramètres, aux invites et aux ressources s effectue au niveau de listes complètes. Pour modifier une ressource existante, vous devez par exemple utiliser l option modify resources du programme de ligne de commande Composer. Ensuite, le programme copie la liste complète des ressources de la base de données dans un fichier d édition que vous pouvez modifier et enregistrer directement via l interface de Composer. Au stade de l enregistrement, le programme de ligne de commande Composer contrôle la syntaxe du fichier et recopie la définition dans la base de données en écrasant la définition existante si la syntaxe est parfaite. Copyright IBM Corp. 1999,

60 Composer n émet pas d avertissement particulier lorsque les mots clés du langage de planification sont utilisés comme noms d objet de planification. Pourtant, l utilisation des mots clés peut entraîner des erreurs. Evitez d utiliser les mots clés suivants lorsque vous définissez des objets de planification : Tableau 4. Liste des mots réservés abendprompt end i18n_priority on schedule after every in onuntil scriptname at everyday interactive op server autodocoff except isuserjob opens stop autodocon extraneous jobfilename order streamlogon behindfirewall fdignore keyjob os su carryforward fdnext keysched priority timezone_tzid confirmed fdprev maestro prompt token_in cpuname filename needs qualifier until dateval follows netdelim quoted_string weekday(s) day(s) freedays nextjob recovery workday(s) day_of_week go node request deadline hi notempty rerun docommand i18n_id number sa 36 IBM Tivoli Workload Scheduler - Guide de référence

61 Définitions de poste de travail Un poste de travail est un objet de planification qui exécute des travaux. Il s agit généralement d un ordinateur individuel sur lequel sont exécutés les travaux et flux de travaux. Une définition de poste de travail est requise sur chaque ordinateur exécutant des travaux sur le réseau IBM Tivoli Workload Scheduler. Généralement, les définitions de poste de travail se réfèrent à des postes de travail physiques. Cependant, en présence d agents étendus, les postes de travail correspondent à des définitions logiques qui doivent être hébergées par un poste de travail physique. Vous pouvez faire figurer plusieurs définitions de poste de travail dans un même fichier texte, avec des définitions de classes de postes de travail et des définitions de domaines. Chaque définition de poste de travail utilise le format et les arguments suivants : Syntaxe #[ commentaires] cpuname poste_travail [description texte ] os type_sys_expl node nom_hôte [tcpaddr port] [secureaddr port][timezone tz fuseau_horaire] [domain nom_domaine] [for maestro [host poste_travail-hôte [access méthode]] [type fta s-agent x-agent] [ignore] [autolink on off] [behindfirewall on off] [securitylevel enabled on force] [fullstatus on off] end [resolvedep on off] [server id_serveur]] [cpuname...] [cpuclass...] [domain...] Arguments # commentaires Indique que le contenu figurant entre le signe dièse et la fin de la ligne doit être considéré comme un commentaire. cpuname poste_travail Indique le nom du poste de travail. Ce nom doit commencer par une lettre et peut contenir des caractères alphanumériques, des tirets et des traits de soulignement. Il peut contenir jusqu à 16 caractères. Pour connaître les mots à éviter lorsque vous utilisez cpuname, voir tableau 4, à la page 36. Remarque : Les noms de postes de travail doivent être uniques et ne peuvent pas être identiques à des noms de domaines ou de classes de postes de travail. description texte Fournit une description du poste de travail. Ce texte doit figurer entre guillemets. Chapitre 3. Référence au programme Composer 37

62 os type_sys_expl Indique le système d exploitation du poste de travail. Les valeurs admises sont UNIX, WNT et OTHER. Tableau 5. Valeurs des systèmes d exploitation pris en charge Utilisez ces valeurs... Pour les systèmes d exploitation... UNIX HP-UX, Sun Solaris, AIX, Linux pour Intel, Linux pour S/390 et z/series, Linux pour iseries et pseries, Irix, OSF, Dynix, Compaq WNT Windows NT, Windows 2000, Windows 2000 NET Server, Windows XP Professionnel OTHER Utilisé avec des agents étendus. Remarque : Pour connaître la liste des plateformes prises en charge, voir IBM Tivoli Workload Scheduler - Notes sur l édition. node nom_hôte Nom d hôte ou adresse IP du poste de travail. Les noms de domaines complets sont admis. tcpaddr port Indique le numéro de port TCP que le planificateur utilise pour établir des communications sur le poste de travail. La valeur par défaut est secureaddr Définit le port utilisé pour détecter les connections SSL entrantes. Cette valeur doit correspondre à celle définie par l option locale port SSL nm du poste de travail. Elle doit être différente de l option locale port nm qui définit le port utilisé pour des communications normales. Si securitylevel est indiqué mais que cet attribut fait défaut, est utilisé comme valeur par défaut. Pour plus d informations sur l authentification SSL, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. timezone tz fuseau_horaire Indique le fuseau horaire du poste de travail. Pour plus d informations sur les noms de fuseau horaire valides, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. Pour assurer une planification du temps précise, ce fuseau horaire doit être le même que celui défini pour le système d exploitation de l ordinateur. domain nom_domaine host access Indique le nom de domaine du planificateur du poste de travail. La valeur par défaut pour les agents à tolérance de pannes et les agents standard est le domaine maître, généralement appelé MASTERDM. La valeur par défaut pour un gestionnaire de domaine correspond au domaine qu il gère. La valeur par défaut pour un agent étendu est le domaine de son poste de travail hôte. poste_travail-hôte Nom du poste de travail hôte de l agent. Ce nom est obligatoire pour des agents étendus. L hôte correspond au poste de travail avec lequel l agent étendu communique et sur lequel résident ses méthodes d accès. Notez que l hôte ne peut pas correspondre à un autre agent étendu. méthode Indique une méthode d accès pour des agents étendus et des agents réseau. Elle doit correspondre au nom d un fichier figurant dans le répertoire racine_tws/methods du poste de travail hôte de l agent. 38 IBM Tivoli Workload Scheduler - Guide de référence

63 type Indique le type du poste de travail. Entrez l un des éléments suivants. fta Agent à tolérance de pannes, incluant les gestionnaires de domaines et les gestionnaires de domaines de sauvegarde. s-agent Agent standard. x-agent Agent étendu. ignore Indique que le planificateur ignorera cette définition du poste de travail. autolink Indique si les postes de travail doivent être connectés au démarrage. Pour des agents à tolérance de pannes et des agents standard, entrez on afin que le gestionnaire de domaine se connecte à l agent au moment du démarrage du gestionnaire de domaine. Pour le gestionnaire de domaine, entrez on afin que ses agents se connectent au gestionnaire de domaine au moment de leur démarrage. La connexion automatique est particulièrement utile lors de la séquence de démarrage au début de chaque journée. En effet, en début de journée, un plan de production est créé et compilé sur le gestionnaire de domaine maître et tous les postes de travail sont arrêtés puis redémarrés. Pour tous les agents pour lesquels l option autolink est activée, le gestionnaire de domaine envoie automatiquement une copie du nouveau plan de production et démarre l agent. Si l option autolink est également activée pour le gestionnaire de domaine, l agent, à son tour, se connecte au gestionnaire de domaine. Si la valeur de l option autolink d un agent est off, le programme initialise l agent dès que vous exécutez une commande Conman link sur le gestionnaire de domaine de l agent ou sur le gestionnaire de domaine maître. behindfirewall Si cet attribut est défini sur ON, cela signifie qu il existe un pare-feu entre le poste de travail et le gestionnaire de domaine maître. Seule une connexion directe entre le poste de travail et son gestionnaire de domaine est autorisée. Pour tous les postes de travail ayant behindfirewall défini sur ON, les commandes start poste_travail, stop poste_travail et showjobs sont envoyées selon la hiérarchie du domaine ; il n est pas nécessaire de faire établir une connexion directe avec le poste de travail par le maître ou le gestionnaire du domaine. fullstatus Indique si l agent est mis à jour avec un statut complet ou partiel. Cette option s applique uniquement pour des agents à tolérance de pannes. Pour que l agent s exécute sur le mode Statut intégral, entrez on. Dans ce mode, l agent est mis à jour avec le statut des travaux et des flux de travaux fonctionnant sur tous les autres postes de travail de ce domaine et des domaines subordonnés, mais pas des domaines homologues ou parents. Si la valeur de fullstatus est off, l agent est informé uniquement du statut des travaux et flux de travaux sur les postes de travail qui affectent ses propres travaux et flux de travaux. Cela peut améliorer les performances en réduisant l activité du réseau. Pour conserver le plan de production d un agent au même niveau de détail que son gestionnaire de domaine, attribuez la valeur on à fullstatus et resolvedep. Définissez toujours ces modes sur on pour des gestionnaires de domaine de sauvegarde. Chapitre 3. Référence au programme Composer 39

64 securitylevel Indique le type d authentification SSL pour le poste de travail. Il doit avoir l une des valeurs suivantes : enabled Le poste de travail utilise une authentification SSL uniquement si le poste de travail de son gestionnaire de domaine ou un autre agent à tolérance de pannes inférieur dans la hiérarchie du domaine l exige. on Le poste de travail utilise une authentification SSL lorsqu il établit une connexion avec son gestionnaire de domaine. Le gestionnaire de domaine utilise une authentification SSL lorsqu il établit une connexion avec le gestionnaire de domaine parent. L agent à tolérance de pannes refuse toute connexion entrante de son gestionnaire de domaine dès qu il ne s agit pas d une connexion SSL. force Le poste de travail utilise une authentification SSL pour toutes ses connexions et accepte les connexions de ses gestionnaires de domaines parent et subordonnés. Il refusera toute connexion entrante si ce n est pas une connexion SSL. Si cet attribut fait défaut, le poste de travail n est pas configuré pour les connexions SSL. Dans ce cas, toute valeur pour secureaddr sera ignorée. Vous devrez également définir l option locale port SSL nm à 0 afin de vous assurer que le port n est pas ouvert par netman. Pour plus d informations sur l authentification SSL, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Le tableau suivant décrit le type de communication utilisée pour chaque type de configuration de securitylevel. Tableau 6. Type de communication selon la valeur de securitylevel. Agent à tolérance de pannes (Gestionnaire de domaine) Gestionnaire de domaine (Gestionnaire de domaine parent) - - TCP/IP Enabled - TCP/IP Type de connexion On - Pas de connexion Force - Pas de connexion - On TCP/IP Enabled On TCP/IP On On SSL Force On SSL - Enabled TCP/IP Enabled Enabled TCP/IP On Enabled SSL Force Enabled SSL - Force Pas de connexion Enabled Force SSL On Force SSL Force Force SSL 40 IBM Tivoli Workload Scheduler - Guide de référence

65 resolvedep Indique si un agent recherche toutes les dépendances ou uniquement les siennes. Cette option s applique uniquement pour des agents à tolérance de pannes. Pour que l agent s exécute sur le mode Résolution des dépendances, entrez on. Avec ce mode, l agent recherche les dépendances de tous les travaux et flux de travaux, y compris ceux exécutés sur d autres postes de travail. Pour que l agent soit informé de l activité sur d autres postes de travail, la valeur de fullstatus doit également être on. Si la valeur de resolvedep est off, l agent ne recherche que les dépendances de ses propres travaux et flux de travaux. Cela permet de réduire le temps de traitement. server Pour conserver le plan de production d un agent au même niveau de détail que son gestionnaire de domaine, attribuez la valeur on à fullstatus et resolvedep. Définissez toujours ces modes sur on pour des gestionnaires de domaine de sauvegarde. id_serveur Indique un serveur Mailman sur le gestionnaire de domaine responsable des communications avec l agent. Cette option s applique aux agents à tolérance de pannes et aux agents standard uniquement. N utilisez pas cette option pour des gestionnaires de domaine. L utilisation de serveurs peut réduire le temps requis pour initialiser des agents et améliorer l opportunité des messages. L ID doit correspondre à une lettre ou à un chiffre unique (A-Z et 0-9). Les ID étant propres à chaque gestionnaire de domaine, vous pouvez utiliser sans conflit les mêmes ID dans des domaines différents. Si vous avez besoin de plus de 36 ID serveur dans un domaine, pensez à diviser ce dernier en deux domaines ou plus. Si aucun ID de serveur n est spécifié, les communications avec l agent seront gérées par le processus Mailman principal sur le gestionnaire de domaine. A son démarrage, le gestionnaire de domaine crée un serveur distinct pour chaque ID de serveur unique. Si le même ID est utilisé pour plusieurs agents, un seul serveur est créé pour gérer leurs communications. A titre indicatif, il est conseillé de définir des serveurs supplémentaires afin d éviter qu un seul serveur gère plus de huit agents. Exemples Dans l exemple suivant, vous allez créer un gestionnaire de domaine maître baptisé hdq-1 et un agent à tolérance de pannes baptisé hdq-2 dans le gestionnaire de domaine. Notez que l argument domain est facultatif dans cet exemple, car la valeur par défaut du domaine maître est masterdm. cpuname hdq-1 description Headquarters master DM os unix tz pst node sultan.ibm.com domain masterdm for maestro type fta autolink on fullstatus on resolvedep on end cpuname hdq-2 os wnt tz pst node opera.ibm.com Chapitre 3. Référence au programme Composer 41

66 end domain masterdm for maestro type fta autolink on L exemple suivant illustre la création d un domaine nommé distr-a avec un gestionnaire de domaine nommé distr-a1 et un agent standard nommé distr-a2 : domain distr-a manager distr-a1 parent masterdm end cpuname distr-a1 description District A domain mgr os wnt tz est node pewter.ibm.com domain distr-a for maestro type fta autolink on fullstatus on resolvedep on end cpuname distr-a2 os wnt node quatro.ibm.com tz est domain distr-a for maestro type s-agent end Dans l exemple suivant, un poste de travail avec une authentification SSL est créé. La définition de sécurité securitylevel indique que la connexion entre le poste de travail et son gestionnaire de domaine peut être uniquement de type SSL. Le port est réservé pour la détection des connexions SSL entrantes. cpuname ENNETI3 os WNT node apollo tcpaddr secureaddr for maestro autolink off fullstatus on securitylevel on end Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d un poste de travail réparti du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 42 IBM Tivoli Workload Scheduler - Guide de référence

67 Définitions de classe de postes de travail Une classe de postes de travail correspond à un groupe de postes de travail pour lequel des flux de travaux communs peuvent être écrits. Vous pouvez faire figurer plusieurs définitions de classes de travail dans un même fichier texte, avec des définitions de postes de travail et des définitions de domaines. Chaque définition de classe de postes de travail utilise le format et les arguments suivants : Syntaxe # commentaires cpuclass classe_postes_travail members [...] end [cpuname...] [cpuclass...] [domain...] Arguments # commentaires Indique que le contenu figurant entre le signe dièse et la fin de la ligne doit être considéré comme un commentaire. cpuclass classe_postes_travail Nom de la classe de postes de travail. Ce nom doit commencer par une lettre et peut contenir des caractères alphanumériques, des tirets et des traits de soulignement. Il peut contenir jusqu à 16 caractères. Remarque : Vous ne pouvez pas utiliser des noms identiques pour des postes de travail, des classes de postes de travail et des domaines. members poste_travail Présente une liste de noms de postes de travail, séparés par des espaces, membres de la classe. Le caractère (a commercial) inclut tous les postes de travail. Exemples Dans l exemple suivant, nous définissons une classe de postes de travail appelée backup : cpuclass backup members main site1 site2 end Dans l exemple suivant, nous définissons une classe de postes de travail appelée allcpus, qui contient chaque poste de travail : cpuclass allcpus end Chapitre 3. Référence au programme Composer 43

68 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d une classe de postes de travail du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 44 IBM Tivoli Workload Scheduler - Guide de référence

69 Définitions de domaine Un domaine correspond à un groupe de postes de travail comportant un ou plusieurs agents ainsi qu un gestionnaire de domaine. Le gestionnaire de domaine se comporte de la même manière que le concentrateur de gestion pour les agents dans le domaine. Vous pouvez faire figurer plusieurs définitions de domaines dans un même fichier texte, avec des définitions de postes de travail et des définitions de classes de postes de travail. Chaque définition de domaine utilise le format et les arguments suivants : Syntaxe # commentaires domain nom_domaine[ description texte ] manager poste_travail [parent nom_domaine] end [cpuname...] [cpuclass...] [domain...] Arguments # commentaires Indique que le contenu figurant entre le signe dièse et la fin de la ligne doit être considéré comme un commentaire. domain nom_domaine Nom du domaine. Ce nom doit commencer par une lettre et peut contenir des caractères alphanumériques, des tirets et des traits de soulignement. Il peut contenir jusqu à 16 caractères. Vous ne pouvez pas utiliser des noms identiques pour des postes de travail, des classes de postes de travail et des domaines. description texte Fournit une description du domaine. Ce texte doit figurer entre guillemets. manager poste_travail Nom du poste de travail correspondant au gestionnaire de domaine. Ce poste de travail doit appartenir au domaine qui est défini. Le gestionnaire de domaine doit être un agent à tolérance de pannes avec la valeur on définie pour les options fullstatus et resolvedep. parent nom_domaine Nom du domaine parent auquel le gestionnaire de domaine est connecté. Il s agit par défaut du domaine maître, qui ne requiert pas de définition de domaine. Il est défini par les options globales master et master domain. Chapitre 3. Référence au programme Composer 45

70 Exemples Dans l exemple suivant, nous définissons un domaine appelé east utilisant le domaine maître comme parent et deux domaines subordonnés baptisés northeast et southeast : domain east description The Eastern domain manager cyclops end domain northeast description The Northeastern domain manager boxcar parent east end domain southeast description The Southeastern domain manager sedan parent east end Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d un domaine du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 46 IBM Tivoli Workload Scheduler - Guide de référence

71 Définitions de travail Un travail correspond à une commande, à un fichier exécutable ou à un programme planifié et exécuté par IBM Tivoli Workload Scheduler. Vous pouvez écrire des définitions de travaux dans des fichiers d édition, puis les ajouter à la base de données du planificateur à l aide du programme de ligne de commande Composer. Vous pouvez faire figurer plusieurs définitions de travaux dans un même fichier d édition. Remarque : Dans la mesure où un travail proprement dit ne comporte pas de dépendances, celles-ci doivent être ajoutées au travail d un flux de travaux. Le langage de planification utilisé pour l écriture de flux de travaux vous permet également d ajouter et de modifier des définitions de travaux. Pour savoir comment utiliser le langage de planification pour écrire des flux de travaux, consultez le chapitre suivant. Chaque définition de travail utilise le format et les arguments suivants : Syntaxe $jobs [poste_travail#]nom_travail scriptname nom_fichier docommand commande streamlogon nom_utilisateur [description texte ] [interactive] [rccondsucc Condition de succès ] [recovery {stop continue rerun} [after [poste_travail#]nom_travail] [abendprompt texte ] ] [ [poste_travail#]nom_travail... ] Arguments poste_travail# Indique le nom du poste de travail ou de la classe de postes de travail sur lequel le travail est exécuté. Le poste par défaut est celui sur lequel le programme Composer est exécuté. Le signe dièse (#) est un délimiteur obligatoire. Si une classe de postes de travail est indiquée, celle-ci doit correspondre à la classe de postes de travail d un flux de travaux contenant le travail. nom_travail Indique le nom du travail. Ce nom doit commencer par une lettre et peut contenir des caractères alphanumériques, des tirets et des traits de soulignement. Il peut contenir jusqu à 40 caractères. scriptname nom_fichier Indique le nom du fichier exécuté par le travail. Utilisez le mot clé scriptname pour exécuter les travaux UNIX et Windows. Pour un fichier exécutable, entrez le nom du fichier et les éventuels arguments et options. La longueur du nom_fichier additionnée à la longueur de la Condition de succès (du mot clé rccondsucc) ne doit pas dépasser 4095 caractères. Vous Chapitre 3. Référence au programme Composer 47

72 pouvez également utiliser des paramètres IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Utilisation de paramètres dans les définitions de travail», à la page 52. Dans le cas des travaux Windows, ajoutez les extensions de fichier. Les noms UNC sont admis. N indiquez pas de fichiers sur les unités mappées. Si des espaces ou des caractères spéciaux autres que les barres obliques (/) et les barres obliques inversées (\) sont inclus, la chaîne entière doit être placée entre guillemets ( ). Si le nom du fichier comporte des espaces, entrez ce nom dans un autre fichier dont le nom ne comporte pas d espaces, puis utilisez le nom du deuxième fichier pour cet argument. docommand commande Indique une commande exécutée par le travail. Entrez une commande valide et les éventuels arguments et options placés entre guillemets ( ). La longueur de la commande additionnée à la longueur de la Condition de succès (du mot clé rccondsucc) ne doit pas dépasser 4095 caractères. La commande est exécutée directement et le script de configuration jobmanrc n est pas exécuté, contrairement au mot clé scriptname. Par ailleurs, la commande est traitée sous forme de travail et toutes les règles relatives aux travaux s appliquent. Vous pouvez également utiliser des paramètres IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Utilisation de paramètres dans les définitions de travail», à la page 52. streamlogon nom_utilisateur Nom d utilisateur sous lequel le travail s exécute. Ce nom peut comporter jusqu à 47 caractères. Si ce nom comporte des caractères spéciaux, il doit être placé entre guillemets ( ). Indiquez un utilisateur qui peut se connecter au poste de travail sur lequel le travail s exécute. Vous pouvez également utiliser des paramètres IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Utilisation de paramètres dans les définitions de travail», à la page 52. Dans le cas de travaux Windows, l utilisateur doit également posséder une définition d utilisateur. Pour obtenir des informations relatives aux besoins de l utilisateur, voir «Définitions d utilisateur», à la page 54. description texte Fournit une description du travail. Ce texte doit figurer entre guillemets. interactive Dans le cas de travaux Windows, rajoutez ce mot clé pour indiquer que le travail sera exécuté de manière interactive sur le bureau Windows NT. 48 IBM Tivoli Workload Scheduler - Guide de référence

73 rccondsucc Condition de succès Expression qui détermine le code retour (RC) requis pour considérer qu un travail est réussi. La longueur maximale de la condition de succès doit être de 256 caractères. Cette expression peut être une combinaison d expressions de comparaison et d expressions booléennes : Expression de comparaison Indique les codes retour des travaux. La syntaxe est : (RC opérateur opérande) RC Mot clé RC. opérateur Opérateur de comparaison. Il peut prendre l une des valeurs suivantes : Tableau 7. Opérateur de comparaison Exemple Opérateur Description RC<a < Inférieur à RC<=a <= Inférieur ou égal à RC>a > Supérieur à RC>=a >= Supérieur ou égal à RC=a = Egal à RC!=a!= Différent de RC<>a <> Différent de opérande Un entier entre et Par exemple, vous pouvez définir un travail réussi comme un travail qui termine par un code retour inférieur ou égal à 3. Exemple : rccondsucc "(RC <= 3)" Expression booléenne Indique une combinaison logique d expressions de comparaison. La syntaxe est : expression_de_comparaison opérateur expression_de_comparaison expression_de_comparaison Cette expression est analysée de gauche à droite. Vous pouvez utiliser des parenthèses pour attribuer une priorité à l évaluation de l expression. Chapitre 3. Référence au programme Composer 49

74 opérateur Opérateur logique. Il peut prendre l une des valeurs suivantes : Tableau 8. Opérateurs logiques Exemple Opérateur Résultat expr_a and expr_b And TRUE si expr_a ET expr_b sont VRAIES. expr_a or expr_b Or TRUE si expr_a OU expr_b est VRAIE. Not expr_a Not TRUE si expr_a n est PAS VRAIE. recovery Par exemple, vous pouvez définir un travail réussi comme un travail qui termine par un code retour inférieur ou égal à 3 ou par un code retour différent de 5 et inférieur à 10. Exemple : rccondsucc "(RC=3) OR ((RC>=5) AND (RC<10))" Options de reprise du travail. La valeur par défaut est stop sans aucun travail de reprise et aucune invite de reprise. Entrez l une des options de reprise suivantes : stop, continue ou rerun. Elle peut être suivie d un travail de reprise et/ou d une invite de reprise. stop En cas de fin anormale du travail, le traitement ne se poursuit pas avec le travail suivant. continue En cas de fin anormale du travail, le traitement se poursuit avec le travail suivant. rerun En cas de fin anormale, le travail est réexécuté. after [poste_travail#]nom_travail Indique le nom d un travail de reprise à lancer si le travail parent prend fin de façon anormale. Les travaux de reprise ne sont lancés qu une seule fois pour chaque instance du travail parent qui prend fin de façon anormale. Vous pouvez indiquer le poste du travail de reprise s il est différent du poste du travail parent. Par défaut, il s agit du poste du travail parent. Tous les travaux ne remplissent pas les conditions nécessaires pour permettre l exécution de travaux de reprise sur un poste de travail différent. Suivez les instructions ci-après : v Si un des postes de travail correspond à un agent étendu, il doit être hébergé par un gestionnaire de domaine ou un agent à tolérance de pannes, dont la valeur du mode fullstatus est on. v Le poste du travail de reprise doit se trouver dans le même domaine que le poste du travail parent. v Si le poste du travail de reprise correspond à un agent à tolérance de pannes, la valeur du mode fullstatus de cet agent doit être on. 50 IBM Tivoli Workload Scheduler - Guide de référence

75 abendprompt texte Indique le texte d une invite de reprise, figurant entre guillemets, qui doit être affiché dans le cas d une fin anormale du travail. Ce texte peut comporter jusqu à 64 caractères. S il commence par un signe deux-points (:), l invite s affiche mais aucune réponse n est requise pour la poursuite du processus. Si le texte commence par un signe d exclamation (!), l invite ne s affiche pas mais une réponse est requise pour la poursuite du traitement. Le tableau ci-après regroupe toutes les combinaisons possibles d options de reprise et d actions. Il est basé sur les critères suivants d un flux de travaux nommé sked1 : v Le flux de travaux sked1 comporte deux travaux, job1 et job2. v S il est sélectionné pour job1, le travail de reprise est jobr. v job2 est dépendant de job1 et ne démarre pas tant que job1 n est pas terminé. Invite de reprise : Non Travail de reprise : Non Invite de reprise : Oui Travail de reprise : Non Invite de reprise : Non Travail de reprise : Oui Stop Continue Rerun Une intervention est requise. Lancez l invite de reprise. Une intervention est requise. Exécutez jobr. Si celui-ci se termine de façon anormale, une intervention est requise. S il s exécute avec succès, exécutez job2. Exécutez job2. Réexécutez job1. En cas de fin anormale de job1, lancez Lancez l invite de reprise. Si la réponse est oui, exécutez job2. Exécutez jobr. Exécutez job2. l invite du planificateur. Si la réponse est oui, répétez ce qui précède. Si job1 s exécute avec succès, exécutez job2. Lancez l invite de reprise. Si la réponse est oui, réexécutez job1. En cas de fin anormale de job1, répétez ce qui précède. Si job1 s exécute avec succès, exécutez job2. Exécutez jobr. Si jobr se termine de façon anormale, une intervention est requise. Si jobr s exécute avec succès, réexécutez job1. En cas de fin anormale de job1, lancez l invite du planificateur. Si la réponse est oui, répétez ce qui précède. Si job1 s exécute avec succès, exécutez job2. Chapitre 3. Référence au programme Composer 51

76 Invite de reprise : Oui Travail de reprise : Oui Stop Continue Rerun Lancez l invite de reprise. Si la réponse est oui, exécutez jobr. Si celui-ci se termine de façon anormale, une intervention est requise. S il s exécute avec succès, exécutez job2. Lancez l invite de reprise. Si la réponse est oui, exécutez jobr. Exécutez job2. Lancez l invite de reprise. Si la réponse est oui, exécutez jobr. Si jobr se termine de façon anormale, une intervention est requise. Si jobr s exécute avec succès, réexécutez job1. En cas de fin anormale de job1, répétez ce qui précède. Si job1 s exécute avec succès, exécutez job2. Remarques : 1. Une intervention est requise signifie que job2 est toujours dépendant de job1 et qu il doit donc être libéré par l opérateur. 2. L option de reprise continue se substitue à l état de fin anormale, ce qui peut faire apparaître l agenda contenant le travail en échec comme ayant réussi. L agenda n est donc pas reporté au jour suivant. 3. Si vous sélectionnez l option Rerun sans indiquer une invite de reprise, le planificateur génère sa propre invite. 4. Pour référencer un travail de reprise dans Conman, vous devez utiliser le nom du travail d origine (job1 dans le scénario ci-dessus, pas jobr). Un seul travail de reprise est exécuté par fin anormale. Utilisation de paramètres dans les définitions de travail : Les utilisations et restrictions suivantes s appliquent aux paramètres des définitions de travail : v Des paramètres sont admis dans les valeurs streamlogon, scriptname et docommand. v Un paramètre peut correspondre à une chaîne entière ou partielle. v Plusieurs paramètres sont admis dans une seule variable. v Les noms de paramètres doivent figurer entre carets (^) et la chaîne entière entre guillemets. v Assurez-vous que les caractères caret ne sont pas précédés d une barre oblique inversée dans la chaîne. Le cas échéant, mettez la barre oblique inversée entre carets dans la définition du paramètre. Par exemple, au lieu de taper la définition de paramètres suivante : $PARM MYDIR "scripts" job01 scriptname "c:\pippo\home\^mydir^\test.cmd" entrez : $PARM MYDIR "\scripts" job01 scriptname "c:\pippo\home^mydir^\test.cmd" Dans l exemple suivant, un paramètre intitulé mis est utilisé dans la valeur streamlogon. D autres exemples sont fournis dans la section «Définitions de paramètre», à la page IBM Tivoli Workload Scheduler - Guide de référence

77 Exemples L exemple suivant présente un fichier comportant deux définitions de travaux : $jobs cpu1#gl1 scriptname "/usr/acct/scripts/gl1" streamlogon acct description "general ledger job1" bkup scriptname "/usr/mis/scripts/bkup" streamlogon "^mis^" recovery continue after recjob1 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d une définition de travail du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 3. Référence au programme Composer 53

78 Définitions d utilisateur Les noms d utilisateur utilisés comme valeur streamlogon dans les définitions de travail Windows doivent posséder des définitions utilisateur. Cela n est pas obligatoire pour les utilisateurs qui exécutent des travaux sur d autres plateformes. Chaque définition d utilisateur utilise le format et les arguments suivants : Syntaxe # commentaires username[poste_travail#]nom_utilisateur password mot_de_passe end [username...] Arguments # commentaires Indique que le contenu figurant entre le signe dièse et la fin de la ligne doit être considéré comme un commentaire. username [poste_travail#]nom_utilisateur Indique le nom d un utilisateur Windows. poste_travail Indique le poste de travail sur lequel l utilisateur peut exécuter des travaux. Le signe dièse est obligatoire. La valeur par défaut est le caractère blanc qui signifie que toutes les plateformes sont concernées. nom_utilisateur Nom de l utilisateur présentant le format suivant : [domaine\]utilisateur où domaine représente le domaine Windows de l utilisateur et utilisateur, le nom de l utilisateur. Le nom de domaine peut comporter jusqu à 16 caractères (dont la barre oblique inversée) et le nom d utilisateur peut comporter jusqu à 31 caractères. Les noms d utilisateur Windows sont sensibles à la casse. En outre, l utilisateur doit pouvoir se connecter au poste de travail sur lequel le planificateur lancera les travaux et doit disposer des droits requis pour ouvrir une session en tant que tâche. Si le nom n est pas unique dans Windows, il doit être considéré comme étant respectivement un utilisateur local, un utilisateur de domaine ou un utilisateur de domaine sécurisé. mot_de_passe Indique le mot de passe de l utilisateur. Le mot de passe peut comporter jusqu à 29 caractères et doit figurer entre guillemets. Pour n indiquer aucun mot de passe, utilisez deux guillemets consécutifs sans espace ( ). Une fois la définition de l utilisateur compilée, il vous sera impossible de lire le mot de passe. Les utilisateurs disposant des droits d accès appropriés peuvent modifier ou supprimer un utilisateur, mais les informations relatives aux mots de passe ne sont jamais affichées. 54 IBM Tivoli Workload Scheduler - Guide de référence

79 Utilisation des définitions d utilisateur et streamlogon Tivoli Workload Scheduler : Sous Windows, vous devez spécifier les définitions d utilisateur via le programme Composer sous la forme [poste_travail#]nom_utilisateur. Le nom du poste de travail est facultatif ; si vous ne l indiquez pas, cela signifie que tous les postes de travail exécutent Windows sur le réseau Tivoli Workload Scheduler. Si vous définissez ou soumettez un travail via le programme Composer, vous devez spécifier un poste de travail et lui affecter un nom de connexion correct. Dans ce cas, le nom de connexion comprend simplement un nom d utilisateur (nom d utilisateur Windows correct) sans le nom du poste de travail. Par exemple, dans la définition de travail suivante : $JOB poste_travail job01 docommand "dir" streamlogon nom_utilisateur La valeur de l option streamlogon est nom_utilisateur et non poste_travail#nom_utilisateur. Si vous utilisez la commande altpass, rappelez-vous que vous devez toutefois utiliser la définition d utilisateur sous la forme poste_travail#nom_utilisateur Dans cette commande, vous pouvez omettre le nom du poste de travail seulement si vous modifiez son mot de passe sur la machine sur laquelle vous exécutez la commande. Utilisateur de domaine sécurisé : Si le planificateur doit lancer des travaux pour un utilisateur de domaine sécurisé, portez une attention particulière à la définition des comptes utilisateur. En supposant que le planificateur est installé dans le domaine Domaine1 pour le compte utilisateur maestro et que le compte utilisateur sue dans le domaine Domaine2 doit lancer un travail, les conditions suivantes doivent être remplies : v Une sécurisation réciproque doit subsister entre Domaine1 et Domaine2. v Dans Domaine1 sur les ordinateurs sur lesquels des travaux sont lancés, sue doit posséder le droit d ouvrir une session en tant que service. v Dans Domaine1, maestro doit correspondre à un utilisateur de domaine. v Dans Domaine2, maestro doit détenir les droits pour accéder à l ordinateur à partir du réseau. Exemples L exemple suivant permet de définir quatre utilisateurs : username joe password "okidoki" end # username server#jane password "okitay" end # username dom1\jane password "righto" end # username jack password "" end Chapitre 3. Référence au programme Composer 55

80 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d un utilisateur Windows du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 56 IBM Tivoli Workload Scheduler - Guide de référence

81 Définitions de calendrier Les calendriers correspondent à des listes de dates que vous pouvez utiliser pour planifier des flux de travaux. Pour saisir une définition de calendrier, exécutez la commande modify du programme Composer. Le programme Composer copie toute la liste des définitions de calendrier dans un fichier d édition et ouvre un éditeur dans lequel vous pouvez modifier la liste. Chaque définition de calendrier utilise le format et les arguments suivants : Syntaxe $calendar nom_calendrier date [...] [ description ] [nom_calendrier...] Arguments nom_calendrier Nom du calendrier. Ce nom peut comporter jusqu à huit caractères alphanumériques, incluant les tirets (-) et les traits de soulignement (_), et doit commencer par une lettre. description Fournit une description du calendrier. Elle doit figurer entre guillemets. Son nom peut comporter des caractères alphanumériques à condition de commencer par une lettre. Les caractères suivants sont admis : virgule (,), point (.), tiret (-), plus (+), apostrophe ( ) et égal (=). Il ne peut pas comporter les caractères suivants : guillemet ( ) (autres que ceux encadrant la description), deux-points (:), point-virgule(;) et la perluète (&). date [...] Indique une ou plusieurs dates, séparées par des espaces. Le format est mm/jj/aa. Exemples L exemple ci-après permet de définir trois calendriers intitulés monthend, paydays et holidays : $calendar monthend "Month end dates 1st half 99" 01/31/99 02/28/99 03/31/99 04/30/99 05/31/99 06/30/99 paydays 01/15/99 02/15/99 03/15/99 04/15/99 05/14/99 06/15/99 holidays 01/01/99 02/15/99 05/31/99 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d un calendrier du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 3. Référence au programme Composer 57

82 Définitions de paramètre Les paramètres représentent les valeurs, qui remplacent certaines variables dans les définitions de travail ou de flux de travaux dès que le nouveau plan de production est créé. Pour saisir une définition de paramètre, exécutez la commande modify du programme Composer. Le programme Composer copie alors toute la liste des définitions de paramètre dans un fichier d édition et ouvre un éditeur dans lequel vous pouvez modifier la liste. Chaque définition de paramètre utilise le format et les arguments suivants : Syntaxe $parm nom_paramètre [nom_paramètre...] Arguments valeur nom_paramètre Nom du paramètre. Ce nom peut comporter jusqu à huit caractères alphanumériques, incluant les tirets (-) et les traits de soulignement (_), et doit commencer par une lettre. valeur Indique la valeur affectée au paramètre. N inclut pas le nom d autres paramètres. Remarques Des paramètres peuvent être utilisés dans tout travail, tout flux de travaux et toute invite. Lorsqu ils sont utilisés au niveau de la planification, les noms des paramètres sont remplacés par leurs valeurs lorsque le plan de production est compilé pour une nouvelle journée de traitement. Plusieurs paramètres sont admis dans une seule variable. Les noms de paramètres doivent figurer entre carets (^) et la chaîne entière entre guillemets. Assurez-vous que les caractères caret ne sont pas précédés d une barre oblique inversée dans la chaîne. Le cas échéant, mettez la barre oblique inversée entre carets dans la définition du paramètre. Par exemple, au lieu de taper la définition de paramètres suivante : $PARM MYDIR "scripts" job01 scriptname "c:\pippo\home\^mydir^\test.cmd" entrez : $PARM MYDIR "\scripts" job01 scriptname "c:\pippo\home^mydir^\test.cmd" Exemples Deux paramètres, glpath et gllogon, sont définis de la manière suivante : $parm glpath gllogon "/glfiles/daily" "gluser" 58 IBM Tivoli Workload Scheduler - Guide de référence

83 Dans un flux de travaux intitulé glsched, les paramètres glpath et gllogon sont utilisés dans un travail intitulé gljob2 : schedule glsched on weekdays : gljob2 scriptname "/usr/gl^glpath^" streamlogon "^gllogon^" opens "^glpath^/datafile" prompt ":^glpath^ started by ^gllogon^" end Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d un paramètre du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 3. Référence au programme Composer 59

84 Définitions d invite Les invites peuvent servir de dépendances dans les travaux ou les flux de travaux. Caractérisée par un nom unique associé à un message textuel, l invite doit recevoir une réponse affirmative de la part du travail ou du flux de travaux à lancer. Pour saisir une définition d invite, exécutez la commande modify du programme Composer. Le programme Composer copie alors toute la liste des définitions d invite dans un fichier d édition et ouvre un éditeur dans lequel vous pouvez modifier la liste. Il existe deux types d invite : v ad hoc ou locale, v prédéfinie ou globale. Une invite locale est définie dans les propriétés d un travail ou d un flux de travaux et est propre à ce travail ou ce flux de travaux. Une invite globale est définie dans la base de données du planificateur et peut être utilisée par n importe quel travail ou flux de travaux. Remarque : Chaque fois que la commande Jnextday est exécutée, les définitions d invite générales ou prédéfinies sont réinitialisées. Syntaxe $prompt nom_invite [:!]texte [nom_invite...] Arguments nom_invite Nom de l invite. Ce nom peut comporter jusqu à huit caractères alphanumériques, incluant les tirets (-) et les traits de soulignement (_), et doit commencer par une lettre. texte Fournit le texte de l invite. S il commence par un signe deux-points (:), l invite s affiche mais aucune réponse n est requise pour la poursuite du processus. Si le texte commence par un signe d exclamation (!), l invite ne s affiche pas mais une réponse est requise pour la poursuite du processus. Un ou plusieurs paramètres peuvent être utilisés pour une partie ou l ensemble de la chaîne de texte de l invite. Si un paramètre est utilisé, celui-ci doit être placé entre carets (^). Pour un exemple, voir «Définitions de paramètre», à la page 58. Remarque : Dans une invite locale, lorsqu ils ne désignent pas de paramètre, les carets (^) doit être précédés d une barre oblique inversée pour ne pas provoquer d erreur. Dans les invites globales, il n est pas nécessaire de faire précéder les carets d une barre oblique inversée. Pour créer une ligne, vous pouvez inclure une barre oblique inversée suivie de la lettre n ( \n) dans le texte. 60 IBM Tivoli Workload Scheduler - Guide de référence

85 Exemples L exemple suivant permet de définir trois invites : $prompt prmt1 "prêt pour job4? (y/n)" prmt2 ":job4 lancé" prmt3 "!poursuivre?" Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d une invite du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 3. Référence au programme Composer 61

86 Définitions de ressource Les ressources correspondent à des ressources de planification physiques ou logiques qui peuvent servir de dépendances pour les travaux et les flux de travaux. Pour saisir une définition de ressource, exécutez la commande modify du programme Composer. Le programme Composer copie alors toute la liste des définitions de ressource dans un fichier d édition et ouvre un éditeur dans lequel vous pouvez modifier la liste. Chaque définition de ressource utilise le format et les arguments suivants : Syntaxe $resource poste_travail#nom_ressource unités [ description ] [poste_travail#nom_ressource...] Arguments poste_travail Indique le nom du poste de travail ou de la classe de postes de travail sur lequel la ressource est utilisée. nom_ressource Indique le nom de la ressource. Ce nom peut comporter jusqu à huit caractères alphanumériques, incluant les tirets (-) et les traits de soulignement (_), et doit commencer par une lettre. unités Indique le nombre d unités de ressources disponibles. Les valeurs peuvent être comprises entre 0 et description Fournit une description de la ressource. Elle doit figurer entre guillemets. Exemples L exemple suivant permet de définir quatre ressources : $resource ux1#tapes 3 "unités de bande" ux1#jobslots 24 "emplacements de travaux" ux2#tapes 2 "unités de bande" ux2#jobslots 16 "emplacements de travaux" Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création d une ressource répartie du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 62 IBM Tivoli Workload Scheduler - Guide de référence

87 Programme de ligne de commande Composer Le programme de ligne de commande Composer permet de gérer les objets de planification dans la base de données du planificateur. Exécution du programme Composer Pour exécuter le programme, utilisez la commande suivante : composer [ commande[&[commande]][...] ] La liste suivante détaille les différents exemples de commande : v Exécute le programme Composer et invite l utilisateur à taper une commande : composer v Exécute les commandes print et version avant de quitter : composer "p parms&v" v Exécute les commandes print et version avant d inviter l utilisateur à taper une commande : composer "p parms&v&" v Lit les commandes à partir de cmdfile : composer < cmdfile v Transmet les commandes de cmdfile au programme Composer : cat cmdfile composer Caractères de commande Vous pouvez taper les caractères de commande suivants en mode conversationnel pour interrompre le programme Composer, si les paramètres stty sont configurés à cette fin. Ctrl+c Le programme Composer interrompt l exécution de la commande dès que l étape courante le permet et renvoie une invite de commande. Ctrl+d Le programme Composer quitte après avoir exécuté la commande courante. Sortie sur le terminal La sortie sur votre ordinateur est contrôlée par les variables shell MAESTROLINES et MAESTROCOLUMNS. Si aucune de ces variables n est définie, il est fait appel aux variables du shell standard LINES et COLUMNS. A la fin de chaque page d écran, le programme Composer vous invite à poursuivre. Si la variable MAESTROLINES (ou LINES) a pour valeur zéro ou une valeur négative, le programme Composer ne marque pas de pause à la fin de chaque page. Sortie offline Dans les commandes du programme Composer, l option ;offline permet d imprimer la sortie d une commande. Si vous la définissez, les variables suivantes contrôlent la sortie : Variables Windows : $MAESTROLP Indique le fichier dans lequel la sortie d une commande est écrite. La valeur par défaut est stdout. $MAESTROLPLINES Indique le nombre de lignes par page. La valeur par défaut est 60. Chapitre 3. Référence au programme Composer 63

88 $MAESTROLPCOLUMNS Indique le nombre de caractères par ligne. La valeur par défaut est 132. Variables UNIX : Dans les commandes du programme Composer, l option ;offline permet d imprimer la sortie d une commande. Lorsqu elle est insérée, la sortie est contrôlée par les variables de shell ci-après : $MAESTROLP Indique la destination de la sortie d une commande. Vous pouvez indiquer : > fichier La sortie est dirigée vers un fichier dont elle remplace le contenu. Si le fichier n existe pas, il est créé. >> fichier La sortie est dirigée vers un fichier et est ajoutée à la fin de son contenu. Si le fichier n existe pas, il est créé. commande La sortie est dirigée vers une commande système ou un processus. Le programme exécute la commande système, que la sortie soit générée ou non. commande La sortie est dirigée vers une commande système ou un processus. La commande système n est pas exécutée en l absence de résultat. La valeur par défaut est lp -tconlist qui dirige la sortie de la commande vers l imprimante et insère le titre CONLIST sur la page bannière de la sortie. $MAESTROLPLINES Indique le nombre de lignes par page. La valeur par défaut est 60. $MAESTROLPCOLUMNS Indique le nombre de caractères par ligne. La valeur par défaut est 132. Vous devez exporter les variables avant d exécuter le programme Composer. Editeur Composer Plusieurs commandes du programme Composer permettent d ouvrir automatiquement un éditeur de texte. Vous pouvez sélectionner l éditeur que Composer doit utiliser. Windows : Sous Windows, l éditeur par défaut est l éditeur MS-DOS edit. Toutefois, cet éditeur suit la convention d appellation 8.3 qui peut constituer une restriction lorsque Composer l utilise pour modifier des objets de base de données. Si le nom de l objet est supérieur à 8,3 caractères, la commande MODIFY de Composer s exécute en erreur. Il est recommandé d utiliser un autre éditeur, tel que le bloc-notes. Pour ce faire, remplacez la variable EDITOR par le nom du nouvel éditeur avant d exécuter Composer. UNIX : Plusieurs commandes du programme Composer permettent d ouvrir automatiquement un éditeur de texte. Le type d éditeur utilisé est déterminé par la valeur de deux variables du shell. Si la variable VISUAL est définie, elle définit l éditeur, sinon c est la variable EDITOR qui le définit. Si aucune de ces variables n est définie, l éditeur vi s ouvre. 64 IBM Tivoli Workload Scheduler - Guide de référence

89 Sélection de l invite de commande Composer sous UNIX L invite de commande du programme Composer est définie dans le fichier racine_twslocalopts. L invite de commande par défaut correspond à un tiret (-). Pour sélectionner une autre invite, éditez l option d invite de Composer dans le fichier localopts et modifiez le tiret. L invite peut comporter jusqu à dix caractères, le signe dièse (#) de fin requis n étant pas inclus : # # Custom format attributes # date format = 1 # The possible values are 0-ymd, 1-mdy, 2-dmy, 3-NLS. composer prompt = - conman prompt = % switch sym prompt = <n>% # Syntaxe des commandes Les commandes du programme Composer se décomposent de la manière suivante : nom_commande sélection arguments Où : nom_commande Indique le nom de la commande. sélection Indique l objet ou le groupe d objets sur lequel sera exécutée la commande. arguments Indique les arguments de la commande. Caractères génériques Les caractères génériques acceptés dans certaines commandes du programme Composer sont les suivants Remplace un ou plusieurs caractères alphanumériques.? Remplace un caractère alphanumérique. % Remplace un caractère numérique. Délimiteurs et caractères spéciaux Les caractères ci-après, ont une signification particulière dans les commandes du programme Composer. Caractère Description & Délimiteur de commande. Voir «Exécution du programme Composer», à la page 63. ; Délimiteur d argument. Par exemple : ;info;offline = Délimiteur de valeur. Par exemple : sched=sked5 Chapitre 3. Référence au programme Composer 65

90 Caractère Description :! Préfixes de commande qui transmettent la commande au système. Ces préfixes sont facultatifs. Si le programme Composer ne reconnaît pas une commande, elle est transmise automatiquement au système. Par exemple :!ls ou :ls << >> Crochets de mise en commentaire. Des commentaires peuvent figurer sur une seule ligne n importe où dans un flux de travaux. Par exemple : schedule foo <<commentaire>> on everyday * Préfixe de commentaire. Lorsque ce préfixe correspond au premier caractère d une ligne, la ligne entière correspond à un commentaire. Lorsque ce préfixe suit une commande, seul le reste de la ligne correspond au commentaire. Par exemple : *commentaire ou print& *commentaire > Dirige la sortie de la commande vers un fichier dont elle remplace le contenu. Si le fichier n existe pas, il est créé. Par exemple : display parms > parmlist >> Dirige la sortie de la commande vers un fichier et celle-ci est ajoutée à la fin du fichier. Si le fichier n existe pas, il est créé. Par exemple : display parms >> parmlist La sortie de la commande est dirigée vers une commande système ou un processus. Le programme exécute la commande système, que la sortie soit générée ou non. Par exemple : display parms grep alparm La sortie de la commande est dirigée vers une commande système ou un processus. La commande système n est pas exécutée en l absence de résultat. Par exemple : display parms grep alparm Description des commandes Les pages suivantes fournissent une description des commandes du programme Composer. Commande Description Page add Ajoute des objets de planification. «add», à la page 68 build Crée ou recrée un fichier IBM Tivoli Workload Scheduler. «build», à la page 69 continue Ignore l erreur suivante. «continue», à la page 70 create Crée un fichier à des fins d édition. «create», à la page 71 delete Supprime des objets de planification. «delete», à la page 73 display Affiche des objets de planification. «display, list, print», à la page IBM Tivoli Workload Scheduler - Guide de référence

91 Commande Description Page edit Permet d éditer un fichier. «edit», à la page 79 exit Sort de Composer. «exit», à la page 80 list Répertorie les objets de planification. «display, list, print», à la page 75 modify Modifie les objets de planification. «modify», à la page 81 new Edite ou ajoute des objets de planification. «new», à la page 83 print Imprime des objets de planification. «display, list, print», à la page 75 redo Edite la commande précédente. «redo», à la page 84 replace Permet de remplacer des objets de planification. «replace», à la page 86 validate Valide un fichier. «validate», à la page 88 version Affiche la bannière du programme de ligne de commande Composer. «version», à la page 89 system command Envoie une commande au système. «system command», à la page 87 Vous pouvez entrer le nom des commandes et les mots clés en majuscules ou en minuscules. Vous pouvez également les abréger en utilisant les premiers caractères pour les distinguer les uns des autres. Chapitre 3. Référence au programme Composer 67

92 add Permet d ajouter des travaux, des flux de travaux, des utilisateurs, des postes de travail, des classes de postes de travail et des domaines. Des droits d accès add sont requis pour les nouveaux objets. Si l objet existe déjà, celui-ci requiert des droits d accès modify. Syntaxe add nom_fichier Arguments nom_fichier Indique le nom d un fichier qui contient les éléments suivants : v Définitions de travaux (la première ligne du fichier doit être $jobs). v Définitions de flux de travaux. v N importe quelle combinaison de définitions de poste de travail, de classe de postes de travail et de domaine. v Définitions d utilisateurs. Remarques La syntaxe du fichier est systématiquement contrôlée avant l enregistrement de celui-ci dans la base de données. Les erreurs et les avertissements sont consignés. Si le fichier contient des erreurs de syntaxe, vous êtes invité à les corriger. Si un objet existe déjà, un message vous demande si vous souhaitez le remplacer. Exemples Pour ajouter les travaux du fichier myjobs, exécutez la commande suivante : add myjobs Pour ajouter les flux de travaux du fichier mysked, exécutez la commande suivante : a mysked Pour ajouter les postes de travail, les classes de postes de travail et les domaines du fichier cpus.src, exécutez la commande suivante : a cpus.src Pour ajouter les définitions d utilisateur du fichier users_nt, exécutez la commande suivante : a users_nt Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Contrôle des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 68 IBM Tivoli Workload Scheduler - Guide de référence

93 build Crée ou recrée des fichiers de base de données du planificateur. Vous devez avoir un droit d accès build sur le fichier. Si vous avez implémenté le groupe de correctifs 8.2-TWS-FP04, vous pouvez utiliser la commande sans arrêter IBM Tivoli Workload Scheduler. Toutefois, nous vous conseillons d arrêter tous les processus IBM Tivoli Workload Scheduler avant d exécuter la commande si vous n avez pas implémenté le groupe de correctifs ou un groupe de correctifs ultérieur. Syntaxe build nom_fichier Arguments nom_fichier_base_données Désigne l un des noms de fichier suivant : calendars Le fichier comportant les définitions des calendriers. cpudata Le fichier comportant les définitions des postes de travail, des classes de postes de travail et des domaines. jobs Le fichier comportant les définitions des travaux. mastsked Le fichier comportant les définitions des flux de travaux. parms Le fichier comportant les définitions des paramètres. prompts Le fichier comportant les définitions des invites. resources Le fichier comportant les définitions des ressources. userdata Le fichier comportant les définitions des utilisateurs. Remarques Lorsqu il n existe pas, le fichier est créé. S il existe, il est recréé. Recréer un fichier peut s avérer utile lorsque la base de données a été fragmentée à la suite d une série d ajouts ou de suppressions. Cette opération supprime les enregistrements inutilisés et optimise les clés. Exemples Pour régénérer les fichiers contenant les définitions de flux de travaux, exécutez la commande suivante : build mastsked Pour régénérer le fichier contenant les calendriers, exécutez la commande suivante : build calendars Pour régénérer le fichier contenant les postes de travail, exécutez la commande suivante : b cpudata Chapitre 3. Référence au programme Composer 69

94 continue Permet d ignorer l erreur générée par la commande suivante. Syntaxe continue Remarques Cette commande est utile lorsque plusieurs commandes sont entrées sur la ligne de commande ou redirigées à partir d un fichier. Elle indique au programme Composer de continuer à exécuter les commandes même si celle qui a été lancée après continue génère une erreur. Elle est utile lorsque vous entrez des commandes de manière interactive dans la mesure où le programme Composer ne s arrête pas sur une erreur. Exemples Si vous souhaitez que le programme Composer continue à traiter la commande print si la commande delete génère une erreur, exécutez la commande suivante : composer "continue&delete cpu=site4&print cpu=@" 70 IBM Tivoli Workload Scheduler - Guide de référence

95 create Permet de créer un fichier contenant les définitions des objets. Vous devez avoir un droit d accès display sur les objets copiés. Syntaxe create nom_fichier from calendars parms prompts resources cpu={poste_travail classe_postes_travail domaine} jobs=[poste_travail#]nom_travail sched=[poste_travail#]flux_travaux users=[poste_travail#]nom_utilisateur Arguments nom_fichier Désigne un nom de fichier. calendars Copie tous les calendriers dans le fichier. parms Copie tous les paramètres dans le fichier. prompts Copie toutes les invites dans le fichier. resources Copie toutes les ressources dans le fichier. cpu Copie un poste de travail, une classe de postes de travail ou un domaine dans le fichier. poste_travail Nom du poste de travail. Les caractères génériques sont acceptés. classe_postes_travail Nom de la classe de postes de travail. Les caractères génériques sont acceptés. domaine Nom du domaine. Les caractères génériques sont acceptés. jobs Copie tous les travaux dans le fichier. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le travail est exécuté. Les caractères génériques sont acceptés. Le poste par défaut est celui sur lequel le programme Composer est exécuté. nom_travail Nom du travail. Les caractères génériques sont acceptés. sched Copie tous les flux de travaux dans le fichier. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le flux de travaux est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. flux_travaux Nom du flux de travaux. Les caractères génériques sont acceptés. Chapitre 3. Référence au programme Composer 71

96 users Copie tous les utilisateurs dans le fichier. La zone du mot de passe n est pas copiée pour des raisons de sécurité. poste_travail Nom du poste de travail sur lequel l utilisateur est défini. Les caractères génériques sont acceptés. Le poste par défaut est celui sur lequel le programme Composer est exécuté. nom_utilisateur Nom de l utilisateur. Les caractères génériques sont acceptés. Remarque : Vous devez sauvegarder régulièrement les objets de la base de données. Remarques Après avoir créé un fichier, vous pouvez le modifier à l aide de la commande edit. Les commandes add et replace peuvent ensuite être utilisées pour ajouter ou mettre à jour la définition. Exemples Pour créer un fichier contenant tous les calendriers, exécutez la commande suivante : create caltemp from calendars Pour créer un fichier contenant tous les flux de travaux, exécutez la commande suivante : cr stemp from sched=@ Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Contrôle des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 72 IBM Tivoli Workload Scheduler - Guide de référence

97 delete Permet de supprimer des définitions d objets dans la base de données. Un droit d accès delete sur les objets supprimés est requis. Syntaxe delete cpu={poste_travail classe_postes_travail domaine} jobs=[poste_travail#]nom_travail sched=[poste_travail#]flux_travaux users=[poste_travail#]nom_utilisateur Arguments cpu Supprime les postes de travail, les classes de postes de travail ou les domaines. poste_travail Nom du poste de travail. Les caractères génériques sont acceptés. classe_postes_travail Nom de la classe de postes de travail. Les caractères génériques sont acceptés. domaine Nom du domaine. Les caractères génériques sont acceptés. jobs Supprime les travaux. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le travail est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. nom_travail Nom du travail. Les caractères génériques sont acceptés. sched Supprime les flux de travaux. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le flux de travaux est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. flux_travaux Nom du flux de travaux. Les caractères génériques sont acceptés. users Supprime les utilisateurs. poste_travail Nom du poste de travail sur lequel l utilisateur est défini. Les caractères génériques sont acceptés. Le poste par défaut est celui sur lequel le programme Composer est exécuté. nom_utilisateur Nom de l utilisateur. Les caractères génériques sont acceptés. Remarques Si vous utilisez des caractères génériques pour spécifier plusieurs définitions, le programme Composer demande confirmation avant de supprimer une définition répondant aux critères. Chapitre 3. Référence au programme Composer 73

98 Exemples Pour supprimer le travail job3 qui a été lancé sur le poste de travail site3, exécutez la commande suivante : delete jobs=site3#job3 Pour supprimer tous les postes de travail dont le nom commence par ux, exécutez la commande suivante : de cpu=ux@ Pour supprimer tous les flux de travaux dont le nom commence par test sur tous les postes de travail, exécutez la commande suivante : de sched=@#test@ Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Contrôle des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 74 IBM Tivoli Workload Scheduler - Guide de référence

99 display, list, print Permet d afficher, de répertorier ou d imprimer des définitions d objets. Pour exécuter les commandes display et print, vous devez avoir un accès en affichage sur l objet. En réalité, la commande display affiche le contenu de l objet de base de données tandis que les commandes list et print affichent le nom et les attributs de l objet de base de données. Syntaxe display list print calendars parms prompts resources cpu={poste_travail classe_postes_travail domaine} jobs=[poste_travail#]nom_travail sched=[poste_travail#]flux_travaux users=[poste_travail#]nom_utilisateur Arguments calendars Affiche tous les calendriers. parms Affiche tous les paramètres. prompts Affiche toutes les invites. resources Affiche toutes les ressources. cpu Affiche un poste de travail, une classe de postes de travail ou un domaine. poste_travail Nom du poste de travail. Les caractères génériques sont acceptés. classe_postes_travail Nom de la classe de postes de travail. Les caractères génériques sont acceptés. domaine Nom du domaine. Les caractères génériques sont acceptés. jobs Affiche un travail. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le travail est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. nom_travail Nom du travail. Les caractères génériques sont acceptés. sched Affiche un flux de travaux. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le flux de travaux est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. flux_travaux Nom du flux de travaux. Les caractères génériques sont acceptés. Chapitre 3. Référence au programme Composer 75

100 users Affiche un utilisateur. (La zone du mot de passe n est pas copiée pour des raisons de sécurité). poste_travail Nom du poste de travail sur lequel l utilisateur est défini. Les caractères génériques sont acceptés. Le poste par défaut est celui sur lequel le programme Composer est exécuté. nom_utilisateur Nom de l utilisateur. Les caractères génériques sont acceptés. Résultat de commande La commande list affiche uniquement les noms d objet. La sortie de la commande print est contrôlée par la variable MAESTROLP. Pour plus d informations, voir «Sortie offline», à la page 63. Format des calendriers : Calendrier Nom du calendrier. Description Description du calendrier dans un format libre. Ces zones sont suivies par une liste de dates provenant du calendrier. Format des postes de travail : ID du poste de travail Nom d un poste de travail, d une classe de postes de travail ou d un domaine. Créateur Nom de l utilisateur qui a créé la définition du poste de travail. Dernière mise à jour Date à laquelle la définition du poste de travail a été mise à jour pour la dernière fois. Ces zones sont suivies de la définition du poste de travail ou de la classe de postes de travail. Format des travaux : ID du poste de travail Nom du poste de travail sur lequel le travail est exécuté. Travail Nom du travail. Connexion Nom de l utilisateur qui s est connecté pour le travail. Dernière date d exécution Date à laquelle le travail a été exécuté pour la dernière fois. Ces zones sont suivies de la définition du travail. Format des paramètres : Paramètre Nom du paramètre. 76 IBM Tivoli Workload Scheduler - Guide de référence

101 Valeur Valeur du paramètre. Format des invites : Invite Nom de l invite. Message Texte du message d invite. Format des ressources : ID du poste de travail Nom du poste de travail sur lequel la ressource est définie. Ressource Nom de la ressource. Nb. disponible Nombre total d unités de ressource. Description Description de la ressource, dans un format libre. Format des calendriers : ID du poste de travail Nom du poste de travail sur lequel le flux de travaux est exécuté. Agenda Nom du flux de travaux. Créateur Nom de l utilisateur qui a créé la définition du flux de travaux. Dernière mise à jour Date à laquelle la définition du flux de travaux a été mise à jour pour la dernière fois. Ces zones sont suivies par la définition du flux de travaux. Format des utilisateurs : ID du poste de travail Nom du poste de travail sur lequel l utilisateur est autorisé à exécuter des travaux. Utilisateur Nom de l utilisateur. Créateur Nom de l utilisateur qui a créé la définition d utilisateur. Dernière mise à jour Date à laquelle la définition d utilisateur a été mise à jour pour la dernière fois. Ces zones sont suivies par la définition d utilisateur. Exemples Pour afficher tous les calendriers, exécutez la commande suivante : display calendars Chapitre 3. Référence au programme Composer 77

102 Pour imprimer tous les flux de travaux qui ont été lancés sur le poste de travail site2, exécutez la commande suivante : di sched=site2#@;offline Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Utilisation des listes d objets du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 78 IBM Tivoli Workload Scheduler - Guide de référence

103 edit Permet d éditer un fichier. Syntaxe edit nom_fichier Remarques Il convient de lancer un éditeur et d ouvrir le fichier à modifier dans ce programme. Pour plus d informations, voir «Editeur Composer», à la page 64. Exemples Pour modifier le fichier mytemp, exécutez la commande suivante : edit mytemp Pour modifier le fichier resfile, exécutez la commande suivante : ed resfile Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Contrôle des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 3. Référence au programme Composer 79

104 exit Quitte le programme de ligne de commande Composer. Syntaxe exit Remarques Si vous exécutez le programme de ligne de commande Composer en mode Aide, la commande active le programme Composer en mode Saisie de commande. Exemples Pour quitter le programme de ligne de commande Composer, exécutez la commande suivante : exit ou : e 80 IBM Tivoli Workload Scheduler - Guide de référence

105 modify Permet de modifier ou d ajouter des objets de planification. Vous devez avoir des droits d accès de modification sur l objet ou le fichier de base de données concerné. Syntaxe modify calendars parms prompts resources cpu={poste_travail classe_postes_travail domaine} jobs=[poste_travail#]nom_travail sched=[poste_travail#]flux_travaux users=[poste_travail#]nom_utilisateur Arguments calendars Modifie tous les calendriers. parms Modifie tous les paramètres. prompts Modifie toutes les invites. resources Modifie toutes les ressources. cpu Modifie un poste de travail, une classe de postes de travail ou un domaine. poste_travail Nom du poste de travail. Les caractères génériques sont acceptés. classe_postes_travail Nom de la classe de postes de travail. Les caractères génériques sont acceptés. domaine Nom du domaine. Les caractères génériques sont acceptés. jobs Modifie un travail. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le travail est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. nom_travail Nom du travail. Les caractères génériques sont acceptés. sched Modifie un flux de travaux. poste_travail Nom du poste de travail ou de la classe de postes de travail sur lequel le flux de travaux est exécuté. Les caractères génériques sont acceptés. Le poste de travail par défaut est celui sur lequel le programme Composer est exécuté. flux_travaux Nom du flux de travaux. Les caractères génériques sont acceptés. Chapitre 3. Référence au programme Composer 81

106 users Modifie un utilisateur. poste_travail Nom du poste de travail sur lequel l utilisateur est défini. Les caractères génériques sont acceptés. Le poste par défaut est celui sur lequel le programme Composer est exécuté. nom_utilisateur Nom de l utilisateur. Les caractères génériques sont acceptés. Remarques La commande modify copie la définition ou la liste d objets dans un fichier temporaire, modifie le fichier et ajoute ensuite son contenu dans le fichier de base de données approprié. La séquence de commandes suivante produit un effet identique : create file from object-specification edit file add file Si l opération d ajout a abouti, le fichier d édition est supprimé. Pour plus d informations, consultez les descriptions des commandes create, edit et add présentées dans ce chapitre. Si la zone du mot de passe n a pas été renseignée lorsque vous quittez l éditeur lors de la définition d un utilisateur, l ancien mot de passe est conservé. Pour définir un mot de passe vide, insérez deux guillemets ( ). Exemples Pour modifier tous les calendriers, exécutez la commande suivante : modify calendars Pour modifier le flux de travaux sked9 qui a été lancé sur le poste de travail site1, exécutez la commande suivante : m sched=site1#sked9 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Contrôle des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 82 IBM Tivoli Workload Scheduler - Guide de référence

107 new Permet d ajouter un objet de planification. Des droits d accès add sont requis pour les nouveaux objets du poste de travail. Lorsque les objets existent déjà, vous devez avoir des droits d accès de modification sur l objet ou le fichier de base de données concerné. Syntaxe new Remarques La commande new crée un fichier temporaire, édite le fichier et ajoute ensuite son contenu au fichier existant. Pour les calendriers, les paramètres, les ressources et les invites, utilisez la commande modify décrite à la page 81. Exemples Pour créer un fichier temporaire, le modifier et ajouter son contenu à la base de données, exécutez la commande suivante : new ou : n Chapitre 3. Référence au programme Composer 83

108 redo Modifie et exécute à nouveau la commande précédente. Syntaxe redo Contexte Si vous exécutez la commande redo, le programme Composer affiche la dernière commande, que vous pouvez modifier et réexécuter à votre guise. Utilisez la barre d espacement pour placer le curseur sous le caractère à modifier, puis entrez les instructions ci-dessous. Instructions d[ rép ] Supprime le caractère situé au-dessus de la lettre d. Cette commande peut être suivie par d autres instructions. itexte Insère du texte avant le caractère situé au-dessus de la lettre i. rtexte Remplace un ou plusieurs caractères par le texte en commençant par le caractère au-dessus du r. Le remplacement est implicite si aucune autre instruction n est entrée. >texte Ajoute le texte à la fin de la ligne. >d[rép texte ] Supprime les caractères en fin de ligne. Cette commande peut être suivie d une autre instruction ou d un autre texte. >rtexte Remplace les caractères à la fin de la ligne par le texte. Exemples d instruction ddd Supprime les trois caractères au-dessus des d. iabc Insère abc avant le caractère situé au-dessus de la lettre i. rabc Remplace les trois caractères indiqués, en commençant par le caractère situé au-dessus de la lettre r, par abc. abc Remplace les trois caractères situés au-dessus de abc, par abc. d diabc Supprime le caractère au-dessus du premier d, ignore un caractère, supprime le caractère au-dessus du second d, puis le remplace par abc. >abc Ajoute abc à la fin de la ligne. >ddabc Supprime les deux derniers caractères de la ligne et insère abc à leur place. >rabc Remplace les trois derniers caractères de la ligne par abc. Exemples Pour insérer un caractère, exécutez la commande suivante : redo dislay site1#sa@ ip display site1#sa@ 84 IBM Tivoli Workload Scheduler - Guide de référence

109 Pour remplacer un caractère, exécutez la commande suivante : redo display site1#sa@ r2 display site2#sa@ Chapitre 3. Référence au programme Composer 85

110 replace Permet de remplacer des objets de planification. Des droits d accès de modification sont requis sur les objets ou le fichier de base de données concerné. Syntaxe replace nom_fichier Arguments nom_fichier Indique le nom d un fichier qui contient les éléments suivants : v Définitions de travaux. La première ligne du fichier doit être $jobs. v Définitions de flux de travaux. v N importe quelle combinaison de définitions de poste de travail, de classe de postes de travail et de domaine. v Définitions d utilisateurs. v Un ensemble complet de calendriers, de paramètres, d invites ou de ressources. Remarques La commande replace ressemble à la commande add mais elle n affiche aucune invite pour le remplacement des objets existants. Pour plus d informations, voir «add», à la page 68. Exemples Pour remplacer les travaux du fichier myjobs, exécutez la commande suivante : replace myjobs Pour remplacer les flux de travaux du fichier mysked, exécutez la commande suivante : rep mysked Pour remplacer toutes les ressources par celles du fichier myres, exécutez la commande suivante : rep myres 86 IBM Tivoli Workload Scheduler - Guide de référence

111 system command Exécute une commande système. Syntaxe [:!] commande-sys Arguments commande-sys Désigne une commande système valide. Le préfixe deux-points (:) ou le point d exclamation (!) sont requis uniquement lorsque la commande est orthographiée comme une commande Composer. Exemples Pour exécuter une commande ps sur UNIX, exécutez la commande suivante : ps -ef Pour exécuter une commande dir sur Windows, exécutez la commande suivante : dir \bin Chapitre 3. Référence au programme Composer 87

112 validate Permet de valider un fichier contenant des objets de planification. Syntaxe validate nom_fichier[;syntax] Arguments nom_fichier Désigne le nom d un fichier qui contient des calendriers, des postes de travail, des classes de postes de travail, des domaines, des travaux, des paramètres, des invites, des ressources ou des flux de travaux. Entrez prodsked pour valider le fichier du plan de production créé lors de la phase de préproduction. syntax Détecte les erreurs de syntaxe dans le fichier. Remarques La commande validate contrôle et valide la syntaxe de la même façon que lors de l ajout ou de la modification d objets. Elle permet de valider le fichier du plan de production, prodsked, qui a été créé au cours de la phase de préproduction. Le fichier Prodsked contient les flux de travaux devant être exécutés un jour donné. Il peut être modifié avant le jour de traitement à l aide d un éditeur. La commande validate doit être utilisée dans ce contexte pour vérifier que le plan de production est encore valide. Si l option de syntaxe a été omise pour les flux de travaux, la validation et l édition d état comprennent les opérations ci-dessous. v Vérification des noms de travaux par rapport au fichier de travail maître. v Examen des dépendances pour vérifier que les objets existent. Par exemple, ce contrôle permet de détecter une dépendance de type needs sur une ressource inexistante. Cette opération recherche également les références à des calendriers qui n existent pas. v Recherche des dépendances en boucle. Par exemple, si job1 suit job2 et si job2 suit job1, il existe une dépendance en boucle. La sortie de la commande validate peut être redirigée vers un fichier de la manière suivante : composer "validate filename" > outfile Pour insérer des messages d erreur dans le fichier de sortie, utilisez la commande suivante : composer "validate filename" > outfile 2>&1 Exemples Pour vérifier la syntaxe d un fichier contenant les définitions de poste de travail, exécutez la commande suivante : validate mycpus;syntax Pour revalider tous les flux de travaux, exécutez la commande suivante : create allskeds from sched=@#@ validate allskeds Grâce à cette commande, vous pouvez vérifier l intégrité des références sur les autres objets de planification après toute modification. 88 IBM Tivoli Workload Scheduler - Guide de référence

113 version Affiche la bannière du programme de ligne de commande Composer. Syntaxe version Exemples Pour afficher la bannière du programme de ligne de commande Composer, exécutez la commande suivante : version ou : v Chapitre 3. Référence au programme Composer 89

114 90 IBM Tivoli Workload Scheduler - Guide de référence

115 Chapitre 4. Langage de planification Le présent chapitre explique comment créer un flux de travaux selon les objets de planification définis dans la base de données, à l aide du programme de ligne de commande Composer. Les flux de travaux ainsi créés par l interface graphique ne font pas référence aux mots clés répertoriés dans le présent chapitre, mais tous les flux de travaux du planificateur sont sauvegardés à l aide des mêmes syntaxe et mots clés du langage de planification. Le présent chapitre détaille les points suivants : v Syntaxe des flux de travaux v Description des mots clés Syntaxe des flux de travaux La structure d un flux de travaux avec des mots clés en gras est décrite ci-après. Un flux de travaux commence avec un mot clé schedule suivi par des attributs et des dépendances. Le délimiteur introduit les travaux composant le flux. Chaque travail possède ses attributs et dépendances. schedule [cpu#]plan [freedays Nom_Calendrier [-sa] [-su] ] on {date jour calendrier demande}[,...] [fdignore fdnext fdprev] [on {date jour calendrier demande}[,...] [fdignore fdnext fdprev]] [,...] [deadline heure [timezone tz fuseau_horaire][+n day[s] [,...] [except{date jour calendrier}[,...] [fdignore fdnext fdprev] ] [,...] [at heure[timezone tz fuseau_horaire][+ n day [s] ] ] [,...] [carryforward] [follows { [cpu#] pgm [. travail] [,...] } ] [keysched] [limit nombre] [needs ressource] [opens fichier] [priority nombre] [prompt nom texte] [until heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action] : instruction-travail [at heure[timezone tz fuseau_horaire][+ n day [s] ] ] [,...] [confirmed] [deadline heure [timezone tz fuseau_horaire][+n day[s] [,...] [every fréquence] [follows travail flux_travaux] [keyjob] [needs ressource] [opens fichier] [priority nombre] [prompt nom texte] [until heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action] [instruction-travail...] end Copyright IBM Corp. 1999,

116 Ne tentez pas d écrire plusieurs flux de travaux sur une même ligne car ils seront rejetés par la commande schedulr alors que Composer les aura, semble-t-il, acceptés. Par exemple, si vous écrivez l agenda suivant sur une même ligne : SCHEDULE cbdbu01#nn_cbcid1001ys31 ON CBZZ0001 PRIORITY 10 FOLLOWS cbdbu02#nn_cbtnd :cbdbu01#jn_cbcid1001ys1ga1 PRIORITY 10 OPENS "/ st01/st01if/in/cubcifys1ga1001.dat.ok" le programme génère une erreur dès que la commande schedulr traite l agenda. Dans cet exemple, vous devez exécuter l une des procédures suivantes : v Utilisez le programme Composer pour : 1. Créer un nom de fichier via la commande schedule=cbdbu01#nn_cbcid1001ys31 (ou tous les agendas définis selon cette méthode). 2. Exécuter la commande composer add nom_fichier v Divisez l agenda comme suit : SCHEDULE cbdbu01#nn_cbcid1001ys31 ON CBZZ0001 PRIORITY 10 FOLLOWS cbdbu02#nn_cbtnd :cbdbu01#jn_cbcid1001ys1ga1 PRIORITY 10 OPENS "/st01/st01if/in/cubcifys1ga1001.dat.ok" Mots clés Le tableau suivant contient une brève description des mots clés du langage de planification. Mot clé Description Page at Heure à laquelle l exécution du flux de travaux ou du travail a été lancée. carryforward Reporte le flux de travaux lorsque celui-ci n est pas terminé. comments Inclut des commentaires dans une définition de flux de travaux. confirmed Indique qu une confirmation de l état d achèvement du travail est nécessaire. deadline Indique le temps nécessaire pour l achèvement d un travail ou d un flux de travaux. «at», à la page 94 «carryforward», à la page 96 «comments», à la page 97 «confirmed», à la page 98 «deadline», à la page 99 end Marque la fin d un flux de travaux. «end», à la page 100 every Lance le travail de manière répétitive à une fréquence précise. except Spécifie les dates où le flux de travaux ne sera pas exécuté. follows Indique quel travail ou flux de travaux doit être retenu avant l achèvement d autres travaux ou flux de travaux. freedays Indique un calendrier des jours chômés pour le calcul des jours ouvrés correspondant au flux de travaux. Les samedis et dimanches peuvent également être définis comme jours ouvrés. job statement Définit un travail et les dépendances qui lui sont associées. «every», à la page 101 «except», à la page 102 «follows», à la page 105 «freedays», à la page 106 «job statement», à la page IBM Tivoli Workload Scheduler - Guide de référence

117 Mot clé Description Page keyjob Qualifie un travail comme étant clé ou critique dans la base de données et dans le plan journalier, afin qu il soit surveillé par différentes applications, notamment IBM Tivoli Business Systems Manager ou Tivoli Enterprise Console. keysched Qualifie un flux de travaux comme étant clé ou critique dans la base de données et dans le plan journalier, afin qu il soit surveillé par différentes applications, notamment IBM Tivoli Business Systems Manager ou Tivoli Enterprise Console. limit Définit le nombre maximal de travaux qui peuvent être lancés simultanément à partir de ce flux de travaux. needs Définit le nombre d unités d une ressource requises par ce travail ou ce flux de travaux pour que celui-ci puisse être lancé. «keyjob», à la page 114 «keysched», à la page 115 «limit», à la page 116 «needs», à la page 117 on Définit les dates d exécution du flux de travaux. «on», à la page 118 opens Définit les ressources qui doivent être disponibles avant le lancement d un travail ou d un flux de travaux. priority Définit la priorité d un travail ou d un flux de travaux. prompt Définit les invites qui doivent avoir reçu une réponse pour que le travail ou le flux de travaux puisse être lancé. «opens», à la page 121 «priority», à la page 123 «prompt», à la page 124 schedule Attribue un nom au flux de travaux. «schedule», à la page 125 until Définit une heure après laquelle ce travail ou ce flux de travaux ne sera pas lancé. «until», à la page 126 Dépendances Une dépendance est une condition devant être remplie pour permettre le lancement d un travail ou d un flux de travaux. Elles sont associées aux flux de travaux à l aide des mots clés follows, needs, opens et prompt. Le nombre maximal de dépendances admis pour un travail ou un flux de travaux est fixé à 40. Distinction Description des mots clés Remarque : La seule dépendance à être vérifiée immédiatement avant exécution est NEEDS. Une dépendance OPENS est automatiquement considérée comme étant résolue avant l exécution du travail. majuscules/minuscules Vous pouvez utiliser indifféremment des majuscules ou des minuscules lorsque vous écrivez vos agendas (sauf pour les noms de chemin, les noms utilisateur et les commandes UNIX, qui distinguent les majuscules des minuscules). La syntaxe pour les mots clés du langage de planification est décrite ci-après. Chapitre 4. Langage de planification 93

118 at Définit l heure au plus tôt à laquelle un travail ou un flux de travaux est lancé. Syntaxe at heure [timezone tz fuseau_horaire][+n day[s]] [,...] Arguments heure Indique une heure. Les valeurs admises sont comprises entre 0000 et fuseau_horaire Indique le fuseau horaire à utiliser lors du calcul de l heure de début. Pour plus d informations sur les noms de fuseau horaire, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. Il s agit par défaut du fuseau horaire correspondant au poste de travail sur lequel le travail ou le flux de travaux est lancé. Remarque : Si des heures at et until sont indiquées, les fuseaux horaires doivent être identiques. n Indique un décalage, en jours, à partir de la date et de l heure de début planifiées. Remarques Si l heure n est pas spécifiée à l aide du mot clé at pour un travail ou un flux de travaux, le lancement sera déterminé par ses dépendances et sa priorité. La valeur de temps dans l option at est considérée comme suit : Si la valeur de temps est inférieure à l heure courante, elle est prise en compte pour le jour suivant. Si la valeur de temps est supérieure à l heure courante, elle est prise en compte pour le jour courant. Si vous indiquez une valeur de temps supérieure à 2400, elle est divisée par 2400 pour obtenir le nombre de jours. Si vous indiquez des jours, ceux-ci sont ajoutés à la valeur obtenue après division par Exemples Dans les exemples suivants, on considère que la journée de traitement IBM Tivoli Workload Scheduler commence à 6 heures du matin. v Comme le flux de travaux suivant doit être exécuté tous les mardis, il est lancé au plus tôt le mercredi à 3 heures du matin. Les deux travaux qu il contient sont lancés dès que possible après cette heure. schedule sked7 on tu at 0300: job1 job2 end v Le fuseau horaire du poste de travail sfran correspond à l heure du pacifique (pst) et le fuseau horaire du poste de travail nycity correspond à l heure de la côte Est (est). Le flux de travaux suivant est sélectionné à des fins d exécution le vendredi. Il est lancé sur le poste de travail sfran à 10 heures du matin pst le samedi. Le travail job1 est lancé sur sfran dès que possible après cette heure. Le travail job2 est lancé sur sfran à 14 heures est (11 heures du matin pst) le samedi. Quant au travail job3, il est lancé sur le poste de travail nycity à 16 heures est (13 heures pst) le samedi. 94 IBM Tivoli Workload Scheduler - Guide de référence

119 sfran#schedule sked8 on fr at day: job1 job2 at 1400 tz est nycity#job3 at 1600 end Chapitre 4. Langage de planification 95

120 carryforward Autorise le report d un flux de travaux au plan de production du lendemain, s il n est pas terminé avant la fin du plan de production de la journée en cours. Syntaxe carryforward Exemples Le flux de travaux suivant est reporté si les travaux qu il contient ne sont pas terminés avant le début du processus de préproduction de la journée suivante. schedule sked43 on th carryforward : job12 job13 job13a end 96 IBM Tivoli Workload Scheduler - Guide de référence

121 comments Inclut des commentaires dans une définition de flux de travaux. Syntaxe *texte <<texte>> Arguments *texte Insère une ligne de commentaire. Le premier caractère de la ligne doit être un astérisque. <<texte>> Insère un commentaire sur une ligne. Le texte doit être placé entre chevrons doubles. Exemples L exemple suivant inclut les types de commentaires : **************************************** * Travaux de nettoyage hebdomadaires **************************************** * schedule wkend on fr at 1830 carryforward : job1 <<totaux et rapports définitifs>> job2 <<mise à jour de la base de données>> end Chapitre 4. Langage de planification 97

122 confirmed Indique que la fin d un travail doit être confirmée à l aide d une commande confirm de Conman. Pour plus d informations, voir «confirm», à la page 161. Syntaxe confirmed Exemples Dans le flux de travaux suivant, la confirmation de la fin du travail job1 doit être reçue avant le lancement de job2 et de job3. schedule test1 on fr: job1 confirmed job2 follows job1 job3 follows job1 end 98 IBM Tivoli Workload Scheduler - Guide de référence

123 deadline Indique le temps nécessaire pour l achèvement d un travail ou d un flux de travaux. Les travaux et flux de travaux qui n ont pas encore démarrés ou qui sont encore en cours d exécution à expiration de la date d échéance sont considérés comme étant en retard dans le plan. Lorsque un travail (ou flux de travaux) est en retard, les actions suivantes sont exécutées : v Le travail apparaît comme étant en retard dans Conman et Job Scheduling Console. v Le programme envoie un événement à Tivoli Enterprise Console et IBM Tivoli Business Systems Manager. v Un message est envoyé aux journaux de stdlist et console. Syntaxe deadline heure [timezone tz fuseau_horaire][+n day[s] [,...] Arguments heure Indique une heure. Les valeurs admises sont comprises entre 0000 et fuseau_horaire Indique le fuseau horaire à utiliser lors du calcul de l heure d échéance. Pour plus d informations sur les noms de fuseau horaire, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. Il s agit par défaut du fuseau horaire correspondant au poste de travail sur lequel le travail ou le flux de travaux est lancé. n Indique un décalage en jours à partir de l heure d échéance planifiée. Exemples L exemple suivant lance le flux de travaux sked7 chaque jour ainsi que le travail jobc. Ils doivent démarrer à 14h30 et être terminés à 16h00. schedule sked7 on everyday : jobc at 1430 deadline 1600 end Chapitre 4. Langage de planification 99

124 end Signale la fin d une définition de flux de travaux. Syntaxe end Exemples schedule test1 on monthend : job1 job2 job3 end << end of job stream >> 100 IBM Tivoli Workload Scheduler - Guide de référence

125 every Définit la fréquence de répétition d un travail. Le travail est lancé de façon répétitive selon la fréquence indiquée. Si le travail a une dépendance qui n est pas satisfaite, l itération n aura lieu qu une fois la dépendance satisfaite. Syntaxe every fréquence Arguments fréquence Fréquence de répétition exprimée en heures et en minutes, au format hhmm (elle peut être supérieure à 24 heures). Remarques Malgré la fin anomale d un travail EVERY, l itération continue. Si vous avez utilisé l option EVERY avec la dépendance AT, le travail lance les travaux selon des heures spécifiques. Si une réexécution est différée (en raison d une dépendance ou autre), IBM Tivoli Workload Scheduler se réaligne à l heure AT. Dans ce cas, une ou plusieurs itérations risquent de ne pas respecter la fréquence EVERY. Si vous avez utilisé l option EVERY sans dépendance AT, les travaux réexécutés seront planifiés selon la fréquence EVERY définie, à partir de l heure de démarrage réel du travail. En outre, certaines interactions risquent de ne pas respecter la fréquence IF AND ONLY IF vous avez utilisé l option EVERY avec la dépendance AT. Dans tous les autres cas, la fréquence CHAQUE est toujours respectée. Exemples Dans l exemple suivant, le travail testjob est exécuté toutes les heures : testjob every 100 Dans l exemple suivant, le travail testjob1 est exécuté toutes les 15 minutes entre 18 et 20 heures : testjob1 at 1800 every 15 until 2000 Le travail sera exécuté à 18:00, 18:15, 18:30, etc. Si le travail est soumis adhoc à 18:33, il sera réexécuté à 18:33, 18:34, 18:45, etc. L exemple suivant ne démarre pas l itération du travail testjob2 tant que le travail testjob1 n a pas abouti. testjob2 every 15 follows testjob1 Chapitre 4. Langage de planification 101

126 except Définit les dates qui constituent des exceptions par rapport aux dates définies par le mot clé on d un flux de travaux. Pour plus d informations, voir «on», à la page 118. Syntaxe except {date jour calendrier } [fdignore fdnext fdprev][,...] [except {date jour calendrier }] [fdignore fdnext fdprev][,...]] Arguments date Indique une date au format mm/jj/aa. jour Jour de la semaine. Indiquez un ou plusieurs des éléments suivants : mo Lundi tu Mardi we Mercredi th Jeudi fr Vendredi sa Samedi su Dimanche weekdays N importe quel jour de la semaine sauf le samedi et le dimanche. workdays Il peut s agir de l un des cas suivants : v Si vous avez indiqué un calendrier des jours chômés, les jours ouvrés sont tous les jours sauf le samedi et le dimanche (à moins que vous n ayez précisé -sa ou -su avec le mot clé freedays) et toutes les dates du calendrier des jours chômés précisé. v Si vous n avez pas précisé de calendrier des jours chômés, les jours ouvrés sont tous les jours sauf le samedi et le dimanche et toutes les dates figurant sur le calendrier des jours fériés. freedays Jours figurant sur le calendrier des jours chômés, si vous en avez indiqué un. calendrier Dates indiquées dans un calendrier portant ce nom. Le nom du calendrier peut être suivi d un décalage au format suivant : {+ -}n {day[s] weekday[s] workday[s]} Où : n Indique le nombre de jours, jours de la semaine ou jours ouvrés. days Inclut tous les jours de la semaine. weekdays Inclut tous les jours de la semaine sauf le samedi et le dimanche. workdays Inclut tous les jours de la semaine excepté les samedis et dimanches (sauf indication contraire par le mot clé freedays) et les dates figurant sur un calendrier désigné des jours chômés ou des jours fériés. 102 IBM Tivoli Workload Scheduler - Guide de référence

127 règle des jours chômés Indique une règle qui doit être appliquée lorsque la date devant être exclue correspond à un jour chômé. Il peut s agir de l un des cas suivants : fdignore La date n est pas exclue. fdnext Le jour ouvré le plus proche suivant le jour chômé est exclu. fdprev Le jour ouvré le plus proche précédant le jour chômé est exclu. Remarques Vous pouvez définir plusieurs instances du mot clé except pour le même flux de travaux. Chaque instance correspond à un cycle d exécution auquel vous pouvez associer une règle de jour chômé. Si une définition de flux de travaux contient plusieurs instances except, celles-ci doivent être consécutives. Chaque instance du mot clé doit contenir l une des valeurs autorisées par la syntaxe except. Exemples Dans l exemple suivant, le flux de travaux testskd2 est sélectionné pour être exécuté tous les jours de la semaine, à l exception des dates figurant dans les calendriers intitulés monthend et holidays : schedule testskd2 on weekdays except monthend,holidays Dans l exemple suivant, le flux de travaux testskd3 est sélectionné pour être exécuté tous les jours de la semaine à l exception du 15 mai 1999 et du 23 mai 1999 : schedule testskd3 on weekdays except 05/15/99,05/23/99 Dans l exemple suivant, le flux de travaux testskd4 est sélectionné pour être exécuté tous les jours sauf pendant les deux jours précédant toute date figurant dans un calendrier intitulé monthend : schedule testskd4 on everyday except monthend-2 weekdays Sélectionnez le flux de travaux sked4 de sorte qu il s exécute les lundis, mardis et 2 jours de semaine avant chaque date répertoriée dans le calendrier MONTHEND. Si la date d exécution correspond à un jour chômé, exécutez le flux de travaux le jour ouvré suivant le plus proche. N exécutez pas le flux de travaux le mercredi. schedule sked4 on mo on tu, MONTHEND -2 weekdays fdnext except we Chapitre 4. Langage de planification 103

128 Sélectionnez le flux de travaux testskd2 pour qu il s exécute chaque jour de la semaine sauf les jours répertoriés dans le calendrier MONTHEND. Si une date figurant dans le calendrier MONTHEND correspond à un jour chômé, excluez le jour de semaine le plus proche précédant cette date. Dans cet exemple, les jours chômés sont les samedis, les dimanches et toutes les dates répertoriées dans le calendrier des jours fériés par défaut. schedule testskd2 on weekdays except MONTHEND fdprev 104 IBM Tivoli Workload Scheduler - Guide de référence

129 follows Définit les autres travaux et flux de travaux qui doivent aboutir avec le lancement d un travail ou d un flux de travaux. Syntaxe Utilisez la syntaxe suivante pour les flux de travaux : Utilisez la syntaxe suivante pour les travaux : nom_travail [,...] Arguments agent_réseau Nom de l agent réseau dans lequel la dépendance interréseau est définie. poste_travail Poste de travail sur lequel s exécute le travail ou le flux de travaux qui doit aboutir. Par défaut, il s agit du même poste de travail que le travail ou le flux de travaux dépendant. Si aucun poste de travail n est spécifié avec l agent réseau, le poste de travail auquel l agent réseau est connecté est utilisé par défaut. flux_travaux Nom du flux de travaux qui doit aboutir. Pour un travail, il s agit par défaut du même flux de travaux que le travail dépendant. nom_travail Nom du travail qui doit aboutir. Vous pouvez utiliser un arrobas (@) pour indiquer que tous les travaux du flux de travaux doivent aboutir. Exemples L exemple suivant indique que le flux de travaux skedc ne doit pas être lancé tant que le flux de travaux sked4 sur le poste de travail site1 et le travail joba du flux de travaux sked5 sur le poste de travail site2 n ont pas abouti : schedule skedc on fr follows site1#sked4,site2#sked5.joba Ne lancez pas sked6 tant que le travail jobx du flux de travaux skedx sur le réseau distant cluster4 n a pas abouti : sked6 follows cluster4::site4#skedx.jobx L exemple suivant indique que le travail jobd ne doit pas être lancé tant que le travail joba du même flux de travaux et le travail job3 du flux de travaux skeda n ont pas abouti : jobd follows joba,skeda.job3 L exemple suivant indique que le travail jobe ne doit pas être lancé tant que tous les travaux du flux de travaux skedb sur le poste de travail unix1 n ont pas abouti : jobe follows unix1#skedb.@ Chapitre 4. Langage de planification 105

130 freedays Permet d indiquer le nom d un calendrier des jours chômés (consultez le guide d utilisation pour une description de ce type de calendrier) qui répertorie les jours où le flux de travaux ne doit pas être exécuté. Tivoli Workload Scheduler utilise ce type de calendrier comme calendrier de base pour calculer les jours ouvrés pour le flux de travaux. Le mot clé affecte uniquement la planification des flux de travaux pour lesquels il est indiqué. Syntaxe freedays Nom_Calendrier [-sa] [-su] Arguments Nom_Calendrier Nom du calendrier devant être utilisé comme calendrier des jours chômés pour le flux de travaux. Si Nom_Calendrier ne se trouve pas dans la base de données, Tivoli Workload Scheduler génère un message d erreur lorsque vous sauvegardez le flux de travaux. Si Nom_Calendrier ne se trouve pas dans la base de données lorsque le planificateur s exécute, Tivoli Workload Scheduler génère un message d erreur et utilise le calendrier par défaut des jours fériés à la place. N utilisez pas les noms des jours de la semaine pour nommer un calendrier. -sa Considère le samedi comme un jour ouvré. -su Considère le dimanche comme un jour ouvré. Remarques Si vous ne précisez pas de calendrier des jours chômés dans la définition du flux de travaux, le mot clé workdays prend la valeur suivante : workdays = tous les jours sauf samedi et dimanche (à moins que l utilisateur n ait indiqué -sa ou -su avec freedays) et toutes les dates associées à Nom_Calendrier. Si vous ne précisez pas freedays dans la définition du flux de travaux, alors : jours ouvrés = tous les jours sauf samedi et dimanche et toutes les dates figurant sur le calendrier des jours fériés. Par défaut, le samedi et le dimanche sont considérés comme jours chômés, sauf si vous indiquez le contraire en ajoutant -sa et/ou -su après Nom_Calendrier. Exemples Sélectionnez le flux de travaux sked2 pour qu il s exécute le 01/01/2001 ainsi que tous les jours ouvrés ne figurant pas sur le calendrier des jours chômés nommé GERMHOL. schedule sked2 freedays GERMHOL on 01/01/2001, workdays Sélectionnez le flux de travaux sked3 pour qu il s exécute deux jours ouvrés avant chaque date du calendrier PAYCAL. Les jours ouvrés incluent tous les jours de la semaine, du lundi au samedi, non répertoriés dans le calendrier des jours chômés nommé USAHOL. schedule sked3 freedays USAHOL -sa on PAYCAL -2 workdays 106 IBM Tivoli Workload Scheduler - Guide de référence

131 Sélectionnez le flux de travaux sked3 pour les dates répertoriées dans le calendrier APDATES. Si une date sélectionnée correspond à un jour chômé, n exécutez pas le flux de travaux. Dans le présent exemple, les dimanches et toutes les dates répertoriées dans le calendrier GERMHOL sont considérés comme jours chômés. A l exception des dates spécifiques répertoriées dans GERMHOL, tous les jours de la semaine du lundi au samedi sont des jours ouvrés. schedule sked3 freedays GERMHOL -sa on APDATES fdignore Sélectionnez le flux de travaux testsked3 pour qu il s exécute chaque jour de la semaine sauf le 15/5/2002 et le 23/5/2002. Si le 23/5/2002 correspond à un jour chômé, ne l excluez pas. Dans le présent exemple, les samedis, dimanches et toutes les dates répertoriées dans GERMHOL doivent être considérés comme jours chômés. A l exception des dates spécifiques répertoriées dans GERMHOL, tous les jours de la semaine du lundi au vendredi sont des jours ouvrés. schedule testskd3 freedays GERMHOL on weekdays except 5/15/2002 fdignore except 5/23/2002 Sélectionnez le flux de travaux testsked4 pour qu il s exécute tous les jours sauf 2 jours de semaine avant chaque date répertoriée dans le calendrier MONTHEND. Si la date à exclure correspond à un jour chômé, ne l excluez pas, mais excluez le jour ouvré suivant le plus proche. Dans l exemple suivant, les jours chômés correspondent à toutes les dates répertoriées dans USAHOL, tandis que les jours ouvrés sont tous les jours de la semaine du lundi au dimanche ne figurant pas dans USAHOL. schedule testskd4 freedays USAHOL -sa -su on everyday except MONTHEND -2 weekdays fdnext Chapitre 4. Langage de planification 107

132 job statement Les instructions de travail placent des travaux dans un flux de travaux et définissent des dépendances sur les travaux. Dans une instruction de travail, vous pouvez également inclure des attributs de travail et des options de reprise qui ajoutent un nouveau travail ou modifient un travail existant de la base de données. Pour plus d informations, voir Remarques. Syntaxe [poste_travail#]nom_travail [description texte ] [scriptname nom_fichier docommand ligne_de_commande ] [streamlogon nom_utilisateur] [interactive] [rccondsucc Condition de succès ] [recovery {stop continue rerun} [after [poste_travail#]nom_travail] [abendprompt texte ] ] [dépendance-travail [,...]] Arguments poste_travail Indique le nom du poste de travail ou de la classe de postes de travail sur lequel le travail est exécuté. Par défaut, le poste de travail sur lequel le flux de travaux s exécute est utilisé. Le signe dièse (#) est un délimiteur obligatoire. Si une classe de postes de travail est indiquée, celle-ci doit correspondre à la classe de postes de travail d un flux de travaux contenant le travail. nom_travail Indique le nom du travail. Ce nom doit commencer par une lettre et peut contenir des caractères alphanumériques, des tirets et des traits de soulignement. Il peut comporter jusqu à 40 caractères. Remarque : N utilisez pas le mot recovery pour le nom du travail. Il s agit d un mot réservé. description Description du travail en format libre placée entre guillemets. scriptname nom_fichier Indique le nom du fichier exécuté par le travail. Utilisez le mot clé scriptname pour exécuter les travaux UNIX et Windows. Pour un fichier exécutable, entrez le nom du fichier et les éventuels arguments et options. La longueur du nom_fichier additionnée à la longueur de la Condition de succès (du mot clé rccondsucc) ne doit pas dépasser 4095 caractères. Vous pouvez également utiliser des paramètres IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Utilisation des paramètres dans les définitions de travail», à la page 112. Dans le cas des travaux Windows, ajoutez les extensions de fichier. Les noms UNC sont admis. N indiquez pas de fichiers sur les unités mappées. Si des espaces ou des caractères spéciaux autres que les barres obliques (/) et les barres obliques inversées (\) sont inclus, la chaîne entière doit être placée entre guillemets ( ). 108 IBM Tivoli Workload Scheduler - Guide de référence

133 Si le nom du fichier comporte des espaces, entrez ce nom dans un autre fichier dont le nom ne comporte pas d espaces, puis utilisez le nom du deuxième fichier pour cet argument. docommand commande Indique une commande exécutée par le travail. Entrez une commande valide et les éventuels arguments et options placés entre guillemets ( ). La longueur de la commande additionnée à la longueur de la Condition de succès (du mot clé rccondsucc) ne doit pas dépasser 4095 caractères. La commande est exécutée directement et le script de configuration jobmanrc n est pas exécuté, contrairement au mot clé scriptname. Par ailleurs, la commande est traitée sous forme de travail et toutes les règles relatives aux travaux s appliquent. Vous pouvez également utiliser des paramètres IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Utilisation des paramètres dans les définitions de travail», à la page 112. streamlogon interactive Sur les agents FTA Windows, les travaux échouent si le chemin du script/programme à exécuter contient un blanc. Par exemple, l instruction CMD.EXE /C "C:\PROGRAM FILES\CCR\CCR_CONSOLIDATE.BAT" échoue et le programme génère le message suivant : The name specified is not recognized as an internal or external command, operable program or batch file. car il ne parvient pas à gérer les blancs dans ce contexte. Nom d utilisateur sous lequel le travail s exécute. Ce nom peut comporter jusqu à 47 caractères. Si ce nom comporte des caractères spéciaux, il doit être placé entre guillemets ( ). Indiquez un utilisateur qui peut se connecter au poste de travail sur lequel le travail s exécute. Vous pouvez également utiliser des paramètres IBM Tivoli Workload Scheduler. Pour plus d informations, voir «Utilisation des paramètres dans les définitions de travail», à la page 112. Dans le cas de travaux Windows, l utilisateur doit également posséder une définition d utilisateur. Pour obtenir des informations relatives aux besoins de l utilisateur, voir «Définitions d utilisateur», à la page 54. Dans le cas de travaux Windows, rajoutez ce mot clé pour indiquer que le travail sera exécuté de manière interactive sur le bureau Windows. Chapitre 4. Langage de planification 109

134 rccondsucc Condition de succès Expression qui détermine le code retour (RC) requis pour considérer qu un travail est réussi. La longueur maximale de la condition de succès doit être de 256 caractères. Cette expression peut être une combinaison d expressions de comparaison et d expressions booléennes : Expression de comparaison Indique les codes retour des travaux. La syntaxe est : (RC opérateur opérande) RC Mot clé RC. opérateur Opérateur de comparaison. Il peut prendre l une des valeurs suivantes : Tableau 9. Opérateur de comparaison Exemple Opérateur Description RC<a < Inférieur à RC<=a <= Inférieur ou égal à RC>a > Supérieur à RC>=a >= Supérieur ou égal à RC=a = Egal à RC!=a!= Différent de RC<>a <> Différent de opérande Un entier entre et Par exemple, vous pouvez définir un travail réussi comme un travail qui termine par un code retour inférieur ou égal à 3. Exemple : rccondsucc "(RC <= 3)" Expression booléenne Indique une combinaison logique d expressions de comparaison. La syntaxe est : expression_de_comparaison opérateur expression_de_comparaison expression_de_comparaison Cette expression est analysée de gauche à droite. Vous pouvez utiliser des parenthèses pour attribuer une priorité à l évaluation de l expression. 110 IBM Tivoli Workload Scheduler - Guide de référence

135 opérateur Opérateur logique. Il peut prendre l une des valeurs suivantes : Tableau 10. Opérateurs logiques Exemple Opérateur Résultat expr_a and expr_b And TRUE si expr_a ET expr_b sont VRAIES. expr_a or expr_b Or TRUE si expr_a OU expr_b est VRAIE. Not expr_a Not TRUE si expr_a n est PAS VRAIE. recovery Par exemple, vous pouvez définir un travail réussi comme un travail qui termine par un code retour inférieur ou égal à 3 ou par un code retour différent de 5 et inférieur à 10. Exemple : rccondsucc "(RC=3) OR ((RC>=5) AND (RC<10))" Options de reprise du travail. La valeur par défaut est stop sans aucun travail de reprise et aucune invite de reprise. Entrez l une des options de reprise suivantes : stop, continue ou rerun. Elle peut être suivie d un travail de reprise et/ou d une invite de reprise. stop En cas de fin anormale du travail, le traitement ne se poursuit pas avec le travail suivant. continue En cas de fin anormale du travail, le traitement se poursuit avec le travail suivant. rerun En cas de fin anormale, le travail est réexécuté. after [poste_travail#]nom_travail Indique le nom d un travail de reprise à lancer si le travail parent prend fin de façon anormale. Les travaux de reprise ne sont lancés qu une seule fois pour chaque instance du travail parent qui prend fin de façon anormale. Vous pouvez indiquer le poste du travail de reprise s il est différent du poste du travail parent. Par défaut, il s agit du poste du travail parent. Tous les travaux ne remplissent pas les conditions nécessaires pour permettre l exécution de travaux de reprise sur un poste de travail différent. Suivez les instructions ci-après : v Si un des postes de travail correspond à un agent étendu, il doit être hébergé par un gestionnaire de domaine ou un agent à tolérance de pannes, dont la valeur du mode fullstatus est on. v Le poste du travail de reprise doit se trouver dans le même domaine que le poste du travail parent. v Si le poste du travail de reprise correspond à un agent à tolérance de pannes, la valeur du mode fullstatus de cet agent doit être on. Chapitre 4. Langage de planification 111

136 abendprompt texte Indique le texte d une invite de reprise, figurant entre guillemets, qui doit être affiché dans le cas d une fin anormale du travail. Ce texte peut comporter jusqu à 64 caractères. S il commence par un signe deux-points (:), l invite s affiche mais aucune réponse n est requise pour la poursuite du processus. Si le texte commence par un signe d exclamation (!), l invite ne s affiche pas mais une réponse est requise pour la poursuite du traitement. dépendance-travail Indique les mots clés et les arguments de planification. Les mots clés valides pour les travaux sont les suivants : at, confirmed, every, follows, needs, opens, priority, prompt et until. Utilisation des paramètres dans les définitions de travail : Les utilisations et restrictions suivantes s appliquent aux paramètres des définitions de travail : v Les paramètres sont admis dans les valeurs streamlogon, scriptname et docommand. v Un paramètre peut correspondre à une chaîne entière ou partielle. v Plusieurs paramètres sont admis dans une seule variable. v Les noms de paramètres doivent figurer entre carets (^) et la chaîne entière entre guillemets. Voir l exemple ci-dessous dans lequel un paramètre intitulé mis est utilisé dans la valeur streamlogon. D autres exemples sont fournis dans la section «Définitions de paramètre», à la page 58. Remarques Un travail ne doit être défini qu une seule fois dans la base de données ; il peut ensuite être utilisé dans plusieurs flux de travaux. Lors de l ajout ou de la modification d un flux de travaux, les attributs ou les options de reprise de ses travaux sont également ajoutés ou modifiés. Lors de la définition des travaux, prenez en considération ce qui suit : v Les travaux peuvent être définis indépendamment (voir «Définitions de travail», à la page 47), ou dans le cadre des flux de travaux. Dans l un ou l autre cas, les modifications sont apportées dans la base de données et n ont pas d incidence sur le plan de production jusqu au début d une nouvelle journée de traitement. v Lors de l ajout ou du remplacement d un flux de travaux, les éventuelles modifications apportées aux travaux ont une incidence sur tous les autres flux de travaux qui utilisent les travaux. Il est à noter que le rapport de références croisées peut être utilisé pour déterminer les noms des flux de travaux qui contiennent un travail particulier. Exemples L exemple suivant définit un flux de travaux comportant trois travaux précédemment définis : schedule bkup on fr at 20:00: cpu1#jbk1 cpu2#jbk2 needs 1 tape cpu3#jbk3 follows jbk1 end 112 IBM Tivoli Workload Scheduler - Guide de référence

137 La définition de flux de travaux suivante contient des instructions de travail qui ajoutent ou modifient les définitions de deux travaux de la base de données : schedule sked4 on mo: job1 scriptname d:\apps\maestro\scripts\jcljob1 streamlogon jack recovery stop abendprompt continue production site1#job2 scriptname d:\apps\maestro\scripts\jcljob2 streamlogon jack follows job1 end Chapitre 4. Langage de planification 113

138 keyjob Le mot clé keyjob est utilisé pour indiquer qu un travail est clé ou critique dans la base de données et dans le plan journalier et qu il doit être surveillé par des applications telles que Tivoli Business Systems Manager. Pour savoir comment activer l indicateur de clé, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Exemples Voici un exemple : SCHEDULE cpu1#sched1 ON everyday KEYSCHED AT 0100 cpu1#myjob1 KEYJOB END 114 IBM Tivoli Workload Scheduler - Guide de référence

139 keysched Le mot clé keysched est utilisé pour indiquer qu un travail est clé ou critique dans la base de données et dans le plan journalier et qu il doit être surveillé par des applications telles que Tivoli Business Systems Manager. Pour savoir comment activer l indicateur de clé, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Syntaxe keysched Exemples Voici un exemple : SCHEDULE cpu1#sched1 ON everyday KEYSCHED AT 0100 cpu1#myjob1 KEYJOB END Chapitre 4. Langage de planification 115

140 limit Limite le nombre de travaux pouvant être exécutés simultanément dans un flux de travaux. Syntaxe limit limite_travail Arguments limite_travail Limite le nombre de travaux qui peuvent être exécutés simultanément dans un flux de travaux. Les valeurs admises sont comprises entre 0 et Si vous indiquez 0, vous empêchez le lancement de tous les travaux. Exemples Dans l exemple suivant, le nombre de travaux pouvant être exécutés simultanément dans le flux de travaux sked2 est limité à cinq : schedule sked2 on fr limit 5: 116 IBM Tivoli Workload Scheduler - Guide de référence

141 needs Définit les ressources qui doivent être disponibles avant le lancement d un travail ou d un flux de travaux. Syntaxe needs [n] [poste_travail#]nom_ressource [,...] Arguments n Indique le nombre d unités de ressources requises. Les valeurs admises sont comprises entre 0 et 32. Valeur par défaut : 1. Remarque : Le nombre de travaux et de planifications utilisant une ressource à n importe quelle heure ne peut dépasser 32. poste_travail Indique le nom du poste de travail sur lequel la ressource est définie localement. Par défaut, il s agit du poste du travail ou du flux de travaux dépendant. Les ressources ne peuvent être utilisées comme dépendances que par les travaux ou les flux de travaux qui sont exécutés sur le même poste de travail que la ressource. Cependant, un agent standard et son hôte peuvent faire référence aux mêmes ressources. nom_ressource Nom de la ressource Exemples Dans l exemple suivant, le lancement du flux de travaux sked3 est interdit tant que trois unités de CPUtime et deux unités de tapes ne sont pas disponibles : schedule sked3 on fr needs 3 cputime, 2 tapes : La ressource jlimit a été définie avec deux unités disponibles. Dans l exemple suivant, l exécution simultanée d un maximum de deux travaux est autorisée dans le flux de travaux sked4 : schedule sked4 on mo,we,fr: joba needs 1 jlimit jobb needs 1 jlimit jobc needs 2 jlimit <<runs alone>> jobd needs 1 jlimit end Chapitre 4. Langage de planification 117

142 on Il s agit d un mot clé de flux de travaux obligatoire qui définit le moment et la fréquence de sélection d un flux de travaux à des fins d exécution. Le mot clé on doit suivre le mot clé schedule. Pour plus d informations, voir «except», à la page 102. Syntaxe on {date jour calendrier demande}[,...] [fdignore fdnext fdprev][,...] [on {date jour calendrier demande}[,...] [fdignore fdnext fdprev]][,...] Arguments date Indique une date au format mm/jj/aa. jour Jour de la semaine. Vous pouvez indiquer un ou plusieurs des jours suivants : mo Lundi tu Mardi we Mercredi th Jeudi fr Vendredi sa Samedi su Dimanche weekdays N importe quel jour de la semaine sauf le samedi et le dimanche everyday Un jour de la semaine workdays Il peut s agir de l un des cas suivants : v Si vous avez indiqué un calendrier des jours chômés, les jours ouvrés sont tous les jours sauf le samedi et le dimanche (à moins que vous n ayez précisé -sa ou -su avec le mot clé freedays) et toutes les dates du calendrier des jours chômés précisé. v Si vous n avez pas précisé de calendrier des jours chômés, les jours ouvrés sont tous les jours sauf le samedi et le dimanche et toutes les dates figurant sur le calendrier des jours fériés. freedays Jours figurant sur le calendrier des jours chômés, si vous en avez indiqué un. calendrier Dates indiquées dans un calendrier portant ce nom. Le nom du calendrier peut être suivi d un décalage au format suivant : {+ -}n {day[s] weekday[s] workday[s]} Où : n Indique le nombre de jours, jours de la semaine ou jours ouvrés. days Inclut tous les jours de la semaine. weekdays Inclut tous les jours de la semaine sauf le samedi et le dimanche. 118 IBM Tivoli Workload Scheduler - Guide de référence

143 workdays Inclut tous les jours de la semaine excepté les samedis et dimanches (sauf indication contraire par le mot clé freedays) et les dates figurant sur un calendrier désigné des jours chômés ou des jours fériés. request Sélectionne le flux de travaux uniquement lorsque celui-ci est demandé. Ce paramètre est utilisé pour les flux de travaux qui sont sélectionnés par nom et non par date. Pour empêcher un flux de travaux planifié d être sélectionné pour le travail Jnextday, définissez sa définition sur A LA DEMANDE. Remarque : Si vous tentez d exécuter un flux de travaux contenant plusieurs heures à la demande, rappelez-vous les points suivants : v Les indicateurs A la demande ont la priorité sur les indicateurs à. v Les indicateurs A la demande n ont jamais la priorité sur les indicateurs sur. règle des jours chômés Indique une règle qui doit être appliquée lorsque la date sélectionnée correspond à un jour chômé. Il peut s agir de l un des cas suivants : fdignore Le flux de travaux n est pas exécuté. fdnext Le flux de travaux est exécuté le jour ouvré le plus proche suivant le jour chômé. fdprev Le flux de travaux est exécuté le jour ouvré le plus proche précédant le jour chômé. Remarques Vous pouvez définir plusieurs instances du mot clé on pour le même flux de travaux. Chaque instance correspond à un cycle d exécution auquel vous pouvez associer une règle de jour chômé. Si une définition de flux de travaux contient plusieurs instances on, celles-ci doivent être consécutives. Chaque instance du mot clé doit contenir l une des valeurs autorisées par la syntaxe on. Vous devez indiquer le mot clé on au moins une fois dans la définition d un flux de travaux. Exemples Dans l exemple suivant, le flux de travaux sked1 est sélectionné les lundis et les mercredis : schedule sked1 on mo,we Dans l exemple suivant, le flux de travaux sked3 est sélectionné le 15 juin 1999 et aux dates répertoriées dans le calendrier apdates : schedule sked3 on 6/15/99,apdates Chapitre 4. Langage de planification 119

144 Dans l exemple suivant, le flux de travaux sked4 est sélectionné deux jours avant chaque date figurant dans le calendrier monthend : schedule sked4 on monthend -2 weekdays Dans l exemple suivant, le flux de travaux testskd1 est sélectionné tous les jours de la semaine sauf les mercredis : schedule testskd1 on weekdays except we Dans l exemple suivant, le flux de travaux testskd3 est sélectionné tous les jours de la semaine à l exception des 15 et 24 mai 1999 : schedule testskd3 on weekdays except 05/16/99,05/24/99 Dans l exemple suivant, le flux de travaux testskd4 est sélectionné tous les jours sauf les deux jours précédant toute date figurant dans un calendrier intitulé monthend : schedule testskd4 on everyday except monthend -2 weekdays Sélectionnez le flux de travaux sked1 pour qu il s exécute les lundis et vendredis ainsi que le 29/12/2001. Si les lundis et le 29/12/2001 correspondent à des jours chômés, exécutez le flux de travaux le jour ouvré suivant le plus proche. Si les vendredis correspondent à des jours chômés, exécutez le flux de travaux le jour ouvré précédent le plus proche. Dans cet exemple, les jours chômés sont les samedis, les dimanches et toutes les dates répertoriées dans le calendrier HOLIDAYS par défaut. Les jours ouvrés incluent tous les jours de la semaine du lundi au vendredi ne figurant pas dans le calendrier HOLIDAYS. schedule sked1 on mo, 12/29/2001 fdnext on fr fdprev 120 IBM Tivoli Workload Scheduler - Guide de référence

145 opens Indique les fichiers qui doivent être disponibles avant le lancement d un travail ou d un flux de travaux. Syntaxe opens [poste_travail#] nom_fichier [(qualifiant)] [,...] Arguments poste_travail Indique le nom du poste de travail ou de la classe de postes de travail qui contient le fichier. Par défaut, il s agit du poste de travail ou de la classe de postes du travail du travail ou du flux de travaux dépendant. Si une classe de postes de travail est utilisée, celle-ci doit être identique à celle du flux de travaux qui contient cette instruction. nom_fichier Indique le nom du fichier, placé entre guillemets. Vous pouvez utiliser des paramètres IBM Tivoli Workload Scheduler dans tout ou partie de la chaîne de nom de fichier. Si un paramètre est utilisé, celui-ci doit être placé entre carets (^). A l exception des agents étendus, les noms de fichier doivent être complets sur tous les types de poste de travail. qualifiant Indique une condition de test valide. Sous UNIX, le programme communique le qualifiant à la commande test, qui est exécutée avec des droits root dans le répertoire bin/sh. Sous Windows, la fonction de test est exécutée avec des droits d utilisateur maestro. Les qualifiants acceptés sont les suivants : -d %p Si le fichier existe sous forme de répertoire. -e %p Si le fichier existe. -f %p Si le fichier existe en tant que fichier régulier. -r %p Si le fichier existe et est lisible. -s %p Si le fichier existe et que sa taille est supérieure à zéro. -w %p Si le fichier existe et qu il peut être écrit. Sous UNIX et Windows, l expression %p insère le nom du fichier. Entrer (notempty) équivant à entrer (-s %p). Si aucun qualifiant n est indiqué, ((-f %p) est utilisé par défaut. Remarques Combinaison entre le chemin de fichier et les qualifiants (limitée à 120 caractères) et le nom de fichier (limité à 28 caractères). Exemples L exemple suivant permet de vérifier, avant le lancement de ux2#sked6, que le fichier c:\users\fred\datafiles\file88 du poste de travail nt5 est accessible en lecture : schedule ux2#sked6 on tu opens nt5#"c:\users\fred\datafiles\file88" Chapitre 4. Langage de planification 121

146 L exemple suivant permet de vérifier, avant le lancement du travail jobr2, si les trois répertoires, /jean, /marie et /roger, existent : jobr2 opens "/users"(-d %p/jean -a -d %p/marie -a -d %p/roger) L exemple suivant permet de vérifier si cron a créé son fichier FIFO avant de lancer le travail job6 : job6 opens "/usr/lib/cron/fifo"(-p %p) L exemple suivant permet de vérifier, avant le lancement du travail jobt2, que le fichier d:\work\john\execit1 du poste de travail dev3 existe et qu il n est pas vide : jobt2 opens dev3#"d:\work\john\execit1"(notempty) L exemple suivant permet de vérifier, avant le lancement du travail job77, que le fichier c:\tech\checker\startf du poste de travail nyc existe, que sa taille est supérieure à zéro et qu il est accessible en écriture : job77 opens nyc#"c:\tech\checker\startf"(-s %p -a -w %p) Sécurité des commandes test(1) : Sous UNIX, une fonction de sécurité spéciale empêche toute utilisation non autorisée d autres commandes dans le qualifiant. Par exemple, le fichier ci-dessous contient une commande dans le qualifiant : /users/xpr/hp3000/send2(-n " ls /users/xpr/hp3000/m* " -o -r %p) Si le qualifiant ne contient aucune autre commande, les vérifications suivantes sont effectuées : 1. L option locale jm no root doit avoir la valeur no. 2. Dans le fichier de sécurité, l utilisateur qui documente le programme ou qui ajoute la dépendance Open Files avec une commande adddep Conman, doit avoir soumis l accès à un travail avec les attributs suivants : name=cmdstest.fileeq logon=root jcl=chemin d accès des fichiers OPEN cpu=poste de travail sur lequel résident les fichiers OPEN Notez que cmdstest et fileeq n existent pas. 122 IBM Tivoli Workload Scheduler - Guide de référence

147 priority Définit la priorité d un travail ou d un flux de travaux. Syntaxe priority nombre hi go Arguments Nombre Indique la priorité. Les valeurs admises sont comprises entre 0 et 99. Une priorité de zéro empêche le lancement du travail ou du flux de travaux. hi Equivalent de la priorité 100. go Equivalent de la priorité 101 (priorité maximale). Exemples L exemple suivant illustre la relation entre le flux de travaux et les priorités des travaux. Les travaux sont lancés dans l ordre suivant : job1,job2, joba, jobb. schedule sked1 on tu priority 50 : job1 priority 15 job2 priority 10 end schedule sked2 on tu priority 10 : joba priority 60 jobb priority 50 end Si les priorités de flux de travaux sont identiques, les travaux sont lancés dans l ordre suivant : joba, jobb, job1, job2. Chapitre 4. Langage de planification 123

148 prompt Définit les invites auxquelles une réponse affirmative doit être donnée avant le lancement d un travail ou d un flux de travaux. Syntaxe prompt nom_invite [,...] prompt [:!]texte [...] Arguments nom_invite Indique le nom d une invite de la base de données. texte Indique une invite littérale sous forme de chaîne de caractères placée entre guillemets ( ). Plusieurs chaînes séparées par une barre oblique inversée et n (\n) peuvent être utilisées pour des messages longs. Si la chaîne commence par un signe deux-points (:), le message s affiche mais aucune réponse n est requise. Si la chaîne commence par un point d exclamation (!), le message ne s affiche pas mais il requiert une réponse. Vous pouvez entrer une barre oblique suivie d un n ( \n ) dans le texte pour les retours à la ligne. Un ou plusieurs paramètres peuvent être utilisés dans tout ou partie de la chaîne de caractères. Pour utiliser un paramètre, placez son nom entre carets (^). Remarque : Dans une invite locale, lorsqu ils ne désignent pas de paramètre, les carets (^) doit être précédés d une barre oblique inversée pour ne pas provoquer d erreur. Dans les invites globales, il n est pas nécessaire de faire précéder les carets d une barre oblique inversée. Exemples L exemple suivant illustre des invites littérales et nommées. La première correspond à une invite littérale qui utilise un paramètre intitulé sys1. Lorsqu une seule réponse affirmative est reçue pour l invite intitulée apmsg, les dépendances des deux travaux job1 et job2 sont respectées. schedule sked3 on tu,th prompt "All ap users logged out of ^sys1^? (y/n)" : job1 prompt apmsg job2 prompt apmsg end L exemple suivant définit une invite littérale qui apparaît sur plusieurs lignes. Il contient une barre oblique inversée suivie de la lettre n (\n) à la fin de chaque ligne : schedule sked5 on fr prompt "Les travaux du flux de travaux occupent \n un temps UC énorme.\n Voulez-vous les lancer maintenant? (o/n)" : j1 j2 follows j1 end 124 IBM Tivoli Workload Scheduler - Guide de référence

149 schedule Indique le nom du flux de travaux. A l exception des commentaires, il doit correspondre au premier mot clé d un flux de travaux et être suivi du mot clé on. Syntaxe schedule [poste_travail#]nom_flux_travaux on... Arguments poste_travail Indique le nom du poste de travail sur lequel le flux de travaux est lancé. Par défaut, il s agit du poste de travail sur lequel Composer s exécute pour ajouter le flux de travaux. nom_flux_travaux on Indique le nom du flux de travaux. Ce nom doit commencer par une lettre et peut contenir des caractères alphanumériques, des tirets et des traits de soulignement. Il peut comporter jusqu à 16 caractères. Indique le moment ou la fréquence de sélection du flux de travaux à des fins d exécution. Pour plus d informations, voir «on», à la page 118. Exemples L exemple suivant permet de nommer un flux de travaux sked1 qui est lancé sur le poste de travail sur lequel Composer est en cours d exécution : schedule sked1 on tu L exemple suivant permet de nommer un flux de travaux sked-2 qui est lancé sur le poste de travail sur lequel Composer est en cours d exécution : schedule sked-2 on everyday except fr L exemple suivant permet de nommer un flux de travaux skedux7 qui est lancé sur le poste de travail hpux3 : schedule hpux3#skedux7 on monthend Chapitre 4. Langage de planification 125

150 until Indique l heure au plus tard à laquelle un travail ou un flux de travaux sera lancé. Syntaxe until heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action] Arguments heure Indique l heure. Les valeurs admises sont comprises entre 0000 et fuseau_horaire Indique le fuseau horaire à utiliser lors du calcul de l heure. Pour plus d informations sur les noms de fuseau horaire, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. Il s agit par défaut du fuseau horaire correspondant au poste de travail sur lequel le travail ou le flux de travaux est lancé. Remarque : Si une heure est indiquée par les options until et at, les fuseaux horaires doivent être identiques. n Indique un décalage, en jours, à partir de la date et de l heure de début planifiées. onuntil action Indique l action à effectuer sur un travail ou flux de travaux, dont l heure until est arrivée à expiration, mais qui n a pas pas encore démarré. Les valeurs possibles du paramètre de l action sont : suppr L état final du flux de travaux est HOLD si le flux de travaux contient au moins un travail chaque. Dans le cas contraire, le programme calcule l état final selon les règles normales et les travaux utilisant l option onuntil suppr sont considérés à l état SUCC dès que l heure définie par until arrive, même si leurs dépendances n ont pas été réellement libérées. cont Le travail ou flux de travaux s exécute lorsque toutes les conditions requises sont remplies. Un message apparaît alors dans le journal lorsque l heure définie par until est dépassée. canc Un travail ou flux de travaux est annulé lorsque l heure définie par until est atteinte. Tout travail ou flux de travaux qui dépendait de l accomplissement d un travail ou flux de travaux qui a été annulé, s exécutera car la dépendance n est plus appliquée. Exemples Dans l exemple suivant, le programme interdit tout lancement du processus sked1 après 17 heures les mardis : schedule sked1 on tu until 1700: Le programme lance sked1 à 17:00 lorsque l heure définie par until est atteinte : schedule sked1 until 1700 onuntil cont Le programme lance le travail job1 entre 13 et 17 heures pendant les jours de la semaine : schedule sked2 on weekdays: job1 at 1300 until 1700 end 126 IBM Tivoli Workload Scheduler - Guide de référence

151 Dans l exemple suivant, le programme lance le travail joba toutes les 15 minutes entre 22:30 et 23:30 les lundis : schedule sked3 on mo: joba at 2230 every 0015 until 2330 end Dans l exemple suivant, le programme lance le flux de travaux sked4 les dimanches entre 8 et 13 heures. Les travaux doivent être lancés selon l intervalle suivant : schedule sked4 on fr at days until days : job1 job2 at 0900 <<launched on sunday>> job3 follows job2 at 1200 <<launched on sunday>> end Dans l exemple suivant, le programme lance le flux de travaux sked8 tous les jours de la semaine à 16:00. Il doit être terminé à 17:00. Si le flux de travaux n est pas terminé à 17:00, il est considéré comme étant en retard. Les travaux doivent être lancés comme suit : job1 démarre à 16:00 ou au plus tard à 16:20. Si le travail job1 n a pas encore démarré à 16:20, le programme consigne un message dans le journal et job1 commence son exécution. Quant au travail job2, il s exécute à 16:30 ou au plus tard à 16:50. Si le travail job2 n a pas encore démarré à 16:50, il est annulé. schedule sked8 on weekdays at 1600 deadline 1700 : job1 at 1600 until 1620 onuntil cont job2 at 1630 until 1650 onuntil canc end Dans l exemple suivant, le programme lance le flux de travaux sked01. Si l événement until intervient, le programme exécute le flux de travaux sked02 car le flux de travaux sked01 passe à l état SUCC. Par contre, le flux de travaux sked03 n est pas exécuté car il possède une dépendance horaire ponctuelle sur le travail job01, qui n a pas été libérée. SCHEDULE sked01 on everyday: job01 until 2035 onuntil suppr end SCHEDULE sked02 on everyday follows sked01.@ : job02 end SCHEDULE sked03 on everyday follows sked01.jtest : job03 END Chapitre 4. Langage de planification 127

152 128 IBM Tivoli Workload Scheduler - Guide de référence

153 Chapitre 5. Référence au programme Conman L environnement du plan de production IBM Tivoli Workload Scheduler est géré via le programme de ligne de commande Conman. Le programme Conman permet de lancer et d arrêter le traitement, de modifier et d afficher le plan de production (Symphony) et de contrôler les liaisons entre les postes de travail d un réseau. Le présent chapitre détaille les points suivants : v Exécution de Conman v Sélection et qualification des travaux et des flux de travaux v Syntaxe et utilisation des commandes Conman Exécution du programme Conman Pour lancer Conman, exécutez la commande suivante : conman [ command[&...][&]"] Exemples Dans l exemple suivant, Conman est lancé et invite l utilisateur à taper une commande : conman Dans l exemple suivant, Conman exécute les commandes sj et sp avant de quitter : conman"sj&sp" Dans l exemple suivant, Conman exécute les commandes sj et sp et invite l utilisateur à taper une commande : conman"sj&sp&" Dans l exemple suivant, Conman lit les commandes à partir de cfile : conman < cfile Dans l exemple suivant, les commandes provenant de cfile sont dirigées vers Conman : cat cfile conman Caractères de commande Vous pouvez entrer les caractères de commande suivants pour arrêter Conman. Ctrl+c Conman stoppe la commande en cours d exécution dès qu une étape le permet et renvoie une invite de commande. Ctrl+d Conman se ferme après avoir exécuté la commande en cours. Exécution des commandes système Lorsqu une commande système est entrée avec une barre verticale ou un préfixe de commande système (: ou!), elle est exécutée par un processus enfant. Pour garantir la sécurité, l ID utilisateur effectivement associé au processus enfant est celui de l utilisateur qui exécute Conman. Copyright IBM Corp. 1999,

154 Invites utilisateur Si vous utilisez des caractères génériques pour sélectionner les objets soumis à l action d une commande, Conman vous demande confirmation après avoir localisé chacun des objets recherchés. Si vous répondez oui l action est effectuée sur l objet, et si vous répondez non l objet est ignoré et aucune action n est effectuée. Lorsque Conman est exécuté en mode interactif, les invites de confirmation sont exécutées sur votre ordinateur. La sélection de la touche Retour en réponse à une invite est interprétée comme étant une réponse négative. La fonction d invite peut être désactivée dans une commande à l aide de l option ;noask. Bien qu aucune invite de confirmation ne soit générée lorsque Conman est exécuté en mode interactif, celui-ci se comporte comme si la réponse avait été négative dans chacun des cas et aucune action n est effectuée sur les objets. Par conséquent, il est important d inclure l option ;noask dans les commandes lorsque Conman ne s exécute pas en mode interactif. Sortie sur le terminal La sortie sur votre ordinateur est indiquée par les variables du shell MAESTROLINES et MAESTROCOLUMNS. Si aucune de ces variables n est définie, il est fait appel aux variables du shell LINES et COLUMNS. Les variables peuvent être définies comme suit : Sortie $MAESTROLINES Indique le nombre de lignes par page d écran. La valeur par défaut est 24. A la fin de chaque page d écran, Conman vous invite à poursuivre. Si la variable MAESTROLINES (ou LINES) a pour valeur zéro ou une valeur négative, Conman ne marque pas de pause à la fin de chaque page. $MAESTROCOLUMNS Indique le nombre de caractères par ligne. La valeur par défaut est 80. $MAESTRO_OUTPUT_STYLE Indique le mode d affichage des noms d objet. Si sa valeur est LONG, le nom complet est affiché. Si la valeur n est pas définie ou définie par une valeur différente de LONG, les noms longs sont tronqués à huit caractères suivis du signe (+). offline Dans les commandes Conman, l option ;offline sert généralement à imprimer la sortie d une commande. Lorsqu elle est insérée, la sortie est contrôlée par les variables de shell ci-après : $MAESTROLP Indique la destination de la sortie d une commande. Vous pouvez indiquer : > fichier La sortie est dirigée vers un fichier dont elle remplace le contenu. Si le fichier n existe pas, il est créé. >> fichier La sortie est dirigée vers un fichier et est ajoutée à la fin de son contenu. Si le fichier n existe pas, il est créé. 130 IBM Tivoli Workload Scheduler - Guide de référence

155 commande La sortie est dirigée vers une commande système ou un processus. Le programme exécute la commande système, que la sortie soit générée ou non. commande La sortie est dirigée vers une commande système ou un processus. La commande système n est pas exécutée en l absence de résultat. La valeur par défaut est lp -tconlist qui dirige la sortie de la commande vers l imprimante et insère le titre CONLIST sur la page bannière de la sortie imprimée. $MAESTROLPLINES Indique le nombre de lignes par page. La valeur par défaut est 60. $MAESTROLPCOLUMNS Indique le nombre de caractères par ligne. La valeur par défaut est 132. Les variables doivent être exportées avant l exécution de Conman. Sélection de l invite de commande Conman Par défaut, l invite de commande conman est figurée par le signe %. Elle est définie dans le fichier racine_tws/localopts. L invite de commande par défaut correspond à un tiret (-). Pour sélectionner une autre invite, éditez l option d invite conman dans le fichier localopts et modifiez le tiret. Le message d invite peut comporter jusqu à 10 caractères, le signe dièse (#) de fin requis non inclus. Syntaxe des commandes # # Custom format attributes # date format = 1 # The possible values are 0-ymd, 1-mdy, 2-dmy, 3-NLS. composer prompt = - conman prompt = % switch sym prompt = <n>% # Les commandes Conman se composent des éléments suivants : nom_commande sélection arguments Où : nom_commande Indique le nom de la commande. sélection Indique l objet ou le groupe d objets sur lequel sera exécutée la commande. arguments Indique les arguments de la commande. Voici un exemple de commande Conman : sj sked1.@+state=hold~priority=0;info;offline Où : sj Forme abrégée de la commande showjobs. Chapitre 5. Référence au programme Conman 131

156 Caractères Sélectionne tous les travaux du flux de travaux sked1 qui sont à l état hold et dont la priorité est différente de zéro. ;info;offline Arguments de la commande showjobs. génériques Les caractères génériques acceptés sont les suivants Remplace un ou plusieurs caractères alphanumériques.? Remplace un caractère alphanumérique. % Remplace un caractère numérique. Délimiteurs et caractères spéciaux Les caractères suivants ont une signification spéciale dans les commandes Conman : Caractère Description & Délimiteur de commande. Voir «Exécution du programme Conman», à la page Délimiteur servant à sélectionner les objets pour les commandes. Il permet d ajouter un attribut dont un objet doit être doté. Par exemple : sked1.@+priority=0 ~ Délimiteur servant à sélectionner les objets pour les commandes. Il permet d ajouter un attribut dont un objet doit être doté. Par exemple : sked1.@~priority=0 ; Délimiteur d argument. Par exemple : ;info;offline, Délimiteur de répétition et de fourchette. Par exemple : state=hold,sked,pend = Délimiteur de valeur. Par exemple : state=hold :! Préfixes de commande qui transmettent la commande au système. Ces préfixes sont facultatifs. Si Conman ne reconnaît pas la commande, celle-ci est transmise automatiquement au système. Par exemple :!ls ou :ls <<>> Crochets de mise en commentaire. Par exemple : <<commentaire>> * Préfixe de commentaire. Le préfixe doit être le premier caractère de la ligne de commande ou suivre un délimiteur de commande. Par exemple : *commentaire ou sj& *commentaire > Dirige la sortie de la commande vers un fichier dont elle remplace le contenu. Si le fichier n existe pas, il est créé. Par exemple : sj> joblist 132 IBM Tivoli Workload Scheduler - Guide de référence

157 Caractère Description >> Dirige la sortie de la commande vers un fichier et celle-ci est ajoutée à la fin du fichier. Si le fichier n existe pas, il est créé. Par exemple : sj>> joblist La sortie de la commande est dirigée vers une commande système ou un processus. Le programme exécute la commande système, que la sortie soit générée ou non. Par exemple : sj grep ABEND La sortie de la commande est dirigée vers une commande système ou un processus. La commande système n est pas exécutée en l absence de résultat. Par exemple : sj grep ABEND Liste des commandes Le tableau suivant répertorie les commandes Conman. Les noms de commande et les mots clés peuvent être entrés en majuscules ou en minuscules et peuvent être abrégés au nombre minimal de caractères suffisant pour les distinguer les uns des autres. Certains noms de commande ont également une forme abrégée. Commande Forme abrégée Description Type 1 adddep adj ads Ajoute des dépendances d un travail ou d un flux de travaux. altpass Modifie un mot de passe de définition d objet utilisateur. altpri ap Modifie les priorités d un travail ou d un flux de travaux. cancel cj cs Annule un travail ou un flux de travaux. confirm Confirme l achèvement d un travail. console Affecte la console IBM Tivoli Workload Scheduler. Page G,P 151, 153 G,P 155 G,P 156 G,P 165, 159 G,P 161 G,P,S 163 continue Ignore l erreur suivante. G,P,S 164 deldep ddj dds Supprime les dépendances du travail ou du flux de travaux. display df dj ds Affiche les fichiers, les travaux et les flux de travaux. G,P 183, 167 G,P,S 2 exit Arrête Conman. G,P,S 170 fence Définit la priorité limite des travaux d IBM Tivoli Workload Scheduler. help 5 Affiche les informations relatives à la commande. 169 G,P,S 171 G,P,S 173 kill Arrête l exécution d un travail. G,P 174 limit lc ls Modifie le nombre limite de travaux d un poste de travail ou d un flux de travaux. G,P,S 3 175, 176 Chapitre 5. Référence au programme Conman 133

158 Commande Forme abrégée Description Type 1 link lk Etablit des liaisons de poste de travail. listsym Affiche la liste des fichiers journaux Symphony. Page G,P,S 177 G,P 179 recall rc Affiche les messages d invite. G,P 180 redo Edite la commande précédente. G,P,S 181 release rj rs Libère les dépendances du travail ou du flux de travaux. G,P 157, 185 reply Répond au message d invite. G,P 187 rerun rr Lance une nouvelle exécution d un travail. resource Modifie le nombre d unités de ressource. setsym Sélectionne un fichier journal Symphony. showcpus sc Affiche les informations relatives au poste de travail et aux liaisons. showdomain Affiche les informations relatives au domaine. showfiles sf Affiche les informations relatives aux fichiers. showjobs sj Affiche les informations relatives aux travaux. showprompts sp Affiche les informations relatives aux invites. showresources sr Affiche les informations relatives aux ressources. showschedules ss Affiche les informations relatives aux flux de travaux. shutdown Stoppe les processus de production d IBM Tivoli Workload Scheduler. start Lance les processus de production d IBM Tivoli Workload Scheduler. status Affiche l état de la production d IBM Tivoli Workload Scheduler. stop Stoppe les processus de production d IBM Tivoli Workload Scheduler. stop ;progressive Stoppe les processus de production d IBM Tivoli Workload Scheduler de façon hiérarchique. G,P 188 G,P 191 G,P 192 G,P,S 193 G,P,S 197 G,P 198 G,P 200 G,P 208 G,P 210 G,P 212 G,P,S 215 G,P,S 216 G,P,S 218 G,P,S IBM Tivoli Workload Scheduler - Guide de référence

159 Commande Forme abrégée Description Type 1 submit sbd sbf sbj sbs Soumet une commande, un fichier, un travail ou un flux de travaux. switchmgr Change le gestionnaire de domaine. commande-sys Envoie une commande au système. tellop to Envoie un message à la console. unlink Ferme les liaisons de poste de travail. version v Affiche la bannière du programme de ligne de commande Conman. G,P,S 4 Page 222, 224, 226, 228 G,P 230 G,P,S 231 G,P,S 232 G,P,S 233 G,P,S Types de postes de travail : gestionnaires de domaine (G), agents à tolérance de pannes (P), agents standard (S). 2. Vous pouvez afficher des fichiers uniquement sur un agent standard. 3. Vous pouvez modifier le nombre limite de travaux lancés uniquement sur le poste de travail d un agent standard. 4. Vous pouvez utiliser les commandes submit job (sbj) et submit sched (sbs) sur un agent standard uniquement si le répertoire mozart du gestionnaire du domaine maître est accessible à cet agent standard. 5. Non disponible sur les plateformes Windows prises en charge. Sélection de travaux dans les commandes Pour les commandes qui s exécutent sur les travaux, les travaux cible sont sélectionnés au moyen d attributs et de qualifiants. La syntaxe de sélection des travaux fournie ci-après est décrite dans les pages suivantes. Syntaxe [poste_travail#] { flux_travaux.travail numéro_travail} [ + ~qualifiant_travail[...]] ou : Arguments agent_réseau::[poste_travail#] flux_travaux.travail poste_travail Utilisé avec le fichier flux_travaux.travail, cet argument indique le nom du poste de travail sur lequel est exécuté le flux de travaux. Utilisé avec l argument numéro_travail, il indique le poste de travail sur lequel est exécuté le travail. Les caractères génériques sont acceptés. flux_travaux Indique le nom du flux de travaux dans lequel s exécute le travail. Les caractères génériques sont acceptés. travail Indique le nom du travail. Les caractères génériques sont acceptés. Chapitre 5. Référence au programme Conman 135

160 numéro_travail Indique le numéro du travail. qualifiant_travail Voir «Qualificatifs des travaux». agent_réseau Indique le nom de l agent de réseau du planificateur qui assure l interface avec le réseau distant du planificateur sur lequel se trouve le travail cible. Les deux-points doubles (::) sont un délimiteur requis. Les caractères génériques sont acceptés. Pour plus d informations, voir Chapitre 9, «Référence aux agents réseau», à la page 313. Qualificatifs des travaux Les qualifiants de travaux indiquent les attributs de travaux sur lesquels une commande doit agir. Ils sont précédés d un signe + ou ~. Le signe + signifie que les travaux comportant l attribut indiqué sont appropriés pour la commande. Le signe ~ signifie que les travaux comportant l attribut indiqué sont exclus de la commande. Les mots clés des qualifiants de travaux peuvent être abrégés à l aide des premiers caractères afin de les distinguer les uns des autres. at[=heure heure_min heure_max heure_min,heure_max [absolute abs]] Sélectionne ou exclut des travaux en fonction de l heure de début planifiée. heure Indique l heure de début planifiée exprimée comme suit : hhmm[+n days date] [timezone tz fuseau_horaire] Où : hhmm Heure et minute. + n days Occurrence suivante de hhmm en n nombre de jours. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du travail. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure respecte les règles suivantes: v Lorsque hhmm est antérieure à l heure courante, l heure de début est le lendemain ; lorsque hhmm est postérieure à l heure courante, l heure de début est le jour même. v Lorsque hhmm est supérieure à 2400, elle est divisée par La partie entière représente le nombre de jours en +, tandis que la partie décimale représente l heure. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les travaux dont l heure de début prévue est égale ou postérieure à l heure indiquée sont sélectionnés. 136 IBM Tivoli Workload Scheduler - Guide de référence

161 heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les travaux dont l heure de début prévue est égale ou antérieure à l heure indiquée sont sélectionnés. absolute abs Indique l heure de début planifiée pour le jour présent. Ce mot clé peut être utilisé uniquement avec timezone tz fuseau_horaire et hhmm. Il respecte les règles suivantes : v Lorsque hhmm est antérieure à l heure courante, le travail débute immédiatement. v Si l heure hhmm est postérieure à l heure courante, le travail débutera à l heure de début hhmm du jour présent. v Lorsque hhmm dépasse 2400, elle est divisée par 2400 pour obtenir le jour et l heure. La partie entière du résultat de la division représente le jour (nombre de jours en +), tandis que la partie décimale représente l heure : Si l heure calculée est antérieure à l heure courante, le travail débutera à l heure calculée la veille du jour calculé. Si l heure calculée est postérieure à l heure courante, le travail débutera le jour et à l heure calculés. Par exemple, si l heure courante est 1200 et si le travail est soumis à hhmm = 3500 ( ), le mot clé indiqué étant abs, le travail sera lancé à 1100 le jour suivant. Dans le cas où le mot clé abs n est pas indiqué, le travail sera lancé à 1100 deux jours plus tard. Si l option at est utilisée seule, la plage est extensible et les travaux sont sélectionnés ou exclus si une heure de début a été planifiée pour eux. confirmed Sélectionne ou exclut les travaux qui ont été planifiés à l aide du mot clé confirm. deadline[=heure heure_min,,heure_max heure_min,heure_max] Indique le temps nécessaire pour l achèvement d un travail. hhmm[+n days date] [timezone tz fuseau_horaire] hhmm Heure et minute. + n days Décalage en jours à partir de l heure d échéance planifiée. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Indique le fuseau horaire à utiliser lors du calcul de l heure d échéance. Pour plus d informations sur les noms de fuseau horaire, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. Il s agit par défaut du fuseau horaire correspondant au poste de travail sur lequel le travail ou le flux de travaux est lancé. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les travaux dont l heure d échéance est égale ou postérieure à cette heure limite sont sélectionnés. Chapitre 5. Référence au programme Conman 137

162 heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les travaux dont l heure d échéance est égale ou antérieure à cette heure limite sont sélectionnés. every[=fréquence fréquence_min,,fréquence_max fréquence_min,fréquence_max] Sélectionne ou exclut des travaux soumis ou non à une fréquence de répétition. fréquence Indique la fréquence d exécution planifiée, exprimée en heures et en minutes (hhmm). fréquence_min Indique la limite inférieure d une plage de fréquence, exprimée au même format que la fréquence. Les travaux dont la fréquence de répétition est supérieure ou égale à la fréquence indiquée sont sélectionnés. fréquence_max Indique la limite supérieure d une plage de fréquence, exprimée au même format que la fréquence. Les travaux dont la fréquence de répétition est inférieure ou égale à la fréquence indiquée sont sélectionnés. Si l option every est utilisée seule, la plage est extensible et les travaux sont sélectionnés ou exclus s ils sont associés à une fréquence de répétition. finished[=heure heure_min,,heure_max heure_min,heure_max] Sélectionne ou exclut les travaux selon qu ils sont terminés ou non. heure Indique l heure de fin exacte des travaux, exprimée comme suit : hhmm [date] [ timezone tz fuseau_horaire] hhmm Heure et minute. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du travail. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les travaux qui sont terminés à cette heure ou après sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les travaux qui sont terminés à cette heure ou avant sont sélectionnés. Si l option finished est utilisée seule, la plage est extensible et les travaux sont sélectionnés ou exclus selon qu ils sont terminés ou non. follows[=[agent_réseau::][[poste_travail#] flux_travaux.]travail[;nocheck][;wait=heure]] Sélectionne ou exclut les travaux selon qu ils comportent ou non une dépendance follows. 138 IBM Tivoli Workload Scheduler - Guide de référence

163 agent_réseau Indique le nom de l agent de réseau du planificateur qui assure l interface avec le réseau distant du planificateur sur lequel se trouve le travail prérequis. Les caractères génériques sont acceptés. Pour plus d informations, voir Chapitre 9, «Référence aux agents réseau», à la page 313. poste_travail Indique le nom du poste de travail sur lequel le travail prérequis est exécuté. Les caractères génériques sont acceptés. flux_travaux Indique le nom du flux de travaux dans lequel le travail prérequis est exécuté. Les caractères génériques sont acceptés. Si vous entrez flux_travaux.@, indiquez que le travail cible vient à la suite de tous les travaux du flux de travaux. travail Indique le nom du travail prérequis. Lorsque ce paramètre est entré sans argument flux de travaux, il indique que le travail prérequis se trouve dans le même flux de travaux que le travail cible. Pour une dépendance d aboutissement, n utilisez pas de caractères génériques dans le nom du travail. nocheck Uniquement valable pour les commandes sbd, sbj et sbs. Conman ne vérifie pas l existence des travaux prérequis dans le fichier Symphony. Lorsque Batchman traite la commande submit, il ajoute les arguments de cette commande à symphony (tels que le travail à soumettre), y compris les dépendances des travaux prérequis qui figurent dans symphony. Pour les travaux prérequis ne figurant pas dans le fichier symphony, Batchman affiche un avertissement dans stdlist. wait=heure Uniquement valable pour les commandes sbd, sbj et sbs. Au cours de l intervalle de temps indiqué, conman vérifie chaque seconde que les travaux prérequis figurent dans le fichier symphony. Conman continue sa vérification jusqu à ce que les travaux prérequis soient trouvés ou que l intervalle de temps indiqué pour le mot clé wait arrive à expiration. Lorsque tous les travaux prérequis sont trouvés, Batchman traite la commande submit. Même si un seul travail prérequis n est pas trouvé dans symphony à l expiration de l intervalle de temps, Conman ne traite pas la commande submit et envoie un message d erreur. Le nombre maximum de secondes est Si vous indiquez nocheck ainsi que wait, lorsque l intervalle de temps arrive à expiration, Batchman traite la commande submit même si un travail prérequis ne figure pas dans symphony. Le travail à soumettre et les travaux prérequis qui figurent dans symphony sont ajoutés à symphony. Si l option follows est utilisée seule, des travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances follows. logon=nom_utilisateur Sélectionnez les travaux en fonction des noms d utilisateur sous lesquels ils sont exécutés. Si le nom utilisateur contient des caractères spéciaux, il doit être placé entre guillemets ( ). Les caractères génériques sont acceptés. Chapitre 5. Référence au programme Conman 139

164 needs[=[poste_travail#]nom_ressource] Sélectionne ou exclut des travaux selon qu ils comportent ou non une dépendance par rapport à des ressources. poste_travail Indique le nom du poste de travail sur lequel la ressource est définie. Les caractères génériques sont acceptés. nom_ressource Indique le nom de la ressource. Les caractères génériques sont acceptés. Si l option needs est utilisée seule, des travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances sur les ressources. opens[=[poste_travail#]nom_fichier[(qualifiant)]] Sélectionne des travaux selon qu ils comportent ou non une dépendance par rapport à des fichiers. Une dépendance de fichier se produit lorsqu un travail ou flux de travaux dépend de l existence d un ou de plusieurs fichiers avant de pouvoir être exécuté. poste_travail Indique le nom du poste de travail sur lequel se trouve le fichier. Les caractères génériques sont acceptés. nom_fichier Indique le nom du fichier. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : caractères alphanumériques, tirets (-), barres obliques (/), barres obliques inversées (\) et traits de soulignement (_). Les caractères génériques sont acceptés. qualifiant Condition de test valide. Si elle est omise, les travaux sont sélectionnés ou exclus, quel que soit le qualifiant utilisé. Si l option opens est utilisée seule, des travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances sur les fichiers. Une dépendance de fichier se produit lorsqu un travail ou flux de travaux dépend de l existence d un ou de plusieurs fichiers avant de pouvoir être exécuté. priority=pri pri_min,,pri_max pri_min,pri_max Sélectionne ou exclut des travaux en fonction de leurs priorités. pri Indique la valeur de la priorité. Vous pouvez entrer une valeur comprise entre 0 et 99, hi ou go. pri_min Indique la limite inférieure d une plage de priorité. Les travaux dont la priorité est égale ou supérieure à cette valeur sont sélectionnés. pri_max Indique la limite supérieure d une plage de priorité. Les travaux dont la priorité est inférieure ou égale à cette valeur sont sélectionnés. prompt[=nom_invite num_message] Sélectionne ou exclut des travaux selon qu ils comportent ou non une dépendance par rapport à des invites. 140 IBM Tivoli Workload Scheduler - Guide de référence

165 nom_invite Indique le nom d une invite globale. Les caractères génériques sont acceptés. num_message Indique le numéro de message d une invite locale. Si l option prompt est utilisée seule, des travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances sur les invites. recovery=option_reprise Sélectionne ou exclut des travaux en fonction de leurs options de reprise. option_reprise Affecte à l option de reprise de travaux la valeur stop, continue ou rerun. scriptname=nom_fichier Sélectionne ou exclut des travaux en fonction du nom de leurs fichiers exécutables. nom_fichier Indique le nom d un fichier exécutable. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : caractères alphanumériques, tirets (-), barres obliques (/), barres obliques inversées (\) et traits de soulignement (_). Les caractères génériques sont acceptés. started[=heure heure_min,,heure_max heure_min,heure_max] Sélectionne ou exclut des travaux selon qu ils ont été lancés ou non. heure Indique l heure de début exacte des travaux, exprimée comme suit : hhmm [date] [ timezone tz fuseau_horaire] hhmm Heure et minute. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du travail. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les travaux qui ont été lancés à cette heure ou après sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les travaux qui ont été lancés à cette heure ou avant sont sélectionnés. Si l option started est utilisée seule, la plage est extensible et les travaux sont sélectionnés ou exclus selon qu ils ont été lancés ou non. state=état[,...] Sélectionne ou exclut des travaux en fonction de leur état. état Indique l état courant du travail. Les états acceptés pour un travail sont les suivants : Chapitre 5. Référence au programme Conman 141

166 abend Le travail est terminé avec un code de sortie différent de zéro. abenp Une confirmation abend a été reçue mais le travail n est pas terminé. add Le travail est en cours de soumission. done Le travail est terminé avec un état inconnu. error Pour les dépendances interréseaux uniquement, une erreur s est produite lors de la recherche de l état distant. exec Le travail est en cours d exécution. extrn Pour les dépendances interréseaux uniquement, l état est inconnu. Une erreur s est produite, une action de réexécution vient d être effectuée sur le travail du flux de travaux externes, ou le travail ou le flux de travaux distant n existe pas. fail Impossible de lancer le travail. fence La priorité du travail est inférieure à la priorité limite. hold Le travail attend la résolution de dépendances. intro Le travail est introduit à des fins de lancement par le système. pend Le travail est terminé et attend une confirmation. ready Le travail est prêt à démarrer et toutes les dépendances sont résolues. sched L heure du travail indiquée par at n est pas arrivée. succ Le travail est terminé avec un code de sortie zéro. succp Une confirmation succ a été reçue mais le travail n est pas terminé. wait Le travail est à l état wait (agent étendu uniquement). until[=heure heure_min heure_max heure_min,heure_max [absolute abs]] Sélectionne ou exclut des travaux en fonction de l heure de fin planifiée qui leur est associée. heure Indique l heure de fin planifiée exprimée comme suit : hhmm[+n days date] [timezone tz fuseau_horaire] hhmm Heure et minute. + n days Occurrence suivante de hhmm en n nombre de jours. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du travail. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure_min Indique la limite inférieure d une plage horaire exprimée au même 142 IBM Tivoli Workload Scheduler - Guide de référence

167 format que l heure. Les travaux dont l heure de fin planifiée est égale ou postérieure à l heure indiquée sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les travaux dont l heure de fin planifiée est égale ou antérieure à l heure indiquée sont sélectionnés. absolute abs Indique l heure de début planifiée pour le jour présent. Ce mot clé peut être utilisé uniquement avec timezone tz fuseau_horaire et hhmm. Il respecte les règles suivantes : v Lorsque hhmm est antérieure à l heure courante, le travail débute immédiatement. v Si l heure hhmm est postérieure à l heure courante, le travail débutera à l heure de début hhmm du jour présent. v Lorsque hhmm dépasse 2400, elle est divisée par 2400 pour obtenir le jour et l heure. La partie entière du résultat de la division représente le jour (nombre de jours en +), tandis que la partie décimale représente l heure : Si l heure calculée est antérieure à l heure courante, le travail débutera à l heure calculée la veille du jour calculé. Si l heure calculée est postérieure à l heure courante, le travail débutera le jour et à l heure calculés. Par exemple, si l heure courante est 1200 et si le travail est soumis à hhmm = 3500 ( ), le mot clé indiqué étant abs, le travail sera lancé à 1100 le jour suivant. Dans le cas où le mot clé abs n est pas indiqué, le travail sera lancé à 1100 deux jours plus tard. Si l option until est utilisée seule, la plage est extensible et les travaux sont sélectionnés ou exclus selon qu ils sont associés ou non à une heure de fin planifiée. Sélection de flux de travaux dans les commandes Pour les commandes qui s exécutent sur les flux de travaux, les flux de travaux cible sont sélectionnés au moyen d attributs et de qualifiants. Le syntaxe de sélection des flux de travaux fournie ci-après est décrite dans les pages suivantes. Syntaxe [poste_travail#] flux_travaux[+ ~qualifiant_flux_travaux[...]] Arguments poste_travail Indique le nom du poste de travail sur lequel le flux de travaux est exécuté. Les caractères génériques sont acceptés. flux_travaux Indique le nom du flux de travaux. Les caractères génériques sont acceptés. qualifiant_flux_travaux Voir la section Qualifiants de flux de travaux ci-après. Chapitre 5. Référence au programme Conman 143

168 Qualifiants de flux de travaux at[=heure heure_min heure_max heure_min,heure_max [absolute abs]] Sélectionne ou exclut des flux de travaux en fonction de l heure de début planifiée. heure Indique l heure de début planifiée exprimée comme suit : hhmm[+n days date] [timezone tz fuseau_horaire] hhmm Heure et minute. + n days Occurrence suivante de hhmm en n nombre de jours. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du flux de travaux. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. absolute abs Indique l heure de début planifiée pour le jour présent. Ce mot clé peut être utilisé uniquement avec timezone tz fuseau_horaire et hhmm. Il respecte les règles suivantes : v Lorsque hhmm est antérieure à l heure courante, le travail débute immédiatement. v Si l heure hhmm est postérieure à l heure courante, le travail débutera à l heure de début hhmm du jour présent. v Lorsque hhmm dépasse 2400, elle est divisée par 2400 pour obtenir le jour et l heure. La partie entière du résultat de la division représente le jour (nombre de jours en +), tandis que la partie décimale représente l heure : Si l heure calculée est antérieure à l heure courante, le travail débutera à l heure calculée la veille du jour calculé. Si l heure calculée est postérieure à l heure courante, le travail débutera le jour et à l heure calculés. Par exemple, si l heure courante est 1200 et si le travail est soumis à hhmm = 3500 ( ), le mot clé indiqué étant abs, le travail sera lancé à 1100 le jour suivant. Dans le cas où le mot clé abs n est pas indiqué, le travail sera lancé à 1100 deux jours plus tard. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les flux de travaux dont l heure de début planifiée est égale ou postérieure à l heure indiquée sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les flux de travaux dont l heure de début planifiée est égale ou antérieure à l heure indiquée sont sélectionnés. 144 IBM Tivoli Workload Scheduler - Guide de référence

169 Si l option at est utilisée seule, la plage est extensible et les flux de travaux sont sélectionnés ou exclus s ils sont associés à une heure de début planifiée. carriedforward Sélectionne ou exclut les flux de travaux qui ont été reportés. carryforward Sélectionne ou exclut les flux de travaux qui ont été planifiés à l aide du mot clé carryforward. finished[=heure heure_min,,heure_max heure_min,heure_max] Sélectionne ou exclut les flux de travaux selon qu ils sont terminés ou non. heure Indique l heure de fin exacte des flux de travaux, exprimée comme suit : hhmm [date] [ timezone tz fuseau_horaire] hhmm Heure et minute. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du flux de travaux. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les flux de travaux qui sont terminés à cette heure ou après sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les flux de travaux qui sont terminés à cette heure ou avant sont sélectionnés. Si l option finished est utilisée seule, la plage est extensible et les flux de travaux sont sélectionnés ou exclus selon qu ils sont terminés ou non. follows[=[agent_réseau::][poste_travail#] flux_travaux[.travail[;nocheck][;wait=heure]] Sélectionne ou exclut les flux de travaux selon qu ils comportent ou non une dépendance follows. agent_réseau Indique le nom de l agent de réseau qui assure l interface avec le réseau distant du planificateur contenant le travail ou le flux de travaux prérequis. Les caractères génériques sont acceptés. Pour plus d informations sur les agents de réseau, voir Chapitre 9, «Référence aux agents réseau», à la page 313. poste_travail Indique le nom du poste de travail sur lequel est exécuté le travail ou le flux de travaux prérequis. Les caractères génériques sont acceptés. flux_travaux Indique le nom du flux de travaux prérequis. Les caractères génériques sont acceptés. travail Indique le nom du travail prérequis. Les caractères génériques sont acceptés. Chapitre 5. Référence au programme Conman 145

170 nocheck Uniquement valable pour les commandes sbd, sbj et sbs. Conman ne vérifie pas l existence des travaux prérequis dans le fichier Symphony. Lorsque Batchman traite la commande submit, il ajoute les arguments de cette commande à symphony (tels que le travail à soumettre), y compris les dépendances des travaux prérequis qui figurent dans symphony. Pour les travaux prérequis ne figurant pas dans le fichier symphony, Batchman affiche un avertissement dans stdlist. wait=heure Uniquement valable pour les commandes sbd, sbj et sbs. Au cours de l intervalle de temps indiqué, conman vérifie chaque seconde que les travaux prérequis figurent dans le fichier symphony. Conman continue sa vérification jusqu à ce que les travaux prérequis soient trouvés ou que l intervalle de temps indiqué pour le mot clé wait arrive à expiration. Lorsque tous les travaux prérequis sont trouvés, Batchman traite la commande submit. Même si un seul travail prérequis n est pas trouvé dans symphony à l expiration de l intervalle de temps, Conman ne traite pas la commande submit et envoie un message d erreur. Le nombre maximum de secondes est Si vous indiquez nocheck ainsi que wait, lorsque l intervalle de temps arrive à expiration, Batchman traite la commande submit même si un travail prérequis ne figure pas dans symphony. Le travail à soumettre et les travaux prérequis qui figurent dans symphony sont ajoutés à symphony. Si l option follows est utilisée seule, les flux de travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances follows. limit[=limite limite_min,,limite_max limite_min,limite_max] Sélectionne ou exclut les flux de travaux selon qu ils comportent ou non un nombre limite de travaux. limite Indique la valeur précise du nombre limite de travaux. limite_min Indique la limite inférieure d une plage. Les flux de travaux dont les limites de travaux sont égales ou supérieure à la limite indiquée sont sélectionnés. limite_max Indique la limite supérieure d une fourchette. Les flux de travaux dont les limites de travaux sont inférieures ou égale à la limite indiquée sont sélectionnés. Si l option limit est utilisée seule, la plage est extensible et les flux de travaux sont sélectionnés ou exclus s ils sont associés à une limite de travail. needs[=[poste_travail#]nom_ressource] Sélectionne ou exclut les flux de travaux selon qu ils comportent ou non une dépendance de ressource. poste_travail Indique le nom du poste de travail sur lequel la ressource est définie. Les caractères génériques sont acceptés. 146 IBM Tivoli Workload Scheduler - Guide de référence

171 nom_ressource Indique le nom de la ressource. Les caractères génériques sont acceptés. Si l option needs est utilisée seule, les flux de travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances de ressource. opens[=[poste_travail#]nom_fichier[(qualifiant)]] Sélectionne ou exclut les flux de travaux selon qu ils comportent ou non une dépendance de fichier. Une dépendance de fichier se produit lorsqu un travail ou flux de travaux dépend de l existence d un ou de plusieurs fichiers avant de pouvoir être exécuté. poste_travail Indique le nom du poste de travail sur lequel se trouve le fichier. Les caractères génériques sont acceptés. nom_fichier Indique le nom du fichier. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : caractères alphanumériques, tirets (-), barres obliques (/), barres obliques inversées (\) et traits de soulignement (_). Les caractères génériques sont acceptés. qualifiant Condition de test valide. En cas d omission, les flux de travaux sont sélectionnés ou exclus, quel que soit le qualifiant utilisé. Si l option opens est utilisée seule, les flux de travaux sont sélectionnés ou exclus selon qu ils comportent ou non des dépendances de fichier. Une dépendance de fichier se produit lorsqu un travail ou flux de travaux dépend de l existence d un ou de plusieurs fichiers avant de pouvoir être exécuté. priority=pri pri_min,,pri_max pri_min,pri_max Sélectionne ou exclut les flux de travaux en fonction de leurs priorités. pri Indique la valeur de la priorité. Vous pouvez entrer une valeur comprise entre 0 et 99, hi ou go. pri_min Indique la limite inférieure d une plage de priorité. Les flux de travaux dont la priorité est égale ou supérieure à cette valeur sont sélectionnés. pri_max Indique la limite supérieure d une plage de priorité. Les flux de travaux dont la priorité est inférieure ou égale à cette valeur sont sélectionnés. prompt[=nom_invite num_message] Sélectionne ou exclut les flux de travaux selon qu ils comportent ou non une dépendance d invite. nom_invite Indique le nom d une invite globale. Les caractères génériques sont acceptés. num_message Indique le numéro de message d une invite locale. Chapitre 5. Référence au programme Conman 147

172 Si l option prompt est utilisée seule, les flux de travaux sont sélectionnés ou exclus s ils comportent des dépendances d invite. started[=heure heure_min,,heure_max heure_min,heure_max] Sélectionne ou exclut les flux de travaux selon qu ils ont été lancés ou non. heure Indique l heure de début exact des flux de travaux, exprimée comme suit : hhmm [date] [ timezone tz fuseau_horaire] hhmm Heure et minute. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du flux de travaux. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les flux de travaux qui sont lancés à cette heure ou après sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les flux de travaux qui sont lancés à cette heure ou avant sont sélectionnés. Si l option started est utilisée seule, la plage est extensible et les flux de travaux sont sélectionnés ou exclus selon qu ils ont été lancés ou non. state=état[,...] Sélectionne ou exclut les flux de travaux en fonction de leur état. état Indique l état courant du flux de travaux. Les états des flux de travaux sont les suivants : abend Le flux de travaux ne s est pas achevé normalement. add L agenda vient d être soumis. exec Le flux de travaux est en cours d exécution. hold Le flux de travaux attend la résolution de dépendances. ready Le flux de travaux est prêt à être lancé et toutes les dépendances sont résolues. stuck L exécution est interrompue. Aucun travail n est lancé sans l intervention de l opérateur. succ Le flux de travaux s est achevé correctement. until[=heure heure_min heure_max heure_min,heure_max [absolute abs]] Sélectionne ou exclut les flux de travaux en fonction de l heure de fin planifiée. heure Indique l heure de fin planifiée exprimée comme suit : hhmm[+n days date] [timezone tz fuseau_horaire] hhmm Heure et minute. 148 IBM Tivoli Workload Scheduler - Guide de référence

173 + n days Occurrence suivante de hhmm en n nombre de jours. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du flux de travaux. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. heure_min Indique la limite inférieure d une plage horaire exprimée au même format que l heure. Les flux de travaux dont l heure de fin planifiée est égale ou postérieure à l heure indiquée sont sélectionnés. heure_max Indique la limite supérieure d une plage horaire, exprimée au même format que l heure. Les flux de travaux dont l heure de fin planifiée est égale ou antérieure à l heure indiquée sont sélectionnés. absolute abs Indique l heure de début planifiée pour le jour présent. Ce mot clé peut être utilisé uniquement avec timezone tz fuseau_horaire et hhmm. Il respecte les règles suivantes : v Lorsque hhmm est antérieure à l heure courante, le travail débute immédiatement. v Si l heure hhmm est postérieure à l heure courante, le travail débutera à l heure de début hhmm du jour présent. v Lorsque hhmm dépasse 2400, elle est divisée par 2400 pour obtenir le jour et l heure. La partie entière du résultat de la division représente le jour (nombre de jours en +), tandis que la partie décimale représente l heure : Si l heure calculée est antérieure à l heure courante, le travail débutera à l heure calculée la veille du jour calculé. Si l heure calculée est postérieure à l heure courante, le travail débutera le jour et à l heure calculés. Par exemple, si l heure courante est 1200 et si le travail est soumis à hhmm = 3500 ( ), le mot clé indiqué étant abs, le travail sera lancé à 1100 le jour suivant. Dans le cas où le mot clé abs n est pas indiqué, le travail sera lancé à 1100 deux jours plus tard. Si l option until est utilisée seule, la plage est extensible et les flux de travaux sont sélectionnés ou exclus selon qu ils sont associés ou non à une heure de fin planifiée. Chapitre 5. Référence au programme Conman 149

174 Description des commandes Les pages suivantes décrivent de manière détaillée les commandes Conman. Remarque : Dans les commandes, les termes sched et schedule se rapportent aux flux de travaux et le terme cpu aux postes de travail. Traitement des commandes Conman Lorsque vous utilisez plusieurs commandes, il est important que vous connaissiez le mode de traitement des commandes. Lorsque vous modifiez les dépendances d un travail ou d un agenda dans symphony, conman empêche l insertion de ces dépendances en empêchant que la commande correspondante ne soit transmise à Batchman. Toutefois, il se peut qu une telle modification apparaisse comme ne s étant pas terminée avec succès alors que c est pourtant le cas. La raison est la suivante : conman n écrit pas directement dans symphony, mais demande à Batchman de le faire. Batchman reçoit les événements qui se produisent sur chaque système du réseau, et suivant la même séquence. A mesure que Batchman traite ces événements, les états de symphony changent dans le réseau du planificateur. Dans le cas où un Batchman est occupé, pour quelque raison que ce soit, les commandes conman sont mises en file d attente ; symphony n est mis à jour que lorsque Batchman est en mesure de lire les commandes depuis la boîte aux lettres et de les exécuter. Ainsi, une commande conman peut effectuer différentes actions, selon le moment où elle est exécutée. En outre, lorsque Batchman traite l événement, l utilisateur ne reçoit aucune notification. En conclusion, il se peut que vous supprimiez une dépendance et que la suppression n apparaisse pas parce que Batchman était occupé. Si vous réexécutez la commande, il se peut que la suppression soit effective alors qu un message indique que la commande a été transmise à Batchman. 150 IBM Tivoli Workload Scheduler - Guide de référence

175 adddep job Ajoute des dépendances à un travail. Vous devez avoir un accès adddep au travail. Pour inclure des dépendances needs et prompt, vous devez avoir un accès use aux ressources et aux invites globales. Syntaxe adj travail_sélectionné[;dépendance[;...]][;noask] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. dépendance Type de dépendance. Indiquez l un des éléments suivants. Les caractères génériques ne sont pas admis. at=hhmm[timezone tz fuseau_horaire][+n days mm/jj/aa] [absolute abs] confirmed deadline=heure [timezone tz fuseau_horaire][+n day[s mm/jj/aa] every=fréquence travail[,...] needs=[num] [poste_travail#]ressource[,...] opens=[poste_travail#] nom_fichier [(qualifiant)][,...] priority[=pri hi go] prompt= [:!]texte nom_invite[,...] until heure [timezone tz fuseau_horaire][+n day[s]] [absolute abs] [onuntil action] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Si aucune valeur n est indiquée pour priority, le travail retourne à sa priorité planifiée initialement. Si aucun poste de travail n est indiqué dans follows, needs ou opens, le poste de travail sur lequel le travail s exécute est utilisé par défaut. Pour ajouter des dépendances d invite lors de l exécution de Conman sur un agent à tolérance de pannes, vous devez avoir accès au répertoire racine_tws/mozart du gestionnaire de domaine maître. Vous ne pouvez pas utiliser la commande pour ajouter une ressource ou une invite sous la forme de dépendances, sauf si ces dernières sont déjà référencées par un travail ou un agenda dans le fichier Symphony. Exemples Pour ajouter une dépendance de ressource au travail job3 du flux de travaux sked9, exécutez la commande suivante : adddep sked9.job3;needs=2 tapes Pour ajouter une dépendance de fichier et une échéance until au travail job6 du flux de travaux sked2, exécutez la commande suivante : adj sked2.job6;opens="/usr/lib/prdata/file5"(-s %p); until=2330 Chapitre 5. Référence au programme Conman 151

176 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création de dépendances entre des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 152 IBM Tivoli Workload Scheduler - Guide de référence

177 adddep sched Ajoute des dépendances à un flux de travaux. Vous devez avoir un accès adddep au flux de travaux. Pour inclure des dépendances needs et prompt, vous devez avoir un accès use aux ressources et aux invites globales. Syntaxe ads flux_travaux_sélectionné[;dépendance[;...]][;noask] Arguments flux_travaux_sélectionné Voir «Sélection de flux de travaux dans les commandes», à la page 143. dépendance Type de dépendance. Indiquez l un des éléments suivants. Les caractères génériques ne sont pas admis. at=hhmm[timezone tz fuseau_horaire][+n days mm/jj/aa] [absolute abs] carryforward deadline=heure [timezone tz fuseau_horaire][+n day[s mm/jj/aa] travail[,...] limit=limite needs=[num] [poste_travail#]ressource[,...] opens=[poste_travail#] nom_fichier [(qualifiant)][,...] priority[=pri hi go] prompt= [:!]texte nom_invite[,...] until heure [timezone tz fuseau_horaire][+n day[s]] [absolute abs] [onuntil action] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque flux de travaux significatif. Remarques v Si aucune valeur n est indiquée pour priority, le flux de travaux retourne à sa priorité planifiée à l origine. v Si vous n indiquez aucune valeur pour limit, 0 est la valeur par défaut. v Si aucun poste de travail n est indiqué dans follows, needs ou opens, le poste de travail sur lequel le flux de travaux s exécute est utilisé par défaut. v Pour ajouter des dépendances d invite lors de l exécution de Conman sur un agent à tolérance de pannes, vous devez avoir accès au répertoire racine_tws/mozart du gestionnaire de domaine maître. v Vous ne pouvez pas utiliser la commande pour ajouter une ressource ou une invite sous la forme de dépendances, sauf si ces dernières sont déjà référencées par un travail ou un agenda dans le fichier Symphony. Exemples Pour ajouter une dépendance d invite au flux de travaux sked3, exécutez la commande suivante : adddep sched=sked3;prompt=msg103 Chapitre 5. Référence au programme Conman 153

178 Pour ajouter une dépendance follows et un nombre maximal de travaux au flux de travaux sked4, exécutez la commande suivante : ads sked4;follows=sked3;limit=2 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création de dépendances dans un flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 154 IBM Tivoli Workload Scheduler - Guide de référence

179 altpass Modifie le mot de passe d un objet utilisateur dans le plan de production en cours. Vous devez avoir un accès altpass à l objet utilisateur. Syntaxe altpass [poste_travail#]nom_utilisateur[; mot_de_passe ] Arguments poste_travail Indique le poste de travail sur lequel l utilisateur est défini. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. nom_utilisateur Indique le nom d un utilisateur. mot_de_passe Indique le nouveau mot de passe. Celui-ci doit être placé entre guillemets. Pour n indiquer aucun mot de passe pour l utilisateur, utilisez deux guillemets consécutifs ( ). Remarques Si vous n indiquez aucun mot de passe, Conman vous invite à entrer un mot de passe et une confirmation. Dans ce cas, le mot de passe ne s affiche pas lorsqu il est saisi et ne doit pas être placé entre guillemets. Il est à noter que la modification s effectue uniquement dans le plan de production en cours. Elle est donc temporaire. Pour procéder à une modification permanente, voir «Définitions d utilisateur», à la page 54. Exemples Pour remplacer le mot de passe de l utilisateur jim sur le poste de travail mis5 par giraffe, exécutez la commande suivante : altpass mis5#jean; girafe Pour remplacer le mot de passe de l utilisateur jim sur le poste de travail mis5 par giraffe sans afficher le mot de passe, exécutez la commande suivante : altpass mis5#jean password: xxxxxxxx confirm: xxxxxxxx Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Changement des mots de passe utilisateur Windows du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 155

180 altpri Modifie la priorité d un travail ou d un flux de travaux. Vous devez avoir un accès altpri au travail ou au flux de travaux. Syntaxe ap travail_sélectionné flux_travaux_sélectionné[;pri][;noask] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. flux_travaux_sélectionné Voir «Sélection de flux de travaux dans les commandes», à la page 143. pri Indique le niveau de priorité. Vous pouvez entrer une valeur comprise entre 0 et 99, hi ou go. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail ou flux de travaux significatif. Exemples Pour modifier la priorité du travail balance du flux de travaux glmonth, exécutez la commande suivante : altpri glmonth.balance;55 Pour modifier la priorité de tous les travaux du flux de travaux mis5, exécutez la commande suivante : ap mis5.@;25 Pour modifier la priorité du flux de travaux glmonth, exécutez la commande suivante : altpri glmonth;10 Pour modifier la priorité du flux de travaux mis5, exécutez la commande suivante : ap mis5; IBM Tivoli Workload Scheduler - Guide de référence

181 cancel job Annule un travail. Vous devez avoir un accès cancel au travail. Syntaxe cj travail_sélectionné[;pend][;noask] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. pend Annule le travail uniquement après la résolution de ses dépendances. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Si un travail est annulé avant d être lancé, il ne va pas démarrer. Si vous annulez un travail après l avoir lancé, il continue son exécution. Si un travail en cours d exécution est annulé et qu il se termine sur un état abend, aucune tentative de récupération automatique du travail n est effectuée. Si l option ;pend n est pas utilisée, les travaux et les flux de travaux qui dépendent du travail annulé sont libérés immédiatement de la dépendance. Si l option ;pend est indiquée et que le travail n a pas été lancé, l annulation est différée jusqu à ce que toutes les dépendances, y compris l heure d exécution définie par l argument at, soient résolues. Une fois que toutes les dépendances sont résolues, le travail est annulé et les travaux ou les flux de travaux qui dépendent du travail annulé sont libérés de la dépendance. Lors de la période pendant laquelle l annulation est différée, la mention [Cancel Pend] (annulation en cours) apparaît dans la colonne Dépendances du travail dans un écran showjobs. Si l option ;pend est indiquée et que le travail a déjà été lancé, cette option est ignorée et les travaux ou les flux de travaux qui dépendent du travail annulé sont immédiatement libérés de la dépendance. Vous pouvez utiliser la commande rerun pour relancer les travaux qui ont été annulés ou portant la mention [Cancel Pend] (annulation en cours). Vous pouvez aussi ajouter et supprimer des dépendances par rapport à des travaux associés à la mention [Cancel Pend]. Pour annuler immédiatement un travail associé à la mention [Cancel Pend], entrez une commande de libération du travail ou une commande d annulation sans l option ;pend. En ce qui concerne les travaux parvenus à échéance, la mention [Until] apparaît dans la colonne Dépendances d un écran showjobs et leurs dépendances ne sont plus évaluées. Si un travail de ce type porte également la mention [Cancel Pend], il n est annulé que lorsque vous libérez ou supprimez l échéance until ou entrez une autre commande cancel sans l option ;pend. Chapitre 5. Référence au programme Conman 157

182 Pour arrêter l évaluation des dépendances, affectez à la priorité d un travail la valeur zéro, à l aide de la commande altpri. Pour reprendre l évaluation des dépendances, affectez à la priorité une valeur supérieure à zéro. Remarque : Dans le cas des dépendances interréseaux, l annulation d un travail du flux de travaux externe permet de libérer tous les travaux et flux de travaux locaux de la dépendance. Les travaux du flux de travaux externes correspondent à des travaux et à des flux de travaux qui sont signalés comme étant des dépendances interréseaux. Le statut d une dépendance interréseau n est pas vérifié à la suite d une commande cancel. Pour plus d informations, voir «Dépendances interréseau», à la page 316. Exemples Pour annuler le travail report du flux de travaux apwkly sur le poste de travail site3, exécutez la commande suivante : cancel site3#apwkly.report Pour annuler le travail setup du flux de travaux mis5 qui n est pas à l état abend, exécutez la commande suivante : cj mis5.setup~state=abend Pour annuler le travail job3 du flux de travaux sked3 une fois ses dépendances résolues, exécutez la commande suivante : cj sked3.job3;pend Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Suppression d un travail dans un flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 158 IBM Tivoli Workload Scheduler - Guide de référence

183 cancel sched Annule un flux de travaux. Vous devez avoir un accès cancel au flux de travaux. Syntaxe cs flux_travaux_sélectionné[;pend][;noask] Arguments flux_travaux_sélectionné Voir «Sélection de flux de travaux dans les commandes», à la page 143. pend Annule le flux de travaux uniquement après la résolution de ses dépendances. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque flux de travaux significatif. Remarques Si un flux de travaux est annulé avant d être lancé, il ne va pas démarrer. S il est annulé une fois qu il est lancé, les travaux en cours sont exécutés jusqu à la fin mais aucun autre travail n est lancé. Si l option ;pend n est pas utilisée, les travaux et les flux de travaux qui dépendent du flux de travaux annulé sont libérés immédiatement de la dépendance. Si l option ;pend est indiquée et que le flux de travaux n a pas été lancé, l annulation est différée jusqu à ce que toutes les dépendances, y compris l heure d exécution indiquée par l argument at, soient résolues. Une fois que toutes les dépendances sont résolues, le flux de travaux est annulé et les travaux ou les flux de travaux dépendants sont libérés de la dépendance. Lorsqu une annulation est différée, la mention [Cancel Pend] (Annulation en cours) apparaît dans la colonne Dépendances d un écran showschedules. Si l option ;pend est indiquée et que le flux de travaux a déjà été lancé, les travaux non encore lancés sont annulés et les travaux et flux de travaux dépendants sont libérés de la dépendance. Pour annuler immédiatement un flux de travaux marqué [Cancel Pend], entrez une commande de release pour le flux de travaux ou une autre commande cancel sans l option ;pend. En ce qui concerne les flux de travaux parvenus à échéance, la mention [Until] apparaît dans la colonne Dépendances de la fenêtre showschedules et leurs dépendances ne sont plus évaluées. Si un travail de ce type porte également la mention [Cancel Pend], il n est annulé que lorsque vous libérez ou supprimez l échéance until ou entrez une autre commande cancel sans l option ;pend. Pour arrêter l évaluation des dépendances, affectez la valeur de priorité zéro au flux de travaux à l aide de la commande altpri. Pour reprendre l évaluation des dépendances, affectez à la priorité une valeur supérieure à zéro. Chapitre 5. Référence au programme Conman 159

184 Exemples Pour annuler le flux de travaux sked1 sur le poste de travail site2, exécutez la commande suivante : cancel site2#sked1 Pour annuler le flux de travaux mis2 qui est à l état stuck, exécutez la commande suivante : cs mis2+state=stuck Pour annuler le flux de travaux sked3 une fois ses dépendances résolues, exécutez la commande suivante : cs sked3;pend Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Suppression de flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 160 IBM Tivoli Workload Scheduler - Guide de référence

185 confirm Confirme la fin d un travail qui a été planifié à l aide du mot clé confirmed. Il existe une exception (voir Remarques ). Vous devez avoir un accès confirm au travail. Syntaxe confirm travail_sélectionné;{succ abend}[;noask] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. succ Confirme que le travail a abouti. abend Confirme que le travail a échoué. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Il n est pas nécessaire d utiliser le mot clé confirmé lors de la planification du travail pour que ce dernier passe de l état abend à succ. Pour plus d informations sur la confirmation d un travail, voir «confirmed», à la page 98. Pour plus d informations sur les travaux externes, voir «Dépendances interréseau», à la page 316. Le tableau suivant présente l incidence de la commande confirm sur les divers états des travaux : Etat initial du travail Etat après confirm : réussite Etat après confirm : arrêt anormal ready aucune incidence aucune incidence hold aucune incidence aucune incidence exec succp abenp abenp succp aucune incidence succp aucune incidence aucune incidence pend succ abend done succ abend succ aucune incidence aucune incidence abend succ aucune incidence fail aucune incidence aucune incidence skel aucune incidence aucune incidence tout travail externe succ abend Exemples Pour générer une confirmation succ si le travail job3 du flux de travaux misdly réussit, exécutez la commande suivante : confirm misdly.job3;succ Chapitre 5. Référence au programme Conman 161

186 Pour générer une confirmation abend si le travail 234 échoue, exécutez la commande suivante : conf 234;abend 162 IBM Tivoli Workload Scheduler - Guide de référence

187 console Opère l affectation de la console et définit le niveau de message. Vous devez avoir un accès console au poste de travail. Syntaxe console [sess sys][;level=niveau_message] Arguments sess Envoie des messages écran et des invites du planificateur à la sortie standard. sys Stoppe l envoi des messages écran et des invites du planificateur à la sortie standard. Ce processus se déroule automatiquement lorsque vous arrêtez Conman. niveau_message Niveau des messages du planificateur qui sont envoyés à la console. Indiquez l un des niveaux suivants : 0 Aucun message. Il s agit du niveau par défaut des agents à tolérance de pannes. 1 Messages d exception tels que des invites opérateur, et des fins anormales de travail. 2 Niveau 1 avec messages d aboutissement du flux de travaux. 3 Niveau 2 avec messages d aboutissement du travail. Il s agit du niveau par défaut du gestionnaire de domaine maître. 4 Niveau 3 avec messages de lancement de travail. Remarques Si la commande console est entrée sans aucune option, l état en cours de la console s affiche. Par défaut, les processus de contrôle du planificateur écrivent les messages écran et les invites dans les fichiers de listage standard. Sur UNIX, ils peuvent également être envoyés au démon syslog. Exemples Pour lancer l écriture des invites et des messages de console dans la sortie standard et définir le niveau des messages sur 1, exécutez la commande suivante : console sess;level=1 Pour interrompre l écriture des invites et des messages de console dans la sortie standard et définir le niveau des messages sur 4, exécutez la commande suivante : cons sys;l=4 Pour afficher l état courant de la console, exécutez la commande suivante : cons Console is #J675, level 2, session 675 correspond à l ID processus du shell de l utilisateur. Chapitre 5. Référence au programme Conman 163

188 continue Ignore l erreur de commande suivante. Syntaxe continue Remarques Cette commande est utile lorsque des commandes sont entrées de façon non interactive. Elle charge Conman de poursuivre l exécution des commandes même si la commande qui suit continue donne lieu à une erreur. Exemples Pour demander au programme Conman de continuer à utiliser la commande rerun même si la commande cancel échoue, exécutez la commande suivante : conman "continue&cancel=176&rerun job=sked5.job3" 164 IBM Tivoli Workload Scheduler - Guide de référence

189 deldep job Supprime des dépendances d un travail. Vous devez avoir un accès deldep au travail. Syntaxe ddj travail_sélectionné;dépendance[;...][;noask] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. dépendance Type de dépendance. Indiquez au moins l un des éléments suivants. Vous pouvez utiliser des caractères génériques dans les arguments poste_travail, flux_travaux, travail, ressource, nom_fichier et nom_invite. at[=heure heure_min heure_max heure_min,heure_max] confirmed deadline[=heure[timezone tz fuseau_horaire][+n days mm/jj/aa]] every travail[,...]] needs[=[num] [poste_travail#]ressource[,...]] opens[=[poste_travail#] nom_fichier [(qualifiant)][,...]] priority prompt[= [:!]texte nom_invite[,...]] until[=heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action]] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Si l option priority est supprimée, le travail retourne à sa priorité planifiée à l origine. Lors de la suppression d une dépendance opens, vous pouvez inclure uniquement le nom de fichier de base. Conman recherche ensuite, sans faire de distinction majuscules/minuscules, les fichiers concordants, sans tenir compte des noms de répertoires. Les dépendances sur tous les fichiers concordants sont supprimées. Dans certaines circonstances, la commande deldep, une fois soumise, est susceptible de s exécuter avec succès, même si elle est à nouveau envoyée au Batchman. Pour plus d informations, voir «Traitement des commandes Conman», à la page 150. Exemples Pour supprimer une dépendance de ressource dans le travail job3 du flux de travaux sked5, exécutez la commande suivante : deldep sked5.job3;needs=2 tapes Chapitre 5. Référence au programme Conman 165

190 Pour supprimer toutes les dépendances follows dans le travail job4 du flux de travaux sked3, exécutez la commande suivante : ddj sked3.job4;follows Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Gestion des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 166 IBM Tivoli Workload Scheduler - Guide de référence

191 deldep sched Supprime des dépendances d un flux de travaux. Vous devez avoir un accès deldep au flux de travaux. Syntaxe dds flux_travaux_sélectionné;dépendance[;...][;noask] Arguments flux_travaux_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. dépendance Type de dépendance. Indiquez au moins l un des éléments suivants. Vous pouvez utiliser des caractères génériques dans les arguments poste_travail, flux_travaux, travail, ressource, nom_fichier et nom_invite. at[=heure heure_min heure_max heure_min,heure_max] carryforward deadline[=heure[timezone tz fuseau_horaire][+n days mm/jj/aa]] travail[,...]] limit needs[=[num] [poste_travail#]ressource[,...]] opens[=[poste_travail#] nom_fichier [(qualifiant)][,...]] priority prompt[= [:!]texte nom_invite[,...]] until[=heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action]] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque flux de travaux significatif. Remarques Si l option priority est supprimée, le travail retourne à sa priorité planifiée à l origine. Lors de la suppression d une dépendance opens, vous pouvez inclure uniquement le nom de fichier de base. Conman recherche ensuite, sans faire de distinction majuscules/minuscules, les fichiers concordants, sans tenir compte des noms de répertoires. Les dépendances sur tous les fichiers concordants sont supprimées. Dans certaines circonstances, la commande deldep, une fois soumise, est susceptible de s exécuter avec succès, même si elle est à nouveau envoyée au Batchman. Pour plus d informations, voir «Traitement des commandes Conman», à la page 150. Exemples Pour supprimer une dépendance de ressource dans le flux de travaux sked5, exécutez la commande suivante : deldep sked5;needs=2 tapes Pour supprimer toutes les dépendances follows du flux de travaux sked3, exécutez la commande suivante : dds sked3;follows Chapitre 5. Référence au programme Conman 167

192 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Gestion de flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 168 IBM Tivoli Workload Scheduler - Guide de référence

193 display Affiche un fichier de travail ou une définition de flux de travaux. Si vous indiquez un fichier par son nom, vous devez avoir un accès en lecture au fichier. En ce qui concerne les fichiers de travail et les définitions de flux de travaux, vous devez avoir un accès display au travail ou au flux de travaux. Syntaxe dfnom_fichier[;offline] djtravail_sélectionné[;offline] dsflux_travaux_sélectionné[;offline] Arguments nom_fichier Indique le nom du fichier, en général, un fichier script de travail. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : caractères alphanumériques, tirets (-), barres obliques (/), barres obliques inverses (\) et traits de soulignement (_). Les caractères génériques sont acceptés. Le fichier doit être accessible à partir de votre poste de travail de connexion. travail_sélectionné Travail dont le fichier de travail est affiché. Voir «Sélection de travaux dans les commandes», à la page 135. Le fichier de travail doit être accessible à partir de votre poste de travail de connexion. flux_travaux_sélectionné Flux de travaux dont la définition est affichée. Voir «Sélection de flux de travaux dans les commandes», à la page 143. Le répertoire mozart du planificateur sur le gestionnaire de domaine maître doit être accessible à partir de votre poste de travail de connexion. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Exemples Pour afficher le fichier c:\maestro\jclfiles\arjob3, exécutez la commande suivante : df c:\apps\maestro\jclfiles\arjob3 Pour afficher hors ligne le fichier script du travail job6 du flux de travaux sked3, exécutez la commande suivante : dj sked3.job6;off Pour afficher la définition du flux de travaux sked9, exécutez la commande suivante : ds sked9 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Gestion des travaux et Gestion des flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 169

194 exit Quitte le programme de ligne de commande Conman. Syntaxe e Remarques Si vous exécutez le programme de ligne de commande Conman en mode Aide sur UNIX, la commande active le programme Conman en mode Saisie de commande. Exemples Pour quitter le programme de ligne de commande Conman, exécutez la commande suivante : exit ou e 170 IBM Tivoli Workload Scheduler - Guide de référence

195 fence Modifie la priorité limite des travaux sur un poste de travail. Les travaux ne sont pas lancés si leur niveau de priorité est inférieur ou égal à la priorité limite définie pour les travaux. Vous devez avoir un accès fence au poste de travail. Syntaxe fence poste_travail;pri[;noask] Arguments poste_travail Indique le nom du poste de travail. Par défaut, il s agit de votre poste de travail de connexion. pri Indique le niveau de priorité. Vous pouvez entrer une valeur comprise entre 0 et 99, hi ou go. Si vous entrez system, la priorité limite affectée aux travaux a la valeur zéro. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque poste de travail significatif. Remarques La priorité limite empêche le lancement des travaux dont le niveau de priorité est faible, quel que soit le niveau de priorité affecté aux flux de travaux dont ils dépendent. Il est donc possible de différer l exécution des travaux de priorité faible dans des flux de travaux de priorité élevée tout en permettant le lancement des travaux de priorité élevée dans des flux de travaux de priorité faible. Lors du premier démarrage d IBM Tivoli Workload Scheduler après installation, la priorité limite des travaux a pour valeur zéro. Après avoir modifié la priorité limite, celle-ci est différée pendant le traitement préproduction au plan de production du jour suivant. Pour afficher la valeur en cours affectée à la priorité limite des travaux, utilisez la commande status. Exemples Pour modifier la priorité limite du poste de travail site4, exécutez la commande suivante : fence site4;20 Pour modifier la priorité limite du poste de travail sur lequel vous exécutez le programme Conman, exécutez la commande suivante : f ;40 Pour empêcher le planificateur de lancer tous les travaux sur le poste de travail tx3, exécutez la commande suivante : f tx3;go Pour définir sur zéro la priorité limite du poste de travail sur lequel vous exécutez le programme Conman, exécutez la commande suivante : f ;system Chapitre 5. Référence au programme Conman 171

196 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Affichage des propriétés d un poste de travail du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 172 IBM Tivoli Workload Scheduler - Guide de référence

197 help Affiche l aide relative aux commandes. Non disponible sur Windows. Syntaxe help commande Arguments commande Indique le nom d une commande système ou Conman. Pour les commandes Conman, entrez le nom complet de la commande ; les abréviations et les formats abrégés ne sont pas pris en charge. Dans le cas des commandes comportant deux mots, il suffit d entrer le premier mot pour afficher l aide relative à toutes les versions de la commande. Par exemple, si vous entrez help display, toutes les informations relatives aux commandes display file, display job, et display sched s affichent. Vous pouvez également entrer les mots clés suivants : commands Affiche la liste de toutes les commandes Conman. jobselect Répertorie des informations concernant la sélection des travaux relatifs aux commandes. jobstates Répertorie des informations relatives aux états des travaux. schedselect Répertorie des informations concernant la sélection des flux de travaux relatifs aux commandes. schedstates Répertorie des informations relatives aux états des flux de travaux. Exemples Pour afficher l aide relative à toutes les commandes Conman, exécutez la commande suivante : help commands Pour afficher les informations relatives à la commande fence, exécutez la commande suivante : help fence Pour afficher les informations relatives aux commandes altpri job et altpri sched, exécutez la commande suivante : h altpri Chapitre 5. Référence au programme Conman 173

198 kill Arrête l exécution d un travail. Sur UNIX, vous devez utiliser la commande UNIX kill. Syntaxe kill travail_sélectionné[;noask] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Le temps de réponse est plus long, car l opération kill n est pas réalisée par Conman mais par un processus de production du planificateur. A la suite de la commande kill, les travaux sont arrêtés et sont à l état abend (arrêt anormal). Les travaux ou les flux de travaux qui dépendent de ces travaux ne sont pas libérés. Ces travaux ne peuvent pas être exécutés à nouveau. Exemples Pour supprimer le travail report du flux de travaux apwkly sur le poste de travail site3, exécutez la commande suivante : kill site3#apwkly.report Pour supprimer le travail numéro 456, exécutez la commande suivante : k IBM Tivoli Workload Scheduler - Guide de référence

199 limit cpu Modifie le nombre maximal de travaux lancés sur un poste de travail d un agent standard. Vous devez avoir un accès limit au poste de travail. Syntaxe lc poste_travail;limite[;noask] Arguments poste_travail Indique le nom du poste de travail d un agent standard. Les caractères génériques sont acceptés. Par défaut, il s agit de votre poste de travail de connexion. limite Indique le nombre maximal de travaux. Vous pouvez entrer une valeur comprise entre 0 et L indication de system fixe le nombre maximal de travaux à zéro. Dans ce dernier cas, seuls les travaux dotés du niveau de priorité hi et go sont lancés sur le poste de travail. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque poste de travail significatif. Remarques Pour afficher le nombre maximal de travaux autorisés sur votre poste de travail de connexion, utilisez la commande status. Lors du premier démarrage d IBM Tivoli Workload Scheduler après installation, le nombre maximal de travaux de poste de travail a pour valeur zéro ; vous devez augmenter ce nombre avant de lancer des travaux. Une fois le nombre maximal modifié, celui-ci est différé lors du processus de production préalable au plan de production du jour suivant. Le planificateur tente de lancer autant de travaux que possible, dans les limites autorisées. Le nombre de processus qu il est possible de lancer sur un poste de travail est limité de fait. Si cette limite est atteinte, le système envoie un message indiquant que les ressources système ne sont pas disponibles. Lorsqu un travail ne peut pas être lancé pour cette raison, il passe à l état fail (échec). Une réduction du nombre maximal de travaux permet d éviter ces échecs. Exemples Pour modifier le nombre maximum de travaux du poste de travail site3, exécutez la commande suivante : limit cpu=site3;25 Pour modifier le nombre maximum de travaux du poste de travail sur lequel vous exécutez le programme Conman, exécutez la commande suivante : lc ;12 Pour modifier le nombre maximum de travaux du poste de travail rx12, exécutez la commande suivante : lc rx12;6 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Affichage des propriétés d un poste de travail du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 175

200 limit sched Modifie le nombre maximal de travaux d un flux de travaux. Vous devez avoir un accès limité aux flux de travaux. Syntaxe ls flux_travaux_sélectionné;limite[;noask] Arguments flux_travaux_sélectionné Voir «Sélection de flux de travaux dans les commandes», à la page 143. limite Indique le nombre maximal de travaux. Vous pouvez entrer une valeur comprise entre 0 et Si une limite de zéro est indiquée, aucun autre travail n est lancé à partir du flux de travaux. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque flux de travaux significatif. Exemples Pour modifier le nombre maximal de travaux dans tous les flux de travaux dont le nom comporte la mention sales, exécutez la commande suivante : limit sched=sales@;4 Pour modifier le nombre maximum de travaux du flux de travaux apwkly, exécutez la commande suivante : ls apwkly;6 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Gestion de flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 176 IBM Tivoli Workload Scheduler - Guide de référence

201 link Etablit des liaisons de données entre postes de travail. Dans un réseau planificateur, les agents standard et à tolérance de pannes sont reliés à leurs gestionnaires de domaine et ces derniers sont reliés à leurs gestionnaires de domaine parents. Les agents étendus ne sont pas reliés ; ils communiquent via un hôte. Vous devez avoir un accès link au poste de travail cible. Syntaxe lk [domaine!]poste_travail[;noask] Arguments domaine Indique le nom du domaine dans lequel des liaisons sont établies. Les caractères génériques sont acceptés. Cet argument est utile lors de la connexion de plusieurs postes de travail d un domaine. Par exemple, pour connecter tous les agents du domaine stlouis, utilisez la commande suivante : link stlouis!@ Le domaine n est pas requis si l argument poste_travail ne comporte pas de caractères génériques. Si le domaine n est pas indiqué et que l argument poste_travail comporte des caractères génériques, le domaine par défaut est celui où Conman est exécuté. poste_travail Indique le nom du poste de travail à connecter. Les caractères génériques sont acceptés. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque poste de travail significatif. Remarques Si l option autolink a pour valeur on dans une définition de poste de travail, ce dernier est connecté automatiquement à chaque démarrage du planificateur. Si l option autolink a pour valeur off, vous devez utiliser les commandes link et unlink pour contrôler le processus de connexion. Pour plus d informations sur la commande autolink, voir «Définitions de poste de travail», à la page 37. Lorsque l utilisateur possède un accès link aux postes de travail en cours de connexion, les règles ci-dessous s appliquent : v Un utilisateur exécutant Conman sur le gestionnaire de domaine maître peut relier n importe quel poste de travail du réseau. v Un utilisateur exécutant Conman sur un autre gestionnaire que le gestionnaire de domaine maître peut relier n importe quel poste de travail de son domaine et des domaines subordonnés. L utilisateur ne peut pas relier des postes de travail dans les domaines homologues. v Un utilisateur exécutant Conman sur un agent peut relier n importe quel poste de travail dans son domaine local à condition que le poste de travail soit un gestionnaire de domaine ou un hôte. Un agent homologue dans le domaine local ne peut pas être relié. v Pour relier un domaine subordonné lors de l exécution de Conman dans un domaine de niveau supérieur, il n est pas nécessaire que les liaisons intermédiaires soient ouvertes. Chapitre 5. Référence au programme Conman 177

202 Exemples La figure et le tableau qui suivent présentent les liaisons établies par les commandes link exécutées par les utilisateurs en différents points du réseau. DMn sont des gestionnaires de domaine et Ann sont des agents. Figure 3. Liaisons réseau Commande Liaisons établies par Utilisateur1 link Toutes les liaisons sont ouvertes. DM1-A11 DM1-A12 DM1-DM2 DM1-DM3 link DOMAINE3!@ DM3-A31 DM3-A32 link DOMAINE4!@ DM4-A41 DM4-A42 Liaisons établies par Utilisateur2 DM1-DM2 DM2-A21 DM2-A22 DM2-DM4 DM4-A41 DM4-A42 DM1-DM2 DM2-A21 DM2-A22 DM2-DM4 Liaisons établies par Utilisateur3 DM2-A21 DM2-A21 Non autorisé Non autorisé DM4-A41 DM4-A42 Non autorisé link DM2 DM1-DM2 Sans objet DM2-A21 link A42 DM4-A42 DM4-A42 Non autorisé link A31 DM3-A31 Non autorisé Non autorisé 178 IBM Tivoli Workload Scheduler - Guide de référence

203 listsym Répertorie les fichiers journaux du plan de production (Symphony). Vous devez avoir un accès display au fichier Symphony. Syntaxe listsym [;offline] Arguments offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande Date Date agenda Date utilisée par la commande schedulr pour la sélection des flux de travaux à exécuter. réelle Date à laquelle batchman a lancé l exécution du fichier Symphony. Heure de début Heure à laquelle batchman a lancé l exécution du fichier Symphony. Date de journalisation Date de consignation du plan (Symphony) par la commande stageman. Num. d exécution Numéro d exécution attribué au plan (Symphony). Il est utilisé en interne pour la synchronisation du réseau planificateur. Taille Taille du fichier journal dans les enregistrements. Num. de journalisation Numéro de consignation indiquant l ordre chronologique des fichiers journaux. Ce numéro peut être utilisé dans une commande setsym pour accéder à un fichier journal spécifique. Nom du fichier Nom du fichier journal attribué par la commande stageman. Exemples Pour afficher les fichiers journaux du plan de production, exécutez la commande suivante : listsym Pour afficher les fichiers journaux du plan de production sur le périphérique de sortie du programme Conman, exécutez la commande suivante : lis ;off Chapitre 5. Référence au programme Conman 179

204 recall Affiche des invites qui attendent une réponse. Vous devez avoir un accès display aux invites. Syntaxe rc [poste_travail][;offline] Arguments poste_travail Indique le nom du poste de travail sur lequel l invite a été émise. Si aucun poste de travail n est indiqué, seules les invites du poste de travail de connexion et les invites globales s affichent. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande Etat Etat de l invite. Les invites en attente sont toujours à l état ASKED (demandée). Message ou invite Pour les invites nommées, numéro de message, nom de l invite et texte du message. Pour les invites non nommées, numéro de message, nom du travail ou du flux de travaux et texte du message. Exemples Pour afficher les invites en attente générées sur le poste de travail où vous exécutez le programme Conman, exécutez la commande suivante : recall ou : rc Pour afficher les invites en attente du poste de travail site3, exécutez la commande suivante : rc site3 Pour afficher les invites en attente sur tous les postes de travail et envoyer les résultats au périphérique hors ligne, exécutez la commande suivante : 180 IBM Tivoli Workload Scheduler - Guide de référence

205 redo Modifie et exécute à nouveau la commande précédente. Syntaxe redo Contexte Si vous exécutez la commande redo, le programme Conman affiche la dernière commande que vous pouvez modifier et réexécuter à votre guise. Utilisez la barre d espacement pour placer le curseur sous le caractère à modifier, puis entrez les instructions ci-dessous. Instructions d[ rép ] Supprime le caractère situé au-dessus de la lettre d. Cette commande peut être suivie par d autres instructions. itexte Insère du texte avant le caractère situé au-dessus de la lettre i. rtexte Remplace un ou plusieurs caractères par du texte en commençant par le caractère au-dessus du r. Le remplacement est implicite si aucune autre instruction n est entrée. >texte Ajoute du texte à la fin de la ligne. >d[rép texte ] Supprime les caractères en fin de ligne. Cette commande peut être suivie d une autre instruction ou d un autre texte. >rtexte Remplace des caractères à la fin de la ligne par du texte. Exemples d instruction ddd Supprime les trois caractères au-dessus des d. iabc Insère abc avant le caractère situé au-dessus du i. rabc Remplace les trois caractères, en commençant par celui qui est situé au-dessus du r, par abc. abc Remplace les trois caractères situés au-dessus de abc, par abc. d diabc Supprime le caractère au-dessus du premier d, ignore un caractère, supprime le caractère au-dessus du second d, puis le remplace par abc. >abc Ajoute abc à la fin de la ligne. >ddabc Supprime les deux derniers caractères de la ligne, puis les remplace par abc. >rabc Remplace les trois derniers caractères de la ligne par abc. Chapitre 5. Référence au programme Conman 181

206 Exemples Pour insérer un caractère, exécutez la commande suivante : redo setsm 4 iy setsym 4 Pour remplacer un caractþre, exécutez la commande suivante : redo setsym 4 5 setsym IBM Tivoli Workload Scheduler - Guide de référence

207 release job Libère les travaux des dépendances. Vous devez avoir un accès release au travail. Syntaxe rj travail_sélectionné[;dépendance[;...]][;noask] Arguments travail_sélectionné Indique le ou les travaux à libérer. Voir «Sélection de travaux dans les commandes», à la page 135. dépendance Type de dépendance. Vous pouvez indiquer l un des éléments suivants. Vous pouvez utiliser des caractères génériques dans les arguments poste_travail, flux_travaux, travail, ressource, nom_fichier et nom_invite. at[=heure heure_min heure_max heure_min,heure_max] confirmed deadline[=heure[timezone tz fuseau_horaire][+n days mm/jj/aa]] every travail[,...]] needs[=[num] [poste_travail#]ressource[,...]] opens[=[poste_travail#] nom_fichier [(qualifiant)][,...]] priority prompt[= [:!]texte nom_invite[,...]] until[=heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action]] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Lors de la libération d une dépendance opens, vous pouvez inclure uniquement le nom de fichier de base. Conman recherche ensuite, sans faire de distinction majuscules/minuscules, les fichiers concordants, sans tenir compte des noms de répertoires. Les dépendances sur tous les fichiers concordants sont libérées. En ce qui concerne les dépendances needs, le travail libéré reçoit le nombre requis d unités de la ressource, même si celles-ci risquent de ne pas être disponibles. Cela peut entraîner l affichage d un nombre négatif par les unités disponibles dans une commande showresources. Lorsque vous libérez un travail d une dépendance de type priority, celui-ci reprend sa priorité d origine planifiée. Exemples Pour libérer le travail job3 du flux de travaux ap de toutes ses dépendances, exécutez la commande suivante : release job=ap.job3 Chapitre 5. Référence au programme Conman 183

208 Pour libérer le travail job2 du flux de travaux skedr de toutes ses dépendances opens, exécutez la commande suivante : rj skedr.job2;opens Pour libérer tous les travaux du poste de travail site4 de ses dépendances sur une invite baptisée glprmt, exécutez la commande suivante : rj site4#@.@;prompt=glprmt Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Libération des dépendances d une instance de travail du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 184 IBM Tivoli Workload Scheduler - Guide de référence

209 release sched Libère les flux de travaux des dépendances. Vous devez avoir un accès release au flux de travaux. Syntaxe rs flux_travaux_sélectionné[;dépendance[;...]][;noask] Arguments flux_travaux_sélectionné Voir «Sélection de flux de travaux dans les commandes», à la page 143. dépendance Type de dépendance. Indiquez l un des éléments suivants. Vous pouvez utiliser des caractères génériques dans les arguments poste_travail, flux_travaux, travail, ressource, nom_fichier et nom_invite. at[=heure heure_min heure_max heure_min,heure_max] carryforward deadline[=heure[timezone tz fuseau_horaire][+n days mm/jj/aa]] travail[,...]] limit needs[=[num] [poste_travail#]ressource[,...]] opens[=[poste_travail#] nom_fichier [(qualifiant)][,...]] priority prompt[= [:!]texte nom_invite[,...]] until[=heure [timezone tz fuseau_horaire][+n day[s]] [onuntil action]] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque flux de travaux significatif. Remarques Lors de la suppression d une dépendance opens, vous pouvez inclure uniquement le nom de fichier de base. Conman recherche ensuite, sans faire de distinction majuscules/minuscules, les fichiers concordants, sans tenir compte des noms de répertoires. Les dépendances sur tous les fichiers concordants sont libérées. En ce qui concerne les dépendances needs, le flux de travaux libéré reçoit le nombre requis d unités de la ressource, même si celles-ci risquent de ne pas être disponibles. Cela peut entraîner l affichage par les unités disponibles d un nombre négatif dans showresources. Lorsque vous libérez un agenda d une dépendance de type priority, le flux de travaux reprend sa priorité d origine. Dans certaines circonstances, la commande deldep, une fois soumise, est susceptible de s exécuter avec succès, même si elle est à nouveau envoyée au batchman. Pour plus d informations, voir «Traitement des commandes Conman», à la page 150. Chapitre 5. Référence au programme Conman 185

210 Exemples Pour libérer le flux de travaux ap de toutes ses dépendances, exécutez la commande suivante : release sched=ap Pour libérer le flux de travaux sked5 de toutes ses dépendances opens, exécutez la commande suivante : rs sked5;opens Pour libérer tous les flux de travaux du poste de travail site3 de ses dépendances dans le flux de travaux main#sked23, exécutez la commande suivante : rs site3#@;follows=main#sked23 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Libération des dépendances d une instance de flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 186 IBM Tivoli Workload Scheduler - Guide de référence

211 reply Répond à une invite de travail ou de flux de travaux. Vous devez avoir un accès reply à l invite nommée ou globale. Pour répondre à une invite non nommée, vous devez avoir un accès reply aux invites et au travail ou aux flux de travaux associés. Syntaxe reply { nom_invite [poste_travail#]num_message};reply[;noask] Arguments nom_invite Indique le nom d une invite globale. Les caractères génériques sont acceptés. poste_travail Indique le nom du poste de travail sur lequel une invite non nommée a été émise. num_message Indique le numéro de message d une invite non nommée. Vous pouvez afficher des numéros de message à l aide des commandes recall et showprompts. reply Indique la réponse : O pour oui ou N pour non. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque invite significative. Remarques Si la réponse est O, les dépendances sur l invite sont respectées. Si la réponse est N, les dépendances ne sont pas respectées et l invite n est pas émise de nouveau. Vous pouvez répondre aux invites avant qu elles soient émises. La commande showprompts permet d afficher toutes les invites, qu elles aient été émises ou non. Exemples Pour répondre O à l invite globale arprmt, exécutez la commande suivante : reply arprmt;y Pour répondre N au message 24 sur le poste de travail site4, exécutez la commande suivante : rep site4#24;n Chapitre 5. Référence au programme Conman 187

212 rerun Lance une nouvelle exécution d un travail. Vous devez avoir un accès rerun au travail. Syntaxe rr travail_sélectionné[;from=[poste_travail#]travail[;at=heure][;pri=pri]][;noask] rr travail_sélectionné[;step=étape][;noask] Arguments travail_sélectionné Indique le nom d un ou de plusieurs travaux. Les caractères génériques sont acceptés. from=[ poste_travail #] travail Indique le nom d un travail défini dans la base de données du planificateur dont le fichier ou la commande va être exécuté à la place du travail indiqué par l argument travail_sélectionné. at= poste_travail# Indique le nom du poste de travail sur lequel le travail from s exécute. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. travail Indique le nom de la définition de travail donnée par l argument from. Les types de noms de travail suivants ne sont pas admis : v Les noms des travaux soumis à l aide des commandes submit file et submit docommand. v Les noms d alias des travaux soumis à l aide de la commande submit job. Pour utiliser l argument from, vous devez avoir accès à la base de données du planificateur à partir de l ordinateur sur lequel Conman est en cours d exécution. heure Indique l heure à laquelle le travail doit être exécuté à nouveau, exprimée comme suit : hhmm [timezone tz fuseau_horaire][+n days date] Où : hhmm Heure et minute. + n days Occurrence suivante de hhmm en n nombre de jours. date Occurrence suivante de hhmm à la date indiquée, exprimée au format mm/jj/aa. timezone tz fuseau_horaire Nom du fuseau horaire du travail. Pour connaître les noms appropriés, voir Annexe B, «Gestion des fuseaux horaires», à la page 347. pri= pri Indique la priorité à affecter au travail réexécuté. Si aucune priorité n est indiquée, le travail reçoit la même priorité que le travail d origine. 188 IBM Tivoli Workload Scheduler - Guide de référence

213 step= étape Indique que le travail est réexécuté à l aide de ce nom, à la place du nom de travail d origine. Pour plus d informations, voir Remarques. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Vous pouvez réexécuter des travaux qui sont à l état succ, fail ou abend. Un travail réexécuté est placé dans le même flux de travaux que le travail d origine, et hérite des dépendances de ce dernier. Si vous réexécutez un travail répétitif (every), le travail sera réexécuté selon la même fréquence que le travail d origine. Remarque : Vous pouvez soumettre la commande rerun pour les travaux du flux de travaux externes qui ont généré une erreur. Les travaux du flux de travaux externes correspondent à des travaux et à des flux de travaux qui sont signalés comme étant des dépendances interréseaux. Après toute exécution de la commande rerun, le travail passe immédiatement à l état extrn après quoi Conman commence à vérifier l état. Lorsque l option ;from est utilisée, le nom du travail réexécuté est fonction de la valeur de l option globale retain rerun job names. Si l option a pour valeur O, les travaux réexécutés conservent les noms de travaux d origine. Si l option a pour valeur N, les noms de travaux from sont attribués aux travaux réexécutés. Pour plus d informations, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Dans les écrans Conman, les travaux réexécutés qui s affichent portent la mention >>rerun as. Pour faire référence à un travail réexécuté dans une autre commande telle que altpri, vous devez utiliser le nom de travail d origine. Lors de la réexécution d un travail à l aide de l option ;step le travail s exécute sous le nom step à la place de son nom d origine. Dans un script de travail, vous pouvez utiliser la commande jobinfo pour revenir au nom du travail, puis exécuter le script différemment pour chaque itération. Dans le script UNIX suivant, la commande jobinfo permet d affecter à une variable STEP le nom qui a été utilisé pour exécuter le travail. Le programme utilise ensuite la variable STEP pour déterminer le mode d exécution du script.... MPATH=`maestro` STEP=`$MPATH/bin/jobinfo if [$STEP = JOB3] then... STEP=JSTEP1 fi if [$STEP = JSTEP1] then... STEP=JSTEP2 fi if [$STEP = JSTEP2] then... fi... job_name` Chapitre 5. Référence au programme Conman 189

214 Dans les écrans Conman, les travaux réexécutés avec l option ;step s affichent avec la mention >>rerun step. Pour plus d informations sur l option jobinfo, voir «jobinfo», à la page 257. Exemples Pour réexécuter le travail job4 du flux de travaux sked1 sur le poste de travail main, exécutez la commande suivante : rerun main#sked1.job4 Pour réexécuter le travail job5 du flux de travaux sked2 en utilisant la définition du travail jobx dont l heure d exécution at et la priorité sont respectivement définies sur 18:30 et 25, exécutez la commande suivante : rr sked2.job5;from=jobx;at=1830;pri=25 Pour réexécuter le travail job3 du flux de travaux sked4 en utilisant le nom de travail jstep2, exécutez la commande suivante : rr sked4.job3;step=jstep2 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Réexécution d une instance de travail du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 190 IBM Tivoli Workload Scheduler - Guide de référence

215 resource Modifie le nombre total d unités d une ressource. Vous devez avoir un accès resource à la ressource. Syntaxe resource [poste_travail#]ressource;nombre[;noask] Arguments poste_travail Indique le nom du poste de travail sur lequel la ressource est définie. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. ressource Indique le nom de la ressource. nombre Indique le nombre total d unités de ressources. Les valeurs correctes sont comprises entre 0 et noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque ressource significative. Exemples Pour remplacer le nombre d unités de la ressource tapes par 5, exécutez la commande suivante : resource tapes;5 Pour remplacer le nombre d unités de la ressource jobslots du poste de travail site2 par 23, exécutez la commande suivante : res site2#jobslots;23 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Gestion des ressources de la base de données du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 191

216 setsym Sélectionne un fichier d archivage de plan de production. Les écrans de commande ultérieurs affichent le contenu du plan de production archivé. Les informations contenues dans un fichier d archivage de plan de production ne peuvent pas être modifiées. Syntaxe setsym [num_fichier] Arguments num_fichier Indique le numéro du fichier d archivage de plan de production. Si aucun numéro de fichier journal n est indiqué, le pointeur retourne en position zéro (plan de production en cours (Symphony)). Utilisez la commande listsym pour afficher la liste des numéros de fichiers d archivage. Exemples Pour sélectionner le fichier archive du plan de production 5, exécutez la commande suivante : setsym 5 Pour sélectionner le plan de production courant (Symphony), exécutez la commande suivante : set 192 IBM Tivoli Workload Scheduler - Guide de référence

217 showcpus Affiche des informations relatives aux postes de travail et aux liaisons. Syntaxe sc [[domaine!]poste_travail][;info ;link][;offline] Arguments domaine Indique le nom d un domaine. Par défaut, le programme utilise le domaine dans lequel la commande est en cours d exécution. poste_travail Indique le nom d un poste de travail. Par défaut, le programme utilise le poste de travail sur lequel la commande est en cours d exécution. Si vous omettez le domaine et le poste de travail, le programme génère les résultats suivants : v La commande suivante affiche tous les postes de travail figurant dans le domaine du poste de travail où la commande a été exécutée, ainsi que les gestionnaire de domaine connectés si le poste de travail est un gestionnaire de domaine. conman "sc" v La commande suivante affiche tous les postes de travail figurant dans le domaine du poste de travail où la commande a été exécutée, sans les gestionnaire de domaine connectés. conman info Affiche les informations au format info. link Affiche les informations au format link. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande La sortie de la commande est générée dans trois formats : standard, info et link. Format standard : ID poste de travail Nom du poste de travail auquel ces informations s appliquent. EXECUTION Numéro d exécution du fichier de contrôle de production (Symphony). NOEUD Type de noeud et type de poste de travail. Les types de noeuds sont les suivants : v UNIX v WINT v AUTRE Les types de postes de travail sont les suivants : v MAITRE v GESTIONNAIRE v FTA v S-AGENT v X-AGENT LIMITE Nombre maximal de travaux du planificateur. Chapitre 5. Référence au programme Conman 193

218 PRIORITE LIMITE Priorité limite des travaux. DATE HEURE Date et heure de début de l exécution du plan de production en cours (Symphony) par le planificateur. ETAT Etat des liaisons du poste de travail Peuvent comporter jusqu à cinq caractères et s affichent comme suit : [L] [T H X] [I] [J] [W H X] L La liaison principale est ouverte ( linked ) sur le gestionnaire de domaine/supérieur. T Liaison TCP/IP. H Le poste de travail est connecté via son hôte. X Le poste de travail est connecté comme agent étendu (x-agent). I Le programme jobman a terminé l initialisation au démarrage. J Le programme jobman est en cours d exécution. W Le poste de travail est connecté via TCP/IP. F Le poste de travail est complètement connecté via les liaisons principale et secondaires. Remarque : Si le poste de travail exécutant Conman correspond à l hôte de l agent étendu, x-agent est à l état LXI JX Si le poste de travail exécutant Conman ne correspond pas à l hôte de l agent étendu, x-agent est à l état LHI JH METHODE Nom de la méthode d accès indiquée dans la définition du poste de travail. Réservé uniquement aux agents étendus. DOMAINE Nom du domaine dont fait partie le poste de travail. Format info : ID poste de travail Nom du poste de travail auquel ces informations s appliquent. VERSION Version du programme jobman d IBM Tivoli Workload Scheduler. FUS HORAIRE Fuseau horaire du poste de travail. Il s agit de la même valeur que celle de la variable d environnement TZ. Pour un agent étendu, il s agit du fuseau horaire de son hôte. INFO Version du système d exploitation et modèle de matériel. Pour les agents étendus, aucune information n est répertoriée. Format link : ID poste de travail Nom du poste de travail auquel ces informations s appliquent. HOTE Nom du poste de travail servant d hôte à un agent standard ou à un agent étendu. Pour les gestionnaires de domaine et les agents à tolérance de pannes, ce nom est identique à l ID du poste de travail. Pour les postes de 194 IBM Tivoli Workload Scheduler - Guide de référence

219 travail d un agent standard, il s agit du nom du gestionnaire de domaine. Pour les agents étendus, ce nom correspond à celui du poste de travail hôte. OPT Etat des liaisons du poste de travail Peuvent comporter jusqu à cinq caractères et s affichent comme suit : [A] [F] [s] [T] A La liaison automatique est activée dans la définition du poste de travail. F Le mode Statut intégral est activé dans la définition du poste de travail. s ID du serveur mailman du poste de travail. T La liaison est définie comme TCP/IP. ADDR Numéro de port TCP du poste de travail. NOEUD Nom de noeud du poste de travail. Exemples 1. Pour afficher les informations relatives au poste de travail sur lequel vous exécutez le programme Conman au format info, exécutez la commande suivante : showcpus ;info 2. Pour afficher hors ligne les informations de liaison relatives à tous les postes de travail, exécutez la commande suivante : 3. Pour afficher les informations relatives au poste de travail, exécutez la commande suivante : showcpus Si vous exécutez la commande dans un environnement où la liaison principale du poste de travail avec son domaine ou gestionnaire supérieur n est pas active, le programme génère la sortie suivante : MASTER 360 *WNT MASTER /04/03 13:48 I J MASTERDM FTA1 360 WNT FTA /04/03 13:48 FTI JW MASTERDM FTA2 360 WNT FTA /04/03 13:48 FTI JW MASTERDM FTA3 360 WNT MANAGER /04/03 13:48 LTI JW DOMAIN1 FTA4 360 WNT FTA /04/03 13:48 F I J DOMAIN1 FTA5 360 WNT FTA /04/03 13:48 I J DOMAIN1 SA1 360 WNT S-AGENT /04/03 13:48 F I J DOMAIN1 XA_FTA4 360 OTHR X-AGENT /04/03 13:48 L I J DOMAIN1 FTA6 360 WNT MANAGER /04/03 13:48 F I J DOMAIN2 FTA7 360 WNT FTA /04/03 13:49 F I J DOMAIN2 Si vous exécutez la commande dans un environnement où la liaison principale du poste de travail avec son domaine ou gestionnaire supérieur n est pas active où au moins une liaison secondaire est active, le programme génère la sortie suivante : MASTER 360 *WNT MASTER /04/03 13:48 I J MASTERDM FTA1 360 WNT FTA /04/03 13:48 FTI JW MASTERDM FTA2 360 WNT FTA /04/03 13:48 FTI JW MASTERDM FTA3 360 WNT MANAGER /04/03 13:48 FTI JW DOMAIN1 FTA4 360 WNT FTA /04/03 13:48 F I J DOMAIN1 FTA5 360 WNT FTA /04/03 13:48 L I DOMAIN1 SA1 360 WNT S-AGENT /04/03 13:48 F I J DOMAIN1 XA_FTA4 360 OTHR X-AGENT /04/03 13:48 L I J DOMAIN1 FTA6 360 WNT MANAGER /04/03 13:48 F I J DOMAIN2 FTA7 360 WNT FTA /04/03 13:49 F I J DOMAIN2 Chapitre 5. Référence au programme Conman 195

220 Si vous exécutez la commande dans un environnement où la liaison principale du poste de travail avec son domaine ou gestionnaire supérieur et toutes les liaisons secondaires sont actives, le programme génère la sortie suivante : MASTER 360 *WNT MASTER /04/03 13:48 I J MASTERDM FTA1 360 WNT FTA /04/03 13:48 FTI JW MASTERDM FTA2 360 WNT FTA /04/03 13:48 FTI JW MASTERDM FTA3 360 WNT MANAGER /04/03 13:48 FTI JW DOMAIN1 FTA4 360 WNT FTA /04/03 13:48 F I J DOMAIN1 FTA5 360 WNT FTA /04/03 13:48 F I DOMAIN1 SA1 360 WNT S-AGENT /04/03 13:48 F I J DOMAIN1 XA_FTA4 360 OTHR X-AGENT /04/03 13:48 L I J DOMAIN1 FTA6 360 WNT MANAGER /04/03 13:48 F I J DOMAIN2 FTA7 360 WNT FTA /04/03 13:49 F I J DOMAIN2 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Utilisation des listes d objets du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 196 IBM Tivoli Workload Scheduler - Guide de référence

221 showdomain Affiche les informations relatives au domaine. Syntaxe showdomain [domaine][;info][;offline] Arguments domaine Indique le nom du domaine. Par défaut, le domaine dans lequel Conman est en cours d exécution est utilisé. Les caractères génériques sont acceptés. info Affiche les informations au format info. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande La sortie de la commande est générée dans deux formats : standard et info. Format standard : DOMAINE Nom du domaine auquel ces informations s appliquent. GESTIONNAIRE Nom du gestionnaire de domaine. PARENT Nom du domaine parent. Format info : DOMAINE Nom du domaine auquel ces informations s appliquent. POSTES DE TRAVAIL MEMBRES Noms des postes de travail du domaine. TYPE POSTE DE TRAVAIL Type de chaque poste de travail : MAITRE, GESTIONNAIRE, FTA, S-AGENT ou X-AGENT. Exemples Pour afficher les informations relatives au domaine masterdm, exécutez la commande suivante : showdomain masterdm Pour afficher les postes de travail appartenant à tous les domaines au format info, exécutez la commande suivante : Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Affichage des propriétés d un domaine du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 197

222 showfiles Affiche des informations relatives aux dépendances sur les fichiers. Une dépendance de fichier se produit lorsque la présence d un ou de plusieurs fichiers permet l exécution d un travail ou d un flux de travaux. Syntaxe sf [[poste_travail#]fichier][;état[;...]][;keys][;offline] sf [[poste_travail#]fichier][;état[;...]][;deps[;keys info logon]][;offline] Arguments poste_travail Indique le nom du poste de travail sur lequel se trouve le fichier. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. Les caractères génériques sont acceptés. fichier Indique le nom du fichier. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : caractères alphanumériques, tirets (-), barres obliques (/), barres obliques inversées (\) et traits de soulignement (_). Par défaut, toutes les dépendances sur les fichiers s affichent. Les caractères génériques sont acceptés. état Indique l état des dépendances de fichiers à afficher. Par défaut, les dépendances sur les fichiers s affichent avec tous les états. Les états sont les suivants : yes Le fichier existe et est disponible. no Le fichier n est pas disponible ou n existe pas.? La disponibilité est en cours de vérification. <blank> Le fichier n a pas encore été vérifié ou était disponible et a été utilisé pour respecter une dépendance par rapport à des travaux ou flux de travaux. keys Affiche la liste composée d une seule colonne des objets sélectionnés par la commande. deps Affiche les informations au format deps. Utilisez keys, info ou logon pour modifier l affichage. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande La sortie de la commande est générée dans trois formats : standard, keys et deps. Les arguments keys, info et logon modifient l affichage deps. Format standard : Existe Etat de la dépendance de fichier Nom de fichier Nom du fichier. 198 IBM Tivoli Workload Scheduler - Guide de référence

223 Format keys : Les fichiers sont répertoriés dans une liste, chacun d eux sur une ligne différente. Les noms de répertoires ne sont pas inclus. Chaque fichier est répertorié au format suivant : poste_travail#fichier Format deps : Les fichiers sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs standard. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;keys : Les travaux et les flux de travaux qui comportent des dépendances sur les fichiers sont répertoriés, un par ligne, au format suivant : poste_travail#flux_travaux[.job] Format deps;info : Les fichiers sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;info. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;logon : Les fichiers sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;logon. Les flux de travaux sont répertoriés au format showschedules standard. Exemples Pour afficher l état d une dépendance de fichier sur le fichierd:\apps\mis\lib\data4, exécutez la commande suivante : showfiles d:\apps\mis\lib\data4 Pour afficher hors ligne l état de toutes les dépendances de fichier sur tous les postes de travail au format deps, exécutez la commande suivante : Chapitre 5. Référence au programme Conman 199

224 showjobs Affiche les informations relatives aux travaux. Syntaxe sj [travail_sélectionné] [;keys info step logon retcod][;short single][;offline] sj[travail_sélectionné] [;deps[;keys info logon]][;short single][;offline] sj [travail_sélectionné] [;stdlist[;keys]][;short single ][;offline] Arguments travail_sélectionné Voir «Sélection de travaux dans les commandes», à la page 135. wkstation Nom du poste de travail sur lequel le travail est exécuté. Les caractères génériques sont acceptés. jobnumber Numéro du travail. hhmm Heure de démarrage du travail. Utilisez cet argument avec les arguments stdlist et single pour afficher une instance spécifique du travail. keys Affiche la liste composée d une seule colonne des objets sélectionnés par la commande. info Affiche les informations au format info. step Affiche les informations au format step. logon Affiche les informations au format logon. retcod Affiche le code retour du travail. stdlist Affiche les informations au format stdlist. Utilisez l argument keys pour modifier l affichage. deps Affiche les informations au format deps. Utilisez keys, info ou logon pour modifier l affichage. short Réduit l affichage des travaux réexécutés et répétitifs afin d inclure uniquement ce qui suit : v Première répétition v Travaux avec des états différents v Travaux concordant exactement single Sélectionne uniquement le travail parent d une chaîne pouvant inclure des réexécutions, des répétitions et des travaux de reprise. Le travail doit être identifié par son numéro dans travail_sélectionné. Cela est notamment utile avec l option stdlist. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande Le programme génère la sortie de la commande showjobs dans sept formats : standard, keys, info, step, logon, deps et stdlist. Les arguments keys, info et logon modifient l affichage. 200 IBM Tivoli Workload Scheduler - Guide de référence

225 Format standard : POSTE DE TRAVAIL Poste de travail sur lequel le travail s exécute. Agenda Nom du flux de travaux. Travail Nom du travail. Il se peut que la mention suivante précède un nom de travail : >> rerun as Travail réexécuté à l aide de la commande rerun ou par suite d une reprise automatique. >> rerun step Travail réexécuté à l aide de la commande rerun ;step. >> every run Deuxième exécution et exécutions ultérieures d un travail répétitif. >>recovery Exécution d un travail de reprise. Etat Etat du travail ou du flux de travaux. Les états des travaux sont les suivants : abend Le travail est terminé avec un code de sortie différent de zéro. abenp Une confirmation abend a été reçue mais le travail n est pas terminé. add Le travail est en cours de soumission. done Le travail est terminé avec un état inconnu. error Pour les dépendances interréseaux uniquement, une erreur s est produite lors de la recherche de l état distant. exec Le travail est en cours d exécution. extrn Pour les dépendances interréseaux uniquement, l état est inconnu. Une erreur s est produite, une action de réexécution vient d être effectuée sur le travail du flux de travaux externes, ou le travail ou le flux de travaux distant n existe pas. fail Impossible de lancer le travail. fence La priorité du travail est inférieure à la priorité limite. hold Le travail attend la résolution de dépendances. intro Le travail est introduit à des fins de lancement par le système. pend Le travail est terminé et attend une confirmation. ready Le travail est prêt à démarrer et toutes les dépendances sont résolues. sched L heure du travail indiquée par at n est pas arrivée. succ Le travail est terminé avec un code de sortie zéro. succp Une confirmation succ a été reçue mais le travail n est pas terminé. wait Le travail est à l état wait (agent étendu). Chapitre 5. Référence au programme Conman 201

226 Les états de flux de travaux sont les suivants : abend L exécution du flux de travaux s est terminée avec un code de sortie différent de zéro. add Le flux de travaux a été ajouté par intervention de l opérateur. cancel Le flux de travaux a été annulé. cancel pend Le flux de travaux est en cours d annulation. L annulation est reportée jusqu à ce que toutes les dépendances, y compris l heure at, soient résolues. error Pour les dépendances interréseaux uniquement, une erreur s est produite lors de la recherche de l état distant. exec Le flux de travaux est en cours d exécution. extrn Pour les dépendances interréseaux uniquement, le flux de travaux se trouve dans un réseau distant du planificateur et son statut est inconnu. Une erreur est survenue, une action de réexécution a été effectuée sur le flux de travaux externes ou le travail ou le flux de travaux INET n existe pas. hold Le flux de travaux attend la résolution de dépendances. ready Le flux de travaux est prêt à démarrer et toutes les dépendances sont résolues. stuck L exécution du flux de travaux a été interrompue. Aucun travail n est lancé sans l intervention de l opérateur. succ Le flux de travaux s est achevé correctement. Pr Priorité du travail ou du flux de travaux. Un signe plus (+) précédant la priorité indique que le travail a été lancé. Début prévu Heure de début du travail ou du flux de travaux. Les parenthèses indiquent une estimation de l heure de début. Si l heure de début dépasse 24 heures dans le passé ou dans l avenir, la date est répertoriée à la place de l heure. Durée écoulée estimée Heure d exécution du travail ou du flux de travaux. Les parenthèses indiquent une estimation basée sur les statistiques consignées. dépendances Liste des commentaires et des dépendances sur les travaux. Une combinaison des éléments suivants peut être répertoriée : v Pour une dépendance follows, un nom de travail ou de flux de travaux s affiche. v Pour une dépendance opens, le nom de fichier s affiche. Si le fichier réside sur un agent étendu et que son nom comporte plus de 25 caractères, seuls les 25 derniers caractères s affichent. v Pour une dépendance needs, un nom de ressource placé entre tirets (-) s affiche. Si le nombre d unités demandées est supérieur à un, le nombre s affiche avant le premier tiret. v Pour une heure d échéance deadline, l heure précédée du signe inférieur (<) s affiche. 202 IBM Tivoli Workload Scheduler - Guide de référence

227 v Pour une fréquence every, la fréquence de répétition précédée par une perluète (&) s affiche. v Pour une échéance until, l heure précédée du signe inférieur (<) s affiche. v Pour une dépendance prompt, le numéro d invite s affiche au format #num. Pour les invites globales, le nom d invite vient à la suite, entre parenthèses. v Pour les travaux en cours d exécution, le numéro d identification de processus (PID) s affiche au format #Jnnnnn. v Les travaux soumis sur UNIX via les commandes IBM Tivoli Workload Scheduler at et batch portent la mention [Userjcl]. v Les travaux annulés portent la mention [Cancelled]. v Les travaux annulés à l aide de l option ;pend portent la mention [Cancel Pend] (Annulation en cours). v Les travaux pour lesquels une heure d expiration est définie, y compris les travaux annulés avec l option ;pend, portent la mention [Until]. v [Recovery] signifie que l intervention de l opération est requise. v [Confirm] signifie qu une confirmation est requise car le travail a été planifié à l aide du mot clé confirm. v [Script] concerne les réseaux complets uniquement, c est-à-dire que le travail comporte un script centralisé et que Tivoli Workload Scheduler pour z/os ne l a pas encore chargé sur l agent. Format keys : Les noms des travaux sont répertoriés, un par ligne, au format suivant : poste_travail#flux_travaux.job Format info : Poste de travail Poste de travail sur lequel le travail s exécute. Agenda Nom du flux de travaux. Travail Nom du travail. Il se peut que la mention suivante précède un nom de travail : >> rerun as Travail réexécuté à l aide de la commande rerun ou par suite d une reprise automatique. >> rerun step Travail réexécuté à l aide de la commande rerun ;step. >> every run Deuxième exécution et exécutions ultérieures d un travail répétitif. >>recovery Exécution d un travail de reprise. Chapitre 5. Référence au programme Conman 203

228 Fichier du travail Nom du script ou du fichier exécutable du travail. Les noms de fichiers longs risquent de faire l objet d un renvoi à la ligne, ce qui donne lieu à un saut de page incorrect. Pour éviter cela, ajoutez le signe avant more. Par exemple : conman sj;info more Opt Option de reprise de travaux, s il y a lieu. Les options de reprise sont RE pour réexécution, CO pour poursuite et ST pour arrêt. Travail Nom du travail de reprise, s il y a lieu. Invite Numéro de l invite de reprise, s il y a lieu. Format step : Le format n est pas pris en charge sur Windows. POSTE DE TRAVAIL Poste de travail sur lequel le travail s exécute. Agenda Nom du flux de travaux. Travail Nom du travail. Il se peut que la mention suivante précède un nom de travail : >> rerun as Travail réexécuté à l aide de la commande rerun ou par suite d une reprise automatique. >> repeated as Deuxième exécution et exécutions ultérieures d un travail répétitif. Etat Etat du travail ou du flux de travaux. Pour connaître les informations d état, reportez-vous au Format standard. Code retour Le code retour du travail. #travail Numéro d identification de processus affiché au format #Jnnnnn. Etape Liste des processus descendants qui sont associés au travail. Pour les travaux d agent étendu, seuls les processus hôte sont répertoriés. Format logon : Poste de travail Poste de travail sur lequel le travail s exécute. Agenda Nom du flux de travaux. Travail Nom du travail. Il se peut que la mention suivante précède un nom de travail : >> rerun as Travail réexécuté à l aide de la commande rerun ou par suite d une reprise automatique. >> repeated as Deuxième exécution et exécutions ultérieures d un travail répétitif. 204 IBM Tivoli Workload Scheduler - Guide de référence

229 Etat Etat du travail ou du flux de travaux. Pour connaître les informations d état, reportez-vous au Format standard. Code retour Le code retour du travail. #travail Numéro d identification de processus affiché au format #Jnnnnn. Connexion Nom d utilisateur sous lequel le travail s exécute. Format stdlist : Chaque fois qu un travail est lancé par le processus Jobmon (Windows) ou Jobman (UNIX), le programme crée automatiquement le fichier de liste standard. Vous pouvez afficher le contenu des fichiers liste standard en utilisant le programme Conman. Les fichiers liste standard comprennent les informations suivantes : v Bannières de début et fin de page v Commandes echo v Sortie stdout du travail v Sortie stderr du travail Pour préciser un format de date particulier à utiliser dans les fichiers liste standard, modifiez le format de date IBM Tivoli Workload Scheduler avant de créer les fichiers. Il vous suffit de modifier le format de date local. Selon l environnement, modifiez le format de date local comme suit : v Sur UNIX, définissez la variable LANG dans l environnement au démarrage du processus Netman. Si la variable LANG n est pas définie, l environnement local du système d exploitation utilise C par défaut. v Sur Windows, procédez comme suit : 1. Cliquez sur Panneau de configuration Options régionales et linguistiques, puis modifiez l environnement local (emplacement). 2. Cliquez avec le bouton droit de la souris sur Poste de travail, sélectionnez Propriétés, cliquez sur Avancé et sur Variables d environnement, puis définissez la variable LANG dans les variables système. 3. Arrêtez et redémarrez le système. Les fichiers de liste standard des travaux sélectionnés s affichent. Format stdlist;keys : Les noms des fichiers de liste standard des travaux sélectionnés sont répertoriés, un par ligne. Format deps : Les travaux utilisés dans les dépendances follows sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs standard. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;keys : Les travaux et les flux de travaux qui comportent des dépendances follows sont répertoriés, un par ligne. Format deps;info : Les travaux utilisés dans les dépendances follows sont répertoriés, suivis des travaux et des flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;info. Les flux de travaux sont répertoriés au format showschedules standard. Chapitre 5. Référence au programme Conman 205

230 Format deps;logon : Les travaux utilisés dans les dépendances follows sont répertoriés, suivis des travaux et des flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;logon. Les flux de travaux sont répertoriés au format showschedules standard. Exemples Pour afficher le statut de tous les travaux de tous les flux de travaux acctg sur le poste de travail site3, exécutez la commande suivante : showjobs site3#acctg@.@ Pour afficher le statut de tous les travaux sur le poste de travail où vous exécutez le programme Conman au format logon, exécutez la commande suivante : sj ;logon Pour afficher le statut de tous les travaux à l état hold sur tous les postes de travail au format deps, exécutez la commande suivante : Pour afficher tous les fichiers liste standard du travail sendmail du flux de travaux mail sur le poste de travail WN1 tournant dans un environnement Windows, environnement multifenêtre : sj WN1#mail.sendmail;stdlist Le programme génère la sortie suivante : ================================================================= = TRAVAIL : WN1#MAIL.SENDMAIL = UTILISATEUR : xpress = FICHIER JCL : \users\xpress\sendxpmail = Numéro du travail : 8027 = Ven 5 Juin 12:17: ================================================================= <commandes stdout, stderr et echo>... ================================================================= = Statut de sortie : 0 = Système heure (Secondes) : 0 Durée écoulée (Minutes) : 0 = Temps utilisateur (Secondes) : 0 = Ven 5 Juin 12:17: ================================================================== Où : Statut de sortie Statut du travail à l issue de son exécution Durée écoulée Durée écoulée du travail Système heure Temps passé par le noyau système pour exécuter le travail Temps utilisateur Temps passé par l utilisateur système pour exécuter le travail Remarque : Les zones Système heure et Temps utilisateur sont utilisées sur UNIX uniquement. Sur Windows, leurs valeurs sont toujours définies sur 0 car le processus joblnch.exe est exécuté dans un bref délai qui peut être considéré comme nul. 206 IBM Tivoli Workload Scheduler - Guide de référence

231 Dans l exemple suivant, le programme affiche le statut du travail dbseload en générant le code retour 7 et l état TERMINE : $ conman sj workstation#daily_db_load TWS for UNIX (AIX)/CONMAN 8.2 ( ) Licensed Materials Property of IBM 5698-WKB (C) Copyright IBM Corp 1998,2001 US Government User Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Installé pour l utilisateur Variable locale LANG définie sur fr_fr Agenda (Exp) 09/30/03 (#126) sur MASTER. Batchman ACTIF. Limite : 10, Priorité limite : 0, Niveau d audit : 1 sj workstation#daily_db_load (Est) (Est) Poste travail Agenda Travail Etat Pr Démarrage Ecoulement Dépendances Code retour WORKSTATION #DAILY_DB_LOAD **************************************** SUCC 10 22:11 00:04 DATASPLT SUCC 10 22:11 00:01 #J DATAMRGE ABEND 10 22:12 00:01 #J CHCKMRGE SUCC 10 22:12 00:01 #J DATACLNS SUCC 10 22:12 00:01 #J DATARMRG SUCC 10 22:13 00:01 #J DBSELOAD SUCC 10 22:13 00:01 #J DATAREPT SUCC 10 22:13 00:01 #J DATARTRN SUCC 10 22:14 00:01 #J $ Le programme propose également un nouvel argument baptisé retcod. Si vous l associez à l argument keys, il renvoie le code retour d un travail défini (voir exemple suivant) : $ conman sj workstation#daily_db_load.dbseload\;keys\;retcod TWS for UNIX (AIX)/CONMAN 8.2 ( ) Licensed Materials Property of IBM 5698-WKB (C) Copyright IBM Corp 1998,2001 US Government User Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Installé pour l utilisateur Variable locale LANG définie sur fr_fr Agenda (Exp) 10/16/03 (#150) sur MASTER. Batchman ACTIF. Limite : 10, Priorité limite : 0, Niveau d audit : 1 sj workstation#daily_db_load.dbseload;keys;retcod 8$ Une fois intégrée à un script, la fonction retcod peut se révéler assez puissante. Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Utilisation des listes d objets du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 207

232 showprompts Affiche les informations relatives aux invites. Syntaxe sp[invite_sélectionnée][;keys][;offline] sp[invite_sélectionnée] [;deps[;keys info logon]][;offline] Arguments invite_sélectionnée [nom_invite [poste_travail#]num_message][;état[;...]] nom_invite Indique le nom d une invite globale. Les caractères génériques sont acceptés. poste_travail Indique le nom du poste de travail sur lequel une invite non nommée est émise. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. num_message Indique le numéro de message d une invite non nommée. état Indique l état des invites à afficher. Les états sont les suivants : OUI L invite a généré l envoi de la réponse y. NON L invite a généré l envoi de la réponse n. DEMANDEE L invite a été émise mais aucune réponse n a été générée. INACTIVE L invite n a pas été émise. keys Affiche la liste composée d une seule colonne des objets sélectionnés par la commande. deps Affiche les informations au format deps. Utilisez keys, info ou logon pour modifier l affichage. info Affiche les informations au format info. logon Affiche les informations au format logon. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande La sortie de la commande est générée dans trois formats : standard, keys et deps. Les arguments keys, info et logon modifient l affichage deps. Format standard : Etat Etat de l invite. Message ou invite Pour les invites nommées, numéro de message, nom et texte de l invite. Pour les invites non nommées, numéro de message, nom du travail ou du flux de travaux et texte de l invite. 208 IBM Tivoli Workload Scheduler - Guide de référence

233 Format keys : Les invites sont répertoriées, une par ligne. Les invites nommées sont répertoriées avec les noms et numéros de message qui leur sont associés. Les invites non nommées sont répertoriées avec les numéros de messages qui leur sont associés et avec les noms des travaux ou flux de travaux dans lesquels elles apparaissent sous forme de dépendances. Format deps : Les invites utilisées sous forme de dépendances sont répertoriées, suivies des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs standard. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;keys : Les travaux et les flux de travaux qui comportent des dépendances sur les invites sont répertoriés, un par ligne. Format deps;info : Les invites utilisées sous forme de dépendances sont répertoriées, suivies des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;info. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;logon : Les invites utilisées sous forme de dépendances sont répertoriées, suivies des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;logon. Les flux de travaux sont répertoriés au format showschedules standard. Exemples Pour afficher le statut de toutes les invites générées sur le poste de travail où vous exécutez le programme Conman, exécutez la commande suivante : showprompts Pour afficher le statut de toutes les invites mis générées au format deps format, exécutez la commande suivante : sp mis@;asked;deps Pour afficher le statut de l invite 34 sur le poste de travail main, exécutez la commande suivante : sp main#34 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Affichage des propriétés d une invite du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 209

234 showresources Affiche les informations relatives aux ressources. Syntaxe sr[[poste_travail#]nom_ressource][;keys][;offline] sr[[poste_travail#]nom_ressource][;deps[;keys info logon]][;offline] Arguments poste_travail Indique le nom du poste de travail sur lequel la ressource est définie. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. nom_ressource Indique le nom de la ressource. Les caractères génériques sont acceptés. keys Affiche la liste composée d une seule colonne des objets sélectionnés par la commande. deps Affiche les informations au format deps. Utilisez keys, info ou logon pour modifier l affichage. info Affiche les informations au format info. logon Affiche les informations au format logon. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande La sortie de la commande est générée dans trois formats : standard, keys et deps. Les arguments keys, info et logon modifient l affichage deps. Format standard : Poste de travail Poste de travail sur lequel la ressource est définie. Ressource Nom de la ressource. Total Nombre total d unités de ressources définies. Disponible Nombre d unités de ressources non allouées. Qté Nombre d unités de ressources allouées à un travail ou à un flux de travaux. Util par Nom du travail ou du flux de travaux. Format keys : Les ressources sont répertoriées, une par ligne. Format deps : Les ressources utilisées sous forme de dépendances sont répertoriées, suivies des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs standard. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;keys : Les travaux et les flux de travaux qui comportent des dépendances sur les ressources sont répertoriés, un par ligne. 210 IBM Tivoli Workload Scheduler - Guide de référence

235 Format deps;info : Les ressources utilisées sous forme de dépendances sont répertoriées, suivies des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;info. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;logon : Les ressources utilisées sous forme de dépendances sont répertoriées, suivies des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;logon. Les flux de travaux sont répertoriés au format showschedules standard. Exemples Pour afficher les informations relatives à toutes les ressources sur le poste de travail où vous exécutez le programme Conman, exécutez la commande suivante : showresources Pour afficher les informations relatives à la ressource dbase sur le poste de travail main au format deps, exécutez la commande suivante : sr main#dbase;deps Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Affichage des propriétés d une ressource du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 211

236 showschedules Affiche les informations relatives aux flux de travaux. Syntaxe ss[flux_travaux_sélectionné][;keys][;offline] ss[flux_travaux_sélectionné][;deps[;keys info logon]][;offline] Arguments flux_travaux_sélectionné Voir «Sélection de flux de travaux dans les commandes», à la page 143. keys Affiche la liste composée d une seule colonne des objets sélectionnés par la commande. deps Affiche les informations au format deps. Utilisez keys, info ou logon pour modifier l affichage. info Affiche les informations au format info. logon Affiche les informations au format logon. offline Envoie la sortie de la commande au périphérique de sortie de Conman. Pour plus d informations sur ce périphérique, voir «Sortie offline», à la page 130. Sortie de commande La sortie de la commande est générée dans trois formats : standard, keys et deps. Les arguments keys, info et logon modifient l affichage deps. Format standard : Poste de travail Poste de travail sur lequel le flux de travaux s exécute. Agenda Nom du flux de travaux. Etat Etat du flux de travaux. Les états sont les suivants : add Le flux de travaux a été ajouté par intervention de l opérateur. abend L exécution du flux de travaux s est terminée avec un code de sortie différent de zéro. cancel Le flux de travaux a été annulé. cancel pend Le flux de travaux est en cours d annulation. L annulation est reportée jusqu à ce que toutes les dépendances, y compris l heure at, soient résolues. error Pour les dépendances interréseaux uniquement, une erreur s est produite lors de la recherche de l état distant. exec Le flux de travaux est en cours d exécution. extrn Pour les dépendances interréseaux uniquement, le flux de travaux se trouve dans un réseau distant du planificateur et son statut est inconnu. Une erreur est survenue, une action de réexécution a été effectuée sur le flux de travaux externes ou le travail ou le flux de travaux INET n existe pas. 212 IBM Tivoli Workload Scheduler - Guide de référence

237 hold Le flux de travaux attend la résolution de dépendances. ready Le flux de travaux est prêt à démarrer et toutes les dépendances sont résolues. stuck L exécution du flux de travaux a été interrompue. Aucun travail n est lancé sans l intervention de l opérateur. succ Le flux de travaux s est achevé correctement. Pr Priorité du flux de travaux. Début prévu Heure de début du flux de travaux. Les parenthèses indiquent une estimation de l heure de début. Si l heure de début dépasse 24 heures dans le passé ou dans l avenir, la date est répertoriée à la place de l heure. Durée écoulée estimée Heure d exécution du flux de travaux. Les parenthèses indiquent une estimation basée sur les statistiques consignées. # Travaux Nombre de travaux du flux de travaux. Travaux OK Nombre de travaux dont l exécution a abouti. Lim Agend Nombre maximal de travaux dans un flux de travaux. Si aucune valeur n est indiquée, aucune limite ne s applique. dépendances Liste des commentaires et des dépendances sur les flux de travaux. Une combinaison des éléments suivants peut être répertoriée : v Pour une dépendance follows, un nom de travail ou de flux de travaux s affiche. v Pour une dépendance opens, le nom de fichier s affiche. Si le fichier réside sur un agent étendu et que son nom comporte plus de 25 caractères, seuls les 25 derniers caractères s affichent. v Pour une dépendance needs, un nom de ressource placé entre tirets (-) s affiche. Si le nombre d unités demandées est supérieur à un, le nombre s affiche avant le premier tiret. v Pour une échéance définie par l argument until, l heure précédée du signe inférieur (<) s affiche. v Pour une dépendance prompt, le numéro d invite s affiche au format #num. Pour les invites globales, le nom d invite vient à la suite, entre parenthèses. v Les flux de travaux annulés portent la mention [Cancelled]. v Les flux de travaux annulés à l aide de l option ;pend portent la mention [Cancel Pend] (Annulation en cours). v Pour une heure d échéance deadline, l heure précédée du signe inférieur (<) s affiche. v Les flux de travaux pour lesquels une heure d expiration est définie, y compris les flux de travaux annulés à l aide de l option ;pend, portent la mention [Until] (Echéance). v Les flux de travaux contenant le mot clé carryforward portent la mention [Carry]. Chapitre 5. Référence au programme Conman 213

238 v En ce qui concerne les flux de travaux du jour précédent qui ont été reportés, le nom et la date d origine s affichent entre crochets. Format keys : Les flux de travaux sont répertoriés, un par ligne. Format deps : Les flux de travaux utilisés comme dépendances sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs standard. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;keys : Les flux de travaux qui comportent des dépendances follows sont répertoriés un par ligne. Format deps;info : Les flux de travaux utilisés sous forme de dépendances sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;info. Les flux de travaux sont répertoriés au format showschedules standard. Format deps;logon : Les flux de travaux utilisés sous forme de dépendances sont répertoriés, suivis des travaux et flux de travaux dépendants. Les travaux sont répertoriés au format showjobs;logon. Les flux de travaux sont répertoriés au format showschedules standard. Exemples Pour afficher le statut de tous les flux de travaux à l état hold sur le poste de travail où vous exécutez le programme Conman, exécutez la commande suivante : Pour afficher le statut de tous les flux de travaux corp sur le poste de travail site2 au format deps;info, exécutez la commande suivante : ss site2#corp@;deps;info Pour afficher hors ligne le statut de tous les flux de travaux à l état abend sur tous les postes de travail, exécutez la commande suivante : Pour afficher le statut de tous les flux de travaux sur tous les postes de travail, exécutez la commande suivante : Après avoir exécuté la commande, le programme génère une sortie proche de l exemple suivant : Poste travail Agenda Etat Pr démarrage Ecoulement # OK Lim TWS820A #SCHED-1 ABEND 10 09/03 0: TWS820A #SCHED-2 READY TWS820A #SCHED-3 ABEND 10 09/03 0: TWS820A #SCHED-4 EXEC 10 09/ TWS820A #SCHED-5 READY TWS820A #SCHED-6 READY TWS820A #SCHED-7 SUCC 10 09/03 0: TWS820A #SCHED-8 READY 10 ( 0:01) 1 0 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Affichage d un flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. 214 IBM Tivoli Workload Scheduler - Guide de référence

239 shutdown Arrête sans condition tous les processus de production du planificateur, y compris Batchman, Jobman, Netman, Mailman, tous les serveurs Mailman servers et tous les éditeurs. Vous devez avoir un accès shutdown au poste de travail. Syntaxe shutdown [;wait] Arguments wait Attend l arrêt de tous les processus avant d inviter l utilisateur à lancer une autre commande. Remarques La commande shutdown arrête les processus uniquement sur le poste de travail sur lequel Conman est en cours d exécution. Pour réexécuter Netman uniquement, exécutez la commande StartUp. Pour plus d informations sur la commande StartUp, voir «StartUp», à la page 276. Pour réexécuter l intégralité de l arborescence de processus, exécutez la commande Conman start. Avant d exécuter une commande shutdown, vous devez exécuter la commande Conman Exemples Pour arrêter la production sur le poste de travail où vous exécutez le programme Conman, exécutez la commande suivante : shutdown Pour arrêter la production sur le poste de travail où vous exécutez le programme Conman et attendre la fin de tous les processus, exécutez la commande suivante : unlink@;noask shut ;wait Chapitre 5. Référence au programme Conman 215

240 start Lance les processus de production du planificateur. Vous devez avoir un accès start au poste de travail. Syntaxe start [domaine!]poste_travail[;mgr][;noask][;demgr] Arguments domaine Indique le nom du domaine dans lequel des postes de travail sont lancés. Les caractères génériques sont acceptés. Cet argument est utile lors du lancement de plusieurs postes de travail dans un domaine. Par exemple, pour lancer tous les agents du domaine stlouis, utilisez la commande suivante : start stlouis!@ Si l argument domaine n est pas indiqué et que l argument poste_travail comporte des caractères génériques, le domaine par défaut est celui dans lequel Conman est en cours d exécution. poste_travail Indique le nom du poste de travail à démarrer. Les caractères génériques sont acceptés. mgr Ce paramètre ne peut être indiqué que sur le poste de travail où Conman est en cours d exécution. Il démarre le poste de travail local en tant que gestionnaire de domaine. Le poste de travail est le nouveau gestionnaire de domaine et le gestionnaire de domaine en cours devient un agent à tolérance de pannes. Ce format de commande suit généralement une commande stop. Il est à noter que, pour changer de gestionnaire de domaine, il est préférable d utiliser une commande switchmgr. Pour plus d informations, voir «switchmgr», à la page 230. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque poste de travail significatif. demgr Cette option interdit toute ouverture des connexions externes durant la phase de transition entre le moment où un agent démarre en tant qu ancien gestionnaire de domaine et le moment où la commande switchmgr est exécutée, privant ainsi l agent de la fonction de gestionnaire de domaine. Elle est exécutée automatiquement. Tant que l ancien gestionnaire de domaine n a pas traité l événement switchmgr (dans le cas, par exemple, d un redémarrage retardé ou suivant la réparation d un agent endommagé), l option demgr DOIT être utilisée pour lancer l ancien gestionnaire de domaine depuis la ligne de commande locale. Pour plus d informations, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Remarques La commande start est utilisée chaque début de journée pour réexécuter le planificateur après le traitement de préproduction. Elle initialise et lance automatiquement les agents à tolérance de pannes, qui sont connectés automatiquement. Les agents qui ne sont pas connectés automatiquement sont initialisés et exécutés via la commande link. 216 IBM Tivoli Workload Scheduler - Guide de référence

241 En supposant qu un utilisateur possède un accès start aux postes de travail en cours de démarrage, les règles suivantes s appliquent : v Un utilisateur exécutant Conman sur le gestionnaire de domaine maître peut démarrer n importe quel poste de travail du réseau. v Un utilisateur exécutant Conman sur un autre gestionnaire que le gestionnaire de domaine maître peut démarrer n importe quel poste de travail appartenant à ce domaine ou à des domaines subordonnés. L utilisateur ne peut pas démarrer des postes de travail appartenant à des domaines homologues. v Un utilisateur exécutant Conman sur un agent peut démarrer tout poste de travail hébergé par cet agent. Exemples La figure et le tableau qui suivent présentent les postes de travail démarrés par les commandes start exécutées par les utilisateurs en différents points du réseau. DMn sont des gestionnaires de domaine et Ann sont des agents. Figure 4. Postes de travail réseau démarrés Commande Démarrage par Utilisateur1 Tous les postes de travail sont démarrés. DM1 A11 A12 start DOMAINE3!@ DM3 A31 A32 start DOMAINE4!@ DM4 A41 A42 Démarrage par Utilisateur2 DM2 A21 A22 DM4 A41 A42 DM2 A21 A22 Démarrage par Utilisateur3 A21 A21 Non autorisé Non autorisé DM4 A41 A42 Non autorisé start DM2 DM2 DM2 Non autorisé start A42 A42 A42 Non autorisé start A31 A31 Non autorisé Non autorisé Chapitre 5. Référence au programme Conman 217

242 status Affiche la bannière Conman et l état de la production d IBM Tivoli Workload Scheduler. Syntaxe status Sortie de commande Le mode du plan de production (Symphony) est indiqué entre parenthèses, à la suite du mot Agenda sur la deuxième ligne de la sortie. Le message d information Def ou Exp peut apparaître. Def indique que le plan de production est en mode non étendu, et Exp indique qu il est en mode étendu. Le mode du plan de production est déterminé par la valeur de l option globale version étendue. Sous IBM Tivoli Workload Scheduler version 8.2, les bases de données et les plans sont toujours développés, mais cette information apparaît pour une compatibilité amont. Exemples L exemple suivant affiche l état du plan de production en cours. Il positionne ensuite le pointeur du plan de production sur 2, puis en affiche l état. %status TWS for WINDOWS NT/CONMAN 8.2 ( ) Licensed Materials Property of IBM 5698-WKB (C) Copyright IBM Corp 1998,2001 US Government User Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Agenda (Exp) 05/19/03 (#17) sur DEMOCPU. Batchman arrêté. Limit: 30, Fence: 0, Audit Level: IBM Tivoli Workload Scheduler - Guide de référence

243 stop Arrête les processus de production du planificateur. Pour arrêter le processus Netman, utilisez la commande shutdown. Vous devez avoir un accès stop au poste de travail. Syntaxe stop[domaine!]poste_travail[;wait][;noask] Arguments domaine Indique le nom du domaine dans lequel des postes de travail sont arrêtés. Dans la mesure où les postes de travail portent des noms uniques, le domaine n est pas requis lors de l arrêt d un poste de travail spécifique. Les caractères génériques sont acceptés. Cet argument est utile lors de l arrêt de plusieurs postes de travail dans un domaine. Par exemple, pour arrêter tous les agents du domaine stlouis, utilisez la commande suivante : stop stlouis!@ Si l argument domaine n est pas indiqué et que l argument poste_travail comporte des caractères génériques, le domaine par défaut est celui dans lequel Conman est en cours d exécution. poste_travail Indique le nom du poste de travail à arrêter. Les caractères génériques sont acceptés. wait Indique qu aucune autre commande ne doit être acceptée tant que tous les processus ne sont pas arrêtés. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque poste de travail significatif. Remarques Si la commande stop ne peut pas être appliquée à un poste de travail distant (si le chemin TCP/IP n est pas disponible, par exemple), la commande est stockée en local dans un fichier pobox et envoyée au poste de travail une fois celui-ci est connecté. En supposant qu un utilisateur possède un accès stop aux postes de travail en cours d arrêt, les règles suivantes s appliquent : v Un utilisateur exécutant Conman sur le gestionnaire de domaine maître peut arrêter n importe quel poste de travail du réseau. v Un utilisateur exécutant Conman sur un autre gestionnaire que le gestionnaire de domaine maître peut arrêter n importe quel poste de travail appartenant à ce domaine ou à des domaines subordonnés. L utilisateur ne peut pas arrêter des postes de travail appartenant à des domaines homologues. v Un utilisateur exécutant Conman sur un agent peut arrêter n importe quel poste de travail du domaine local. Lorsque vous lancez une commande sur un gestionnaire de domaine, une commande conman stop s exécute en local sur les postes de travail distants. La commande commence son exécution sur les postes de travail situés en bas de la hiérarchie du réseau, pour terminer sur le gestionnaire de domaine. Cependant, les fichiers symphony ne sont pas mis à jour tant que les postes de travail fonctionnent. C est pourquoi, si vous lancez une commande conman sc@!@ depuis Chapitre 5. Référence au programme Conman 219

244 un poste de travail, il se peut que les informations résultantes reflètent avec précision les différents états des postes de travail, y compris celle du gestionnaire de domaine. Exemples La figure et le tableau qui suivent présentent les postes de travail arrêtés par les commandes stop exécutées par les utilisateurs en différents points du réseau. DMn sont des gestionnaires de domaine et Ann sont des agents. Figure 5. Postes de travail réseau arrêtés Commande Arrêt par Utilisateur1 Tous les postes de travail sont arrêtés. DM1 A11 A12 stop DOMAINE3!@ DM3 A31 A32 stop DOMAINE4!@ DM4 A41 A42 Arrêt par Utilisateur2 DM2 A21 A22 DM4 A41 A42 DM2 A21 A22 Arrêt par Utilisateur3 DM2 A21 A22 DM2 A21 A22 Non autorisé Non autorisé DM4 A41 A42 stop DM2 DM2 DM2 DM2 Non autorisé stop A42 A42 A42 Non autorisé stop A31 A31 Non autorisé Non autorisé 220 IBM Tivoli Workload Scheduler - Guide de référence

245 stop ;progressive Arrête les processus de production du planificateur de façon hiérarchique lorsque vous avez défini au moins un poste de travail sur behindfirewall dans un réseau IBM Tivoli Workload Scheduler version 8.2. Similaire à la commande stop cette commande est plus efficace pour améliorer les performances d exécution du plan. La commande ne s exécute pas à partir du domaine dans lequel elle a été initialement émise pour chaque domaine subordonné, elle s exécute à chaque niveau de la hiérarchie. Vous devez avoir un accès stop au poste de travail. Syntaxe stop ;progressive Remarques Lorsque vous émettez la commande sur un gestionnaire de domaine, tous les postes de travail de ce même domaine sont arrêtés. Puis, le gestionnaire de domaine est lui-même arrêté et la commande s exécute sur chaque domaine subordonné. La commande continue de s exécuter de la façon hiérarchique suivante : le gestionnaire de domaine arrête les postes de travail du même domaine, s arrête lui-même, puis la commande s exécute ensuite sur les domaines subordonnés. Exemples La figure 5, à la page 220 et le tableau ci-dessous présentent les postes de travail arrêtés à l aide de la commande stop ;progressive sur DM2. Commande Arrêt par DM2 Arrêt par DM4 stop ;progressive A21 A22 DM2 A41 A42 DM4 Chapitre 5. Référence au programme Conman 221

246 submit docommand Soumet une commande à lancer sous forme de travail planificateur. Vous devez avoir un accès submit au travail. Pour inclure des dépendances needs et prompt, vous devez avoir un accès use aux ressources et aux invites globales. Syntaxe sbd [poste_travail#] commande [;alias[=nom]][;into=flux_travaux] [;option_travail[;...]] Arguments poste_travail Indique le nom du poste de travail sur lequel le travail va être lancé. Les caractères génériques sont admis, auquel cas, le travail est lancé sur les postes de travail correspondants. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. Vous ne pouvez pas indiquer une classe de postes de travail ou un domaine. commande Indique une commande système valide comportant jusqu à 255 caractères. L intégralité de la commande doit être placée entre guillemets ( ). La commande est traitée sous forme de travail et toutes les règles relatives aux travaux s appliquent. alias=nom Indique un nom unique à attribuer au travail. Si le mot clé alias est entré sans qu aucun nom ne soit indiqué, un nom est créé à partir des six premiers caractères alphanumériques (en majuscules) de la commande, selon le nombre de caractères de la commande, suivis d un nombre aléatoire de dix chiffres. Si la commande contient des caractères blancs, le nom est créé à partir des six premiers caractères alphanumériques précédant le caractère blanc. Par exemple, dans le cas de la commande rm apfile, le nom généré est similaire à RM Si la commande comporte plus de six caractères alphanumériques telle que wlsinst, le nom créé est WLSINS Si aucun alias n est indiqué la première fois que vous soumettez la commande, un nom de travail est créé à partir des 255 caractères du nom de la commande. Si vous soumettez une commande une seconde fois à partir du même poste de travail, le mot clé alias est obligatoire et doit être unique pour chaque commande soumise. into=flux_travaux Indique le nom du flux de travaux dans lequel le travail va être placé à des fins de lancement. Entrez le nom comme suit : [poste_travail#]flux_travaux Si l option poste_travail n est pas indiquée, le poste de travail sur lequel Conman est en cours d exécution est utilisé par défaut. Si l argument into n est pas indiqué, le travail est ajouté à un flux de travaux appelé JOBS. option_travail Indiquez l un des arguments suivants : at=hhmm [timezone tz fuseau_horaire] [+n days mm/jj/aa] [absolute abs] confirmed 222 IBM Tivoli Workload Scheduler - Guide de référence deadline=heure [timezone tz fuseau_horaire][+n day[s mm/jj/aa]

247 every=fréquence job[;nocheck][;wait=heure][,...] interactive logon=utilisateur needs=[num] [poste_travail#]ressource[,...] opens=[poste_travail#] nom_fichier [(qualifiant)][,...] priority[=pri hi go] prompt= [:!]texte nom_invite[,...] rccondsucc Condition de succès recovery=stop continue rerun after [poste_travail#]nom_travail abendprompt texte until heure [timezone tz fuseau_horaire][+n day[s] [absolute abs]] [onuntil action] Remarques Si aucun poste de travail n est indiqué avec les options follows, needs ou opens, le poste de travail sur lequel se trouve le travail est utilisé. Si le travail est exécuté sur un agent à tolérance de pannes et que vous souhaitez inclure une dépendance prompt ou recoveryprompt, le répertoire mozart(racine_tws/mozart) du gestionnaire de domaine maître doit être accessible (monté ou partagé). Exemples Pour soumettre une commande rm dans le flux de travaux JOBS avec une dépendance follows, exécutez la commande suivante : submit docommand="rm apfile";follows sked3 Pour soumettre une commande sort caractérisée par l alias sortit et placer le travail dans le flux de travaux reports dont l heure d exécution at est définie sur 17:30, exécutez la commande suivante : sbd "sort < file1 > file2";alias=sortit;into=reports;at=1730 Pour soumettre la commande chmod sur tous les postes de travail dont le nom commence par site, exécutez la commande suivante : sbd site@#"chmod 444 file2";alias Chapitre 5. Référence au programme Conman 223

248 submit file Soumet un fichier à lancer sous forme de travail planificateur. Vous devez avoir un accès submit au travail. Pour inclure des dépendances needs et prompt, vous devez avoir un accès use aux ressources et aux invites globales. Syntaxe sbf nom_fichier[;alias[=nom]][;into=flux_travaux][;option_travail[;...]][;noask] Arguments nom_fichier Indique le nom du fichier (jusqu à 255 caractères). Les caractères génériques sont acceptés. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : tirets (-), barres obliques (/), barres obliques inverses (\) et traits de soulignement (_). alias=nom Indique un nom unique à attribuer au travail. Si le mot clé alias est entré sans qu aucun nom ne soit indiqué, un nom est créé à partir des six premiers caractères alphanumériques (en majuscules) du nom de fichier, selon le nombre de caractères du nom de fichier, suivis d un nombre aléatoire de dix chiffres. Par exemple, dans le cas où le nom de fichier est jclttx5, le nom généré est similaire à JCLTTX Si aucun alias n est indiqué, un nom de fichier est créé à partir des 255 caractères alphanumériques du nom de base des fichiers, en majuscules. Dans l un ou l autre des cas ci-dessus, si le nom du fichier ne commence pas par une lettre, vous êtes invité à utiliser alias= nom. Si vous soumettez un fichier une seconde fois à partir du même poste de travail, le mot clé alias est obligatoire et doit être unique pour chaque fichier soumis. into=flux_travaux Nom du flux de travaux dans lequel le travail va être placé à des fins de lancement. Entrez le nom comme suit : [poste_travail#]flux_travaux. Si l option poste_travail n est pas indiquée, le poste de travail sur lequel Conman est en cours d exécution est utilisé par défaut. Si l argument into n est pas indiqué, le travail est ajouté à un flux de travaux appelé JOBS. option_travail Indiquez l un des arguments suivants : at=hhmm [timezone tz fuseau_horaire] [+n days mm/jj/aa] [absolute abs] confirmed deadline=heure[timezone tz fuseau_horaire][+n days mm/jj/aa] every=fréquence travail[,...] interactive logon=utilisateur needs=[num] [poste_travail#]ressource[,...] 224 IBM Tivoli Workload Scheduler - Guide de référence

249 opens=[poste_travail#] nom_fichier [(qualifiant)][,...] priority[=pri hi go] prompt= [:!]texte nom_invite[,...] rccondsucc Condition de succès recovery=stop continue rerun after [poste_travail#]nom_travail abendprompt texte until heure [timezone tz fuseau_horaire][+n day[s] [absolute abs]] [onuntil action] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque fichier significatif. Remarques Si aucun poste de travail n est indiqué avec follows, needs ou opens, le poste de travail sur lequel le travail s exécute est utilisé par défaut. Si le travail est exécuté sur un agent à tolérance de pannes et que vous souhaitez inclure une dépendance prompt ou recoveryprompt, le répertoire mozart(racine_tws/mozart) du gestionnaire de domaine maître doit être accessible (monté ou partagé). Exemples Pour soumettre un fichier dans le flux de travaux jobs en utilisant le nom de travail myjcl, exécutez la commande suivante : submit file=d:\jobs\lib\daily\myjcl Pour soumettre un fichier dans le flux de travaux missked en utilisant le nom de travail misjob4, exécutez la commande suivante : sbf /usr/lib/mis/jcl4;alias=misjob4;into=missked ;needs=2 slots Le travail requiert deux unités de la ressource slots. Pour soumettre tous les fichiers dont le nom commence par back dans le flux de travaux bkup, exécutez la commande suivante : sbf "/usr/lib/backup/back@";into=bkup Chapitre 5. Référence au programme Conman 225

250 submit job Soumet un travail à lancer par le planificateur. Vous devez avoir un accès submit au travail. Pour inclure des dépendances needs et prompt, vous devez avoir un accès use aux ressources et aux invites globales. Pour soumettre un travail, vous devez exécuter Conman sur le gestionnaire de domaine maître ou avoir accès aux bases de données du planificateur sur le gestionnaire de domaine maître. Syntaxe sbj [poste_travail#]nom_travail[;alias[=nom]][;into=flux_travaux] [;option_travail[;...]][;noask] Arguments poste_travail Indique le nom du poste de travail sur lequel le travail va être lancé. Les caractères génériques sont admis, auquel cas, le travail est lancé sur les postes de travail correspondants. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. Vous ne pouvez pas indiquer une classe de postes de travail ou un domaine. nom_travail Indique le nom du travail. Les caractères génériques sont admis, auquel cas, tous les travaux correspondants sont soumis. Si le travail figure déjà dans le plan de production et qu il est soumis dans le même flux de travaux, vous devez utiliser le même argument alias pour attribuer un nom unique. alias=nom Indique un nom unique à attribuer au travail à la place de l option nom_travail. Si vous entrez le mot clé alias sans indiquer de nom, un nom est créé à l aide des deux premiers caractères alphanumériques du nom indiqué par l option nom_travail, suivis d un nombre aléatoire de six chiffres. Le nom apparaît systématiquement en majuscules. Par exemple, si l option nom_travail indique jcrttx5, le nom généré sera similaire à JC into=flux_travaux Indique le nom du flux de travaux dans lequel le travail va être placé à des fins de lancement. Entrez le nom comme suit : [poste_travail#]flux_travaux Si l option poste_travail n est pas indiquée, le poste de travail sur lequel Conman est en cours d exécution est utilisé par défaut. Si l option into n est pas indiquée, le travail est ajouté à un flux de travaux appelé jobs. option_travail Indiquez l un des arguments suivants : at=hhmm [timezone tz fuseau_horaire] [+n days mm/jj/aa] [absolute abs] confirmed deadline=heure[timezone tz fuseau_horaire][+n days mm/jj/aa] every=fréquence 226 IBM Tivoli Workload Scheduler - Guide de référence

251 job[;nocheck][;wait=heure][,...] needs=[num] [poste_travail#]ressource[,...] opens=[poste_travail#] nom_fichier [(qualifiant)][,...] priority[=pri hi go] prompt= [:!]texte nom_invite[,...] rccondsucc Condition de succès recovery=stop continue rerun after [poste_travail#]nom_travail abendprompt texte until heure [timezone tz fuseau_horaire][+n day[s] [absolute abs]] [onuntil action] noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque travail significatif. Remarques Si aucun poste de travail n est indiqué avec follows, needs ou opens, le poste de travail sur lequel le travail est exécuté sera utilisé par défaut. Si le travail est exécuté sur un agent à tolérance de pannes et que vous souhaitez inclure une dépendance prompt ou recoveryprompt, le répertoire mozart(racine_tws/mozart) du gestionnaire de domaine maître doit être accessible (monté ou partagé). Exemples Pour soumettre les travaux test dans le flux de travaux JOBS, exécutez la commande suivante : submit job=test Pour soumettre un travail caractérisé par l alias rptx4 et placer le travail dans le flux de travaux reports dont l heure d exécution at est définie sur 17:30, exécutez la commande suivante : sbj rjob4;alias=rptx4;into=reports;at=1730 Pour soumettre le travail txjob3 sur tous les postes de travail dont le nom commence par site, exécutez la commande suivante : sbj site@#txjob3;alias Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Soumettre des travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 227

252 submit sched Soumet un flux de travaux devant être lancé par le planificateur. Vous devez avoir un accès submit au flux de travaux. Pour inclure des dépendances needs et prompt, vous devez avoir un accès use aux ressources et aux invites globales. Pour soumettre un flux de travaux, vous devez exécuter Conman sur le gestionnaire de domaine maître ou avoir accès aux bases de données du planificateur sur ce même gestionnaire. Syntaxe sbs [poste_travail#]nom_flux_travaux[;alias[=nom]] [;option_flux_travaux[;...]][;noask] Arguments poste_travail Indique le nom du poste de travail sur lequel le flux de travaux va être lancé. Les caractères génériques sont admis, auquel cas, le flux de travaux est lancé sur les postes de travail correspondants. Par défaut, le poste de travail sur lequel Conman est en cours d exécution est utilisé. Vous ne pouvez pas indiquer une classe de postes de travail ou un domaine. nom_flux_travaux Indique le nom du flux de travaux. Les caractères génériques sont admis, auquel cas, tous les flux de travaux correspondants sont soumis. Si le flux de travaux figure déjà dans le plan de production, vous devez utiliser l argument alias pour attribuer un nom unique. alias=nom Indique un nom unique à attribuer au flux de travaux à la place de l option nom_flux_travaux. Si vous indiquez le mot clé alias sans indiquer de nom, un nom est créé à l aide des deux premiers caractères alphanumériques du nom indiqué par l option nom_flux_travaux, suivis par un nombre aléatoire de six chiffres. Le nom apparaît systématiquement en majuscules. Par exemple, si l option nom_flux_travaux est sttrom, le nom généré sera similaire à ST option_flux_travaux Entrez l un des éléments suivants. at=hhmm [timezone tz fuseau_horaire] [+n days mm/jj/aa] [absolute abs] carryforward deadline=heure[timezone tz fuseau_horaire][+n days mm/jj/aa] job[;nocheck][;wait=heure][,...] limit=limite_travail needs=[num] [poste_travail#]ressource[,...] opens=[poste_travail#] nom_fichier [(qualifiant)][,...] priority[=pri hi go] prompt= [:!]texte nom_invite[,...] until heure [timezone tz fuseau_horaire][+n day[s] [absolute abs]] [onuntil action] 228 IBM Tivoli Workload Scheduler - Guide de référence

253 noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque flux de travaux significatif. Remarques Si aucun poste de travail n est indiqué avec follows, needs ou opens, le poste de travail du flux de travaux est utilisé par défaut. Si le flux de travaux est exécuté sur un agent à tolérance de pannes et que vous souhaitez inclure une dépendance prompt ou recoveryprompt, le répertoire mozart racine_tws/mozart) du gestionnaire de domaine maître doit être accessible (monté ou partagé). Exemples Pour soumettre le flux de travaux adhoc sur le poste de travail site1 et le définir en tant que flot de travaux carryforward, exécutez la commande suivante : submit sched=site1#adhoc;carryforward Pour soumettre le flux de travaux fox4 caractérisé par un nombre maximal de 2 travaux, une priorité égale à 23 et une échéance fixée à minuit par l option until, exécutez la commande suivante : sbs fox4;limit=2;pri=23;until=0000 Pour soumettre le flux de travaux sched3 sur tous les postes de travail dont le nom commence par site, exécutez la commande suivante : sbs site@#sched3 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Gestion des plans répartis du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 5. Référence au programme Conman 229

254 switchmgr Remplace le gestionnaire de domaine en cours par un gestionnaire de domaine de sauvegarde. Vous devez avoir un accès start et stop au gestionnaire de domaine de sauvegarde. Syntaxe switchmgr domaine;nouv_gest Arguments domaine Indique le domaine dans lequel vous souhaitez effectuer le changement de gestionnaire. nouv_gest Indique le nom du nouveau gestionnaire de domaine. Il doit correspondre à un poste de travail du même domaine et être défini par avance comme agent à tolérance de pannes, les options Résolution des dépendances et Statut intégral étant activées. Remarques Cette commande arrête le poste de travail indiqué et le relance ensuite en tant que gestionnaire de domaine. Tous les postes de travail faisant partie du domaine sont informés du changement et l ancien gestionnaire de domaine est converti en agent à tolérance de pannes dans le domaine. Si le traitement de la nouvelle journée (travail Jnextday) est réalisé sur l ancien gestionnaire de domaine, le domaine agira comme si une autre commande switchmgr avait été exécutée et l ancien gestionnaire de domaine reprendra automatiquement ses responsabilités de gestionnaire de domaine. Exemples Pour basculer le gestionnaire de domaine sur le poste de travail orca dans le domaine masterdm, exécutez la commande suivante : switchmgr masterdm,orca Pour basculer le gestionnaire de domaine sur le poste de travail ruby dans le domaine bldg2, exécutez la commande suivante : switchmgr bldg2,ruby 230 IBM Tivoli Workload Scheduler - Guide de référence

255 system Exécute une commande système. Syntaxe [:!] commande-sys Arguments commande-sys Désigne une commande système valide. Le préfixe (: ou!) est requis lorsqu un nom de commande est orthographié comme une commande Conman. Exemples Pour exécuter une commande ps sur UNIX, exécutez la commande suivante : ps -ef Pour exécuter une commande dir sur Windows, exécutez la commande suivante : dir \bin Chapitre 5. Référence au programme Conman 231

256 tellop Envoie un message à la console du planificateur. Syntaxe to [texte] Arguments texte Indique le texte du message. Celui-ci peut comporter jusqu à 900 caractères. Remarques Si la commande tellop est émise sur le gestionnaire de domaine maître, le message est envoyé à tous les postes de travail connectés. Si elle est émise sur un gestionnaire de domaine, le message est envoyé à tous les agents connectés de son domaine et des domaines subordonnés. Si elle est émise sur un poste de travail autre qu un gestionnaire de domaine, le message est envoyé uniquement à son gestionnaire de domaine si celui-ci est connecté. Le message s affiche uniquement si le niveau de message écran est supérieur à zéro. Voir «console», à la page 163. Si la commande tellop est entrée seule, vous êtes invité à entrer le texte du message. A l invite, tapez chaque ligne et appuyez sur la touche Retour. A la fin du message, tapez deux barres obliques (//) ou un point (.) et appuyez sur la touche Retour. Vous pouvez utiliser la séquence de retour ligne (\n) pour la mise en forme des messages. Vous pouvez quitter la commande tellop à tout moment sans envoyer de message en appuyant sur Control+c. Exemples Pour envoyer un message, exécutez la commande suivante : tellop TWS sera arrêté à\n4:30 pendant 15 minutes. Pour inviter l utilisateur à saisir du texte avant d envoyer un message, exécutez la commande suivante : to TELLOP>********************************* TELLOP>* TWS sera arrêté à * TELLOP>* 4:30 pendant 15 minutes. * TELLOP>********************************* TELLOP>// 232 IBM Tivoli Workload Scheduler - Guide de référence

257 unlink Ferme les liaisons de données entre les postes de travail. Vous devez avoir un accès unlink au poste de travail cible. Syntaxe unlink[domaine!]poste_travail[;noask] Arguments domaine Indique le nom du domaine dans lequel les liaisons doivent être arrêtées. Il n est pas nécessaire d indiquer le nom de domaine d un poste de travail appartenant au domaine maître. Les caractères génériques sont acceptés. Remarque : Vous devez toujours indiquer le nom de domaine lors de la suppression d un lien d un poste de travail n appartenant pas au domaine maître. Cet argument est utile lors de la suppression des liaisons de plusieurs postes de travail dans un domaine. Par exemple, pour supprimer les liaisons de tous les agents du domaine stlouis, utilisez la commande suivante : link stlouis!@ Si vous n indiquez pas l argument domaine et que l argument poste_travail comporte des caractères génériques, le domaine par défaut est celui dans lequel Conman est en cours d exécution. poste_travail Indique le nom du poste de travail dont la liaison doit être supprimée. Les caractères génériques sont acceptés. noask Indique que l utilisateur ne doit pas être invité à confirmer avant d effectuer une opération sur chaque poste de travail significatif. Remarques En supposant qu un utilisateur possède un accès unlink aux postes de travail dont la liaison est en cours de suppression, les règles suivantes s appliquent : v Un utilisateur exécutant Conman sur le gestionnaire de domaine maître peut supprimer la liaison de n importe quel poste de travail du réseau. v Un utilisateur exécutant Conman sur un gestionnaire autre que le gestionnaire de domaine maître peut supprimer la liaison de n importe quel poste de travail de son propre domaine et des domaines subordonnés. L utilisateur ne peut pas supprimer la liaison des postes de travail dans les domaines homologues. v Un utilisateur exécutant Conman sur un agent peut supprimer une liaison de n importe quel poste de travail dans son domaine local à condition que le poste de travail soit ou un gestionnaire de domaine ou un hôte. Un agent homologue appartenant au même domaine ne peut pas être privé de liaisons. Pour plus d informations, voir «link», à la page 177. Chapitre 5. Référence au programme Conman 233

258 Exemples La figure et le tableau qui suivent présentent les liaisons fermées par les commandes unlink exécutées par les utilisateurs en différents points du réseau. DMn sont des gestionnaires de domaine et Ann sont des agents. Figure 6. Postes de travail réseau non liés Commande Fermeture par Utilisateur1 unlink Toutes les liaisons sont fermées. DM1-A11 DM1-A12 DM1-DM2 DM1-DM3 unlink DOMAINE3!@ DM3-A31 DM3-A32 unlink DOMAINE4!@ DM4-A41 DM4-A42 Fermeture par Utilisateur2 DM1-DM2 DM2-A21 DM2-A22 DM2-DM4 DM4-A41 DM4-A42 DM1-DM2 DM2-A21 DM2-A22 DM2-DM4 Fermeture par Utilisateur3 DM2-A21 DM2-A21 Non autorisé Non autorisé DM4-A41 DM4-A42 Non autorisé unlink DM2 DM1-DM2 Sans objet DM2-A21 unlink A42 DM4-A42 DM4-A42 Non autorisé unlink A31 DM3-A31 Non autorisé Non autorisé 234 IBM Tivoli Workload Scheduler - Guide de référence

259 version Affiche la bannière du programme de ligne de commande Conman. Syntaxe version Exemples Pour afficher la bannière du programme de ligne de commande Conman, exécutez la commande suivante : %version MAESTRO for UNIX (HPUX)/CONMAN 6.0 (3.34) (C) Tivoli Systems 1998 Agenda 5/16/98 (#7) sur SFO. Batchman arrêté. Limite : 6, Priorité limite : 0 Chapitre 5. Référence au programme Conman 235

260 236 IBM Tivoli Workload Scheduler - Guide de référence

261 Chapitre 6. Commandes d utilitaire Description des commandes Le présent chapitre décrit les commandes d utilitaire d IBM Tivoli Workload Scheduler. Ces commandes constituent des outils de gestion du planificateur. A l exception de StartUp et version, elles résident dans le répertoire racine_tws/bin. StartUp se trouve dans le répertoire racine_tws et version dans le répertoire racine_tws/version. Commande Description at Pour UNIX uniquement. Soumet un travail à exécuter à un moment donné. batch Pour UNIX uniquement. Soumet un travail à exécuter dès que possible. caxtract Extrait des informations sur les calendriers. cpuinfo Renvoie les informations indiquées dans une définition de poste de travail. datecalc Convertit la date et l heure au format choisi. dbexpand Etend les bases de données du planificateur. delete Supprime les fichiers script et les fichiers de liste standard par nom. evtsize Définit la taille maximale des fichiers de messages d événements. jbxtract Extrait les informations relatives aux travaux. jobinfo Renvoie des informations sur un travail. jobstdl Renvoie le nom des chemins d accès des fichiers de liste standard. listproc Pour Windows uniquement. Répertorie les processus. Cette commande n est pas prise en charge. killproc Pour Windows uniquement. Supprime les processus. Cette commande n est pas prise en charge. maestro Renvoie le répertoire principal du planificateur. makecal Permet de créer des calendriers personnalisés. metronome.pl Prend une image instantanée d IBM Tivoli Workload Scheduler et génère un rapport html pour aider à résoudre les problèmes. morestdl Affiche le contenu des listes standard. parms Affiche, modifie et ajoute des paramètres. paxtract Extrait les informations relatives aux paramètres. prxtract Extrait les informations relatives aux invites. r11xtr Extrait les informations relatives aux flux de travaux. release Libère les unités d une ressource. rextract Extrait les informations relatives aux ressources. rmstdlist Supprime les fichiers de liste standard en fonction de leur âge. showexec Pour UNIX uniquement. Affiche des informations sur l exécution des travaux. StartUp Lance le processus Netman. Copyright IBM Corp. 1999,

262 Commande Description version Pour UNIX uniquement. Affiche les informations de version. xrxtrct Extrait les informations relatives aux références croisées. wmaeutil Extrait les informations relatives aux références croisées. 238 IBM Tivoli Workload Scheduler - Guide de référence

263 Commandes at et batch Pour UNIX uniquement. Soumet commandes et travaux ad hoc devant être lancés par IBM Tivoli Workload Scheduler. Pour plus d informations sur la disponibilité pour les utilisateurs, reportez-vous aux commandes at.allow et at.deny ci-dessous. Syntaxe at -v -u at -sflux_travaux -qfile-attentespéc-heure batch -v -u batch [-s flux_travaux] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -s flux_travaux Indique le nom d un flux de travaux dans lequel le travail est soumis. Si le flux de travaux n existe pas, le système le crée. Le nom du flux doit commencer par une lettre et peut contenir des caractères alphanumériques et des tirets. Il peut comporter jusqu à 16 caractères. Si les arguments -s et -q sont omis, un nom de flux de travaux est sélectionné sur la base de la valeur de la variable d environnement ATSCRIPT. Si cette dernière contient le mot maestro, le nom du flux de travaux correspond aux huit premiers caractères du nom de groupe de l utilisateur. Si ATSCRIPT n est pas définie ou si elle comporte une valeur autre que maestro, le flux de travaux sera intitulé at (pour les travaux soumis avec at) ou batch (pour les travaux soumis avec batch). Pour plus d informations sur les flux de travaux, voir «Autres remarques», à la page q file-attente Indique que le travail doit être soumis dans un flux de travaux portant le nom file-attente, lequel ne peut comporter qu une seule lettre (comprise entre a et z). Pour plus d informations sur les flux de travaux, voir «Autres remarques», à la page 241. spéc-heure Indique l heure à laquelle le travail va être lancé. Ne s applique qu aux travaux at. La syntaxe est identique à celle de la commande UNIX at. Remarques Après avoir entré at ou batch, lancez les commandes qui constituent le travail. Pour terminer chaque ligne d entrée, appuyez sur la touche de retour. Le programme se termine par une marque de fin de fichier (généralement Ctrl+d) ou par une ligne avec un point (.). Vous avez également la possibilité d utiliser le signe inférieur (<) pour lire des commandes à partir d un fichier. Voir «Exemples», à la page 241. Chapitre 6. Commandes d utilitaire 239

264 Les informations relatives aux travaux at et batch sont transmises au gestionnaire de domaine maître où les travaux sont ajoutés dans des flux de travaux du plan de production, Symphony. Les travaux sont lancés en fonction des dépendances incluses dans les flux de travaux. Le shell UNIX utilisé pour exécuter les travaux soumis via les commandes IBM Tivoli Workload Scheduler at et batch est déterminé par la variable SHELL_TYPE du script de configuration jobmanrc. N utilisez pas le shell C. Pour plus d informations, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Une fois soumis, les travaux sont lancés de la même manière que d autres travaux planifiés. Chaque travail est exécuté dans l environnement de l utilisateur qui le soumet. Pour vous assurer que l environnement est complet, des commandes set sont insérées dans le script pour que celui-ci corresponde aux valeurs des variables de l environnement de l utilisateur. Remplacement des commandes UNIX : Les commandes UNIX at et batch standard peuvent être remplacées par les commandes du planificateur. Dans l exemple suivant, nous expliquons comment remplacer les commandes UNIX at et batch : $ mv /usr/bin/at /usr/bin/uat $ mv /usr/bin/batch /usr/bin/ubatch $ ln -s racine_tws/bin/at /usr/bin/at $ ln -s racine_tws/bin/batch /usr/bin/batch Si vous installez le planificateur via le script customize, le programme crée les liens suivants par défaut (plateformes de niveau 2 uniquement) : /usr/bin/mat > racine_tws/bin/at /usr/bin/mbatch > racine_tws/bin/batch Cela permet l exécution des commandes comme suit : /usr/bin/mat /usr/bin/mbatch Fichiers at.allow et at.deny : Les commandes at et batch utilisent les fichiers /usr/lib/cron/at.allow et /usr/lib/cron/at.deny pour limiter l accès. Si le fichier at.allow existe, seuls les utilisateurs répertoriés dans le fichier sont autorisés à utiliser at et batch. Si le fichier n existe pas, at.deny est examiné pour vérifier si les droits d accès de l utilisateur sont explicitement refusés. S il n existe aucun fichier, seul l utilisateur root est autorisé à utiliser les commandes. Si les commandes sont exécutées sous la forme mat ou mbatch, le programme ignore les fichiers at.allow et at.deny sans appliquer de restriction (plateformes de niveau 2 uniquement). Fichiers script : Les commandes entrées avec at ou batch sont stockées dans des fichiers script. Ces derniers sont créés par le planificateur à l aide de la convention d appellation suivante : racine_tws/atjobs/epoch.sss Où : epoch Indique le nombre de secondes écoulées depuis 00:00, 1/1/70. sss Représente les trois premiers caractères du nom du flux de travaux. 240 IBM Tivoli Workload Scheduler - Guide de référence

265 Remarque : Le planificateur supprime les fichiers script des travaux qui ne sont pas reportés. Toutefois, Tivoli conseille de contrôler l espace disque du répertoire atjobs et de supprimer éventuellement les fichiers caducs. Noms de travail : Le planificateur attribue un nom unique à chaque travail at et batch lorsque celui-ci est soumis. Les noms sont constitués de l ID processus de l utilisateur, précédé du nom d utilisateur, tronqué pour ne plus comporter que huit caractères. Le nom résultant est mis en majuscules. Autres remarques : Tivoli conseille de créer à l avance, via le programme Composer, les flux de travaux dans lesquels les travaux at et batch sont soumis. Les flux de travaux peuvent contenir des dépendances qui déterminent l heure de lancement des travaux. Les flux de travaux doivent contenir au moins le mot clé carryforward. Cela assure que les travaux qui n aboutissent pas ou qui ne sont pas lancés pendant le jour en cours sont reportés au plan de production du jour suivant. La liste suivante présente quelques suggestions concernant les flux de travaux at et batch : v Indiquez l expression on everyday pour que les flux de travaux soient sélectionnés chaque jour. v Utilisez le mot clé limit pour limiter le nombre des travaux soumis qui peuvent être exécutés simultanément. v Utilisez le mot clé priority pour définir la priorité des travaux soumis par rapport aux autres travaux. Si la valeur de temps est antérieure à l heure courante, elle est prise en compte pour le jour suivant. Si la valeur de temps est postérieure à l heure courante, elle est prise en compte pour le jour courant. Si la valeur de temps est supérieure à 2400, celle-ci est divisée par 2400 pour obtenir le nombre de jours. Si vous indiquez la valeur de temps en jours, celle-ci est ajoutée à la valeur résultant de la division par Exemples Pour soumettre un travail dans le flux de travaux sched8 qui sera lancé dès que possible, exécutez la commande suivante : batch -s sched8 commande <Retour>... <Control d> Pour soumettre un travail dans le flux de travaux k qui sera lancé à 21:45, exécutez la commande suivante : at -qk 21h45 commande <Retour>... <Control d> Pour soumettre un travail qui sera lancé deux heures à compter de la saisie de la commande, exécutez la commande suivante : at now + 2 hours commande <Retour>... <Control d> Si la variable ATSCRIPT est nulle, le travail est soumis dans un flux de travaux dont le nom est identique à celui du groupe de l utilisateur. Sinon, il est soumis dans un flux de travaux intitulé at. Chapitre 6. Commandes d utilitaire 241

266 Pour soumettre un travail dans le flux de travaux sked-mis qui sera lancé à 17:30, exécutez la commande suivante : at -s sked-mis 17h30 commande <Retour>... <Control d> La commande suivante est identique à celle de l exemple précédent, excepté que le programme lit les commandes du travail à partir d un fichier : at -s sked-mis 17h30 <./mon_travail Le fait que les commandes soient lues à partir d un fichier ne modifie pas la façon dont elles sont traitées. Cela signifie que les commandes sont copiées du fichier./mon_travail dans un fichier script. 242 IBM Tivoli Workload Scheduler - Guide de référence

267 caxtract Extrait de la base de données du planificateur les informations relatives aux calendriers. Syntaxe caxtract [-v -u] [ -o fichier] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -o fichier Indique le fichier de sortie. La destination par défaut est stdout. Sortie de commande Chaque enregistrement de calendrier contient des zones de longueur variable, délimitées par des tabulations. Ces zones sont décrites dans le tableau ci-après. Zone Description 1 Nom du calendrier 8 2 Description du calendrier 64 Longueur maximale (octets) Exemples Pour extraire les informations sur toutes les définitions de calendrier et diriger les résultats vers le fichier cainfo, exécutez la commande suivante : caxtract -o cainfo Chapitre 6. Commandes d utilitaire 243

268 cpuinfo Renvoie les informations indiquées dans une définition de poste de travail. Syntaxe cpuinfo -v -u cpuinfo poste_travail [type_info] [...] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. poste_travail Nom du poste de travail. type_info Type d informations à afficher. Indiquez un ou plusieurs des éléments suivants : os_type Renvoie la valeur de la zone os : UNIX, WNT et OTHER. node Renvoie la valeur de la zone node. port Renvoie la valeur de la zone port. autolink Renvoie la valeur de la zone autolink : ON ou OFF. fullstatus Renvoie la valeur de la zone fullstatus : ON ou OFF. resolvedep Renvoie la valeur de la zone resolvedep : ON ou OFF. host Renvoie la valeur de la zone host. method Renvoie la valeur de la zone access. server Renvoie la valeur de la zone server. type Renvoie le type de chaque poste de travail : MASTER, MANAGER, FTA, S-AGENT et X-AGENT. time_zone Renvoie le fuseau horaire du poste de travail. Pour un agent étendu, la zone est vide. version Renvoie la version du planificateur en cours d exécution sur le poste de travail. Pour un agent étendu, la zone est vide. info Renvoie la version du système d exploitation et le modèle du poste de travail. Pour un agent étendu, la zone est vide. Remarques Les valeurs sont renvoyées, séparées par de nouvelles lignes, dans l ordre de saisie des arguments sur la ligne de commande. Si aucun argument n est indiqué, toutes les informations applicables sont renvoyées avec des libellés et sont séparées par de nouvelles lignes. 244 IBM Tivoli Workload Scheduler - Guide de référence

269 Exemples Les exemples ci-dessous sont basés sur la définition de poste de travail suivante : cpuname oak os UNIX node oak.tivoli.com tcpaddr for maestro autolink on fullstatus on resolvedep on end Pour imprimer le type de système d exploitation du poste de travail oak, exécutez la commande suivante : >cpuinfo oak os_type UNIX Pour imprimer les numéros de noeud et de port du poste de travail oak, exécutez la commande suivante : >cpuinfo oak node port oak.tivoli.com Pour imprimer toutes les informations relatives au poste de travail oak, exécutez la commande suivante : >cpuinfo oak OS TYPE:UNIX NODE:oak.tivoli.com PORT:31111 AUTOLINK:ON FULLSTATUS:ON RESOLVEDEP:ON HOST: METHOD: SERVER: TYPE: FTA TIME ZONE:US/Pacif VERSION:6.1 INFO:SunOS 5.3 Generic 1016 sun4m Chapitre 6. Commandes d utilitaire 245

270 datecalc Résout les expressions de date et renvoie les dates aux formats voulus. Syntaxe datecalc -v -u datecalc date-base [décalage] [pic format][freedays Nom_Calendrier [-sa] [-su]] datecalc -t heure [date-base] [décalage] [pic format] datecalc aaaammjjhhmm [décalage] [pic format] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. date-base Indiquez l un des arguments suivants : jour date today tomorrow scheddate Où : jour Indique un jour de la semaine. Les valeurs admises sont les suivantes : su, mo, tu, we, th, fr ou sa. date Indique une date au format élément/élément[/élément], où élément représente : j[j], m[m] et aa[aa]. Si deux chiffres sont utilisés pour l année ( aa ), un nombre supérieur à 70 correspond à une date du 20e siècle et un nombre inférieur à 70 correspond à une date du 21e siècle. Les valeurs admises pour le mois (m[m]) sont jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov ou dec. Les barres obliques (/) peuvent être remplacées par des tirets (-), des points (.), des virgules (,) ou des espaces. Par exemple, vous pouvez entrer une des dates suivantes pour le 28 mars 1999 : 03/28/ mar.99 99,28,3 mar Si des nombres sont utilisés, il est possible d entrer une date ambiguë, par exemple, 2,7,98. Dans ce cas, datecalc utilise le format de date défini dans le catalogue de messages du planificateur pour interpréter la date. Si celle-ci ne respecte pas le format, datecalc génère un message d erreur. today Indique la date système en cours. tomorrow Indique la date système en cours plus un jour ou, dans le cas des calculs d heure, plus 24 heures. 246 IBM Tivoli Workload Scheduler - Guide de référence

271 scheddate Indique la date du plan de production. Celle-ci peut être différente de la date système. Si vous l utilisez dans les travaux d un flux de travaux qui n est pas reporté, le programme renvoie la date à laquelle le travail doit être exécuté. Elle peut être différente de la date de production du flux de travaux si le travail possède une dépendance AT. Si vous l utilisez dans les travaux d un flux de travaux qui est reporté, le programme renvoie la date à laquelle le travail aurait dû être exécuté. Elle peut être différente de la date de production du flux de travaux reporté si le travail possède une dépendance AT. Si la dépendance AT respecte la syntaxe suivante : at=hhmm + n days, les n jours ne seront pas ajoutés à la variable TIVOLI_JOB_DATE. Par conséquent, la commande datecalc ne reportera pas les jours en question. -t heure [ date-base ] Indiquez l heure en utilisant un des formats suivants : now noon midnight [h[h][[:]mm] [am pm] [zulu] Où : now Indique la date et l heure système en cours. noon Indique midi (ou 1200). midnight Indique minuit (ou 0000). h[h][[:]mm] Indique l heure au format 12 heures (si des heures am ou pm sont utilisées) ou au format 24 heures. Le délimiteur (:) facultatif peut être remplacé par un point (.), une virgule (,), une apostrophe ( ), la lettre h ou un espace. Par exemple, vous pouvez utiliser les formats suivants pour représenter l heure 20:00 : 8:00pm 20: pm pm 20 8,00pm \ 00pm zulu Indique que l heure entrée correspond à l heure de Greenwich (heure universelle). Cette heure est convertie par datecalc en heure locale. aaaammjjhhmm Indique l année, le mois, le jour, l heure et les minutes, exprimés en douze chiffres exactement. Par exemple, tapez pour représenter le 7 mai 1999, 9 heures 15. Chapitre 6. Commandes d utilitaire 247

272 décalage Indique un décalage par rapport à la date-base au format suivant : pic {[+ > - < nombre nearest] next} day[s] weekday[s] workday[s] week[s] month[s] year[s] hour[s] minute[s] jour calendrier Où : + > Indique un décalage par rapport à une date ou une heure ultérieures. Sous Windows, utilisez + (Plus). Sous UNIX, utilisez > (supérieur à). Veillez à faire précéder ce dernier de la barre oblique inverse ( \> ). - < Indique un décalage par rapport à une date ou une heure antérieures. Sous Windows, utilisez - (moins). Sous UNIX, utilisez < (inférieur à). N oubliez pas de fermer l accolade par le signe ( \< ). nombre Nombre d unités du type indiqué. nearest Indique un décalage par rapport à l occurrence la plus proche du type d unité (antérieure ou ultérieure). next Indique l occurrence suivante du type d unité. day[s] Indique tous les jours. weekday[s] Indique tous les jours sauf le samedi et le dimanche. workday[s] Identique à weekday[s], mais exclut également les dates du calendrier holidays. week[s] Indique sept jours. month[s] Indique des mois du calendrier. year[s] Indique des années du calendrier. hour[s] Indique des heures d horloge. minute[s] Indique des minutes d horloge. jour Indique un jour de la semaine. Les valeurs admises sont les suivantes : su, mo, tu, we, th, fr ou sa. calendrier Indique les entrées d un calendrier de ce nom. format Indique le format de renvoi de la date et de l heure. Les caractères du format ont les significations suivantes : m Mois. d Jour du mois. 248 IBM Tivoli Workload Scheduler - Guide de référence

273 y Année. j Jour du mois du calendrier julien. h t Heure. Minute. ^ / Un espace. Sous UNIX, utilisez le caret (^). Il doit être précédé de la barre oblique inverse (\) dans le shell Bourne. Sous Windows, utilisez le symbole / (barre oblique). Vous pouvez également inclure des signes de ponctuation. Il s agit des délimiteurs utilisés dans date et heure. Si aucun format n est défini, datecalc renvoie la date et l heure au format défini par les variables d environnement NLS (Native Language Support). Si les variables NLS ne sont pas définies, la langue nationale C est utilisée par défaut. freedays Indique le nom d un calendrier de jours chômés Nom_Calendrier devant remplacer les jours fériés dans l évaluation des jours ouvrés. Dans le cas présent, les jours ouvrés sont considérés comme étant tous les jours de la semaine sauf samedi, dimanche et toutes les dates répertoriées dans Nom_Calendrier. Par défaut, le samedi et le dimanche ne sont pas considérés comme des jours ouvrés, à moins que vous n indiquiez explicitement le contraire en ajoutant -sa et/ou -su après Nom_Calendrier. Vous pouvez également affecter le nom holidays au calendrier des jours chômés. Exemples Pour renvoyer la date suivante (à compter du jour courant) sur le calendrier de fin de mois, exécutez la commande suivante : >datecalc today next monthend Dans les exemples suivants, la date système en cours est le vendredi 9 avril >datecalc today +2 days pic mm/dd/yy 04/11/99 >datecalc today next tu pic yy\^mm\^dd >LANG=american;export LANG >datecalc -t 14:30 tomorrow Sat, Apr 10, :30:00 PM >LANG=french;datecalc -t 14:30 tomorrow Samedi 10 avril :30:00 Dans l exemple suivant, l heure système en cours est 10:24. >datecalc -t now \> 4 hours pic hh:tt 14:24 Chapitre 6. Commandes d utilitaire 249

274 dbexpand Convertit les bases de données du gestionnaire de domaine maître du mode non étendu en mode étendu. La commande affecte la valeur oui à l option globale de version étendue et effectue des copies de sauvegarde de vos anciens fichiers de base de données que vous pouvez utiliser pour revenir en mode non étendu, si nécessaire. Si vous mettez à jour le réseau par étapes et si certains postes de travail exécutent Tivoli Maestro version 5.x (ou antérieure), vous devez utiliser les bases de données non étendues en attendant que tous les ordinateurs soient mis à jour vers Tivoli Maestro 6.x or IBM Tivoli Workload Scheduler. Une fois tous les ordinateurs à jour, lancez dbexpand sur le gestionnaire de domaine maître pour convertir les bases de données au mode étendu. Syntaxe dbexpand -v -u dbexpand -n[ -b rép-sauvegarde] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -n Indique que vous ne devez pas être invité à entrer un nom de répertoire de sauvegarde. Si -b est inclus, le répertoire nommé est utilisé à des fins de sauvegarde. Si -b n est pas inclus, le répertoire par défaut est utilisé. Dans l un ou l autre cas, si le répertoire existe, il est remplacé. -b rép-sauvegarde Indique un répertoire de sauvegarde des fichiers de base de données. Répertoire par défaut : racine_tws/mozart/mozart.old Si -n est omis et que le répertoire de sauvegarde existe déjà, vous êtes invité à entrer un nom de répertoire de sauvegarde. Remarques Vous pouvez exécuter la commande dbexpand sans arrêter le planificateur. Toutefois, vous ne pouvez pas soumettre de travaux ou de flux de travaux dans le plan de production en cours avant le lendemain. Pour cette raison, Tivoli conseille d exécuter la commande dbexpand un peu avant l exécution du travail Jnextday. Exemples Pour développer les bases de données et sauvegarder les fichiers dans le répertoire /usr/lib/maestro/temp, exécutez la commande suivante : dbexpand -n -b /usr/lib/maestro/temp Si le répertoire existe déjà, le programme écrase son contenu. 250 IBM Tivoli Workload Scheduler - Guide de référence

275 Pour développer les bases de données et sauvegarder les fichiers dans le répertoire c:\programs\wsched\temp, exécutez la commande suivante : dbexpand -b c:\programs\wsched\temp Une invite s affiche si le répertoire existe déjà. Chapitre 6. Commandes d utilitaire 251

276 delete Supprime des fichiers. Cette commande permet de supprimer des listes standard. Les utilisateurs maestro et root (sur UNIX) et Administrateur (sur Windows) peuvent supprimer tous les fichiers. Les autres utilisateurs ne peuvent supprimer que les fichiers associés à leurs propres travaux. Syntaxe delete -v -u delete nom_fichier Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. nom_fichier Indique le nom du fichier ou du groupe de fichiers à supprimer. Ce nom doit être placé entre guillemets ( ) s il contient des caractères autres que les suivants : caractères alphanumériques, tirets (-), barres obliques (/), barres obliques inversées (\) et traits de soulignement (_). Les caractères génériques sont acceptés. ATTENTION : Utilisez cette commande avec précaution. L utilisation incorrecte de caractères génériques peut entraîner la suppression accidentelle des fichiers. Exemples Pour supprimer tous les fichiers liste standard du 4 novembre 2004, exécutez la commande suivante : delete d:\win32app\maestro\stdlist\ \@ Inclus dans un travail planifié sous UNIX, le script suivant supprime le fichier liste standard du travail si aucune erreur ne se produit :... #Suppression de la stdlist de ce travail : if grep -i error $UNISON_STDLIST then exit 1 else `maestro`/bin/delete $UNISON_STDLIST fi... Notez que le script de configuration standard, jobmanrc, affecte à la variable UNISON_STDLIST le nom de la liste standard du travail. Pour plus d informations sur jobmanrc, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. 252 IBM Tivoli Workload Scheduler - Guide de référence

277 evtsize Définit la taille des fichiers d événements du planificateur. Cette commande permet d augmenter la taille d un fichier événements après réception du message Fin du fichier des événements. Pour exécuter la commande evtsize, vous devez être un utilisateur maestro ou root (sous UNIX) ou Administrateur (sous Windows). N oubliez pas d arrêter le moteur IBM Tivoli Workload Scheduler avant d exécuter la commande. Syntaxe evtsize -v -u evtsize nom_fichier taille evtsize -show nom_fichier Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -show nom_fichier Requière la longueur de la file d attente du fichier donné. nom_fichier Nom du fichier des événements. Indiquez l un des arguments suivants : Courier.msg Intercom.msg Mailbox.msg pobox/poste_travail.msg taille Taille maximale, en octets, du fichier des événements. Lors de la création du fichier par le planificateur, la taille maximale est définie à 10 Mo. Exemples Pour définir la taille maximale du fichier Intercom à 20 Mo, exécutez la commande suivante : evtsize Intercom.msg Pour définir la taille maximale du fichier pobox du poste de travail chicago à 15 Mo, exécutez la commande suivante : evtsize pobox\chicago.msg La commande suivante : evtsize -show Intercom.msg renvoie le résultat suivant : TWS for Windows NT/EVTSIZE 8.2 ( ) Licensed Materials Property of IBM 5698-WKB (C) Copyright IBM Corp 1998,2001 US Government User Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. AWS Queue size current 880, maximum bytes (read 48, write 928) Chapitre 6. Commandes d utilitaire 253

278 Où : 880 Est la taille de la file d attente du fichier Intercom.msg Est la taille maximale du fichier Intercom.msg. read 48 Indique la position du pointeur pour lire les enregistrements write 928 Indique la position du pointeur pour écrire les enregistrements 254 IBM Tivoli Workload Scheduler - Guide de référence

279 jbxtract Extrait de la base de données du planificateur les informations relatives aux travaux. Syntaxe jbxtract [-v -u] [ -j travail] [-c poste_travail] [-o fichier] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -j travail Indique le travail pour lequel l extraction est effectuée. Par défaut, tous les travaux sont pris en compte. -c poste_travail Indique le poste de travail des travaux pour lesquels l extraction est effectuée. Par défaut, tous les postes de travail sont pris en compte. -o fichier Indique le fichier de sortie. La destination par défaut est stdout. Sortie de commande La variable MAESTRO_OUTPUT_STYLE spécifie le style de sortie pour les noms d objet longs. Définissez cette variable par LONG pour utiliser des zones longues pour les noms d objet. Si cette variable n est pas définie et que la valeur qui lui a été affectée est différente de LONG, les noms longs sont tronqués à huit caractères suivis du signe plus. Par exemple : A Chaque enregistrement de travail contient des zones de longueur variable délimitées par des tabulations. Ces zones sont décrites dans le tableau ci-après. Zone Description 1 Nom du poste de travail 16 2 Nom du travail 16 3 Nom du fichier du script de travail Description du travail 65 5 Nom du travail de reprise 16 6 Option de reprise (0 = arrêt (stop), 1 = reprise (rerun), 2 = poursuite (continue) 7 Texte de l invite de reprise 64 8 Option d auto-documentation (0 = désactivée, 1 = activée 5 9 Nom de connexion de l utilisateur pour le travail ID utilisateur du créateur du travail Nombre d exécutions réussies 5 12 Nombre d exécutions abandonnées 5 13 Durée totale de toutes les exécutions de travaux 8 14 Temps nécessaire au poste de travail pour toutes les exécutions des travaux Longueur maximale (octets) 5 8 Chapitre 6. Commandes d utilitaire 255

280 Zone Description Longueur maximale (octets) 15 Temps moyen écoulé 8 16 Date de la dernière exécution (aammjj) 8 17 Heure de la dernière exécution (hhmm) 8 18 Secondes de la dernière exécution 8 19 Dernier temps écoulé 8 20 Durée (en secondes) de sollicitation du poste de travail 8 21 Temps écoulé maximal 8 22 Date d exécution maximale (aammjj) 8 23 Sollicitation minimale du poste de travail en secondes 8 24 Temps minimal écoulé 8 25 Date d exécution minimale (aammjj) 8 Exemples Pour extraire les informations sur le travail mon_travail du poste de travail principal et diriger les résultats dans le fichier jinfo, exécutez la commande suivante : jbxtract -j mon_travail -c principal -o jinfo 256 IBM Tivoli Workload Scheduler - Guide de référence

281 jobinfo Utilisée dans un script de travail pour renvoyer des informations relatives au travail. Syntaxe jobinfo -v -u jobinfo option-travail [...] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. option-travail Option de travail. Indiquez un ou plusieurs des éléments suivants : confirm_job Renvoie YES si le travail doit être confirmé. is_command Renvoie YES si le travail a été planifié ou soumis à l aide de la structure docommand. job_name Renvoie le nom du travail sans le nom du poste de travail et le nom du flux de travaux. job_pri Renvoie le niveau de priorité du travail. programmatic_job Renvoie YES si le travail a été soumis à l aide de la commande at ou batch du planificateur. Sous UNIX uniquement. re_job Renvoie YES si le travail est réexécuté par suite d une commande rerun de Conman ou de l option de reprise rerun. re_type Renvoie l option de reprise du travail (stop, continue ou rerun). rstrt_flag Renvoie YES si le travail est exécuté en tant que travail de reprise. rstrt_retcode Si le travail en cours est un travail de reprise, renvoie le code retour du travail parent. time_started Renvoie l heure à laquelle l exécution du travail a commencé. Remarques Les valeurs d option de travail sont renvoyées, séparées par de nouvelles lignes, dans l ordre dans lequel elles ont été demandées. Chapitre 6. Commandes d utilitaire 257

282 Exemples 1. Le fichier script /jcl/backup est documenté à deux reprises et les noms de travaux partback et fullback lui sont attribués. Si le travail est exécuté sous la forme partback, il effectue une sauvegarde partielle. S il est exécuté sous la forme fullback, il effectue une sauvegarde complète. Cela est déterminé dans le script à l aide de commandes similaires aux commandes suivantes : #Choix entre partiel (1) ou intégral (2) : if [ "`\`maestro\`/bin/jobinfo job_name`" = "PARTBACK" ] then bkup=1 else bkup=2 fi Pour afficher le code retour du travail parent, exécutez la commande suivante si le travail courant est un travail de reprise : $ jobinfo rstrt_retcode Le premier travail (travail parent) a été défini dans le script recovery.sh alors que le second travail (travail de reprise) est activé uniquement si le premier se termine de manière anormale. Si vous associez un code retour à la commande jobinfo rstrt_retcode, vous pouvez diriger le travail de reprise pour réaliser différentes actions selon le code retour du travail parent. Dans l exemple suivant, nous avons illustré un travail de reprise : $JOBS MASTER#DBSELOAD DOCOMMAND "/usr/local/tws/maestro/scripts/populate.sh" STREAMLOGON "^TWSUSER^" DESCRIPTION "alimentation manuelle de la base de données" RECOVERY RERUN AFTER MASTER#RECOVERY RCCONDSUCC "(RC = 0) OR ((RC > 4) AND (RC < 11))" Le travail est associé à l option de reprise RERUN, qui permet au travail de reprise d intervenir avant que le programme ne tente d exécuter une nouvelle fois le travail parent. Dans l exemple suivant, le travail de reprise proprement dit est défini : $ JOBS MASTER#RECOVERY DOCOMMAND "^TWSHOME^/scripts/recovery.sh" STREAMLOGON "^TWSUSER^" DESCRIPTION "reprise manuelle de la base de données" RECOVERY STOP 258 IBM Tivoli Workload Scheduler - Guide de référence

283 jobstdl Renvoie les noms des listes standard. Cette commande doit être exécutée par l utilisateur pour lequel IBM Tivoli Workload Scheduler a été installé. Si vous utilisez la commande sans paramètres, vous devez être connecté en tant qu utilisateur IBM Tivoli Workload Scheduler. Syntaxe jobstdl -v -u jobstdl [-day num] [-first -last -num n -all] [-name flux_travaux.travail numéro_travail] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -day num Renvoie les noms de liste standard qui datent du nombre de jours indiqué (1 pour hier, 2 pour avant-hier, etc.). Valeur par défaut : zéro (aujourd hui). -first Renvoie le nom de la première liste standard valide. -last Renvoie le nom de la dernière liste standard valide. -numn Renvoie le nom de la liste standard correspondant à l exécution indiquée d un travail. -all Renvoie le nom de toutes les listes standard valides. -name flux_travaux.travail Indique le nom du flux de travaux et du travail pour lequel des noms de liste standard sont renvoyés. numéro_travail Indique le numéro du travail pour lequel des noms de liste standard sont renvoyés. Remarques Les noms de fichier sont renvoyés dans un format approprié pour être entrés dans d autres commandes. Si le programme renvoie plusieurs noms, il les sépare par un espace. Exemples Pour renvoyer les noms de chemin de tous les fichiers liste standard du jour courant, exécutez la commande suivante : jobstdl Pour renvoyer le nom de chemin de la liste standard pour la première exécution du travail mailxhg1.getmail du jour courant, exécutez la commande suivante : jobstdl -first -name mailxhg1.getmail Pour renvoyer le nom de chemin de la liste standard pour la seconde exécution du travail mailxhg1.getmail du jour courant, exécutez la commande suivante : jobstdl -num 2 -name mailxhg1.getmail Chapitre 6. Commandes d utilitaire 259

284 Pour renvoyer le nom de chemin des fichiers liste standard de toutes les exécutions du travail mailxhg1.getmail remontant à trois jours, exécutez la commande suivante : jobstdl -day 3 -name mailxhg1.getmail Pour renvoyer le nom de chemin de la liste standard de la dernière exécution du travail mailxhg1.getmail remontant à quatre jours, exécutez la commande suivante : jobstdl -day 4 -last -name mailxhg1.getmail Pour renvoyer le nom de chemin de la liste standard du travail 455, exécutez la commande suivante : jobstdl 455 Pour imprimer le contenu du fichier liste standard du travail 455, exécutez la commande suivante : cd `maestro`/bin lp -p 6 `jobstdl 455` 260 IBM Tivoli Workload Scheduler - Guide de référence

285 maestro Renvoie le nom de chemin du répertoire principal du planificateur, désigné par racine_tws. Syntaxe maestro [-v -u] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. Exemples Pour afficher le répertoire principal du planificateur, exécutez la commande suivante : $ maestro /usr/lib/maestro Pour vous placer dans le répertoire principal du planificateur, exécutez la commande suivante : $ cd `maestro` Chapitre 6. Commandes d utilitaire 261

286 makecal Crée un calendrier personnalisé. Sous UNIX, vous devez utiliser le shell Korn pour exécuter la commande. Syntaxe makecal [-v -u] makecal [-c nom] -d n -e {-f s date} -l -m -p n {-r n -s date} -w n [-i n] [ -x -z][-freedays Nom_Calendrier [-sa] [-su]] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -c nom Indique un nom pour le calendrier. Les mots clés IBM Tivoli Workload Scheduler (tels que Freedays ou Schedule) ne peuvent pas être utilisés comme noms de calendrier. Ce nom peut comporter jusqu à huit caractères alphanumériques et doit commencer par une lettre. N utilisez pas les noms des jours de la semaine pour nommer un calendrier. Le nom par défaut est le suivant : Chhmm, où hhmm est l heure courante exprimée en heures et en minutes. -d n Indique le énième jour de chaque mois. -e Indique le dernier jour de chaque mois. -f Crée un calendrier de fin de mois fiscal contenant le dernier jour du mois fiscal. Indiquez un des formats suivants : 1 Format de semaine Format de semaine Format de semaine Cet argument requiert l argument -s. -i n Indique que n dates doivent être placées dans le calendrier. -l Indique le dernier jour ouvré de chaque mois. Cet argument ne fonctionne correctement que si le plan de production (fichier Symphony) et le calendrier holidays existent déjà. Remarque : L utilisation de cet argument a pour résultat d inclure également dans le nouveau calendrier le dernier jour ouvré du mois précédant la date de création du calendrier. -m Indique le premier et le quinzième jour de chaque mois. -pn Indique le jour ouvré précédant le énième jour de chaque mois. Cet argument ne fonctionne correctement que si le plan de production (fichier Symphony) et le calendrier holidays existent déjà. -rn Indique chaque énième jour. Cet argument requiert l argument -s. -s date Indique la date de début pour les arguments -f et -r. Cette date doit être valide et non ambiguë et placée entre apostrophes ; par exemple, utilisez JAN et non 1/10/99. Pour plus d informations sur les formats de date, reportez-vous à base-date pour datecalc à la page IBM Tivoli Workload Scheduler - Guide de référence

287 -wn Indique le jour ouvré suivant le énième jour du mois. Cet argument ne fonctionne correctement que si le plan de production (fichier Symphony) et le calendrier holidays existent déjà. -x Envoie la sortie du calendrier à stdout au lieu de l ajouter dans la base de donnée du calendrier. -z Ajoute le calendrier dans la base de données de calendrier et compile le plan de production (fichier Symphony). Attention : cet argument soumet à nouveau des travaux et des flux de travaux à partir du plan de production du jour. Il est peut-être nécessaire d annuler des flux de travaux et des travaux. -freedays Indique le nom d un calendrier de jours chômés Nom_Calendrier devant remplacer les jours fériés dans l évaluation des jours ouvrés. Dans le cas présent, les jours ouvrés sont considérés comme étant tous les jours de la semaine sauf samedi, dimanche et toutes les dates répertoriées dans Nom_Calendrier. Par défaut, le samedi et le dimanche ne sont pas considérés comme des jours ouvrés, à moins que vous n indiquiez explicitement le contraire en ajoutant -sa et/ou -su après Nom_Calendrier. Vous pouvez également affecter le nom holidays au calendrier des jours chômés. Ce mot clé affecte le traitement de makecal avec les options -l, -p et -w. Exemples Pour créer un calendrier de deux ans où le dernier jour de chaque mois est sélectionné, exécutez la commande suivante : makecal -e -i24 Pour créer un calendrier de 30 jours débutant le 30 mai 1999 et où un jour sur trois est sélectionné, exécutez la commande suivante : makecal -r 3 -s "30 MAY 1999" -i30 Chapitre 6. Commandes d utilitaire 263

288 metronome.pl Un script PERL qui prend une image instantanée d IBM Tivoli Workload Scheduler et génère un rapport html. Lorsqu un utilisateur rencontre un problème avec le produit, ce rapport peut aider le service d assistance d IBM Tivoli Workload Scheduler. Remarques Pour plus d informations sur l utilitaire metronome, voir IBM Tivoli Workload Scheduler Troubleshooting and Error Messages. 264 IBM Tivoli Workload Scheduler - Guide de référence

289 morestdl Affiche le contenu des listes standard. Cette commande doit être exécutée par l utilisateur pour lequel IBM Tivoli Workload Scheduler a été installé. Si vous utilisez cette commande sans avoir défini de paramètres, assurez-vous que vous êtes connecté en tant qu utilisateur IBM Tivoli Workload Scheduler. Syntaxe morestdl -v -u morestdl [-day num] [-first -last -num n -all] [-name flux_travaux.travail numéro_travail] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -day num Affiche les listes standard qui datent du nombre de jours indiqué (1 pour hier, 2 pour avant-hier, etc.). Valeur par défaut : zéro (aujourd hui). -first Affiche la première liste standard valide. -last Affiche la dernière liste standard valide. -numn Affiche la liste standard correspondant à l exécution indiquée d un travail. -all Affiche toutes les listes standard valides. -name flux_travaux.travail Indique le nom du flux de travaux et du travail pour lequel la liste standard est affichée. numéro_travail Indique le numéro du travail pour lequel la liste standard est affichée. Exemples Pour afficher le fichier liste standard pour la première exécution du travail mailxhg1.getmail du jour courant, exécutez la commande suivante : morestdl -first -name mailxhg1.getmail Pour afficher le fichier liste standard pour la deuxième exécution du travail mailxhg1.getmail du jour courant, exécutez la commande suivante : morestdl -num 2 -name mailxhg1.getmail Pour afficher les fichiers liste standard de toutes les exécutions du travail mailxhg1.getmail remontant à trois jours, exécutez la commande suivante : morestdl -day 3 -name mailxhg1.getmail Pour afficher le fichier liste standard de la dernière exécution du travail mailxhg1.getmail remontant à quatre jours, exécutez la commande suivante : morestdl -day 4 -last -name mailxhg1.getmail Pour imprimer le fichier liste standard du travail 455, exécutez la commande suivante : morestdl 455 lp -p 6 Chapitre 6. Commandes d utilitaire 265

290 parms Renvoie la valeur en cours d un paramètre, modifie la valeur d un paramètre ou ajoute un nouveau paramètre. Syntaxe parms [-v -u] parms nom parms -c nom valeur Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. nom Indique le nom du paramètre dont la valeur est affichée. -c nom valeur Indique le nom et la valeur d un paramètre. La valeur peut comporter jusqu à 72 caractères. Si la valeur contient des caractères spéciaux, elle doit être placée entre apostrophes. Si le paramètre n existe pas, il est ajouté à la base de données. S il existe déjà, sa valeur est modifiée. Remarques Lorsque vous exécutez la commande parms sur la ligne de commande sans aucun argument, vous êtes invité à entrer des noms et valeurs de paramètres. Exemples Pour renvoyer la valeur monparm, exécutez la commande suivante : parms monparm Pour modifier la valeur monparm, exécutez la commande suivante : parms -c monparm "item 123" Pour créer un nouveau paramètre appelé sonparm, exécutez la commande suivante : parms -c sonparm "item 789" Pour modifier la valeur monparm et ajouter le paramètre sonparm, exécutez la commande suivante : parms Nom du paramètre? monparm < Retour> Valeur du paramètre? "item 456" < Retour> Nom du paramètre? sonparm < Retour> Valeur du paramètre? "item 123" < Retour> Nom du paramètre? < Retour> 266 IBM Tivoli Workload Scheduler - Guide de référence

291 paxtract Extrait de la base de données du planificateur les informations relatives aux paramètres. Syntaxe paxtract [-v -u] [ -o fichier] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -o fichier Indique le fichier de sortie. La destination par défaut est stdout. Sortie de commande Chaque enregistrement de paramètre contient des zones de longueur variable délimitées par des tabulations. Ces zones sont décrites dans le tableau ci-après. Zone Description 1 Nom du paramètre 8 2 Valeur du paramètre 64 Longueur maximale (octets) Exemples Pour extraire les informations sur toutes les définitions de paramètre et diriger les résultats vers le fichier painfo, exécutez la commande suivante : paxtract -o painfo Chapitre 6. Commandes d utilitaire 267

292 prxtract Extrait de la base de données du planificateur les informations relatives aux invites. Syntaxe prxtract [-v -u] [ -o fichier] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -o fichier Indique le fichier de sortie. La destination par défaut est stdout. Sortie de commande Chaque enregistrement d invite contient des zones de longueur variable délimitées par des tabulations. Ces zones sont décrites dans le tableau ci-après. Zone Description 1 Nom de l invite 8 2 Valeur de l invite 200 Longueur maximale (octets) Exemples Pour extraire les informations sur toutes les définitions d invite et diriger les résultats vers le fichier prinfo, exécutez la commande suivante : prxtract -o prinfo 268 IBM Tivoli Workload Scheduler - Guide de référence

293 r11xtr Extrait de la base de données du planificateur les informations relatives aux flux de travaux. Syntaxe prxtract [-v -u] [ -m mm[aa]] [ -c poste_travail] [-o fichier] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -m mm[aa] Indique le mois (mm) et éventuellement l année (aa) des flux de travaux. La valeur par défaut est le mois et l année en cours. -c poste_travail Indique le poste de travail des flux de travaux. Par défaut, tous les postes de travail sont pris en compte. -o fichier Indique le fichier de sortie. La destination par défaut est stdout. Sortie de commande La variable MAESTRO_OUTPUT_STYLE spécifie le style de sortie pour les noms d objet longs. Définissez cette variable par LONG pour utiliser des zones longues pour les noms d objet. Si cette variable n est pas définie et que la valeur qui lui a été affectée est différente de LONG, les noms longs sont tronqués à huit caractères suivis du signe plus. Par exemple : A Chaque enregistrement de flux de travaux contient des zones de longueur variable délimitées par des tabulations. Ces zones sont décrites dans le tableau ci-après. Zone Description 1 Nom du poste de travail 16 2 Nom du flux de travaux 16 3 Date du flux de travaux (aammjj) 6 4 Durée estimée (en secondes) de sollicitation du poste de travail 5 Option plusieurs postes de travail (* signifie que certains travaux sont exécutés sur d autres postes de travail) 6 Nombre de travaux 4 7 Jour de la semaine (Su, Mo, Tu, We, Th, Fr, Sa) 2 Longueur maximale (octets) 6 1 Exemples Pour extraire les informations sur les flux de travaux remontant à juin 1999 sur le poste de travail principal, exécutez la commande suivante : r11xtr -m c principal Chapitre 6. Commandes d utilitaire 269

294 Pour extraire les informations sur tous les flux de travaux remontant au mois de juin sur tous les postes de travail et diriger le résultat vers le fichier r11out, exécutez la commande suivante : r11xtr -m 06 -o r11out 270 IBM Tivoli Workload Scheduler - Guide de référence

295 release Libère des unités d une ressource au niveau du flux de travaux ou d un travail. Syntaxe release -v -u release [-s] [poste_travail#]nom_ressource Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -s Libère des unités de ressource uniquement au niveau du flux de travaux. Si -s n est pas utilisé, les unités de ressource sont libérées au niveau d un travail, ou au niveau du flux de travaux si la ressource est introuvable au niveau du travail. poste_travail# Indique le nom du poste de travail ou de la classe de postes de travail sur laquelle la ressource est définie. Par défaut, il s agit du poste de travail local. nom_ressource Indique le nom de la ressource. Remarques Les unités d une ressource sont acquises par un travail ou un flux de travaux lorsque celui-ci est lancé, et libérées automatiquement à la fin du travail ou du flux de travaux. La commande release peut être utilisée dans un script de travail pour libérer des ressources avant la fin du travail ou du flux de travaux. Les unités d une ressource sont libérées dans le même ordre que celui de leur acquisition. Exemples Dans le flux de travaux suivant, deux unités de la ressource dbase sont requises par le flux sked5 : schedule ux1#sked5 on tu nécessite 2 dbase : job1 jobrel follows job1 job2 follows jobrel end Pour libérer la ressource dbase avant le début du travail job2, le fichier script de jobrel contient la commande suivante : `maestro`/bin/release -s dbase L argument -s peut être omis, dans la mesure où aucune ressource n a été bloquée au niveau du travail. Dans le flux de travaux suivant, huit unités de la ressource discio sont requises par job2. Elles sont définies en deux blocs de 5 et 3 pour être libérées de façon incrémentielle dans le même ordre que celui dans lequel elles ont été acquises. Chapitre 6. Commandes d utilitaire 271

296 schedule ux1#sked7 on weekdays : job1 job2 follows job1 needs 5 discio,3 discio job3 follows job2 end Pour libérer la ressource discio de façon incrémentielle lors de l exécution de job2, le script de job2 contient les lignes de commande suivantes :... # Libération de 5 unités de discio : `maestro`/bin/release discio... # Libération de 3 unités de discio : `maestro`/bin/release discio IBM Tivoli Workload Scheduler - Guide de référence

297 rextract Extrait de la base de données du planificateur les informations relatives aux ressources. Syntaxe rextract [-v -u] [ -o fichier] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -o fichier Indique le fichier de sortie. La destination par défaut est stdout. Sortie de commande Chaque enregistrement de ressource contient des zones de longueur variable délimitées par des tabulations. Ces zones sont décrites dans le tableau ci-après. Zone Description 1 Nom du poste de travail 8/16 2 Nom de la ressource 8 3 Unités de ressource totales 4 4 Description de la ressource 72 Longueur maximale (octets) Exemples Pour extraire les informations sur toutes les définitions de ressource et diriger les résultats vers le fichier reinfo, exécutez la commande suivante : rextract -o reinfo Chapitre 6. Commandes d utilitaire 273

298 rmstdlist Supprime ou affiche des listes standard en fonction de l ancienneté du fichier. Syntaxe rmstdlist -v -u rmstdlist [-p] [age] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -p Affiche les noms des répertoires des listes standard valides. Aucun répertoire ou fichier n est supprimé. Si -p n est pas indiqué, les listes standard valides sont supprimées. age Age minimum, en jours, des répertoires de listes standard à afficher ou à supprimer. Valeur par défaut : 10 jours. Exemples Pour afficher le nom des répertoires de fichiers liste standard qui ont plus de 14 jours, exécutez la commande suivante : rmstdlist -p 14 Pour supprimer tous les fichiers liste standard (et leurs répertoires) qui ont plus de 7 jours, exécutez la commande suivante : rmstdlist IBM Tivoli Workload Scheduler - Guide de référence

299 showexec Affiche le statut des travaux qui sont en cours d exécution. Pour UNIX uniquement. Cette commande est destinée aux agents standard. Pour les gestionnaires de domaine et les agents à tolérance de pannes, utilisez plutôt la commande conman showjobs. Syntaxe showexec [-v -u -info] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -info Affiche le nom du fichier de travail au lieu de l utilisateur, de la date et de l heure. Sortie de commande Le résultat de la commande existe dans deux formats : standard et info. Format standard : Poste de travail Poste de travail sur lequel le travail s exécute. Calendrier Nom du flux de travaux dans lequel le travail est exécuté. Travail Nom du travail. #travail Numéro du travail. Utilisateur Nom d utilisateur du travail. Date de début Date de début d exécution du travail. Heure de début Heure de début d exécution du travail. Durée écoulée (prévue) Durée d exécution estimée du travail (en minutes). Format info : Poste de travail Poste de travail sur lequel le travail s exécute. Calendrier Nom du flux de travaux dans lequel le travail est exécuté. Travail Nom du travail. #travail Numéro du travail. JCL Nom de fichier du travail. Exemples Pour afficher les travaux en cours d exécution au format standard, exécutez la commande suivante : showexec Pour afficher les travaux en cours d exécution au format info, exécutez la commande suivante : showexec -info Chapitre 6. Commandes d utilitaire 275

300 StartUp Lance le processus de gestion de réseau du planificateur, Netman. Vous devez avoir un accès start au poste de travail. Syntaxe StartUp [-v -u] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. Remarques Sous Windows, le service Netman est lancé automatiquement au redémarrage de l ordinateur. StartUp peut être utilisé pour réexécuter le service si celui-ci est arrêté pour une raison quelconque. Sous UNIX, la commande StartUp réside généralement dans le fichier /etc/rc. Elle permet de lancer le processus Netman à chaque redémarrage d un ordinateur. StartUp peut être utilisé pour réexécuter le processus Netman si celui-ci est arrêté pour une quelconque raison. Le reste de l arborescence des processus peut être réexécuté à l aide d une commande conman start. Pour plus d informations, voir «start», à la page 216. Exemples Pour afficher le nom et la version de la commande, exécutez la commande suivante : StartUp -v Pour lancer le processus Netman, exécutez la commande suivante : StartUp 276 IBM Tivoli Workload Scheduler - Guide de référence

301 version Affiche les informations relatives à la version du planificateur. Pour UNIX uniquement. Les informations sont extraites d un fichier de version. Syntaxe version/version -V -u -h version/version [-a] [ -f fichierv] [-p produit] [fichier [...]] Arguments -V Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. -h Affiche des informations d aide sur la commande et quitte l application. -a Affiche des informations relatives aux fichiers produit. Par défaut, seules les informations relatives aux fichiers indiqués s affichent. -f fichierv Indique le nom du fichier de version. Il s agit par défaut d un fichier intitulé version.info dans le répertoire de travail en cours ou dans le répertoire de produit indiqué avec -p. -pproduit Indique le nom de produit Tivoli dont le répertoire figure directement sous le répertoire de travail courant et contient un fichier version.info. S il est omis, -f ou sa valeur par défaut est utilisée. fichier Indique les noms des fichiers produit, séparés par des espaces, pour lesquels des informations de version sont affichées. Par défaut, aucune information relative aux fichiers ne s affiche ou, si -a est utilisé, toutes les informations relatives aux fichiers s affichent. Sortie de commande L en-tête de la sortie contient le nom, la version, la plateforme, le niveau de modification et la date d installation du produit. Le reste de l écran répertorie des informations relatives au(x) fichier(s) indiqué(s). Les fichiers sont répertoriés au format suivant : Fichier Nom du fichier. Révision Numéro de révision du fichier. Modification Niveau de modification du fichier, s il y a lieu. Taille (octets) Taille du fichier, en octets. Total de contrôle Total de contrôle du fichier. Les totaux de contrôle sont calculés via la commande UNIX sum. Sous AIX, la commande sum est associée à l argument -o. Remarques Les informations relatives aux fichiers IBM Tivoli Workload Scheduler sont contenues dans le fichier version.info. Ce dernier est placé dans le répertoire racine_tws/version lors de l installation. Le fichier version.info est dans un format spécifique et ne doit pas être modifié. Chapitre 6. Commandes d utilitaire 277

302 Vous pouvez transférer le fichier version.info vers un autre répertoire. Toutefois, vous devez ensuite inclure l argument -f pour rechercher le fichier. Vous pouvez utiliser l argument -p si votre répertoire courant contient les répertoires de plusieurs produits Tivoli. Vous pouvez alors accéder aux informations de version en indiquant le nom du produit. Exemples Pour afficher les informations relatives à tous les fichiers, exécutez la commande suivante : version/version -a -f version/version.info Pour afficher les informations relatives au fichier customize, exécutez la commande suivante : cd version./version customize Pour afficher les informations relatives au fichier customize (si le fichier version.info réside dans le répertoire /apps/maestro), exécutez la commande suivante : cd version./version -f /apps/maestro/version.info customize 278 IBM Tivoli Workload Scheduler - Guide de référence

303 wmaeutil Permet d arrêter le serveur de connecteurs pour le plan, la base de données et le moteur. La commande makesec ne s exécutera pas correctement sous Windows tant que les connecteurs n auront pas été arrêtés. Syntaxe UNIX : wmaeutil.sh nom_instance [-stop DB PL EG * ] [-version DB PL EG * ] [-dbinfo DB PL] [-sethome] [-gethome] [ALL -stop] Windows : wmaeutil.cmd nom_instance [-stop DB PL EG * ] [-version DB PL EG * ] [-dbinfo DB PL] [-sethome] [-gethome] [ALL -stop] Arguments nom_instance Nom de l instance du planificateur. Il s agit du nom de l instance que vous avez indiqué lors de l installation du moteur du planificateur et du connecteur. -stop DB PL EG * Cette option permet d arrêter le serveur de connecteurs indiqué. L astérisque (*) permet d arrêter les trois serveurs de connecteurs. Si utilisée, elle doit figurer entre guillemets. -version DB PL EG * Cette option permet d obtenir le numéro de version du serveur de connecteurs pour le plan, la base de données et le moteur installés sur le système. L astérisque (*) permet d obtenir les versions des trois serveurs de connecteurs à la fois. Si utilisée, elle doit figurer entre guillemets. -dbinfo DB PL Cette option permet de savoir si la base de données du planificateur et le plan auxquels ce connecteur est lié sont étendus ou non. Sous IBM Tivoli Workload Scheduler version 8.2, les bases de données et les plans sont toujours développés, mais cette option permet une compatibilité amont. -sethome Cette option permet de définir l attribut racine_tws des objets du planificateur (moteur, base de données et plan) dans la base de données des objets Tivoli. Cette valeur d attribut lie des connecteurs pour l instance d objet en question au produit de base du planificateur. Il considère le nom complet du répertoire principal du planificateur comme un argument. De même, la chaîne de nom de chemin d accès doit être incluse entre guillemets simples afin d éviter toute interprétation shell. -gethome Cette option ne requiert aucun argument et imprime la valeur de l attribut racine_tws pour les instances d objets du moteur, de la base de données et du plan comme défini dans la base de données d objets. Chapitre 6. Commandes d utilitaire 279

304 ALL -stop Cette option arrête les serveurs de connecteurs pour toutes les instances de connecteurs connectées à l installation courante du planificateur, c est-à-dire qu elle arrête les serveurs de connecteurs pour toutes les instances dont l attribut racine_tws correspond au répertoire principal de l installation planificateur utilisée. Remarques Définition des variables d environnement : Pour que wmaeutil s exécute correctement, procédez comme suit : 1. Définissez l environnement Tivoli Management Framework : Sous Windows :c:\>%systemroot%\system32\drivers\etc\tivoli\setup_env.cmd Sous UNIX :$. /etc/tivoli/setup_env.sh 2. Définissez l environnement IBM Tivoli Workload Scheduler : Sous Windows :racine_tws\tws_env.cmd Sous UNIX :racine_tws/tws_env.sh pour le shell Bourne et racine_tws/tws_env.csh pour le shell C. Vous pouvez mettre à jour votre profil UNIX pour exécuter le fichier sans avoir à exécuter la commande manuellement. Remarques relatives à la commande makesec : La commande wmaeutil doit être exécutée avant le lancement de la commande makesec. La commande makesec ne s exécutera pas correctement sous Windows tant que les connecteurs n auront pas été arrêtés. Vous devez également arrêter les connecteurs lorsque vous utilisez la commande makesec sous UNIX. Nom d instance IBM Tivoli Workload Scheduler : Si vous ne vous souvenez pas du nom d instance indiqué lors de l installation, effectuez les étapes ci-après : 1. Localisez les variables d environnement Tivoli :. /etc/tivoli/setup_env.sh (pour UNIX) C:\winnt\system32\drivers\etc\Tivoli\setup_env.cmd (pour Windows) 2. Exécutez la commande wlookup pour obtenir le nom de l instance du planificateur : wlookup -ar MaestroEngine maestro #Maestro::Engine# où maestro2 est le nom de l instance du planificateur. 280 IBM Tivoli Workload Scheduler - Guide de référence

305 Exemples Pour arrêter les connecteurs de la base de données, du plan et du moteur d une instance appelée maestro, exécutez la commande suivante : wmaeutil.sh maestro ALL -stop Pour arrêter les connecteurs de la base de données d une instance appelée tws, exécutez la commande suivante : wmaeutil.sh tws ALL -stop DB Pour arrêter les connecteurs de la base de données, du plan et du moteur d une instance appelée maestro2, exécutez la commande suivante : wmaeutil.sh maestro2 -version * Chapitre 6. Commandes d utilitaire 281

306 xrxtrct Extrait de la base de données du planificateur les informations relatives aux références croisées. Syntaxe xrxtrct [-v -u] Arguments -v Affiche la version de la commande et quitte l application. -u Affiche des informations sur la syntaxe de la commande et quitte l application. Sortie de commande La variable MAESTRO_OUTPUT_STYLE spécifie le style de sortie pour les noms d objet longs. Définissez cette variable par LONG pour utiliser des zones longues pour les noms d objet. Si cette variable n est pas définie et que la valeur qui lui a été affectée est différente de LONG, les noms longs sont tronqués à huit caractères suivis du signe plus. Par exemple : A Le résultat de la commande est enregistré dans huit fichiers, xdep_job, xdep_sched, xfile, xjob, xprompt, xresources, xsched et xwhen. Fichier xdep_job : Le fichier xdep_job contient deux types d enregistrements. Le premier enregistrement contient les informations sur les travaux et les flux de travaux qui dépendent d un travail. Chaque enregistrement d un travail et d un flux de travaux dépendant contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom du travail 40 4 Nom du flux de travaux 16 5 Non utilisée Nom du poste de travail du flux de travaux dépendant 16 7 Nom du flux de travaux dépendant 16 8 Nom du poste de travail du travail dépendant 16 9 Nom du travail dépendant Non utilisée 6 11 Non utilisée 6 12 Non utilisée 8 13 Fin d enregistrement (null) 1 Le deuxième type d enregistrement contient des informations sur les travaux et les flux de travaux soumis aux interdépendances de réseaux interconnectés. Chaque enregistrement de travail et de flux de travaux contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. 282 IBM Tivoli Workload Scheduler - Guide de référence

307 Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom du travail Non utilisée Nom du poste de travail du flux de travaux dépendant 16 6 Nom du flux de travaux dépendant 16 7 Nom du poste de travail du travail dépendant 16 8 Nom du travail dépendant 40 9 Non utilisée 6 10 Non utilisée 6 11 Non utilisée 8 12 Fin d enregistrement (null) 1 Fichier xdep_sched : Le fichier xdep_sched contient des informations sur les flux de travaux qui dépendent d un flux de travaux. Chaque enregistrement de flux de travaux dépendant contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom du flux de travaux 16 4 Non utilisée Nom du poste de travail du flux de travaux dépendant 16 6 Nom du flux de travaux dépendant 16 7 Non utilisée 8 8 Non utilisée 8 9 Non utilisée 6 10 Non utilisée 6 11 Non utilisée 8 12 Fin d enregistrement (null) 1 Fichier xfile : Le fichier xfile contient des informations sur les travaux et les flux de travaux qui dépendent d un fichier. Chaque enregistrement contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom du fichier Nom du poste de travail du flux de travaux dépendant 16 5 Nom du flux de travaux dépendant 16 6 Nom du poste de travail du travail dépendant 16 Chapitre 6. Commandes d utilitaire 283

308 Zone Description Longueur (octets) 7 Nom du travail dépendant 40 8 Non utilisée 6 9 Non utilisée 6 10 Non utilisée 8 11 Fin d enregistrement (null) 1 Fichier xjob : Le fichier xjob contient des informations sur les flux de travaux dans lesquels figure chaque travail. Chaque enregistrement de travail contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom du travail 40 4 Non utilisée Nom du poste de travail des flux de travaux 16 6 Nom du flux de travaux 16 7 Non utilisée 8 8 Non utilisée 8 9 Non utilisée 6 10 Non utilisée 6 11 Non utilisée 8 12 Fin d enregistrement (null) 1 Fichier xprompt : Le fichier xprompt contient des informations sur les travaux et les flux de travaux qui dépendent d une invite. Chaque enregistrement d invite contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom ou texte de l invite 20 4 Non utilisée Nom du poste de travail du flux de travaux dépendant 16 6 Nom du flux de travaux dépendant 16 7 Nom du poste de travail du travail dépendant 16 8 Nom du travail dépendant 40 9 Non utilisée 6 10 Non utilisée 6 11 Non utilisée 8 12 Fin d enregistrement (null) IBM Tivoli Workload Scheduler - Guide de référence

309 Fichier xresource : Le fichier xresource contient des informations sur les travaux et les flux de travaux qui dépendent d une ressource. Chaque enregistrement de ressource contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom de la ressource 8 4 Non utilisée Nom du poste de travail du flux de travaux dépendant 16 6 Nom du flux de travaux dépendant 16 7 Nom du poste de travail du travail dépendant 16 8 Nom du travail dépendant 40 9 Unités allouées 6 10 Non utilisée 6 11 Non utilisée 8 12 Fin d enregistrement (null) 1 Fichier xsched : Le fichier xsched contient des informations sur les flux de travaux. Chaque enregistrement de flux de travaux contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom du flux de travaux 16 4 Non utilisée Nom du poste de travail (identique à la zone 2 ci-dessus) 6 Nom du flux de travaux (identique à la zone 3 ci-dessus) 7 Non utilisée 8 8 Non utilisée 8 9 Non utilisée 6 10 Non utilisée 6 11 Non utilisée 8 12 Fin d enregistrement (null) Chapitre 6. Commandes d utilitaire 285

310 Fichier xwhen : Le fichier xwhen contient des informations sur le moment auquel les flux de travaux seront exécutés. Chaque enregistrement de flux de travaux contient des zones de longueur fixe sans délimiteur. Ces zones sont décrites dans le tableau ci-après. Zone Description Longueur (octets) Nom du poste de travail 16 3 Nom ou date ON/EXCEPT 8 4 Option except (*=EXCEPT) 1 5 Non utilisée Nom du poste de travail 16 7 Nom du flux de travaux 16 8 Non utilisée 8 9 Non utilisée 8 10 Non utilisée 6 11 Numéro de décalage 6 12 Unité de décalage 8 13 Fin d enregistrement (null) 1 Exemples Pour extraire les informations relatives à toutes les références croisées, exécutez la commande suivante : xrxtrct 286 IBM Tivoli Workload Scheduler - Guide de référence

311 Commandes non prises en charge Les commandes non prises en charge suivantes proposent des fonctions sous Windows, qui sont similaires aux commandes UNIX ps et kill. Elles peuvent être utilisées si les utilitaires Windows ne sont pas disponibles. Syntaxe listproc killproc pid Remarques listproc Affiche la liste des processus du système sous forme de tableau. killproc Supprime le processus dont l ID est pid. Remarque : Exécutée par l administrateur, la commande killproc permet de supprimer les processus système. Chapitre 6. Commandes d utilitaire 287

312 288 IBM Tivoli Workload Scheduler - Guide de référence

313 Chapitre 7. Présentation des commandes de génération d états Le présent chapitre détaille les commandes de génération d états, qui permettent de préparer un récapitulatif ou les détails de la journée de production précédente ou suivante. Commandes de génération d états Le tableau suivant présente les commandes IBM Tivoli Workload Scheduler de génération d états. Commande Etat rep1 Etat 01 - Liste détails travaux rep2 Etat 02 - Liste des invites rep3 Etat 03 - Liste des calendriers des utilisateurs rep4a Etat 04A - Liste des paramètres des utilisateurs rep4b Etat 04B - Liste des ressources TWS rep7 Etat 07 - Liste des historiques des travaux rep8 Etat 08 - Histogramme des travaux rep11 Etat 11 - Agenda de production planifiée reptr Etat 09A - Récapitulatif de la production planifiée Etat 09B - Détail de la production planifiée Etat 09D - Détail de la production planifiée (format étendu) Etat 10A - Récapitulatif de la production réelle Etat 10B - Récapitulatif du détail de la production réelle xref Etat 12 - Etat de références croisées Résultat de la commande Les variables suivantes contrôlent le résultat des commandes de génération d états : MAESTROLP Indique la destination du résultat d une commande. La valeur par défaut est stdout. Vous pouvez lui attribuer l une des valeurs suivantes : nom_fichier Le résultat est écrit dans un fichier. > nom_fichier Sous UNIX uniquement. Le résultat est redirigé vers un fichier dont le contenu est remplacé. Si le fichier n existe pas, il est créé. >> nom_fichier Sous UNIX uniquement. Le résultat est redirigé vers un fichier et est ajouté à ce dernier. Si le fichier n existe pas, il est créé. commande Sous UNIX uniquement. Le résultat de la commande est dirigé vers une commande ou un processus système. La commande système est toujours exécutée. Copyright IBM Corp. 1999,

314 commande Sous UNIX uniquement. Le résultat de la commande est dirigé vers une commande ou un processus système. La commande système n est pas exécutée en l absence de résultat. MAESTRO_OUTPUT_STYLE Indique le style du résultat pour les noms d objet longs. Définissez cette variable par LONG pour utiliser des zones longues pour les noms d objet. Si cette variable n est pas définie ou que la valeur qui lui a été affectée est différente de LONG, les noms longs sont tronqués à huit caractères suivis du signe plus. Par exemple : A Modification du format de date Dans IBM Tivoli Workload Scheduler, le format de date affecte toutes les commandes qui acceptent une date comme option d entrée (à l exception de la commande datecalc) ainsi que les en-têtes de tous les états. Le format de date par défaut est mm/jj/aa. Pour sélectionner un format différent, éditez l option locale format de date. Les valeurs possibles sont les suivantes : 0 Pour sélectionner : aa/mm/jj 1 Pour sélectionner : mm/jj/aa 2 Pour sélectionner : jj/mm/aa 3 Pour utiliser : Les variables NLS. Pour plus d informations sur la façon de modifier les variables locales, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. 290 IBM Tivoli Workload Scheduler - Guide de référence

315 Commandes rep1 à rep4b Ces commandes permettent d imprimer les états suivants : Etat 01 - Liste détails travaux Etat 02 - Liste d invites Etat 03 - Liste des calendriers des utilisateurs Etat 04A - Liste des paramètres des utilisateurs Etat 04B - Liste des ressources Maestro Syntaxe rep[x][-v -u] Arguments x Numéro de l état. Les numéros possibles sont les suivants : 1, 2, 3, 4a ou 4b. -u Permet d afficher la version de la commande et de quitter. -v Permet d afficher des informations sur l utilisation de la commande et de quitter. Exemples Imprimez l état 03 Liste des calendriers des utilisateurs : rep3 Affichez les informations d utilisation pour la commande rep2 : rep2 -u Sous UNIX, imprimez deux exemplaires de l état 04A Liste des paramètres des utilisateurs sur l imprimante lp2 : MAESTROLP=" lp -dlp2 -n2" export MAESTROLP rep4a Chapitre 7. Présentation des commandes de génération d états 291

316 Commande rep7 Cette commande permet d imprimer l état 07 - Liste des historiques des travaux. Syntaxe rep7 -v -u rep7 [-c poste_travail] [-s flux_travaux] [-j travail] [-f date -t date ] [-l] Arguments -u Permet d afficher la version de la commande et de quitter. -v Permet d afficher des informations sur l utilisation de la commande et de quitter. -c poste_travail Indique le nom du poste de travail sur lequel les travaux s exécutent. Par défaut, tous les postes de travail sont pris en compte. -s flux_travaux Indique le nom du flux de travaux dans lequel les travaux s exécutent. Par défaut, tous les flux de travaux sont pris en compte. -j travail Indique le nom du travail. Par défaut, tous les travaux sont pris en compte. -f date Indique que l historique des travaux est imprimé à partir de cette date. Entrez la date au format aaaammjj. Par défaut, la date disponible la plus ancienne est prise en compte. -t date Indique que l historique des travaux est imprimé jusqu à cette date. Entrez la date au format aaaammjj. Par défaut, la date la plus récente est prise en compte. -l Limite les informations de ligne de résumé aux travaux appartenant à la plage de dates définie par les options -f ou -t. L utilisation de cette option entraîne l inversion du résultat : la ligne de résumé est imprimée après les lignes d exécution individuelles. Cette option est valable uniquement si vous précisez aussi au moins l une des options -f ou -t. Exemples Imprimez l historique de tous les travaux pour le poste de travail ux3 : rep7 -c ux3 Imprimez l historique de tous les travaux contenus dans le flux de travaux sked25 : rep7 -s sked25 Imprimez l historique de tous les travaux contenus dans le flux de travaux mysked sur le poste de travail x15 entre le 21 janvier 1999 et le 25 janvier 1999 : rep7 -c x15 -s mysked -f t IBM Tivoli Workload Scheduler - Guide de référence

317 Commande rep8 Cette commande permet d imprimer l état 08 - Histogramme des travaux. Syntaxe rep8 -v -u rep8 [-f date -b heure -t date -e heure] [-i fichier] [-p ] rep8 [-b heure -e heure] [ -i fichier] [-p ] Arguments -u Permet d afficher la version de la commande et de quitter. -v Permet d afficher des informations sur l utilisation de la commande et de quitter. -f date Indique que l historique des travaux est imprimé à partir de cette date. Entrez la date au format aaaammjj. Par défaut, la date du jour est prise en compte. -b heure Indique que l historique des travaux est imprimé à partir de cette heure. Entrez l heure au format hhmm. Par défaut, l heure de début de la journée du planificateur est prise en compte. -t date Indique que l historique des travaux est imprimé jusqu à cette date. Entrez la date au format aaaammjj. Par défaut, la date la plus récente est prise en compte. -e heure Indique que l historique des travaux est imprimé jusqu à cette heure. Entrez l heure au format hhmm. Par défaut, l heure de début de la journée du planificateur est prise en compte. -i fichier Indique le nom du fichier journal duquel est extrait l historique des travaux. Notez que les fichiers journaux sont stockés dans le répertoire schedlog. Par défaut, le plan courant (fichier Symphony) est pris en compte. Remarque : Assurez-vous que la plage horaire indiquée par les arguments -f date -b heure -t date -e heure] est comprise dans la plage horaire et la date définies dans l argument du fichier journal -i fichier. -p Indique qu un saut de page est inséré après chaque date d exécution. Chapitre 7. Présentation des commandes de génération d états 293

318 Exemples Imprimez un histogramme des travaux qui inclut toutes les informations dans le plan courant (fichier Symphony) : rep8 Imprimez un histogramme des travaux qui commence à 6 heures du matin le 25 janvier 1999 et qui se termine à 5 heures 59 du matin le 26 janvier rep8 -f b t e i schedlog/m Imprimez un histogramme des travaux, à partir du plan courant (fichier Symphony), qui commence à 6 heures du matin et se termine à 22 heures : rep8 -b e IBM Tivoli Workload Scheduler - Guide de référence

319 Commande rep11 Cette commande permet d imprimer l état 11 Agenda de production planifiée. Syntaxe rep11 -v -u rep11 [-m mm[ aa] [...]] [-c poste_travail [...]] [-o fichier] Arguments -u Permet d afficher la version de la commande et de quitter. -v Permet d afficher des informations sur l utilisation de la commande et de quitter. -m mm[aa] Indique les mois à prendre en compte. Entrez le numéro du mois au format mm. Par défaut, le mois courant est pris en compte. Vous pouvez également indiquer une année en utilisant le format aa. Par défaut, l année courante est prise en compte ou l année suivante si vous indiquez un mois qui précède le mois courant. -c poste_travail Indique les postes de travail à prendre en compte. Par défaut, tous les postes de travail sont pris en compte. -o fichier Indique le fichier de sortie. Il s agit, par défaut, du fichier défini par la variable MAESTROLP. Si MAESTROLP n est pas définie, le fichier par défaut est stdout. Exemples Générez un état pour les mois de juin, juillet et août 1999 pour les postes de travail principal, site1 et sagent1 : rep11 -m c principal site1 sagent1 Générez un état pour les mois de juin, juillet et août de l année en cours pour tous les postes de travail et dirigez la sortie vers le fichier r11out : rep11 -m o r11out Générez un état pour le mois et l année en cours pour le poste de travail site2 : rep11 -c site2 Chapitre 7. Présentation des commandes de génération d états 295

320 Commande reptr Cette commande permet d imprimer les états suivants : v Etat 09A - Récapitulatif de la production planifiée v Etat 09B - Détail de la production planifiée v Etat 10A - Récapitulatif de la production réelle v Etat 10B - Détail de la production réelle Syntaxe reptr [-v -u] reptr -pre [-{summary detail}] [fichier_sym] reptr -post [-{summary detail}] [fichier_journal] Arguments -u Permet d afficher la version de la commande et de quitter. -v Permet d afficher des informations sur l utilisation de la commande et de quitter. -pre Permet de demander l impression des états de préproduction (09A, 09B). -post Permet de demander l impression des états de postproduction (10A, 10B). -summary Permet de demander l impression des états récapitulatifs (09A, 10A). Si les arguments -summary et -detail sont omis, les deux types d état sont imprimés. -detail Permet de demander l impression des états détaillés (09B, 10B). Si les arguments -summary et -detail sont omis, les deux types d état sont imprimés. fichier_sym Indique le nom du fichier de plan de production à partir duquel les états seront imprimés. Le fichier par défaut est Symnew dans le répertoire courant. fichier_journal Indique le nom du fichier journal à partir duquel les états seront imprimés. Notez que les fichiers journaux du plan de production sont stockés dans le répertoire schedlog. Le fichier par défaut est celui du plan courant (fichier Symphony). Si la commande est exécutée sans options, tous les états pre et post sont imprimés. Exemples Imprimez l état détaillé de préproduction à partir du fichier Symnew : reptr -pre -detail Imprimez l état récapitulatif de préproduction à partir du fichier mysym : reptr -pre -summary mysym Imprimez l état récapitulatif de postproduction à partir du fichier journal M : reptr -post -summary schedlog/m IBM Tivoli Workload Scheduler - Guide de référence

321 Imprimez tous les états de pré et postproduction. reptr Les états de préproduction s appuient sur les informations contenues dans le fichier Symnew. Les états de postproduction s appuient sur les informations contenues dans le fichier Symphony. Chapitre 7. Présentation des commandes de génération d états 297

322 Commande xref Cette commande permet d imprimer l état 12 Etat de références croisées. Syntaxe xref [-V -U] xref [-cpu poste_travail] [-depends -files -jobs -prompts -resource -schedules -when [...]] Arguments -U Permet d afficher la version de la commande et de quitter. -V Permet d afficher des informations sur l utilisation de la commande et de quitter. -cpu poste_travail Permet d imprimer l état du poste de travail désigné. Le caractère étant autorisé, les informations de tous les postes de travail qualifiés sont prises en compte. Par défaut, tous les postes de travail sont pris en compte. -depends Permet d imprimer un état détaillant les flux de travaux et les travaux avec leurs successeurs. -files Permet d imprimer un état détaillant les flux de travaux et les travaux dépendants de chaque fichier. -jobs Permet d imprimer un état détaillant les flux de travaux dans lesquels chaque travail est exécuté. -prompts Permet d imprimer un état détaillant les flux de travaux et les travaux dépendants de chaque invite. -resource Permet d imprimer un état détaillant les flux de travaux et les travaux dépendants de chaque ressource. -schedules Permet d imprimer un état détaillant les flux de travaux et les travaux successeurs de chaque flux de travaux. -when Permet d imprimer un état détaillant les dates Include et Exclude des flux de travaux. Si la commande est exécutée sans options, tous les postes de travail et toutes les options sont sélectionnés. Exemples Imprimez un état pour tous les postes de travail, qui détaille toutes les informations de référence croisée : xref Imprimez un état pour tous les postes de travail. Incluez les informations de référence croisée relatives à toutes les dépendances de successeur : xref -depends -schedules 298 IBM Tivoli Workload Scheduler - Guide de référence

323 Modèles d état Etat 01 Liste détails travaux : TWS for UNIX (SOLARIS)/REPORT1 8.2 (1.8) IBM Page 1 Etat 01 Détails des travaux Affichage 06/11/03 Travail : SUN001 #ACC Description : Fichiers JCL : ^ACCHOME^ Connexion : ^ACCLOGIN^ Créateur : maestro Travail de reprise : Type de reprise : STOP Invite de reprise : Autodoc Composer : Oui Nombre total d exécutions : 0-0 réussies, 0 abandonnées Ecoulé(mins) CPU(secs) Total 00:00:00 0 Normal 00:00:00 Dernière exécution 00:00:00 0 (Sur à 00:00) Maximum 00:00:00 0 (Sur ) Minimum 00:00:00 0 (Sur ) Etat 02 Liste des invites : TWS for UNIX (SOLARIS)/REPORT2 8.2 (1.6) IBM Page 1 Etat 02 Liste des invites 06/11/03 Message d invite ACCRES Répondez OUI dès que vous êtes prêt à exécuter les processus acc103 et acc104. ACCUSERS Tous les utilisateurs ACC se sont-ils déconnectés? CALLNO CALLOPER Appelez ^PERSONONCALL^ au ^CALLNO^ pour vérifier que toutes les cartes de présence ont été traitées. HRSRES Répondez OUI dès que vous êtes prêt à exécuter les processus hrs103 et hrs104. MISRES Répondez OUI dès que vous êtes prêt à exécuter les processus mis103 et mis104. PERSONONCALL Louis Armstrong Nombre total d invites sur le fichier : 7 Etat 03 Liste des calendriers des utilisateurs : TWS for UNIX (SOLARIS)/REPORT3 8.2 (1.7) IBM Etat 03 Liste des calendriers des utilisateurs 06/22/03 Type de calendrier : JOURSPAYE Description : Jours de paye Oct 2003 Nov 2003 Dim Lun Mar Mer Jeu Ven Sam Dim Lun Mar Mer Jeu Ven Etat 04A Liste des paramètres : TWS for UNIX (SOLARIS)/REPORT4A 8.2 (1.6) IBM Page 1 Etat 4A Liste des paramètres des utilisateurs 06/11/03 Nom du Paramètre Table des matières ACCHOME /usr/local/tivoli/maestro/scripts ACCLOGIN maestro BADEXIT 99 GOODEXIT 0 Chapitre 7. Présentation des commandes de génération d états 299

324 LONG 2000 SCRPATH /usr/local/tivoli/maestro/scripts SHORT 20 Nombre de paramètres pour le fichier : 7 Etat 04B Liste des ressources : TWS for UNIX (SOLARIS)/REPORT4B 8.2 (1.6) IBM Page 1 Etat 4B Liste des ressources TWS 06/11/03 Ressource Numéro Poste de travail Nom Disponible Description SUN001 #ACCDB 1 Base de données SUN001 #ACCODB 5 Ressource de classe Maestro SUN001 #ACCONE 1 Ressource de classe Maestro SUN001 #ACCPRT 2 Imprimantes SUN001 #ACCTAPE 1 Unité de bande SUN001 #HRSODB 5 Ressource de classe Maestro SUN001 #HRSONE 1 Ressource de classe Maestro SUN001 #MISODB 5 Ressource de classe Maestro SUN001 #MISONE 1 Ressource de classe Maestro Nombre de ressources pour le fichier : 9 Etat 07 Liste des historiques des travaux : TWS for UNIX (SOLARIS)/REPORT7 8.2 (1.10) IBM Page 1 Etat 07 Liste des historiques des travaux Affichage 06/11/03 Date Heure Nom de l agenda Ecoulé CPU Etat Travail :SUN001 #ACCJOB01 Exécutions : Abandonnées 1 Réussies 1 Temps écoulé : Normal 2 Min 2 Max 2 06/10/03 09:36 SUN001 #ACCW SU 06/10/03 10:32 SUN001 #ACCW AB Travail :SUN001 #ACCJOB02 Exécutions : Abandonnées 1 Réussies 1 Temps écoulé : Normal 2 Min 1 Max 2 06/10/03 09:44 SUN001 #ACCW SU 06/10/03 10:31 SUN001 #ACCW AB Etat 08 Histogramme des travaux : TWS for UNIX (SOLARIS)/REPORT8 8.2 (1.7) IBM Page 1 Etat 08 Histogramme des travaux 06/10/03 12:41-06/11/03 12:40 06/11/03 Intervalle par col : 15 minutes CPU : SUN Travail Nom Stat /11/03 TESTRET+.ACCJOB03SU. ACCW02.ACCJOB14AB. HRSW02.HRSJOB14AB. MISW02.MISJOB14AB. JOBS.ACCENV SU. 300 IBM Tivoli Workload Scheduler - Guide de référence

325 Etat 11 Agenda de production planifiée : TWS for UNIX/REP AWSBJA001I Licensed Materials Property of IBM 5698-WKB (C) Copyright IBM Corp 1998,2003 US Government User Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract TWS for UNIX (SOLARIS)/REPORT ( ) IBM Etat 11 Agenda de production planifiée pour JUN 2003 CPU : SUN001 Num Est Cpu Agenda Travaux Heure Dim Lun Mar Mer Jeu Ven Mer Jeu Ven Sam Dim Lun Mar Mer Jeu Mer Jeu Ven Sam Dim Lun ACCDAIL+ 1 0 * * * * * * * * * * ACCW * * * * * * * * * * ACCW * * * * * * * * * * ACCW * * * * * * * * * * ACCW * * * * * * * * * * FINAL 1 4 * * * * * * * * * * * * * * * HRSW * * * * * * * * * * HRSW * * * * * * * * * * Etat 12 Etat de références croisées : TWS for UNIX (SOLARIS)/CROSSREF 8.2 (1.5) IBM Page 1 Etat 12 Etat de références croisées pour les dépendances de travail. 06/13/03 Poste de travail : SUN001 Nom de travail Dépendances ACCR01 #ACCJOB01 ACCR01.ACCJOB02 ACCW01 #ACCJOB01 ACCW01.ACCJOB04 ACCR01 #ACCJOB02 ACCR01.ACCJOB03 ACCR01 #ACCJOB03 ACCR01.ACCJOB04 ACCW01 #ACCJOB03 ACCW01.ACCJOB01 ACCW01 #ACCJOB04 ACCW01.ACCJOB02 ACCR01 #ACCJOB05 ACCR01.ACCJOB06 ACCW02 #ACCJOB11 ACCW02.ACCJOB12 ACCW02 #ACCJOB12 ACCW02.ACCJOB13 ACCW02 #ACCJOB14 ACCW02.ACCJOB15 Chapitre 7. Présentation des commandes de génération d états 301

326 302 IBM Tivoli Workload Scheduler - Guide de référence

327 Chapitre 8. Référence aux agents étendus Le présent chapitre décrit l interface des agents étendus et explique aux programmeurs comment créer des méthodes d accès personnalisées. Les agents étendus permettent de proposer les fonctions de planification de travaux du produit IBM Tivoli Workload Scheduler aux autres systèmes et applications, notamment les systèmes UNIX locaux ou distants, Peoplesoft, SAP R/3, z/os, OPC, Oracle CCM et VMS. Le présent chapitre détaille les points suivants : v Présentation des agents étendus v Interface vers les méthodes d accès v Exécution des méthodes v Résolution d incidents Présentation des agents étendus Les agents étendus permettent d étendre les fonctions de planification des travaux d IBM Tivoli Workload Scheduler vers d autres systèmes et applications. Un agent étendu est un poste de travail disposant d un hôte et d une méthode d accès. L hôte peut correspondre à n importe quel autre poste de travail à l exception d un autre agent étendu. La méthode d accès correspond à un script ou à un programme fourni par l utilisateur ou par IBM qui est exécuté par l hôte chaque fois que l agent étendu est référencé dans le plan de production. Par exemple, le système hôte exécute la méthode d accès en transmettant les informations relatives au travail sous la forme d options de ligne de commande pour lancer un travail sur un agent étendu. La méthode d accès communique avec le système ou l application externe pour lancer le travail et renvoie le statut de ce travail. Définition de poste de travail Tous les agents étendus doivent présenter une définition de poste de travail logique. Ce poste de travail logique doit être hébergé par un poste de travail physique IBM Tivoli Workload Scheduler, à savoir un gestionnaire de domaine maître, un agent FTA ou un agent standard. La définition du poste de travail de l agent étendu référence le nom de la méthode d accès ainsi que le nom du poste de travail de l hôte. Lorsque des travaux sont lancés sur le poste de travail de l agent étendu, la méthode d accès est appelée. Elle transmet les informations relatives aux travaux au système externe. Interface vers les méthodes d accès L interface entre IBM Tivoli Workload Scheduler et une méthode d accès est composée des informations transmises à la méthode par la ligne de commande et des messages renvoyés au planificateur sur stdout. Syntaxe de la ligne de commande des méthodes L hôte du planificateur exécute une méthode d accès à l aide de la syntaxe de ligne de commande suivante : nom_méthode -t tâche options -- chaîne_tâche Copyright IBM Corp. 1999,

328 Où : nom_méthode Désigne le nom de fichier de la méthode d accès. Toutes les méthodes d accès doivent figurer dans le répertoire : racine_tws/methods -t tâche Désigne la tâche à effectuer, où tâche correspond à l une des tâches suivantes : LJ Lance un travail. MJ Gère un travail lancé précédemment. Cette option permet de se resynchroniser si une tâche LJ précédente s est arrêtée de manière inattendue. CF Vérifie la disponibilité d un fichier. Cette option permet de vérifier les dépendances opens de fichier. GS Obtient le statut d un travail. Cette option permet de vérifier les dépendances follows de fichier. options Désigne les options associées à la tâche. Pour plus d informations, voir «Options de tâche». chaîne_tâche Une chaîne comportant jusqu à 255 caractères associée à la tâche. Voir «Options de tâche». Options de tâche Les options de tâche figurent dans le tableau suivant. Un X signifie que l option est admise pour la tâche. Tâche Options Chaîne de la tâche -t -c -n -p -r -s -d -l -o -j -q -w -S LJ X X X X X X X X X X chaîne_lj MJ X X X X X X X X X chaîne_mj CF X X X X chaîne_cf GS X X X X X X chaîne_gs -c agent_étendu,hôte,maître Désigne les noms de planificateur de l agent étendu, de l hôte et du gestionnaire de domaine maître, chacun étant séparé par une virgule. -n nom_noeud Désigne le nom de noeud de l ordinateur associé à l agent étendu, s il existe. Ce nom est défini dans la zone Noeud de la définition de poste de travail de l agent étendu. -p numéro_port Désigne le numéro du port TCP associé à l agent étendu, s il existe. Ce numéro est défini dans la zone Adresse TCP de la définition de poste de travail de l agent étendu. -r exécution_courante,exécutions_pécifique Désigne le numéro d exécution en cours du planificateur et le numéro d exécution spécifique associé au travail, séparés par une virgule. Les 304 IBM Tivoli Workload Scheduler - Guide de référence

329 numéros d exécution en cours et spécifiques peuvent être distincts si le travail a été reporté depuis une exécution antécédente. -s flux_travaux Désigne le nom du flux de travaux du travail. -d date_planification,période Désigne la date de planification (aammjj) ainsi que la période équivalente, séparée par une virgule. -l utilisateur Désigne le nom de l utilisateur du travail. Ce nom est défini dans la zone Connexion de la définition du travail. -o liste_std Désigne le chemin d accès complet du fichier de liste standard du travail. Toute sortie émanant de ce travail doit figurer dans ce fichier. -j nom_travail,id Indique le nom du travail et l identificateur unique affecté par le planificateur, séparés par une virgule. Ce nom est défini dans la zone Nom du travail de la définition du travail. -q qualifiant Désigne le qualifiant qui doit être utilisé dans une commande de test émise par une méthode pour un fichier. -w délai Indique le temps, exprimé en secondes, pendant lequel le planificateur attend une réponse sur un travail externe avant d envoyer un signal SIGTERM à la méthode d accès. La valeur par défaut est S nouveau_nom Indique que le travail est réexécuté à l aide de ce nom, à la place du nom de travail d origine. Dans le script d un travail, vous pouvez utiliser la commande jobinfo pour renvoyer le nom du travail et exécuter le script différemment à chaque itération. Pour plus d informations, reportez-vous à la description de la commande conman rerun du manuel IBM Tivoli Workload Scheduler - Guide de référence. -- chaîne_lj Utilisé avec la tâche LJ. La chaîne provenant de la zone Fichier Script ou la zone Commande de la définition du travail. -- chaîne_mj Utilisé avec la tâche MJ. CDIl s agit des informations fournies au planificateur par la méthode dans une réponse %CJ à une tâche LJ. Généralement, elles identifient le travail qui a été lancé. Par exemple, une méthode Unix peut fournir l ID processus (PID) pour le travail qu elle a lancé, qui est ensuite transmis par le planificateur comme faisant partie d une tâche MJ. -- chaîne_cf Utilisé avec la tâche CF. Pour une dépendance opens de fichier, correspond à la chaîne figurant dans la zone Opens Files de la définition du flux de travaux. -- chaîne_gs Utilisé avec la tâche GS. Désigne le travail dont le statut est vérifié. Le format est le suivant : followsjob[,id_travail] Chapitre 8. Référence aux agents étendus 305

330 Où : followsjob Correspond à la chaîne figurant dans la liste Follows Sched/Job de la définition de flux de travaux. id_travail Correspond à un identificateur de travail facultatif reçu par le planificateur dans une réponse %CJ à une tâche GS précédente. Messages de réponse des méthodes Les méthodes renvoient des informations à IBM Tivoli Workload Scheduler sous la forme de messages écrits dans stdout. Toutes les lignes commençant par le symbole de pourcentage (%) et finissant par une nouvelle ligne sont considérées comme un message. Les messages présentent le format suivant : %CJ statut [chaîne_mj id_travail] %JS [temps_poste_travail] %RC %UT cr [message_erreur] Où : CJ Change le statut du travail. JS état Le statut par lequel le travail est changé. Tous les statuts de travaux du planificateur sont valides à l exception de hold et ready. Pour la tâche GS, les statuts suivants sont également valides : ERROR Une erreur s est produite. EXTRN Le statut est inconnu. chaîne_mj Chaîne pouvant comporter jusqu à 255 caractères, que le planificateur inclut dans toute tâche MJ associée au travail. Voir page 305. id_travail Chaîne pouvant comporter jusqu à 64 caractères, que le planificateur inclut dans toute tâche GS associée au travail. Voir page 305. [temps_poste_travail] Indique qu un travail a abouti et fournit la durée de son exécution en secondes. RC cr cr est un nombre qui est interprété par IBM Tivoli Workload Scheduler comme étant le code retour du travail de l agent étendu. Le code retour est pris en compte seulement si la condition du code retour à été indiquée dans la définition du travail de l agent étendu. Dans le cas contraire, il est ignoré et un message apparaît pour indiquer que le travail de l agent étendu a abouti. %JS [temps_poste_travail]. De la même manière, si cette 306 IBM Tivoli Workload Scheduler - Guide de référence

331 UT méthode n envoie pas le message %RC, un message apparaît pour indiquer que le travail de l agent étendu a abouti %JS [temps_poste_travail]. [message_erreur] Indique que la tâche requise n est pas supportée par la méthode. Affiche une chaîne pouvant comporter jusqu à 255 caractères, que le planificateur inclura dans son message d erreur. Fichier d options de méthode Un fichier d options de méthode vous permet de spécifier des informations relatives à la connexion ainsi que d autres options. Le planificateur lit le fichier, si ce dernier existe, avant d exécuter une méthode. Si ce fichier est modifié après le démarrage du planificateur, les modifications ne prennent effet que lorsque celui-ci a été arrêté puis réexécuté. Ce fichier peut contenir des options du planificateur ainsi que toute autre information relative à la méthode. Les options reconnues par le planificateur sont les suivantes : LJuser=nom_utilisateur CFuser=nom_utilisateur GSuser=nom_utilisateur GStimeout=secondes Où : LJuser=utilisateur Désigne la connexion à utiliser pour les tâches LJ et MJ. La valeur par défaut correspond à la connexion figurant dans la définition du travail. CFuser=nom_utilisateur Désigne la connexion à utiliser pour la tâche CF. Par défaut, la valeur est root sur Unix. Sur Windows, il s agit du nom utilisateur du compte sur lequel le planificateur a été installé. GSuser=nom_utilisateur Désigne la connexion à utiliser pour les tâches GS. Par défaut, la valeur est root sur Unix. Sur Windows, il s agit 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 réponse avant de supprimer la méthode d accès. La valeur par défaut est 300. Remarque : Si le système hôte de l agent étendu exécute Windows, l utilisateur doit être défini en tant qu objet utilisateur du planificateur. Le fichier d options doit présenter le même nom de chemin que ses méthodes d accès, avec l extension de fichier.opts. Par exemple, le nom du chemin d accès Windows au fichier d options de la méthode netmth est racine_tws\methods\netmth.opts. Chapitre 8. Référence aux agents étendus 307

332 Exécution des méthodes Les sections suivantes décrivent les échanges entre IBM Tivoli Workload Scheduler et une méthode d accès. Tâche de lancement d un travail (LJ) La tâche LJ charge la méthode de l agent étendu de lancer un travail sur une application ou un système externe. Avant d exécuter la méthode, IBM Tivoli Workload Scheduler crée un environnement d exécution. Le paramètre LJuser, lu à partir du fichier d options de la méthode, indique avec quel compte utilisateur la méthode doit être exécutée. Si ce paramètre ne figure pas dans le fichier d options ou que le fichier d options n existe pas, le compte utilisateur qui sera utilisé correspond à celui défini dans la zone Connexion de la définition du travail. En outre, les variables d environnement suivantes sont définies : HOME Répertoire principal de l utilisateur connecté LOGNAME Nom de l utilisateur connecté PATH /bin:/usr/bin (UNIX) ou %SYSTEM%\SYSTEM32 (Windows) TZ Fuseau horaire Si la méthode ne peut pas être exécutée, l état du travail devient fail. Lorsqu une méthode est en cours d exécution, elle écrit des messages à son stdout pour indiquer le statut du travail sur le système externe. Ces messages sont décrits dans le tableau ci-après. Tâche Réponse de la méthode Action IBM Tivoli Workload Scheduler LJ et MJ %CJ état [chaîne_mj] Affecte l état état au travail. Inclut chaîne_mj dans toute tâche MJ ultérieure. %JS [temps_poste_travail] Affecte le statut succ au travail. Code de sortie = différent de zéro %UT [message_erreur ] et code de sortie = 2 Affecte le statut abend au travail. Affecte le statut abend au travail et affiche message_erreur. Une séquence typique est constituée d un ou de plusieurs messages %CJ indiquant un changement dans l état du travail, puis un message %JS avant que la méthode n existe indiquant que le travail a abouti. Si le travail n aboutit pas, la méthode doit exister sans écrire le message %JS. Une méthode qui ne supporte pas la tâche LJ écrit un message %UT vers stdout et renvoie le code de sortie 2. Tâche de gestion du travail (MJ) La tâche MJ assure la synchronisation avec un travail précédemment lancé dans le cas où le planificateur détermine que la tâche LJ s est achevée de façon inattendue. Le planificateur configure l environnement de la même façon que pour la tâche LJ et transmet chaîne_mj. Pour plus d informations, voir «Tâche de lancement d un travail (LJ)». 308 IBM Tivoli Workload Scheduler - Guide de référence

333 Si la méthode localise le travail indiqué, elle renvoie les mêmes messages qu une tâche LJ. Si la méthode ne parvient pas à localiser le travail, elle quitte l application avec un code de sortie différent de zéro ; le planificateur affecte alors le statut abend au travail. Suppression d un travail Lors de l exécution d une tâche LJ ou MJ, la méthode doit capter un signal SIGTERM (signal 15). Ce signal est envoyé lorsqu un opérateur lance une commande Kill via le gestionnaire de console du planificateur. A la réception du signal, la méthode doit essayer de supprimer (kill) le travail et sortir sans qu un message %JS ne soit généré. Tâche de vérification d un fichier (CF) La tâche CF charge la méthode de l agent étendu de vérifier la disponibilité d un fichier sur le système externe. Avant d exécuter la méthode, le planificateur crée un environnement d exécution. Le paramètre CFuser, lu à partir du fichier d options de la méthode, indique avec quel compte utilisateur la méthode doit être exécutée. Si le paramètre ne figure pas dans le fichier d options ou si celui-ci n existe pas, le programme utilise l utilisateur root (sur Unix) et le nom de l utilisateur du compte où le planificateur a été installé (sur Windows). Si la méthode ne peut pas être exécutée, la dépendance opens du fichier est marquée comme échouée. En fait, le programme définit le statut du fichier sur NO et ne peut pas exécuter les travaux ou flux de travaux dépendants. Pendant la phase d exécution, la méthode exécute une commande test ou son équivalent sur le fichier utilisant le qualifiant qui lui a été transmis via l option de ligne de commande -q. Si la valeur du fichier test est true, la méthode existe avec un code de sortie 0. Si la valeur du fichier test est false, la méthode existe avec un code de sortie différent de 0. Voir le tableau ci-dessous. Tâche Réponse de la méthode Action IBM Tivoli Workload Scheduler CF Code de sortie = 0 Définit le statut du fichier à YES. Code de sortie = différent de zéro %UT [message_erreur ] et code de sortie = 2 Définit le statut du fichier à NO. Définit le statut du fichier à NO. Une méthode qui ne supporte pas la tâche CF écrit un message %UT vers stdout et sort en renvoyant le code de sortie 2. Tâche d obtention d un statut (GS) La tâche GS charge la méthode de l agent étendu de vérifier le statut d un travail. Cette opération est nécessaire lorsque l exécution d un autre travail dépend du succès de l exécution d un travail externe. Avant l exécution de la méthode, le paramètre GSuser est lu à partir du fichier d options de la méthode pour déterminer le compte utilisateur avec lequel la méthode doit être exécutée. Si le paramètre ne figure pas dans le fichier d options ou si celui-ci n existe pas, le programme utilise l utilisateur root (sur Unix) et le nom de l utilisateur du compte où le planificateur a été installé (sur Windows). Si la méthode ne peut pas être lancée, le travail ou le flux de travaux dépendant ne peut pas être exécuté. Si l id_travail d une précédente tâche GS est disponible, il est transmis à la méthode. La méthode vérifie le statut du travail indiqué et le renvoie dans un message %CJ écrit vers stdout. Elle existe alors avec le code de sortie 0. Conformément à la Chapitre 8. Référence aux agents étendus 309

334 fréquence définie par l option locale bm check status, la méthode est réexécutée avec une tâche GS jusqu à ce que l un des statuts de travail suivants soit renvoyé : abend Le travail s est arrêté de manière anormale. succ Le travail a abouti. cancl Le travail a été annulé. done Le travail a été effectué sans savoir s il a abouti ou s il a échoué. fail Le travail n a pas pu être exécuté. error Une erreur s est produit dans la méthode lors de la vérification du statut du travail. extrn La vérification du travail a échoué ou le statut du travail n a pas pu être déterminé. Notez que GStimeout dans le fichier d options de la méthode indique le temps pendant lequel le planificateur attend une réponse avant de supprimer la méthode. Pour plus d informations, voir «Fichier d options de méthode», à la page 307. Les réponses de méthode sont décrites dans le tableau ci-après. Tâche Réponse de la méthode Action IBM Tivoli Workload Scheduler GS %CJ statut [id_travail] Définit l état du travail à état et inclut id_travail dans toute tâche GS suivante. %UT [message_erreur ] et code de sortie = 2 L état du travail est inchangé. Commande Une méthode qui ne supporte pas la tâche GS écrit un message %UT à stdout et sort avec le code de sortie 2. cpuinfo La commande cpuinfo peut être utilisée dans une méthode d accès pour renvoyer des informations à partir d une définition de poste de travail. Pour plus d informations sur la commande complète, voir «cpuinfo», à la page 244. Identification et résolution des incidents Les sections suivantes décrivent comment identifier et déboguer des problèmes survenus au niveau d agents étendus et de méthodes d accès. Messages d erreur de la liste standard d un travail Tous les messages en sortie émanant d une méthode d accès, exceptés ceux commençant par un symbole de pourcentage (%), sont écrits dans le fichier de la liste standard (stdlist) du travail. Pour les tâches GS et CF qui ne sont pas associées aux travaux du planificateur, les messages sont écrits dans le fichier de liste standard du planificateur. Pour obtenir des informations relatives à tout problème, reportez-vous à ces fichiers. Méthode non exécutable Si une méthode d accès ne peut pas être exécutée, les événements suivants se produiront : v Pour des tâches LJ et MJ, le travail se voit affecter le statut fail. 310 IBM Tivoli Workload Scheduler - Guide de référence

335 v Pour la tâche CF, la dépendance par rapport à un fichier n est pas résolue et le travail dépendant conserve le statut hold. v Pour la tâche GS, la dépendance par rapport à un travail n est pas résolue et le travail dépendant conserve le statut hold. Pour plus d informations, consultez la liste des fichiers standard (stdlist) pour le travail et le planificateur. Messages du gestionnaire de console Le programme génère le message d erreur suivant si vous exécutez une commande start, stop, link ou unlink sur un agent étendu : Error executing command: Not implemented for extended agents. [ ] Ce message d erreur n est pas affiché si des caractères génériques ont été utilisés pour la sélection d un agent étendu. Messages des programmes Composer et compiler Le programme génère les messages d erreur suivants dès que le programme Composer rencontre une syntaxe incorrecte dans une définition de poste de travail : ACCESS METHOD is syntactically invalid [ ] Duplicate ACCESS keyword [ ] Missing or invalid ACCESS METHOD [ ] Si un agent étendu est défini avec une méthode d accès mais sans hôte, le message suivant s affiche : "Method needs a Host CPU" Messages du programme jobman Pour les agents étendus, les messages d information, d avertissement ou d erreur sont générés dans le fichier stdlist de Jobman. Un travail dont le lancement a abouti génère le message suivant : Launched job nom_travail for poste_travail, #Jid_travail for user nom_utilisateur. Un travail dont le lancement n a pas abouti génère le message suivant : Error launching nom_travail for poste_travail: texte_erreur L échec d une tâche de vérification de fichier génère le message suivant : Error invoking nom_méthode for poste_travail: texte_erreur L échec d une tâche de gestion de fichier génère le message suivant : Error managing nom_travail for poste_travail using nom_méthode: texte_erreur Lorsqu une méthode envoie un message à Jobman qui n est pas reconnu, le message suivant est généré : Error: message invalid for nom_travail, #jnum_travail for poste_travail using nom_méthode. "first 64 characters of the offending message" Chapitre 8. Référence aux agents étendus 311

336 312 IBM Tivoli Workload Scheduler - Guide de référence

337 Chapitre 9. Référence aux agents réseau Présentation Les dépendances interréseaux d IBM Tivoli Workload Scheduler permettent aux travaux et aux flux de travaux d un réseau local du planificateur d utiliser les travaux et flux de travaux d un réseau distant sous la forme de dépendances d aboutissement. Le présent chapitre décrit comment utiliser les dépendances interréseaux. Le présent chapitre détaille les points suivants : v Présentation v Configuration d un poste de travail d agent réseau v Dépendances interréseau Un agent réseau correspond à une définition de poste de travail logique qui autorise des dépendances d aboutissement entre un réseau local du planificateur et un réseau distant du planificateur. Les dépendances d aboutissement distantes sont affectées aux travaux et aux flux de travaux de la même façon que les dépendances locales, si ce n est que le nom de l agent réseau est inclus afin d indiquer que le travail ou le flux de travaux se trouve dans un réseau externe du planificateur. Ce type de dépendance est appelé dépendance interréseau. Si des flux de travaux dotés de dépendances interréseaux sont inclus dans le programme, un flux de travaux spécial nommé EXTERNAL est créé pour afficher l état de ces dépendances. Ce flux de travaux EXTERNAL contient des travaux de marque de réservation qui représentent chaque dépendance suivante distante. La définition du poste de travail d un agent réseau contient le nom de la méthode d accès au réseau, netmth. Un fichier d options est utilisé pour indiquer l utilisateur au nom duquel la méthode s exécute ainsi que la fréquence à laquelle les dépendances d un travail ou d un flux de travaux sont vérifiées. Ce fichier d options doit posséder le même nom de chemin d accès que ses méthodes d accès et doit s appeler netmth.opts. Le planificateur invoque la méthode d accès chaque fois qu il a besoin de vérifier le statut d un travail ou d un flux de travaux distant. La méthode d accès interroge le réseau distant sur l état du travail ou du flux de travaux prédécesseur. Le planificateur poursuit sa vérification jusqu à ce que le travail ou le flux de travaux distant ait le statut SUCC, CANCL ou ERROR. Vous pouvez contrôler l état des dépendances interréseaux avec Job Scheduling Console en affichant le flux de travaux EXTERNAL. Configuration d un poste de travail d agent réseau Avant d indiquer une dépendance interréseau, vous devez créer une définition de poste de travail planificateur pour le réseau distant. La définition du poste de travail d un réseau distant est appelée un agent réseau. Les postes de travail des agents de réseau sont définis de façon standard comme des agents étendus et nécessitent un poste hôte et une méthode d accès netmeth. Copyright IBM Corp. 1999,

338 A l aide de Job Scheduling Console, définissez un poste de travail d agent réseau dans la base de données du planificateur. Procédez comme suit : 1. Dans la sous-fenêtre Liste d actions de Job Scheduling Console, ouvrez le commutateur Nouveau poste de travail 2. Cliquez sur le nom du moteur. La fenêtre Propriétés d un poste de travail dans la base de données est affichée. 3. Dans la zone Nom, indiquez un nom pour ce poste de travail. Ce nom peut comporter jusqu à 16 caractères alphanumériques. Il peut contenir un tiret et un trait de soulignement, mais il doit commencer par une lettre. Par exemple, MaîtreB. 4. Dans la zone Noeud, indiquez le nom du noeud ou l adresse IP du poste de travail. Seuls les noms de domaine complets sont acceptés. Cette zone est obligatoire. 5. Dans la zone Port TCP, entrez le numéro de port utilisé par le gestionnaire de domaine maître dans le réseau distant. Dans l exemple qui suit, le numéro de port utilisé par MaîtreA. 6. Dans la zone Système d exploitation, sélectionnez AUTRE. 7. Dans la zone Domaine, indiquez le domaine du poste de travail hôte. 8. Dans la zone Fuseau horaire, indiquez le fuseau horaire de ce poste de travail (facultatif). 9. Dans la zone Description, entrez une description du poste de travail. Cette description peut comporter jusqu à 40 caractères et doit commencer par une lettre. 10. Dans la zone Type de poste de travail, sélectionnez Agent étendu dans la liste déroulante. 11. Ne cochez pas la case Ignorer. 12. Dans la zone Méthode d accès, entrez netmeth. 13. Dans la zone Hôte, indiquez le nom du noeud du poste de travail hôte (dans l exemple, MaîtreB) ou sélectionnez-en un dans la liste obtenue en cliquant sur le bouton Postes de travail. 14. Cliquez sur OK. Le poste de travail d agent réseau est sauvegardé dans la base de données du planificateur MaîtreB (réseau local). L exemple suivant montre comment définir un poste de travail d agent réseau pour un réseau distant, Réseau A, qui permet au réseau local, Réseau B, d utiliser les travaux et flux de travaux du réseau distant sous la forme de dépendances d aboutissement. 314 IBM Tivoli Workload Scheduler - Guide de référence

339 Figure 7. Réseaux local et distant Les étapes suivantes montrent comment définir un poste de travail d agent réseau appelé AgentRéseau qui se sert de la méthode d accès netmth. 1. Définissez le poste de travail MaîtreA dans la base de données MaîtreA. L utilisateur de poste de travail est maîtrea_tws. 2. Indiquez le numéro de port TCP pour MaîtreA, tel que Indiquez le noeud pour MaîtreA, tel que MaîtreA.rome.tivoli.com. 4. Définissez le poste de travail MaîtreB dans la base de données MaîtreB. L utilisateur de ce poste de travail est maîtreb_tws. 5. Indiquez le noeud pour MaîtreB, tel que MaîtreB.rome.tivoli.com. La définition du poste de travail d agent réseau est sauvegardée dans la base de donnée MaîtreB. Exemple de ligne de commande d agent réseau L exemple suivant montre une définition de poste de travail sur la ligne de commande pour l agent réseau AgentRéseau de la figure 7 : CPUNAME AGENTRESEAU DESCRIPTION "AGENT RESEAU" OS OTHER NODE MAITREA.ROME.TIVOLI.COM TCPADDR (Le poste de travail AgentRéseau est en mode écoute sur le port MaîtreA.) FOR maestro HOST MAITREB ACCESS NETMTH END Chapitre 9. Référence aux agents réseau 315

340 Fichier d options Un fichier d options doit être créé pour indiquer le poste utilisateur sur lequel la méthode d accès est exécutée et la fréquence à laquelle les dépendances d un travail ou d un flux de travaux distant sont vérifiées. Les modifications apportées à ce fichier ne prennent effet qu une fois que vous avez arrêté puis redémarré le planificateur. Ce fichier d options doit posséder le même nom de chemin d accès que ses méthodes d accès et doit s appeler netmth.opts. racine_tws/methods/netmth.opts Syntaxe GSuser=nom_connexion GStimeout=secondes Où : nom_connexion Nom de connexion utilisé pour exécuter la méthode. Si le système hôte de l agent réseau exécute Windows, l utilisateur doit être défini dans le planificateur. secondes Indique le temps, exprimé en secondes, pendant lequel le planificateur attend une réponse avant de supprimer la méthode d accès. La valeur par défaut est 300 secondes. Si la méthode d accès est appelée à nouveau, elle démarrera automatiquement. Exemple de fichier d options Les fichiers d options sur MaîtreB pour la méthode netmth ressemblent au fichier suivant : GSuser=maîtreA_tws GStimeout=600 Dépendances interréseau Les dépendances interréseaux sont spécifiées dans l éditeur de flux de travaux avec la console Job Scheduling Console. Cliquez sur le bouton Ajout d une dépendance à l interréseau pour ajouter une icône de travail d interréseau au flux de travaux (représentant le prédécesseur), puis créez la dépendance entre prédécesseur et successeur entre cette icône et un autre travail avec le bouton Ajout d un lien. Remarque : les travaux et flux de travaux distants sont définis sur leur réseau local et y sont exécutés de façon standard. Qu ils soient utilisés comme dépendances interréseaux n a aucun effet sur leur comportement local. Lorsque des travaux et des flux de travaux distants sont spécifiés comme étant des dépendances entre prédécesseur et successeur de flux de travaux locaux, ils sont suivis par Conman dans un flux de travaux externes spécialement créé à cet effet. Les noms sont générés pour les dépendances et sont traités en tant que travaux dans le flux de travaux externes. 316 IBM Tivoli Workload Scheduler - Guide de référence

341 Création d une dépendance interréseau sur un flux de travaux Pour ajouter une dépendance interréseau à un flux de travaux : 1. Ouvrez la vue Graphe en cliquant avec le bouton droit sur un flux de travaux et en sélectionnant Ouvrir à partir du menu en incrustation. 2. Dans la vue Graphe, cliquez sur le bouton Ajout d une dépendance sur l interréseau dans la barre d outils. La fenêtre Dépendance interréseau s ouvre alors. 3. Cliquez sur le bouton Rechercher (...) et utilisez la fenêtre Recherche d un poste de travail pour sélectionner le nom d un agent réseau. 4. Dans la zone Dépendance, indiquez la dépendance à format libre ou le prédécesseur de travail/flux de travaux sous le format poste_travail#flux_travaux.travail. La longueur maximale de cette zone est : v 120 caractères à format libre v 16 pour le poste de travail v 16 pour le flux de travaux v 40 pour le travail 5. Cliquez sur OK pour fermer la fenêtre. Si vous ajoutez une nouvelle dépendance interréseau, un bouton de nouvelle dépendance interréseau apparaît dans la vue Graphe. 6. Sauvegardez le flux de travaux. Utilisation de la ligne de commande Les dépendances interréseaux peuvent être incluses dans des flux de travaux composés à l aide de la ligne de commande de Composer. Par exemple, pour créer une dépendance d aboutissement à un travail ou flux de travaux en utilisant le mot clé follows, procédez comme suit : v Dépendance interréseau d un flux de travaux 1. Définissez un flux de travaux appelé plana dans la base de données MaîtreA. 2. Définissez un flux de travaux appelé planb dans la base de données MaîtreB avec une dépendance sur plana. Utilisez la ligne de commande du programme Composer pour définir la dépendance interréseau du flux de travaux comme suit : schedule planb on everyday : end follows AgtRéseau::MaîtreA#planA v Dépendance interréseau d un travail 1. Définissez un travail appelé travaila dans la base de données MaîtreA. 2. Définissez un travail appelé travailb dans la base de données MaîtreB avec une dépendance sur travaila. Utilisez la ligne de commande du programme Composer pour définir la dépendance interréseau du flux de travaux comme suit : $jobs travailb... follows AgtRéseau::MaîtreA#travailA end end Chapitre 9. Référence aux agents réseau 317

342 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création de flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Dépendances interréseau et Conman Dans le plan, les dépendances interréseaux s affichent et sont manipulées de plusieurs façons. v Planification ad hoc v Flux de travaux externes Planification ad hoc et dépendances interréseau Les dépendances interréseau peuvent servir de dépendances d aboutissement pour les travaux et flux de travaux soumis au plan. Les dépendances sont indiquées comme telles pour d autres dépendances entre prédécesseur et successeur. Pour plus d informations, voir «Création d une dépendance interréseau sur un flux de travaux», à la page 317. Flux de travaux externes Toutes les dépendances interréseaux s affichent dans un flux de travaux externes. Les dépendances sont répertoriées en tant que travaux, indépendamment du fait qu elles soient définies pour des travaux ou des flux de travaux. Il existe un flux de travaux externes pour chaque agent réseau du plan. Des noms de travail spécifiques sont générés comme suit : Ennnmmss Où : nnn est un nombre aléatoire. mm sont les minutes en cours. ss sont les secondes en cours. Le nom réel du travail ou du flux de travaux est enregistré dans la partie JCL de l enregistrement de travail. Etat des travaux externes L état de libération des travaux est déterminé par la méthode d accès et répertorié dans la zone Statut du flux de travaux externes. L état de libération est l état enregistré à la dernière interrogation du réseau distant. Les travaux peuvent sembler sauter les états survenant entre les interrogations. Tous les états des travaux et des flux de travaux sont répertoriés, sauf FENCE. De plus, deux états sont spécifiques aux travaux externes : ERROR Une erreur est survenue lors de la vérification du statut distant. EXTRN Etat inconnu. Une erreur est survenue, une action de réexécution a été effectuée sur le flux de travaux externes ou le travail ou le flux de travaux INET n existe pas. 318 IBM Tivoli Workload Scheduler - Guide de référence

343 Actions sur les travaux externes Vous pouvez effectuer trois actions différentes sur des travaux distants dans un agenda EXTERNE : annulation (Cancel), réexécution (Rerun) et confirmation (Confirm). Remarque : Aucune de ces commandes n a d effet sur le travail ou l agenda distant dans le réseau distant. Elles permettent simplement de manipuler les dépendances du réseau local. Cancel Annule le travail EXTERNE, libérant ainsi la dépendance de tous les travaux et agendas locaux. La vérification du statut de la dépendance prend fin. Rerun Demande à Conman de redémarrer la vérification du statut du travail EXTERNE. Immédiatement après une réexécution, le travail acquiert le statut EXTRN. La réexécution est intéressante pour les travaux EXTERNES ayant le statut ERROR. Par exemple, si un travail EXTERNE ne peut pas être lancé parce que la méthode d accès réseau n accorde pas l autorisation d exécution, le travail acquiert le statut ERROR et celui-ci cesse d être vérifié. Lorsque vous aurez corrigé les autorisations, la méthode pourra démarrer, mais Conman ne démarrera la vérification du statut du travail EXTERNE que lorsque vous aurez effectué une réexécution. Confirm SUCC / ABEND Affecte le statut SUCC ou ABEND au travail EXTERNE, libérant ainsi la dépendance pour tous les travaux et agendas locaux. La vérification du statut de la dépendance prend fin. Actions sur les dépendances interréseau des travaux et des agendas Les dépendances interréseaux sont répertoriées dans la colonne Dépendances des fenêtres SHOWJOBS et SHOWSCHEDULES des agendas au format suivant : net::net_dep Où : net Nom du poste de travail de l agent réseau. Les deux-points doubles (::) sont un délimiteur requis. Les caractères génériques sont acceptés. net_dep Désigne la dépendance interréseau au format suivant : [poste_travail#] sched[.travail] Si aucun poste de travail n est indiqué, le poste par défaut est celle du planificateur à laquelle l agent réseau est connecté. Cette valeur est déterminée par les zones Noeud et Adresse TCP de la définition de poste de travail de l agent réseau. Les caractères génériques sont acceptés. Les actions Libérer, Ajouter une dépendance et Supprimer une dépendance fonctionnent de la même façon pour les dépendances interréseaux que pour les autres dépendances. Chapitre 9. Référence aux agents réseau 319

344 Spécification de ligne de commande Conman Les commandes Conman pouvant spécifier des dépendances interréseaux sont répertoriées ci-après avec un exemple basé sur : v Un poste de travail de planificateur local appelé local1 v Un agenda défini pour local1 appelé plan1 v Un travail situé dans local1#plan1 appelé travail1 v Un agent de réseau planificateur appelé agtréseau v Un poste de travail de planificateur situé dans le réseau distant de l agent réseau appelée distant1 v Un agenda défini pour distant1 appelé pland v Un travail situé dans distant1#pland appelé travaild adddep job : Ajoute un travail distant sous la forme d une dépendance d aboutissement à un travail : adj local1#plan1.travail1;follows=agtréseau::distant1#pland.travaild adddep sched : Ajoute un agenda distant sous la forme d une dépendance d aboutissement à un agenda : ads local1#plan1;follows=agtréseau::distant1#pland cancel job : Annule tous les travaux EXTERNES pour un agent réseau (les deux commandes sont équivalentes) : cj agtréseau#external.@ cj agtréseau::@ confirm : Confirme qu un travail EXTERNE s est terminé avec succès : confirm agtréseau::distant1#pland.travaild;succ deldep job : Supprime une dépendance de travail distant d un travail : ddj local1#plan1.travail1;follows=agtréseau::distant1#pland.travaild deldep sched : Supprime une dépendance de travail distant d un agenda : dds local1#plan1;follows=agtréseau::distant1#pland.travaild release job : Libère un travail d une dépendance interréseau : rj local1#plan1.travail1;follows=agtréseau::distant1#pland.travaild release sched : Libère un agenda d une dépendance interréseau : rs local1#plan1;follows=agtréseau::distant1#pland.travaild rerun : Réexécute un travail EXTERNE (les deux commandes sont équivalentes) : rr agtréseau#external.travaild rr agtréseau::distant1#pland.travaild showjobs;info : Affiche toutes les dépendances distantes pour un agent réseau avec leur nom d origine et leur nom généré par le planificateur : sj agtréseau#external.@;info submit : Soumet une commande rm dans l agenda JOBS avec un agenda distant sous la forme d une dépendance d aboutissement : sbd "rm apfile";follows=agtréseau::distant1#pland 320 IBM Tivoli Workload Scheduler - Guide de référence

345 Informations complémentaires Pour connaître la tâche Job Scheduling Console équivalente, voir Création de flux de travaux du document IBM Tivoli Workload Scheduler Job Scheduling Console - Guide d utilisation. Chapitre 9. Référence aux agents réseau 321

346 322 IBM Tivoli Workload Scheduler - Guide de référence

347 Chapitre 10. Configuration des définitions de sécurité utilisateur Centralisation de la sécurité Pour déterminer les privilèges des utilisateurs, les programmes et commandes IBM Tivoli Workload Scheduler comparent leurs noms d utilisateur aux définitions d utilisateur figurant dans le fichier de sécurité. Le présent chapitre explique comment mettre en place les définitions d utilisateur et gérer le fichier de sécurité. Grâce à l option globale Sécurité centralisée, les administrateurs Tivoli Workload Scheduler peuvent choisir entre les deux modèles de sécurité suivants : Sécurité centralisée Les fichiers de sécurité de tous les postes de travail réseau Tivoli Workload Scheduler peuvent être créés et modifiés uniquement sur le gestionnaire de domaine maître. Par ailleurs, la production, la maintenance et la distribution des fichiers est assurée par l administrateur Tivoli Workload Scheduler. Remarque : La sécurité centralisée n est pas prise en charge si vous manipulez des bases de données IBM Tivoli Workload Scheduler non étendues. Sécurité locale Le fichier de sécurité de chaque poste de travail peut être géré par son administrateur ou son superutilisateur. L utilisateur local peut exécuter la commande makesec pour créer ou mettre à jour le fichier. Sur le maître IBM Tivoli Workload Scheduler, définissez l option globale Sécurité centralisée sur ON pour activer la sécurité centralisée. Une fois l option globale activée, l utilitaire Jnextday recherche les informations de sécurité dans le fichier Symphony, qui consigne également le fait que l option est activée. Dès que le gestionnaire de domaine maître a fini de distribuer le fichier Symphony sur le réseau, chaque poste de travail comprend un fichier Symphony renfermant les mêmes informations de sécurité. Le mécanisme de sécurité centralisée est activé chaque fois qu une liaison est établie ou qu une commande IBM Tivoli Workload Scheduler est exécutée. Dans les réseaux dotés d une sécurité centralisée, le programme ne pourra pas établir la connexion entre deux postes de travail si la sécurité centralisée est désactivée dans le fichier Symphony de l un des postes de travail ou si les informations du fichier de sécurité diffèrent. Par contre, un poste de travail doit toujours accepter les demandes de connexion entrantes déposées par son gestionnaire de domaine même si les informations du fichier de sécurité transmises par le gestionnaire de domaine ne correspondent pas à celles de son fichier Symphony. Grâce à cette convention, les administrateurs peuvent modifier le fichier de sécurité sur le système maître, sans avoir à redistribuer le fichier modifié sur l ensemble du réseau avant d exécuter l utilitaire Jnextday. Copyright IBM Corp. 1999,

348 Chaque fois qu une commande est exécutée sur le poste de travail d un réseau doté de la sécurité centralisée (via le programme Conman ou le composant Job Scheduling Console), les sous-programmes de sécurité vérifient que les informations de sécurité du fichier Symphony correspondent bien à celles du fichier de sécurité locale. Dans le cas contraire, le programme interdit (ou limite) tout accès aux objets et aux commandes IBM Tivoli Workload Scheduler avant de consigner un message de violation d accès. La sécurité centralisée ne régit pas les transactions IBM Tivoli Workload Scheduler pour lesquelles le fichier Symphony est inutile. Dans ce cas, les commandes ne demandant pas l exécution du fichier Symphony utilisent le fichier de sécurité locale. Par exemple, la commande parms, qui permet de modifier ou d afficher la base de données des paramètres locaux, continue à s appuyer sur le fichier de sécurité locale même si la sécurité centralisée est active et si le fichier de sécurité locale diffère des conventions de sécurité centralisée. Si le fichier de sécurité d un poste de travail doit être supprimé et recréé, les informations de sécurité qu il contenait ne correspondront plus à celles du fichier de sécurité résidant sur le système maître (qui sont également consignées dans le fichier Symphony). En outre, le programme protège le fichier contre toute contrefaçon, grâce à un mécanisme associé au processus de création du fichier Symphony. Utilisation du fichier de sécurité Sur un réseau IBM Tivoli Workload Scheduler regroupant plusieurs gestionnaires de domaine, agents à tolérance de pannes et agents standard, chaque poste de travail possède son propre fichier de sécurité. Vous pouvez gérer un fichier sur chaque poste de travail ou créer un fichier de sécurité sur le gestionnaire de domaine maître que vous copierez ensuite sur chaque gestionnaire de domaine, agent à tolérance de pannes et agent standard. Vérifiez que tous les utilisateurs IBM Tivoli Workload Scheduler disposent des privilèges nécessaires dans le fichier de sécurité. Le logiciel comprend un fichier modèle baptisé racine_tws/config/security.conf. Durant l installation, le programme installe une copie du modèle dans le répertoire racine_tws/config/security.conf et une copie opérationnelle compilée dans le répertoire racine_tws/security.conf. Création du fichier de sécurité Pour créer les définitions d utilisateur, modifiez le fichier modèle racine_tws/security.conf. Ne modifiez pas le modèle original figurant dans le répertoire racine_tws/config/security.conf. Exécutez la commande makesec pour compiler et installer un nouveau fichier de sécurité opérationnel. A l issue de l installation, vous pouvez modifier le fichier à votre guise via la commande dumpsec. Pour plus d informations, voir «dumpsec», à la page 340 et «makesec», à la page 341. Modification du fichier de sécurité Pour modifier le fichier de sécurité, procédez comme suit : 1. Arrêtez les connecteurs (voir «Arrêt des connecteurs pour l application des modifications», à la page 325). 2. Exécutez la commande dumpsec pour télécharger le fichier de sécurité (voir «dumpsec», à la page 340). 324 IBM Tivoli Workload Scheduler - Guide de référence

349 3. Modifiez la syntaxe du fichier de sécurité (voir «Syntaxe du fichier de sécurité»). 4. Exécutez la commande makesec pour transférer le fichier de sécurité (voir «makesec», à la page 341). 5. Arrêtez et réexécutez le programme Conman ou Composer pour appliquer les modifications apportées au fichier de sécurité (voir Chapitre 5, «Référence au programme Conman», à la page 129 ou Chapitre 3, «Référence au programme Composer», à la page 35). Arrêt des connecteurs pour l application des modifications Sous Windows, vous devez arrêter le connecteur avant d exécuter la commande makesec. Sur UNIX, vous pouvez l arrêter avant ou après l exécution de la commande makesec. Exécutez la commande wmaeutil pour arrêter le connecteur. Exécution de la commande wmaeutil : Pour exécuter la commande wmaeutil, procédez comme suit : 1. Définissez l environnement Tivoli : v Depuis une ligne de commande UNIX : Pour ksh :. /etc/tivoli/setup_env.sh Pour csh : source /etc/tivoli/setup_env.sh v Depuis une ligne de commande Windows : %SYSTEMROOT%\system32\drivers\etc\Tivoli\setup_env.cmd 2. Exécutez la commande suivante : v UNIX : wmaeutil.sh ALL -stop v Windows : wmaeutil.cmd ALL -stop Syntaxe du fichier de sécurité Définitions Le fichier de sécurité renferme une ou plusieurs définitions d utilisateur. d utilisateur Une définition d utilisateur définit un groupe d utilisateurs, les objets auxquels il peut accéder et les opérations qu il peut réaliser. Syntaxe [# commentaires] user nom_définition attributs_utilisateur begin [* commentaires] type_objet [attributs_objet] access[=action[,...]] [type_objet... ] [end] Chapitre 10. Configuration des définitions de sécurité utilisateur 325

350 Paramètres [# *] commentaires Toutes les chaînes de texte comprenant le symbole dièse/astérisque et au moins un espace sont traitées comme des commentaires. Ils ne sont pas copiés dans le fichier de sécurité opérationnel installé par la commande makesec. nom_définition Précisez le nom de la définition d utilisateur. Il peut compter 36 caractères alphanumériques maximum et doit commencer par un caractère alphabétique. attributs_utilisateur Précisez un ou plusieurs attributs pour identifier le groupe d utilisateurs associés à la définition. Vous pouvez les définir comme suit : attribut_utilisateur[{+ ~}attribut_utilisateur[...]] Le signe plus (+) permet d ajouter un attribut que les utilisateurs doivent posséder. Quant au signe tilde (~), il permet d ajouter un attribut que les utilisateurs ne doivent pas posséder. Pour définir un attribut_utilisateur, procédez comme suit : cpu=poste_travail [,...] Où : poste_travail Précisez le poste de travail auquel l utilisateur est connecté. Les caractères génériques sont acceptés. En outre, vous pouvez utiliser les variables IBM Tivoli Workload Scheduler suivantes : $master L utilisateur est connecté au gestionnaire de domaine maître IBM Tivoli Workload Scheduler. $remotes L utilisateur est connecté à un agent standard IBM Tivoli Workload Scheduler. $slaves L utilisateur est connecté à un agent à tolérance de pannes IBM Tivoli Workload Scheduler. $thiscpu L utilisateur est connecté au poste de travail IBM Tivoli Workload Scheduler sur lequel le programme sécurisé est en cours d exécution. Si vous utilisez le composant Job Scheduling Console, adoptez la variable $framework. $framework Précisez le poste de travail sur lequel l utilisateur exécute le composant Job Scheduling Précisez que l utilisateur accède au produit IBM Tivoli Workload Scheduler via le composant Job Scheduling Console ou est connecté à un poste de travail IBM Tivoli Workload Scheduler. 326 IBM Tivoli Workload Scheduler - Guide de référence

351 group=nom_groupe[,...] Uniquement pour les utilisateurs UNIX. N employez pas cet argument si vous utilisez le composant Job Scheduling Console. Précisez le groupe UNIX auquel appartient l utilisateur. Les caractères génériques sont acceptés. logon=nom_utilisateur [,...] Où : nom_utilisateur Précisez le nom avec lequel l utilisateur s est connecté au poste de travail IBM Tivoli Workload Scheduler. Les caractères génériques sont acceptés. Vous devez définir l attribut cpu= sur le nom d un poste de travail ou sur le admin_tme Précisez le nom du groupe Administrateur Tivoli auquel appartient l utilisateur. Si ce nom comprend des espaces, vous devez le placer entre guillemets. Les caractères génériques sont acceptés. Vous devez définir l attribut cpu= sur Précisez que l utilisateur est connecté avec un nom quelconque ou appartient à un groupe Administrateur Tivoli. type_objet Précisez le type d objet pour lequel l utilisateur bénéficie de privilèges d accès. La liste suivante détaille les types d objet disponibles : calendar Calendriers utilisateur cpu Postes de travail et domaines file Fichiers base de données IBM Tivoli Workload Scheduler job Travaux planifiés parameter Paramètres utilisateur prompt Invites globales resource Ressources de planification schedule Flux de travaux userobj Objets utilisateur Vous pouvez ajouter plusieurs types d objet à une définition d utilisateur. Si vous omettez un type d objet, le programme interdira tout accès aux objets de ce type. attributs_objet Chaque type d objet comprend différents attributs d objet (voir tableau 11, à la page 328). Chapitre 10. Configuration des définitions de sécurité utilisateur 327

352 Tableau 11. Attribut d objet Attribut Nom cpu jcl logon Objet calendar Oui Non Non Non cpu Non Oui Non Non file Oui Non Non Non job Oui Oui Oui Oui parameter Oui Oui Non Non prompt Oui Non Non Non resource Oui Oui Non Non schedule Oui Oui Non Non userobj Non Oui Non Oui Précisez un ou plusieurs attributs pour identifier le groupe d objets du type spécifié. Si vous omettez les attributs, tous les objets du type spécifié restent accessibles. Vous pouvez les définir comme suit : attribut_objet[{+ ~}attribut_objet[...]] Le signe plus (+) permet d ajouter un attribut que les objets doivent posséder. Quant au signe tilde (~), il permet d ajouter un attribut que les objets ne doivent pas posséder. Pour définir un attribut d objet, procédez comme suit : name=nom[,...] Affectez un ou plusieurs noms au type d objet. Les caractères génériques sont acceptés. Si vous indiquez plusieurs noms, utilisez la virgule comme séparateur. Si vous omettez cet attribut, tous les objets définis restent accessibles. Les valeurs suivantes concernent le type d objet file : calendars Calendriers cpudata Postes de travail et domaines jobs Travaux mastsked Flux de travaux parameters Paramètres prodsked Agenda de production prompts Invites resources Ressources security Fichier de sécurité Symphony Plan de production cpu=poste_travail[,...] Précisez un ou plusieurs noms de poste de travail ou de domaine. Les caractères génériques sont acceptés. Si vous indiquez plusieurs noms, utilisez la virgule comme séparateur. Si vous omettez cet attribut, tous les postes de travail sont qualifiés. Vous pouvez utiliser les variables IBM Tivoli Workload Scheduler suivantes : $master, $remotes, $slaves et $thiscpu. Pour plus d informations, voir «Variables fournies avec le produit», à la page 332. jcl= chemin commande Précisez la commande ou le nom du chemin du fichier exécutable d un objet travail. Vous devez placer l expression entre 328 IBM Tivoli Workload Scheduler - Guide de référence

353 Tableau 12. Actions guillemets ( ). Les caractères génériques sont acceptés. Si vous omettez cet attribut, tous les fichiers de travail et commandes sont qualifiés. logon=nom_utilisateur[,...] Précisez les noms d utilisateur. Les caractères génériques sont acceptés. Si vous indiquez plusieurs noms, utilisez la virgule comme séparateur. Si cet attribut est omis, tous les noms d utilisateur sont qualifiés. Pour définir les objets de type job, vous pouvez utiliser les variables $jclowner, $owner et $user. Pour plus d informations, voir «Variables fournies avec le produit», à la page 332. action Précisez les opérations que les utilisateurs peuvent réaliser. Si vous indiquez plusieurs opérations, utilisez la virgule comme séparateur. Si vous omettez cet attribut, le programme interdit toute opération. Si vous tapez access=@, les utilisateurs peuvent réaliser toutes les opérations. Pour connaître tous les types d opération possibles par type d objet, voir tableau 12 et tableau 13. Action add adddep altpass altpri build cancel confirm console deldep delete display fence kill Objet calendar Oui Non Non Non Non Non Non Non Non Oui Oui Non Non cpu Oui Non Non Non Non Non Non Oui Non Oui Oui Oui Non file Non Non Non Non Oui Non Non Non Non Oui Oui Non Non job Oui Oui Non Oui Non Oui Oui Non Oui Oui Non Non Non parameter Oui Non Non Non Non Non Non Non Non Oui Oui Non Non prompt Oui Non Non Non Non Non Non Non Non Oui Oui Non Non resource Oui Non Non Non Non Non Non Non Non Oui Oui Non Non schedule Oui Oui Non Oui Non Oui Non Non Oui Oui Oui Non Non useobj Oui Non Oui Non Non Non Non Non Non Oui Oui Non Non Tableau 13. Actions (suite) Action limit link list modify release reply rerun Objet Oui shut down start stop submit unlink use calendar Non Non Non Oui Non Non Non Non Non Non Non Non Oui cpu Oui Oui Oui Oui Non Non Non Oui Oui Oui Non Oui Non file Non Non Non Non Non Non Non Non Non Non Non Non Non job Non Non Oui Oui Oui Oui Oui Non Non Non Oui Non Oui parameter Non Non Non Oui Non Non Non Non Non Non Non Non Non prompt Non Non Oui Oui Non Non Non Non Non Non Non Non Oui resource Non Non Oui Oui Non Non Non Non Non Non Non Non Oui schedule Oui Non Oui Oui Oui Oui Non Non Non Non Oui Non Non useobj Non Non Non Oui Non Non Non Non Non Non Non Non Non Remarques : 1. Le type d objet file permet de gérer la sécurité sur l interface de ligne de commande à laquelle lui seul peut être associé. 2. Concernant le type d objet file, l opération clean revient à effectuer l opération build. 3. Pour autoriser un utilisateur à basculer la fonction de gestionnaire de domaine sur un poste de travail, l utilisateur doit disposer de privilèges d accès start et stop sur le poste de travail. Chapitre 10. Configuration des définitions de sécurité utilisateur 329

354 add Ajoutez et enregistrez de nouveaux calendriers dans la base de données. adddep Ajoutez des dépendances aux travaux du plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. altpass Modifiez les mots de passe utilisateur dans la base de données. altpri Modifiez la priorité des travaux dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. build Générez les fichiers de base de données d IBM Tivoli Workload Scheduler. Cette opération est uniquement disponible depuis la ligne de commande. Dans le fichier de sécurité de l objet, la clé clean revient à utiliser la clé build. cancel Annulez les travaux dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. confirm Confirmez l exécution des travaux dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. console Affichez et modifiez la console IBM Tivoli Workload Scheduler. deldep Supprimez les dépendances des travaux dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. delete Supprimez les calendriers de la base de données. display Affichez les calendriers de la base de données. fence Modifiez la priorité limite des travaux du poste de travail dans le plan de production. kill Supprimez les travaux dans le plan de production. 330 IBM Tivoli Workload Scheduler - Guide de référence

355 limite Modifiez le nombre maximum de travaux du poste de travail dans le plan de production. link Etablissez les liaisons vers un poste de travail. list Affichez les postes de travail et les domaines dans le plan si vous exécutez un requête Job Scheduling Console ou la commande Conman show. modify Modifiez les calendriers de la base de données. release Libérez les travaux de leurs dépendances dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. reply Répondez aux invites des travaux dans le plan de production. rerun Relancez les travaux dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. shutdown Arrêtez le traitement IBM Tivoli Workload Scheduler. Cette opération est uniquement disponible depuis la ligne de commande. start Lancez le traitement IBM Tivoli Workload Scheduler. stop Arrêtez le traitement IBM Tivoli Workload Scheduler. submit Soumettez les travaux dans le plan de production. Cette opération n est pas disponible sur les postes de travail connectés à IBM Tivoli Workload Scheduler pour z/os dans le cadre de la planification complète. unlink Fermez les liaisons vers le poste de travail. use Utilisez les calendriers pour planifier les flux de travaux. Qualification de l ordre des utilisateurs Pour qualifier les utilisateurs qui accéderont aux objets IBM Tivoli Workload Scheduler, le programme compare les attributs des utilisateurs aux définitions utilisateur selon l ordre dans lequel les définitions ont été ajoutées au fichier de sécurité. La première définition correspondant à l utilisateur détermine ses privilèges. Pour cette raison, il est important de classer les définitions d utilisateur, en partant de la plus spécifique. Par exemple : #Incorrect : Chapitre 10. Configuration des définitions de sécurité utilisateur 331

356 #Première définition d utilisateur du fichier de sécurité USER First CPU=@+LOGON=TWSUser Begin... End #Deuxième définition d utilisateur du fichier de sécurité USER Second CPU=@+LOGON=TWSDomain/TWSUser Begin... End #Correct : #Première définition d utilisateur du fichier de sécurité USER First CPU=@+LOGON=TWSDomain/TWSUser Begin... End #Deuxième définition d utilisateur du fichier de sécurité USER Second CPU=@+LOGON=TWSUser Begin... End Pour plus d informations, voir «Exemple de fichier de sécurité», à la page 336. Qualification de l ordre des objets Dans une définition d utilisateur, vous pouvez utiliser plusieurs instructions sur un même type d objet pour affecter différents privilèges d accès à différents groupes d objets. Comme le programme utilise la première instruction correspondante, l ordre des instructions objet est très important. Elles doivent être classées de la plus spécifique à la moins spécifique. Par exemple : #Incorrect : job name=@ access=display job name=ar@ access=@ #Correct : job name=ar@ access=@ job name=@ access=display Pour plus d informations, voir «Exemple de fichier de sécurité», à la page 336. Variables fournies avec le produit Vous pouvez utiliser dans les attributs d objet les variables suivantes, qui sont fournies avec le produit : $jclgroup Nom de groupe du fichier exécutable d un travail $jclowner Propriétaire du fichier exécutable d un travail $master Gestionnaire de domaine maître IBM Tivoli Workload Scheduler $owner Créateur d un flux de travaux et de ses travaux $remotes Ensemble des postes de travail agent standard 332 IBM Tivoli Workload Scheduler - Guide de référence

357 $slaves Ensemble des postes de travail agent à tolérance de pannes $thiscpu Poste de travail sur lequel l utilisateur exécute la commande ou le programme IBM Tivoli Workload Scheduler $user Utilisateur qui exécute la commande ou le programme IBM Tivoli Workload Scheduler Les variables $jclgroup et $jclowner peuvent être vérifiées uniquement si l utilisateur exécute un programme IBM Tivoli Workload Scheduler sur le poste de travail où réside le fichier exécutable du travail. Si le programme est en cours d exécution sur un poste de travail différent, l accès utilisateur est refusé. Caractères génériques Si les descriptions de syntaxe les mentionnent, vous pouvez utiliser les caractères génériques suivants :? Remplace un caractère alphanumérique. % Remplace un caractère Remplace zéro ou plusieurs caractères alphanumériques. Superutilisateur (sur UNIX) Si le fichier de sécurité n existe pas, seuls les superutilisateurs peuvent accéder aux objets IBM Tivoli Workload Scheduler. En outre, ils ont accès à tous les objets et peuvent exécuter l ensemble des programmes et commandes IBM Tivoli Workload Scheduler. Pour contrôler les superutilisateurs, créez un fichier de sécurité contenant la définition d utilisateur de chaque superutilisateur. Dans le fichier de sécurité d un réseau, vous pouvez établir une distinction entre les superutilisateurs locaux et les superutilisateurs du gestionnaire de domaine maître. Par exemple, vous pouvez limiter les utilisateurs locaux aux opérations qui affectent uniquement leurs postes de travail de connexion et autoriser les superutilisateurs maîtres à celles qui affectent tous les postes de travail du réseau. Pour plus d informations, voir Exemple de fichier de sécurité. Privilèges d accès Le tableau suivant détaille les mots clés d accès possibles pour chaque type d objet et les privilèges octroyés aux utilisateurs depuis la ligne de commande Tivoli Workload Scheduler. Type d objet Mot clé d accès Privilège utilisateur calendar add Non disponible delete Non disponible display Accès Composer display et create modify Non disponible (voir file > modify) use Accès Composer use sur les objets calendar dans les agendas Chapitre 10. Configuration des définitions de sécurité utilisateur 333

358 Type d objet Mot clé d accès Privilège utilisateur cpu (domaines inclus) add Accès Composer add et new console Accès Conman console delete Accès Composer delete display Accès Composer display et create list Accès Conman showcpus fence Accès Conman fence limit Accès Conman limit link Accès Conman link modify Accès Composer modify et replace shutdown Accès Conman shutdown start Accès Conman start stop Accès Conman stop unlink Accès Conman unlink file build Accès Composer build delete Non disponible display Sécurité d accès via l accès dumpsec modify Sécurité d accès via l accès makesec et l accès Composer modify sur les objets calendar, parameter, prompt et resource job add Accès Composer add et new adddep Accès Conman adddep altpri Accès Conman altpri cancel Accès Conman cancel confirm Accès Conman confirm deldep Accès Conman deldep delete Accès Composer delete display Accès Conman display + accès Composer display list Accès Conman showjobs kill Accès Conman kill modify Accès Composer modify et replace release Accès Conman release reply Accès Conman reply rerun Accès Conman rerun submit Accès Conman submit (docommand, file, job) use Accès Composer use sur les objets job dans un agenda 334 IBM Tivoli Workload Scheduler - Guide de référence

359 Type d objet Mot clé d accès Privilège utilisateur parameter add Accès parms pour l ajout de paramètres delete Non disponible display Accès Composer display, create et parms pour l affichage des paramètres modify Non disponible (voir aussi file > modify) prompt add Non disponible delete Non disponible display Accès Composer display et create + accès Conman recall list Accès Conman showprompts modify Non disponible (voir file > modify) reply Accès Conman reply use Accès Composer use sur les objets prompt dans un flux de travaux + accès Conman add sur les dépendances resource add Non disponible delete Non disponible display Accès Composer display et create list Accès Conman showresources modify Non disponible (voir file > modify) resource Accès Conman resource use Accès Composer use sur les objets resource dans un flux de travaux + accès Conman add sur les dépendances schedule add Accès Composer add et new adddep Accès Conman adddep altpri Accès Conman altpri cancel Accès Conman cancel deldep Accès Conman deldep delete Accès Composer delete display Accès Composer display et create + accès Conman display list Accès Conman showschedules limit Accès Conman limit modify Accès Composer modify et replace release Accès Conman release reply Accès Conman reply submit Accès Conman submit sur un agenda Chapitre 10. Configuration des définitions de sécurité utilisateur 335

360 Type d objet Mot clé d accès Privilège utilisateur userjob add Accès Composer add et new delete Accès Composer delete display Accès Composer display (mot de passe masqué) modify Accès Composer modify altpass Accès Conman altpass Exemple de fichier de sécurité Le code suivant illustre un exemple de fichier de sécurité, suivi d une description. ########################################################### # Sample Security File ########################################################### # (1) APPLIES TO MAESTRO OR ROOT USERS LOGGED IN ON THE # MASTER DOMAIN MANAGER OR FRAMEWORK. user mastersm cpu=$master,$framework + logon=maestro,root,root_london-region begin # OBJECT ATTRIBUTES ACCESS CAPABILITIES # job schedule resource prompt file calendar cpu access=@ access=@ access=@ access=@ access=@ access=@ access=@ parameter name=@ ~ name=r@ access=@ userobj cpu=@ + logon=@ access=@ end ########################################################### # (2) APPLIES TO MAESTRO OR ROOT USERS LOGGED IN ON ANY # WORKSTATION OTHER THAN THE MASTER DOMAIN MANAGER. user sm logon=maestro,root begin # OBJECT ATTRIBUTES ACCESS CAPABILITIES # job cpu=$thiscpu access=@ schedule cpu=$thiscpu access=@ resource cpu=$thiscpu access=@ prompt access=@ file access=@ calendar access=@ cpu cpu=$thiscpu access=@ parameter cpu=$thiscpu ~ name=r@ access=@ end ########################################################### # (3) APPLIES TO USERS LOGGED INTO THE SYS GROUP ON THE # MASTER DOMAIN MANAGER OR FRAMEWORK. user masterop cpu=$master,$fw + group=sys begin # OBJECT ATTRIBUTES ACCESS CAPABILITIES # IBM Tivoli Workload Scheduler - Guide de référence

361 job + logon=twsdomain\twsuser job + logon=root access=adddep,altpri,cancel, confirm,deldep,release, reply,rerun,submit,use job + logon=$user,$jclowner ~ logon=root access=add,adddep,altpri, cancel,confirm, deldep,release,reply, rerun,submit,use schedule cpu=$thiscpu access=@ schedule cpu=@ access=adddep,altpri,cancel, deldep,limit,release, submit resource access=add,display, resource,use prompt access=add,display,reply,use file access=build calendar access=display,use cpu cpu=@ access=@ parameter name=@ ~ name=r@ access=@ end ########################################################### # (4) APPLIES TO USERS LOGGED INTO THE SYS GROUP ON ANY # WORKSTATION OTHER THAN THE MASTER DOMAIN MANAGER user op group=sys begin # OBJECT ATTRIBUTES ACCESS CAPABILITIES # job cpu=$thiscpu + logon=$user access=@ job cpu=$thiscpu + logon=root access=adddep,altpri,cancel, confirm,deldep,release, reply,rerun,submit,use job cpu=$thiscpu ~ logon=root access=adddep,altpri,cancel, confirm,deldep,release, reply,rerun,submit,use schedule cpu=$thiscpu access=@ resource access=add,display,resource,use prompt access=add,display,reply,use file access=build calendar access=use cpu cpu=$thiscpu access=console,fence,limit, link,start,stop,unlink parameter name=@ ~ name=r@ access=@ end ########################################################### # (5) APPLIES TO USERS LOGGED INTO THE MIS GROUP ON # ANY WORKSTATION OR FRAMEWORK. user misusers group=mis begin # OBJECT ATTRIBUTES ACCESS CAPABILITIES # job cpu=$thiscpu job + logon=$user access=@ cpu=$thiscpu + logon=$jclowner ~ logon=root access=submit,use schedule cpu=$thiscpu access=add,submit, modify,display parameter name=r@ access=@ Chapitre 10. Configuration des définitions de sécurité utilisateur 337

362 parameter access=display end ########################################################### # (6) APPLIES TO ALL OTHER USERS LOGGED IN ON ANY # WORKSTATION. user default logon=@ begin # OBJECT ATTRIBUTES ACCESS CAPABILITIES # job cpu=$thiscpu job + logon=$user access=@ cpu=$thiscpu + logon=$jclowner ~ logon=root access=submit,use schedule cpu=$thiscpu access=add,submit, modify,display parameter name=u@ access=@ parameter name=@ ~ name=r@ access=display end ########################################################### Comme vous pouvez le noter, les définitions sont classées de la plus spécifique à la moins spécifique. Compte tenu de l ordre des définitions, le programme commence par associer les utilisateurs maestro et root qui sont suivis par les utilisateurs des groupes sys et mis. Quant aux autres utilisateurs, ils sont associés à la dernière définition, qui représente la moins spécifique. # (1) APPLIES TO MAESTRO OR ROOT USERS LOGGED IN ON THE MASTER DOMAIN MANAGER OR FRAMEWORK. user mastersm cpu=$master,$fw + logon=maestro,root,root_london-region Cette définition d utilisateur régit l accès à l interface graphique et à l interface de ligne de commande des utilisateurs maestro et root connectés au gestionnaire de domaine maître. Elle octroie également un accès à l interface graphique aux utilisateurs du groupe Administrateurs Tivoli appelé Root_london-region. Ces derniers disposent d un accès illimité à tous les objets, à l exception des paramètres dont le nom commence par r. Seuls les utilisateurs du groupe mis ont accès aux paramètres r. # (2) APPLIES TO MAESTRO OR ROOT USERS LOGGED IN ON ANY WORKSTATION OTHER THAN THE MASTER DOMAIN MANAGER. user sm logon=maestro,root Cette définition d utilisateur s adresse aux utilisateurs maestro et root non concernés par la définition (1), c est-à-dire les utilisateurs connectés à un poste de travail autre que le gestionnaire de domaine maître ou un ordinateur Tivoli Management Framework. Ils disposent d un accès illimité à tous les objets résidant sur leur poste de travail de connexion. Comme les invites, les fichiers et les calendriers sont globaux par nature, ils ne sont pas associés à un poste de travail. # (3) APPLIES TO USERS LOGGED INTO THE SYS GROUP ON THE MASTER DOMAIN MANAGER OR FRAMEWORK. user masterop cpu=$master,$fw + group=sys Cette définition d utilisateur concerne les utilisateurs connectés au groupe sys sur le gestionnaire de domaine maître ou un ordinateur Tivoli Management Framework. Ils disposent d un groupe unique de privilèges d accès. Vous pouvez 338 IBM Tivoli Workload Scheduler - Guide de référence

363 utiliser plusieurs instructions objet pour octroyer aux utilisateurs un type d accès particulier selon le groupe d objet. Par exemple, le programme propose trois instructions : v La première instruction confère un accès illimité aux travaux qui sont exécutés sur un poste de travail quelconque (@) sous le nom de l utilisateur ($user). v La deuxième instruction confère un type d accès particulier aux travaux qui sont exécutés sur un poste de travail quelconque en tant que superutilisateur. v La troisième instruction confère un type d accès particulier aux travaux qui sont exécutés sur un poste de travail quelconque. Ils doivent être exécutés sous le nom de l utilisateur ($user) ou du propriétaire du fichier de travail ($jclowner). Le programme exclut les travaux exécutés par un superutilisateur. # (4) APPLIES TO USERS LOGGED INTO THE SYS GROUP ON ANY WORKSTATION OTHER THAN THE MASTER DOMAIN MANAGER. user op group=sys Cette définition d utilisateur s adresse aux utilisateurs sys non concernés par la définition (3), c est-à-dire les utilisateurs connectés à un poste de travail autre que le gestionnaire de domaine maître ou un ordinateur Tivoli Management Framework. Ils disposent d un ensemble de privilèges d accès similaires à ceux de la définition (3), sauf que l accès est limité aux objets résidant sur le poste de travail de connexion ($thiscpu) de l utilisateur. # (5) APPLIES TO USERS LOGGED INTO THE MIS GROUP ON ANY WORKSTATION OR FRAMEWORK. user misusers group=mis Cette définition d utilisateur concerne les utilisateurs connectés au groupe mis sur un poste de travail quelconque ou un ordinateur Tivoli Management Framework. Ils disposent d un ensemble limité de privilèges d accès. Le programme omet les ressources, les invites, les fichiers, les calendriers et les postes de travail, pour interdire tout accès à ces objets. Les utilisateurs disposent d un accès illimité aux paramètres dont le nom commence par r, mais peuvent seulement afficher les autres paramètres. # (6) APPLIES TO ALL OTHER USERS LOGGED IN ON ANY WORKSTATION. user default logon=@ Cette définition d utilisateur confère un ensemble de privilèges par défaut aux utilisateurs qui ne sont pas concernés par les définitions précédentes (1 à 5). Ils disposent d un accès illimité aux paramètres dont le nom commence par u, mais peuvent seulement afficher les autres paramètres. Ils ne peuvent en aucun cas accéder aux paramètres dont le nom commence par r. Chapitre 10. Configuration des définitions de sécurité utilisateur 339

364 dumpsec Décompresse le fichier de sécurité et transfère la sortie dans le fichier stdout. L utilisateur doit bénéficier d un accès display sur le fichier de sécurité. Syntaxe dumpsec -v -u dumpsec fichier_sécurité Description Si vous ne définissez aucun argument, le programme vide le fichier de sécurité opérationnel (racine_tws/security.conf). Pour créer une copie modifiable du fichier de sécurité, redirigez la sortie de la commande vers un autre fichier (voir exemples suivants). Arguments -v Affiche uniquement les informations sur la version de la commande. -u Affiche uniquement les informations sur l utilisation de la commande. fichier_sécurité Précisez le nom du fichier de sécurité à vider. Exemples La commande suivante permet d afficher la version de la commande : dumpsec -v La commande suivante permet de vider le fichier de sécurité opérationnel dans le fichier stdout : dumpsec La commande suivante permet de vider le fichier de sécurité opérationnel dans le fichier mysec : dumpsec > mysec La commande suivante permet de vider le fichier de sécurité sectemp dans le fichier stdout : dumpsec sectemp 340 IBM Tivoli Workload Scheduler - Guide de référence

365 makesec Compresse les définitions d utilisateur et installe le fichier de sécurité. Toutes les modifications apportées au fichier de sécurité sont appliquées à l arrêt et au redémarrage des programmes suivants : Conman Quittez et exécutez à nouveau le programme. Composer Quittez et exécutez à nouveau le programme. Connecteurs IBM Tivoli Workload Scheduler Arrêtez les connecteurs via la commande wmaeutil. Le programme réexécute automatiquement les connecteurs en régénérant la première requête sur le composant Job Scheduling Console. Pour utiliser la commande makesec, vous devez disposer d un accès de type modify sur le fichier de sécurité. Syntaxe makesec -v -u makesec [-verify] nom_fichier Description La commande makesec permet de compiler et d installer le fichier spécifié comme fichier de sécurité opérationnel (../racine_tws/security). Si vous ajoutez l argument -verify, le programme vérifie la syntaxe du fichier sans le compiler ou l installer. Arguments -v Affiche uniquement les informations sur la version de la commande. -u Affiche uniquement les informations sur l utilisation de la commande. -verify Vérifie la syntaxe des définitions d utilisateur du fichier nom_fichier uniquement. Par ailleurs, le programme n installe pas le fichier au titre de fichier de sécurité. Il vérifie automatiquement la syntaxe du fichier de sécurité lors de son installation. nom_fichier Précisez le nom d un ou de plusieurs fichiers renfermant les définitions d utilisateur. Si nécessaire, vous pouvez préciser le masque d extension des noms de fichier. Exemples La commande suivante permet d afficher la version de la commande : makesec -v La commande suivante permet de créer une copie modifiable du fichier de sécurité opérationnel dans un fichier appelé tempsec, de modifier les définitions d utilisateur dans un éditeur de texte, de compiler le fichier tempsec et de remplacer le fichier de sécurité opérationnel : dumpsec > tempsec edit tempsec Chapitre 10. Configuration des définitions de sécurité utilisateur 341

366 Dans ce cas, vous devez modifier le fichier tempsec. Si vous avez fini de modifier le fichier tempsec, exécutez la commande makesec pour charger le fichier de sécurité dans IBM Tivoli Workload Scheduler : makesec tempsec La commande suivante permet de compiler les définitions d utilisateur du groupe de fichiers userdef* et de remplacer le fichier de sécurité opérationnel : makesec userdef* 342 IBM Tivoli Workload Scheduler - Guide de référence

367 Annexe A. Informations sur le support La présente section décrit les options ci-après, qui permettent d obtenir de l aide pour tout incident lié aux produits IBM : v «Recherche d un incident dans les bases de connaissances» v «Recherche de correctifs», à la page 344 v «Service de support logiciel IBM», à la page 345 Recherche d un incident dans les bases de connaissances Pour résoudre rapidement un incident lié à un logiciel IBM, commencez par vérifier si ledit incident a déjà été documenté dans les bases de connaissances disponibles. Recherche dans le centre d information à partir de votre système local ou du réseau IBM propose un grand nombre de documentations produit, que vous pouvez installer sur votre ordinateur ou sur un serveur Intranet. Chaque documentation apparaît sur le CD correspondant, fourni avec le produit, que vous pouvez télécharger à partir du site IBM (voir «Accès aux publications en ligne», à la page xviii) ou commander en version papier auprès d IBM (voir «Commande de publications», à la page xix). Ouvrez les documents en version PDF et cherchez les informations que vous souhaitez à l aide des fonctions de recherche intégrées. Recherche dans l Information Center du site Web de support IBM La plupart des documents du site Web de support IBM sont accessibles en ligne et contiennent de nombreuses informations utiles à la résolution d incidents : 1. Accédez au site Web de support logiciel IBM ( 2. Sous Products A - Z, sélectionnez le nom du produit ( I pour IBM), puis les entrées de produit commençant par IBM Tivoli Workload Scheduler. Vous accédez alors aux sites de support spécifiques aux produits. 3. Sous Self help et Learn, sélectionnez dans la liste les différents types de documentation du support produit : v v Manuels Redbooks v Livres blancs v Fichiers Readme et autres documentations L accès à certains documents est limité aux seuls clients enregistrés (leurs titres sont alors accompagnés d une icône en forme de clé). Pour vous enregistrer, sélectionnez le document que vous souhaitez consulter et suivez la procédure. Sur le site, une foire aux questions détaille les avantages de l enregistrement. Copyright IBM Corp. 1999,

368 Recherche sur Internet Si l Information Center ne vous aide pas à résoudre votre problème, cherchez une solution sur Internet. Recherche de correctifs Un correctif est peut-être disponible pour résoudre l incident. Vous pouvez rechercher les correctifs s appliquant à votre produit IBM sur le site Web de support de ce dernier : 1. Accédez au site Web de support logiciel IBM ( 2. Sous Products A - Z, sélectionnez le nom du produit ( I pour IBM), puis les entrées de produit commençant par IBM Tivoli Workload Scheduler. Vous accédez alors aux sites de support spécifiques aux produits. 3. Sous Self help, sélectionnez le lien Search all Downloads, qui vous permet d obtenir une liste de correctifs, groupes de correctifs et autres mises à jour de service pour votre produit. 4. Cliquez sur le nom d un correctif pour lire sa description et éventuellement le télécharger. Pour recevoir un message électronique hebdomadaire détaillant les correctifs et les actualités concernant les produits IBM, procédez comme suit : 1. Sur la page de support du produit IBM, cliquez sur My support dans le cadre gauche. 2. Si vous êtes déjà enregistré, passez directement à l étape suivante. Sinon, cliquez sur le bouton Register dans le coin supérieur droit pour créer un ID utilisateur et un mot de passe personnels. 3. Enregistrez-vous au service My support. 4. Sur la page My support, sélectionnez l onglet Edit profile et cliquez sur Subscribe to . Choisissez une famille de produits, puis cochez les cases correspondant au type d informations qui vous intéressent. 5. Cliquez sur Update. 6. Si vous souhaitez recevoir par courrier électronique des informations sur d autres groupes de produits, répétez les étapes 4 et 5. Pour plus d informations sur les types de correctif, voir Software Support Handbook ( 344 IBM Tivoli Workload Scheduler - Guide de référence

369 Service de support logiciel IBM Le service de support logiciel IBM propose une assistance pour résoudre les incidents que vous pourriez rencontrer avec le produit. Avant de contacter le service de support logiciel IBM, vérifiez que votre entreprise dispose d un contrat actif de maintenance logiciel IBM et qu elle est autorisée à soumettre des incidents à IBM. Le type de ce contrat dépend du produit dont vous disposez : v Si vous possédez des logiciels IBM distribués (incluant notamment, mais de façon non limitative, les produits Tivoli, Lotus, Rational, DB2 et WebSphere tournant sur les systèmes d exploitation Windows et UNIX), vous pouvez rejoindre le programme Passport Advantage en suivant la méthode de votre choix : En ligne : Accédez à la page d accueil de Passport Advantage ( et cliquez sur S enregistrer. Par téléphone : Pour connaître le numéro de téléphone applicable à votre pays, consultez le site Web de support logiciel IBM à l adresse et cliquez sur le nom de la zone géographique appropriée. v Pour les logiciels IBM eserver (incluant notamment, mais de façon non limitative, les produits DB2 et WebSphere exécutés en environnements zseries, pseries et iseries), vous pouvez conclure un contrat de maintenance logicielle en vous adressant directement à un ingénieur commercial IBM ou à un partenaire commercial IBM. Pour plus d informations sur le support des produits eserver, accédez à la page Web du service de support technique IBM ( Si vous n êtes pas certain du type de contrat de maintenance logicielle requis, accédez à la page Web des contacts du guide de support logiciel IBM ( et cliquez sur votre région géographique pour obtenir le numéro de téléphone du service de support présent dans votre région. Au Canada, composez le IBMSERV ( ). Pour contacter le service de support logiciel IBM, procédez comme suit : 1. Déterminez l impact de l incident sur vos activités. 2. Décrivez l incident et collectez les informations pertinentes. 3. Soumettez l incident au service de support logiciel IBM. Détermination de l impact de l incident sur vos activités Lorsque vous signalez un incident à IBM, il vous est demandé d indiquer son niveau de gravité. Par conséquent, vous devez comprendre et évaluer l impact de l incident sur vos activités. Utilisez pour cela les critères suivants : Gravité 1 Impact critique : vous ne pouvez pas utiliser le programme, ce qui a des conséquences graves sur le déroulement des opérations. Cette situation nécessite une solution immédiate. Gravité 2 Impact significatif : le programme est utilisable mais son utilisation est très limitée. Annexe A. Informations sur le support 345

370 Gravité 3 Impact relatif : le programme est utilisable mais certaines fonctions, non préjudiciables au déroulement des opérations, ne sont pas disponibles. Gravité 4 Impact minime : l incident a peu d impact sur le déroulement de vos opérations, ou une solution satisfaisante a été mise en oeuvre. Description de l incident et collecte des informations pertinentes Lorsque vous décrivez un incident à IBM, soyez le plus précis possible. Incluez toutes les informations possibles afin que les spécialistes du support logiciel IBM puissent vous aider à résoudre efficacement l incident. Pour gagner du temps, préparez les réponses aux questions suivantes : v Quelles versions des logiciels étaient exécutées lorsque l incident s est produit? v Existe-t-il des journaux, des traces et des messages liés aux symptômes de l incident? Vous serez peut-être invité par le service de support logiciel IBM à fournir ces informations. v Est-il possible de recréer l incident? Si oui, quelles étapes sont à l origine de l incident? v Des modifications ont-elles été apportées au système (par exemple, au matériel, au système d exploitation, au logiciel de réseau)? v Disposez-vous actuellement d une solution? Si oui, expliquez-la lorsque vous relatez l incident. Soumission d un incident au service de support logiciel IBM Pour soumettre l incident, vous pouvez utiliser l une des deux méthodes suivantes : v En ligne : Cliquez sur la page Submit and track problems sur le site Web de support logiciel IBM ( Entrez les informations requises dans l outil de soumission d incident. v Par téléphone : Pour connaître le numéro de téléphone applicable à votre pays, consultez la page Contacts du document IBM Software Support Handbook ( et cliquez sur le nom de la zone géographique appropriée. Si l incident concerne un défaut logiciel ou la documentation fournie, le service de support logiciel IBM crée un rapport officiel d analyse de programme (APAR). Ce rapport détaille l incident. Dans la mesure du possible, le service de support logiciel IBM indique une solution à mettre en oeuvre en attendant que l APAR soit résolu et qu un correctif soit disponible. IBM publie quotidiennement les APAR résolus sur le site Web de support logiciel IBM, afin que les utilisateurs ayant le même problème puissent bénéficier des mêmes résolutions. Pour plus d informations sur la résolution des incidents, voir Recherche d un incident dans les bases de connaissances et Recherche de correctifs. 346 IBM Tivoli Workload Scheduler - Guide de référence

371 Annexe B. Gestion des fuseaux horaires IBM Tivoli Workload Scheduler prend en charge plusieurs fuseaux horaires. Si vous les activez, vous pouvez gérer la charge de travail au niveau global. En outre, ils permettent de planifier facilement vos activités sur différents fuseaux horaires et de traiter les travaux devant être exécutés en zone morte. La zone morte représente la période entre l heure de début d une journée IBM Tivoli Workload Scheduler sur le gestionnaire de domaine maître et l heure d un agent à tolérance de pannes dans un autre fuseau horaire. Si un domaine maître de la côte Est des Etats-Unis dont l heure de début de journée IBM Tivoli Workload Scheduler correspond à 06:00 initialise un agent de la côte Ouest caractérisé par un décalage horaire de 3 heures, la zone morte de l agent à tolérance de pannes sera comprise entre 03:00 et 06:00. Dans les versions antérieures, le programme devait réaliser un traitement spécial pour exécuter les travaux couverts par cette période. Désormais, IBM Tivoli Workload Scheduler les exécute exactement au moment où vous l attendez car il suffit d activer la fonction Fuseau horaire pour définir un fuseau horaire comprenant une heure de début sur un travail ou un flux de travaux. La figure 8 illustre l heure de début de journée IBM Tivoli Workload Scheduler (à savoir 06:00) d un domaine maître de la côte Est des Etats-Unis et un agent de la côte Ouest caractérisé par un décalage horaire de 3 heures. Figure 8. Zones mortes Activation de la fonction Fuseau horaire Pour activer la fonction Fuseau horaire sur IBM Tivoli Workload Scheduler, procédez comme suit : 1. Dans le fichier RACINE_TWS/mozart/globalopts du gestionnaire de domaine maître, définissez l option Timezone enable sur yes. Par défaut, la valeur est no (fuseau horaire désactivé). 2. Affectez un fuseau horaire spécifique à chaque poste de travail du réseau IBM Tivoli Workload Scheduler en modifiant ses propriétés via le composant Job Scheduling Console. Copyright IBM Corp. 1999,

372 Si vous n affectez pas de fuseau horaire à un poste de travail, celui-ci utilisera le fuseau horaire du gestionnaire de domaine maître. Pour savoir comment activer la fonction Fuseau horaire, voir IBM Tivoli Workload Scheduler - Guide de planification et d installation. Exécution d un flux de travaux sans fuseau horaire activé alors que le gestionnaire de domaine maître avance par rapport à l agent à tolérance de pannes La présente section décrit l instruction de définition du flux de travaux, qui permet d exécuter un flux de travaux tous les matins sur un agent à tolérance de pannes, réglé sur l heure du Pacifique et connecté à un gestionnaire de domaine maître qui, lui, est réglé sur l heure de la côte Est (heure de début de journée définie sur 06:00), si vous n avez pas activé la fonction Fuseau horaire. Pour lancer le flux de travaux tous les matins, vous devez planifier son exécution entre le dimanche et le jeudi, en précisant les mots clés carryforward et at comme suit : Schedule FTA# PST_SCHEDULE1 On SU, weekdays except FR CARRYFORWARD AT job1 job2 END Si vous omettez le mot clé carryforward, le programme n exécutera jamais le travail car l agent à tolérance de pannes sera initialisé tous les jours à 03:00. Exécution d un flux de travaux avec fuseau horaire activé alors que le gestionnaire de domaine maître avance par rapport à l agent à tolérance de pannes La présente section décrit l instruction de définition du flux de travaux, qui permet d exécuter un flux de travaux tous les matins sur un agent à tolérance de pannes, réglé sur l heure du Pacifique, connecté à un gestionnaire de domaine maître réglé sur l heure de la côte Est (heure de début de journée définie sur 06:00) si vous avez activé la fonction Fuseau horaire. Pour exécuter le flux de travaux tous les matins, vous devez planifier son exécution chaque jour de la semaine en précisant le mot clé at comme suit : Schedule FTA# PST_SCHEDULE2 On weekdays AT job1 job2 END Si le gestionnaire de domaine maître réglé sur la côte Est initialise à 03:00 l agent à tolérance de pannes réglé sur l heure du Pacifique, l agent lancera le flux de travaux le même jour à 03: IBM Tivoli Workload Scheduler - Guide de référence

373 Exécution d un flux de travaux sans fuseau horaire activé alors que le gestionnaire de domaine maître retarde par rapport à l agent à tolérance de pannes La présente section décrit l instruction de définition du flux de travaux, qui permet d exécuter un flux de travaux tous les matins sur un agent à tolérance de pannes, réglé sur l heure de la côte Est, connecté à un gestionnaire de domaine maître réglé sur l heure du Pacifique (heure de début de journée définie sur 06:00) si vous n avez pas activé la fonction Fuseau horaire. Pour exécuter le flux de travaux tous les matins, vous devez planifier son exécution entre le dimanche et le jeudi, en précisant le mot clé carryforward et en associant le paramètre +1DAY au mot clé at (voir instruction de définition de flux de travaux suivante) : Schedule FTA1#EST_SCHEDULE1 On SU, weekdays except FR AT DAY CARRYFORWARD.. job1 job2 END Vous devez absolument préciser le mot clé carryforward. Sinon, le programme ne sélectionnera pas le flux de travaux pour l ajouter au plan qui sera exécuté le jour suivant. Si vous ne précisez pas le paramètre +1DAY, le flux de travaux sera lancé immédiatement après avoir été initialisé par le gestionnaire maître de la côte Ouest à 09:00. Exécution d un flux de travaux avec fuseau horaire activé alors que le gestionnaire de domaine maître retarde par rapport à l agent à tolérance de pannes La présente section décrit l instruction de définition du flux de travaux, qui permet d exécuter un flux de travaux tous les matins sur un agent à tolérance de pannes, réglé sur l heure de la côte Est, connecté à un gestionnaire de domaine maître réglé sur l heure du Pacifique (heure de début de journée définie sur 06:00) si vous avez activé la fonction Fuseau horaire. Pour exécuter le flux de travaux tous les matins, rédigez l instruction de définition du flux de travaux suivante : Schedule FTA1#EST_SCHEDULE2 On SU, weekdays except FR AT job1 job2 END Une fois initialisé, à 09:00, l agent à tolérance de pannes de la côte Est exécute le flux de travaux le jour suivant à 08:00. Annexe B. Gestion des fuseaux horaires 349

374 Soumission d un flux de travaux ad hoc caractérisé par une dépendance at La présente section explique comment soumettre un flux de travaux ad hoc caractérisé par une dépendance at. Si vous avez défini un flux de travaux sans dépendance horaire et si vous souhaitez le soumettre en en précisant une, précisez la dépendance at en utilisant le programme Conman sur le gestionnaire de domaine maître. Par exemple, si vous avez défini le flux de travaux SCHED1 sans préciser de dépendance at : Schedule FTA1#SCHED1 on request.. job1 END Pour soumettre le flux de travaux SCHED1 en précisant une dépendance PST at, exécutez la commande Conman suivante sur le gestionnaire de domaine maître : sbs FTA1#SCHED1 ;at=0400 TZ PST Le gestionnaire de domaine maître convertit l heure de soumission (02:00, heure de la côte Est, par exemple) à celle du fuseau horaire de l heure du Pacifique (PST) que vous avez indiqué dans la commande. Ensuite, le gestionnaire de domaine maître compare la valeur associée au mot clé at : v Si la valeur de la dépendance at est postérieure ou identique à la valeur générée, l agenda est exécuté le même jour. v Si la valeur de la dépendance at est antérieure à la valeur générée, l agenda sera exécuté le jour suivant. Désormais, le gestionnaire de domaine maître convertit la date obtenue et l heure précisée dans la commande (04:00, heure du Pacifique) à celle du fuseau horaire défini sur le poste de travail FTA1, depuis le fuseau horaire de l heure du Pacifique PST que vous avez précisé dans la commande. Soumission d un flux de travaux caractérisé par une dépendance at survenant pendant l heure d été La présente section explique comment soumettre un flux de travaux caractérisé par une dépendance at survenant pendant l heure d été. Supposons un gestionnaire de domaine maître défini dans le fuseau horaire de l heure de l Europe centrale ECT (GMT+1:00). Nous sommes le 3 avril A cette date, le fuseau horaire ECT est déjà passé à l heure d été - soit GMT+2:00. Dans l exemple suivant, vous allez soumettre un flux de travaux comprenant une dépendance at associée au fuseau horaire PST (GMT-8:00) : Schedule MDM#SCHED1 AT 0230 TZ PST.. job1 job2 END 350 IBM Tivoli Workload Scheduler - Guide de référence

375 Dans la zone du fuseau horaire PST, on passe à l heure d été le 3 avril 2005 à 02:00. Par conséquent, il sera 03:00 et le fuseau horaire passera de GMT-8:00 à GMT-7:00. Le gestionnaire de domaine maître convertit la dépendance horaire AT 0230 TZ PST à l heure du fuseau horaire de l agent à tolérance de pannes sur lequel le flux de travaux doit être exécuté, qui représente, dans ce cas, le fuseau horaire du gestionnaire de domaine maître lui-même (ETC). Le programme convertit toutes les dépendances horaires comprises entre AT 0200 TZ PST et AT 0259 TZ PST à l heure du fuseau horaire ECT 1159, car toutes les minutes du fuseau horaire PST correspondent à une seule minute du fuseau horaire ECT. Hors de cette plage de dépendances horaires, toutes les dépendances sont converties selon les règles de conversion standard. Par exemple, les dépendances horaires du fuseau horaire AT 0300 TZ PST sont converties à l heure du fuseau horaire ECT 1200 ; de même, les dépendances horaires du fuseau horaire AT 0301 TZ PST sont converties à celles du fuseau horaire ECT 1201 et ainsi de suite. Annexe B. Gestion des fuseaux horaires 351

376 Liste des fuseaux horaires La présente section détaille et décrit les fuseaux horaires pris en charge. Nom Description Par rapport à GMT GMT Greenwich Mean Time GMT UTC Universal Coordinated Time GMT ECT European Central Time GMT+1:00 EET Eastern European Time GMT+2:00 ART (Arabic) Egypt Standard Time GMT+2:00 EAT Eastern African Time GMT+3:00 MET Middle East Time GMT+3:30 NET Near East Time GMT+4:00 PLT Pakistan Lahore Time GMT+5:00 IST India Standard Time GMT+5:30 BST Bangladesh Standard Time GMT+6:00 VST Vietnam Standard Time GMT+7:00 CTT China Taiwan Time GMT+8:00 JST Japan Standard Time GMT+9:00 ACT Australia Central Time GMT+9:30 AET Australia Eastern Time GMT+10:00 SST Solomon Standard Time GMT+11:00 NST New Zealand Standard Time GMT+12:00 MIT Midway Islands Time GMT-11:00 HST Hawaii Standard Time GMT-10:00 AST Alaska Standard Time GMT-9:00 PST Pacific Standard Time GMT-8:00 PNT Phoenix Standard Time GMT-7:00 MST Mountain Standard Time GMT-7:00 CST Central Standard Time GMT-6:00 EST Eastern Standard Time GMT-5:00 IET Indiana Eastern Standard Time GMT-5:00 PRT Puerto Rico and US Virgin Islands Time GMT-4:00 CNT Canada Newfoundland Time GMT-3:30 AGT Argentina Standard Time GMT-3:00 BET Brazil Eastern Time GMT-3:00 CAT Central African Time GMT-1: IBM Tivoli Workload Scheduler - Guide de référence

377 Annexe C. Fonction d audit Une option d audit est disponible pour assurer le suivi des modifications apportées à la base de données et au plan : v Pour la base de données, toutes les modifications utilisateur sont consignées. Cependant, la version antérieure aux modifications n est pas consignée. Si un objet est ouvert et enregistré, l action sera consignée, même si aucune modification n a été apportée. v Pour le plan, toutes les modifications utilisateur sont consignées. Les actions sont consignées, qu elles aboutissent ou non. Les journaux d audit sont créés dans les répertoires suivants : racine_tws/audit/plan racine_tws/audit/database Les fichiers d audit sont consignés sous la forme d un fichier texte à plat sur des machines individuelles du réseau IBM Tivoli Workload Scheduler. Les risques d erreur d audit sont réduits grâce au réseau et il est possible d écrire directement dans le journal. En règle générale, les formats de journaux sont identiques pour le plan et la base de données. Les journaux comportent un en-tête qui est identique pour tous les enregistrements, un ID action et une section de données qui diffère en fonction du type d action. Toutes les données sont conservées sous format texte et peuvent être utilisées dans un éditeur de texte tel que vi ou Bloc-notes. Remarque : Dans les commandes MODIFY, il existe deux entrées dans le journal pour les ressources, les calendriers, les paramètres et les invites. La commande MODIFY s affiche dans le journal de la même manière que les commandes DELETE et ADD. Activation de la fonction d audit L option d audit est activée par deux entrées dans le fichier globalopts : plan audit level = 0 1 database audit level = 0 1 La valeur 1 active l audit et la valeur 0 désactive l audit. La valeur par défaut d IBM Tivoli Workload Scheduler est 0, ou audit désactivé. Si ces options ne figurent pas dans le fichier globalopts, l audit est désactivé. L audit est désactivé par défaut lors de l installation du produit. Pour lancer l audit de la base de données, vous devez fermer IBM Tivoli Workload Scheduler complètement et utiliser la commande WMAEUTIL pour arrêter l instance du connecteur. Lorsque vous redémarrez IBM Tivoli Workload Scheduler ainsi que l instance du connecteur, le journal de suivi de la base de donnée se déclenche. L audit du plan prend effet lorsque Jnextday est exécuté. Copyright IBM Corp. 1999,

378 Format des journaux d audit Les formats de journaux d audit sont essentiellement identiques pour le plan et la base de données. Le journal comporte un en-tête, un ID action et des sections de données qui diffèrent selon le type d action. Les données sont sous un format texte lisible et chaque élément de données est séparé par une barre verticale ( ). Les entrées du fichier journal apparaîtront au format suivant : Type de journal Date GMT Heure GMT Date locale Heure locale Type d objet Type d action Nom du poste de travail ID utilisateur Utilisateur Tivoli Management Framework Nom d objet Données d action Les fichiers journaux contiennent les informations suivantes : Type de journal Affiche une valeur de huit caractères qui indique la source de l enregistrement du journal. Les types de journaux suivants sont pris en charge : HEADER L en-tête du fichier journal CONMAN Commande Conman FILEAID Commande permettant d ouvrir un fichier PLAN Action du plan STAGEMAN Exécution de stageman RELEASE Commande release DATABASE Action de la base de données PARMS Commande de paramètres MAKESEC Exécution de makesec DBEXPAND Exécution de dbexpand Date GMT Affiche la date GMT à laquelle l action a été exécutée. La date est sous la forme aaaammjj où aaaa désigne l année, mm le mois et jj le jour. Heure GMT Affiche l heure GMT à laquelle l action a été exécutée. L heure est sous la forme hhmmss où hh désigne les heures, mm les minutes et ss les secondes. Date locale Affiche la date locale à laquelle l action a été exécutée. La date locale est définie par l option relative au fuseau horaire du poste de travail. La date est sous la forme aaaammjj où aaaa désigne l année, mm le mois et jj le jour. 354 IBM Tivoli Workload Scheduler - Guide de référence

379 Heure locale Affiche l heure locale à laquelle l action a été exécutée. L heure locale est définie par l option relative au fuseau horaire du poste de travail. L heure est sous la forme hhmmss où hh désigne les heures, mm les minutes et ss les secondes. Type d objet Affiche le type d objet qui a été affecté par une action. Le type d objet est l un des suivants : DATABASE Définition de la base de données DBWKSTN Définition du poste de travail de la base de données DBWKCLS Définition des classes de postes de travail de la base de données DBDOMAIN Définition des domaines de la base de données DBUSER Définition des utilisateurs de la base de données DBJBSTRM Définition des flux de travaux de la base de données DBJOB Définition des travaux de la base de données DBCAL Définition des calendriers de la base de données DBPROMPT Définition des invites de la base de données DBPARM Définition des paramètres de la base de données DBRES Définition des ressources de la base de données DBSEC Sécurité de la base de données PLAN Plan PLWKSTN Poste de travail du plan PLDOMAIN Domaine du plan PLJBSTRM Flux de travaux du plan PLJOB Travail du plan PLPROMPT Invite du plan PLRES Ressource du plan Annexe C. Fonction d audit 355

380 Type PLFILE Fichier du plan d action Affiche quelle action a été prise contre l objet. Les valeurs adéquates pour cette zone dépendent de l action en cours. Pour la base de données, le type d action peut être ADD, DELETE, MODIFY, EXPAND ou INSTALL. IBM Tivoli Workload Scheduler enregistrera dans la base de données les actions ADD, DELETE et MODIFY pour le poste de travail, les classes de postes de travail, les domaines, les utilisateurs, les travaux, les flux de travaux, les calendriers, les invites, les ressources et paramètres. La zone Type d action enregistre également l installation d un nouveau fichier de sécurité. Lorsque makesec sera exécuté, IBM Tivoli Workload Scheduler l enregistrera comme une action INSTALL pour un objet de définition de sécurité. Lorsque dbexpand sera exécuté, il sera enregistré comme une action EXPAND pour un objet de base de données. Les actions LIST et DISPLAY ne sont pas consignées pour les objets. Pour fileaid, IBM Tivoli Workload Scheduler ne consignera que les commandes qui entraînent l ouverture d un fichier. Pour les paramètres, la ligne de commande contenant des arguments est consignée. Nom du poste de travail Affiche le poste de travail IBM Tivoli Workload Scheduler à partir duquel l utilisateur exécute l action. ID utilisateur Affiche l utilisateur connecté qui a exécuté une action donnée. Sur les plateformes Win32, il s agit du nom complet du domaine : domaine\utilisateur. Utilisateur Tivoli Management Framework Affiche l ID utilisateur reconnu par Tivoli. Il s agit de l ID de connexion de l utilisateur de Job Scheduling Console Nom de l objet Affiche le nom complet de l objet. Son format dépendra du type d objet désigné ci-après : DATABASE Non disponible DBWKSTN poste_travail DBWKCLS classe_postes_travail DBDOMAIN domaine DBUSER [poste_travail#]utilisateur DBJBSTRM poste_travail#flux_travaux DBJOB poste_travail#travail DBCAL calendrier 356 IBM Tivoli Workload Scheduler - Guide de référence

381 DBPROMPT invite DBPARM poste_travail#paramètre DBRES poste_travail#ressource DBSEC Non disponible PLAN Non disponible PLWKSTN poste_travail PLDOMAIN domaine PLJBSTRM poste_travail#instance_flux_travaux PLJOB En-tête du journal d audit poste_travail#instance_flux_travaux.travail PLPROMPT [poste_travail#]invite PLRES poste_travail#ressource PLFILE poste_travail#chemin(qualifiant) Données dépendantes d une action Affiche les zones de données relatives à une action donnée. Le format de ces données dépend de la zone Type d action. Chaque fichier journal démarrera par un enregistrement de l en-tête qui contient des informations sur la date à laquelle le journal a été crée et s il s agit du journal de la base de données ou du plan. Le contenu de l entrée du fichier d en-tête se présente comme suit : Type de journal HEADER Date GMT La date GMT à laquelle le fichier journal a été créé. Heure GMT L heure GMT à laquelle le fichier journal a été créé. Date locale La date locale à laquelle le fichier journal a été créé. Heure locale L heure locale à laquelle le fichier journal a été créé. Annexe C. Fonction d audit 357

382 Nom du poste de travail Le nom du poste de travail IBM Tivoli Workload Scheduler pour lequel ce fichier a été créé. Chaque poste de travail du réseau IBM Tivoli Workload Scheduler crée son propre journal. ID Type utilisateur L ID utilisateur IBM Tivoli Workload Scheduler qui a créé le fichier journal. d objet Lit DATABASE pour un fichier journal de base de données et PLAN pour un fichier journal de plan. Nom de l objet Non disponible Type d action Non disponible Données dépendantes d une action Affiche la version du fichier. Exemples d entrée du journal d audit Voici quelques exemples d entrée d un fichier journal : HEADER DATABASE GANGES RIVERS\pyasa 1.0 DATABASE DBWKSTN ADD GANGES RIVERS\pyasa JAMUNA DATABASE DBJOB MODIFY SINDHU RIVERS\tairak NARMADA#dubo 358 IBM Tivoli Workload Scheduler - Guide de référence

383 Remarques Le présent document peut contenir des informations ou des références concernant certains produits, logiciels ou services IBM non annoncés dans ce pays. Pour plus de détails, référez-vous aux documents d annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial IBM. Toute référence à un produit, logiciel ou service IBM n implique pas que seul ce produit, logiciel ou service puisse être utilisé. Tout autre élément fonctionnellement équivalent peut être utilisé, s il n enfreint aucun droit d IBM. Il est de la responsabilité de l utilisateur d évaluer et de vérifier lui-même les installations et applications réalisées avec des produits, logiciels ou services non expressément référencés par IBM. IBM peut détenir des brevets ou des demandes de brevets couvrant les produits mentionnés dans le présent document. La remise de ce document ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirez recevoir des informations concernant l acquisition de licences, veuillez en faire la demande par écrit à l adresse suivante : IBM EMEA Director of Licensing IBM Europe Middle-East Africa Tour Descartes Paris-La Défense Cedex 50 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 caractères double octet peuvent être obtenues par écrit à l adresse suivante : IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japon Le paragraphe suivant ne s applique ni au Royaume-Uni, ni dans aucun autre pays dans lequel il serait contraire aux lois locales : LE PRESENT DOCUMENT EST LIVRE EN L ETAT. 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 D ADAPTATION A VOS BESOINS. Certaines juridictions n autorisent pas l exclusion des garanties implicites ou explicites, auquel cas l exclusion ci-dessus ne vous sera pas applicable. Copyright IBM Corp. 1999,

384 Le présent document peut contenir des inexactitudes ou des coquilles. Il est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. IBM peut, à tout moment et sans préavis, améliorer ou modifier les produits et/ou logiciels décrits dans ce document. Les références à des sites Web non IBM sont fournies à titre d information uniquement et n impliquent en aucun cas une adhésion aux données qu ils contiennent. Les éléments figurant sur ces sites Web ne font pas partie des éléments du présent produit IBM et l utilisation de ces sites relève de votre seule responsabilité. IBM pourra utiliser ou diffuser, de toute manière qu elle jugera appropriée et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies. Les licenciés souhaitant obtenir des informations permettant : (i) l échange des données entre des logiciels créés de façon indépendante et d autres logiciels (dont celui-ci), et (ii) l utilisation mutuelle des données ainsi échangées, doivent adresser leur demande à : IBM Corporation 2Z4A/ Burnet Road Austin, TX Etats-Unis Ces informations peuvent être soumises à des conditions particulières, prévoyant notamment le paiement d une redevance. Le logiciel sous licence décrit dans ce document et tous les éléments sous licence disponibles s y rapportant sont fournis par IBM conformément aux dispositions de l ICA, des Conditions internationales d utilisation des logiciels IBM ou de tout autre accord équivalent. Les informations concernant des produits non IBM ont été obtenues auprès des fournisseurs de ces produits, par l intermédiaire d annonces publiques ou via d autres sources disponibles. IBM n a pas testé ces produits et ne peut confirmer l exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoir aucune réclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit être adressée aux fournisseurs de ces produits. Le présent document peut contenir des exemples de données et de rapports utilisés couramment dans l environnement professionnel. Ces exemples mentionnent des noms fictifs de personnes, de sociétés, de marques ou de produits à des fins illustratives ou explicatives uniquement. Toute ressemblance avec des noms de personnes, de sociétés ou des données réelles serait purement fortuite. 360 IBM Tivoli Workload Scheduler - Guide de référence

385 Marques IBM, le logo IBM, z/os, Tivoli et le logo Tivoli sont des marques d International 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 enregistrée de The Open Group aux Etats-Unis et/ou dans certains autres pays. D autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document. Remarques 361

386 362 IBM Tivoli Workload Scheduler - Guide de référence

387 Glossaire A agent à tolérance de pannes (FTA) : Dans le réseau Tivoli Workload Scheduler, poste de travail capable de résoudre des dépendances locales et de lancer ses travaux en l absence d un gestionnaire de domaine. agent étendu : Agent utilisé pour intégrer les fonctions de contrôle de travaux de Tivoli Workload Scheduler à d autres systèmes d exploitation (par exemple, MVS) et applications (par exemple, Oracle Applications, Peoplesoft et Baan). Les agents étendus utilisent des scripts appelés méthodes d accès pour communiquer avec les systèmes externes. agent réseau : Type d agent étendu servant à créer des dépendances entre les travaux et flux de travaux des différents réseaux Tivoli Workload Scheduler. Voir aussi dépendance interréseau (INET). B base de données : Base regroupant l ensemble des définitions créées pour des objets de planification tels que les travaux, les flux de travaux, les ressources, les postes de travail, etc. Une base de données contient également des informations importantes telles que les statistiques relatives à l exécution des travaux et des flux de travaux, des informations sur l ID utilisateur qui a créé un objet et la date de dernière modification d un objet. Le plan, en revanche, ne contient que les travaux et les flux de travaux (y compris les objets dépendants) dont l exécution est prévue dans la production du jour. base de données étendue : Base autorisant les noms longs pour les objets de base de données tels que les travaux, les flux de travaux, les postes de travail, les domaines et les utilisateurs. Les bases de données étendues sont configurées à l aide de la commande dbexpand ou d une option définie lors de l installation. N étendez pas votre base de données tant que vous n avez pas compris les implications et les incidences de cette commande. batchman : Processus exécuté au début de chaque jour de traitement de Tivoli Workload Scheduler pour lancer des travaux conformément aux informations du fichier Symphony. C calendrier : Objet défini dans la base de données Tivoli Workload Scheduler qui contient une liste de dates de planification. S agissant d un objet unique défini dans la base de données, il peut être affecté à de multiples flux de travaux. L affectation d un calendrier à un flux de travaux permet d exécuter ce dernier aux dates indiquées dans le calendrier. Notez qu un calendrier peut être utilisé comme cycle d exécution inclusif ou exclusif. caractères génériques : Caractères génériques acceptés pour Tivoli Workload Scheduler :? Remplace un caractère alphanumérique. % Remplace un caractère numérique. * Remplace zéro ou plusieurs caractères alphanumériques dans Tivoli Job Scheduling Remplace zéro ou plusieurs caractères alphanumériques dans la ligne de commande Tivoli Workload Scheduler. Les caractères génériques sont généralement utilisés pour affiner la recherche d un ou de plusieurs objets de la base de données. Par exemple, pour afficher tous les postes de travail, vous pouvez entrer le caractère générique * (astérisque). Pour obtenir la liste de tous les postes de travail site1 à site8, vous pouvez entrer site%. classe de postes de travail : Groupe de postes de travail. Une classe peut contenir n importe quel nombre de postes de travail. Des flux de travaux et des travaux peuvent être affectés à des fins d exécution dans une classe de postes de travail afin de faciliter la réplication d un travail ou d un flux de travaux sur plusieurs postes de travail. Composer : Application en mode ligne de commande permettant de gérer des définitions d objets de planification dans la base de données. Conman (ou gestionnaire de console) : Application en mode ligne de commande permettant de gérer l environnement de production et notamment d effectuer les tâches suivantes : lancer et arrêter des processus de production, modifier et afficher des agendas et des travaux du plan et contrôler la connexion des postes de travail dans un réseau. cycle d exécution : Cycle d exécution indiquant les jours pendant lesquels un flux de travaux doit être exécuté. Dans Tivoli Workload Scheduler, vous pouvez indiquer l un des trois types de cycle d exécution suivants pour un flux de travaux : cycle d exécution simple, cycle d exécution hebdomadaire ou cycle d exécution basé sur un calendrier (couramment appelé cycle calendrier ). Chaque type de cycle d exécution peut être inclusif ou exclusif. En d autres termes, Copyright IBM Corp. 1999,

388 chaque cycle d exécution peut définir des jours pour lesquels un flux de travaux est inclus dans le cycle de production ou ceux pour lesquels un flux de travaux est exclu du cycle de production. Lorsque vous définissez plusieurs cycles d exécution pour un flux de travaux et que des cycles d exécution inclusifs et exclusifs indiquent les mêmes jours, les cycles d exécution exclusifs sont prioritaires. cycle d exécution exclusif : Cycle d exécution précisant les jours pendant lesquels un flux de travaux ne peut pas être exécuté. Les cycles d exécution exclusifs sont prioritaires par rapport aux cycles d exécution inclusifs. cycle d exécution hebdomadaire : Cycle d exécution précisant les jours de la semaine pendant lesquels un flux de travaux doit être exécuté. Par exemple, en faisant appel à ce cycle, vous pouvez demander que l exécution ait lieu chaque lundi, mercredi et vendredi. Un cycle d exécution hebdomadaire est défini pour un flux de travaux spécifique et ne peut pas être utilisé par plusieurs flux de travaux. Pour plus d informations, voir cycle d exécution. cycle d exécution inclusif : Cycle d exécution précisant les jours d exécution d un flux de travaux. Les cycles d exécution exclusifs sont prioritaires par rapport aux cycles d exécution inclusifs. cycle d exécution simple : Ensemble de jours définis par l utilisateur, au cours duquel un flux de travaux est exécuté. Un cycle d exécution simple est défini pour un flux de travaux spécifique et ne peut pas être utilisé par plusieurs flux de travaux. Pour plus d informations, voir cycle d exécution. D dépendance : Condition préalable à l exécution d un travail ou d un flux de travaux. Le nombre maximal de dépendances admis pour un travail ou un flux de travaux est de 40. Les quatre types de dépendances utilisées par Tivoli Workload Scheduler sont les dépendances prédécesseur/successeur, les dépendances par rapport à une ressource, les dépendances par rapport à un fichier et les dépendances par rapport à une invite. dépendance interréseau (INET) : Dépendance entre les travaux ou flux de travaux des différents réseaux Tivoli Workload Scheduler. Voir aussi agent réseau. dépendances prédécesseur/successeur : Dépendance indiquant que l exécution d un travail ou d un flux de travaux ne peut pas commencer tant que l exécution d autres travaux ou flux de travaux n est pas terminée. domaine : Groupe nommé de postes de travail Tivoli Workload Scheduler constitué d un ou de plusieurs postes de travail et d un gestionnaire de domaine utilisé comme concentrateur de gestion. Les domaines ont tous un domaine parent excepté le domaine maître. durée : Période de temps prévue pour effectuer un travail. Dans la vue Diagramme des travaux de la base de données, la durée est représentée par une barre bleu clair située au milieu de la barre d activité ou par un losange bleu clair. E échéance : Heure au-delà de laquelle un travail ou flux de travaux ne peut plus être exécuté. Correspond à l option Until de Maestro. F fichier stdlist : Fichier de liste standard créé pour chaque travail lancé par Tivoli Workload Scheduler. Les fichiers de liste standard contiennent des bannières d en-tête et de fin, des commandes echo, ainsi que des erreurs et des avertissements. Ces fichiers peuvent être utilisés pour résoudre les incidents d exécution de travaux. fichier Symphony : Fichier contenant les informations de planification requises par le processus de contrôle de production (batchman) pour l exécution du plan. Le fichier est généré et chargé lors de la phase de préproduction. Lors de la phase de production, il est mis à jour en continu pour indiquer le statut en cours du processus de production : travaux terminés, travaux en cours, travaux restant à effectuer. Afin de gérer le traitement de la production, le contenu du fichier Symphony (plan) peut être affiché et modifié à l aide de Job Scheduling Console. flux de travaux : Flux constitué par une liste de travaux exécutés comme une unité (application de sauvegarde hebdomadaire, par exemple) et englobant également les heures, les priorités et toute autre dépendance déterminant l ordre d exécution des travaux. flux de travaux FINAL : Dernier flux de travaux exécuté au cours d une journée de production. Il contient un travail qui exécute le fichier script Jnextday. G gestionnaire de domaine : Concentrateur de gestion dans un domaine Tivoli Workload Scheduler. Toutes les communications à destination et en provenance des agents du domaine sont acheminées via le gestionnaire de domaine. gestionnaire de domaine maître : Dans un réseau Tivoli Workload Scheduler, gestionnaire permettant de gérer les fichiers servant à documenter les objets de planification. Il crée le plan en début de journée et 364 IBM Tivoli Workload Scheduler - Guide de référence

389 effectue l ensemble des opérations de journalisation et de présentation pour le réseau. H heure de début au plus tôt : Heure avant laquelle le travail ou le flux de travaux ne peut pas être lancé. L heure de début au plus tôt correspond à une estimation, déterminée en fonction de l expérience antérieure dans l exécution du travail ou du flux de travaux. Le travail ou le flux de travaux peut toutefois être lancé après l heure définie à partir du moment ou toutes les autres dépendances sont respectées. Dans le diagramme, l heure de début est représentée par le début (bord gauche) de la barre d activité bleu marine. Pour les instances de travail, l heure de début calculée par OPC est représentée par une barre bleu clair. Voir aussi heure de début réelle et heure de début prévue. heure de début prévue : Heure à laquelle Tivoli Workload Scheduler estime qu une instance de travail débutera. Cette estimation est fondée sur l heure de début d exécutions précédentes. hôte : Poste de travail Workload Scheduler requis par les agents étendus. Il peut s agir de n importe quel poste de travail Tivoli Workload Scheduler, à l exception d un autre agent étendu. I instance de flux de travaux : Flux de travaux planifié à une date d exécution spécifique du plan. Voir aussi flux de travaux. instance de travail : Travail planifié pour une date d exécution spécifique du plan. Voir aussi travail. invite : Invites pouvant servir de dépendances pour les travaux et les flux de travaux. Une réponse affirmative doit être donnée à une invite pour que le travail ou le flux de travaux dépendant soit lancé. Il existe deux types d invite : prédéfinie et ad hoc. Une invite ad hoc est définie dans les propriétés d un travail ou d un flux de travaux ; elle est propre à ce travail ou à ce flux de travaux. Une invite prédéfinie est définie dans la base de données de Tivoli Workload Scheduler et peut être utilisée par n importe quel travail ou flux de travaux. L limite : Limite d un travail permettant d allouer un nombre spécifique de travaux que Tivoli Workload Scheduler est autorisé à lancer. Une limite de travail peut être définie pour chaque flux de travaux et pour chaque poste de travail. Par exemple, avec une limite de 25, Tivoli Workload Scheduler peut exécuter simultanément un maximum de 25 travaux sur un poste de travail. liste : Liste affichant les objets de planification des travaux. Vous devez créer des listes distinctes pour chaque objet de planification des travaux. Pour chacun de ces objets, il existe deux types de liste : une liste de définitions dans la base de données et une liste d instances dans le plan. M méthode d accès : Exécutable utilisé par les agents étendus pour connecter et contrôler l exécution des travaux sur d autres systèmes d exploitation (par exemple, MVS) et applications (par exemple, Oracle Applications, Peoplesoft et Baan). La méthode d accès doit être indiquée dans la définition de poste de travail de l agent étendu. O options globales : Options globales définies sur le gestionnaire de domaine maître dans le fichier globalopts et s appliquant à tous les postes de travail du réseau Tivoli Workload Scheduler. Voir aussi options locales. options locales : Options locales définies dans le fichier localopts. Chaque poste de travail du réseau Tivoli Workload Scheduler doit comprendre un fichier localopts. Les paramètres de ce fichier s appliquent uniquement à ce poste de travail. Voir aussi options globales. P paramètre : Paramètres utilisés pour remplacer les valeurs de vos travaux et flux de travaux. Lorsqu un paramètre est utilisé dans un script de travail, la valeur est remplacée au moment de l exécution. Dans ce cas, le paramètre doit être défini sur le poste de travail où il sera utilisé. Les paramètres ne peuvent pas être utilisés lors du traitement de script des travaux de l agent étendu. plan : Plan contenant l ensemble des activités de planification des travaux prévue pour une journée. Dans Tivoli Workload Scheduler, le plan est créé toutes les 24 heures et est constitué de tous les travaux, flux de travaux et objets de dépendance dont l exécution est planifiée pour cette journée. Tous les flux de travaux pour lesquels vous avez créé des cycles d exécution sont automatiquement planifiés et intégrés au plan. Tout au long du cycle de production, les travaux et les flux de travaux du plan sont exécutés en fonction de leurs restrictions temporelles et d autres dépendances. Tout travail ou flux de travaux dont l exécution a échoué est intégré au plan des jours suivants. Glossaire 365

390 poste de travail : En général, ordinateur individuel sur lequel sont exécutés les travaux et flux de travaux. Il est défini dans la base de données Tivoli Workload Scheduler sous forme d objet unique. Une définition de poste de travail est requise pour chaque ordinateur qui exécute des travaux ou des flux de travaux dans le réseau Workload Scheduler. prédécesseur : Travail devant aboutir pour que l exécution des travaux successeurs puisse commencer. priorité : Tivoli Workload Scheduler possède un système de file d attente pour les travaux et les flux de travaux du plan. Vous pouvez affecter à chaque travail ou flux de travaux un niveau de priorité de 0 à 101. Un travail possédant une priorité de 0 ne sera pas exécuté. priorité limite : Priorité limite d un travail permettant de contrôler son exécution sur un poste de travail. Elle correspond à un niveau de priorité que la priorité d un travail ou d un flux de travaux doit dépasser pour pouvoir s exécuter. Une priorité limite de 40, par exemple, empêche le lancement des travaux dont la priorité est inférieure ou égale à 40. R ressource : Ressource physique ou logique de votre système. Une fois définie dans la base de données Tivoli Workload Scheduler, elle peut servir de dépendance pour les travaux et les flux de travaux. Par exemple, vous pouvez définir une ressource appelée bandes avec une valeur d unité égale à deux. Ensuite, définissez des travaux qui requièrent deux unités de bande disponibles comme dépendance. Les travaux liés à cette dépendance ne peuvent pas s exécuter en même temps, car chaque fois qu un travail est exécuté, la ressource bandes est utilisée. restrictions temporelles : Restrictions temporelles pouvant être appliquées à la fois pour les travaux et les flux de travaux. Vous pouvez définir l heure de début d une exécution ou l heure après laquelle l exécution ne peut plus avoir lieu. En indiquant ces deux heures, vous pouvez définir une fenêtre dans laquelle un travail ou un flux de travaux est exécuté. Pour les travaux, vous pouvez aussi indiquer un taux de répétition. Par exemple, vous pouvez configurer Tivoli Workload Scheduler de sorte que le même travail soit lancé toutes les 30 minutes entre 8 heures 30 et 13 heures 30. S statut : Etat en cours du travail ou du flux de travaux de Job Scheduling Console. Le statut de Job Scheduling Console est commun à Tivoli Workload Scheduler et à OPC. Voir aussi statut interne. statut du travail : Voir statut. statut interne : Statut en cours des travaux et flux de travaux dans le moteur Tivoli Workload Scheduler. Le statut interne est unique pour Tivoli Workload Scheduler. Voir aussi statut. successeur : Travail qui ne peut être lancé que si tous les travaux prédécesseurs dont il dépend sont terminés. T Tivoli Management Framework (TMF) : Logiciel de base requis pour exécuter les applications de l ensemble de produits Tivoli. L infrastructure du logiciel permet d intégrer des applications de gestion Tivoli Systems et Tivoli Partners. Tivoli Management Framework inclut les éléments suivants : v Répartiteur de requêtes d objets (oserv) v Base de données d objets répartie v Fonctions d administration de base v Services d applications de base v Services de bureau de base tels que l interface utilisateur graphique Dans un environnement Tivoli, Tivoli Management Framework est installé sur chaque client et sur chaque serveur. Toutefois, le serveur TMR est le seul serveur qui contient la base de données d objets complète. Tivoli Management Region (TMR) : Dans un environnement Tivoli, serveur Tivoli et ensemble des clients qu il sert. Une entreprise peut disposer de plusieurs TMR. Une TMR détermine la connectivité physique des ressources alors qu une région d administration détermine leur organisation logique. travail : Unité de travail traitée sur un poste de travail. Une définition du travail est constituée d un nom de travail unique dans la base de données Tivoli Workload Scheduler, ainsi que d autres informations nécessaires à l exécution du travail. Lorsque vous ajoutez un travail à un flux de travaux, vous pouvez définir ses dépendances et ses restrictions temporelles telles que l heure de début prévue et l échéance. travail externe : Travail d un flux de travaux donné, prédécesseur d un travail d un autre flux de travaux. Un travail externe est représenté par une icône de réserve dans la vue Graphe du flux de travaux. travail/flux de travaux interréseau (INET) : Travail ou flux de travaux d un réseau Tivoli Workload Scheduler distant, correspondant au prédécesseur d un travail ou d un flux de travaux du réseau local. Un travail interréseau est représenté par une icône de réserve dans la vue Graphe du flux de travaux. Voir aussi agent réseau. travail interactif : Travail exécuté de manière interactive sur un bureau Windows NT. 366 IBM Tivoli Workload Scheduler - Guide de référence

391 travail Jnextday : Travail qui, lorsqu il est planifié en fin de journée, permet d automatiser totalement le traitement en pré et postproduction. Un exemple de travail jnextday est fourni dans racine_tws\jnextday. Le travail Jnextday effectue les opérations suivantes : il configure le traitement du jour suivant (contenu dans le fichier Symphony) ; il imprime des états, reporte des flux de travaux non terminés, arrête et relance Tivoli Workload Scheduler. U utilisateur : Pour Windows NT uniquement, nom utilisateur indiqué dans la zone de connexion d une définition de travail et intégrant la définition d utilisateur correspondante. Les définitions fournissent les mots de passe utilisateur requis par Tivoli Workload Scheduler pour lancer des travaux. utilitaires : Ensemble d exécutables de ligne de commande permettant de gérer Tivoli Workload Scheduler. V vue Arborescence : Vue située dans la partie gauche de Job Scheduling Console et dans laquelle s affichent le serveur Tivoli Workload Scheduler, les groupes de listes par défaut et les groupes de listes créées par l utilisateur. X X-agent : Voir agent étendu. Glossaire 367

392 368 IBM Tivoli Workload Scheduler - Guide de référence

393 Index A absolute, mot clé 137, 143, 144, 149 activation de l audit 353 adddep job, commande 151 adddep sched, commande 153 agent étendu définition de poste de travail 303 présentation 303 référence 303 agent réseau exemple de commande de poste de travail 315 ficher d options 316 interréseau, dépendance 316 netmth 313 poste de travail 313 présentation 313 altpass, commande 155 altpri, commande 156 arborescence des processus sur UNIX 11 arborescence des processus sur Windows 13 arrêt des processus du planificateur 18, 221 at, commande 238 at, mot clé 17, 93 audit activation 353 exemples d entrée du journal 358 fichiers journaux 353 format de journal 354 format de l en-tête 357 B bases de connaissances, recherche de solutions 343 batch, commande 238 batchman 11 behindfirewall 39 bibliothèque xiv C cancel job, commande 158 cancel sched, commande 159 caractères de commande 63 caractères de commande, conman 129 caractères génériques 65, 132 caractères spéciaux, Composer 65 caractères spéciaux, Conman 132 carryforward, mot clé 17, 96 caxtract, commande 243 centralisée, sécurité 323 centres d information, recherche de solutions 343 classe de postes de travail, définition 43 commande de publications xix commandes add 68 commandes (suite) adddep job 151 adddep sched 153 altpass 155 altpri 156 build 69 cancel job 157 cancel sched 159 commande système 231 compiler 10 confirm 161 console 163 continue 70, 164 create 71 deldep job 165 deldep sched 167 delete 73 display 75, 169 dumpsec 324, 340 edit 79 exit 80, 170 fence 171 help 173 kill 174 limit cpu 175 limit sched 176 link 177 list 75 listsym 179 logman 10 makesec 324, 341 modify 81 new 83 print 75 recall 180 redo 84, 181 release job 183 release sched 185 rep1 291 rep rep2 291 rep3 291 rep4a 291 rep4b 291 rep7 292 rep8 293 replace 86 reply 187 reptr 296 rerun 188 resource 191 schedulr 10 setsym 192 showcpus 193 showdomain 197 showfiles 198 showjobs 200 showprompts 208 showresources 210 showschedules 212 shutdown 215 commandes (suite) stageman 10 start 216 status 218 stop 219 stop ;progressive 221 submit docommand 222 submit file 224 submit job 226 submit sched 228 switchmgr 230 tellop 232 unlink 233 validate 88 version 89, 235 xref 298 commandes d utilitaire 237 commandes non prises en charge 287 commandes système, conman 129 commentaires sur les publications xix comments, mot clé 97 communication SSL enabled 39 force 39 on 39 compiler, commande 10 Composer 10 Composer, caractères de commande 63 Composer, éditeur 64 Composer, programme 63 Composer, référence 35 condition de succès 49, 110 confirm, commande 161 confirmed, mot clé 98 Conman 10 Conman, exécution 129 Conman, invite de commande 131 Conman, liste des commandes 133 Conman, référence 129 Conman, syntaxe des commandes 131 connecteur 325 console, commande 163 contact par courrier électronique xix continue, commande 164 conventions type de caractère xx correctifs, recherche 344 correctifs APAR IY IY IY IY IY , 132, 333 IY , 206 IY IY IY IY , 341 IY IY IY Copyright IBM Corp. 1999,

394 correctifs APAR (suite) IY cpuinfo, commande 245 cpuname 37 création d une dépendance interréseau 317 création du fichier de sécurité 324 cycle de production 9 automatisation 15 D datecalc, commande 246 dbexpand, commande 250 deadline, mot clé 99 définition d invite 60 définition d utilisateur 54 définition de calendrier 57 définition de domaine 45 définition de paramètre 58 définition de poste de travail 37 définition de travail 47 définition des ressources 62 définitions d utilisateur, sécurité 324 deldep, commande 165 deldep sched, commande 167 delete, commande 252 délimiteurs 65 délimiteurs, Conman 132 dépendance fichier 140, 147, 198 interréseau 313, 317 dernière heure de début 17 description des commandes de Composer 66 display, commande 169 dumpsec, commande 10, 324, 340 E échéance 17 éditeur, objet de base de données 64 end, mot clé 100 entrées de base de données 35 état retard 99 états des travaux 141 every, mot clé 101 evtsize, commande 254 except, mot clé 102 exécution de Composer 63 exécution de Conman 129 exemple de fichier de sécurité 336 exemples d entrée du journal, audit 358 exit, commande 170 F fence, commande 171 fichier, dépendance 140, 147, 198 fichier de sécurité mise à jour 324 fichier globalopts fonction d audit 353 fichier modèle, sécurité 324 flux de travaux final ajout 16 personnalisation 15 follows, mot clé 105 formation Voir Tivoli, formation technique xix freedays, mot clé 106 fuseau horaire 136 G gestion de la sécurité 324 gestion des fuseaux horaires 347 H help, commande 173 heure de début 17 heure de début, dernière 17 I identification des incidents description de l incident au service de support logiciel IBM 346 détermination de l impact de l incident pour le service de support logiciel IBM 345 soumission de l incident au service de support logiciel IBM 346 incidents interfaces utilisateur 10 Internet, recherche de solutions 344 interréseau, dépendance 313, 316 invite de commande 65 invite de commande, Conman 131 invites utilisateur 130 J jbxtract, commande 255 Jnextday exécution 16 job launch 11 Job Scheduling Console 10 job statement, mot clé 108 jobinfo, commande 257 jobman 11 jobmanrc 19 jobmon 11 jobstdl, commande 259 K keyjob, mot clé 114 keysched, mot clé 115 kill, commande 174 killproc, commande 287 L langage de planification 91 limit, mot clé 116 limit cpu, commande 175 limit sched, commande 176 link, commande 177 listproc, commande 287 listsym, commande 179 locale, sécurité 323 logman, commande 10 M maestro, commande 261 mailman 11 makecal, commande 262 makesec 325 makesec, commande 10, 324, 341 manuels xiv accès en ligne xviii commande xix voir publications xviii metronome.pl, commande 264 modèles d état 299 morestdl, commande 265 mots clés absolute 137, 143, 144, 149 deadline 99 mots clés, langage de planification 92 mots réservés 36 N needs, mot clé 117 netman 11 netmth, méthode d accès 313 niveau de sécurité enabled 39 force 39 on 39 noms de chemin d accès, notation xxi noms de répertoire, notation xxi notation noms de chemin d accès xxi type de caractère xxi variables d environnement xxi O objets de base de données, éditeur 64 objets de planification 35 on, mot clé 17, 118 onuntil 126 onuntil, mot clé 126 opens, mot clé 121 ordre des objets, fichier de sécurité 332 ordre des utilisateurs, fichier de sécurité 331 P pare-feu paramétrage 39 parms, commande 266 paxtract, commande IBM Tivoli Workload Scheduler - Guide de référence

395 planification, langage, mots clés 92 priority, mot clé 123 produit, bibliothèque xiv progressive 221 prompt, mot clé 124 prxtract, commande 268 publications en ligne accès xviii R r11xtract, commande 269 rccondsucc 49, 110 recall, commande 180 redo, commande 181 régénération des connecteurs 353 release, commande 271 release job, commande 183 release sched, commande 185 rep1, commande 291 rep11, commande 295 rep2, commande 291 rep3, commande 291 rep4a, commande 291 rep4b, commande 291 rep7, commande 292 rep8, commande 293 reply, commande 187 reptr, commande 296 rerun, commande 188 resource, commande 191 retard, état 99 rextract, commande 273 rmstdlist, commande 274 S schedule, mot clé 125 schedulr, commande 10 sécurité centralisée 323 création du fichier de sécurité 324 définitions d utilisateur 325 dumpsec 324 exemple de fichier 336 fichier modèle 324 gestion 324 locale 323 makesec 324 ordre des définitions utilisateur 331 ordre des objets 332 superutilisateur UNIX 333 syntaxe du fichier 325 variables 332 sélection de flux de travaux dans les commandes 143 sélection des travaux dans les commandes 135 service clients voir service de support logiciel 345 service de support logiciel contact 345 description de l incident au service de support logiciel IBM 346 service de support logiciel (suite) détermination de l impact de l incident pour le service de support logiciel IBM 345 soumission de l incident au service de support logiciel IBM 346 setsym, commande 192 setup_env 325 Sfinal ajout 16 showcpus, commande 193 showdomains, commande 197 showexec, commande 275 showfiles, commande 198 showjobs, commande 200 showprompts, commande 209 showresources, commande 210 showschedules, commande 212 shutdown, commande 215 site Web de support, recherche de solutions 343 sortie offline 130 sortie offline pour UNIX 64 sortie sur le terminal 63, 130 stageman, commande 10 start, commande 216 startup, commande 276 status, commande 218 stop, commande 219 stop ;progressive, commande 221 submit docommand 222 submit file, commande 224 submit job, commande 226 submit sched, commande 228 superutilisateur UNIX, sécurité 333 switchmgr, commande 230 syntaxe, fichier de sécurité 325 syntaxe des commandes Composer 65 syntaxe des commandes Conman 131 syntaxe du langage de planification 91 system, commande conman 231 T technique, formation Tivoli xix tellop, commande 232 Tivoli, formation technique xix Tivoli Software Information Center xviii travaux, états 141 type_sys_expl 37 typographie, conventions xx U unlink, commande 233 until, mot clé 126 V variables, fichier de sécurité 332 variables, notation xxi variables d environnement, notation xxi version, commande 235, 277 W wmaeutil 325 wmaeutil, commande 32, 279, 353 writer 11 X xref, commande 298 xrxtrct, commande 282 Z zones mortes 347 Index 371

396 372 IBM Tivoli Workload Scheduler - Guide de référence

397

398 Numéro de programme : 5698-WSH SC