guide des commandes - ibmpublib.boulder.ibm.com/tividd/td/tsla/sc32-0833-03/fr_fr/... · 2005. 1....
TRANSCRIPT
IBM Tivoli Service Level Advisor
Guide des commandes
Version 2.1
SC11-2196-00
���
IBM Tivoli Service Level Advisor
Guide des commandes
Version 2.1
SC11-2196-00
���
Première édition - novembre 2004
Réf. US : SC32-0833-03
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 http://www.fr.ibm.com (serveur IBM en France)
v http://www.can.ibm.com (serveur IBM au Canada)
v http://www.ibm.com (serveur IBM aux Etats-Unis)
Compagnie IBM France
Direction Qualité
Tour Descartes
92066 Paris-La Défense Cedex 50
© Copyright IBM France 2004. Tous droits réservés.
© Copyright International Business Machines Corporation 2002, 2004. All rights reserved.
Table des matières
Avis aux lecteurs canadiens . . . . . vii
Avant-propos . . . . . . . . . . . . ix
A qui s’adresse ce guide . . . . . . . . . . ix
Publications . . . . . . . . . . . . . . ix
Bibliothèque IBM Tivoli Service Level Advisor . . ix
Bibliothèque IBM DB2 Universal Database
Enterprise Edition . . . . . . . . . . . xi
Bibliothèque Tivoli Data Warehouse . . . . . xi
Modules d’intégration de données . . . . . . xi
Bibliothèque IBM WebSphere Application Server xi
Informations relatives à la console
d’administration SLM . . . . . . . . . . xi
Publications connexes . . . . . . . . . . xii
Accès en ligne aux publications . . . . . . . xii
Commande de publications . . . . . . . . . xii
Accessibilité . . . . . . . . . . . . . . xii
Formation technique Tivoli . . . . . . . . . xiii
Comment prendre contact avec le service de
support logiciel IBM . . . . . . . . . . . xiii
Détermination de l’impact de l’incident sur vos
activités . . . . . . . . . . . . . . xiv
Description de l’incident et collecte des
informations pertinentes . . . . . . . . . xiv
Soumission d’un incident au service de support
logiciel IBM . . . . . . . . . . . . . xiv
Recherches dans les bases de connaissances . . xv
Obtention de correctifs . . . . . . . . . xv
Mise à jour des informations de support . . . xvi
Participation à des groupes d’informations . . . xvii
Conventions utilisées dans ce document . . . . xviii
Conventions typographiques . . . . . . . xviii
Variables et chemins d’accès spécifiques des
systèmes d’exploitation . . . . . . . . . xviii
Chapitre 1. Présentation de l’interface de
ligne de commande . . . . . . . . . . 1
Commandes de service CLI . . . . . . . . . 1
Caractères spéciaux . . . . . . . . . . . 3
Connexions au service CLI . . . . . . . . 4
Codes retour . . . . . . . . . . . . . 4
Commandes de service non CLI . . . . . . . . 5
Utilisation de l’interface de ligne de commande . . 5
Configuration de l’accès telnet à l’interface de
ligne de commande . . . . . . . . . . . 5
Méthodes list et help . . . . . . . . . . . 6
Utilisation du service CLI . . . . . . . . . . 6
Protection par mot de passe . . . . . . . . 7
Commandes de service CLI supplémentaires . . 7
Chapitre 2. Commandes de service CLI 11
scmd help . . . . . . . . . . . . . . . 12
scmd list . . . . . . . . . . . . . . . 14
scmd setPassword . . . . . . . . . . . . 16
scmd setPasswordEnabled . . . . . . . . . 18
Chapitre 3. Commandes de processus
ETL . . . . . . . . . . . . . . . . 21
scmd etl addApplicationData . . . . . . . . 22
scmd etl disable . . . . . . . . . . . . . 24
scmd etl enable . . . . . . . . . . . . . 26
scmd etl getApps . . . . . . . . . . . . 28
scmd etl getDataExpiration . . . . . . . . . 29
scmd etl getDMVersion . . . . . . . . . . 31
scmd etl getIDInfo . . . . . . . . . . . . 32
scmd etl getMMVersion . . . . . . . . . . 35
scmd etl help . . . . . . . . . . . . . . 36
scmd etl list . . . . . . . . . . . . . . 37
scmd etl setDataExpiration . . . . . . . . . 38
Chapitre 4. Commandes de
transmission . . . . . . . . . . . . 41
scmd escalate checkCache . . . . . . . . . 42
scmd escalate customize . . . . . . . . . . 44
scmd escalate disable . . . . . . . . . . . 48
scmd escalate enable . . . . . . . . . . . 49
scmd escalate help . . . . . . . . . . . . 52
scmd escalate list . . . . . . . . . . . . 53
scmd escalate parentSLAsEscalation . . . . . . 54
scmd escalate setCacheSize . . . . . . . . . 56
scmd escalate snmp FormatDateTime . . . . . . 57
scmd escalate TECLogging . . . . . . . . . 58
scmd escalate test . . . . . . . . . . . . 59
scmd escalate update email . . . . . . . . . 60
scmd escalate view . . . . . . . . . . . . 62
Chapitre 5. Commandes de
journalisation et de trace . . . . . . . 63
scmd log filter . . . . . . . . . . . . . 64
scmd log handler . . . . . . . . . . . . 67
scmd log help . . . . . . . . . . . . . 70
scmd log list . . . . . . . . . . . . . . 71
scmd log message . . . . . . . . . . . . 72
scmd log trace . . . . . . . . . . . . . 75
Chapitre 6. Commandes du
gestionnaire de l’évaluateur de
mesures . . . . . . . . . . . . . . 79
scmd mem addSingleSchedulePeriod . . . . . . 80
scmd mem detectMissingAvailabilityData . . . . 83
scmd mem dumpData . . . . . . . . . . . 89
scmd mem flushEvents . . . . . . . . . . 93
scmd mem help . . . . . . . . . . . . . 94
scmd mem list . . . . . . . . . . . . . 95
scmd mem reEval . . . . . . . . . . . . 96
scmd mem removeSingleSchedulePeriod . . . . 102
scmd mem removeStoppedRetryEntries . . . . 104
scmd mem retryMissedIntervals . . . . . . . 107
scmd mem showAllSLAIDs . . . . . . . . 109
scmd mem showHourlyFrequencyIntervals . . . 110
© Copyright IBM Corp. 2002, 2004 iii
scmd mem showMetricEvaluators . . . . . . 113
scmd mem showRetrys . . . . . . . . . . 117
scmd mem skipHistoricSLAs . . . . . . . . 120
scmd mem trending . . . . . . . . . . . 121
Chapitre 7. Commandes offline . . . . 123
scmd offline createOfferinginXML . . . . . . 124
scmd offline help . . . . . . . . . . . . 126
scmd offline list . . . . . . . . . . . . 127
scmd offline migrateSLAs . . . . . . . . . 128
scmd offline updateNames . . . . . . . . . 130
scmd offline updateOffering . . . . . . . . 132
Chapitre 8. Commandes du
gestionnaire de commandes . . . . . 135
scmd om help . . . . . . . . . . . . . 136
scmd om list . . . . . . . . . . . . . 137
scmd om redeployCompletedSLAs . . . . . . 138
scmd om submitSLA . . . . . . . . . . . 140
Chapitre 9. Commandes de
communication à distance . . . . . . 141
scmd rcc getPort . . . . . . . . . . . . 142
scmd rcc help . . . . . . . . . . . . . 143
scmd rcc list . . . . . . . . . . . . . . 144
scmd rcc setPort . . . . . . . . . . . . 145
Chapitre 10. Commandes d’utilisateur
de rapport Web . . . . . . . . . . 147
scmd report addUser . . . . . . . . . . . 148
scmd report changeUser . . . . . . . . . . 154
scmd report deleteUser . . . . . . . . . . 158
scmd report displayTimezones . . . . . . . 159
scmd report help . . . . . . . . . . . . 161
scmd report list . . . . . . . . . . . . . 162
scmd report listUser . . . . . . . . . . . 163
Chapitre 11. Commandes du
planificateur . . . . . . . . . . . . 165
scmd scheduler help . . . . . . . . . . . 166
scmd scheduler list . . . . . . . . . . . 167
scmd scheduler listSettings . . . . . . . . . 168
scmd scheduler setMaxEvaluationThreads . . . . 169
scmd scheduler setMaxTimeForForcedScheduling 170
Chapitre 12. Commandes de base de
données SLM . . . . . . . . . . . 171
scmd sdc adjustIDGenerator . . . . . . . . 173
scmd sdc createCustomer . . . . . . . . . 174
scmd sdc createRealm . . . . . . . . . . 176
scmd sdc displayActiveServiceElements . . . . 178
scmd sdc displayAllCustomers . . . . . . . 180
scmd sdc displayAllRealms . . . . . . . . . 181
scmd sdc displayAllSchedules . . . . . . . . 182
scmd sdc displayAllServiceOfferings . . . . . 184
scmd sdc displayAllSLAs . . . . . . . . . 186
scmd sdc displayBaseSLAs . . . . . . . . . 187
scmd sdc displayBusinessSchedules . . . . . . 189
scmd sdc displayCustomer . . . . . . . . . 191
scmd sdc displayCustomerByID . . . . . . . 192
scmd sdc displayCustomerFromSLAID . . . . . 193
scmd sdc displayDataCollectorType . . . . . . 194
scmd sdc displayMilestoneSchedules . . . . . 195
scmd sdc displayObsoleteServiceElements . . . . 196
scmd sdc displayOfferingElementList . . . . . 197
scmd sdc displayOfferingScheduleName . . . . 198
scmd sdc displayOfferingState . . . . . . . . 199
scmd sdc displayRealm . . . . . . . . . . 200
scmd sdc displayScheduleByName . . . . . . 201
scmd sdc displayServiceOfferingByID . . . . . 203
scmd sdc displayServiceOfferingID . . . . . . 205
scmd sdc displayServiceOfferingName . . . . . 206
scmd sdc displayServiceOfferingsByState . . . . 207
scmd sdc displaySLAByID . . . . . . . . . 209
scmd sdc displaySLAMetricPropertyID . . . . . 210
scmd sdc displaySLAState . . . . . . . . . 211
scmd sdc getAssociatedSLAID . . . . . . . . 212
scmd sdc help . . . . . . . . . . . . . 213
scmd sdc list . . . . . . . . . . . . . 214
scmd sdc purgeIntermediateResults . . . . . . 215
scmd sdc purgeOldData . . . . . . . . . . 216
scmd sdc registerWarehouseData . . . . . . . 217
Chapitre 13. Commandes de gestion
de composants . . . . . . . . . . 219
scmd slm getComponentStatus . . . . . . . 220
scmd slm getStatus . . . . . . . . . . . 222
scmd slm help . . . . . . . . . . . . . 224
scmd slm list . . . . . . . . . . . . . 225
scmd slm listComponents . . . . . . . . . 226
scmd slm shutdown . . . . . . . . . . . 227
scmd slm startComponent . . . . . . . . . 228
scmd slm stopComponent . . . . . . . . . 230
Chapitre 14. Commandes de gestion
d’objets SLM . . . . . . . . . . . 231
scmd som cancel . . . . . . . . . . . . 232
scmd som create . . . . . . . . . . . . 233
scmd som delete . . . . . . . . . . . . 235
scmd som displayAll . . . . . . . . . . . 236
scmd som displayTimezones . . . . . . . . 237
scmd som export . . . . . . . . . . . . 238
scmd som help . . . . . . . . . . . . . 240
scmd som list . . . . . . . . . . . . . 241
Chapitre 15. Commandes de collecte
de données d’entrepôt . . . . . . . 243
scmd wdccli connections . . . . . . . . . 244
scmd wdccli help . . . . . . . . . . . . 245
scmd wdccli list . . . . . . . . . . . . 246
scmd wdccli listSettings . . . . . . . . . . 247
scmd wdccli setConRetries . . . . . . . . . 248
scmd wdccli setConWait . . . . . . . . . . 249
scmd wdccli setETLPoll . . . . . . . . . . 250
scmd wdccli setLogStartEnd . . . . . . . . 251
iv IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 16. Utilitaires de service non
CLI . . . . . . . . . . . . . . . . 253
cliutil . . . . . . . . . . . . . . . . 254
diagutil . . . . . . . . . . . . . . . 255
dsutil . . . . . . . . . . . . . . . . 257
logutil . . . . . . . . . . . . . . . . 260
rcomutil . . . . . . . . . . . . . . . 263
slmbackup . . . . . . . . . . . . . . 265
slmenv . . . . . . . . . . . . . . . 268
slmrestore . . . . . . . . . . . . . . 269
slmrestorerestart . . . . . . . . . . . . 273
userdump . . . . . . . . . . . . . . 275
verutil . . . . . . . . . . . . . . . . 276
viewer . . . . . . . . . . . . . . . . 278
wasutil . . . . . . . . . . . . . . . 284
Annexe. Remarques . . . . . . . . 289
Marques . . . . . . . . . . . . . . . 291
Index . . . . . . . . . . . . . . . 293
Table des matières v
vi IBM Tivoli Service Level Advisor - Guide des commandes
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. 2002, 2004 vii
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 1 800 465-1234.
viii IBM Tivoli Service Level Advisor - Guide des commandes
Avant-propos
Le Guide des commandes d’IBM Tivoli Service Level Advisor contient des détails sur
toutes les commandes de l’interface de ligne de commande (CLI) qui sont
accessibles via IBM Tivoli Service Level Advisor.
A qui s’adresse ce guide
Ce document est destiné aux administrateurs système et au personnel de services
professionnels Tivoli qui ont besoin d’effectuer diverses tâches à l’aide de
l’interface de ligne de commande d’IBM Tivoli Service Level Advisor. Vous devez
être familiarisé avec le fonctionnement de base d’IBM Tivoli Service Level Advisor
et de chacun de ses composants.
Publications
La présente section indique la liste des publications contenues dans la bibliothèque
IBM Tivoli Service Level Advisor, ainsi que dans d’autres documents connexes. Elle
explique également comment accéder en ligne aux publications Tivoli et
commander des publications Tivoli.
Bibliothèque IBM Tivoli Service Level Advisor
Les informations produit relatives à l’utilisation d’IBM Tivoli Service Level Advisor
se trouvent dans le répertoire /tsladocs du CD de documentation d’IBM Tivoli
Service Level Advisor, aux formats PDF et HTML. L’insertion du CD de
documentation sur le système d’exploitation Windows entraîne le lancement
automatique du centre de documentation Tivoli Software à partir duquel vous
pouvez accéder à tous les documents disponibles au format électronique.
Les documents suivants figurent dans la bibliothèque IBM Tivoli Service Level
Advisor :
v Un document ″Lisez-moi en premier″ qui sert de point de départ pour vous
aider à vous orienter dans la série de produits IBM prenant en charge la solution
SLM globale, et qui contient de rapides instructions sur la documentation à
consulter pour commencer l’installation d’IBM Tivoli Service Level Advisor et
des applications associées.
v Notes sur l’édition, SC11-2198
Ce document contient des informations de dernière minute (telles que certains
incidents et leurs solutions, ou encore la disponibilité des modules de
correction).
v Guide d’initiation, SC11-2040
Ce document présente IBM Tivoli Service Level Advisor et donne des
informations sur la planification, l’installation et la configuration d’IBM Tivoli
Service Level Advisor en vue de son utilisation en environnement d’entreprise
Tivoli.
v Gestion des contrats de service, SC11-2014
Ce document donne des informations sur la création et la gestion de calendriers,
d’offres, de clients et de domaines et sur l’association de ces éléments à des
ressources sélectionnées de votre environnement d’entreprise pour développer
des contrats de service (SLA) entre votre entreprise et les clients qui font appel à
© Copyright IBM Corp. 2002, 2004 ix
vous dans le cadre de ces contrats. Ce document s’adresse aux administrateurs,
aux spécialistes des offres de services et aux spécialistes des contrats de service
qui sont chargés de créer et de gérer des contrats SLA.
v Rapports SLM, SC11-2197
Ce document fournit des informations sur la génération et l’affichage de
rapports SLM sur le Web pour IBM Tivoli Service Level Advisor, en fonction des
résultats de l’évaluation et des analyses de tendances des données extraites de la
base de données Tivoli Data Warehouse. Des informations complémentaires sont
fournies pour permettre à vous-mêmes ou à vos clients d’intégrer des rapports
SLM dans des sites Web, notamment des exemples de personnalisation de
diverses fonctions d’affichage.
v Guide d’administration, SC11-1898
Ce document contient des informations relatives aux tâches d’administration que
vous pouvez effectuer à l’aide d’IBM Tivoli Service Level Advisor pour
configurer votre environnement SLM et effectuer diverses fonctions
d’administration à l’appui d’IBM Tivoli Service Level Advisor, telles que les
opérations de sauvegarde et de restauration ainsi que la définition et
l’autorisation des utilisateurs.
v Guide des commandes, SC11-2196 (le présent document)
Ce document fournit des informations relatives aux commandes CLI (Command
Line Interface - Interface de ligne de commande) disponibles pour l’affichage de
certaines conditions et de certains états au sein d’IBM Tivoli Service Level
Advisor, et pour l’exécution de différentes tâches de configuration à l’aide de la
commande scmd. Il décrit également des utilitaires supplémentaires qui
fournissent d’autres fonctions spécifiques.
v Messages, SC11-2199
Ce document donne des informations sur les messages qui peuvent s’afficher au
cours de l’utilisation d’IBM Tivoli Service Level Advisor. Il fournit des
explications supplémentaires sur les messages et des instructions de reprise sur
erreurs.
v Troubleshooting, SC32-1249
Ce document fournit des informations sur la résolution des incidents que vous
pourrez rencontrer lors de l’installation et de la configuration, ainsi que sur la
résolution des problèmes d’administration susceptibles d’apparaître lors du
fonctionnement normal du produit. Des informations sur la consignation des
messages et de la trace sont également incluses.
v Aide en ligne d’IBM Tivoli Service Level Advisor
L’aide en ligne contient des rubriques pour toutes les tâches d’administration
d’IBM Tivoli Service Level Advisor effectuées à l’aide d’console d’administration
SLM. Elle s’affiche dans le Module d’assistance des tâches d’console
d’administration SLM. Les informations spécifiques aux tâches IBM Tivoli
Service Level Advisor se trouvent uniquement dans l’aide en ligne. Lors de
l’installation de nouveaux produits qui s’exécutent dans console d’administration
SLM, les rubriques d’aide en ligne correspondantes sont également installées et
intégrées dans la bibliothèque d’informations existante.
En outre, pour obtenir des informations de support et des mises à jour logicielles
relatives à IBM Tivoli Service Level Advisor, ainsi que des modules d’entrepôt pris
en charge et des correctifs provisoires téléchargeables, visitez le site Web IBM
Tivoli Service Level Advisor suivant :
http://www.ibm.com/software/sysmgmt/products/support
/IBMTivoliServiceLevelAdvisor.html
x IBM Tivoli Service Level Advisor - Guide des commandes
Bibliothèque IBM DB2 Universal Database Enterprise Edition
Les documents nécessaires à la prise en charge d’IBM DB2 Universal Database
Enterprise Edition sont fournis sur le CD-ROM IBM DB2 Universal Database
Enterprise Edition et à l’adresse suivante :
http://www.ibm.com/software/data/db2/udb
Bibliothèque Tivoli Data Warehouse
IBM Tivoli Service Level Advisor exige que Tivoli Data Warehouse soit installé
dans l’entreprise. Cette application tient lieu de référentiel de données pour les
applications Tivoli de contrôle des performances et de la disponibilité générant des
données de gestion des niveaux de service. Reportez-vous aux documents suivants
fournis sur le CD de documentation de Tivoli Data Warehouse livré avec IBM
Tivoli Service Level Advisor :
v Installing and Configuring Tivoli Data Warehouse
v Enabling an Application for Tivoli Data Warehouse
v Tivoli Data Warehouse Release Notes
Modules d’intégration de données
Les modules d’intégration de données (également désignés par modules
d’entrepôt) représentent les interfaces utilisées pour le chargement et la
transformation, dans Tivoli Data Warehouse, des données collectées par les
applications source, ainsi que du chargement et de la transformation de ces
données à partir de Tivoli Data Warehouse vers des applications cible qui utilisent
ces données pour générer des rapports et effectuer des analyses. Pour connaître
l’emplacement en ligne des informations les plus récentes sur les modules
d’entrepôt, reportez-vous au document intitulé Notes sur l’édition d’IBM Tivoli
Service Level Advisor.
Bibliothèque IBM WebSphere Application Server
IBM Tivoli Service Level Advisor utilise IBM WebSphere Application Server
comme base des fonctions serveur d’administration et serveur de rapports SLM. Le
Guide d’initiation donne des informations de départ sur l’installation d’IBM
WebSphere Application Server et son intégration à IBM Tivoli Service Level
Advisor. Pour en savoir plus, reportez-vous à la documentation officielle fournie
sur le support du produit IBM WebSphere Application Server livré avec IBM Tivoli
Service Level Advisor, ainsi qu’aux dernières informations en ligne sur IBM
WebSphere Application Server sur le site Web suivant :
http://www.ibm.com/software/webservers/appserv/was/library
Informations relatives à la console d’administration SLM
IBM Tivoli Service Level Advisor fournit la console d’administration SLM, une
interface utilisateur graphique (GUI) sur le Web du serveur d’administration qui
est exécutée dans l’environnement IBM WebSphere et à partir de laquelle vous
pouvez créer et gérer des calendriers, des offres, des clients, des domaines et des
contrats de service. Les informations relatives à l’utilisation de la console
d’administration SLM et aux tâches liées à la création et la gestion de contrats SLA
sont décrites en détail dans le document Gestion des contrats de service. L’aide aux
utilisateurs de la console d’administration SLM est disponible dans la fonction
d’aide en ligne du module d’assistance des tâches.
Avant-propos xi
Publications connexes
Les documents suivants contiennent également des informations utiles :
Le Glossaire des logiciels Tivoli contient les définitions de nombreux termes
techniques relatifs aux logiciels Tivoli. Ce glossaire est disponible (en anglais
uniquement) sur le site Web suivant :
http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm
Pour accéder au glossaire, cliquez sur le lien Glossaire dans le panneau gauche de
la fenêtre de la bibliothèque de logiciels Tivoli.
Accès en ligne aux publications
Outre le CD de documentation qui est expédié avec IBM Tivoli Service Level
Advisor, vous pouvez accéder à ces publications en ligne. IBM affiche sur le site
Web du centre d’aide et d’information des logiciels Tivoli toutes les publications de
ce produit et de tous les autres produits Tivoli, à mesure qu’elles sont disponibles
et chaque fois qu’elles sont mises à jour. Pour accéder au centre d’aide et
d’information pour les logiciels Tivoli, ouvrez la bibliothèque de logiciels Tivoli à
l’adresse Web suivante :
http://www.ibm.com/software/tivoli/library
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 IBM Tivoli Service Level Advisor pour accéder à cette bibliothèque dans le
centre d’information des logiciels Tivoli.
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 :
www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi
Au Canada, vous pouvez également les commander par téléphone en composant le
numéro 800-426-4968.
Pour obtenir la liste des numéros de téléphone dans les autres pays, visitez le site
Web :
http://www.ibm.com/software/tivoli/order-lit/
Accessibilité
Les fonctions d’accessibilité permettent à un utilisateur souffrant d’un handicap
physique, comme une mobilité réduite ou une vision limitée, d’utiliser plus
facilement les logiciels. Grâce à ce produit, vous bénéficiez de technologies d’aide
acoustique et de navigation dans l’interface. L’usage du clavier au lieu de la souris
vous permet également de contrôler les différentes fonctionnalités de l’interface
graphique.
xii IBM Tivoli Service Level Advisor - Guide des commandes
Formation technique Tivoli
Pour plus d’informations sur la formation technique Tivoli, visitez le site Web
suivant :
www.ibm.com/software/tivoli/education
Comment prendre contact avec le service de support logiciel IBM
Le service de support logiciel IBM fournit une assistance en cas d’incident survenu
avec ce produit.
Avant de prendre contact avec le service de support logiciel IBM, votre entreprise
doit avoir conclu un contrat de maintenance logicielle IBM et vous devez disposer
d’une autorisation de soumission d’incidents à IBM. Le type de contrat de
maintenance dont vous disposez dépend du type de produit :
v Pour les logiciels IBM répartis (incluant notamment, mais de façon non
limitative, les produits Tivoli, Lotus et Rational, ainsi que les produits DB2 et
WebSphere exécutés sous Windows ou sous UNIX), inscrivez-vous au
programme Passport Advantage en utilisant l’une des méthodes suivantes :
– Inscription en ligne : accédez à la page Web Passport Advantage, puis
cliquez sur le lien How to Enroll :
www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home
– Par téléphone : pour connaître le numéro de téléphone à composer en
fonction de votre pays, accédez au site Web du support logiciel IBM suivant
et cliquez sur votre région géographique :
techsupport.services.ibm.com/guides/contacts.html
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 :
www.ibm.com/servers/eserver/techsupport.html
Si vous n’êtes pas certain du type de contrat de maintenance logicielle requis,
accédez à la page des contacts du guide de support logiciel IBM sur le Web 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
1-800-IBMSERV (1-800-426-7378).
techsupport.services.ibm.com/guides/contacts.html
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.
Avant-propos xiii
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 de vos
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.
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 (http://www.ibm.com/software/support/probsub.html).
Entrez les informations requises dans l’outil de soumission d’incident.
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.
xiv IBM Tivoli Service Level Advisor - Guide des commandes
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 «Recherches dans les
bases de connaissances» et «Obtention de correctifs».
Recherches dans les bases de connaissances
Si un incident survient lorsque vous utilisez votre logiciel IBM, vous souhaitez
sans doute le résoudre rapidement. Commencez par rechercher dans les bases de
connaissances disponibles si une solution a déjà été répertoriée pour cet incident.
Recherches dans le Centre d’information à partir de votre
système local ou du réseau
IBM met à votre disposition une riche documentation que vous pouvez installer
sur votre machine locale ou sur un serveur Intranet. Vous pouvez utiliser la
fonction de recherche de ce centre pour extraire des informations d’ordre
conceptuel, des instructions d’exécution pour des tâches précises, des informations
de référence ou des documents de support.
Conseil : Mettez à jour votre Centre d’informations avec les dernières informations
de prise en charge.
Recherches sur Internet
Si vous ne trouvez aucune réponse à votre question dans le Centre d’information,
recherchez sur Internet les informations les plus récentes susceptibles de vous aider
à résoudre l’incident. Pour rechercher votre produit dans plusieurs ressources sur
Internet, ouvrez le dossier correspondant dans la fenêtre de navigation à gauche de
la page et sélectionnez Support on the Web. Cela vous permet d’effectuer une
recherche dans un grand nombre de ressources, parmi lesquelles :
v Fiches techniques IBM
v Produits téléchargeables IBM
v Publications IBM Redbooks
v IBM DeveloperWorks
v Forums
v Google
Obtention de correctifs
Un correctif est peut-être disponible pour résoudre l’incident. Vous pouvez vérifier
les correctifs disponibles pour votre logiciel IBM en accédant au site Web de
support logiciel IBM :
1. Accédez au site Web de support logiciel IBM (
http://www.ibm.com/software/support).
2. Dans la rubrique Products A - Z, sélectionnez le nom de votre produit. Cela
permet d’ouvrir un site spécifique consacré à ce produit.
3. Dans la rubrique Self help, cliquez sur le lien All Updates, qui vous permet
d’obtenir la liste des correctifs, groupes de correctifs et autres mises à jour
disponibles pour votre produit. Pour obtenir des conseils afin d’affiner votre
recherche, cliquez sur le lien Search tips.
Avant-propos xv
4. Cliquez sur le nom d’un correctif pour afficher sa description et, le cas échéant,
le télécharger.
Pour recevoir par courrier électronique des notifications hebdomadaires sur les
correctifs et d’autres informations actualisées sur les produits IBM, procédez
comme suit :
1. Dans la page de support d’un produit IBM, cliquez sur My support dans
l’angle supérieur droit de la page.
2. Si vous êtes déjà enregistré, passez directement à l’étape suivante. Si vous ne
l’êtes pas, cliquez sur le bouton Register dans l’angle supérieur droit de la page
afin de créer votre ID utilisateur et votre mot de passe.
3. Revenez à la page My support.
4. Dans cette page, cliquez sur l’option Edit profiles dans le panneau de
navigation de gauche et accédez à l’option Select Mail Preferences.
Sélectionnez une famille de produits et cochez les cases en fonction des
informations qui vous intéressent.
5. Cliquez sur Submit.
6. Pour la notification par courrier électronique relative à d’autres produits,
répétez les étapes 4 et 5.
Pour plus d’informations sur les types de correctifs, voir Software Support Handbook
(http://techsupport.services.ibm.com/guides/handbook.html).
Mise à jour des informations de support
Les centres d’information contiennent généralement un ou plusieurs modules
d’extension. Ces modules ajoutent des fiches techniques IBM et autres documents
au centre d’information. La procédure suivante explique comment mettre à jour les
modules d’extension :
1. Accédez au site Web de support logiciel IBM
(www.ibm.com/software/support).
2. Dans la rubrique Products A - Z, sélectionnez le nom de votre produit. Cela
permet d’ouvrir un site spécifique consacré à ce produit.
3. Dans la zone Search support for this product, tapez le mot de passe :
com.ibm.support. Cochez la case Download, puis cliquez sur Submit.
4. Vérifiez le résultat de la recherche des mises à jour de modules d’extension.
Tous ces modules utilisent la convention ″com.ibm.support.produit.doc.″ Si une
mise à jour est disponible, sélectionnez-la dans la liste et affichez les
instructions de téléchargement.
5. Enregistrez le fichier compressé joint dans un répertoire temporaire sur votre
disque dur.
6. Décompressez ce fichier en veillant à conserver les sous-dossiers.
7. Copiez le dossier contenant les modules d’extension dans votre dossier de
modules d’extension Eclipse. Par exemple, si votre logiciel IBM est installé dans
c:\IBM\WebSphere\, copiez le dossier des modules à jour
(com.ibm.support.product.doc) dans c:\IBM\WebSphere\eclipse\plugins.
8. Pour afficher les informations de support actualisées, démarrez le centre
d’information (ou arrêtez, puis redémarrez-le), puis développez la rubrique
Support information dans l’arborescence de navigation.
xvi IBM Tivoli Service Level Advisor - Guide des commandes
Participation à des groupes d’informations
Avec les groupes d’informations utilisateur, les professionnels de l’industrie
logicielle bénéficient d’un forum pour échanger leurs idées, leurs compétences
techniques et leurs expériences sur le produit. Les groupes d’informations
utilisateur se trouvent sur Internet et sont accessibles à l’aide de lecteurs de
nouvelles standard. Ces groupes sont essentiellement destinés aux communications
entre utilisateurs et ne remplacent pas le support officiel.
Si vous utilisez Mozilla, suivez les instructions suivantes pour accéder à un groupe
d’informations :
1. Ouvrez une fenêtre dans le navigateur Mozilla.
2. Dans le menu Edition, cliquez sur Préférences. La fenêtre Préférences s’affiche.
3. Dans la vue Catégorie, cliquez sur Messagerie & forums pour afficher les
paramètres correspondants.
4. Cochez la case Utiliser Mozilla comme application de messagerie par défaut.
5. Cliquez sur OK.
6. Fermez le navigateur Mozilla, puis rouvrez-le.
7. Copiez-collez l’adresse d’un groupe d’informations sur un produit dans la zone
Adresse du navigateur, puis appuyez sur Entrée pour ouvrir le groupe
d’informations.
Si vous utilisez Microsoft Internet Explorer, suivez les instructions suivantes pour
accéder à un groupe d’informations :
1. Ouvrez Internet Explorer.
2. Dans le menu Outils, cliquez sur Options Internet.
3. Dans la fenêtre Options Internet, cliquez sur l’onglet Programmes.
4. Dans la liste Groupes de discussion, cliquez sur la flèche vers le bas, puis sur
Outlook Express.
5. Cliquez sur OK.
6. Fermez Internet Explorer, puis rouvrez-le.
7. Copiez-collez l’adresse d’un groupe d’informations sur un produit dans la zone
Adresse du navigateur, puis appuyez sur Entrée pour ouvrir le groupe
d’informations.
Pour trouver des informations sur Tivoli Data Warehouse, accédez au groupe
d’informations suivant :
news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse
Pour trouver des informations sur Tivoli Service Level Advisor, accédez au groupe
d’informations suivant :
news://news.software.ibm.com/ibm.software.tivoli.service-level-advisor
Pour trouver des informations sur IBM DB2, accédez au groupe d’informations
suivant :
news://news.software.ibm.com/ibm.software.db2
Pour trouver des informations sur IBM WebSphere Application Server, accédez au
groupe d’informations suivant :
news://news.software.ibm.com/ibm.software.websphere.application-server
Avant-propos xvii
Conventions utilisées dans ce document
Le présent guide fait appel à diverses conventions typographiques pour désigner
des termes, actions, commandes et chemins d’accès dépendants du système
d’exploitation et icônes placées en marge du document.
Conventions typographiques
Ce document utilise les conventions typographiques suivantes :
Gras
v Utilisé pour les commandes en minuscules et les commandes en
minuscules et majuscules difficiles à distinguer du reste du texte
v Eléments d’interface (cases à cocher, boutons radio, zones, dossiers,
icônes, zones de liste et ses éléments, listes à plusieurs colonnes,
conteneurs, commandes, noms de menus, pages de propriétés), libellés
(tels que Astuce : et Conditions applicables aux systèmes d’exploitation
:)
v Mots clés et paramètres figurant dans le texte
Italique
v Citations (titres de manuel, disquette et CD)
v Termes définis dans le texte
v Mise en évidence de termes
v Termes nouveaux dans le texte (ne figurant pas dans une liste de
définitions)
v Variables et valeurs à 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 Texte de messages et d’invites adressés à l’utilisateur
v Texte que l’utilisateur doit taper
v Valeurs d’arguments ou options de commandes
Variables et chemins d’accès spécifiques des systèmes
d’exploitation
Ce document utilise les conventions UNIX pour la spécification des variables
d’environnement et pour la notation des répertoires.
Lorsque vous utilisez la ligne de commande Windows, remplacez $ par %% dans
les variables d’environnement et remplacez chaque barre oblique (/) par une barre
oblique inversée (\) dans les chemins d’accès. Les noms des variables
d’environnement ne sont pas toujours les mêmes 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.
xviii IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 1. Présentation de l’interface de ligne de commande
IBM Tivoli Service Level Advisor est doté d’une interface de ligne de commande
(CLI) qui permet de communiquer avec le serveur SLM, le serveur
d’administration SLM et les options de rapports SLM d’IBM Tivoli Service Level
Advisor. Un jeu complet de commandes CLI est livré avec IBM Tivoli Service Level
Advisor pour fournir des informations relatives à l’environnement de gestion de
niveau de service (SLM) et pour déclencher des actions via le serveur SLM, le
serveur d’administration SLM et la console Rapports SLM.
Les commandes CLI sont logiquement réparties en deux domaines :
v Commandes d’administration
v Commandes de reprise sur incident et d’informations complémentaires
Les commandes d’administration sont généralement utilisées dans le cadre des
opérations quotidiennes et aident l’administrateur IBM Tivoli Service Level
Advisor à contrôler et à configurer le produit. Les commandes de reprise sur
incident et d’informations complémentaires fournissent d’autres fonctionnalités qui
sont utilisées dans les situations de détermination et de résolution d’incident. Les
commandes de reprise sur incident doivent être utilisées avec précaution, car
certaines commandes risquent de modifier l’état du système. Avant d’émettre des
commandes de reprise sur incident, vous devez comprendre la description
complète et la fonction prévue de chacune des commandes. Avant d’utiliser une
commande de reprise sur un incident, il est peut être nécessaire de prendre contact
avec le service de support Tivoli. Pour plus d’informations sur l’utilisation prévue
de certaines de ces commandes, reportez-vous au Guide d’administration.
Les commandes CLI interagissent avec IBM Tivoli Service Level Advisor en
communiquant via le service CLI ou, dans le cas des commandes de service non
CLI, directement avec le serveur SLM, la console Rapports SLM et la console
d’administration SLM.
Commandes de service CLI
Le service CLI est lancé dans le cadre du démarrage du serveur SLM et est
disponible lorsque le serveur SLM est actif. Les commandes CLI scmd sont
spécifiques au service CLI et ne sont disponibles que sur le serveur SLM. Le
format des commandes CLI scmd est le suivant :
scmd [–p <mot_de_passe>] [<nom_regroupement>] <méthode> [<options>]
Les éléments de la commande sont définis comme suit :
–p <mot_de_passe>
Indique l’option –p transmise au mot de passe en cours qui doit être fourni
si la protection par mot de passe est activée. Pour plus d’informations, voir
«Protection par mot de passe» à la page 7.
<nom_regroupement>
Méthode permettant de regrouper des commandes scmd similaires qui sont
utilisées avec une fonction particulière d’IBM Tivoli Service Level Advisor.
Pour consulter la liste des noms de regroupements disponibles, voir le
tableau 2 à la page 9. Dans le cas des commandes de service CLI de base,
telles que list, help, setPassword et setPasswordEnabled, les noms de
© Copyright IBM Corp. 2002, 2004 1
regroupement ne sont pas utilisés. Pour plus d’informations, voir
«Utilisation du service CLI» à la page 6.
<méthode>
Indique l’action particulière à effectuer. Les méthodes sont généralement
regroupées et il se peut que certaines soient transmises avec une ou
plusieurs options et des arguments associés.
<options>
Indique une ou plusieurs options supplémentaires et des arguments
associés à la méthode indiquée.
Par exemple, une commande scmd dans le regroupement sdc qui utilise la
méthode readAllCustomers pour afficher le nom de tous les clients est émise
comme suit :
scmd sdc readAllCustomers
Autre exemple : une commande scmd du regroupement log utilise la méthode
trace avec une option de list pour déterminer les consignateurs de trace qui sont
disponibles. Cette commande est émise comme suit :
scmd log trace -list
Le tableau 1 décrit plus en détail la syntaxe des commandes.
Tableau 1. Description de la syntaxe des commandes de service CLI
Syntaxe Description Exemple
Crochets ( [ ] ) Les informations placées
entre crochets ( [ ] ) sont
facultatives. Tous les
éléments non placés entre
crochets doivent être
spécifiés.
[–p <mot_de_passe>]
Accolades ( { } ) Les accolades ( { } )
identifient un ensemble
d’options qui s’excluent
mutuellement, lorsqu’une
option est requise.
{ true | false}
Barre verticale ( | ) Les options qui s’excluent
mutuellement sont séparées à
l’aide d’une barre verticale (
| ). Vous pouvez entrer une
des opérations séparées par
la barre verticale, mais vous
ne pouvez pas entrer
plusieurs options lors d’une
utilisation unique de la
commande. Une barre
verticale permet de séparer
les options facultatives ou
obligatoires.
{true | false}
2 IBM Tivoli Service Level Advisor - Guide des commandes
Tableau 1. Description de la syntaxe des commandes de service CLI (suite)
Syntaxe Description Exemple
Chevrons
fermants/ouvrants ( <
> )
Le texte placé entre des
chevrons (< >) représente les
variables qui doivent être
remplacées par l’élément
qu’il représente. Dans
l’exemple, remplacez
<nom_fichier> par le nom du
fichier spécifique.
<nom_fichier>
Points de suspension (
... )
Les points de suspension (...)
indiquent que l’option
précédente peut être répétée
plusieurs fois à l’aide de
valeurs différentes.
1. [–x <fichier>]...
Les points de suspension situés
hors des crochets indiquent
que la variable –x <fichier>
est facultative et peut être
répétée comme suit :
–x <fichier1> –x <fichier2>
–x <fichier3>
2. [–x <fichier>...]
Les points de suspension
placés entre crochets indiquent
que –x <fichier> est facultatif
et la variable fichier peut être
répétée comme suit :
–x <fichier1> <fichier2>
<fichier3>
3. –x <fichier>
[–x <fichier>]...
Indique que vous devez
spécifier –x<fichier> au moins
une fois.
Caractères spéciaux
Certains caractères spéciaux qui sont transmis dans le cadre des paramètres, par
exemple, %, &, !, [, ], :, + ou des espaces, doivent être placés entre guillemets, de
sorte qu’ils soient transmis correctement. Par exemple, vous pouvez choisir de
créer un nom de client tel que
Omni Bank
Ce nom de client comporte un espace ; il doit donc être placé entre guillemets dans
la commande CLI, comme dans l’exemple suivant :
scmd sdc createCustomer -name "Omni Bank" -realmList America
Certains caractères ont une signification spéciale pour le processeur de commandes
DOS qui traite ces commandes avant qu’ils soient traités par le processeur de
commandes CLI. Lorsque ces caractères spéciaux sont placés entre guillemets, cela
indique à DOS qu’ils doivent être transmis dans le cadre du paramètre et qu’ils ne
nécessitent pas une intervention spéciale de la part de DOS.
Chapitre 1. Présentation de l’interface de ligne de commande 3
Précaution à prendre lors de l’utilisation d’une barre oblique
inversée (\)
Si vous utilisez une barre oblique inversée (\) pour le dernier caractère d’un
paramètre transmis à une commande scmd, vous devez l’indiquer sous forme de
deux barres obliques inversées (\\) dans la chaîne. Par exemple, la commande
suivante tente de créer un client dont le nom se termine par une barre oblique
inversée :
scmd sdc createCustomer -name "ABC\" -realmList XYZ
Cette commande échoue et émet une erreur d’analyse syntaxique car le paramètre
-realmList n’est pas reconnu. La commande n’est pas traitée correctement, en
raison de la barre oblique inversée située à la fin du nom de client ABC\. Pour
corriger cet incident, vous devez indiquer le nom client à l’aide de deux barres
obliques inversées :
scmd sdc createCustomer -name "ABC\\" -realmList XYZ
Cette commande est traitée correctement et le client nommé ABC\ est créé.
Précaution à prendre lors de l’utilisation de guillemets
Lors de l’utilisation de guillemets de part et d’autre des paramètres des chaînes de
commande scmd, si la chaîne contient des guillemets non appariés, les paramètres
résultants transmis au processeur de commandes scmd risquent d’être traités de
façon incorrecte.
Dans l’exemple suivant, la commande est émise pour créer un client nommé ″Jean
Dupont″, mais le guillemet de début n’est pas associé à un guillemet de fin :
scmd sdc createcustomer -realmlist aa -name "Jean Dupont -desc Executive
Il en résulte que le client nommé Jean Dupont -desc Executive est créé et que le
paramètre -desc est ignoré. Veillez à placer les paramètres entre des guillemets
appariés.
Connexions au service CLI
Les commandes de service CLI fonctionnent en temps réel sur le serveur SLM, de
sorte que le serveur SLM doit être en cours d’exécution pour que la
communication soit correcte. Si une connexion au service CLI ne peut pas être
obtenue, l’erreur suivante s’affiche :
DYKAL2030E Impossible d’établir une connexion au service d’interface de ligne
de commande sur le port <numéro_port>
Pour plus d’informations sur la configuration, le dépannage et l’utilisation générale
du service CLI, consultez d’autres sections du présent document et reportez-vous
au Guide d’administration et au Guide d’initiation.
Codes retour
Si des commandes CLI sont exécutées à partir d’un fichier de commandes ou d’un
script de shell, le service CLI fournit un code retour indiquant la réussite ou
l’échec de l’appel scmd. Les codes retour sont les suivants :
v ICLIBundle.RETURN_SUCCESS = 0
v ICLIBundle.RETURN_FAILURE = 1
Ces codes retour peuvent vous être utiles si vous écrivez des scripts pour émettre
diverses commandes scmd, afin de déterminer la suite des opérations à effectuer
4 IBM Tivoli Service Level Advisor - Guide des commandes
en fonction de la réussite ou de l’échec de l’appel. Ces codes retour ne s’affichent
pas lors de l’émission de commandes CLI à partir d’une invite d’écran.
Commandes de service non CLI
Les commandes non effectuées à l’aide du service CLI (c’est-à-dire, non émises
sous forme de commandes scmd) sont disponibles que les serveurs IBM Tivoli
Service Level Advisor soient ou non en cours d’exécution, mais elles nécessitent le
démarrage du serveur concerné pour que les actions qui leur sont associées
prennent effet. Pour déterminer les commandes qui sont disponibles sur chaque
serveur et pour plus d’informations sur la fonction prévue des commandes,
consultez les descriptions de commande figurant dans le présent document.
Utilisation de l’interface de ligne de commande
Avant d’utiliser l’interface de ligne de commande, vous devez initialiser
l’environnement de ligne de commande IBM Tivoli Service Level Advisor. Pour ce
faire, accédez au répertoire <rép_installation_SLM> dans lequel une ou plusieurs
options d’installation IBM Tivoli Service Level Advisor ont été installées sur le
poste local, puis émettez la commande suivante dans une invite :
v Sous Windows :
slmenv
v Sous UNIX :
. ./slmenv
Une fois que l’environnement de ligne de commande a été configuré correctement,
vous pouvez émettre des commandes CLI à partir de n’importe quel emplacement
du shell en cours en tapant le nom de commande suivi des paramètres requis.
Remarque : La commande slmrestore ne peut être émise qu’à partir du répertoire
/tools/restore du CD-ROM du produit IBM Tivoli Service Level
Advisor. Pour plus de détails, reportez-vous à la description de
l’utilitaire slmrestore dans le Chapitre 16, «Utilitaires de service non
CLI», à la page 253.
Par exemple, supposons qu’IBM Tivoli Service Level Advisor a été installé dans le
répertoire C:\TSLA et que vous souhaitez afficher la liste de tous les clients définis,
à l’aide de la commande sdc displayAllCustomers. Pour cela, ouvrez une fenêtre
de commande et émettez les commandes suivantes :
cd C:\TSLA
slmenv
scmd sdc displayAllCustomers
Il suffit d’émettre slmenv une seule fois pour initialiser l’environnement de
commandes au début de votre session de commande, puis vous pouvez émettre
plusieurs commandes CLI.
Configuration de l’accès telnet à l’interface de ligne de
commande
Sur un système d’exploitation UNIX, lors de l’utilisation de telnet pour accéder à
l’interface de ligne de commande IBM Tivoli Service Level Advisor à l’aide d’un
support de langue destiné à un environnement non anglais, il est peut-être
nécessaire de définir la variable système LC_CTYPE en plus de la variable système
LANG pour que IBM Tivoli Service Level Advisor affiche correctement des
Chapitre 1. Présentation de l’interface de ligne de commande 5
réponses de commande dans la langue de l’environnement local. Cela s’applique
quelle que soit votre connexion (en local ou à distance).
L’exemple suivant est destiné à la langue française sur un poste Solaris sur lequel
telnet a été démarré :
export LANG=fr_FR
export LC_CTYPE=fr_FR
Méthodes list et help
Pour vous aider à utiliser les commandes CLI, chaque regroupement de
commandes scmd de service CLI et chaque commande de service non CLI
fournissent deux méthodes supplémentaires :
List Renvoie une liste d’arguments admissibles et la syntaxe de commande de
base. Par exemple, pour afficher la liste des commandes et options
disponibles pour le regroupement sdc, vous pouvez émettre la commande
suivante :
scmd sdc list
Help Renvoie des informations détaillées relatives aux significations et aux
valeurs possibles des arguments de commande. Par exemple, pour afficher
la syntaxe de commande, les variables, les options et des exemples pour le
regroupement etl, vous pouvez émettre la commande suivante :
scmd etl help
Les deux méthodes peuvent servir d’arguments avec toutes les commandes de
service non CLI, comme dans les commandes génériques suivantes :
v Pour le service CLI :
scmd list
scmd help
scmd <nom_regroupement> list
scmd <nom_regroupement> help
v Pour les commandes de service non CLI :
<nom_commande> list
<nom_commande> help
Utilisation du service CLI
Le service CLI fournit une bibliothèque de commandes assurant l’interface avec les
composants d’IBM Tivoli Service Level Advisor, y compris le service CLI
proprement dit. Les quatre commandes de base suivantes permettent de configurer
le service CLI et d’obtenir des informations sur les autres commandes proposées
par le service CLI :
v scmd help
v scmd list
v scmd setPassword
v scmd setPasswordEnabled
Ces commandes sont distinctes du reste des commandes scmd et ne comprennent
pas de nom de regroupement. Ces commandes sont décrites plus en détail dans le
Chapitre 2, «Commandes de service CLI», à la page 11.
6 IBM Tivoli Service Level Advisor - Guide des commandes
Protection par mot de passe
La protection par mot de passe est une fonction facultative du service CLI. Par
défaut, la protection par mot de passe est désactivée. Utilisez les méthodes
setPassword et setPasswordEnabled pour définir et modifier le mot de passe en
cours et pour activer et désactiver la protection par mot de passe. Lorsque la
protection par mot de passe est activée, toutes les commandes, à l’exception de
scmd help, exigent que le mot de passe en cours soit indiqué pour que la
commande soit émise correctement.
Par exemple, lorsque la protection par mot de passe est désactivée, vous pouvez
émettre la commande suivante pour afficher tous les paramètres configurés
destinés à la transmission d’événements :
scmd escalate view
Lorsque la protection par mot de passe est activée, vous devez indiquer cette
commande avec un autre paramètre, –p <motdepasse_en_cours>, en procédant
comme suit :
scmd -p <motdepasse_en_cours> escalate view
Lors de la première installation d’IBM Tivoli Service Level Advisor, vous pouvez
activer la protection par mot de passe et indiquer un mot de passe initial. Si vous
activez la protection par mot de passe pour votre service CLI, utilisez la
commande scmd setPassword afin de modifier ce mot de passe initial à tout
moment.
Remarque : Même si la protection par mot de passe est désactivée, vous devez
indiquer le mot de passe en cours lors de l’émission de la commande
setPassword ou setPasswordEnabled.
Par exemple, pour remplacer le mot de passe en cours par un nouveau mot de
passe, émettez la commande suivante :
scmd -p <motdepasse_en_cours> setPassword <nouveau_motdepasse>
Même si la commande scmd help ne nécessite pas de mot de passe, elle tente de
se connecter au service CLI, puis elle renvoie une erreur indiquant que le mot de
passe est incorrect. Ce comportement est imputable à la nature des informations
renvoyées par la commande scmd help. Si une connexion n’est pas établie du fait
que le service CLI est inaccessible ou que le mot de passe est incorrect ou non
indiqué, scmd help renvoie des informations d’aide générales. Si une connexion au
service CLI est établie et authentifiée, scmd help renvoie des informations d’aide
spécifiques, y compris une liste de tous les regroupements CLI disponibles.
Oubli du mot de passe CLI
Le mot de passe CLI est défini par vous-même ou paramétré sur une valeur par
défaut lors de l’installation d’IBM Tivoli Service Level Advisor. Si le mot de passe
CLI a été modifié et qu’il est inconnu, prenez contact avec votre administrateur
IBM Tivoli Service Level Advisor. Pour plus de détails sur la définition ou
l’extraction du mot de passe CLI, reportez-vous au Guide d’administration.
Commandes de service CLI supplémentaires
Outre les quatre commandes de service CLI de base, il existe un grand ensemble
de commandes intervenant sur les composants d’IBM Tivoli Service Level Advisor.
Ces regroupements de commandes sont disponibles pendant la durée de vie du
composant correspondant et peuvent être obtenus à l’aide des commandes scmd
list et scmd help.
Chapitre 1. Présentation de l’interface de ligne de commande 7
Par exemple, lorsque la commande scmd list est émise (en partant du principe que
la protection par mot de passe est désactivée), le résultat qui s’affiche est similaire
à l’exemple suivant :
>scmd list
Syntaxe :
scmd list
scmd help
scmd –p <mot_de_passe> setPassword <nouveau_mot_de_passe>
scmd –p <mot_de_passe> setPasswordEnabled { true | false }
scmd [–p <mot_de_passe>] [<nom_regroupement>] <nom_méthode> [args...]
scmd rcc <nom_méthode> [args...]
scmd escalate <nom_méthode> [args...]
scmd wdccli <nom_méthode> [args...]
scmd report <nom_méthode> [args...]
scmd log <nom_méthode> [args...]
scmd scheduler <nom_méthode> [args...]
scmd som <nom_méthode> [args...]
scmd om <nom_méthode> [args...]
scmd slm <nom_méthode> [args...]
scmd offline <nom_méthode> [args...]
scmd mem <nom_méthode> [args...]
scmd etl <nom_méthode> [args...]
scmd sdc <nom_méthode> [args...]
Remarque :
scmd help
- Fournit des informations complémentaires sur l’utilisation des commandes
scmd de base.
scmd <nom_regroupement> list
- Fournit la liste des méthodes disponibles pour le regroupement
<nom_regroupement>
Dans l’exemple de sortie ci-dessus, rcc, slm, sdc et d’autres commandes représentent
la liste des noms de regroupement de commandes disponibles qui peuvent être
utilisés dans d’autres commandes CLI. Par exemple, la commande scmd rcc list
renvoie une liste des méthodes disponibles dans le regroupement rcc, comme dans
l’exemple suivant :
>scmd rcc list
Syntaxe :
scmd rcc help
scmd rcc list
scmd rcc getPort
scmd rcc setPort <port>
Remarque :
scmd rcc help
Fournit des informations complémentaires sur l’utilisation des commandes rcc.
Dans l’exemple ci-dessus, help, list, getPort et setPort sont les méthodes disponibles
dans le regroupement rcc.
Le tableau 2 à la page 9 contient la liste des noms de regroupements disponibles à
utiliser avec scmd, ainsi que leurs fonctionnalités respectives.
8 IBM Tivoli Service Level Advisor - Guide des commandes
Tableau 2. Noms de regroupements disponibles et fonctionnalités respectives
Nom du
regroupement Fonction
(nom de
regroupement
non indiqué)
Informations et configuration du service CLI. Le service CLI est le jeu de
commandes par défaut et ne comporte pas de nom de regroupement.
escalate Fonctions de configuration et de dépannage pour la notification
d’événements.
etl Informations et configuration des processus d’extraction, de
transformation et de chargement ETL et extraction des données
d’enregistrement de la base de données SLM.
log Configuration de la consignation de trace et de la journalisation de
messages, y compris les gestionnaires et les filtres.
mem Informations et configuration des commandes client.
offline Fonctions diverses : affichage de la liste des noms de ressources dans les
contrats SLA, mises à niveau de type de composant et création/mise à
jour d’offre au format XML
om Reprise suite à un incident de traitement de commandes client
rcc Configuration du port de communication éloigné utilisé par le serveur
SLM pour communiquer avec le serveur d’administration SLM.
report Configuration des utilisateurs de rapports Web
scheduler Configuration du calendrier des évaluations et de l’analyse des tendances
sdc Fournit des informations sur les objets de gestion stockés dans la base de
données SLM.
slm Informations d’état et contrôle du serveur SLM et des composants d’IBM
Tivoli Service Level Advisor.
som Fournit des fonctions permettant d’exporter des propriétés des clients,
domaines, calendriers, offres et contrats SLA existants vers des fichiers
texte dans lesquels ils peuvent être modifiés pour créer des objets
similaires sans l’aide de la console d’administration SLM.
wdccli Informations d’état et fonctions de configuration et de test pour
l’interface de collecte de données avec la base de données Tivoli Data
Warehouse.
Les autres chapitres du présent document contiennent plus de détails sur chacune
des commandes CLI scmd et sur les commandes utilitaires de service non CLI
mises à votre disposition. Pour consulter d’autre exemples d’utilisation de
commandes CLI, reportez-vous au Guide d’administration et à d’autres documents
de la bibliothèque du produit.
Chapitre 1. Présentation de l’interface de ligne de commande 9
10 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 2. Commandes de service CLI
La présente section décrit les commandes CLI générales que vous pouvez utiliser
pour le service CLI, telles qu’elles sont présentées dans le tableau 3.
Tableau 3. Commandes CLI générales
Commande CLI Page
scmd help 12
scmd list 14
scmd setPassword 16
scmd setPasswordEnabled 18
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis, sauf dans le cas des
commandes scmd setPasswordEnabled et scmd setPassword qui
nécessitent systématiquement un mot de passe.
© Copyright IBM Corp. 2002, 2004 11
scmd help
Renvoie l’écran d’aide contenant des informations relatives à l’utilisation de la
commande scmd.
Syntaxe
scmd help
Description
Fournit une description de la syntaxe et des arguments de la commande scmd,
ainsi que des exemples d’utilisation de la commande dans l’interface de ligne de
commande. Si le service CLI est accessible, scmd help renvoie des informations sur
les regroupements de commandes CLI disponibles. La sortie s’affiche sous forme
de syntaxe, o- les regroupements de commandes CLI disponibles remplacent
l’argument <nom_regroupement> suivant :
scmd <nom_regroupement> <nom_méthode> [args...]
Dans l’exemple de sortie suivant, les noms de regroupements disponibles sont rcc,
report, escalate, wdccli, log, scheduler, om, som, slm, offline, mem, sdc et etl :
Syntaxe :
scmd list
scmd help
scmd -p <mot_de_passe> setPassword <nouveau_mot_de_passe>
scmd -p <mot_de_passe> setPasswordEnabled {true|false}
scmd [-p <mot_de_passe> [<nom_regroupement>] <nom_méthode> [args...]
scmd rcc <nom_méthode> [args...]
scmd escalate <nom_méthode> [args...]
scmd wdccli <nom_méthode> [args...]
scmd report <nom_méthode> [args...]
scmd log <nom_méthode> [args...]
scmd scheduler <nom_méthode> [args...]
scmd om <nom_méthode> [args...]
scmd som <nom_méthode> [args...]
scmd offline <nom_méthode> [args...]
scmd slm <nom_méthode> [args...]
scmd mem <nom_méthode> [args...]
scmd sdc <nom_méthode> [args...]
scmd etl <nom_méthode> [args...]
O- :
help Affiche cet écran d’aide.
list Affiche la liste des <noms_regroupements> disponibles.
setPassword Modifie le mot de passe servant à accéder au service d’interface
de ligne de commande (CLI).
Pour le modifier, vous devez indiquer le mot de passe existant.
setPasswordEnabled
Active ou désactive l’obligation d’entrer le mot de passe.
Vous devez indiquer le mot de passe existant.
<nom_regroupement>
Indique le regroupement CLI sur lequel appeler la méthode
<nom_méthode>.
Utilisez la commande scmd <nom_regroupement> list pour afficher
la liste des méthodes disponibles
12 IBM Tivoli Service Level Advisor - Guide des commandes
pour <nom_regroupement>.
O- <nom_regroupement> peut comporter une des valeurs suivantes :
rcc, sla, escalate, wdccli, log, scheduler,
om, som, slm, offline, mem, sdc, etl.
<nom_méthode> Méthode à appeler sur <nom_regroupement>.
<mot_de_passe> Indique le mot de passe requis pour le traitement
de cette commande scmd.
Obligatoire si l’attribut passwordEnabled a pour valeur true.
[args...] Indique un argument appliqué à une méthode donnée.
L’obligation d’utiliser cet attribut est fonction de la méthode
utilisée.
Utilisez la commande scmd <nom_regroupement> help pour obtenir
plus d’informations.
Exemples :
scmd slm list Renvoie la liste des méthodes disponibles pour le regroupement SLM.
scmd slm help Renvoie des informations détaillées sur l’utilisation des méthodes
des regroupements SLM.
scmd -p motdepasse_en_cours setPassword nouveau_motdepasse
Remplace le mot de passe CLI en cours ’motdepasse_en_cours’ par
le nouveau mot de passe ’nouveau_motdepasse’.
La commande scmd <nom_regroupement> list ou scmd <nom_regroupement> help
permet de déterminer les méthodes accessibles à l’aide de chaque regroupement
CLI. Dans l’exemple ci-dessus, scmd rcc list renvoie la liste des méthodes et la
syntaxe correspondant au regroupement rcc.
Si le service CLI est inaccessible, les arguments <nom_regroupement> disponibles ne
peuvent pas être déterminés et l’écran d’aide générale s’affiche au format suivant :
scmd [<nom_regroupement>] <nom_méthode> [args...]
Options
Aucune option n’est disponible pour cette commande.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Voir aussi
scmd<nom_regroupement> help, o- <nom_regroupement> représente un nom de
commande scmd, par exemple, mem ou sdc.
scmd list
Chapitre 2. Commandes de service CLI 13
scmd list
Renvoie des informations relatives à la syntaxe de la commande scmd, y compris
les regroupements CLI actuellement disponibles.
Syntaxe
scmd list
Description
Cette commande renvoie la liste de tous les regroupements CLI qui sont
actuellement disponibles. Si le service CLI est inaccessible, la sortie s’affiche sous
forme de syntaxe, o- les regroupements CLI disponibles remplacent l’argument
<nom_regroupement> au format de commande suivant :
scmd <nom_regroupement> <nom_méthode> [args...]
Dans l’exemple suivant, les noms de regroupement disponibles sont rcc, report,
escalate, wdccli, log, scheduler, om, som, slm, offline, mem, sdc et etl :
Syntaxe :
scmd list
scmd help
scmd -p <mot_de_passe> setPassword <nouveau_mot_de_passe>
scmd -p <mot_de_passe> setPasswordEnabled {true|false}
scmd [-p <mot_de_passe> [<nom_regroupement>] <nom_méthode> [args...]
scmd rcc <nom_méthode> [args...]
scmd report <nom_méthode> [args...]
scmd escalate <nom_méthode> [args...]
scmd wdccli <nom_méthode> [args...]
scmd log <nom_méthode> [args...]
scmd scheduler <nom_méthode> [args...]
scmd om <nom_méthode> [args...]
scmd som <nom_méthode> [args...]
scmd slm <nom_méthode> [args...]
scmd offline <nom_méthode> [args...]
scmd mem <nom_méthode> [args...]
scmd sdc <nom_méthode> [args...]
scmd etl <nom_méthode> [args...]
Remarque :
scmd help
- Fournit des informations supplémentaires sur l’utilisation des commandes scmd
de base.
scmd <nom_regroupement> list
- Fournit la liste des méthodes pour <nom_regroupement>.
La commande scmd <nom_regroupement> list ou scmd <nom_regroupement> help
permet de déterminer les méthodes accessibles à l’aide de chaque regroupement
CLI. Dans l’exemple ci-dessus, scmd rcc list renvoie la liste des méthodes et la
syntaxe correspondant au regroupement rcc.
Options
Aucune option n’est disponible pour cette commande.
14 IBM Tivoli Service Level Advisor - Guide des commandes
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Voir aussi
scmd<nom_regroupement>list, o- <nom_regroupement> représente un nom de
commande scmd, par exemple, mem ou sdc.
scmd help
Chapitre 2. Commandes de service CLI 15
scmd setPassword
Définit la valeur du mot de passe de service CLI.
Syntaxe
scmd –p <motdepasse_en_cours> setPassword <nouveau_motdepasse>
Description
Définit la valeur du mot de passe de service CLI qui doit être indiqué à l’aide
d’autres commandes scmd si la détection de mot de passe est activée (pour plus de
détails sur l’activation et la désactivation de la protection par mot de passe, voir
«scmd setPasswordEnabled» à la page 18).
Lors de la définition d’un nouveau mot de passe, vous devez également indiquer
le mot de passe en cours pour que le nouveau mot de passe soit accepté. Si
passwordEnabled a été paramétré sur la valeur true dans la configuration, toutes
les autres commandes scmd doivent également inclure l’option – p
<motdepasse_en_cours> pour que la commande soit exécutée.
Le <nouveau_motdepasse> doit comporter entre six et seize caractères.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours utilisé par le service CLI.
Classe d’autorisation
La commande nécessite le <motdepasse_en_cours> pour que le mot de passe en
cours soit remplacé par un nouveau mot de passe.
Remarques
L’option –p <motdepasse_en_cours> est requise pour les commandes setPassword et
setPasswordEnabled, même si la protection par mot de passe est désactivée. Par
défaut, la protection par mot de passe est désactivée. Cette commande CLI peut
servir à modifier le mot de passe.
Si le mot de passe en cours est perdu ou oublié, demandez à l’administrateur IBM
Tivoli Service Level Advisor d’extraire ou de réinitialiser le mot de passe de service
CLI.
Valeurs de retour
Si le mot de passe a correctement été défini, le message suivant est renvoyé :
DYKAL2040I Le mot de passe CLI a été modifié.
Si le mot de passe en cours qui est fourni par –p est incorrect, le message suivant
est renvoyé :
DYKAL2004E Le mot de passe entré est incorrect.
Le mot de passe CLI est requis pour que la méthode setPassword soit appliquée.
Si la longueur du mot de passe fourni par l’option –p n’est pas comprise dans la
plage admissible de 6 à 16 caractères, le message suivant est renvoyé :
DYKAL2039E Le mot de passe entré n’est pas valide. Les mots de passe CLI
16 IBM Tivoli Service Level Advisor - Guide des commandes
doivent comporter entre 6 et 16 caractères. Le mot de passe n’a pas été modifié.
Exemples
1. Dans l’exemple suivant, le mot de passe en cours abcdefg est remplacé par
z1y2x3w4 :
scmd –p abcdefg setPassword z1y2x3w4
2. L’exemple suivant illustre le message qui est renvoyé lorsqu’un mot de passe
en cours non valide est indiqué :
scmd –p wrongPassword setPassword z1y2x3w4
DYKAL2004E Le mot de passe entré est incorrect.
3. L’exemple suivant illustre le message qui est renvoyé lorsque le nouveau mot
de passe indiqué comporte moins de six caractères ou plus de seize caractères :
scmd –p motdepasse_en_cours setPassword abc
DYKAL2039E Le mot de passe entré n’est pas valide.
Les mots de passe CLI doivent comporter entre 6 et 16 caractères.
Le mot de passe n’a pas été modifié.
Voir aussi
scmd setPasswordEnabled
Chapitre 2. Commandes de service CLI 17
scmd setPasswordEnabled
Active ou désactive la protection par mot de passe pour les commandes scmd du
service CLI.
Syntaxe
scmd –p <motdepasse_en_cours> setPasswordEnabled {true | false}
Description
Cette commande affecte au paramètre passwordEnabled du service CLI la valeur
true (protection par mot de passe activée) ou la valeur false (protection par mot de
passe désactivée). Si la protection par mot de passe est activée, vous devez
indiquer l’option –p <motdepasse_en_cours> avec d’autres commandes CLI scmd
pour que celles-ci soit exécutées.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours utilisé par le service CLI. Le mot
de passe est défini à l’aide de la commande scmd setPassword.
Classe d’autorisation
La commande nécessite <motdepasse_en_cours> pour que le mot de passe en cours
soit remplacé par un nouveau mot de passe.
Remarques
L’option –p <motdepasse_en_cours> est requise pour les commandes setPassword et
setPasswordEnabled, même si la protection par mot de passe est désactivée.
Si la protection par mot de passe n’a pas été activée lors de l’installation d’IBM
Tivoli Service Level Advisor, elle est désactivée par défaut.
Valeurs de retour
Si une valeur autre que true ou false est indiquée, le message suivant est renvoyé :
DYKAL2026E L’entrée valeur n’est pas valide. Cette opération requiert
une valeur true ou false.
Syntaxe :
scmd -p <mot_de_passe> setPasswordEnabled {true|false}
Si la commande aboutit, un des messages suivants est renvoyé :
DYKAL2041I Le mot de passe CLI a été activé.
DYKAL2042I Le mot de passe CLI a été désactivé.
Exemples
1. Dans cet exemple, la protection par mot de passe est activée :
scmd –p <motdepasse> setPasswordEnabled true
2. Dans cet exemple, la protection par mot de passe est désactivée :
scmd –p <motdepasse> setPasswordEnabled false
3. Cet exemple présente le message d’erreur qui est renvoyé si la valeur true ou
false n’est pas indiquée :
scmd –p <motdepasse> setPasswordEnabled tru
18 IBM Tivoli Service Level Advisor - Guide des commandes
DYKAL2026E L’entrée tru n’est pas valide. Cette opération requiert
une valeur true ou false.
Syntaxe :
scmd -p <mot_de_passe> setPasswordEnabled {true|false}
Voir aussi
scmd setPassword
Chapitre 2. Commandes de service CLI 19
20 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 3. Commandes de processus ETL
La présente section décrit les commandes CLI (interface de ligne de commande)
qui vous aident à gérer le type de données extraites de Tivoli Data Warehouse et
chargées dans la base de données SLM et le magasin de données d’application
SLM par les processus d’extraction, de transformation et de chargement (ETL). Les
commandes disponibles sont répertoriées dans le tableau 4 :
Tableau 4. Commandes CLI pour les processus ETL
Commande CLI Page
scmd etl addApplicationData 22
scmd etl disable 24
scmd etl enable 26
scmd etl getApps 28
scmd etl getDataExpiration 29
scmd etl getDMVersion 31
scmd etl getIDInfo 32
scmd etl getMMVersion 35
scmd etl help 36
scmd etl list 37
scmd etl setDataExpiration 38
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 21
scmd etl addApplicationData
Ajoute l’application identifiée à l’environnement SLM et l’active à des fins
d’utilisation avec IBM Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl addApplicationData <code_source_mesure>
″<nom_application>″ [ETLOLDDATA]
Description
La commande scmd etl addApplicationData ajoute l’application identifiée à
l’environnement SLM et permet le transfert de ses données de la base de données
Tivoli Data Warehouse vers la base de données SLM et le magasin de données
SLM Measurement à des fins d’utilisation avec IBM Tivoli Service Level Advisor.
Remarque : Pour déterminer le code source de mesure d’une application que vous
souhaitez ajouter à l’environnement SLM, reportez-vous au document
Installation, Interface, and Usage Guide for Tivoli Data Warehouse de
l’application concernée, qui se trouve dans le répertoire \doc du
support d’installation d’application, par exemple :
/tedw_apps/apf/install/v210/doc/TAPM_for_TEDW.pdf
Dans ce document, recherchez la colonne MSrc_Cd du tableau MSrc
(source de mesure). Le code source de mesure de l’application est
enregistré dans cette colonne.
Vous pouvez, le cas échéant, choisir d’extraire d’anciennes données de mesure qui
ont déjà été enregistrées dans l’entrepôt de données central de cette application
source (jusqu’au délai d’expiration de purge configuré) et les transférer vers le
magasin de données SLM Measurement lors de la prochaine exécution du
processus ETL.
Pour savoir comment répertorier les codes de mesure des applications source qui
ont déjà été ajoutées à l’environnement SLM, voir «scmd etl getApps» à la page 28.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<code_source_mesure>
Indique le code source de mesure de l’application source à ajouter,
par exemple, BWM pour Tivoli Web Services Manager.
<nom_application>
Indique le nom de l’application à ajouter à l’environnement SLM,
par exemple, Tivoli Web Services Manager.
ETLOLDDATA
Configure le processus ETL pour extraire d’anciennes données de
mesure de l’entrepôt de données central de cette application
(jusqu’au délai d’expiration de purge configuré) lors de la
prochaine exécution du processus ETL. Ce dernier réinitialise
automatiquement l’indicateur à la fin de l’exécution, de sorte que
22 IBM Tivoli Service Level Advisor - Guide des commandes
les anciennes données ne soient pas extraites de nouveau lors
d’exécutions ultérieures du processus ETL.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Ajoutez l’application source, XYZ Warehouse Application à l’environnement SLM,
puis activez-la de sorte que les données de cette application soient transférées
de la base de données Tivoli Data Warehouse vers la base de données SLM et
le magasin de données SLM Measurement. La documentation de l’application
indique XYZ pour le code source de mesure.
scmd etl addApplicationData XYZ "XYZ Warehouse Application"
2. Ajoutez l’application source, OmniBank Transaction Processor à l’environnement
SLM, puis activez-la de sorte que les données de cette application soient
transférées de la base de données Tivoli Data Warehouse vers la base de
données SLM et le magasin de données SLM Measurement. La documentation
de l’application indique OMN pour le code source de mesure. Configurez
également le processus ETL de sorte que toutes les données de mesure
précédemment stockées de cette application soient transférées de l’entrepôt de
données central vers les bases de données SLM.
scmd etl addApplicationData OMN "OmniBank Transaction Processor" ETLOLDDATA
Voir aussi
scmd etl enable, scmd etl disable, scmd etl getApps
Chapitre 3. Commandes de processus ETL 23
scmd etl disable
Empêche que les données de l’application source indiquée soient transférées de la
base de données Tivoli Data Warehouse vers la base de données (dyk_cat) et le
magasin de données SLM Measurement (dyk_dm).
Syntaxe
scmd [–p <motdepasse_en_cours>] etl disable <code_source_mesure> [LIST]
Description
La commande scmd etl disable empêche que les données non souhaitées soient
transférées de la base de données Tivoli Data Warehouse vers la base de données
SLM et le magasin de données SLM Measurement, afin de minimiser la quantité de
données transférées. Vous pouvez indiquer le nom du code source de mesure pour
désactiver l’application source et, lors d’exécutions ultérieures de l’ETL
d’enregistrement et du processus ETL, pour empêcher le transfert des données de
cette application source vers IBM Tivoli Service Level Advisor. La valeur de
l’indicateur associé du filtre d’extraction est remplacée par N, ce qui signifie Non.
Cette commande supprime également toutes les données existantes qui ont été
enregistrées pour l’application source indiquée, tant qu’aucune offre de service ou
aucun contrat en attente n’est associé à l’application source spécifiée. Si vous tentez
de désactiver une application source et que des offres ou des contrats SLA
existants ont été créés à l’aide des données associées à cette application, un
message d’erreur s’affiche. Vous devez ensuite relancer la commande scmd etl
disable à l’aide du paramètre LIST, afin de déterminer les offres et les contrats
SLA qui sont associés à l’application source indiquée.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<code_source_mesure>
Indique le nom de code de l’application source à bloquer. Vous
pouvez utiliser la commande scmd etl getApps pour afficher la
liste des applications dans le filtre et les codes source de mesure
qui leur sont associés.
LIST Affiche la liste de toutes les offres et tous les contrats SLA qui sont
dépendants des données associées à l’application source indiquée.
L’utilisation du paramètre LIST ne désactive pas l’application. Si
des offres ou des contrats SLA sont répertoriés pour une
application source que vous souhaitez désactiver, utilisez la console
d’administration SLM pour annuler et ensuite retirer des contrats
SLA existants, puis supprimez les offres sur lesquelles les contrats
SLA ont été fondés. Relancez ensuite la commande scmd etl
disable pour désactiver l’application source.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
24 IBM Tivoli Service Level Advisor - Guide des commandes
Remarques
Toutes les applications source sont désactivées par défaut. Utilisez la commande
scmd etl enable pour activer les applications source à utiliser avec IBM Tivoli
Service Level Advisor avant d’exécuter l’ETL d’enregistrement ou le processus
ETL.
Exemples
1. Bloquez le transfert des données de Tivoli Web Services Manager de l’entrepôt
de données central Tivoli Data Warehouse vers IBM Tivoli Service Level
Advisor.
scmd etl disable BWM
Voir aussi
scmd etl enable, scmd etl getApps, scmd etl addApplicationData
Chapitre 3. Commandes de processus ETL 25
scmd etl enable
Permet le transfert des données de l’application source indiquée de la base de
données Tivoli Data Warehouse vers la base de données (dyk_cat) et le magasin de
données SLM Measurement (dyk_dm).
Syntaxe
scmd [–p <motdepasse_en_cours>] etl enable <code_source_mesure> [ETLOLDDATA]
Description
La commande scmd etl enable permet le transfert des données associées à une
application source particulière à partir de l’entrepôt de données central Tivoli Data
Warehouse vers la base de données SLM et le magasin de données SLM
Measurement. Vous pouvez indiquer le nom de code de l’application source à
activer et, lors d’exécutions ultérieures de l’ETL d’enregistrement et du processus
ETL, pour permettre le transfert des données de cette application source à des fins
d’évaluation par IBM Tivoli Service Level Advisor. La valeur de l’indicateur associé
du filtre d’extraction est remplacée par Y, ce qui signifie Oui.
Vous pouvez, le cas échéant, choisir d’extraire d’anciennes données de mesure qui
ont déjà été enregistrées dans l’entrepôt de données central de cette application
source (jusqu’au délai d’expiration de purge configuré) et les transférer vers le
magasin de données SLM Measurement lors de la prochaine exécution du
processus ETL.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<code_source_mesure>
Indique le code source de mesure de l’application source à activer.
Vous pouvez utiliser la commande scmd etl getApps pour afficher
la liste des applications source qui ont déjà été activées ainsi que
les codes source de mesure qui leur sont associés.
ETLOLDDATA
Configure le processus ETL pour extraire d’anciennes données de
mesure de l’entrepôt de données central de cette application
(jusqu’au délai d’expiration de purge configuré) lors de la
prochaine exécution du processus ETL. Ce dernier réinitialise
automatiquement l’indicateur à la fin de l’exécution, de sorte que
les anciennes données ne soient pas extraites de nouveau lors
d’exécutions ultérieures du processus ETL.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Toutes les applications source sont désactivées par défaut. Utilisez la commande
scmd etl enable pour activer les applications source à utiliser avec IBM Tivoli
Service Level Advisor avant d’exécuter l’ETL d’enregistrement ou le processus
ETL.
26 IBM Tivoli Service Level Advisor - Guide des commandes
Exemples
1. Activez le transfert des données de Tivoli Web Services Manager (code source
de mesure : BWM) à partir de l’entrepôt de données central vers la base de
données SLM (dyk_cat) et le magasin de données SLM Measurement (dyk_dm).
scmd etl enable BWM
2. Activez le transfert des données de Tivoli Business System Manager (code
source de mesure : GTM) à partir de l’entrepôt de données central vers la base
de données SLM et le magasin de données SLM Measurement, puis configurez
le processus ETL de sorte que toutes les données de mesure précédemment
stockées pour Tivoli Business System Manager soient transférées de l’entrepôt
de données central vers le magasin de données SLM Measurement.
scmd etl enable GTM ETLOLDDATA
Voir aussi
scmd etl disable, scmd etl getApps, scmd etl addApplicationData
Chapitre 3. Commandes de processus ETL 27
scmd etl getApps
Renvoie la liste des applications qui sont enregistrées par leur code source de
mesure et indique également si l’application source est activée ou désactivée.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl getApps
Description
La commande scmd etl getApps renvoie la liste des applications qui sont
enregistrées par leur code source de mesure et indique également si l’application
source est activée ou désactivée.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez la liste des applications source qui ont été enregistrées.
scmd etl getApps
Pour chaque application source enregistrée, la sortie affichée est similaire à
l’exemple suivant :
Code source mesure : BWM
Nom d’application : Tivoli Web Services Manager
Indicateur : Y
Le paramètre Indicateur : Y indique que cette application source est activée.
Voir aussi
scmd etl disable, scmd etl enable, scmd etl addApplicationData
28 IBM Tivoli Service Level Advisor - Guide des commandes
scmd etl getDataExpiration
Renvoie le délai, en nombre de jours, pendant lequel les données standard et à
long terme peuvent résider dans le magasin de données SLM Measurement
(dyk_dm) avant qu’elles soient supprimées.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl getDataExpiration
Description
La commande scmd etl getDataExpiration renvoie le délai, en nombre de jours,
pendant lequel les données peuvent résider dans le magasin de données SLM
Measurement avant qu’elles soient supprimées. Les données arrivées à expiration
sont supprimées de manière à conserver de l’espace dans la base de données et à
empêcher cette dernière de s’agrandir excessivement.
La commande renvoie réellement deux nombres, un pour les données standard et
un pour les données à long terme. Les données à long terme font notamment
référence aux données des mesures de gestion des incidents/modifications. Par
exemple, un ticket d’incident peut être ouvert aujourd’hui, mais il se peut que la
résolution réelle de l’incident et la fermeture du ticket d’incident prennent deux
mois. Les données de mesure liées à l’ouverture de l’incident doivent être
conservées dans la base de données tant que l’incident n’est pas fermé, de sorte
que les enregistrements de mesure d’ouverture et de fermeture puissent être
évalués conjointement afin de fournir des résultats sur les changements d’état et
sur le délai de fermeture des mesures.
L’ETL de purge est configuré de sorte qu’une distinction soit faite entre les
données de mesure standard et les données de mesure à long terme. Il supprime
les données standard lorsque celles-ci arrivent à expiration, tout en conservant les
données à long terme dans la base de données jusqu’à leur expiration.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Les données ne sont réellement purgées du magasin de données SLM
Measurement que lorsque le processus ETL de purge est exécuté. Le processus ETL
de purge doit être planifié pour être exécuté de manière récurrente, de sorte que la
taille du magasin de données SLM Measurement n’augmente pas excessivement, ce
qui risque d’avoir une incidence défavorable sur les performances du processus
ETL et du collecteur de données. Le nom du processus ETL de purge est
DYK_m15_Purge_Measurement_Datamart_Process. Pour plus d’informations sur l’ETL
de purge, reportez-vous au Guide d’initiation.
Chapitre 3. Commandes de processus ETL 29
Exemples
1. Obtenez le délai, en nombre de jours, pendant lequel les données standard et à
long terme peuvent être conservées dans le magasin de données SLM
Measurement avant qu’elles arrivent à expiration.
scmd etl getDataExpiration
La sortie est généralement similaire à l’exemple ci-dessous. Notez les deux
valeurs différentes pour le délai d’expiration des données standard et celui des
données à long terme :
DYKET1506I Les données standard sont définies pour arriver à expiration
tous les 63 jours.
Les données à long terme arrivent à expiration tous les 365 jours.
Voir aussi
scmd etl setDataExpiration
30 IBM Tivoli Service Level Advisor - Guide des commandes
scmd etl getDMVersion
Renvoie la version de schéma du magasin de données SLM Measurement
(dyk_dm).
Syntaxe
scmd [–p <motdepasse_en_cours>] etl getDMVersion
Description
La commande scmd etl getDMVersion renvoie la version de schéma du magasin
de données SLM Measurement (dyk_dm).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Obtenez la version de schéma du magasin de données SLM Measurement.
scmd etl getDMVersion
La sortie standard qui s’affiche est similaire à l’exemple suivant :
Version de schéma DM : 2.1.0.0
Chapitre 3. Commandes de processus ETL 31
scmd etl getIDInfo
Affiche des informations externes relatives à l’ID interne indiqué utilisé par IBM
Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl getIDInfo <ID_interne> MT | COMP
Description
Lors de l’utilisation d’IBM Tivoli Service Level Advisor pour évaluer des données
de mesure de Tivoli Data Warehouse, il est possible que des données prévues
soient manquantes, en retard, altérées ou non valides. Par exemple, il se peut que
le magasin de données SLM Measurement ne contienne pas de données pour un
type de mesure dont l’ID est 10 et pour un composant ou une ressource dont l’ID
est 100. Pour traiter ces problèmes d’intégrité de données, vous pouvez choisir de
remonter à l’entrepôt de données central de Tivoli Data Warehouse pour vérifier
que les données de mesure comportant cette combinaison de type de mesure et
d’ID composant ou ressource figurent dans la base de données.
Dans la mesure où il est possible que la configuration de Tivoli Data Warehouse
contienne un ou plusieurs entrepôts de données centraux, il est également
nécessaire de connaître l’entrepôt de données central source à partir duquel les
données ont été extraites. IBM Tivoli Service Level Advisor prend en charge
plusieurs entrepôts de données centraux au moyen de la génération d’un ID interne
pour les composants et les types de mesure, afin de distinguer les données
provenant de chaque entrepôt de données central. Même si votre entreprise ne
contient qu’un seul entrepôt de données central, IBM Tivoli Service Level Advisor
génère un ID interne. Ces ID internes sont inclus dans des messages et
informations de trace qui sont générés par IBM Tivoli Service Level Advisor.
Cependant, dans la mesure où ces ID internes ne sont utiles que dans le produit
IBM Tivoli Service Level Advisor, il n’est pas possible de les utiliser pour retrouver
la trace des données de mesure dans l’entrepôt de données central d’origine. Vous
devez mapper ces ID internes vers leur ID externe (ou ID d’origine) qui identifie les
données dans l’entrepôt de données central.
La commande scmd etl getIDInfo sert à indiquer un ID interne et à obtenir l’ID
externe correspondant pour un type de mesure ou un composant ou une ressource
qui a été identifiée de façon unique dans IBM Tivoli Service Level Advisor et que
vous pouvez ensuite utiliser pour retrouver l’origine des données de mesure à
partir de Tivoli Data Warehouse.
Vous pouvez, grâce à cette commande, définir un ID interne et d’indiquer s’il s’agit
d’un ID type de mesure ou d’un ID ressource ou composant, en spécifiant l’option
MT ou COMP.
Les types de mesure correspondent aux mesures de la console d’administration
SLM pour lesquelles vous avez défini des valeurs de violation lors de la
configuration d’une offre. Les composants servent à construire les ressources qui
sont ensuite attribuées à des contrats SLA ou résolues de façon dynamique dans
l’évaluation des contrats SLA.
Par exemple, il se peut que /myhost.raleigh.ibm.com/MyAppServer/MyEJB soit une
ressource construite dans IBM Tivoli Service Level Advisor à partir de trois
enregistrements dans la table MM.COMP de la base de données SLM. Chaque
32 IBM Tivoli Service Level Advisor - Guide des commandes
partie de ce nom de ressource est représentée sous la forme d’un enregistrement
individuel dans la table MM.COMP et chaque enregistrement comporte son propre
ID composant.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_interne> ID généré par et utilisé dans IBM Tivoli Service Level Advisor
pour l’identification unique d’un type de mesure ou d’un
composant ou ressource.
MT Indique que l’ID interne indiqué est destiné à un type de mesure.
COMP Indique que l’ID interne indiqué est destiné à un composant ou à
une ressource.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez les informations d’ID externes relatives à un type de mesure dont l’ID
interne est 10 :
scmd etl getIDInfo 10 MT
Supposons que cet ID interne est mappé vers un ID interne de 20. La sortie
correspondante de cette commande s’affiche comme dans l’exemple suivant :
DYKET1523I Informations relatives à l’ID :
Type de données : type de mesure
ID SLM interne : 10
ID SLM externe : 20
ID instance CDW : 31931106
Nom de base de données CDW : TWH_CDW
Description de base de données CDW : CDW doté d’applications réparties
Le type de mesure dont l’ID interne est 10 est mappé à l’ID externe de 20 dans
l’entrepôt de données central intitulé TWH_CDW, à l’aide de l’ID instance de
31931108. Toutes ces informations permettent de localiser l’origine de ces
éléments de données, ce qui peut être difficile lorsque IBM Tivoli Service Level
Advisor extrait des données de plusieurs entrepôts de données centraux.
2. Affichez les informations d’ID externes relatives à un composant ou une
ressource dont l’ID interne est 23 :
scmd etl getIDInfo 23 COMP
Supposons que cet ID interne est mappé vers un ID interne de 100. La sortie
correspondante de cette commande s’affiche comme dans l’exemple suivant :
DYKET1523I Informations relatives à l’ID :
Type de données : Composant
ID SLM interne : 23
ID SLM externe : 100
ID instance CDW : 31931106
Nom de base de données CDW : TWH_CDW1
Description de base de données CDW : CDW doté d’applications réparties
Le type de composant dont l’ID interne est 23 est mappé à l’ID externe de 100
dans l’entrepôt de données central intitulé TWH_CDW1, à l’aide de l’ID
instance de 31931106.
Chapitre 3. Commandes de processus ETL 33
Il est à noter que les zones Nom de base de données CDW et Description de base de
données CDW ne contiennent des informations que si l’administrateur SLM (ou la
personne qui a installé le module d’intégration de données cible pour IBM Tivoli
Service Level Advisor) a exécuté le script nameCDW.bat qui est livré avec le module
d’intégration cible (situé sur le CD-ROM d’installation IBM Tivoli Service Level
Advisor dans le dossier \tedw_apps_etl\dyk\misc). Ce script permet à l’utilisateur
d’attribuer un nom et une description à chaque entrepôt de données central. Si ce
script n’est pas exécuté, les zones sont vides dans la sortie de la commande scmd
etl getIDInfo.
34 IBM Tivoli Service Level Advisor - Guide des commandes
scmd etl getMMVersion
Renvoie la version du schéma de magasin (MM) de la base de données SLM
(dyk_cat).
Syntaxe
scmd [–p <motdepasse_en_cours>] etl getMMVersion
Description
La commande scmd etl getMMVersion renvoie la version du schéma de magasin
(MM) de la base de données SLM (dyk_cat).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Obtenez la version du schéma de magasin (MM) de la base de données SLM
(dyk_cat).
scmd etl getMMVersion
La sortie standard qui s’affiche est similaire à l’exemple suivant :
Version de schéma DM : 2.1.0.0
Chapitre 3. Commandes de processus ETL 35
scmd etl help
Renvoie l’écran d’aide contenant des informations relatives à l’utilisation de la
commande scmd etl.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl help
Description
La commande scmd etl help renvoie l’écran d’aide contenant des informations
relatives à l’utilisation de la commande scmd etl.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Demandez de l’aide pour la commande scmd etl.
scmd etl help
Voir aussi
scmd help
36 IBM Tivoli Service Level Advisor - Guide des commandes
scmd etl list
Affiche des informations relatives à la commande scmd etl.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl list
Description
La commande scmd etl list affiche des informations relatives aux diverses
commandes disponibles dans le regroupement de commandes etl.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez des informations sur le regroupement de commandes etl.
scmd etl list
Voir aussi
Autres commandes scmd etl décrites dans ce chapitre.
Chapitre 3. Commandes de processus ETL 37
scmd etl setDataExpiration
Définit le délai, en nombre de jours, pendant lequel les données sont conservées
dans le magasin de données SLM Measurement avant qu’elles soient supprimées.
Syntaxe
scmd [–p <motdepasse_en_cours>] etl setDataExpiration <nombre_jours>
[LONGTERM]
Description
La commande scmd etl setDataExpiration définit le délai, en nombre de jours,
pendant lequel les données sont conservées dans le magasin de données SLM
Measurement avant qu’elles soient supprimées. Pour définir les délais d’expiration
de données, les données de l’entrepôt de données central qui sont liées aux
applications de gestion d’incidents et de modifications sont considérées comme
étant des données à long terme qui doivent être conservées dans la base de données
pendant un délai supérieur au délai habituel.
Un ticket d’incident qui a été ouvert à une date risque de ne pas être ensuite fermé
pendant des semaines ou mois. Les enregistrements de mesure relatifs à
l’ouverture du ticket d’incident doivent être conservés dans la base de données de
sorte qu’ils puissent être évalués conjointement avec les enregistrements de mesure
relatifs à la fermeture de l’incident. C’est la raison pour laquelle cette commande
sert à définir un délai d’expiration distinct pour les données standard et pour les
données à long terme.
La valeur par défaut du délai d’expiration est de 63 jours (soit deux mois plus un
jour) pour les données standard et de 365 jours pour les données à long terme.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<nombre_jours>
Indique le nombre de jours, exprimé sous la forme d’un entier,
pendant lequel les données sont conservées dans le magasin de
données SLM Measurement avant expiration.
LONGTERM Signifie que le nombre de jours indiqué s’applique au délai
d’expiration de données à long terme. Si cet argument n’est pas
indiqué, le nombre de jours s’applique au délai d’expiration de
données standard.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Les données ne sont réellement purgées du magasin de données SLM
Measurement que lorsque le processus ETL de purge est exécuté. Le processus ETL
de purge doit être planifié pour être exécuté de manière récurrente, de sorte que la
taille du magasin de données SLM Measurement n’augmente pas excessivement, ce
qui risque d’avoir une incidence défavorable sur les performances du processus
38 IBM Tivoli Service Level Advisor - Guide des commandes
ETL et du collecteur de données. Le nom du processus ETL de purge est
DYK_m15_Purge_Measurement_Datamart_Process. Pour plus d’informations sur l’ETL
de purge, reportez-vous au Guide d’initiation.
Exemples
1. Paramétrez le délai d’expiration des données standard du magasin de données
SLM Measurement sur 45 jours.
scmd etl setDataExpiration 45
2. Paramétrez le délai d’expiration à long terme des données de gestion
d’incidents/modifications du magasin de données SLM Measurement sur 320
jours.
scmd etl setDataExpiration 320 LONGTERM
Voir aussi
scmd etl getDataExpiration
Chapitre 3. Commandes de processus ETL 39
40 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 4. Commandes de transmission
La présente section décrit les commandes CLI (interface de ligne de commande)
liées à la transmission des événements notifiant au personnel d’assistance les
violations, les tendances à des violations, les annulations des tendances et les
incidents au niveau de l’application. Les commandes disponibles sont répertoriées
dans le tableau 5.
Tableau 5. Commandes CLI de transmission
Commande CLI Page
scmd escalate checkCache 42
scmd escalate customize 44
scmd escalate disable 48
scmd escalate enable 49
scmd escalate help 52
scmd escalate list 53
scmd escalate parentSLAsEscalation 54
scmd escalate setCacheSize 56
scmd escalate snmp FormatDateTime 57
scmd escalate TECLogging 58
scmd escalate test 59
scmd escalate update email 60
scmd escalate view 62
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 41
scmd escalate checkCache
Recherche tous les événements Tivoli Enterprise Console provisoirement stockés
sur le disque en raison d’un précédent incident survenu lors d’une transmission au
serveur Tivoli Enterprise Console.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate checkCache
Description
La commande scmd escalate checkCache permet de rechercher tous les
événements enregistrés sur le disque en raison d’un précédent incident survenu
lors d’une transmission au serveur Tivoli Enterprise Console. S’il existe un serveur
Tivoli Enterprise Console défaillant, le fait d’exécuter cette commande indique si
des événements sont en attente de transmission. Cette commande n’est utile que
lorsque la méthode de transmission et de notification d’événements Tivoli
Enterprise Console est utilisée.
Vous pouvez être amené à utiliser cette commande si vous effectuez une
maintenance au niveau du serveur Tivoli Enterprise Console ou si le message
suivant apparaît dans le journal des messages :
DYKSL1102E Une erreur a eu lieu lors du transfert de l’événement
Tivoli Enterprise Console vers le serveur Tivoli Enterprise Console.
Si la mémoire cache ne contient pas d’événements, le message suivant s’affiche :
Aucun événement n’a été mis en mémoire cache. L’envoi des événements au serveur
ne nécessite aucune action.
Si la mémoire cache contient des événements, le message suivant s’affiche :
Des événements sont mis en mémoire cache. Ces événements sont
automatiquement envoyés de la mémoire cache lors du
rétablissement de la connexion au serveur Tivoli Enterprise Console.
Les événements sont automatiquement envoyés de la mémoire cache lors du
rétablissement de la connexion au serveur Tivoli Enterprise Console. Si aucun
événement n’est reçu sur le serveur Tivoli Enterprise Console, la commande
checkCache doit être exécutée. Si la mémoire cache s’agrandit, vérifiez que le
serveur Tivoli Enterprise Console indiqué dans le fichier de configuration est
disponible.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être utilisée que pour la reprise sur incident.
42 IBM Tivoli Service Level Advisor - Guide des commandes
Exemples
Recherchez tous les événements Tivoli Enterprise Console enregistrés sur le disque.
scmd escalate checkCache
Voir aussi
Chapitre 4. Commandes de transmission 43
scmd escalate customize
Personnalise des messages électroniques et des lignes objet pour la notification par
courrier électronique des événements de type violation, tendance et annulation des
tendances.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate customize email –subject {default |
″<objet>″}
scmd [–p <motdepasse_en_cours>] escalate customize email –event {cancelled |
trend | violation } –content { default | ″<message>″}
scmd [–p <motdepasse_en_cours>] escalate customize email –reportLink enable
–server <serveur_rapports> [–port <port_serveur_rapports>] [–page
<nom_page_rapport>]
scmd [–p <motdepasse_en_cours>] escalate customize email –reportLink disable
Description
La commande scmd escalate customize sert à indiquer la ligne objet et le contenu
des messages électroniques qui sont envoyés par suite de la transmission des
événements de violation, de tendance et d’annulation de tendance. Vous pouvez
envoyer un message par défaut ou vous pouvez définir votre propre message.
Vous pouvez également configurer le lien HTML permettant d’accéder aux détails
de rapport à partir du message électronique.
Définition de l’objet
Si vous sélectionnez l’option d’objet default au lieu de définir votre propre texte
d’objet, la ligne objet par défaut suivante est utilisée :
SLO $EventType
L’objet (objet par défaut ou objet défini par vous-même) peut contenir le mot clé
suivant qui est remplacé par sa valeur réelle lors de la génération de l’événement :
$EventType
Nom du type d’événement. Le type d’événement correspond à une des
chaînes suivantes :
v Violation
v Tendance
v Tendance annulée
Définition du message
Si vous sélectionnez l’option de message default au lieu de définir votre propre
texte de message, le texte de message par défaut suivant est utilisé :
Remarque : Les variables de substitution sont précédées des caractères $ et des
caractères \n sont inclus de sorte qu’une nouvelle ligne soit générée.
Violation
NOTE : une violation de mesure a été détectée. Les détails sont les
suivants : \n\nNom du client : $CustomerName \nID contrat SLA :
$SLAId \nNom SLA : $SLAName \nAutres SLA concernés :
$AffectedSLAs \nEtat du calendrier : $ScheduleState \nRessource :
44 IBM Tivoli Service Level Advisor - Guide des commandes
$ComponentName \nMesure dépassée : $MetricName \nUnités : $Units
\nDate de fin de l’évaluation : $ViolationEndDate \nDétails de la violation
:\n$ViolationDetail
Tendance
NOTE : Un risque de violation de mesure a été détecté. Les détails sont les
suivants :\n\nNom du client : $CustomerName \nID contrat SLA :
$SLAId \nNom SLA : $SLAName \nAutres SLA concernés :
$AffectedSLAs \nEtat du calendrier : $ScheduleState \nRessource :
$ComponentName \nMesure risquent d’être dépassée : $MetricName
\nUnités : $Units \nProjection de la tendance :\n$TrendProjectedDetail
\nPériode d’analyse : $TrendAnalysisPeriod \nNombre total d’exemples :
$TotalSamples
Tendance annulée
NOTE : Un risque de violation de mesure précédemment signalé a été
annulé. La mesure associée aux informations qui suivent ne risque plus
d’être violée : \n\nNom du client : $CustomerName \nID contrat SLA :
$SLAId \nNom SLA : $SLAName \nAutres SLA concernés :
$AffectedSLAs \nEtat du calendrier : $ScheduleState \nRessource :
$ComponentName \nNom de la mesure : $MetricName
Le message (message par défaut ou message défini par vous-même) peut contenir
les mots clés suivants qui sont remplacés par leur valeur réelle lors de la
génération de l’événement :
$AffectedSLAs
Liste des contrats SLA parent, ou les contrats SLA situés plus haut dans la
hiérarchie à niveaux, qui sont concernés par l’événement de violation, de
tendance ou de tendance annulée.
$ComponentName
Nom du composant concerné.
$CustomerName
Nom du client concerné.
$SLAId
ID contrat SLA de l’événement.
$SLAName
Nom de contrat SLA de l’événement.
$MetricName
Nom de la mesure ayant été à l’origine de l’événement.
$RealmName
Nom du domaine concerné.
$ScheduleState
Etat du calendrier d’activité.
$ServiceOfferingName
Nom de l’offre concernée.
$TrendProjectedDetail
Détails de la tendance prévue (applicable uniquement à un événement de
tendance).
$TrendAnalysisPeriod
Période de l’analyse de tendances (applicable uniquement à un événement
de tendance).
Chapitre 4. Commandes de transmission 45
$TotalSamples
Nombre total d’exemples utilisés dans l’analyse de tendances (applicable
uniquement à un événement de tendance).
$Units Unités de la mesure.
$ViolationDetail
Détails de la violation (applicable uniquement à un événement de
violation).
$ViolationEndDate
Date de fin de la violation (applicable uniquement à un événement de
violation).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–event cancelled
Indique l’événement de tendance annulée comme type
d’événement.
–event trend Indique l’événement de tendance comme type d’événement.
–event violation
Indique l’événement de violation comme type d’événement.
–subject default | ″<objet>″
Indique l’objet du courrier électronique des événements de
violation, de tendance ou de tendance annulée. Vous pouvez
indiquer l’objet par défaut ou votre propre objet.
–content default | ″<message>″
Indique le message électronique des événements de violation, de
tendance ou de tendance annulée. Vous pouvez indiquer le
message par défaut ou votre propre message.
–page [<nom_page_rapport>]
Indique le nom d’une page de rapport personnalisée. Le nom par
défaut est opCustReportDetail.jsp.
–port [<port_serveur_rapports>]
Le cas échéant, indique si le port HTTP utilisé par le serveur de
rapports HTTP.
–reportLink enable
Inclut le lien HTML permettant d’accéder aux détails de rapport
dans le courrier électronique.
–reportLink disable
Exclut le lien HTML permettant d’accéder aux détails de rapport
dans le courrier électronique.
–server <serveur_rapports>
Indique le nom complet de l’hôte sur lequel la console Rapports
SLM est installée.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
46 IBM Tivoli Service Level Advisor - Guide des commandes
Remarques
Pour UNIX, faites précéder le caractère $ d’une barre oblique inversée (″\″), de
sorte que que le nom de la variable puisse être reconnu comme variable. Par
exemple :
NOTE : une violation de mesure a été détectée. Les détails sont les suivants :
\n\nNom du client : \$CustomerName \nID contrat SLA : \$SLAId
\nEtat du calendrier : \$ScheduleState \nRessource : \$ComponentName
\nMesure dépassée : \$MetricName \nDétails de la violation :\n\$ViolationDetail
Fichiers
L’objet du courrier électronique s’ajoute dans le fichier e-mail.properties au format
suivant :
<objet_courrier_électronique>=<objet>
Le message du courrier électronique s’ajoute dans le fichier e-mail.properties au
format suivant :
<type_événement>=<message>
Exemples
1. Personnalisez la ligne objet du courrier électronique de sorte qu’elle indique
″Rapport de la société sur l’objet de niveau de service : $EventType.″
scmd escalate customize email -subject "Rapport de la société ABC sur l’objectif
de niveau de service : $EventType"
2. Indiquez la ligne objet par défaut à utiliser :
scmd escalate customize -subject default
3. Indiquez un message personnalisé pour un événement de tendance.
scmd escalate customize email -event trend -content "Attention ! Un
événement de tendance a été détecté."
4. Indique le message par défaut d’un événement de tendance annulée.
scmd escalate customize email -event cancelled -content default
5. Insérez un lien de rapport personnalisé dans le courrier électronique des
événements de violation et de tendance.
Remarque : Le nom de la page de rapport par défaut est
opCustReportDetail.jsp. Dans cet exemple, la page de rapport a été
personnalisée et nommée customizedReportDetail.jsp. Vous pouvez
indiquer ce nom via l’option –page.
scmd escalate customize email -reportLink enable -server
tslaReportServer.ibm.com -port 9080 -page customizedReportDetail.jsp
Chapitre 4. Commandes de transmission 47
scmd escalate disable
Désactive une méthode particulière pour la transmission d’événements ou
désactive la transmission des événements d’incident d’application.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate disable {email | SNMP | TEC |
applicationEvent}
Description
La commande scmd escalate disable désactive la méthode indiquée (courrier
électronique, alarme SNMP ou événements Tivoli Enterprise Console) pour la
transmission des événements de tendance, de tendance annulée ou de violation.
Cette commande désactive également la transmission des événements d’incident
d’application.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
email Indique la méthode de transmission des événements par courrier
électronique.
SNMP Indique la méthode de transmission des événements par alarme
SNMP.
TEC Indique la méthode de transmission des événements par
événement Tivoli Enterprise Console.
applicationEvent
Indique que la transmission des événements d’incident
d’application est désactivée.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Désactive la méthode de transmission par courrier électronique.
scmd escalate disable email
2. Désactive la méthode de transmission par alarme SNMP.
scmd escalate disable SNMP
3. Désactive la méthode de transmission par événement Tivoli Enterprise Console.
scmd escalate disable TEC
4. Désactive la transmission des événements d’incident d’application.
scmd escalate disable applicationEvent
Voir aussi
scmd escalate enable,, scmd escalate view
48 IBM Tivoli Service Level Advisor - Guide des commandes
scmd escalate enable
Active une méthode particulière pour la transmission d’événements ou active la
transmission des événements d’incident d’application.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate enable email –to <adresses_électroniques>
[–cc <adresses_électroniques>] –smtp <serveur_SMTP>
scmd [–p <motdepasse_en_cours>] escalate enable TEC –server <serveur> [–port
<port>] [–cacheSize <taille_fichier_en_ko>]
scmd [–p <motdepasse_en_cours>] escalate enable SNMP –dest <destination_alarme>
–port <port> [–community <nom_communauté>]
scmd [–p <motdepasse_en_cours>] escalate enable applicationEvent
Description
La commande scmd escalate enable active la méthode indiquée (courrier
électronique, événements Tivoli Enterprise Console ou alarmes SNMP) pour la
transmission des événements (tendance, tendance annulée et violation).
Cette commande active également la transmission des événements d’incident
d’application à l’aide de la méthode de transmission configurée (courrier
électronique, alarme SNMP ou événement Tivoli Enterprise Console).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–to <adresses_électroniques>
(courrier électronique uniquement) Indique l’adresse électronique
du destinataire. Pour indiquer plusieurs destinataires de courrier
électronique, insérez un espace entre chaque adresse électronique.
–cc <adresses_électroniques>
(courrier électronique uniquement) Indique l’adresse électronique
du destinataire en copie. Pour indiquer plusieurs destinataires en
copie, insérez un espace entre chaque adresse électronique.
–dest <destination_alarme>
(SNMP uniquement) Indique le nom d’hôte complet ou l’adresse IP
de la machine de destination sur laquelle s’exécute le destinataire
SNMP.
–smtp <serveur_SMTP>
(courrier électronique uniquement) Indique le nom d’hôte complet
du serveur SMTP via lequel le courrier électronique doit être
envoyé. Le système de messagerie auquel vous envoyez les
notifications par courrier électronique doit être capable de gérer les
caractères UTF-8.
Chapitre 4. Commandes de transmission 49
–server <serveur>
(Tivoli Enterprise Console uniquement) Indique le nom d’hôte
complet du serveur SMTP via lequel le courrier électronique doit
être envoyé.
–port <port> (SNMP uniquement) Indique le port de la machine réceptrice sur
laquelle les événements sont envoyés.
–community <nom_communauté>
(SNMP uniquement) Indique le nom de communauté des
événements.
–cacheSize <taille_fichier_en_ko>
(Tivoli Enterprise Console uniquement) Indique la taille maximale,
en kilooctets, du fichier pour le stockage des événements sur
disque lorsque ceux-ci ne peuvent pas être envoyés au serveur. La
valeur par défaut est 64 ko.
Remarque : Le paramètre de taille de mémoire cache est valide
pour un fichier cache qui n’existe pas déjà. Pour
modifier la taille d’un fichier cache existant, par
exemple, de 64 ko à 256 ko, vous devez effectuer les
étapes suivantes :
1. Emettez la commande : scmd escalate
setCacheSize -cachesize 256
2. Arrêtez le serveur SLM.
3. Supprimez le fichier cache existant.
4. Redémarrez le serveur SLM.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Activez la méthode de transmission d’événements par courrier électronique, en
indiquant le destinataire [email protected], le destinataire en copie
[email protected] et le serveur SMTP smtp-server.nc.rr.com.
scmd escalate enable email -to [email protected] -cc [email protected]
-smtp smtp-server.nc.rr.com
2. Activez la méthode de transmission d’événements par courrier électronique, en
indiquant la liste des destinataires [email protected] et
[email protected], ainsi que le serveur SMTP smtp-server.nc.rr.com.
scmd escalate enable email -to [email protected] [email protected]
-smtp smtp-server.nc.rr.com
3. Activez la méthode de transmission d’événements par alarme SNMP, en
indiquant la destination destABC.us.company.com et le port 162.
scmd escalate enable SNMP -to destABC.us.company.com -port 162
4. Activez la méthode de transmission d’événements par alarme SNMP, en
indiquant la destination 66.57.79.58, le port 162 et le nom de communauté
nom_communauté.
scmd escalate enable SNMP -dest 66.57.79.58 -port 162 -community nom_communauté
5. Activez la méthode de transmission des événements par événement Tivoli
Enterprise Console.
scmd escalate enable TEC
50 IBM Tivoli Service Level Advisor - Guide des commandes
6. Activez la méthode de transmission des événements par événement Tivoli
Enterprise Console, à l’aide du serveur tecserver.raleigh.tivoli.com et du port
65535.
scmd escalate enable TEC –server tecserver.raleigh.tivoli.com
-port 65535
7. Activez la transmission des événements d’incident d’application à l’aide de la
méthode configurée (courrier électronique, alarme SNMP ou événement Tivoli
Enterprise Console):
scmd escalate enable applicationEvent
Voir aussi
scmd escalate customize,, scmd escalate disable,, scmd escalate snmp
FormatDateTime,, scmd escalate view, scmd escalate update email
Chapitre 4. Commandes de transmission 51
scmd escalate help
Affiche la syntaxe et des exemples pour le regroupement de commandes scmd
escalate.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate help [–verbose]
Description
La commande scmd escalate help affiche la syntaxe, les variables, les options et
des exemples pour le regroupement de commandes scmd escalate.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–verbose Vous pouvez indiquer cette option pour obtenir des informations
d’aide complémentaires sur le regroupement de commandes.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’aide relative au regroupement de commandes escalate.
scmd escalate help
Affichez l’aide supplémentaire relative au regroupement de commandes escalate.
scmd escalate help -verbose
52 IBM Tivoli Service Level Advisor - Guide des commandes
scmd escalate list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd escalate.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate list
Description
La commande scmd escalate list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd escalate.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affiche la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd escalate.
scmd escalate list
Chapitre 4. Commandes de transmission 53
scmd escalate parentSLAsEscalation
Active ou désactive la notification d’événements Tivoli Enterprise Console pour un
contrat SLA à niveaux, lorsque la transmission d’événements Tivoli Enterprise
Console se produit pour d’autres contrats SLA inclus dans le contrat SLA à
niveaux.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate parentSLAsEscalation {true | false}
Description
La commande scmd escalate parentSLAsEscalation est spécifique aux contrats
SLA à niveaux ; en d’autres termes, les contrats de service qui ont été créés à l’aide
d’une offre qui, à son tour, inclut un ou plusieurs contrats SLA, ce qui crée un
contrat SLA dans une hiérarchie de contrats SLA. Si la transmission d’événements
Tivoli Enterprise Console est configurée pour un contrat SLA qui est inclus dans
un contrat à niveaux et qu’une tendance de violation sur ce contrat SLA inclus est
à l’origine de la transmission d’une notification, cette commande indique si la
transmission d’événements Tivoli Enterprise Console se produit également pour le
contrat SLA à niveaux.
Par défaut, cet indicateur a pour valeur false. Lorsque la transmission
d’événements Tivoli Enterprise Console est configurée et activée, cet indicateur a
pour valeur true.
Un exemple de règle Tivoli Enterprise Console, slmDropParentEvents.rls, est
fourni dans le dossier /escalate ; vous pouvez le charger sur le serveur Tivoli
Enterprise Console pour supprimer les événements de type contrat SLA à niveaux.
Ce jeu d’exemples de règles permet de supprimer les événements de violation
d’objectif de niveau de service (SLO), les événements de tendance et les
événements d’annulation de tendance relatifs aux contrats de service parents (ou aux
contrats de service de premier niveau dans une hiérarchie SLA à niveaux). Un
événement doté d’une valeur différente d’un caractère blanc dans l’emplacement
relatif au contrat SLA composant est identifié comme événement d’un contrat SLA
parent. Cette règle n’est applicable que si vous avez lancé la commande scmd
escalate parentSLAsEscalation pour activer la transmission d’événements de type
contrat SLA parent.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
true La transmission d’événements Tivoli Enterprise Console est activée
pour le contrat SLA à niveaux, lorsqu’un événement Tivoli
Enterprise Console est transmis pour un contrat SLA inclus.
false La transmission d’événements Tivoli Enterprise Console est
désactivée pour le contrat SLA à niveaux, lorsqu’un événement
Tivoli Enterprise Console est transmis pour un contrat SLA inclus.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
54 IBM Tivoli Service Level Advisor - Guide des commandes
Remarques
Cette commande ne s’applique qu’à la notification par événement Tivoli Enterprise
Console. Elle ne s’applique pas aux méthodes de notification par courrier
électronique ou par alarme SNMP.
Exemples
1. Activation de la notification pour les contrats SLA à niveaux :
scmd escalate parentSLAsEscalation true
2. Désactivation de la notification pour les contrats SLA à niveaux :
scmd escalate parentSLAsEscalation false
Chapitre 4. Commandes de transmission 55
scmd escalate setCacheSize
Indique la taille maximale, en kilooctets, du fichier pour le stockage des
événements sur disque lorsque ceux-ci ne peuvent pas être envoyés au serveur. La
valeur par défaut est 64 ko.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate setCacheSize <taille_fichier_en_ko>
Description
La commande scmd escalate setCacheSize indique la taille maximale, en
kilooctets, du fichier pour le stockage des événements sur disque, lorsque ceux-ci
ne peuvent pas être envoyés au serveur Tivoli Enterprise Console (type
d’événement Tivoli Enterprise Console uniquement). La valeur par défaut est 64
ko.
Remarque : Le paramètre de taille de mémoire cache est valide pour un fichier
cache qui n’existe pas déjà. Pour modifier la taille d’un fichier cache
existant, par exemple, de 64 ko à 256 ko, vous devez effectuer les
étapes suivantes :
1. Emettez la commande : scmd escalate setCacheSize -cachesize 256
2. Arrêtez le serveur SLM.
3. Supprimez le fichier cache existant.
4. Redémarrez le serveur SLM.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affectez la valeur de 128 ko à la taille du fichier de stockage d’événements sur
disque :
scmd escalate setCacheSize 128
56 IBM Tivoli Service Level Advisor - Guide des commandes
scmd escalate snmp FormatDateTime
Met en forme la valeur d’horodatage des alarmes SNMP de sorte que celle-ci
corresponde à une chaîne lisible.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate snmp FormatDateTime {true | false}
Description
La commande scmd escalate snmp FormatDateTime met en forme la valeur
d’horodatage des alarmes SNMP de sorte que celle-ci corresponde à une chaîne
lisible. A la place de la mise en forme de la date, telle qu’elle est indiquée dans le
document RFC2579, la date est mise en forme dans l’alarme comme une chaîne de
texte affichant la date et l’heure.
Par exemple, 15 juillet 2002 à 1:30:15 PM EDT s’affiche comme suit :
2002-07-15,13:30:15.0,-4:0
Remarque : La partie des informations, -4:0, indique le décalage par rapport à
l’heure GMT dans le fuseau horaire EDT (heure d’été de l’Est).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
true | false Active ou désactive la mise en forme de la valeur d’horodatage
SNMP.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Activez la mise en forme de la valeur d’horodatage SNMP :
scmd escalate snmp FormatDateTime true
2. Désactivez la mise en forme de la valeur d’horodatage SNMP :
scmd escalate snmp FormatDateTime false
Chapitre 4. Commandes de transmission 57
scmd escalate TECLogging
Paramètre la condition de journalisation Tivoli Enterprise Console sur true ou
false.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate TECLogging {true | false}
Description
La commande scmd escalate TECLogging active ou désactive les fonctions de trace
et de journalisation Tivoli Enterprise Console. TECLogging est initialement
paramétré sur false. TECLogging a pour valeur true uniquement pour les
opérations de débogage de la transmission d’événements Tivoli Enterprise Console.
Lorsque cette fonction est activée, les traces et journaux Tivoli Enterprise Console
sont consignés dans des fichiers TECTraces et TECLogging du dossier /SLMServer
du répertoire commun de Tivoli.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Exemples
Activation de la journalisation Tivoli Enterprise Console
scmd escalate TECLogging true
Désactivation de la journalisation Tivoli Enterprise Console
scmd escalate TECLogging false
58 IBM Tivoli Service Level Advisor - Guide des commandes
scmd escalate test
Envoie un exemple d’événement pour tester la méthode de transmission
actuellement activée.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate test
Description
La commande scmd escalate test envoie un exemple d’événement permettant de
tester la méthode de transmission activée (courrier électronique, alarmes SNMP ou
événements Tivoli Enterprise Console).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande doit être utilisée lors d’une reprise sur incident ou lors de
l’installation initiale du produit pour vérifier les paramètres de méthode de
transmission.
Exemples
Testez toutes les méthodes de transmission activées.
scmd escalate test
Chapitre 4. Commandes de transmission 59
scmd escalate update email
Met à jour quelques paramètres de configuration pour la notification d’événements
par courrier électronique.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate update email [–smtp <serveur_SMTP>]
[<–addTO | –removeTO> <adresses_électroniques>] [<–addCC |–removeCC>
<adresses_électroniques>]
Description
La commande scmd escalate update email permet de modifier les paramètres de
configuration relatifs à la transmission d’événements, à l’aide de la méthode de
notification par courrier électronique. Vous pouvez modifier les paramètres
suivants :
v Modification du nom du serveur SMTP
v Ajout d’adresses électroniques à la liste des adresses de la liste des destinataires
auxquels des notifications par courrier électronique sont envoyées
v Suppression d’adresses électroniques de la liste des adresses de la liste des
destinataires auxquels des notifications par courrier électronique sont envoyées
v Ajout d’adresses électroniques à la liste des adresses de la liste des destinataires
en copie auxquels des notifications par courrier électronique sont envoyées
v Suppression d’adresses électroniques de la liste des adresses de la liste des
destinataires en copie auxquels des notifications par courrier électronique sont
envoyées
Ces paramètres ainsi que d’autres paramètres configuration peuvent initialement
être établis lors du processus d’installation (pour plus de détails, reportez-vous au
Guide d’initiation).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–smtp <serveur_SMTP>
Indique le nom du serveur SMTP auquel des notifications par
courrier électronique adressées.
–addTO <adresses_électroniques>
Indique la liste des adresses électroniques à ajouter dans la liste
des destinataires pour la notification par courrier électronique. La
liste peut comprendre une ou plusieurs adresses électroniques,
séparées par des espaces blancs.
–removeTO <adresses_électroniques>
Indique la liste des adresses électroniques à supprimer de la liste
des destinataires pour la notification par courrier électronique. La
liste peut comprendre une ou plusieurs adresses électroniques,
séparées par des espaces blancs.
–addCC <adresses_électroniques>
Indique la liste des adresses électroniques à ajouter dans la liste
des destinataires en copie pour la notification par courrier
60 IBM Tivoli Service Level Advisor - Guide des commandes
électronique. La liste peut comprendre une ou plusieurs adresses
électroniques, séparées par des espaces blancs.
–removeCC <adresses_électroniques>
Indique la liste des adresses électroniques à supprimer de la liste
des destinataires en copie pour la notification par courrier
électronique. La liste peut comprendre une ou plusieurs adresses
électroniques, séparées par des espaces blancs.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Exemples
1. Remplacez le serveur SMTP par smtp2004.raleigh.ibm.com.
scmd escalate update email -smtp smtp2004.raleigh.ibm.com
2. Ajoutez l’adresse électronique suivante dans la liste des destinataires des
adresses électroniques pour la notification d’événements :
scmd escalate update email -addTO [email protected]
3. Ajoutez les adresses électroniques suivantes à la liste des destinataires des
adresses électroniques pour la notification d’événements :
[email protected] et [email protected]
scmd escalate update email -addTO [email protected] [email protected]
4. Ajoutez l’adresse électronique suivante dans la liste des destinataires en copie
des adresses électroniques pour la notification d’événements :
scmd escalate update email -addCC [email protected]
5. Déplacez [email protected] de la liste des destinataires vers la liste des
destinataires en copie pour la notification d’événements :
scmd escalate update email -removeTO [email protected]
-addCC [email protected]
Voir aussi
scmd escalate customize email
Chapitre 4. Commandes de transmission 61
scmd escalate view
Affiche tous les paramètres configurés et signale les méthodes de transmission qui
sont activées ou désactivées.
Syntaxe
scmd [–p <motdepasse_en_cours>] escalate view
Description
La commande scmd escalate view affiche tous les paramètres configurés des
méthodes de transmission (courrier électronique, alarme SNMP et événements
Tivoli Enterprise Console) et indique si chacune de ces méthodes est activée ou
désactivée.
scmd escalate view
Voici un exemple de sortie standard :
Le courrier électronique est activé.
Destinataires du courrier électronique [email protected],[email protected]
Destinataires en copie du courrier électronique :
Serveur SMTP de courrier électronique =serveur-smtp.ny.ca.com
Contenu du courrier électronique de violation :
Contenu du courrier électronique de tendance = La mesure $NomMesure dans l’état
$EtatCalendrier risque d’être dépassée le $DatePrévueTendance pour le client
$NomClient du contrat SLA $IDSLA. Le composant de service
qui entraînera la violation est $NomComposant.
Contenu du courrier électronique de tendance annulée :
SNMP est activé.
Destination SNMP =62.56.45.22
Port SNMP =162
Nom de communauté SNMP :
tec est activé.
serveur tec=serveur-tec.raleigh.ibm.com
port tec=65535
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les paramètres configurés des méthodes de transmission.
scmd escalate view
Voir aussi
scmd escalate customize, scmd escalate disable, scmd escalate enable
62 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 5. Commandes de journalisation et de trace
Le présent chapitre décrit les commandes CLI liées aux fonctions de journalisation
et de trace :
Tableau 6. Commandes CLI pour les fonctions de journalisation et de trace
Commande CLI Page
scmd log filter 64
scmd log handler 67
scmd log help 70
scmd log list 71
scmd log message 72
scmd log trace 75
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 63
scmd log filter
Affiche ou modifie les propriétés d’un filtre.
Syntaxe
scmd [–p <motdepasse_en_cours>] log filter {[–g <nom_groupe>]/ [<nom_objet>]}
{–keys | –get <clé> | –set <clé>=<valeur> | –contents | –list}
Description
La commande scmd log filter affiche ou modifie les propriétés d’un objet de
journalisation de filtre.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–g <nom_groupe>
Indique le nom d’un groupe d’objets filtre. Les modifications
apportées à ce groupe ont une incidence sur les propriétés de tous
les objets du groupe. Les noms de groupes font la distinction entre
les majuscules et les minuscules.
<nom_objet> Indique le nom de l’objet filtre. Les noms d’objets font la
distinction entre les majuscules et les minuscules.
–keys Affiche la liste des propriétés (clés) de l’objet filtre indiqué.
–get <clé> Extrait des informations relatives à la clé indiquée de l’objet filtre.
Les noms de clés font la distinction entre les majuscules et les
minuscules.
–set <clé>=<valeur>
Définit une nouvelle propriété pour l’objet filtre indiqué. Les noms
de clés et les valeurs indiquées font la distinction entre les
majuscules et les minuscules.
–contents Affiche la liste des paires clé=valeur du programme de
journalisation ou de gestion identifié par <nom_objet>.
–list Affiche une liste de tous les objets filtre. Si un nom de groupe est
indiqué, seuls les programmes de journalisation de filtre du groupe
s’affichent.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez une liste de tous les objets filtre :
scmd log filter -list
La sortie qui s’affiche est similaire à l’exemple suivant :
msgFilter
trcFilter
trcFilter/slmlevel3
64 IBM Tivoli Service Level Advisor - Guide des commandes
trcFilter/slmlevel2
trcFilter/slmlevel1
trcFilter/slm
La liste inclut l’objet msgFilter et le nom de groupe trcFilter. Le groupe trcFilter
est également répertorié avec les programmes de journalisation de filtre de ce
groupe, slm, slmlevel1, slmlevel2 et slmlevel3.
2. Affichez la liste des programmes de journalisation de filtre du groupe trcFilter :
scmd log filter -g trcFilter -list
La sortie qui s’affiche est similaire à l’exemple suivant :
trcFilter
trcFilter/slmlevel3
trcFilter/slmlevel2
trcFilter/slmlevel1
trcFilter/slm
3. Affichez la liste des clés du programme de journalisation de filtre msgFilter :
scmd log filter msgFilter -keys
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/filter/msgFilter :
mask
className
description
Les clés du gestionnaire msgFilter sont mask, className et description.
4. Affichez la liste des clés du programme de journalisation msgFilter, puis le
contenu de chaque clé :
scmd log filter msgFilter -contents
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/filter/msgFilter :
mask = TYPE_DEFAULT_MESSAGE
className = com.ibm.logging.AnyMaskFilter
description = filtre des messages
5. Affichez la liste des messages de trace qui sont consignés à l’aide du filtre
trcFilter/slmlevel2 :
scmd log filter trcFilter/slmlevel2 -contents
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/filter/trcFilter/slmlevel2 :
mask = TYPE_LEVEL1 TYPE_LEVEL2
Cela signifie que le filtre de trace prédéfini, trcFilter/slmlevel2, ne peut afficher
que les messages de trace TYPE_LEVEL1 et TYPE_LEVEL2. Les filtres
prédéfinis et les messages de trace qu’ils peuvent afficher sont les suivants :
trcFilter.slm
(par défaut) Permet d’afficher les messages de trace TYPE_LEVEL1
uniquement
trcFilter.slmlevel1
Permet d’afficher les messages de trace TYPE_LEVEL1 uniquement
trcFilter.slmlevel2
Permet d’afficher les messages de trace TYPE_LEVEL1 et
TYPE_LEVEL2 uniquement
Chapitre 5. Commandes de journalisation et de trace 65
trcFilter.slmlevel3
Permet d’afficher les messages de trace TYPE_LEVEL1, TYPE_LEVEL2
et TYPE_LEVEL36. Tous les programmes de journalisation d’IBM Tivoli Service Level Advisor sont
configurés de sorte que le filtre par défaut trcFilter.slm (TYPE_LEVEL1) soit
utilisé. Pour appliquer une modification à tous les programmes de
journalisation, vous pouvez modifier le masque de ce filtre.
Pour tracer les messages TYPE_LEVEL1 par défaut et les messages
TYPE_LEVEL2, émettez la commande suivante :
scmd log filter trcFilter.slm -set mask="TYPE_LEVEL1 TYPE_LEVEL2"
66 IBM Tivoli Service Level Advisor - Guide des commandes
scmd log handler
Affiche ou modifie les propriétés d’un gestionnaire.
Syntaxe
scmd [–p<motdepasse_en_cours>] log handler {[–g <nom_groupe>] | [<nom_objet>]}
{–keys | –get <clé> | –set <clé>=<valeur> | –contents | –list}
Description
La commande scmd log handler affiche ou modifie les propriétés d’un objet de
journalisation de gestionnaire.
Un des objets de journalisation de gestionnaire intéressants est le gestionnaire
eventWatcher, qui sert à surveiller les messages spécifiques émis et à générer des
événements pour ces messages. Par exemple, pour être informé chaque fois que le
message DYKME9037E est généré, vous pouvez émettre la commande suivante afin
de configurer le gestionnaire eventWatcher de sorte que celui-ci surveille ce
message :
scmd log handler eventWatcher -set escalateMessages="DYKME9037E"
La clé escalateMessages est une des clés valides du gestionnaire eventWatcher. Pour
afficher la liste des clés disponibles d’un gestionnaire, émettez une commande
similaire à l’exemple suivant :
scmd log handler <nom_gestionnaire> -keys
Pour afficher la liste des clés valides d’un gestionnaire et la valeur en cours de
chaque clé, vous pouvez émettre un commande similaire à l’exemple suivant :
scmd log handler <nom_gestionnaire> -contents
Pour répertorier la valeur d’une clé spécifique, vous pouvez émettre une
commande similaire à l’exemple suivant :
scmd log handler <nom_gestionnaire> -get <clé>
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–g <nom_groupe>
Indique le nom d’un groupe d’objets gestionnaire. Les
modifications apportées à ce groupe ont une incidence sur les
propriétés de tous les objets du groupe. Les noms de groupes font
la distinction entre les majuscules et les minuscules.
<nom_objet> Indique le nom de l’objet gestionnaire. Les noms d’objets font la
distinction entre les majuscules et les minuscules.
–keys Affiche la liste des propriétés (clés) de l’objet gestionnaire indiqué.
–get <clé> Extrait des informations relatives à la clé indiquée de l’objet
gestionnaire. Les noms de clés font la distinction entre les
majuscules et les minuscules.
Chapitre 5. Commandes de journalisation et de trace 67
–set <clé>=<valeur>
Définit une nouvelle propriété pour l’objet gestionnaire indiqué.
Les noms de clés et les valeurs font la distinction entre les
majuscules et les minuscules.
–contents Affiche la liste des paires clé=valeur de l’objet gestionnaire indiqué,
ainsi que la valeur en cours de chaque clé.
–list Affiche une liste de tous les objets gestionnaire. Si un nom de
groupe est indiqué, seuls les programmes de journalisation de
gestionnaire du groupe s’affichent.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez une liste de tous les objets gestionnaire :
scmd log handler -list
La sortie qui s’affiche est similaire à l’exemple suivant :
msgFile
msgFile/xml
msgFile/slmDetail
msgFile/slmDetailxml
msgFile/slmAuditDetail
msgFile/slmAudit
msgFile/slm
msgFile/slmAuditDetailxml
msgFile/slmAuditxml
eventWatcher
log
log/dbDelete
log/dbReader
log/dbHandler
console
logFile
serialTrcFile
serialMsgFile
trcFile
trcFile/ffdc
trcFile/xml
trcFile/slm
logServerHandler
La liste comprend des noms de groupe de gestionnaires, tels que msgFile, log et
trcFile. Chacun de ces noms de groupe est également répertorié avec les
programmes de journalisation de gestionnaire de ce groupe, par exemple, le
groupe trcFile inclut les programmes de journalisation de gestionnaire ffdc, xml
et slm. Les objets qui ne sont pas inclus dans un groupe sont également
répertoriés, par exemple, eventWatcher et console.
2. Affichez la liste des gestionnaires de journalisation du groupe trcFile :
scmd log handler -g trcFile -list
La sortie qui s’affiche est similaire à l’exemple suivant :
trcFile
trcFile/ffdc
trcFile/xml
trcFile/slm
3. Affichez la liste des clés du gestionnaire de journalisation console :
scmd log handler console -keys
68 IBM Tivoli Service Level Advisor - Guide des commandes
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/handler/console :
formatterNames
className
description
Les clés du gestionnaire console sont formatterNames, className et description.
4. Affichez la liste des clés du gestionnaire de journalisation de console, puis le
contenu de chaque clé :
scmd log handler console -contents
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/handler/console :
formatterNames = minimal
className = com.tivoli.util.logging.ConsoleHandler
description = Gestionnaire de la console
5. Le gestionnaire de journalisation par défaut intitulé console utilise un module de
formatage dont le nom de clé formatterNames a pour valeur minimal. Le module
de formatage minimal n’affiche que l’horodatage et le texte de message sur la
console. Une valeur de module de formatage de maximal est également définie
dans les paramètres de configuration par défaut. Le module de formatage
maximal affiche d’autres zones issues d’un enregistrement de journal.
Pour rattacher le module de formatage maximal au gestionnaire de console par
défaut, entrez la commande suivante :
scmd log handler console -set formatterNames=maximal
6. Affichez le contenu de la clé maxFileSize pour le programme de journalisation
de gestionnaire trcFile/slm :
scmd log handler trcFile/slm -get maxFileSize
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/handler/trcFile/slm :
maxFileSize = 5120
7. Modifiez la taille maximale (en ko) de chaque fichier journal (valeur par défaut
: 5120 ko), respectivement pour les journaux de trace et les journaux de
message :
scmd log handler trcFile/slm -set maxFileSize=2560
scmd log handler msgFile/slm -set maxFileSize=10240
8. Modifiez le nombre de fichiers journaux (valeur par défaut : 3) à utiliser pour
les journaux de trace et les journaux de message respectivement :
scmd log handler trcFile/slm -set maxFiles=5
scmd log handler msgFile/slm -set maxFiles=5
9. Configurez le gestionnaire eventWatcher de sorte qu’il surveille les messages
suivants : DYKME9064W et DYKME9037E:
scmd log handler eventWatcher -set escalateMessages="DYKME9064W DYKME9037E"
Vous pouvez afficher la liste des messages actuellement configurés pour
eventWatcher en émettant la commande suivante :
scmd log handler eventWatcher -get escalateMessages
Chapitre 5. Commandes de journalisation et de trace 69
scmd log help
Affiche la syntaxe et des exemples pour le regroupement de commandes scmd log.
Syntaxe
scmd [–p <motdepasse_en_cours>] log help
Description
La commande scmd log help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd log.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’aide relative au regroupement de commandes scmd log.
scmd log help
70 IBM Tivoli Service Level Advisor - Guide des commandes
scmd log list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd log.
Syntaxe
scmd [–p <motdepasse_en_cours>] log list
Description
La commande scmd log list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd log.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes scmd log disponibles.
scmd log list
Chapitre 5. Commandes de journalisation et de trace 71
scmd log message
Affiche ou modifie les propriétés d’un programme de journalisation de messages.
Syntaxe
scmd [–p <motdepasse_en_cours>] log message {[–g <nom_groupe>] | [<nom_objet>]}
{–keys | –get <clé> | –set <clé>=<valeur> | –contents | –list | –listactive}
Description
La commande scmd log message affiche ou modifie les propriétés d’un
programme de journalisation de messages.
Remarque : Vous ne devez pas modifier la configuration de journalisation initiale
des programmes de journalisation de messages, sauf indications
contraires fournies par le service de support client Tivoli. La
modification de cette configuration peut donner lieu à des messages
de produit importants manquants.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–g <nom_groupe>
Indique le nom d’un groupe d’objets programme de journalisation
de messages. Les modifications apportées à ce groupe ont une
incidence sur les propriétés de tous les objets du groupe. Les noms
de groupes font la distinction entre les majuscules et les
minuscules.
<nom_objet> Indique le nom de l’objet programme de journalisation de
messages. Les noms d’objets font la distinction entre les majuscules
et les minuscules.
–keys Affiche la liste des propriétés (clés) de l’objet programme de
journalisation de messages indiqué.
–get <clé> Extrait des informations relatives à la clé indiquée de l’objet
programme de journalisation de messages. Les noms de clés font la
distinction entre les majuscules et les minuscules.
–set <clé>=<valeur>
Définit une nouvelle propriété pour l’objet programme de
journalisation de messages indiqué. Les noms de clés et les valeurs
font la distinction entre les majuscules et les minuscules.
–contents Affiche la liste des paires clé=valeur de l’objet programme de
journalisation de messages indiqué.
–list Affiche une liste de tous les programmes de journalisation de
messages. Si un nom de groupe est indiqué, seuls les programmes
de journalisation de messages du groupe s’affichent.
–listactive Affiche une liste de tous les programmes de journalisation dont la
fonction de journalisation de messages est activée.
72 IBM Tivoli Service Level Advisor - Guide des commandes
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez les objets programme de journalisation de messages.
scmd log message -list
La sortie est similaire à l’exemple suivant :
dykgu
dykgu/ps
dykitk
dykau
dykau/audit
dykau/detail
dykut
dyksl
log
log/serverLogger
log/dbLogger
log/msgLogger
dykrp
detail
cfg
cfg/default
dykal
dykal/cli
dykal/cm
dykal/adapter
dykal/cfg
dykal/log
dykal/ds
dykom
dyksd
dyksd/sdml
dykme
dykme/scheduler
dyket
dylws
La liste comprend des noms de groupe de messages, tels que dykau, log et dykal.
Chacun de ces noms de groupe est également répertorié avec les programmes
de journalisation de messages de ce groupe, par exemple, le groupe dykau
inclut les programmes de journalisation audit et detail. Les objets qui ne sont
pas inclus dans un groupe sont également répertoriés, par exemple, dyksl et
dyket.
2. Affichez les programmes de journalisation de messages de l’objet message de
groupe dykal.
scmd log message -g dykal -list
La sortie qui s’affiche est similaire à l’exemple suivant :
dykal/cli
dykal/cm
dykal/adapter
dykal/cfg
dykal/log
dykal/ds
3. Affichez la liste des clés du programme de journalisation de messages dykau :
scmd log message dykau -keys
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/message/dykau :
messageFile
Chapitre 5. Commandes de journalisation et de trace 73
component
handlerNames
description
Les clés du gestionnaire dykau sont as messageFile, component, handlerNames et
description.
4. Affichez la liste des composants dont la fonction de journalisation de messages
est activée :
scmd log message -listactive
La sortie qui s’affiche est similaire à l’exemple suivant :
dykgu
dykgu/ps
dykitk
dykau
dykau/audit
dykau/detail
dykut
dyksl
log
log/serverLogger
log/dbLogger
log/msgLogger
dykrp
detail
cfg
cfg/default
dykal
dykal/cli
dykal/cm
dykal/adapter
dykal/cfg
dykal/log
dykal/ds
dykom
dyksd
dyksd/sdml
dykme
dykme/scheduler
dyket
dylws
74 IBM Tivoli Service Level Advisor - Guide des commandes
scmd log trace
Affiche ou modifie les propriétés d’un programme de journalisation de trace.
Syntaxe
scmd [–p <motdepasse_en_cours>] log trace {[–g <nom_groupe>] | [<nom_objet>]}
{–keys | –get <clé> | –set <clé>=<valeur> | –contents | –list | –listactive}
Description
La commande scmd log trace affiche ou modifie les propriétés d’un programme de
journalisation de trace.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–g <nom_groupe>
Indique le nom d’un groupe d’objets programme de journalisation
de trace. Les modifications apportées à ce groupe ont une
incidence sur les propriétés de tous les objets du groupe. Les noms
de groupes font la distinction entre les majuscules et les
minuscules.
<nom_objet> Indique le nom de l’objet programme de journalisation de trace.
Les noms d’objets font la distinction entre les majuscules et les
minuscules.
–keys Affiche la liste des propriétés (clés) de l’objet programme de
journalisation de trace indiqué.
–get <clé> Extrait des informations relatives à la clé indiquée de l’objet
programme de journalisation de trace. Les noms de clés font la
distinction entre les majuscules et les minuscules.
–set <clé>=<valeur>
Définit une nouvelle propriété pour l’objet programme de
journalisation de trace indiqué. Les noms de clés et les valeurs font
la distinction entre les majuscules et les minuscules.
–contents Affiche la liste des paires clé=valeur de l’objet programme de
journalisation de trace indiqué.
–list Affiche une liste de tous les programmes de journalisation de trace.
Si un nom de groupe est indiqué, seuls les programmes de
journalisation de trace du groupe s’affichent.
–listactive Affiche la liste des composants dont la fonction de journalisation
de trace est activée.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez tous les programmes de journalisation de trace :
scmd log trace -list
Chapitre 5. Commandes de journalisation et de trace 75
La sortie qui s’affiche est similaire à l’exemple suivant :
dykgu
dykgu/ps
dykitk
dykau
dykau/audit
dykau/detail
orb
dykut
dyksl
log
log/managerTrace
dykrp
ffdc
util
util/dirwatcher
cfg
cfg/simpleprefs
cfg/fileprefs
cfg/default
cfg/baseprefs
cfg/eventsender
cfg/coalesce
cfg/misc
cfg/persprefs
dykal
dykal/cli
dykal/cm
dykal/adapter
dykal/cfg
dykal/log
dykal/ds
dykom
dyksd
dyksd/sdml
dykme
dykme/scheduler
dyket
dylws
La liste comprend des noms de groupe de trace, tels que cfg, log et dykal.
Chacun de ces noms de groupe est également répertorié avec les programmes
de journalisation de trace de ce groupe, par exemple, le groupe dykal inclut les
programmes de journalisation de trace cli, cm, adapter, cfg, log et ds. Les objets
qui ne sont pas inclus dans un groupe sont également répertoriés, par exemple,
dykom et dyket.
2. Affichez tous les programmes de journalisation de trace du groupe dykal
uniquement :
scmd log trace -g dykal -list
3. Affichez la liste des composants dont la fonction de journalisation de trace est
activée :
scmd log trace -listactive
4. Affichez la liste des composants du groupe dykau dont la fonction de
journalisation de trace est activée :
scmd log trace -g dykau -listactive
5. Affichez toutes les clés des programmes de journalisation de trace :
scmd log trace -keys
La sortie qui s’affiche est similaire à l’exemple suivant :
com/tivoli/util.logging/trace :
filterName
76 IBM Tivoli Service Level Advisor - Guide des commandes
organization
className
isLogging
handlerNames
product
6. Affichez le contenu des clés de journalisation de trace :
scmd log trace -contents
La sortie qui s’affiche est similaire à l’exemple suivant :
com/tivoli/util/logging/trace :
filterName = trcFilter
organization = Tivoli
className = com.tivoli.util.logging.TraceLogger
isLogging = true
handlerNames = trcFile
product = DYK
7. Par défaut, les programmes de journalisation de trace sont activés lors de
l’installation du produit. Pour désactiver les programmes de journalisation de
trace, émettez la commande suivante :
scmd log trace -set isLogging=false
8. Activez la journalisation de trace pour le groupe dykau uniquement :
scmd log trace -g dykau isLogging=true
9. Tracez uniquement les messages level 1 et level 2 pour le composant dyksd :
scmd log trace -g dyksd -set filterNames=trcFilter.slmlevel2
Chapitre 5. Commandes de journalisation et de trace 77
78 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 6. Commandes du gestionnaire de l’évaluateur de
mesures
Le présent chapitre décrit les commandes CLI liées au composant Gestionnaire de
l’évaluateur de mesures d’IBM Tivoli Service Level Advisor, telles qu’elles sont
présentées dans le tableau 7.
Tableau 7. Commandes CLI du gestionnaire de l’évaluateur de mesures
Commande CLI Page
scmd mem addSingleSchedulePeriod 80
scmd mem detectMissingAvailabilityData 83
scmd mem dumpData 89
scmd mem flushEvents 93
scmd mem help 94
scmd mem list 95
scmd mem reEval 96
scmd mem removeSingleSchedulePeriod 102
scmd mem removeStoppedRetryEntries 104
scmd mem retryMissedIntervals 107
scmd mem showAllSLAIDs 109
scmd mem showHourlyFrequencyIntervals 110
scmd mem showMetricEvaluators 113
scmd mem showRetrys 117
scmd mem skipHistoricSLAs 120
scmd mem trending 121
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 79
scmd mem addSingleSchedulePeriod
Met à jour un calendrier existant en ajoutant une période pour une date future
spécifique unique.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem addSingleSchedulePeriod –name
<nom_calendrier> –date <AAAA MM JJ> [–startHour <HH>] [–endHour <HH>]
–state {1(Critique) | 2 (Heures pleines) | 3 (Principal) | 4 (Standard) | 5 (Faible impact)
| 6 (Heures creuses) | 7 (Pas de service)}
Description
La commande scmd mem addSingleSchedulePeriod vous permet de modifier un
calendrier existant en ajoutant une période pour une date unique dans le futur.
Cela peut être utile si, par exemple, vous souhaitez planifier une durée
d’immobilisation unique pour une date spécifique, pour effectuer une maintenance
non planifiée ou pour planifier des systèmes dans un état sans service pendant un
congé d’entreprise ou un autre événement. Vous pouvez également être amené à
modifier un niveau de service spécifique à une date particulière, afin de réagir à
une reprise de la bourse ou à un autre événement externe.
Lors de la planification d’une période pour une date unique, prenez considération
les informations suivantes :
v La période doit être planifiée pour une date dans le futur, ou pour la date en
cours si elle est également associée à une heure de début dans le futur
v La période doit être définie pour une date unique (les heures de début et de fin
ne peuvent pas englober minuit)
v Les paramètres d’heures de début et de fin sont facultatifs et comportent des
valeurs par défaut s’ils ne sont pas définis
v L’heure de fin de la période ne peut pas être antérieure à l’heure de début
v L’état associé à cette période de calendrier doit déjà exister dans le calendrier, à
l’exception de l’état Pas de service (–state = 7). Une valeur de violation doit
auparavant être définie pour l’état du calendrier ; cependant, l’état Pas de service
n’est associé à aucune valeur de violation.
v Pour l’option –state, les chaînes de texte qui sont associées à chaque valeur
numérique (1 à 7) sont le nom d’état traduit (dans un environnement non
anglais) ou le nom personnalisé qui a été spécifié pour l’état dans la console
d’administration SLM (reportez-vous à la tâche Personnaliser les calendriers
dans le portefeuille). Cela apparaît dans la sortie de la commande scmd mem
help correspondant à cette commande CLI. Par exemple, si Critique a été
remplacé par Faible impact, les informations d’aide relatives à cette commande
s’affichent sous forme de -state <1=Faible impact | 2=Peak,...
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–name Nom d’un calendrier existant.
80 IBM Tivoli Service Level Advisor - Guide des commandes
–date Indique une date future, ou la date en cours lorsque celle-ci est
associée à une valeur startHour future. La date doit être indiquée
au format AAAA MM JJ, par exemple, 2004 03 24.
–startHour Heure de début facultative de la période, au format HH, par
exemple, 07 ou 16. Si cette option n’est pas définie, l’heure de
début est considérée comme étant 00:00:00 à la date indiquée.
–endHour Indique une heure de fin facultative pour la période, au format
HH. A l’heure actuelle, cette heure est enregistrée comme étant 1
seconde plus tôt que l’heure indiquée. Par exemple, si une heure de
fin de 16 est indiquée, la valeur 15:59:59 est utilisée. De même, une
heure de fin de 09 est enregistrée sous forme de 08:59:59. Si cette
option n’est pas définie, l’heure de fin est considérée comme étant
23:59:59 à la date indiquée.
–state Etat de calendrier à associer à cette période. L’état du calendrier
doit déjà exister dans le calendrier à modifier. La valeur de cette
option est un entier compris entre 1 et 7, ce qui correspond aux
états par défaut disponibles suivants :
v 1 = Critique
v 2 = Heures pleines
v 3 = Principal
v 4 = Standard
v 5 = Faible impact
v 6 = Heures creuses
v 7 = Pas de service
Si vous avez personnalisé vos noms d’état de calendrier pour
utiliser d’autres noms plus adaptés à votre environnement, les
valeurs correspondantes de 1 à 7 s’appliquent toujours aux
nouveaux noms d’état. Si la commande CLI scmd mem help est
émise, l’aide relative à la syntaxe de cette commande affiche le
nom personnalisé. Si un environnement non anglais est utilisé, les
noms traduits de ces valeurs d’état s’affichent.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Ajoutez une période au calendrier intitulé MainSched pour le 17 avril 2004, puis
associez-la à l’état de calendrier existant, Heures creuses :
scmd mem addSingleSchedulePeriod -name MainSched -date 2004 04 17 -state 6
Dans cet exemple, les heures de début et de fin ne sont pas indiquées ; les
valeurs par défaut de 00:00 et 23:59 sont donc utilisées respectivement. L’option
-state a pour valeur 6, ce qui correspond à l’état de calendrier Heures creuses.
2. Ajoutez une période au calendrier intitulé Calendrier A, utilisant l’état de
calendrier existant Heures pleines, pour le 6 octobre 2005 entre 8 heures et 17
heures :
scmd mem addSingleSchedulePeriod -name "Calendrier A" -date 2005 10 06
-startHour 08 -endHour 17 -state 2
Dans cet exemple, le nom du calendrier inclut un espace ; la totalité du nom de
calendrier doit donc être placée entre guillemets. Les heures de début et de fin
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 81
de la période sont également indiquées dans cet exemple. L’heure de fin de la
période est enregistrée sous forme de 16:59:59.
Voir aussi
scmd mem removeSingleSchedulePeriod
82 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem detectMissingAvailabilityData
Indique le mode de traitement des données de disponibilité sur un système et pour
des types de composant spécifiques.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem detectMissingAvailabilityData [–enable |
–disable | –listCompTypes] [–addExclude <type_composant...>] [–removeExclude
<type_composant...>]
Description
Tivoli Data Warehouse a mis en oeuvre une modification dans la configuration
requise des ETL d’application source qui fournissent des données de disponibilité
(transition d’état). Avant la modification, il n’était pas nécessaire que les
applications source fournissent un point de données indiquant qu’une ressource est
disponible. En l’absence de point de données spécifique indiquant la disponibilité,
toutes les heures non expliquées dans un ensemble de points de données de
transition de données représentant un intervalle de temps étaient considérées
comme étant à l’état disponible.
IBM Tivoli Service Level Advisor peut effectuer une évaluation dans laquelle
l’intégralité d’une période d’évaluation, comprise entre une heure et un mois,
n’inclut aucun point de données. Dans cette situation, il en résulte de l’évaluation
que la ressource est disponible à 100% pour la totalité de la période d’évaluation.
Cependant, s’il existe réellement des transitions d’état pour une ressource qui n’est
pas disponible à 100% pendant la totalité de la période d’évaluation et que l’ETL
d’application source ne fournit pas de points de données en raison de conditions
d’erreur, ces points de données ne sont jamais disponibles pour être inclus dans
l’évaluation. En l’absence de points de données à évaluer, la ressource est signalée
comme étant disponible à 100% par IBM Tivoli Service Level Advisor. Il en résulte
des informations incorrectes dans les rapports de disponibilité.
Tivoli Data Warehouse nécessite désormais des ETL d’application source nouvelles
ou mises à jour pour fournir un point de données de transition d’état de
disponibilité dont la valeur est disponible si la ressource est dans cet état au
moment de l’exécution de l’ETL d’application source. IBM Tivoli Service Level
Advisor compte sur ce point de données de disponibilité lors de l’exécution des
évaluations, afin de faire la distinction entre un état réellement disponible et une
condition de données manquantes. Si des points de données prévus sont
manquants, IBM Tivoli Service Level Advisor émet un message d’avertissement et
la totalité de la période d’évaluation est ignorée, car le pourcentage de disponibilité
réel ne peut pas être déterminé.
Cette condition imposée par Tivoli Data Warehouse s’applique aux nouveaux ETL
d’application source ou aux nouvelles versions des ETL d’application source
existants. Les modules d’intégration de données qui ont été développés avant cette
condition sont toujours pris en charge. Cependant, IBM Tivoli Service Level
Advisor ne peut pas faire la distinction entre un état de disponibilité réel et une
condition de données manquantes pour ces anciens ETL d’application source. La
liste des anciens ETL d’application source qui ont été développés avant cette
modification, ainsi que les types de composant pour lesquels ils fournissent des
données, sont présentés dans le tableau 8 à la page 84.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 83
Tableau 8. ETL d’application source développés avant la modification des conditions
requises par Tivoli Data Warehouse
Nom du produit Type de composant
Tivoli Business System Manager 3.1 BUSINESS_SYSTEM
Tivoli Storage Area Network Manager 1.2 BTA_SWITCH
BTA_PORT
BTA_LUN
IBM Tivoli NetView 7.1.3 et 7.1.4 IP_HOST
IP_NODE
Tivoli Enterprise Console 3.9 Signal de présence
HP2_SEGMENT
HP2_NETWORK
HP2_NODE
EXAMPLE_TYPE
Les types de composant de cette liste peuvent être exclus du processus de
détection de données manquantes. Vous pouvez activer ou désactiver la détection
des données de disponibilité manquantes pour tous les types de composant de la
liste et vous pouvez ajouter et supprimer des types de composant de la liste, à
l’aide de la commande scmd mem detectMissingAvailabilityData.
Dans la mesure où les anciens ETL d’application source sont mis à niveau pour
répondre aux nouvelles conditions exigées par Tivoli Data Warehouse, vous
pouvez supprimer leurs types de composants de cette liste. Si d’autres ETL
d’application source non IBM ne répondant pas à l’exigence de Tivoli Data
Warehouse sont utilisés, ceux-ci peuvent être ajoutés à la liste et exclus lors de la
recherche de données de disponibilité manquantes.
Redémarrage du serveur SLM : Après avoir activé ou désactivé la vérification,
ajouté des types de composant dans la liste ou supprimé des types de composants
de la liste, vous devez arrêter et redémarrer le serveur SLM avant que les
modifications prennent effet.
Pour plus d’informations sur les évaluations et sur la façon dont IBM Tivoli
Service Level Advisor recherche des données manquantes, reportez-vous au
document Gestion des contrats de service.
Fourniture de données pour les types de composant modèle
communs
Grâce à la liste des types de composants exclus, IBM Tivoli Service Level Advisor
prend en charge les ETL d’application source nouveaux et existants, avec une seule
restriction. Plusieurs applications source peuvent fournir des données pour les
types de composants modèle communs, par exemple, Hôte IP. IBM Tivoli Service
Level Advisor ne peut pas faire la distinction entre un ancien ETL d’application
source et un ETL d’application source plus récent qui fournit des données pour le
même type de composant modèle commun.
Si plusieurs applications source fournissent des données de disponibilité à l’aide
du même type de composant et si au moins un des ETL d’application source ne
répond pas à l’exigence de Tivoli Data Warehouse, le type de composant modèle
84 IBM Tivoli Service Level Advisor - Guide des commandes
commun doit être conservé dans la liste des types exclus, tant que l’ancien ETL
d’application source n’est pas mis à jour pour remplir la nouvelle condition.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–enable Active la vérification des données de disponibilité manquantes
pour tous les types de composant fournissant des données de
transition, qui ne figurent pas dans la liste des types exclus.
–disable Désactive la vérification des données de disponibilité manquantes
pour tous les types de composant.
–listCompTypes
Affiche la liste de tous les types de composant qui sont définis
dans IBM Tivoli Service Level Advisor, indépendamment du fait
qu’ils sont exclus ou non de la recherche de données de
disponibilité manquantes. Utilisez la sortie de cette option pour
émettre d’autres commandes scmd mem
detectMissingAvailabilityData afin d’ajouter ou de supprimer des
types de composant dans la liste de ceux qui sont exclus de la
recherche de données de disponibilité manquantes.
–addExclude <type_composant...>
Indique un ou plusieurs types de composant, séparés par des
virgules, à exclure de la recherche de données de disponibilité
manquantes. Cette option n’est acceptée que lorsque la recherche
de données de disponibilité manquantes est activée.
–removeExclude <type_composant...>
Indique un ou plusieurs types de composant, séparés par des
virgules, qui doivent être supprimés de la liste des types exclus et
qui sont inclus dans la recherche de données de disponibilité
manquantes.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Lors de la gestion de la liste des types de composants qui sont exclus de la
recherche de données de disponibilité manquantes, prenez en considération les
informations suivantes :
v Toutes les sorties de la commande affichent les paramètres qui sont en cours
d’utilisation. Si des paramètres sont modifiés et que le serveur SLM n’a pas
encore été redémarré, ces modifications en attente s’affichent également.
v Si aucune option n’est incluse dans la commande scmd mem
detectMissingAvailabilityData, la sortie de la commande affiche le paramètre en
cours (détection activée ou désactivée) et, si la détection est activée, la liste des
types de composant qui figurent dans la liste des types exclus. Si un précédent
appel de la commande a modifié les paramètres d’activation ou d’exclusion et
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 85
que le serveur SLM n’a pas encore été redémarré, la sortie de cette commande
affiche en outre les paramètres dont la modification a été demandée, ainsi qu’un
rappel indiquant que les modifications ne prennent effet qu’après le redémarrage
du serveur SLM.
v Si la détection des données manquantes est désactivée, la liste des types de
composant exclus n’est pas effacée ; cependant, celle-ci est inactive et ne s’affiche
pas dans les sorties de commande ultérieures. Si la détection est activée, la liste
des types de composant exclus est activée et incluse dans les sorties de
commande ultérieures.
v Les options –addExclude et –removeExclude ne sont acceptées que si la
détection des données manquantes a été activée.
v IP_HOST et IP_NODE sont des types de composant modèle communs qui
peuvent être utilisés par plusieurs applications source. IBM Tivoli NetView est
l’utilisateur principal de ces types de composant pour les données de
disponibilité. Si vous installez un nouveau module d’intégration d’application
source qui fournit des données de disponibilité à l’aide de ces types de
composant (pour plus de détails, reportez-vous à la documentation du module
d’intégration) et que vous ne souhaitez pas utiliser IBM Tivoli NetView, vous
devez supprimer ces types de composant de la liste des types exclus. Cependant,
si vous planifiez une exécution simultanée avec IBM Tivoli NetView, vous devez
conserver ces types de composant dans la liste des types exclus jusqu’à la mise à
jour du module d’intégration, afin de répondre à l’exigence de Tivoli Data
Warehouse.
v Si vous utilisez Tivoli Enterprise Console, vous pouvez créer vos propres types
de composant pour classer les ressources pour lesquelles fournir des données de
disponibilité. L’ETL source de Tivoli Enterprise Console ajoute ces nouveaux
types de composant dans Tivoli Data Warehouse. Cela signifie que la liste des
types de composant correspondant aux données de disponibilité Tivoli
Enterprise Console est dynamique. Si vous créez des types de composant pour
Tivoli Enterprise Console, veillez à les ajouter à la liste des types exclus, jusqu’à
la mise à jour de Tivoli Enterprise Console, afin de répondre à l’exigence de
Tivoli Data Warehouse.
v Si vous utilisez un module d’intégration d’application source écrit par un tiers,
vous devez déterminer s’il remplit la condition requise par Tivoli Data
Warehouse pour fournir des données de disponibilité. S’il ne remplit pas cette
condition, vous devez ajouter à la liste des types exclus les types de composant
de ce module d’intégration.
v Si vous installez une version mise à jour d’un module d’intégration de données
qui remplit la condition requise par Tivoli Data Warehouse et qui remplace une
précédente version incluse dans la liste des types exclus, vous devez exécuter le
nouvel ETL source au moins une fois, puis supprimer le type de composant de
la liste des types exclus, avant d’exécuter les ETL d’enregistrement et de
processus d’IBM Tivoli Service Level Advisor. Cela permet de garantir
l’enregistrement des états de disponibilité dans Tivoli Data Warehouse et
l’évaluation correcte des points de données par IBM Tivoli Service Level
Advisor.
Exemples
Les exemples ci-dessous présentent les résultats de la commande scmd mem
detectMissingAvailabilityData lorsque cette dernière est émise plusieurs fois de
manière séquentielle.
1. Affichez les paramètres en cours de la détection des données manquantes.
scmd mem detectMissingAvailabilityData
86 IBM Tivoli Service Level Advisor - Guide des commandes
Le résultat est similaire à l’exemple suivant :
====> Paramètres en cours d’utilisation :
La détection des données manquantes est activée
Les types de composants exclus des contrôles de données de disponibilité
manquantes sont les suivants :
BUSINESS_SYSTEM BTA_SWITCH BTA_PORT BTA_LUN IP_HOST IP_NODE
HEARTBEAT HP2_SEGMENT HP2_NETWORK HP2_NODE EXAMPLE_TYPE
2. Désactivez la détection des données de disponibilité manquantes.
scmd mem detectMissingAvailabilityData -disable
Le résultat est similaire à l’exemple suivant :
====> Paramètres en cours d’utilisation :
La détection des données manquantes est activée
Les types de composants exclus des contrôles de données de disponibilité
manquantes sont les suivants :
BUSINESS_SYSTEM BTA_SWITCH BTA_PORT BTA_LUN IP_HOST IP_NODE
HEARTBEAT HP2_SEGMENT HP2_NETWORK HP2_NODE EXAMPLE_TYPE
====> Les paramètres demandés qui vont prendre effet après le prochain recyclage
du serveur SLM :
La détection des données manquantes sera désactivée
Il est à noter que les paramètres en cours sont toujours en vigueur. La détection
des données manquantes n’est désactivée que lorsque le serveur SLM est arrêté
puis redémarré.
3. Une fois que la commande précédente a été entrée, le serveur SLM est arrêté
puis redémarré, à l’aide des commandes suivantes (pour plus d’informations
sur le démarrage et l’arrêt du serveur SLM, reportez-vous au Guide d’initiation) :
net stop tslm
net start tslm
Affichez les paramètres en cours de la détection des données manquantes.
scmd mem detectMissingAvailabilityData
Le résultat est similaire à l’exemple suivant :
====> Paramètres en cours d’utilisation :
La détection des données manquantes est désactivée
4. Affichez la liste de tous les types de composant qui sont définis dans IBM
Tivoli Service Level Advisor.
scmd mem detectMissingAvailabilityData -listCompTypes
Le résultat est similaire à l’exemple suivant :
Les codes de type de composant sont suivis de leur nom.
Utilisez uniquement le code de type de composant lors de l’ajout d’un élément
dans la liste d’exclusion.
ANM_SMARTSET ANM SmartSet
BUSINESS_SYSTEM Business System
BWM_EP Tivoli Web Transaction Performance Endpoint
(et d’autres...)
5. Ajoutez le type de composant ABC_123 dans la liste d’exclusion, puis
supprimez le type de composant BTA_PORT de la liste d’exclusion.
scmd mem detectMissingAvailabilityData -enable -addExclude ABC_123
-removeExclude BTA_PORT
Le résultat est similaire à l’exemple suivant :
====> Paramètres en cours d’utilisation :
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 87
La détection des données manquantes est désactivée
====> Les paramètres demandés qui vont prendre effet après le prochain recyclage
du serveur SLM :
La détection des données manquantes sera activée
Les types de composants qui vont être exclus des contrôles de données
de disponibilité manquantes sont les suivants :
BUSINESS_SYSTEM BTA_SWITCH BTA_LUN IP_HOST IP_NODE
HEARTBEAT HP2_SEGMENT HP2_NETWORK HP2_NODE EXAMPLE_TYPE ABC_123
Il est à noter que, dans cet exemple, l’état désactivé en cours reste en vigueur
jusqu’après le redémarrage du serveur SLM. La liste des types de composant
qui sont exclus des contrôles de données de disponibilité manquantes ne
comprend plus BTA_PORT et inclut ABC_123.
88 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem dumpData
Affiche, pour un évaluateur de mesures spécifique, tous les points de données
d’une période d’évaluation ou une plage de périodes d’évaluation.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem dumpData –s <ID_contrat_SLA> –i
<index_évaluateur_mesures> –r {<nombre_intervalles_évaluation> |
<premier_intervalle_évaluation_antérieur> <dernier_intervalle_évaluation_antérieur>}
Description
La commande scmd mem dumpData affiche tous les points de données d’un
évaluateur de mesures indiqué, qui couvrent un ou plusieurs intervalles
d’évaluation.
L’ID du contrat SLA et l’index d’évaluateur de mesures sont disponibles à partir
de la commande scmd mem showMetricEvaluators. Par exemple, la sortie de cette
commande est similaire à l’exemple suivant :
ID contrat SLA : 1001
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1003
0) ID évaluateur de mesures : 41:1003:1019
Contexte d’évaluateur de mesures : CONTEXT: 1001:41:TSLA.NumberOfOutages
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Nombre d’indisponibilités / Tous
Nom de ressource : /iphost4.anm.tivoli.com
ID/type de composant : 41 / IP_HOST
1) ID évaluateur de mesures : 41:1003:1020
Contexte d’évaluateur de mesures :
CONTEXT: 1001:41:TSLA.AvailabilityPercent
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Disponibilité / Tous
Nom de ressource : /iphost4.anm.tivoli.com
ID/type de composant : 41 / IP_HOST
2) ID évaluateur de mesures : 41:1003:1022
Contexte d’évaluateur de mesures : CONTEXT: 1001:41:TSLA.TimeToRepair
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Heure de réparation / Tous
Nom de ressource : /iphost4.anm.tivoli.com
ID/type de composant : 41 / IP_HOST
Dans cet exemple de sortie, trois évaluateurs de mesures sont associés à SLA 1001.
Chacun de ces évaluateurs de mesures est identifié par son ID (par exemple,
41:1003:1019, 41:1003:1020, 41:1003:1022) et son index d’évaluateur de mesures
correspondant, représenté sous forme de 0, 1 ou 2 (le nombre entier situé à gauche
sur la même ligne que l’ID évaluateur de mesures).
L’intervalle ou les intervalles d’évaluation que vous définissez à l’aide de
l’argument –r sont spécifiés sous forme d’entiers (1, 2, etc.) indiquant le nième
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 89
intervalle d’évaluation complet avant la date d’émission de la commande. Par
exemple, un évaluateur de mesures est évalué toutes les semaines. Supposons que
vous émettiez la commande scmd mem dumpData à 10 heures 53 le 3 février 2004
et que vous indiquiez une plage d’intervalles d’évaluation de –r 1 2. Cela indique
que vous souhaitez des données pour le premier et le deuxième intervalles
d’évaluation hebdomadaires complets avant le 3 février 2004 (date d’émission de la
commande). La plage de dates correspondant à ces deux intervalles, comme
illustré dans la figure 1, est la suivante :
1. Jan 25, 2004 12:00:00 AM CST-Jan 31, 2004 11:59:59 PM CST
2. Jan 18, 2004 12:00:00 AM CST-Jan 24, 2004 11:59:59 PM CST
Il est à noter que le fuseau horaire correspond à l’heure normale du centre (CST).
Pour ce contrat SLA particulier, le fuseau horaire a été paramétré sur CST. Toutes
les valeurs d’heure s’affichent en heure GMT et dans le fuseau horaire du contrat
SLA.
La sortie de la commande scmd mem dumpData doit être similaire à l’exemple
partiel suivant :
Vidage des données pour l’évaluateur de mesures suivant :
0)ID évaluateur de mesures : 64:1047:1295
Contexte d’évaluateur de mesures : CONTEXT: 1047:64:178
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Nom d’instance DB2
Nom/type de mesure : DB2Up / 178
Nom de ressource : /IBM-Berlin.tivoli.com/DB2
ID/type de composant : 64 / CTD_INSTANCE
Avertissement : Paramètre de données de purge DYK en cours = {0} jours.
Les intervalles comportant des heures antérieures à Dec 5, 2003 à 11:09:35 AM EST
(Dec 5, 2003 4:09:35 PM GMT)
ne contiennent peut-être pas de points de données, si le processus ETL
de purge DYK a été exécuté. Le dernier processus ETL ayant déclenché
des évaluations est déployé à Jan 13, 2004 6:40:22 PM EST
(Jan 13, 2004 11:40:22 PM GMT) .
Tous les intervalles d’évaluation comportant des heures ultérieures
à celle-ci peuvent indiquer des données manquantes.
Les intervalles d’évaluation sont paramétrés sur la fréquence Quotidienne.
Intervalle 1 = Feb 5, 2004 12:00:00 AM EST-Feb 5, 2004 11:59:59 PM EST
(Feb 5, 2004 5:00:00 AM GMT-Feb 6, 2004 4:59:59 AM GMT)
Intervalle 2 = Feb 4, 2004 12:00:00 AM EST-Feb 4, 2004 11:59:59 PM EST
(Feb 4, 2004 5:00:00 AM GMT-Feb 5, 2004 4:59:59 AM GMT)
Intervalle 3 = Feb 3, 2004 12:00:00 AM EST-Feb 3, 2004 11:59:59 PM EST
(Feb 3, 2004 5:00:00 AM GMT-Feb 4, 2004 4:59:59 AM GMT)
Intervalle 4 = Feb 2, 2004 12:00:00 AM EST-Feb 2, 2004 11:59:59 PM EST
(Feb 2, 2004 5:00:00 AM GMT-Feb 3, 2004 4:59:59 AM GMT)
Intervalle 5 = Feb 1, 2004 12:00:00 AM EST-Feb 1, 2004 11:59:59 PM EST
Figure 1. Spécification d’une plage d’intervalles d’évaluation avant la date d’émission de la commande
90 IBM Tivoli Service Level Advisor - Guide des commandes
(Feb 1, 2004 5:00:00 AM GMT-Feb 2, 2004 4:59:59 AM GMT)
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–s <ID_contrat_SLA>
ID contrat SLA de l’évaluateur de mesures indiqué pour lequel des
points de données sont en cours de collecte, par exemple, 1005.
–i <index_évaluateur_mesures>
Nombre entier (par exemple, 0, 1, ou 2) qui apparaît à gauche de
l’ID évaluateur de mesures dans la sortie de la commande scmd
mem showMetricEvaluators.
–r <intervalle_évaluation_unique> | <premier_intervalle_évaluation_antérieur>
<dernier_intervalle_évaluation_antérieur>
Intervalles d’évaluation complets préférés antérieurs à la date
d’entrée de la commande. Vous pouvez indiquer un seul nombre
représentant un intervalle d’évaluation unique ou vous pouvez
indiquer deux nombres indiquant que des points de données sont
requis pour une plage d’intervalles d’évaluation. Il est à noter que
les intervalles sont fonction de la fréquence d’évaluation. Par
exemple, si la fréquence d’évaluation de l’évaluateur de mesures
est Quotidienne et que vous émettez la commande scmd mem
dumpData en indiquant -r 2 4, cela signifie que vous souhaitez les
données pour les deuxième, troisième et quatrième intervalles
quotidiens complets avant aujourd’hui, ou le lundi, le mardi ou le
mercredi précédent.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Dans l’exemple de sortie présenté plus haut, la référence au paramètre de données de
purge DYK désigne un processus de gestion de base de données facultatif qui
utilise l’ETL de purge, un des ETL fournis dans le module d’intégration cible
d’IBM Tivoli Service Level Advisor. Le processus ETL de purge peut être planifié
de sorte qu’il supprime du magasin de données SLM Measurement les données
antérieures à un nombre de jours défini. Lors de l’exécution du processus ETL de
purge, le paramètre de purge DYK sert à déterminer le nombre de jours de
conservation de données dans la base de données. Pour plus d’informations sur le
paramètre de purge, voir «scmd etl setDataExpiration» à la page 38.
Egalement dans l’exemple de sortie présenté précédemment, la date de déploiement
du dernier processus ETL indique la date la plus récente à laquelle le processus ETL
DYK a été exécuté pour le transfert de données vers le magasin de données SLM
Measurement. Si la commande scmd mem dumpData est émise pour un intervalle
qui a lieu après cette date de déploiement du dernier ETL, le résultat inclut
systématiquement une condition de données manquantes.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 91
Exemples
1. Affichez tous les points de données relatifs à l’évaluateur de mesures qui
comporte l’index 3 et l’ID contrat SLA 1007 pour le quatrième intervalle
d’évaluation antérieur à la date en cours :
scmd mem dumpData -s 1007 -i 3 -r 4
2. Affichez tous les points de données relatifs à l’évaluateur de mesures qui
comporte l’index 0 et l’ID contrat SLA 1022 pour les six intervalles d’évaluation
précédents :
scmd mem dumpData -s 1022 -i 0 -r 1 6
Voir aussi
scmd mem showMetricEvaluators, scmd etl setDataExpiration
92 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem flushEvents
Envoie tous les événements conservés au composant interne SLA d’IBM Tivoli
Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem flushEvents
Description
La commande scmd mem flushEvents envoie vers la base de données SLM les
résultats d’évaluation et les données d’événement qui sont provisoirement stockés
dans IBM Tivoli Service Level Advisor. Cela se produit généralement lorsque des
données d’événement ne peuvent pas être envoyées via le système, en raison de
pannes de réseau provisoires d’un système à l’autre. Lorsque la connexion est
restaurée, vous pouvez émettre cette commande pour vider ces données
d’événement conservées via le système et les envoyer à des fins de traitement et de
stockage.
Par exemple, si un incident DB2 ou un incident réseau se produit entre le poste
serveur SLM et le poste sur lequel réside la base de données SLM, le message
d’erreur suivant s’affiche dans le journal des messages lors d’une tentative
d’enregistrement des résultats dans la base de données SLA à la suite de
l’évaluation SLA :
DYKME9034E Une tentative de publication des résultats de contrôle du service a été
effectuée et un échec s’est produit. Les résultats de contrôle seront consignés
en local.
Vous pouvez émettre la commande scmd mem flushEvents pour envoyer ces
données à la base de données SLM une fois que l’incident de réseau a été résolu.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être utilisée que lors d’une reprise sur incident.
Exemples
Envoyez les événements qui sont provisoirement stockés en raison d’une panne
réseau.
scmd mem flushEvents
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 93
scmd mem help
Affiche la syntaxe et des exemples pour le regroupement de commandes scmd
mem.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem help
Description
La commande scmd mem help affiche la syntaxe et des exemples pour le
regroupement de commandes scmd mem.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’aide relative au regroupement de commandes scmd mem.
scmd mem help
94 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem list
Affiche la liste des commandes et options disponibles pour le regroupement de
commandes scmd mem.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem list
Description
La commande scmd mem list affiche la liste des commandes disponibles et la
syntaxe du regroupement de commandes scmd mem.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles ainsi que la syntaxe du
regroupement de commandes scmd mem.
scmd mem list
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 95
scmd mem reEval
Lance une réévaluation des données relatives à un ou plusieurs évaluateurs de
mesures actifs pour une plage de dates et d’heures indiquée.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem reEval {–s <ID_contrat_SLA> | –mi
<ID_évaluateur_mesures>} [<ID_évaluateur_mesures>...] –st <date_début_évaluation>
[–et <date_fin_évaluation>] –j <justification>
Description
La commande scmd mem reEval permet de réévaluer des données pour un ou
plusieurs évaluateurs de mesures pendant un ou plusieurs intervalles d’évaluation.
Cette opération est peut-être nécessaire si des ETL source ou cible ne sont pas
configurés ou planifiés correctement ou si des ETL ont des difficultés lors de
l’écriture de données dans l’entrepôt de données central, ce qui donne lieu à des
données manquantes ou des données en retard une fois l’évaluation d’origine
terminée.
AVERTISSEMENT : Avant d’émettre cette commande, vous devez vous
familiariser avec les relations de délais entre le moment où des données sont
enregistrées dans l’entrepôt de données central et le moment où des données sont
extraites par IBM Tivoli Service Level Advisor à des fins de traitement, ainsi que la
fréquence des évaluations et des analyses de tendances. Si un de ces processus est
inactif en raison d’une configuration incorrecte, de différences entre les fuseaux
horaires ou d’autres situations similaires, vous pouvez continuer de rencontrer des
difficultés au niveau des évaluations et les réévaluations ne produisent pas de
meilleurs résultats. Pour comprendre entièrement votre environnement
d’exploitation avant d’émettre cette commande, adressez-vous à l’administrateur
SLM et à l’administrateur de base de données. Il se peut que le document
Troubleshooting contienne d’autres informations utiles concernant les évaluations.
Vous ne pouvez pas mettre à jour automatiquement une évaluation qui a déjà eu
lieu, en fonction de l’arrivée de données supplémentaires relatives à cet intervalle
d’évaluation. Evitez cet incident en planifiant correctement les heures d’exécution
des ETL d’application source et des ETL cible IBM Tivoli Service Level Advisor.
Cependant, si cet incident se produit, il est peut-être possible de corriger la
situation si celle-ci est traitée avec précaution.
Limitations sur les réévaluations
Lors de l’exécution d’une réévaluation, prenez considération les limitations
suivantes :
v Aucun résultat de tendance ne peut être réévalué. Après le redémarrage d’un
serveur, le processus d’analyse de tendances incorpore chaque résultat de
tendances de manière séquentielle. Une réévaluation d’une tendance risque
d’insérer un point de tendance hors séquence et de dévier les résultats dans une
direction inconnue. En outre, la réévaluation se produit généralement au niveau
des résultats passés, alors que les tendances sont utiles pour les prévisions
d’événements futurs en fonction de données très récentes. Il se peut que la
tendance dépasse la plage horaire qui est en cours de réévaluation. Pour ces
raisons, les résultats de tendances ne peuvent pas être réévalués.
v Seuls les objectifs de niveau de service (SLO) qui font partie des contrats SLA
actifs peuvent être réévalués. Si un contrat SLA a été annulé, aucun des
objectifs de niveau de service de ce contrat SLA ne peut être réévalué.
96 IBM Tivoli Service Level Advisor - Guide des commandes
Si les ressources statiques ou le nom de filtre de ressource dynamique
correspondant aux objectifs de niveau de service ont été modifiés depuis
l’évaluation d’origine, son évaluateur de mesures n’est plus actif, même si le
contrat SLA est toujours actif, et les objectifs de niveau de service ne peuvent
pas être réévalués. Dans le cas d’une tentative d’évaluation des objectifs de
niveau de service modifiés, les résultats de la précédente évaluation sont
conservés et un ensemble de résultats faisant partie des objectifs de niveau de
service modifiés est créé. Ce résultat incohérent dans la base de données risque
de prêter à confusion lorsqu’il est affiché dans la console Rapports SLM. Dans
cette situation, ces objectifs de niveau de service ne doivent pas être réévalués.
v Avant la réévaluation, sauvegardez la base de données SLM. Le processus de
réévaluation conserve les résultats d’origine dans la base de données SLM,
essentiellement pour les opérations d’audit, mais il n’existe aucune méthode
permettant de restaurer ces résultats dans le cas d’une erreur lors de la sélection
des objectifs de niveau de service ou de la plage horaire à réévaluer. Si vous
avez des doutes sur les effets de la réévaluation ou si vous souhaitez réévaluer
plusieurs objectifs de niveau de service, vous devez auparavant sauvegarder
votre base de données de sorte qu’un point de retour soit disponible si vous
devez ultérieurement effectuer une reprise suite à un échec de réévaluation ;
sinon, il en résulte d’autres incidents.
v La réévaluation n’est utile que si des données ont été modifiées depuis
l’évaluation d’origine. Si l’objectif de niveau de service n’a pas été modifié
depuis l’évaluation d’origine et si les données du magasin de données SLM
Measurement correspondant à cet objectif de niveau de service n’ont pas été
modifiées pour la période d’évaluation depuis l’évaluation d’origine, la
réévaluation n’a pas d’effet. Les résultats et les violations issus d’une
réévaluation sont comparés aux résultats et violations d’origine ; s’ils sont
identiques, aucune modification n’est apportée aux résultats dans la base de
données SLM. Si la réévaluation génère des résultats différents, ces nouveaux
résultats et violations d’évaluation remplacent les résultats et violations d’origine
et s’affichent dans tous les futurs rapports.
v Les intervalles de réévaluation de moins d’un jour ne sont pas pris en charge.
Le plus petit intervalle de réévaluation pris en charge est Quotidienne. Si l’objectif
de niveau de service est configuré pour des évaluations horaires, vous devez
réévaluer toutes les évaluations horaires dans une journée entière.
v Seules les instances d’évaluateur de mesures basées sur des contrats SLA du
même fuseau horaire peuvent être réévaluées conjointement.
Exécution d’une réévaluation
Pour effectuer une réévaluation, procédez comme suit :
1. Sauvegardez le magasin de données SLM Measurement et la base de données
SLM pour disposer d’un point de reprise connu si des incidents se produisent
lors d’une réévaluation.
2. Pour indiquer l’ID de l’évaluateur de mesures à la place de l’ID du contrat SLA
dans la commande de réévaluation, émettez la commande scmd mem
showMetricEvaluators, en indiquant l’ID contrat SLA pour lequel vous
souhaitez effectuer une réévaluation. Notez l’ID évaluateur de mesures qui est
associé aux objectifs de niveau de service dont les évaluations doivent être
mises à jour. Il s’agit de la valeur que vous entrez pour la commande scmd
mem reEval, à l’aide de l’option de commande –mi.
3. Déterminez les valeurs des options de commande –st et –et qui représentent la
plage de dates de début et de fin des évaluations d’origine. L’heure associée à
la date de début est 00:00:00 et celle associée à la date de fin est 23:59:59.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 97
Si plusieurs objectifs de niveau de service sont réévalués lors d’une exécution
unique de la commande scmd mem reEval, tous les objectifs de niveau de
service indiqués doivent avoir la même fréquence d’évaluation. Cette méthode
permet d’identifier aisément les valeurs à indiquer pour les dates de début et
de fin de la réévaluation, car elles correspondent directement aux périodes
d’évaluation indiquées dans les rapports sur les résultats des objectifs de
niveau de service.
Par exemple, prenez en considération une période de deux semaines comprise
entre le dimanche 1 janvier et le samedi 14 janvier 2006. Trois contrats SLA sont
définis, chacun comportant trois objectifs de niveau de service (soit un total de
9 objectifs de niveau de service). Le premier objectif de niveau de service de
chaque contrat SLA est doté d’une mesure évaluée à une fréquence quotidienne,
le deuxième objectif de niveau de service à une fréquence hebdomadaire et le
troisième à une fréquence mensuelle.
Supposons que les données ont été modifiées pour deux jours de cette période
de deux semaines, les 2 et 13 janvier, ce qui a une incidence sur tous les 9
objectifs de niveau de service. Pour effectuer une réévaluation de ces données,
émettez des commandes de réévaluation similaires aux exemples suivants :
scmd mem reEval -mi <SLA1:SLO1, SLA2:SLO1, SLA3:SLO1> -st 2006 01 02
-et 2006 01 02 -j "Ceci réévalue les objectifs de niveau de service quotidiens
concernés par les modifications de données du 2 janvier."
scmd mem reEval -mi <SLA1:SLO1, SLA2:SLO1, SLA3:SLO1> -st 2006 01 13
-et 2006 01 13 -j "Ceci réévalue les objectifs de niveau de service quotidiens
concernés par les modifications de données du 13 janvier."
scmd mem reEval -mi <SLA1:SLO2, SLA2:SLO2, SLA3:SLO2> -st 2006 01 01
-et 2006 01 14 -j "Ceci réévalue les objectifs de niveau de service
hebdomadaires concernés par les modifications de données
du 2 janvier et du 13 janvier."
scmd mem reEval -mi <SLA1:SLO3, SLA2:SLO3, SLA3:SLO3> -st 2006 01 01
-et 2006 01 31 -j "Ceci réévalue les objectifs de niveau de service mensuels
concernés par les modifications de données du 2 janvier et du 13 janvier."
Ces commandes donnent lieu à une réévaluation uniquement pour les périodes
d’évaluation concernées par la modification de données. Dans cet exemple,
deux commandes distinctes ont été utilisées pour effectuer l’évaluation
quotidienne les 2 et 13 janvier. Pour effectuer ces réévaluations dans le cadre
d’une commande unique, modifiez la plage de dates de sorte qu’elle inclue les
deux dates, comme dans l’exemple suivant :
scmd mem reEval -mi <SLA1:SLO1, SLA2:SLO1, SLA3:SLO1> -st 2006 01 02
-et 2006 01 13 -j "Ceci réévalue un nombre supérieur à celui qui est nécessaire.
En raison de la plage de dates définie dans cette commande, des réévaluations
quotidiennes supplémentaires sont effectuées au niveau des objectifs de niveau
de service indiqués entre le 3 et le 12 janvier. Si les données de surveillance de
ces dates sont inchangées pour ces objectifs de niveau de service, la
réévaluation n’apporte aucune modification aux résultats. Cependant, si les
données ont été modifiées pour ces dates supplémentaires, les résultats de
réévaluation risquent d’inclure d’autres modifications non prévues.
Dans l’exemple de commande émis pour les évaluations hebdomadaires, il est à
noter que la plage de dates inclut la totalité de la période de deux semaines, ce
qui donne lieu à une réévaluation unique pour les deux intervalles
hebdomadaires. Pour ce faire, vous pouvez émettre deux commandes distinctes,
une par semaine. Cependant, dans la mesure où les deux semaines
comprennent des données modifiées et qu’elles ont lieu de manière
séquentielle, la réévaluation des deux semaines s’effectue plus efficacement
lorsqu’une commande CLI unique existe pour les deux semaines.
98 IBM Tivoli Service Level Advisor - Guide des commandes
Vous pouvez regrouper dans la même commande les objectifs de niveau de
service associés à des fréquences différentes, mais gardez à l’esprit que toutes
les périodes d’évaluation dont l’heure de fin est comprise entre les dates de
début et de fin sont réévaluées. Pour réévaluer tous les 3 objectifs de niveau de
service pour SLA1, émettez une commande unique similaire à l’exemple
suivant :
scmd mem reEval -s <SLA1> -st 2006 01 01 -et 2006 01 31
-j "Ceci réévalue tous les objectifs de niveau de service quotidiens,
hebdomadaires et mensuels de ce contrat SLA."
Par suite de l’émission de cette commande unique, SLO1 comporte 31
réévaluations, SL02 4 réévaluations hebdomadaires et SLO3 1 réévaluation
mensuelle.
Si aucune valeur n’est indiquée pour –et, la valeur par défaut de la date de fin
correspond à la date de la dernière exécution du processus ETL. Cela risque
d’occasionner la réévaluation de plusieurs périodes d’évaluation
supplémentaires, en fonction des heures indiquées et de la fréquence
d’évaluation des objectifs de niveau de service. Si le retard ou l’absence des
données est dû à une erreur d’ETL source qui a depuis été résolue, il est
probable que les nouvelles données couvrent cette période en intégralité ; par
conséquent, toutes ces réévaluations doivent avoir lieu dans tous les cas.
Pour vous assurer que la période d’évaluation correcte est utilisée, définissez
l’heure de fin correspondante de sorte qu’elle soit comprise entre les options –st
et –et. Pour définir les valeurs de début et de fin correctes, prenez également en
considération les informations suivantes :
v Les valeurs de –st et –et doivent être définies de sorte qu’elles soient
postérieures à la date de début de contrat SLA.
v Les valeurs de –st et –et doivent être postérieures à la date à laquelle les
données ont pu être purgées du magasin de données SLM Measurement.
Cette date peut être estimée à l’aide du paramètre de délai d’expiration de
données (voir «scmd etl getDataExpiration» à la page 29).
v Les valeurs de –st et –et doivent être antérieures à la date de la dernière
exécution du processus ETL (aucune réévaluation ne peut être effectuée si
l’évaluation d’origine n’a pas encore eu lieu).
v Les différences entre le fuseau horaire des données des objectifs de niveau de
service et celui de l’emplacement du serveur SLM peuvent entraîner des
complications lors de la détermination des valeurs correctes des options –st
et –et. Si le fuseau horaire du contrat SLA est différent du fuseau horaire
dans lequel réside le serveur SLM, utilisez le fuseau horaire du contrat SLA
lorsque vous indiquez des dates pour cette commande.
v Si vous effectuez une réévaluation pour un contrat SLA qui utilise des
fréquences d’évaluation horaires et si le fuseau horaire du contrat SLA est
différent de celui dans lequel réside le serveur SLM, vous devez peut-être
ajouter un jour à la date de fin ou soustraire un jour de la date de début.
Supposons, par exemple, que vous ayez défini les conditions de réévaluation
suivantes :
– Le fuseau horaire du contrat SLA correspond à GMT-10
– Le fuseau horaire du serveur SLM correspond à GMT-5 (en d’autres
termes, le contrat SLA est situé à l’ouest du serveur SLM)
– La fréquence de l’instance d’évaluateur de mesures (ID = 3:1000:13) à
évaluer est toutes les 4 heures
– Le résultat des rapports à réévaluer est associé à une heure d’évaluation
de 2004 05 14, entre 04:00 GMT-10 et 07:59 GMT-10.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 99
Dans l’exemple ci-dessus, la date prévue du résultat est 5/14/2004 mais,
dans la mesure où il s’agit d’une fréquence d’évaluation horaire, vous devez
ajouter un jour à l’option –et pour tenir compte de la différence entre le
fuseau horaire du contrat SLA et celui du serveur SLM. La commande
ci-dessous est ensuite émise.
scmd mem reEval -mi 3:1000:13 -st 2004 05 14 -et 2004 05 15 -j <justification>
4. Emettez la commande scmd mem reEval en indiquant les ID d’évaluateur de
mesures préférés et les valeurs de début et de fin, tels qu’ils sont décrits
ci-dessus. Utilisez également l’option –j afin de fournir une justification de texte
pour cette réévaluation, à titre de référence historique.
5. Des entrées de journal d’audit sont créées ; elles indiquent l’ID déclaration
unique qui est affecté à cette tentative et à toutes les modifications de base de
données résultant de cette réévaluation.
Si les données sont restées identiques dans le magasin de données SLM
Measurement pour l’ID d’évaluateur de mesures indiqué et la plage de dates, la
réévaluation n’apporte PAS de modifications aux résultats. Si le contrat SLA a été
modifié (par exemple, modification des ressources) depuis l’évaluation d’origine,
les résultats d’évaluation d’origine ne sont pas supprimés de la base de données
(car les ID point de données ne correspondent pas). Les données de résultat issues
de la réévaluation s’ajoutent à la base de données. Il n’est pas conseillé d’effectuer
des réévaluations pour les plages de dates antérieures à une modification de
contrat SLA.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–s <ID_contrat_SLA>
Indique l’ID contrat SLA (par exemple, 1000) de l’évaluateur de
mesures pour lequel des données sont collectées.
–mi <ID_évaluateur_mesures> [<ID_évaluateur_mesures>...]
Indique l’ID d’un ou plusieurs évaluateurs de mesures. Cet ID
s’affiche dans le cadre de la sortie de la commande scmd mem
showMetricEvaluators.
–st <début_plage_dates_évaluation>
Indique la date de début de la période pendant laquelle
l’évaluation préférée a eu lieu pour les évaluations d’origine. Cette
valeur est indiquée au format AAAA MM JJ. L’heure est définie de
façon implicite au format 00:00:00.
–et <fin_plage_dates_évaluation>
Indique, le cas échéant, la date de fin de la période pendant
laquelle l’évaluation a eu lieu pour les évaluations d’origine. Cette
valeur est indiquée au format AAAA MM JJ. L’heure est définie de
façon implicite au format 23:59:59. Si ce paramètre n’est pas inclus
dans la commande, la date de fin utilisée par défaut est la date de
fin de l’exécution la plus récente du processus ETL.
100 IBM Tivoli Service Level Advisor - Guide des commandes
–j <justification>
Indique la justification permettant d’effectuer cette réévaluation de
données. Il s’agit d’une chaîne de texte normale qui est enregistrée
sous la forme du motif de la déclaration pour toutes les
modifications apportées à la base de données qui résultent de cette
réévaluation. Si la chaîne contient des espaces, elle doit être placée
entre guillemets. Vous pouvez entrer jusqu’à 1000 caractères dans
cette chaîne de texte.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Effectuez une réévaluation des données qui ont été collectées pour un
évaluateur de mesures dont l’ID est 45:2231:38, lorsque l’évaluation d’origine a
eu lieu à une fréquence quotidienne. Les données modifiées ont eu lieu entre le
2 décembre 2003 à 2:13:30am (GMT) et le 8 décembre 2003 à 8:45:22pm (GMT).
Utilisez la justification suivante : Ajustement de données suite à la demande de J.
Dupont.
Dans la mesure où la fréquence d’évaluation d’origine est quotidienne et que la
réévaluation des données a lieu sur plusieurs jours, les valeurs de –st et –et
doivent englober la période d’évaluation quotidienne qui a commencé le 2
décembre 2003 à 00:00:00 et qui s’est terminée le 8 décembre 2003 à 23:59:59. La
méthode la plus simple permettant d’indiquer une plage de dates de début et
de fin valide consiste à paramétrer la valeur de date de début sur le début de
la première période d’évaluation à réévaluer et à définir par défaut la valeur de
date de fin sur la date de la dernière exécution du processus ETL. Dans ce cas,
indiquez –st à l’aide d’une valeur de 2003 12 02 et n’entrez pas de valeur pour
–et:
scmd mem reEval -mi 45:2231:38 -st 2003 12 02
-j "Ajustement de données suite à la demande de J. Dupont"
2. Répétez l’exemple précédent, mais indiquez une plage de dates de début et de
fin pour réévaluer uniquement les points de données identifiées entre le 2
décembre et le 8 décembre.
Dans la mesure où la fréquence d’évaluation d’origine est quotidienne et que la
réévaluation des données a lieu sur plusieurs jours, les valeurs de –st et –et
doivent englober la période d’évaluation quotidienne qui a commencé le 3
décembre 2003 à 00:00:00 et qui s’est terminée le 8 décembre 2003 à 23:59:59.
Affectez à –st une valeur de 2003 12 02 et à –et une valeur de 2003 12 08.
scmd mem reEval -mi 45:2231:38 -st 2003 12 02 -et 2003 12 08
-j "Ajustement de données suite à la demande de J. Dupont"
3. Effectuez une réévaluation des données qui ont été collectées pour les
évaluateurs de mesures comportant les ID 1:1018:1013 et 1:1023:1005 du 1er
avril 2004 à ce jour. Utilisez la justification suivante : Correction pour les données
en retard/manquantes.
scmd mem reEval -mi 1:1018:1013 1:1023:1005 -st 2004 04 01
-j "Correction pour les données en retard/manquantes"
Il est à noter, dans cet exemple, que les deux ID évaluateur de mesures sont
séparés par un espace et qu’aucune date de fin n’est indiquée. Cette dernière
est donc paramétrée par défaut sur l’heure de fin de l’exécution la plus récente
du processus ETL.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 101
scmd mem removeSingleSchedulePeriod
Met à jour un calendrier existant en supprimant une période qui a été définie pour
une date future spécifique unique.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem removeSingleSchedulePeriod –name
<nom_calendrier> –date <AAAA MM JJ> [–startHour <HH>] [–endHour <HH>]
–state {1(Critique) | 2 (Heures pleines) | 3 (Principal) | 4 (Standard) | 5 (Faible impact)
| 6 (Heures creuses) | 7 (Pas de service)}
Description
La commande scmd mem removeSingleSchedulePeriod sert à modifier un
calendrier existant en supprimant une période du calendrier d’une date unique
dans le futur. Cela permet de supprimer une période de date unique qui a été
ajoutée au calendrier à l’aide de la commande scmd mem
addSingleSchedulePeriod.
Vous ne pouvez pas supprimer une période d’un calendrier s’il s’agit de la
dernière période à un état donné. Par exemple, si deux périodes, Période A et
Période B, sont définies dans un calendrier et que les deux sont associées à l’état de
calendrier Principal, vous pouvez supprimer une de ces périodes et pas la seconde
car celle-ci correspond à la dernière période dans le calendrier qui est associée à
l’état de calendrier Principal.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–name Nom d’un calendrier existant.
–date Indique une date future, ou la date en cours lorsque celle-ci est
associée à une valeur startHour future. La date doit être indiquée
au format AAAA MM JJ, par exemple, 2004 03 24.
–startHour Heure de début facultative de la période, au format HH, par
exemple, 07 ou 16. Si cette option n’est pas définie, l’heure de
début est considérée comme étant 00:00:00 à la date indiquée.
–endHour Heure de fin facultative de la période, au format HH, par exemple,
08 ou 23. Si cette option n’est pas définie, l’heure de fin est
considérée comme étant 23:59:59 à la date indiquée.
–state Etat de calendrier à associer à cette période. L’état du calendrier
doit déjà exister dans le calendrier à modifier. La valeur de cette
option est un entier compris entre 1 et 7, ce qui correspond aux
états par défaut disponibles suivants :
v 1 = Critique
v 2 = Heures pleines
v 3 = Principal
v 4 = Standard
102 IBM Tivoli Service Level Advisor - Guide des commandes
v 5 = Faible impact
v 6 = Heures creuses
v 7 = Pas de service
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Supprimez une période du calendrier existant intitulé MainSched pour le 17
avril 2004 et associé à l’état de calendrier existant, Heures creuses :
scmd mem removeSingleSchedulePeriod -name MainSched -date 2004 04 17 -state 6
Dans cet exemple, les heures de début et de fin ne sont pas indiquées ; les
valeurs par défaut de 00:00:00 et 23:59:59 sont donc utilisées respectivement.
L’option -state a pour valeur 6, ce qui correspond à l’état de calendrier Heures
creuses.
2. Supprimez une période du calendrier intitulé Calendrier A, utilisant l’état de
calendrier existant Heures pleines, pour le 6 octobre 2005 entre 8:00:00 heures et
16:59:59 heures :
scmd mem removeSingleSchedulePeriod -name "Calendrier A" -date 2005 10 06
-startHour 08 -endHour 17 -state 2
Dans cet exemple, le nom du calendrier inclut un espace ; la totalité du nom de
calendrier doit donc être placée entre guillemets. Les heures de début et de fin
de la période sont également indiquées dans cet exemple. Il est à noter que
endHour a pour valeur 17 dans la commande, ce qui correspond à la valeur de
16:59:59.
Voir aussi
scmd mem addSingleSchedulePeriod
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 103
scmd mem removeStoppedRetryEntries
Supprime les entrées qui sont à l’état de relance arrêtée.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem removeStoppedRetryEntries [–co
<ID_contrat_SLA> | <nom_contrat_SLA> ] [–me <ID_évaluateur_mesures>]
Description
La commande scmd mem removeStoppedRetryEntries permet de supprimer des
entrées qui sont à l’état de relance arrêtée.
Des données sont extraites du magasin de données SLM Measurement de sorte
qu’elles soient traitées pour l’analyse des tendances et l’évaluation. Il se peut que
les données extraites ne soient pas disponibles dans le magasin de données SLM
Measurement au moment de l’évaluation, car l’application source a échoué ou
qu’elle a signalé uniquement une partie des données.
Pour conserver les données du magasin de données SLM Measurement à la suite
de l’évaluation, vous devez exécuter périodiquement un processus de relance. Une
entrée s’ajoute à cette méthode de relance chaque fois que les données extraites ne
sont pas disponibles. Dans ce cas, l’entrée passe à l’état de relance active. Un
nombre de relances fixe s’exécute pour chaque entrée à l’état de relance active. Une
fois que le nombre de relances configurable pour une entrée particulière est épuisé,
cette entrée est supprimée de l’état de relance active et placée dans l’état de relance
arrêtée. Cette commande CLI permet de supprimer les entrées qui sont à l’état de
relance arrêtée.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–co <ID_contrat_SLA> | <nom_contrat_SLA>
Indique l’ID ou le nom du contrat SLA associé aux données à l’état
de relance arrêtée qui doivent être supprimées.
–me <ID_évaluateur_mesures>
Indique l’ID de l’évaluateur de mesures associé aux données à
l’état de relance arrêtée qui doivent être supprimées.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être utilisée que lors d’une reprise sur incident.
Si aucune donnée n’est extraite dans les rapports pour une ressource ou un contrat
SLA particulier, il est possible que certaines données soient perdues du fait de
104 IBM Tivoli Service Level Advisor - Guide des commandes
l’échec de l’application source ou pour une autre raison. Pour vérifier si une
application source signale des données partielles ou aucune donnée, exécutez la
commande scmd mem showStoppedRetry pour afficher les entrées à l’état de
relance active et à l’état de relance arrêtée. Vérifiez l’application source liée au
contrat SLA ou à la ressource, puis assurez-vous qu’elle signale correctement des
données. Si l’application source signale des données dans le magasin de données
SLM Measurement, vous devez exécuter la commande scmd mem
retryMissedIntervals –all pour que l’évaluation et l’analyse des tendances se
produisent pour toutes les entrées. Si vous êtes certain que l’application source ne
signale jamais ces données, vous pouvez exécuter la commande scmd mem
removeStoppedRetryEntries pour ce contrat SLA particulier, afin de supprimer des
entrées à l’état de relance arrêtée.
Exemples
1. Supprimez les entrées associées à l’état de relance arrêtée pour l’ID contrat SLA
1005.
scmd mem removeStoppedRetryEntries -co 1005
La sortie de cette commande est peut-être similaire à l’exemple suivant :
Evaluation des intervalles entre les opérations
ID contrat SLA 1005
ID de l’instance d’élément de service 1028
ID de l’instance d’évaluateur de mesures 50:1028:97
ID contrat SLA 1005
ID de l’instance d’élément de service 1028
ID de l’instance d’évaluateur de mesures 48:1028:97
ID contrat SLA 1005
ID de l’instance d’élément de service 1029
ID de l’instance d’évaluateur de mesures 49:1029:97
Intervalles entre les opérations sur les tendances
ID contrat SLA 1005
ID de l’instance d’élément de service 1028
ID de l’instance d’évaluateur de mesures 50:1028:97
ID contrat SLA 1005
ID de l’instance d’élément de service 1028
ID de l’instance d’évaluateur de mesures 48:1028:97
ID contrat SLA 1005
ID de l’instance d’élément de service 1029
ID de l’instance d’évaluateur de mesures 49:1029:97
2. Supprimez les entrées associées à l’état de relance arrêtée pour l’ID contrat SLA
1008 et l’ID évaluateur de mesures 48:1041:97.
scmd mem removeStoppedRetryEntries -co 1008 -me 48:1041:97
La sortie de cette commande est peut-être similaire à l’exemple suivant :
Evaluation des intervalles entre les opérations
ID contrat SLA 1008
ID de l’instance d’élément de service 1041
ID de l’instance d’évaluateur de mesures 48:1041:97
Intervalles entre les opérations sur les tendances
ID contrat SLA 1008
ID de l’instance d’élément de service 1041
ID de l’instance d’évaluateur de mesures 48:1041:97
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 105
Voir aussi
scmd mem showStoppedRetry, scmd mem retryMissedIntervals
106 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem retryMissedIntervals
Relance l’évaluation ou l’analyse des tendances pour tous les intervalles de temps
à l’état de relance.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem retryMissedIntervals
Description
La commande scmd mem retryMissedIntervals permet de relancer l’évaluation ou
l’analyse des tendances pour tous les intervalles de temps associés à l’état de
relance.
Des données sont extraites du magasin de données SLM Measurement de sorte
qu’elles soient traitées pour l’analyse des tendances et l’évaluation. Il se peut que
les données extraites ne soient pas disponibles dans le magasin de données SLM
Measurement au moment de l’évaluation, car l’application source a échoué ou
qu’elle a signalé uniquement une partie des données.
Pour conserver les données du magasin de données SLM Measurement à la suite
de l’évaluation, vous devez exécuter périodiquement un processus de relance. Une
entrée s’ajoute à cette méthode de relance chaque fois que les données extraites ne
sont pas disponibles. Dans ce cas, l’entrée passe à l’état de relance active. Un
nombre de relances fixe s’exécute pour chaque entrée à l’état de relance active. Une
fois que le nombre de relances configurable pour une entrée particulière est épuisé,
cette entrée est supprimée de l’état de relance active et placée dans l’état de relance
arrêtée. Cette commande CLI permet d’extraire des données de nouveau pour
toutes les entrées aux états de relance active et de relance arrêtée.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être utilisée que lors d’une reprise sur incident.
Si aucune donnée n’est extraite dans les rapports pour une ressource ou un contrat
SLA particulier, il est possible que certaines données soient perdues du fait de
l’échec de l’application source ou pour une autre raison. Pour vérifier si une
application source signale des données partielles ou aucune donnée, exécutez la
commande scmd mem showStoppedRetry pour afficher les entrées à l’état de
relance active et à l’état de relance arrêtée. Vérifiez l’application source liée au
contrat SLA ou à la ressource, puis assurez-vous qu’elle signale correctement des
données. Si vous êtes certain que l’application source ne signale jamais ces
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 107
données, vous pouvez exécuter la commande scmd mem
removeStoppedRetryEntries pour ce contrat SLA particulier, afin de supprimer des
entrées à l’état de relance arrêtée.
Une fois cette commande exécutée, l’analyse des tendances des contrats SLA à
l’état de relance arrêtée risque de se dérouler de manière imprévue.
Exemples
1. Relance de tous les intervalles non traités encore associés à l’état de relance.
scmd mem retryMissedIntervals
La sortie de cette commande est peut-être similaire à l’exemple suivant :
Relance de tous les intervalles non traités encore associés à l’état de relance.
Evaluation des intervalles entre les opérations
ID de l’instance d’élément de service 1043 Instance d’évaluateur de mesures
ID 60:1043:1
ID de l’instance d’élément de service 1043 Instance d’évaluateur de mesures
ID 63:1043:1
Intervalles entre les opérations sur les tendances
ID de l’instance d’élément de service 1043 Instance d’évaluateur de mesures
ID 60:1043:1
ID de l’instance d’élément de service 1043 Instance d’évaluateur de mesures
ID 63:1043:1
Relance de tous les intervalles non traités qui ont déjà été arrêtés par
l’opération de relance.
Evaluation des intervalles entre les opérations
ID de l’instance d’élément de service 1029 Instance d’évaluateur de mesures
ID 49:1029:97
ID de l’instance d’élément de service 1042 Instance d’évaluateur de mesures
ID 49:1042:97
ID de l’instance d’élément de service 1028 Instance d’évaluateur de mesures
ID 50:1028:97
ID de l’instance d’élément de service 1028 Instance d’évaluateur de mesures
ID 48:1028:97
ID de l’instance d’élément de service 1041 Instance d’évaluateur de mesures
ID 48:1041:97
Intervalles entre les opérations sur les tendances
ID de l’instance d’élément de service 1029 Instance d’évaluateur de mesures
ID 49:1029:97
ID de l’instance d’élément de service 1042 Instance d’évaluateur de mesures
ID 49:1042:97
ID de l’instance d’élément de service 1028 Instance d’évaluateur de mesures
ID 50:1028:97
ID de l’instance d’élément de service 1028 Instance d’évaluateur de mesures
ID 48:1028:97
ID de l’instance d’élément de service 1041 Instance d’évaluateur de mesures
ID 48:1041:97
Voir aussi
scmd mem showStoppedRetry, scmd mem removeStoppedRetryEntries
108 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem showAllSLAIDs
Affiche tous les ID contrat SLA.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem showAllSLAIDs
Description
La commande scmd mem showAllSLAIDs affiche tous les ID contrat SLA
existants.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les ID contrat SLA.
scmd mem showAllSLAIDs
La sortie est similaire à l’exemple suivant :
ID contrat SLA : 1004
ID contrat SLA : 1003
ID contrat SLA : 1002
ID contrat SLA : 1001
ID contrat SLA : 1000
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 109
scmd mem showHourlyFrequencyIntervals
Active ou désactive la disponibilité des paramètres de fréquence d’évaluation
facultatifs pour évaluer les résultats plusieurs fois par jour.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem showHourlyFrequencyIntervals [enable |
disable]
Description
La commande scmd mem showHourlyFrequencyIntervals active ou désactive
l’option qui vous permet de définir une fréquence d’évaluation de plusieurs fois
par jour lors du processus de création d’offre.
En général, les applications source enregistrent des données dans Tivoli Data
Warehouse tous les jours, toutes les semaines ou tous les mois et IBM Tivoli
Service Level Advisor peut collecter et évaluer ces données aux mêmes fréquences
d’évaluation. Cependant, certaines applications source peuvent enregistrer des
données dans Tivoli Data Warehouse plusieurs fois par jour. Par exemple, il se
peut qu’une ressource critique de votre entreprise soit interrogée toutes les heures
quant aux données de disponibilité et que ces dernières soient enregistrées dans
Tivoli Data Warehouse une fois par heure. Si les ETL cible d’IBM Tivoli Service
Level Advisor sont planifiés pour collecter et évaluer ces données une fois par
heure, la fréquence d’évaluation qui est indiquée lors de la création d’offre, une
fois que des mesures sont définies pour l’objectif de niveau de service, doit
également être paramétrée sur une évaluation horaire.
Lors de la création d’offre, les fréquences d’évaluation qui peuvent être
sélectionnées dans la liste déroulante Fréquence de l’évaluation sont Quotidienne,
Hebdomadaire et Mensuelle. En émettant la commande
showHourlyFrequencyIntervals, vous pouvez activer les fréquences d’évaluation
supplémentaires suivantes :
v Toutes les heures
v Toutes les deux heures
v Toutes les trois heures
v Toutes les quatre heures
v Toutes les six heures
v Toutes les huit heures
v Toutes les douze heures
Vous pouvez ensuite créer des offres et inclure des mesures dans l’offre en
paramétrant la fréquence de l’évaluation sur une des valeurs ci-dessus. Une fois
cette commande émise, la prochaine fois que vous utiliserez le processus de
création d’offre, la liste déroulante Fréquence de l’évaluation comprend les options
de fréquence horaire supplémentaires.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
110 IBM Tivoli Service Level Advisor - Guide des commandes
enable Permet d’inclure les options de fréquence d’évaluation horaire
supplémentaires dans vos définitions de mesures.
disable Désactive la possibilité d’inclure les options de fréquence
d’évaluation horaire supplémentaires dans vos définitions de
mesures.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Si vous sélectionnez une de ces fréquences d’évaluation horaire pour effectuer des
évaluations, vous ne pouvez pas effectuer d’évaluations intermédiaires pour cette
mesure. Dans la page Paramètres de mesure avancés, la case correspondant aux
évaluations intermédiaires n’est pas cochée.
Vous ne devez activer les évaluations horaires que si des applications source
enregistrent des données dans Tivoli Data Warehouse plusieurs fois par jour. Pour
vérifier la fréquence à laquelle les données source sont enregistrées dans Tivoli
Data Warehouse et pour planifier vos ETL source et cible de façon appropriée,
adressez-vous à l’administrateur de base de données ou toute autre personne de
votre entreprise familiarisée avec le fonctionnement des applications source.
Le paramètre disable n’a aucune incidence sur les offres existantes qui évaluent la
tendance d’une mesure à une fréquence horaire.
Exemples
1. Activez les options de fréquence d’évaluation horaire dans la liste déroulante
Fréquence de l’évaluation :
scmd mem showHourlyFrequencyIntervals enable
La sortie de cette commande est similaire à l’exemple suivant :
Les options permettant de spécifier des intervalles de fréquence par heure
(moins de 24 heures) pour les évaluations de mesure ou analyses de tendance
ont été ACTIVEES.
Cette modification vous donne accès à d’autres choix d’intervalles de fréquence
inférieurs à 24 heures lors de la création d’offres.
Lors de la prochaine création ou modification d’une offre, une fois que des
mesures sont entrées, la liste déroulante Fréquence de l’évaluation contient les
options de fréquence horaire en sus des fréquences par défaut de Quotidienne,
Hebdomadaire et Mensuelle.
2. Désactivez les options de fréquence d’évaluation horaire dans la liste
déroulante Fréquence de l’évaluation :
scmd mem showHourlyFrequencyIntervals disable
La sortie de cette commande est similaire à l’exemple suivant :
Les options permettant de spécifier des intervalles de fréquence par heure
(moins de 24 heures) pour les évaluations de mesure ou analyses
de tendance ont été DESACTIVEES.
Cette modification ne s’applique que pendant la création de NOUVELLES offres.
Les offres existantes comportant déjà des intervalles de fréquence inférieurs
à 24 heures ne sont pas affectées par cette modification.
Lors de la prochaine création ou modification d’offres, les options de fréquence
d’évaluation sont limitées aux valeurs par défaut de Quotidienne, Hebdomadaire
ou Mensuelle.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 111
3. Indiquez si les fréquences d’évaluation horaires sont activées ou désactivées :
scmd mem showHourlyFrequencyIntervals
Si enable ou disable n’est pas spécifié, l’état en cours de ce paramètre s’affiche.
Voir aussi
Pour plus d’informations sur les évaluations horaires, reportez-vous au Guide
d’administration et au document Gestion des contrats de service.
112 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem showMetricEvaluators
Affiche des informations relatives à toutes les instances des évaluateurs de
mesures.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem showMetricEvaluators [–co
<ID_contrat_SLA> | <Nom_contrat_SLA>] [–v]
Description
La commande scmd mem showMetricEvaluators affiche des informations relatives
à chaque évaluateur de mesures, y compris les éléments suivants :
v ID contrat SLA
v ID de l’instance d’élément de service
v Nom de composant
v Description de chaque évaluateur de mesures
La sortie standard qui s’affiche est similaire à l’exemple suivant :
ID contrat SLA : 1000
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1000
0) ID évaluateur de mesures : 12:1000:1002
Contexte d’évaluateur de mesures : CONTEXT: 1000:12:27
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Tivoli Web Transaction Performance QoS Job
Nom/type de mesure : Heure aller-retour / 27
Nom de ressource : /BWM_EP_#5/BWM_QOS_#1
ID/type de composant : 12 / BWM_QOS
Dans cet exemple, l’ID contrat SLA affiché dans la partie supérieure est 1000.
L’index d’évaluateur de mesures est l’entier situé à gauche de l’intitulé, ID évaluateur
de mesures ; dans ce cas, il s’agit de 0.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–co <ID_contrat_SLA> | <nom_contrat_SLA>
Indique l’ID ou le nom du contrat SLA permettant de limiter la
portée de cette commande CLI. Cette zone est facultative.
–v Si ce paramètre facultatif est indiqué, les noms de contrat SLA, les
heures de début SLA et le nom de calendrier d’activité SLA
s’affichent. Chaque évaluateur de mesures affiche également les
états de calendrier et les informations de valeur de violation qui
leur sont associées.
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 113
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez une liste d’évaluateurs de mesures.
scmd mem showMetricEvaluators
Le résultat est peut-être similaire à l’exemple suivant :
ID contrat SLA : 1000
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1000
0) ID évaluateur de mesures : 17:1000:1007
Contexte d’évaluateur de mesures : CONTEXT: 1000:17:27
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Tivoli Web Transaction Performance QoS Job
Nom/type de mesure : Heure aller-retour / 27
Nom de ressource : /BWM_EP_#6/BWM_QOS_#2
ID/type de composant : 17 / BWM_QOS
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1001
1) ID évaluateur de mesures : 33:1001:1038
Contexte d’évaluateur de mesures : CONTEXT: 1000:33:9
Type d’évaluateur : EVAL_TYPE_B
Nom du composant d’offre : Gravité d’événement TEC
Nom/type de mesure : Evénements fermés dans un délai
de 30 à 60 minutes / 9
Nom de ressource : /iphost2.eco.tivoli.com/TEC_SOURCE_#2/SW
ID/type de composant : 33 / TEC_SEVERITY
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1002
2) ID évaluateur de mesures : 3:1002:1013
Contexte d’évaluateur de mesures : CONTEXT: 1000:3:27
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Tivoli Web Transaction Performance STI Job
Nom/type de mesure : Heure aller-retour / 27
Nom de ressource : /BWM_EP_#2/BWM_STI_#2
ID/type de composant : 3 / BWM_STI
ID contrat SLA : 1001
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1003
0) ID évaluateur de mesures : 40:1003:1024
Contexte d’évaluateur de mesures :
CONTEXT: 1001:40:TSLA.NumberOfOutages
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Nombre d’indisponibilités / Tous
Nom de ressource : /iphost3.eco.tivoli.com
ID/type de composant : 40 / IP_HOST
1) ID évaluateur de mesures : 40:1003:1025
Contexte d’évaluateur de mesures :
CONTEXT: 1001:40:TSLA.AvailabilityPercent
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Disponibilité / Tous
Nom de ressource : /iphost3.eco.tivoli.com
ID/type de composant : 40 / IP_HOST
2) ID évaluateur de mesures : 40:1003:1026
Contexte d’évaluateur de mesures : CONTEXT: 1001:40:TSLA.TimeToRepair
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Heure de réparation / Tous
Nom de ressource : /iphost3.eco.tivoli.com
ID/type de composant : 40 / IP_HOST
2. Affichez une liste d’évaluateurs de mesures pour l’ID contrat SLA 1001.
114 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem showMetricEvaluators -co 1001
Le résultat est peut-être similaire à l’exemple suivant :
ID contrat SLA : 1001
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1003
0) ID évaluateur de mesures : 40:1003:1024
Contexte d’évaluateur de mesures :
CONTEXT: 1001:40:TSLA.NumberOfOutages
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Nombre d’indisponibilités / Tous
Nom de ressource : /iphost3.eco.tivoli.com
ID/type de composant : 40 / IP_HOST
1) ID évaluateur de mesures : 40:1003:1025
Contexte d’évaluateur de mesures :
CONTEXT: 1001:40:TSLA.AvailabilityPercent
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Disponibilité / Tous
Nom de ressource : /iphost3.eco.tivoli.com
ID/type de composant : 40 / IP_HOST
2) ID évaluateur de mesures : 40:1003:1026
Contexte d’évaluateur de mesures : CONTEXT: 1001:40:TSLA.TimeToRepair
Type d’évaluateur : EVAL_TYPE_C
Nom du composant d’offre : Hôte IP
Nom/type de mesure : Heure de réparation / Tous
Nom de ressource : /iphost3.eco.tivoli.com
ID/type de composant : 40 / IP_HOST
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1004
3) ID évaluateur de mesures : 12:1004:1010
Contexte d’évaluateur de mesures : CONTEXT: 1001:12:-27
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Tivoli Web Transaction Performance QoS Job
Nom/type de mesure : Transaction réussie pour l’heure
aller-retour.
Nom de ressource : /BWM_EP_#5/BWM_QOS_#1
ID/type de composant : 12 / BWM_QOS
3. Affichez une liste d’évaluateurs de mesures pour l’ID contrat SLA 1000, en
indiquant l’option –v pour obtenir plus d’informations.
scmd mem showMetricEvaluators -co 1000 -v
Le résultat est peut-être similaire à l’exemple suivant :
ID contrat SLA : 1000
Nom du contrat SLA : IBM Worldwide Operations
Heure de début de la commande : 7/6/03 12:00:00 AM CDT
Calendrier d’activité : Calendrier 1
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1000
0) ID évaluateur de mesures : 17:1000:1007
Contexte d’évaluateur de mesures : CONTEXT: 1000:17:27
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Tivoli Web Transaction Performance QoS Job
Nom/type de mesure : Heure aller-retour / 27
Nom de ressource : /BWM_EP_#6/BWM_QOS_#2
ID/type de composant : 17 / BWM_QOS
Etat du calendrier : SCHEDULE_CRITICAL
Valeur minimale : 1.0
Valeur maximale : 99.7
Valeur moyenne : 51.0
Valeur totale : -1.0
Sens de la violation : Ordre décroissant
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1001
1) ID évaluateur de mesures : 33:1001:1038
Contexte d’évaluateur de mesures : CONTEXT: 1000:33:9
Type d’évaluateur : EVAL_TYPE_B
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 115
Nom du composant d’offre : Gravité d’événement TEC
Nom/type de mesure : Evénements fermés dans un délai
de 30 à 60 minutes / 9
Nom de ressource : /iphost2.eco.tivoli.com/TEC_SOURCE_#2/TEC
ID/type de composant : 33 / TEC_SEVERITY
Etat du calendrier : SCHEDULE_CRITICAL
Valeur minimale : 10.0
Valeur maximale : 60.0
Valeur moyenne : -1.0
Valeur totale : 600.0
Sens de la violation : Ordre décroissant
Liste des évaluateurs de mesure pour l’ID instance d’élément de service : 1002
2) ID évaluateur de mesures : 3:1002:1013
Contexte d’évaluateur de mesures : CONTEXT: 1000:3:27
Type d’évaluateur : EVAL_TYPE_A
Nom du composant d’offre : Tivoli Web Transaction Performance STI Job
Nom/type de mesure : Heure aller-retour / 27
Nom de ressource : /BWM_EP_#2/BWM_STI_#2
ID/type de composant : 3 / BWM_STI
Etat du calendrier : SCHEDULE_CRITICAL
Valeur minimale : 10.0
Valeur maximale : 90.0
Valeur moyenne : 40.0
Valeur totale : -1.0
Sens de la violation : Ordre décroissant
116 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem showRetrys
Affiche toutes les entrées qui sont à l’état de relance arrêtée et à l’état de relance
active.
Syntaxe
scmd [–p <motdepasse_en_cours>] mem showRetrys [–v]
Description
La commande scmd mem showRetrys affiche les entrées qui sont à l’état de relance
arrêtée et à l’état de relance active.
Des données sont extraites du magasin de données SLM Measurement de sorte
qu’elles soient traitées pour l’analyse des tendances et l’évaluation. Il se peut que
les données extraites ne soient pas disponibles dans le magasin de données SLM
Measurement au moment de l’évaluation, car l’application source a échoué ou
qu’elle a signalé uniquement une partie des données.
Pour conserver les données du magasin de données SLM Measurement à la suite
de l’évaluation, vous devez exécuter périodiquement un processus de relance. Une
entrée s’ajoute à cette méthode de relance chaque fois que les données extraites ne
sont pas disponibles. Dans ce cas, l’entrée passe à l’état de relance active. Un
nombre de relances fixe s’exécute pour chaque entrée à l’état de relance active. Une
fois que le nombre de relances configurable pour une entrée particulière est épuisé,
cette entrée est supprimée de l’état de relance active et placée dans l’état de relance
arrêtée. Cette commande CLI permet d’afficher les entrées qui sont à l’état de
relance arrêtée.
Elle affiche également les entrées qui sont associées à l’état de relance active. Les
entrées à l’état de relance arrêtée s’affichent au-dessus de la ligne de séparation.
Les entrées à l’état de relance active s’affichent sous la ligne de séparation.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–v Si cette option est indiquée, les noms de contrat SLA s’affichent.
Cette zone est facultative.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être utilisée que lors d’une reprise sur incident.
Si aucune donnée n’est extraite dans les rapports pour une ressource ou un contrat
SLA particulier, il est possible que certaines données soient perdues du fait de
l’échec de l’application source ou pour une autre raison. Pour vérifier si une
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 117
application source signale des données partielles ou aucune donnée, exécutez la
commande scmd mem showRetrys pour afficher les entrées à l’état de relance
active et à l’état de relance arrêtée. Vérifiez l’application source liée au contrat SLA
ou à la ressource, puis assurez-vous qu’elle signale correctement des données. Si
l’application source signale des données dans le magasin de données SLM
Measurement, vous devez exécuter la commande scmd mem retryMissedIntervals
pour que l’évaluation et l’analyse des tendances se produisent pour toutes les
entrées. Si vous êtes certain que l’application source ne signale jamais ces données,
vous pouvez exécuter la commande scmd mem removeStoppedRetryEntries pour
ce contrat SLA particulier, afin de supprimer des entrées à l’état de relance arrêtée.
Exemples
Affichez toutes les entrées qui sont à l’état de relance arrêtée.
scmd mem showRetrys
La sortie de cette commande est peut-être similaire à l’exemple suivant :
Evaluation des intervalles entre les opérations
ID contrat SLA 1005
ID de l’instance d’élément de service 1028
Nom de ressource /fvtaix18.rtp.lab.tivoli.com/slmfvt9 job_name1
ID de l’instance d’évaluateur de mesures 50:1028:97
ID contrat SLA 1005
ID de l’instance d’élément de service 1028
Nom de ressource /fvtsol17/slmfvt8 job3
ID de l’instance d’évaluateur de mesures 48:1028:97
ID contrat SLA 1005
ID de l’instance d’élément de service 1029
Nom de ressource /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playback
ID de l’instance d’évaluateur de mesures 49:1029:97
ID contrat SLA 1008
ID de l’instance d’élément de service 1041
Nom de ressource /fvtsol17/slmfvt8 job3
ID de l’instance d’évaluateur de mesures 48:1041:97
ID contrat SLA 1008
ID de l’instance d’élément de service 1042
Nom de ressource /SLMFVT5.rtp.lab.tivoli.com/slmfvt5_sti playback
ID de l’instance d’évaluateur de mesures 49:1042:97
Relances actives des intervalles non traités
Evaluation des intervalles entre les opérations
ID contrat SLA 1008
ID de l’instance d’élément de service 1043
Nom de ressource /dellxps32.ivt.rtp.lab.tivoli.com/Administrator/web_page_dl_times/
http://corp.tivoli.comm
ID de l’instance d’évaluateur de mesures 63:1043:1
Intervalles entre les opérations sur les tendances
ID contrat SLA 1008
ID de l’instance d’élément de service 1043
Nom de ressource /dellxps32.ivt.rtp.lab.tivoli.com/Administrator/web_page_dl_times/
http://corp.tivoli.comm
ID de l’instance d’évaluateur de mesures 63:1043:1
118 IBM Tivoli Service Level Advisor - Guide des commandes
Voir aussi
scmd mem retryMissedIntervals, scmd mem removeStoppedRetryEntries
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 119
scmd mem skipHistoricSLAs
Ignore l’évaluation historique des contrats SLA qui ont été soumis avec une date
de début dans le passé mais qui n’ont pas encore été déployés ou évalués.
Syntaxe
scmd [ –p <motdepasse_en_cours>] mem skipHistoricalSLAs
Description
Lors de la soumission de plusieurs contrats SLA dont la date de début est dans le
passé, il se peut que le serveur SLM soit bloqué car les contrats SLA n’ont pas
terminé le traitement de leurs évaluations historiques, ce qui, dans certains cas,
peut prendre un temps considérable.
Le redémarrage du serveur SLM, qui donne généralement lieu à l’annulation d’une
condition de blocage, n’est pas applicable dans ce cas car la prochaine évaluation
historique commence après le redémarrage du serveur SLM, ce qui occasionne le
retour de la condition. L’annulation automatique de toutes les évaluations
historiques après le redémarrage du serveur SLM n’est pas admissible dans la
plupart des cas.
La commande scmd mem skipHistoricSLAs permet d’indiquer que tous les
contrats SLA soumis dont la date de début est dans le passé et qui n’ont pas
encore été déployés ou évalués par IBM Tivoli Service Level Advisor ne doivent
pas faire l’objet d’évaluations historiques mais doivent être déployés en vue de la
prochaine évaluation planifiée.
Si le composant évaluateur de mesures d’IBM Tivoli Service Level Advisor est en
cours de restauration par suite du redémarrage du serveur SLM, aucune évaluation
historique n’est effectuée. Si le serveur est arrêté lors du traitement des évaluations
historiques au niveau d’un objectif de niveau de service, cette évaluation spécifique
ne reprend pas lors du redémarrage du serveur.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Exécutez la commande pour ignorer les évaluations historiques des contrats
SLA qui ont été soumis avec une date de début dans le passé mais qui n’ont
pas encore été déployés ou évalués :
scmd mem skipHistoricalSLAs
120 IBM Tivoli Service Level Advisor - Guide des commandes
scmd mem trending
Affiche ou définit la liste en cours des valeurs d’intervalle de tendance.
Syntaxe
scmd [ –p <motdepasse_en_cours>] mem trending {view | set –warningPeriod
<intervalle_temps> –trendMethod {linear | exponential | all}}
Description
La commande scmd mem trending affiche les paramètres d’intervalle de temps en
cours ou affecte à l’algorithme individuel un intervalle de tendance particulier.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
view Affiche la liste en cours des valeurs d’intervalle de tendance.
set Affecte l’intervalle indiqué au type de tendance entré. Vous devez
indiquer au moins une méthode de tendance associée à une
période d’avertissement.
–warningPeriod <intervalle_temps>
Indique le nombre d’intervalles de temps à venir, qui détermine si
une tendance existe. Si cette valeur indique 0, l’algorithme indiqué
est désactivé.
–trendMethod Indique le type de tendance spécifique (linear, exponential ou all)
à associer à l’intervalle donné.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez les valeurs d’intervalle de tendance en cours :
scmd mem trending view
Le résultat est peut-être similaire à l’exemple suivant :
Méthode de tendance Période d’avertissement
=========================================
Linéaire 2
Exponentiel 2
Chapitre 6. Commandes du gestionnaire de l’évaluateur de mesures 121
2. Paramétrez le nombre d’intervalles de tendance sur 3 périodes d’avertissement
pour la méthode de tendance linéaire :
scmd mem trending set -warningPeriod 3 -trendMethod linear
Lorsqu’une autre commande scmd mem trending view est émise, la sortie
suivante s’affiche :
Méthode de tendance Période d’avertissement
=========================================
Linéaire 3
Exponentiel 2
122 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 7. Commandes offline
La présente section décrit les commandes CLI qui permettent la mise à jour des
noms de composant, la migration des données de définition de contrat SLA ou le
remplacement des informations de mesure par défaut pour la migration ETL, telles
qu’elles sont présentées dans le tableau 9 :
Tableau 9. Commandes CLI offline
Commande CLI Page
scmd offline createOfferinginXML 124
scmd offline help 126
scmd offline list 127
scmd offline migrateSLAs 128
scmd offline updateNames 130
scmd offline updateOffering 132
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis, sauf dans le cas des
commandes scmd setPasswordEnabled et scmd setPassword qui
nécessitent systématiquement un mot de passe.
© Copyright IBM Corp. 2002, 2004 123
scmd offline createOfferinginXML
Exporte des informations de mesures sélectives d’une offre vers un fichier XML.
Syntaxe
scmd [–p <motdepasse_en_cours>] offline createOfferinginXML <nom_offre>
<nom_fichier_XML_sortie>
Description
Lors d’une migration ETL source, il se peut que la modélisation des données ait été
modifiée de sorte que les mesures qui étaient disponibles à partir du processus
ETL avant la migration et qui ne le sont plus soient automatiquement mappées
vers de nouvelles mesures une fois la migration terminée. Lors du processus de
migration de ces processus ETL, des valeurs de violation sont automatiquement
générées pour les nouvelles mesures. La commande scmd offline
createOfferinginXML permet d’exporter des informations de mesure contenues
dans une offre et de les enregistrer dans un fichier XML où vous pouvez remplacer
les valeurs de violation générées dans la migration ETL.
Une fois les modifications effectuées, vous pouvez importer de nouveau le fichier
XML vers IBM Tivoli Service Level Advisor à l’aide de la commande scmd offline
updateOffering.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nom_offre> Indique le nom de l’offre qui contient les informations de mesure
par défaut à modifier. Il s’agit du nom de l’offre, tel qu’il est
affiché dans la table Offres de la page Gérer les offres de la console
d’administration SLM.
<nom_fichier_XML_sortie>
Indique le chemin et le nom complets du fichier XML vers lequel
vous souhaitez exporter les informations relatives à l’offre.
Classe d’autorisation
Aucune autorisation n’est requise.
Remarques
Cette commande n’est prise en charge que lors de la migration des processus ETL
développés par IBM à l’appui de la migration des contrats SLA. Cette commande
ne doit être utilisée que selon les instructions explicitement indiquées dans la
documentation du module d’intégration d’application source.
Cette commande ne doit être émise que lors des périodes d’inactivité du serveur
SLM (par exemple, pendant les heures creuses ou les heures de maintenance).
124 IBM Tivoli Service Level Advisor - Guide des commandes
Exemples
Exportez les informations relatives à l’offre intitulée Offre1 vers le fichier XML situé
dans C:\TSLA\offer1.xml :
scmd offline createOfferinginXML Offre1 C:\TSLA\offer1.xml
Voir aussi
scmd offline updateOffering
Chapitre 7. Commandes offline 125
scmd offline help
Affiche la syntaxe et des exemples pour le regroupement de commandes scmd
offline.
Syntaxe
scmd [–p <motdepasse_en_cours>] offline help
Description
La commande scmd offline help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd offline.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes offline.
scmd offline help
126 IBM Tivoli Service Level Advisor - Guide des commandes
scmd offline list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd offline.
Syntaxe
scmd [–p <motdepasse_en_cours>] offline list
Description
La commande scmd offline list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd offline.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd offline.
scmd offline list
Chapitre 7. Commandes offline 127
scmd offline migrateSLAs
Permet la migration des données de définition de contrat SLA, y compris les offres
de service et les contrats SLA, pour les éditions de processus ETL prises en charge.
Syntaxe
scmd [–p <motdepasse_en_cours>] offline migrateSLAs <type_composant_origine>
<nouveau_type_composant>
Description
La commande scmd offline migrateSLAs permet la migration automatique des
données de définition de contrat SLA, y compris les offres et les contrats SLA,
pour les éditions de processus ETL prises en charge.
Remarque : Toutes les éditions de processus ETL ne prennent pas en charge ou ne
nécessitent pas la migration de leurs données de définition de contrat
SLA. Certaines applications source Tivoli ont modifié leur modèle de
données dans les éditions de processus ETL ultérieures, de sorte que
les contrats SLA contiennent des composants d’offre et des ressources
non valides. Pour déterminer si cette commande doit être utilisée pour
la migration des contrats SLA dans IBM Tivoli Service Level Advisor,
consultez la documentation du module d’intégration ETL source.
Cette commande permet d’effectuer les tâches suivantes :
v Expiration automatique des composants d’offre appropriés
v Génération de nouveaux composants d’offre
v Mise à jour de toutes les ressources des contrats SLA contenant ces composants
d’offre
Une fois que les scripts de migration IBM Tivoli Service Level Advisor ont été
exécutés, la console d’administration SLM empêche que les types de composant
arrivés à expiration soient ajoutés sous forme de composants d’offre à de nouvelles
offres, et indique si un composant d’une offre existante est arrivé à expiration.
L’interface Rapports SLM indique également dans la section relative aux
informations de commandes SLA du rapport général si un composant d’offre est
arrivé à expiration.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<type_composant_origine>
Indique le nom du type de composant à remplacer.
<nouveau_type_composant>
Indique le nom du type de composant à placer dans le contrat
SLA.
128 IBM Tivoli Service Level Advisor - Guide des commandes
Classe d’autorisation
Aucune autorisation n’est requise.
Remarques
Cette commande n’est prise en charge que lors de la migration des processus ETL
développés par IBM à l’appui de la migration des contrats SLA. Cette commande
ne doit être utilisée que selon les instructions explicitement indiquées dans la
documentation du module d’intégration d’application source.
Cette commande CLI place provisoirement le serveur SLM en mode maintenance, ce
qui signifie que plusieurs composants internes d’IBM Tivoli Service Level Advisor
sont arrêtés lors de l’exécution de l’interface de ligne de commande (CLI). Avant la
fin du processus de l’interface de ligne de commande, ces composants internes
redémarrent.
Cette commande ne doit PAS être émise au cours de l’exécution des évaluations ou
lorsqu’un autre utilisateur définit une offre ou crée un contrat SLA. Cette
commande ne doit être émise que lors des périodes d’inactivité du serveur SLM.
Exemples
Migration des données de définition de contrat SLA de BWM_QOS vers
BWM_TX_NODE :
scmd offline migrateSLAs BWM_QOS BWM_TX_NODE
Voir aussi
Chapitre 7. Commandes offline 129
scmd offline updateNames
Met à jour les noms de ressources dans les contrats SLA existants.
Syntaxe
scmd [–p <motdepasse_en_cours>] offline updateNames [–migrate]
Description
La commande scmd offline updateNames met à jour les noms de ressources dans
les contrats SLA existants, lorsque les processus ETL utilisent la méthode d’attribut
de nom standard de l’entrepôt pour associer un composant à un nouveau nom.
Cette méthodologie est utilisée par tous les processus ETL source Tivoli qui
prennent en charge les changements de nom de composant.
Lorsqu’une ressource est renommée par une application source, le nouveau nom
est utilisé jusqu’à l’enregistrement des données dans l’entrepôt de données de cette
ressource. Cependant, les données précédemment enregistrées dans l’entrepôt à
l’aide de l’ancien nom de ressource figurent également dans l’entrepôt. En fonction
de la plage de dates utilisée par IBM Tivoli Service Level Advisor pour obtenir des
données de mesure à évaluer, il se peut que des données portant l’ancien ou le
nouveau nom de ressource soient incluses.
Si vos applications source peuvent renommer des ressources, vous devez exécuter
la commande scmd offline updateNames périodiquement (par exemple, une fois
par mois) afin d’utiliser les nouveaux noms de ressource. Les noms de ressource
existants des rapports SLM s’affichent toujours à l’aide du nom d’origine, mais les
rapports générés à partir de données plus récentes contiennent le nom nom de
ressource. Les nouveaux noms des ressources ne prennent pas effet
automatiquement dans la console d’administration SLM ou dans les rapports.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–migrate Cette option permet d’exécuter le code de migration de composant
partagé pour Tivoli Business Systems Manager version 2.1.
N’utilisez pas cette option, sauf indications contraires fournies par
le service de support client Tivoli ou les procédures décrites dans
la documentation Tivoli Business Systems Manager version 2.1.
Classe d’autorisation
Aucune autorisation n’est requise.
Remarques
Cette commande n’est prise en charge que lors de la migration des processus ETL
développés par IBM à l’appui de la migration des contrats SLA. Cette commande
ne doit être utilisée que selon les instructions explicitement indiquées dans la
documentation du module d’intégration d’application source.
130 IBM Tivoli Service Level Advisor - Guide des commandes
Cette commande CLI place provisoirement le serveur SLM en mode maintenance, ce
qui signifie que plusieurs composants internes d’IBM Tivoli Service Level Advisor
sont arrêtés lors de l’exécution de l’interface de ligne de commande (CLI). Avant la
fin du processus de l’interface de ligne de commande, ces composants internes
redémarrent.
Cette commande ne doit PAS être émise au cours de l’exécution des évaluations ou
lorsqu’un autre utilisateur définit une offre ou crée un contrat SLA. Cette
commande ne doit être émise que lors des périodes d’inactivité du serveur SLM.
Exemples
Emettez une commande pour mettre à jour des noms de ressource :
scmd offline updateNames
Emettez une commande pour mettre à jour des noms de ressource et exécuter le
code de migration de composant partagé pour Tivoli Business Systems Manager
2.1 :
scmd offline updateNames -migrate
Voir aussi
scmd offline updateOffering
Chapitre 7. Commandes offline 131
scmd offline updateOffering
Importe de nouveau vers IBM Tivoli Service Level Advisor les informations de
mesure qui ont été exportées vers un fichier XML.
Syntaxe
scmd [–p <motdepasse_en_cours>] offline updateOffering <nom_fichier_XML>
Description
La commande scmd offline updateOffering permet de ré-importer vers IBM Tivoli
Service Level Advisor les informations de mesure qui ont été exportées vers un
fichier XML. Ce fichier XML doit avoir été créé à l’aide de la commande scmd
offline createOfferinginXML.
Lorsque vous utilisez cette commande conjointement avec la commande scmd
offline createOfferinginXML, vous pouvez remplacer les informations de mesure
par défaut d’une offre en les enregistrant dans un fichier XML provisoire, puis en
apportant les modifications et en les ré-important ensuite vers IBM Tivoli Service
Level Advisor. Cela est utile lors de la migration des processus ETL à l’appui de la
migration de contrats SLA.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nom_fichier_XML>
Indique le chemin et le nom complets du fichier XML que vous
souhaitez importer vers IBM Tivoli Service Level Advisor.
Classe d’autorisation
Aucune autorisation n’est requise.
Remarques
Cette commande n’est prise en charge que lors de la migration des processus ETL
développés par IBM à l’appui de la migration des contrats SLA. Cette commande
ne doit être utilisée que selon les instructions explicitement indiquées dans la
documentation du module d’intégration d’application source.
Cette commande ne doit être émise que lors des périodes d’inactivité du serveur
SLM (par exemple, pendant les heures creuses ou les heures de maintenance).
Exemples
Importez les informations de mesure figurant dans le fichier XML qui se trouve
dans C:\TSLA\offer1.xml :
scmd offline updateOffering C:\TSLA\offer1.xml
132 IBM Tivoli Service Level Advisor - Guide des commandes
Voir aussi
scmd offline createOfferinginXML
Chapitre 7. Commandes offline 133
134 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 8. Commandes du gestionnaire de commandes
La présente section décrit les commandes CLI que vous pouvez utiliser pour le
composant gestionnaire de commandes d’IBM Tivoli Service Level Advisor, telles
qu’elles sont présentées dans le tableau 10.
Tableau 10. Commandes CLI du gestionnaire de commandes
Commande CLI Page
scmd om help 136
scmd om list 137
scmd om redeployCompletedSLAs 138
scmd om submitSLA 140
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis, sauf dans le cas des
commandes scmd setPasswordEnabled et scmd setPassword qui
nécessitent systématiquement un mot de passe.
© Copyright IBM Corp. 2002, 2004 135
scmd om help
Affiche la syntaxe et des exemples pour le regroupement de commandes scmd om.
Syntaxe
scmd [–p <motdepasse_en_cours>] om help
Description
La commande scmd om help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd om.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes om.
scmd om help
136 IBM Tivoli Service Level Advisor - Guide des commandes
scmd om list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd om.
Syntaxe
scmd [–p <motdepasse_en_cours>] om list
Description
La commande scmd om list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd om.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd om.
scmd om list
Chapitre 8. Commandes du gestionnaire de commandes 137
scmd om redeployCompletedSLAs
Recherche dans la base de données SLM les contrats SLA terminés et les redéploie
sur le composant gestionnaire de l’évaluateur de mesures d’IBM Tivoli Service
Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] om redeployCompletedSLAs
Description
Il est peut-être nécessaire de recharger en intégralité le gestionnaire de l’évaluateur
de mesures avec tous les contrats SLA sur lesquels il doit établir des rapports. Par
exemple, le serveur exécutant le composant gestionnaire de l’évaluateur de
mesures risque de ne pas fonctionner et de perdre la liste des contrats SLA à traiter
par le gestionnaire de l’évaluateur de mesures. Cette commande permet une
reprise à la suite de ces situations.
La commande scmd om redeployCompletedSLAs permet de rechercher dans la
base de données SLM les contrats SLA terminés et de les redéployer sur le
composant gestionnaire de l’évaluateur de mesures d’IBM Tivoli Service Level
Advisor. Elle sert à récupérer les données si le gestionnaire de l’évaluateur de
mesures perd ses données rémanentes. Il n’y a aucun risque si le gestionnaire de
l’évaluateur de mesures a déjà déployé ces contrats SLA.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être émise par un administrateur SLM que lors d’une
reprise sur incident.
Exemples
En raison d’une utilisation accrue, un serveur de plus grande taille est requis pour
le logiciel IBM Tivoli Service Level Advisor, mais le serveur de la base de données
SLM est satisfaisant. Une fois le logiciel IBM Tivoli Service Level Advisor installé et
configuré sur un serveur de plus grande taille, exécutez la commande
reDeployCompletedSLAs pour recharger le composant gestionnaire de l’évaluateur
de mesures avec les SLA que celui-ci doit traiter.
scmd om redeployCompletedSLAs
138 IBM Tivoli Service Level Advisor - Guide des commandes
La sortie de la commande scmd om redeployCompletedSLAs présente le
déroulement du traitement de chaque contrat SLA :
DYKOM1057I Le traitement du contrat SLA a été démarré.
DYKOM1035I Nombre total de contrats SLA lus à partir de la base de données SLM : 5
DYKOM1043I Nombre total de contrats SLA à re-traiter : 3
DYKMO1040I 1. Préparation du contrat SLA : 1032
DYKOM1033I 1. Traitement du contrat SLA : 1032
DYKOM1040I 2. Préparation du contrat SLA: 1036
DYKOM1033I 2. Traitement du contrat SLA : 1036
DYKOM1040I 3. Préparation du contrat SLA : 1044
DYKOM1033I 3. Traitement du contrat SLA : 1044
DYKOM1050I Fin du traitement du contrat SLA.
L’exemple de sortie ci-dessus indique que la base de données SLM contient cinq
contrats SLA dont trois sont à l’état terminé. L’étape de préparation consiste à lire le
contrat SLA à partir de la base de données et à le préparer à des fins de
déploiement sur le composant gestionnaire de l’évaluateur de mesures. L’étape de
traitement consiste à envoyer le contrat SLA au composant gestionnaire de
l’évaluateur de mesures.
Chapitre 8. Commandes du gestionnaire de commandes 139
scmd om submitSLA
Soumet un contrat SLA de la base de données SLM au composant gestionnaire de
commandes d’IBM Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] om submitSLA [<ID_contrat_SLA> |
<nom_contrat_SLA>
Description
Il est parfois nécessaire de re-soumettre un contrat SLA au composant gestionnaire
de commandes d’IBM Tivoli Service Level Advisor, mais la nouvelle soumission ne
peut pas être effectuée à l’aide de l’interface IBM Console. La commande scmd om
submitSLA soumet au gestionnaire de commandes le contrat SLA indiqué, quel
qu’en soit l’état en cours.
scmd om submitSLA <ID_contrat_SLA>
scmd om submitSLA <nom_contrat_SLA>
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID numérique du contrat SLA. Ce contrat SLA doit déjà
exister dans la base de données SLM.
<nom_contrat_SLA>
Indique le nom du contrat SLA. Ce contrat SLA doit déjà exister
dans la base de données SLM.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être émise par un administrateur SLM que lors d’une
reprise sur incident.
Exemples
Un utilise crée le contrat SLA numéro 1046 mais, une fois le contrat SLA soumis,
celui-ci n’est pas envoyé, pour une raison ou pour une autre, au gestionnaire de
commandes à des fins de traitement. En revanche, le contrat SLA reste à l’état
soumis. Vous pouvez envoyer ce contrat SLA manuellement à l’aide de la
commande suivante :
scmd om submitSLA 1046
L’exemple suivant présente un exemple de sortie :
DYKOM1045I La ligne de commande OM a soumis ce
contrat SLA 1046 au gestionnaire de commandes.
140 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 9. Commandes de communication à distance
La présente section décrit les commandes CLI que vous pouvez utiliser pour la
communication à distance, telles qu’elles sont présentées dans le tableau 11.
Tableau 11. Commandes CLI pour la communication à distance
Commande CLI Page
scmd rcc getPort 142
scmd rcc help 143
scmd rcc list 144
scmd rcc setPort 145
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis, sauf dans le cas des
commandes scmd setPasswordEnabled et scmd setPassword qui
nécessitent systématiquement un mot de passe.
© Copyright IBM Corp. 2002, 2004 141
scmd rcc getPort
Répertorie le port qui est utilisé pour la communication à distance avec ce serveur.
Syntaxe
scmd [–p <motdepasse_en_cours>] rcc getPort
Description
La commande scmd rcc getPort répertorie le port qui est utilisé pour la
communication à distance avec ce serveur. Pour modifier le port, vous devez
redémarrer le serveur de sorte que le nouveau port soit activé. Si le port a été
modifié et que le serveur n’a pas encore été redémarré, la valeur en cours et la
nouvelle valeur s’affichent.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Répertoriez le port en cours.
scmd rcc getPort
Le résultat est similaire à l’exemple suivant :
DYKAL9056I Port en cours : 9980
Voir aussi
scmd rcc setPort, rcomutil
142 IBM Tivoli Service Level Advisor - Guide des commandes
scmd rcc help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd rcc.
Syntaxe
scmd [–p <motdepasse_en_cours>] rcc help
Description
La commande scmd rcc help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd rcc.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes rcc.
scmd rcc help
Chapitre 9. Commandes de communication à distance 143
scmd rcc list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd rcc.
Syntaxe
scmd [–p <motdepasse_en_cours>] rcc list
Description
La commande scmd rcc list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd rcc.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd rcc.
scmd rcc list
144 IBM Tivoli Service Level Advisor - Guide des commandes
scmd rcc setPort
Définit le numéro de port à utiliser pour la communication à distance avec ce
serveur.
Syntaxe
scmd [–p <motdepasse_en_cours>] rcc setPort <port>
Description
La commande scmd rcc setPort définit le numéro de port à utiliser pour la
communication à distance avec ce serveur. Le serveur doit être redémarré pour que
le nouveau port soit activé.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<port> Indique le numéro de port à utiliser pour la communication à
distance.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Remplacez le port de communication à distance par 9981.
scmd rcc setPort 9981
Le port est paramétré sur le nouveau numéro et le message suivant est émis :
DYKAL0066I Le port de communication à distance a été mis à jour.
Le serveur doit être redémarré pour que la nouvelle valeur puisse être utilisée.
Voir aussi
scmd rcc getPort, rcomutil
Chapitre 9. Commandes de communication à distance 145
146 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 10. Commandes d’utilisateur de rapport Web
La présente section décrit les commandes CLI que vous pouvez utiliser pour
ajouter, supprimer, modifier et répertorier des informations relatives aux
utilisateurs qui accèdent aux sites Web des clients pour visualiser des rapports. Les
commandes disponibles sont présentées dans le tableau 12.
Tableau 12. Commandes CLI permettant l’authentification des utilisateurs de la console
Rapports SLM
Commande CLI Page
scmd report addUser 148
scmd report changeUser 154
scmd report deleteUser 158
scmd report displayTimezones 159
scmd report help 161
scmd report list 162
scmd report listUser 163
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 147
scmd report addUser
Ajoute dans la base de données SLM un utilisateur existant du registre
d’utilisateurs du système d’exploitation local ou d’un autre service d’annuaire et
octroie le droit d’accès à la console Rapports SLM.
Syntaxe
scmd [–p <motdepasse_en_cours>] report addUser –name <nom> –view {1 | 2 | 3}
[–customer <client>] [–realm <domaine>] [–page <page>] [–userType {1 | 2 | 3}]
[–timezone <index_fuseau_horaire>] [–int {true | false}]
Description
La commande scmd report addUser permet d’ajouter un nouvel utilisateur de
rapports SLM dans la liste des utilisateurs autorisés de la base de données SLM et
d’octroyer le droit de visualisation si l’accès à certains rapports doit être limité
pour cet utilisateur.
Avant que ce nom d’utilisateur puisse être utilisé pour la connexion à la console
rapports SLM, le nom d’utilisateur indiqué doit être défini dans le registre
d’utilisateurs du système d’exploitation local ou dans un autre service d’annuaire
utilisateur, par exemple, LDAP (Lightweight Directory Access Protocol). Par
exemple, sous Windows 2000, vous pouvez accéder au registre d’utilisateurs
(supposant que vous vous êtes connecté en tant qu’utilisateur disposant de droits
administrateur) et créer un nouvel utilisateur en exécutant la procédure suivante :
1. Sélectionnez Démarrer –> Paramètres –> Panneau de configuration
2. Sélectionnez Outils d’administration
3. Sélectionnez Gestion de l’ordinateur
4. Dans Outils système, développez Utilisateurs et groupes locaux
5. Cliquez à l’aide du bouton droit de la souris sur le dossier Utilisateurs et
sélectionnez Nouvel utilisateur.
6. Définissez le nom d’utilisateur, entrez une description, sélectionnez un mot de
passe, puis cliquez sur Créer pour créer le nouvel utilisateur dans le registre
d’utilisateurs du système d’exploitation Windows local.
Remarque : Consultez la documentation de votre système d’exploitation pour
connaître les procédures permettant de définir de nouveaux
utilisateurs à insérer dans votre registre, ou encore dans un autre
service d’annuaire.
Une fois que le nom d’utilisateur a été ajouté dans le registre d’utilisateurs du
système d’exploitation local ou dans un service d’annuaire utilisateur, vous pouvez
utiliser la commande scmd report addUser pour créer dans la base de données
SLM un compte utilisateur dont les attributs sont spécifiés. Cette commande
permet d’effectuer les tâches suivantes :
v Indiquer le nom d’utilisateur à partir du registre d’utilisateurs du système
d’exploitation local ou d’un service d’annuaire utilisateur.
v Indiquer le droit d’authentification de cet utilisateur, lui permettant de visualiser
des rapports sans restriction ou de limiter le droit de visualisation de
l’utilisateur uniquement aux rapports correspondant à un nom de client et/ou
de domaine spécifique.
v Limiter le droit de visualisation de l’utilisateur aux données classées comme
étant externes et empêcher l’utilisateur de visualiser les données réservées à
l’usage interne uniquement.
148 IBM Tivoli Service Level Advisor - Guide des commandes
v Indiquer la page d’accueil initiale vers laquelle l’utilisateur est transféré une fois
qu’il se connecte au site Web du client.
v Indiquer un type d’utilisateur pour les utilisateurs de rapport, afin d’autoriser ce
nom d’utilisateur à afficher des rapports du point de vue d’un cadre d’entreprise,
d’un client ou d’un technicien.
v Indiquer un fuseau horaire spécifique à un utilisateur. Cette option est
généralement utilisée lorsqu’un contrat SLA a été configuré pour un utilisateur
spécifique situé dans un fuseau horaire différent de celui du serveur SLM.
v Indiquer si les résultats d’évaluation intermédiaires des rapports SLM doivent
ou non être affichés. Si cette fonction est activée, une icône spéciale apparaît
dans les rapports à l’emplacement approprié, de sorte que les résultats soient
identifiés à partir d’évaluations intermédiaires. Il est à noter que si des résultats
d’évaluation intermédiaires sont activés à des fins d’affichage, il se peut que les
performances soient ralenties en raison du traitement supplémentaire requis.
Une fois que cette commande aboutit, vous pouvez vous connecter à la console
Rapports SLM, à l’aide de ce nom d’utilisateur et du mot de passe associé, et
afficher des rapports SLM à partir d’un navigateur Web.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–name <nom> Indique le nom d’utilisateur. Ce nom est requis pour qu’un
utilisateur se connecte à l’application.
Remarque sur les noms d’utilisateur contenant des majuscules et
des minuscules : Si vous utilisez un service d’annuaire utilisateur
qui ignore les caractères majuscules, par exemple, LDAP
(Lightweight Directory Access Protocol), veillez à créer des noms
d’utilisateur comprenant uniquement des caractères minuscules.
–view {1 | 2 | 3}
Indique les droits de l’utilisateur. Le paramètre indiqué est un
entier ayant pour valeur 1, 2 ou 3, qui est défini comme suit :
Vue Droit Explications
1 Illimité Un utilisateur disposant de
droits illimités peut
visualiser tous les rapports.
2 Restreint Un utilisateur disposant de
droits restreints ne peut
visualiser que les rapports
du client et du domaine
indiqués
Chapitre 10. Commandes d’utilisateur de rapport Web 149
Vue Droit Explications
3 Externe Un utilisateur disposant de
droits externes peut
visualiser uniquement les
rapports du client et du
domaine indiqués.
L’utilisateur est autorisé à
visualiser uniquement les
données qui n’ont pas été
classées comme étant
réservées à l’usage interne (la
valeur de isInternal est false
dans les données restreintes).
–customer <client>
Indique le nom du client pour lequel l’utilisateur est autorisé à
afficher les données dans les rapports. Si le nom contient un
espace, la totalité du nom de client doit être placée entre
guillemets. Ce nom doit être prédéfini dans la base de données
SLM. Si un nom de client n’est pas indiqué, cet utilisateur est
autorisé à afficher des résultats pour tous les clients de la base de
données (si un nom de domaine est indiqué, le droit de
visualisation de l’utilisateur est limité à tous les clients associés à
ce domaine).
–realm <domaine>
Indique le nom du domaine pour lequel l’utilisateur est autorisé à
afficher les données dans les rapports. Si le nom contient un
espace, la totalité du nom de domaine doit être placée entre
guillemets. Ce nom doit être prédéfini dans la base de données
SLM. Si un nom de domaine n’est pas indiqué, cet utilisateur est
autorisé à afficher des résultats pour tous les domaines de la base
de données (si un nom de client est indiqué, le droit de
visualisation de l’utilisateur est limité à ce client dans tous les
domaines associés).
–page <page> Indique le rapport initial, ou page d’accueil, à afficher une fois que
l’utilisateur se connecte au site Web pour afficher des rapports. Si
une page d’accueil n’est pas indiquée au moment de la création
d’utilisateur, cette valeur est paramétrée sur report.jsp?fsd=r7d, où
?fsd=r7d indique une plage de dates de la semaine passée dont le
format est Au cours des sept derniers jours. Vous pouvez être amené
à utiliser cette option si vous créez une page de rapport
personnalisée que vous souhaitez afficher à la place de la page de
rapport par défaut.
–userType {1 | 2 | 3}
Indique le type d’utilisateur pour l’affichage des rapports. Le
paramètre indiqué est un entier ayant pour valeur 1, 2 ou 3, qui est
défini comme suit :
Type
d’utilisateur Utilisateur Explications
1 Operations Ce type d’utilisateur peut visualiser des rapports
détaillés d’exploitation destinés au personnel de
l’entreprise. Il s’agit du type d’utilisateur par défaut
utilisé si aucun type n’est spécifié.
150 IBM Tivoli Service Level Advisor - Guide des commandes
Type
d’utilisateur Utilisateur Explications
2 Executive Ce type d’utilisateur peut visualiser des rapports
récapitulatifs de plus haut niveau (destinés aux cadres
de l’entreprise).
3 Customer Ce type d’utilisateur peut visualiser des rapports
relativement détaillés destinés aux clients.
La spécification userType détermine le niveau de détail qui
apparaît dans certains rapports : les types d’utilisateur executive
visualisent plutôt un aperçu des rapports, alors que les types
customer et operations affichent des rapports plus détaillés.
–timezone <index_fuseau_horaire>
Indique le numéro d’index (dont le format correspond à un entier
comprenant un à trois chiffres) du fuseau horaire à associer à cet
utilisateur. Les numéros d’index sont répertoriés en regard de
chaque fuseau horaire dans la sortie de la commande scmd report
displayTimezones. Toutes les informations de temps figurant dans
les rapports sont présentées selon le fuseau horaire spécifié. Si
aucun fuseau horaire n’est sélectionné pour un utilisateur, le fuseau
horaire du serveur de rapports est utilisé par défaut. Cette option
est généralement utilisée lorsqu’un contrat SLA a été configuré
pour un utilisateur particulier situé dans un fuseau horaire
différent de celui du serveur SLM.
–int {true | false}
Spécifie si les résultats intermédiaires de l’évaluation doivent être
affichés par défaut dans les rapports SLM pour cet utilisateur. La
valeur par défaut est true. Si cette option a pour valeur true, les
résultats intermédiaires de l’évaluation sont inclus pour cet
utilisateur (et identifiés par une icône spécifique dans les rapports
de haut niveau). Dans les rapports de niveau plus faible, cette
option contrôle si par défaut, les résultats intermédiaires sont
développés ou réduits dans le rapport. Les utilisateurs peuvent
cliquer sur la flèche située en regard du titre de la table dans le
rapport pour développer ou réduire la table.
Cette valeur ne peut être définie pour un nom d’utilisateur
particulier à l’aide de l’option –int que si la sécurité WebSphere a
été activée. Si la sécurité WebSphere n’est pas activée, vous ne
pouvez pas vous connecter à la console Rapports SLM à l’aide
d’un nom d’utilisateur particulier. Si la sécurité WebSphere n’est
PAS activée, cette option comporte, par défaut, la valeur true. Pour
réduire le tableau des résultats des objectifs de niveau de service
intermédiaires dans des rapports de faible niveau par défaut, vous
devez effectuer les étapes suivantes :
1. Accédez au répertoire
<rép_WebSphere>/config/cells/<nom_machine>/applications/
SLMReport.ear/deployments/SLMReport/SLMReport.war/
WEB-INF, où <rép_WebSphere> représente l’emplacement dans
lequel WebSphere a été installé (par exemple, C:\Program
Files\WebSphere\Appserver) et <nom_machine> le nom de la
machine que vous utilisez.
2. Editez le fichier web.xml.
Chapitre 10. Commandes d’utilisateur de rapport Web 151
3. Recherchez le paramètre tsla.commonPortalPage. La zone du
fichier doit être similaire à l’exemple suivante :
<init-param id="InitParam_1081431629488">
<param-name>tsla.commonPortalPage</param-name>
<param-value>report.jsp?fsd=r7d&int=yes
</param-value></init-param>
4. Remplacez la valeur par défaut report.jsp?fsd=r7d&int=yes
par report.jsp?fsd=r7d&int=no.
5. Sauvegardez les modifications dans le fichier web.xml.
6. Lancez la console d’administration WebSphere.
7. Dans l’arborescence de navigation de gauche, développez
Applications.
8. Sélectionnez Applications d’entreprise.
9. Arrêtez l’application SLMReport.
10. Redémarrez l’application SLMReport.
Une fois cette procédure terminée, affichez la console Rapports
SLM dans votre navigateur Web et vérifiez, même si des résultats
intermédiaires existent dans la période d’évaluation indiquée, que
les résultats et l’icône intermédiaire spéciale ne sont pas inclus
dans des rapports de haut niveau et que le tableau des résultats
d’objectifs de niveau de service intermédiaires des rapports de
faible niveau est réduite par défaut.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Créez un utilisateur titulaire de droits restreints, nommé Jean et dont le type est
executive.
scmd report addUser -name Jean -view 1 -userType 2
Dans la mesure où aucune page d’accueil n’a été indiquée, la page d’accueil
report.jsp s’affiche initialement lorsque l’utilisateur se connecte à la console
Rapports SLM à l’aide de ce nom d’utilisateur. Dans la mesure où l’option -int
n’a pas été indiquée, des résultats intermédiaires sont inclus dans les rapports,
s’il y a lieu.
2. Créez un utilisateur externe de type operations, nommé Marthe, ayant accès au
domaine intitulé Côte Est.
scmd report addUser -name Marthe -view 3 -realm "Côte Est" -userType 1
Dans la mesure où un domaine a été indiqué mais aucun nom de client, cet
utilisateur peut afficher toutes les données de rapport associées au domaine
spécifié. Comme où aucune page d’accueil n’a été indiquée, la page d’accueil
report.jsp s’affiche en premier lorsque cette connexion aboutit.
3. Créez un utilisateur titulaire de droits restreints, nommé david, qui a accès au
nom de client ABC et qui est configuré pour afficher une page d’accueil de
rapport intitulée CôteEst.jsp.
scmd report addUser -name david -view 2 -customer ABC
-page CôteEst.jsp
Dans la mesure où un nom de client a été indiqué mais aucun domaine, cet
utilisateur peut afficher toutes les données de ce client dans un ou plusieurs
152 IBM Tivoli Service Level Advisor - Guide des commandes
domaines associés. Comme un type d’utilisateur n’a pas explicitement été
spécifié, une valeur userType de operations est automatiquement affectée à cet
utilisateur.
4. Créez un utilisateur disposant de droits illimités, nommé Josiane et affectez
l’index de fuseau horaire pour Denver, Colorado.
Affichez d’abord tous les fuseaux horaires afin de trouver l’index de fuseau
horaire préféré :
scmd report displayTimezones
Dans la liste de sortie, recherchez la ligne suivante :
302) (GMT-07:00) Amérique/Denver
Dans cette liste, l’index de fuseau horaire pour Denver est 302.
Créez l’utilisateur à l’aide de cet index de fuseau horaire :
scmd report addUser -name Josiane -timezone 302
5. Créez un utilisateur disposant de droits illimités, nommé Bob, puis désactivez
l’affichage des résultats d’évaluation intermédiaires dans les rapports SLM de
cet utilisateur.
scmd report addUser -name Bob -view 1 -int false
Voir aussi
scmd report changeUser, scmd report deleteUser, scmd report listUser
Chapitre 10. Commandes d’utilisateur de rapport Web 153
scmd report changeUser
Modifie les informations de compte utilisateur dans la base de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] report changeUser –name <nom> [–view {1 | 2 |
3}] [–customer <client>] [–realm <domaine>] [–page <page>] [–userType {1 | 2 | 3}]
[–timezone <index_fuseau_horaire>] [–int {true | false}]
Description
La commande scmd report changeUser permet de modifier les informations
d’authentification d’utilisateur dans la base de données. Cette commande vous
permet d’effectuer les étapes suivantes :
v Modifier le droit d’authentification de cet utilisateur, lui permettant de visualiser
des rapports sans restriction ou de limiter le droit de visualisation de
l’utilisateur uniquement aux rapports correspondant à un nom de client et/ou
de domaine spécifique.
v Modifier le droit dont dispose l’utilisateur pour afficher des données classées
comme étant externes ou réservées à l’usage interne uniquement.
v Modifier la page d’accueil vers laquelle l’utilisateur est transféré une fois qu’il se
connecte au site Web du client.
v Modifier le type des utilisateurs de rapport, afin d’autoriser ce nom d’utilisateur
à afficher des rapports du point de vue d’un cadre d’entreprise (aperçu), du
client ou du technicien.
v Modifier le fuseau horaire spécifique à un utilisateur. Cette option est
généralement utilisée lorsqu’un contrat SLA a été configuré pour un utilisateur
spécifique situé dans un fuseau horaire différent de celui du serveur SLM.
v Indiquer si les résultats d’évaluation intermédiaires des rapports SLM doivent
ou non être affichés. Si cette fonction est activée, une icône spéciale apparaît
dans les rapports à l’emplacement approprié, de sorte que les résultats soient
identifiés à partir d’évaluations intermédiaires. Il est à noter que si des résultats
d’évaluation intermédiaires sont activés à des fins d’affichage, il se peut que les
performances soient ralenties en raison du traitement supplémentaire requis.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–name <nom> Indique le nom d’utilisateur. Ce nom est requis pour qu’un
utilisateur se connecte à l’application. Ce nom d’utilisateur doit
être prédéfini à l’aide de la commande scmd report addUser.
–view {1 | 2 | 3}
Indique les droits de l’utilisateur. Le paramètre indiqué est un
entier ayant pour valeur 1, 2 ou 3, qui est défini comme suit :
Vue Droit Explications
1 Illimité Un utilisateur disposant de
droits illimités peut
visualiser tous les rapports.
154 IBM Tivoli Service Level Advisor - Guide des commandes
Vue Droit Explications
2 Restreint Un utilisateur disposant de
droits restreints ne peut
visualiser que les rapports
du client et du domaine
indiqués
3 Externe Un utilisateur disposant de
droits externes peut
visualiser uniquement les
rapports du client et du
domaine indiqués.
L’utilisateur est autorisé à
visualiser uniquement les
données dont le paramètre
isInternal a pour valeur false
dans les données restreintes).
–customer <client>
Indique le nom du client pour lequel l’utilisateur est autorisé à
afficher les données dans les rapports. Si le nom contient un
espace, la totalité du nom de client doit être placée entre
guillemets. Ce nom doit être prédéfini dans la base de données
SLM. Si un nom de client n’est pas indiqué, cet utilisateur est
autorisé à afficher des résultats pour tous les clients de la base de
données (si un nom de domaine est indiqué, le droit de
visualisation de l’utilisateur est limité à tous les clients associés à
ce domaine).
–realm <domaine>
Indique le nom du domaine pour lequel l’utilisateur est autorisé à
afficher les données dans les rapports. Si le nom contient un
espace, la totalité du nom de domaine doit être placée entre
guillemets. Ce nom doit être prédéfini dans la base de données
SLM. Si un nom de domaine n’est pas indiqué, cet utilisateur est
autorisé à afficher des résultats pour tous les domaines de la base
de données (si un nom de client est indiqué, le droit de
visualisation de l’utilisateur est limité à ce client dans tous les
domaines associés).
–page <page> Indique la page d’accueil initiale à afficher une fois que l’utilisateur
se connecte au site Web pour afficher des rapports.
–userType {1 | 2 | 3}
Indique le type d’utilisateur pour l’affichage des rapports. Le
paramètre indiqué est un entier ayant pour valeur 1, 2 ou 3, qui est
défini comme suit :
Type
d’utilisateur Utilisateur Explications
1 Operations Ce type d’utilisateur peut visualiser des rapports
détaillés d’exploitation destinés au personnel de
l’entreprise. Il s’agit du type d’utilisateur par défaut
utilisé si aucun type n’est spécifié.
2 Executive Ce type d’utilisateur peut visualiser des rapports
récapitulatifs de plus haut niveau (destinés aux cadres
de l’entreprise).
Chapitre 10. Commandes d’utilisateur de rapport Web 155
Type
d’utilisateur Utilisateur Explications
3 Customer Ce type d’utilisateur peut visualiser des rapports
relativement détaillés destinés aux clients.
–timezone <index_fuseau_horaire>
Indique l’index de fuseau horaire qui est spécifique à l’utilisateur.
Toutes les informations de temps figurant dans les rapports sont
présentées selon le fuseau horaire spécifié. Si aucun fuseau horaire
n’est sélectionné pour un utilisateur, le fuseau horaire du serveur
de rapports est utilisé par défaut. Cette option est généralement
utilisée lorsqu’un contrat SLA a été configuré pour un utilisateur
spécifique situé dans un fuseau horaire différent de celui du
serveur SLM. Les numéros d’index de fuseau horaire sont
répertoriés en regard de chaque fuseau horaire dans la sortie de la
commande scmd report displayTimezones.
–int {true | false}
Spécifie si les résultats intermédiaires de l’évaluation doivent être
affichés dans les rapports SLM pour cet utilisateur. La valeur par
défaut est true. Si cette option a pour valeur true, les résultats
intermédiaires de l’évaluation sont inclus pour cet utilisateur (et
identifiés par une icône spécifique dans les rapports de haut
niveau). Certains rapports de niveau inférieur contiennent l’écran
du tableau Résultats des objectifs de niveau de service
intermédiaires. Si cette option a pour valeur false, le tableau
Résultats des objectifs de niveau de service intermédiaires est
néanmoins inclus, mais il est réduit par défaut. Vous pouvez
cliquer sur la flèche située en regard du titre du tableau pour
développer ce dernier et visualiser les résultats intermédiaires.
Remarque : Si la sécurité WebSphere n’est pas activée, vous ne
pouvez pas utiliser cette option pour désactiver les
résultats d’évaluation intermédiaires dans les rapports.
Reportez-vous à la procédure spéciale permettant de
désactiver les résultats d’évaluation intermédiaires
dans la description de l’option –int de la commande
addUser (voir «scmd report addUser» à la page 148).
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Pour des raisons de sécurité de l’accès aux rapports, une fois que l’accès utilisateur
est remplacé par un niveau plus restreint ou que l’utilisateur est supprimé, les
modifications ne prennent pas effet pour les utilisateurs connectés au système,
jusqu’à la prochaine connexion des utilisateurs.
Exemples
1. Remplacez l’utilisateur disposant de droits illimités, Jean par un utilisateur
externe autorisé à afficher des rapports à l’aide du nom de client Tivoli.
scmd report changeUser -name Jean -view 3 -customer Tivoli
2. Remplacez l’utilisatrice externe Marthe par un utilisateur disposant de droits
illimités.
156 IBM Tivoli Service Level Advisor - Guide des commandes
scmd report changeUser -name Marthe -view 1
3. Remplacez le type de l’utilisateur Fred par customer.
scmd report changeUser -name Fred -view 1 -userType 3
Il est à noter que vous devez indiquer l’option –view, même si vous ne
modifiez pas sa valeur.
4. Remplacez le fuseau horaire de l’utilisatrice Josiane pour Asie/Saïgon.
Affichez d’abord tous les fuseaux horaires afin de trouver l’index de fuseau
horaire préféré :
scmd report displayTimezones
Dans la liste de sortie, recherchez la ligne suivante :
157) (GMT+07:00) Asie/Saïgon
Dans cette liste, l’index de fuseau horaire pour Saïgon est 157.
Modifiez le fuseau horaire de l’utilisateur à l’aide de cet index de fuseau
horaire :
scmd report changeUser -name Josiane -view 1 -timezone 157
5. Désactivez l’affichage des évaluations intermédiaires pour l’utilisateur Bob.
scmd report changeUser -name Bob -view 1 -int false
Voir aussi
scmd report addUser, scmd report deleteUser, scmd report listUser
Chapitre 10. Commandes d’utilisateur de rapport Web 157
scmd report deleteUser
Supprime l’utilisateur indiqué de la base de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] report deleteUser –name <nom>
Description
La commande scmd report deleteUser permet de supprimer l’utilisateur indiqué
de la base de données.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–name <nom> Indique le nom d’utilisateur à supprimer.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Pour des raisons de sécurité de l’accès aux rapports, une fois que l’accès utilisateur
est remplacé par un niveau plus restreint ou que l’utilisateur est supprimé, les
modifications ne prennent pas effet pour les utilisateurs connectés au système,
jusqu’à la prochaine connexion des utilisateurs.
Exemples
1. Supprimez l’utilisateur Hiroko de la base de données.
scmd report deleteUser -name Hiroko
Voir aussi
scmd report addUser, scmd report changeUser, scmd report listUser
158 IBM Tivoli Service Level Advisor - Guide des commandes
scmd report displayTimezones
Affiche la liste des fuseaux horaires correspondant à l’heure GMT.
Syntaxe
scmd [–p <motdepasse_en_cours>] report displayTimezones
Description
La commande scmd report displayTimezones affiche la liste des fuseaux horaires
reconnus par le serveur SLM. Pour déterminer les fuseaux horaires qui sont
reconnus par les utilisateurs des rapports, ouvrez votre navigateur Web et accédez
au site Web suivant, où <serveur_rapports> représente le nom complet de la
machine sur laquelle la console Rapports SLM est installée et <port> le numéro de
port HTTP utilisé par WebSphere Application Server :
http://<serveur_rapports>:<port>/SLMReport/timezones.jsp
Chaque fuseau horaire s’affiche au format suivant :
nnn) (GMT+-hh:mm) <Description>
Dans le format ci-dessus :
v nnn représente un index de fuseau horaire comprenant un à trois chiffres, affecté à
chaque fuseau horaire. Il est utilisé par les commandes scmd report addUser et
scmd report changeUser pour associer un fuseau horaire particulier à un nom
d’utilisateur à employer lors de l’affichage des rapports SLM.
v GMT+-hh:mm) indique le fuseau horaire par rapport à l’heure GMT. Par
exemple, le fuseau horaire EST (heure de l’Est) est situé cinq heures après
l’heure GMT et exprimé sous forme de (GMT-05:00).
v <Description> représente une description du fuseau horaire. Il peut s’agir d’une
abréviation reconnue dans le monde entier, par exemple, EST pour l’heure de
l’Est, ou d’un nom plus descriptif, tel que Amérique/Los Angeles ou
Pacifique/Saipan.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
L’écran de sortie de cette commande comporte plusieurs centaines de lignes. Il est
peut-être nécessaire d’ajuster les propriétés d’affichage de la fenêtre de commande,
afin d’afficher toutes ces lignes de sortie ; vous avez également la possibilité de
réacheminer la sortie vers un fichier. Pour plus d’informations, reportez-vous à la
documentation de votre système d’exploitation.
Exemples
1. Affichez la liste des fuseaux horaires.
scmd report displayTimezones
Chapitre 10. Commandes d’utilisateur de rapport Web 159
Le début de la sortie est similaire à l’exemple suivant :
0) (GMT+00:00) Afrique/Abidjan
1) (GMT+00:00) Afrique/Accra
2) (GMT+00:00) Afrique/Bamako
3) (GMT+00:00) Afrique/Banjul
4) (GMT+00:00) Afrique/Bissau
5) (GMT+00:00) Afrique/Casablanca
6) (GMT+00:00) Afrique/Conakry
7) (GMT+00:00) Afrique/Dakar
8) (GMT+00:00) Afrique/El Aaiun
9) (GMT+00:00) Afrique/Libreville
10) (GMT+00:00) Afrique/Lomé
11) (GMT+00:00) Afrique/Monrovia
12) (GMT+00:00) Afrique/Nouakchott
13) (GMT+00:00) Afrique/Ouagadougou
14) (GMT+00:00) Afrique/Sao Tomé
15) (GMT+00:00) Afrique/Tombouctou
16) (GMT+00:00) Amérique/Danmarkshavn
17) (GMT+00:00) Atlantique/Canaries
18) (GMT+00:00) Atlantique/Féroé
19) (GMT+00:00) Atlantique/Madère
20) (GMT+00:00) Atlantique/Reykjavik
21) (GMT+00:00) Atlantique/Sainte Hélène
22) (GMT+00:00) République d’Irlande
23) (GMT+00:00) Europe/Belfast
24) (GMT+00:00) Europe/Dublin
25) (GMT+00:00) Europe/Lisbonne
Voir aussi
scmd report addUser, scmd report changeUser
160 IBM Tivoli Service Level Advisor - Guide des commandes
scmd report help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd report.
Syntaxe
scmd [–p <motdepasse_en_cours>] report help
Description
La commande scmd report help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd report.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes report.
scmd report help
Chapitre 10. Commandes d’utilisateur de rapport Web 161
scmd report list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd report.
Syntaxe
scmd [–p <motdepasse_en_cours>] report list
Description
La commande scmd report list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd report.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd report.
scmd report list
162 IBM Tivoli Service Level Advisor - Guide des commandes
scmd report listUser
Affiche des informations relatives à tous les utilisateurs de la base de données.
Syntaxe
scmd [–p<motdepasse_en_cours>] report listUser
Description
La commande scmd report listUser affiche des informations relatives à tous les
utilisateurs de la base de données.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Afficher la liste des informations utilisateur à partir de la base de données.
scmd report listUser
La sortie de cette commande est similaire à l’exemple suivant :
name = Jean
view = illimité
customer =
realm =
user type = operations
page = report.jsp?fsd=r7d
timezone = null
display intermediate results = true
name = David
view = Restricted
customer = OmniBank
realm = Chicago
user type = operations
page = report.jsp?fsd=r7d
timezone = null
display intermediate results = false
name = Hiroko
view = restreint
customer =
realm = UT-Run X-Realm 1
user type = executive
page = SpecialExecReport.jsp?fsd=r7d
timezone = null
display intermediate results = true
Voir aussi
scmd report addUser, scmd report changeUser, scmd report deleteUser
Chapitre 10. Commandes d’utilisateur de rapport Web 163
164 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 11. Commandes du planificateur
La présente section décrit les commandes CLI qui permettent de configurer le
composant planificateur d’IBM Tivoli Service Level Advisor, telles qu’elles sont
présentées dans le tableau 13.
Tableau 13. Commandes CLI du planificateur
Commande CLI Page
scmd scheduler help 166
scmd scheduler list 167
scmd scheduler listSettings 168
scmd scheduler setMaxEvaluationThreads 169
scmd scheduler setMaxTimeForForcedScheduling 170
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis, sauf dans le cas des
commandes scmd setPasswordEnabled et scmd setPassword qui
nécessitent systématiquement un mot de passe.
© Copyright IBM Corp. 2002, 2004 165
scmd scheduler help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd scheduler.
Syntaxe
scmd [–p <motdepasse_en_cours>] scheduler help
Description
La commande scmd scheduler help affiche la syntaxe, les variables, les options et
des exemples pour le regroupement de commandes scmd scheduler.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes scheduler.
scmd scheduler help
166 IBM Tivoli Service Level Advisor - Guide des commandes
scmd scheduler list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd scheduler.
Syntaxe
scmd [–p <motdepasse_en_cours>] scheduler list
Description
La commande scmd scheduler list affiche la liste de toutes les commandes et
options disponibles pour le regroupement de commandes scmd scheduler.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd scheduler.
scmd scheduler list
Chapitre 11. Commandes du planificateur 167
scmd scheduler listSettings
Répertorie l’état en cours des paramètres du planificateur.
Syntaxe
scmd [–p <motdepasse_en_cours>] scheduler listSettings
Description
La commande scmd scheduler listSettings affiche la liste des paramètres de
configuration en cours qui sont définis pour le planificateur. Le nombre maximal
d’unités d’exécution utilisées pour l’évaluation des mesures et le délai d’exécution,
en heures, de la planification des opérations s’affichent.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez les paramètres en cours du planificateur.
scmd scheduler listSettings
La sortie est similaire à l’exemple suivant :
Nombre maximal d’unités d’exécution d’évaluation = 2
Délai maximal (en heures) des demandes de planification forcée = 5
Voir aussi
scmd scheduler setMaxEvaluationThreads, scmd scheduler
setMaxTimeForForcedScheduling
168 IBM Tivoli Service Level Advisor - Guide des commandes
scmd scheduler setMaxEvaluationThreads
Définit le nombre maximal d’unités d’exécution que le planificateur peut utiliser
pour les tâches d’évaluation de mesures.
Syntaxe
scmd [ –p <motdepasse_en_cours>] scheduler setMaxEvaluationThreads
<nombre_unités_exécution>
Description
La commande scmd scheduler setMaxEvaluationThreads définit le nombre
maximal d’unités d’exécution que le planificateur peut utiliser pour les tâches
d’évaluation de mesures. Sur un poste doté de plusieurs processeurs, vous pouvez
augmenter le nombre d’unités d’exécution utilisées pour les tâches d’évaluation
afin d’améliorer les performances. Ce nombre doit être paramétré sur au moins
deux fois le nombre de processeurs disponibles.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Paramétrez le nombre maximal d’unités d’exécution sur 3.
scmd scheduler setMaxEvaluationThreads 3
Voir aussi
scmd scheduler listSettings
Chapitre 11. Commandes du planificateur 169
scmd scheduler setMaxTimeForForcedScheduling
Définit le délai d’exécution maximal des demandes de planification forcées.
Syntaxe
scmd [–p <motdepasse_en_cours>] scheduler setMaxTimeForForcedScheduling
<nombre_heures>
Description
La commande scmd scheduler setMaxTimeForForcedScheduling définit le délai
maximal, en heures, autorisé pour l’exécution du traitement d’une demande de
planification forcée. Toutes les évaluations de mesures sont déclenchées par une
tâche d’évaluation forcée unique peu après l’exécution du processus ETL, et la
tâche d’évaluation doit être terminée dans le délai maximal défini par cette
commande. Cela sert à coordonner le temps de traitement de l’évaluation avec la
fréquence d’exécution du processus ETL.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Affectez la valeur de 5 heures au délai maximal admis pour l’exécution du
traitement des évaluations forcées :
scmd scheduler setMaxTimeForForcedScheduling 5
Voir aussi
scmd scheduler listSettings
170 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 12. Commandes de base de données SLM
La présente section décrit les commandes CLI liées aux données du composant
base de données SLM d’IBM Tivoli Service Level Advisor, telles qu’elles sont
présentées dans le tableau 14.
Tableau 14. Commandes CLI correspondant aux commandes de base de données SLM
Commande CLI Page
scmd sdc adjustIDGenerator 173
scmd sdc createCustomer 174
scmd sdc createRealm 176
scmd sdc displayActiveServiceElements 178
scmd sdc displayAllCustomers 180
scmd sdc displayAllRealms 181
scmd sdc displayAllSchedules 182
scmd sdc displayAllServiceOfferings 184
scmd sdc displayAllSLAs 186
scmd sdc displayBaseSLAs 187
scmd sdc displayBusinessSchedules 189
scmd sdc displayCustomer 191
scmd sdc displayCustomerByID 192
scmd sdc displayCustomerFromSLAID 193
scmd sdc displayDataCollectorType 194
scmd sdc displayMilestoneSchedules 195
scmd sdc displayObsoleteServiceElements 196
scmd sdc displayOfferingElementList 197
scmd sdc displayOfferingScheduleName 198
scmd sdc displayOfferingState 199
scmd sdc displayRealm 200
scmd sdc displayScheduleByName 201
scmd sdc displayServiceOfferingByID 203
scmd sdc displayServiceOfferingID 205
scmd sdc displayServiceOfferingName 206
scmd sdc displayServiceOfferingsByState 207
scmd sdc displaySLAByID 209
scmd sdc displaySLAMetricPropertyID 210
scmd sdc displaySLAState 211
scmd sdc getAssociatedSLAID 212
scmd sdc help 213
scmd sdc list 214
scmd sdc purgeIntermediateResults 215
© Copyright IBM Corp. 2002, 2004 171
Tableau 14. Commandes CLI correspondant aux commandes de base de données
SLM (suite)
Commande CLI Page
scmd sdc purgeOldData 216
scmd sdc registerWarehouseData 217
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
172 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc adjustIDGenerator
Ajuste le mécanisme de générateur d’ID.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc adjustIDGenerator
Description
Tous les objets de gestion, tels qu’un client ou un contrat SLA, sont identifiés à
l’aide d’un ID unique. Cet ID est créé en fonction d’une table intitulée
ID_GENERATOR, qui contient un enregistrement pour chaque objet de gestion. Si
un enregistrement est accidentellement supprimé de la table ID_GENERATOR, la
création de l’objet de gestion risque d’échouer, car il se peut que le même ID soit
utilisé plusieurs fois. Vous pouvez utiliser la commande scmd sdc
adjustIDGenerator pour ajuster ou créer les enregistrements de la table
ID_GENERATOR.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande ne doit être utilisée qu’à la demande du support client Tivoli.
Exemples
Ajustez tous les enregistrements de générateur d’ID dans la table
ID_GENERATOR.
scmd sdc adjustIDGenerator
Voir aussi
Néant.
Chapitre 12. Commandes de base de données SLM 173
scmd sdc createCustomer
Crée un client dans la base de données SLM.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc createCustomer –name <nom_client> [–desc
<description>] –realmList <nom_domaine> [<nom_domaine>...]
Description
Les clients sont généralement créés à l’aide des tâches Créer un client ou Gérer les
clients du portefeuille de la console d’administration SLM. La commande scmd
sdc createCustomer permet de créer un client dans la base de données à partir de
l’interface de ligne de commande (CLI) et non via la console d’administration SLM.
Cela est préférable lorsque vous utilisez des commandes CLI afin de créer des
utilisateurs pour IBM Tivoli Service Level Advisor (voir «scmd report addUser» à
la page 148) et que vous devez autoriser ce nouvel utilisateur pour un nom de
client qui n’est peut-être pas défini dans la base de données SLM. Cette commande
vous permet de rester dans l’environnement CLI et de créer des clients (et des
domaines à l’aide de la commande scmd sdc createRealm similaire), puis de créer
des utilisateurs et les associer à ces clients (et domaines) sans qu’il soit nécessaire
de basculer sur la console d’administration SLM.
Vous pouvez indiquer un nom de client, fournir le cas échéant une description
pour le client et associer ce dernier à un ou plusieurs noms de domaines existants.
Vous devez indiquer au moins le nom de client et un nom de domaine. Le système
vérifie que le nom de client n’est pas un double d’un nom existant et que les noms
de domaines existent dans la base de données.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–name <nom_client>
Indique le nom du client à créer et à ajouter dans la base de
données. Si ce nom inclut le caractère spécial ″&″, ce nom doit être
placé entre guillemets, par exemple, ″Nom&Client″.
–desc <description>
Description facultative du client. Le texte doit être placé entre
guillemets, par exemple, ″Ceci est la description du client.″
–realmList <nom_domaine> [<nom_domaine>...]
Liste des domaines à associer à ce nom de client. Les noms de
domaines sont répertoriés de manière séquentielle et séparés par
un espace.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Créez un client nommé Banque Omni et associez-le au nom de domaine CôteEst.
scmd sdc createCustomer -name Banque Omni -realmList CôteEst
174 IBM Tivoli Service Level Advisor - Guide des commandes
Si cette commande aboutit, la sortie est similaire à l’exemple suivant :
DYKSD2572I Le client a été créé.
Si cette commande est émise sans qu’au moins un nom de domaine existant
soit indiqué, la sortie est similaire à l’exemple suivant :
DYKSD2577E Erreur d’analyse syntaxique : Une valeur realmList est requise
pour la création de l’objet.
Si cette commande échoue, la sortie est similaire à l’exemple suivant :
DYKSD2573E Un client intitulé Banque Omni existe déjà. Le
client n’a pas pu être créé.
2. Créez un client nommé Banque Omni avec la description Etablissement bancaire
international, puis associez-le aux noms de domaines USA et Europe.
scmd sdc createCustomer -name Banque Omni -desc "Etablissement
bancaire international" -realmList USA Europe
Voir aussi
scmd report addUser, scmd sdc createRealm, scmd sdc displayCustomer
Chapitre 12. Commandes de base de données SLM 175
scmd sdc createRealm
Crée un domaine dans la base de données SLM.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc createRealm –name <nom_domaine> [–desc
<description>]
Description
Les domaines sont généralement créés à l’aide des tâches Créer un domaine ou
Gérer les domaines du portefeuille de la console d’administration SLM. La
commande scmd sdc createRealm permet de créer un domaine dans la base de
données à partir de l’interface de ligne de commande (CLI) et non via la console
d’administration SLM. Cela est préférable lorsque vous utilisez des commandes
CLI afin de créer des utilisateurs pour IBM Tivoli Service Level Advisor (voir
«scmd report addUser» à la page 148) et que vous devez autoriser ce nouvel
utilisateur pour un nom de domaine qui n’est peut-être pas défini dans la base de
données SLM. Cette commande vous permet de rester dans l’environnement CLI et
de créer des domaines (et des clients à l’aide de la commande scmd sdc
createCustomer similaire), puis de créer des utilisateurs et les associer à ces
domaines (et clients) sans qu’il soit nécessaire de basculer sur la console
d’administration SLM.
Vous pouvez indiquer un nom de domaine et fournir le cas échéant une
description pour le domaine. Vous devez indiquer au moins le nom de domaine.
Le système vérifie que le nom de domaine n’est pas un double d’un nom existant.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
–name <nom_domaine>
Indique le nom du domaine à créer et à ajouter dans la base de
données. Si ce nom inclut le caractère spécial ″&″, ce nom doit être
placé entre guillemets, par exemple, ″Nom&Domaine″.
–desc <description>
Description facultative du domaine. Le texte doit être placé entre
guillemets, par exemple, ″Ceci est la description du domaine.″
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Créez un domaine intitulé Europe.
scmd sdc createRealm -name Europe
Si cette commande aboutit, la sortie est similaire à l’exemple suivant :
DYKSD2562I Le domaine a été créé.
Si cette commande échoue, la sortie est similaire à l’exemple suivant :
DYKSD2563E Un domaine intitulé Europe existe déjà. Le domaine n’a
pas pu être créé.
176 IBM Tivoli Service Level Advisor - Guide des commandes
2. Créez un domaine intitulé CôteEst avec la description Clients des états de
Californie, du Nevada, du Washington et de l’Oregon.
scmd sdc createRealm -name CôteEst -desc "Clients des états de Californie,
du Nevada, du Washington et de l’Oregon"
Voir aussi
scmd report addUser, scmd sdc createCustomer, scmd sdc displayRealm
Chapitre 12. Commandes de base de données SLM 177
scmd sdc displayActiveServiceElements
Affiche tous les éléments de service actifs.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayActiveServiceElements
Description
La commande scmd sdc displayActiveServiceElements affiche tous les éléments
de service actifs. Un élément de service est une structure de données SLA interne qui
est mappée vers un composant d’offre utilisé lors de la création d’offres et de
contrats SLA dans la console d’administration SLM. L’élément de service contient
plusieurs composants, y compris le type de composant et les mesures sélectionnées
pour le type de composant. Pour plus d’informations sur les composants d’offre et
la création d’offre, reportez-vous au document Gestion des contrats de service.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Cette commande affiche éventuellement une grande quantité d’informations.
Exemples
Affichez les éléments de service actifs.
scmd sdc displayActiveServiceElements
La sortie de cette commande peut être longue. L’exemple abrégé suivant présente
le début de la sortie :
Nombre d’éléments de service=15
Elément de service :
ID élément de service : 1000
ID SEM : 1000
ID instance : 1000
Nom : CompTyp.CompTyp_Nm.BUSINESS_SYSTEM
Etat : Actif
Version de portée : 1.0
Intervention de l’homme demandée : false
Responsabilité : MONITOR
Etat : STATUS_BUSY
Nom de classe : com.tivoli.managed.util.TWHBundle
Classe de service : BUSINESS_SYSTEM
Classe d’élément : MODEL1
Propriété numéro 0 :
Nom : COMPONENTS
ID : -1
UsageDefaulted
Défini par : administrateur
Afficher au souscripteur : true
Liste de spécifications
178 IBM Tivoli Service Level Advisor - Guide des commandes
Nom : COMPONENTS
UsageDefaulted
Définir la liste de spécifications
Valeur de spécification
Nom : COMPONENTS
UsageDefaulted
Défini par : Administrateur
Afficher au souscripteur : true
Type : entier
Nom : COMPONENT_ID
Valeur de spécification
Nom : COMPONENTS
UsageDefaulted
Défini par : Administrateur
Afficher au souscripteur : true
Type : chaîne
Nom : COMPONENT_NAME
Valeur de spécification
Nom : COMPONENTS
UsageDefaulted
Défini par : Administrateur
Afficher au souscripteur : true
Type : chaîne
Nom : COMPONENT_LONG_NAME
Défini par : administrateur
Afficher au souscripteur : true
Propriété numéro 1 :
Nom : TSLA.NumberOfOutages
Description : TSLA.NumberOfOutagesDesc
ID : 1001
UsageDefaulted
Défini par : administrateur
Afficher au souscripteur : true
Mesure
Interne : false
Nom : TSLA.NumberOfOutages
ID : 1001
Unités : TSLA.Outages
Type d’évaluateur : Evaluateur de type C
Type de mesure : Aucun
Intervalle minimal d’évaluation : 0
Intervalle minimal de tendance : 0
Type : Aucun
Type de tendance : Evaluation en continu
Points de données prévus -1
Relevé de mesure : additif
ID type de mesure : -1
Propriété numéro 2 :
Nom : TSLA.AvailabilityPercent
Description : TSLA.AvailabilityPercentDesc
ID : 1002
UsageDefaulted
Défini par : administrateur
Afficher au souscripteur : true
(et ainsi de suite)
Voir aussi
scmd sdc displayObsoleteServiceElements
Chapitre 12. Commandes de base de données SLM 179
scmd sdc displayAllCustomers
Affiche les informations relatives à tous les clients définis dans la base de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayAllCustomers
Description
La commande scmd sdc displayAllCustomers affiche les informations relatives à
tous les clients définis dans la base de données SLM.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives à tous les clients de la base de données SLM.
scmd sdc displayAllCustomers
Pour chaque client, la sortie est similaire à l’exemple suivant :
Client
ID : 1001
Nom : Comptabilité IBM
Description : Service de comptabilité IBM
Nombre de domaines : 2
Domaine :
ID : 1001
Nom : IBM Strategic Outsourcing
Description : Externalisation IBM
Domaine :
ID : 1003
Nom : IBM HQ
Description : Opérations centrales siège IBM
Voir aussi
scmd sdc displayAllRealms, scmd sdc displayAllSchedules, scmd sdc
displayAllServiceOfferings, scmd sdc displayAllSLAs
180 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayAllRealms
Affiche les informations relatives à tous les domaines de la base de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayAllRealms
Description
Affiche les informations relatives à tous les domaines.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives à tous les domaines.
scmd sdc displayAllRealms
La sortie qui s’affiche est similaire à l’exemple suivant :
Nombre de domaines=3
Domaine :
ID : 1001
Nom : IBM Strategic Outsourcing
Description : Externalisation IBM
Domaine :
ID : 1002
Nom : IBM Software Group
Description : Divisions du groupe de logiciels IBM
Domaine :
ID : 1003
Nom : IBM HQ
Description : Opérations centrales siège IBM
Voir aussi
scmd sdc displayAllCustomers, scmd sdc displayAllSchedules, scmd sdc
displayAllServiceOfferings, scmd sdc displayAllSLAs
Chapitre 12. Commandes de base de données SLM 181
scmd sdc displayAllSchedules
Affiche tous les calendriers d’activité et de repère.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayAllSchedules
Description
La commande scmd sdc displayAllSchedules affiche tous les calendriers d’activité
(et calendriers auxiliaires) qui sont également affichés par la commande scmd sdc
displayBusinessSchedules, ainsi que tous les calendriers de repère qui sont
affichés par la commande scmd sdc displayMilestoneSchedules.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les calendriers d’activité (et auxiliaires) et les calendriers de repère.
scmd sdc displayAllSchedules
La sortie qui s’affiche est similaire à l’exemple partiel suivant :
Nombre de calendriers=17
ID : 1013
Nom : Calendrier A
Description : Ceci est la description du calendrier A
Auxiliaire : false
Dernière modification : 10 février 2004 11:22:54 AM EST
Etats de calendrier :
Critique
Pas de service
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : Amérique/New_York
Heure de début : 0
Heure de fin : 86400000
Date unique
Date : 19 janvier 2004
Période de calendrier :
Etat du calendrier : Pas de service
Fuseau horaire : GMT
Heure de début : 0
Heure de fin : 86399999
Date répétée
Formule de date : 134217534 Hex: 7ffff3e
Calendriers auxiliaires :
ID : 1014
Nom : Aux1
Description : Calendrier auxiliaire
Auxiliaire : true
Dernière modification : 10 février 2004 11:20:12 AM EST
182 IBM Tivoli Service Level Advisor - Guide des commandes
ID : 1014
Nom : Aux1
Description : Calendrier auxiliaire
Auxiliaire : true
Dernière modification : 10 février 2004 11:20:12 AM EST
Etats de calendrier :
Critique
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : Amérique/New_York
Heure de début : 0
Heure de fin : 86400000
Date répétée
Formule de date : 134217534 Hex: 7ffff3e
Dans cet exemple de sortie, la première ligne indique que 17 calendriers sont
définis dans le système. La liste contient le calendrier intitulé Calendrier A dont l’ID
est 1013. Ce calendrier inclut deux états de calendrier, Critique et Pas de service, et
contient également un calendrier auxiliaire, Aux1, dont l’ID est 1014. La définition
du calendrier Aux1 apparaît ensuite ; elle indique un état de calendrier Critique et
la description de période qui lui est associée.
Voir aussi
scmd sdc displayBusinessSchedules, scmd sdc displayMilestoneSchedules, scmd
sdc displayAllCustomers, scmd sdc displayAllRealms, scmd sdc
displayAllServiceOfferings, scmd sdc displayAllSLAs
Chapitre 12. Commandes de base de données SLM 183
scmd sdc displayAllServiceOfferings
Affiche toutes les offres de service enregistrées dans la base de données SLM.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayAllServiceOfferings
Description
La commande scmd sdc displayAllServiceOfferings affiche toutes les offres de
service qui sont enregistrées dans la base de données SLM.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez toutes les offres de service.
scmd sdc displayAllServiceOfferings
Pour chaque offre de service, la sortie résultante est similaire à l’exemple suivant :
Nombre d’offres de service=1
ID : 1001
Nom : Offre de niveau Or
Description : Offre de service de haut niveau
Etat : Publiée
Environnement local : en_US
Nom du calendrier : Calendrier A100
Type : TYPE_INTERNAL
Dernière modification : 15 janvier 2004 3:51:08 PM EST
Classe d’offre : com.tivoli.managed.sdml.OfferingClass@4b93742
L’offre de service contient 2 éléments de service
Elément de service numéro 0
Elément de service :
ID élément de service : 1004
ID SEM : 1000
ID instance : 1003
Nom : Hôte IP
Description : Test de l’évaluateur de mesures C - mesures dérivées
Etat : Actif
Intervention de l’homme demandée : false
ID instance de l’élément d’offre : 1003
Etat : STATUS_BUSY
Elément de service numéro 1
Elément de service :
ID élément de service : 1001
ID SEM : 1000
Instance ID: 1004
Nom : Tivoli Web Transaction Performance QoS Job
Description : Test de l’évaluateur de mesures A Transaction réussie
Etat : Actif
Intervention de l’homme demandée : false
184 IBM Tivoli Service Level Advisor - Guide des commandes
ID instance de l’élément d’offre : 1004
Etat : STATUS_BUSY
Nombre de SLA dans l’offre (si plusieurs niveaux) : 0
Cet exemple présente une offre de service dans la sortie, intitulée Offre de niveau
Or, dont l’ID est 1001. Il s’agit d’une offre publiée, qui contient le calendrier
Calendrier A100, ainsi que deux définitions d’élément de service, l’une pour Hôte IP
et l’autre pour Tivoli Web Transaction Performance QoS Job.
Voir aussi
scmd sdc displayAllCustomers, scmd sdc displayAllRealms, scmd sdc
displayAllSchedules, scmd sdc displayAllSLAs
Chapitre 12. Commandes de base de données SLM 185
scmd sdc displayAllSLAs
Affiche les informations relatives à tous les contrats SLA
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayAllSLAs
Description
La commande scmd sdc displayAllSLAs affiche les attributs de tous les contrats
SLA.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les attributs de tous les contrats SLA.
scmd sdc displayAllSLAs
Pour chaque contrat SLA, la sortie est similaire à l’exemple suivant :
Nombre de contrats SLA=1
ID contrat SLA : 1000
Etat : Terminé
Nom : Contrat de service bancaire
Description : Contrat de service entre les services bancaires et les services
informatiques
ID service-1
Identificateur de service :
Nom du service
Fuseau horaire : Amérique/Chicago
Action : ACTION_DEPLOY
Dernière modification : 15 janvier 2004 3:54:53 PM EST
Client
ID : 1000
Nom : Client ABC
Nombre de domaines : 0
Offre
ID : 1000
Nom : Offre bancaire 1
Description : Offre bancaire
Etat : Publiée
Environnement local : en_US
Type : TYPE_INTERNAL
Voir aussi
scmd sdc displayAllCustomers, scmd sdc displayAllRealms, scmd sdc
displayAllSchedules, scmd sdc displayAllServiceOfferings, scmd sdc
displayBaseSLAs
186 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayBaseSLAs
Affiche les contrats SLA d’origine qui sont associés aux contrats dont l’état est
Echec de la modification ou Echec de l’annulation.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayBaseSLAs
Description
Lors du processus de modification ou d’annulation d’un contrat SLA, un nouvel
enregistrement SLA provisoire est créé dans la base de données à l’aide des
informations modifiées. Cet enregistrement provisoire est généralement fusionné
avec l’enregistrement SLA d’origine de sorte qu’un enregistrement SLA mis à jour
unique soit créé dans la base de données. Si un incident se produit au cours de ce
processus, cet enregistrement SLA provisoire reste à l’état Echec de la modification ou
Echec de l’annulation. Il en résulte deux enregistrements SLA dans la base de
données : l’enregistrement SLA d’origine avant la modification ou l’annulation et
l’enregistrement SLA ayant échoué qui contient les modifications relatives au
contrat SLA d’origine depuis l’échec du processus de modification ou d’annulation.
La commande scmd sdc displayBaseSLAs n’affiche que les contrats SLA d’origine
(ou de base) de la base de données (qui inclut également les contrats SLA dont
l’état est Annulé).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les contrats SLA de base.
scmd sdc displayBaseSLAs
Pour chaque contrat SLA, la sortie est similaire à l’exemple suivant :
Nombre de contrats SLA=4
ID contrat SLA : 1000
Etat : Terminé
Nom : UT-Run X-Order1
Description : Commande de test d’unité 1
ID service-1
Identificateur de service :
Nom du service
Fuseau horaire : Amérique/Chicago
Action : ACTION_DEPLOY
Dernière modification : 15 janvier 2004 3:54:53 PM EST
Client
ID : 1000
Nom : UT-Run X-Customer 1
Nombre de domaines : 0
Offre
ID : 1000
Nom : UT-Run X-Offering 1
Chapitre 12. Commandes de base de données SLM 187
Description : Offre de test d’unité 1
Etat : Publiée
Environnement local : en_US
Type : TYPE_INTERNAL
Voir aussi
scmd sdc displayAllSLAs, scmd sdc getAssociatedSLAID
188 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayBusinessSchedules
Affiche tous les calendriers d’activité et les calendriers auxiliaires qui sont définis
dans la base de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayBusinessSchedules
Description
La commande scmd sdc displayBusinessSchedules affiche tous les calendriers
d’activité et les calendriers auxiliaires qui sont définis dans la base de données
SLM. Un calendrier d’activité est un calendrier auquel est associé une période de
calendrier. Un calendrier auxiliaire peut être associé à plusieurs calendriers
d’activité de manière à définir des périodes de calendrier communes à plusieurs
calendriers d’activité.
Les calendriers auxiliaires s’affichent indépendamment des calendriers d’activité
dans la sortie de cette commande et, s’ils sont associés à un calendrier d’activité, ils
sont également inclus dans la description de ce calendrier d’activité.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les calendriers d’activité et auxiliaires.
scmd sdc displayBusinessSchedules
La sortie affichée d’un calendrier d’activité est similaire à l’exemple suivant :
Nombre de calendriers=1
ID : 1000
Nom : Calendrier d’activité ABC
Auxiliaire : false
Dernière modification : 10 février 2004 11:22:54 AM EST
Etats de calendrier :
Critique
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : Amérique/New_York
Heure de début : 0
Heure de fin : 86400000
Date unique
Date : 19 janvier 2004
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : GMT
Heure de début : 0
Heure de fin : 86399999
Date répétée
Formule de date : 134217534 Hex: 7ffff3e
Chapitre 12. Commandes de base de données SLM 189
Calendriers associés :
ID : 1014
Nom : Aux1
Description : Calendrier auxiliaire
Auxiliaire : true
Dernière modification : 10 février 2004 11:20:12 AM EST
L’affichage d’un calendrier auxiliaire est similaire à l’exemple suivant :
ID : 1014
Nom : Aux1
Description : Calendrier auxiliaire
Auxiliaire : true
Dernière modification : 10 février 2004 11:20:12 AM EST
Etats de calendrier :
Critique
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : Amérique/New_York
Heure de début : 0
Heure de fin : 86400000
Date répétée
Formule de date : 134217534 Hex: 7ffff3e
Voir aussi
scmd sdc displayAllSchedules, scmd sdc displayMilestoneSchedules
190 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayCustomer
Affiche les informations client relatives à un nom de client indiqué.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayCustomer <nom_client>
Description
La commande scmd sdc displayCustomer affiche les informations client associées
au nom de client indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
<nom_client>
Indique le nom du client à afficher. Si le nom contient un espace, il doit
être placé entre guillemets, par exemple, Nom du client.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives au client dont le nom est Service des prêts.
scmd sdc displayCustomer "Service des prêts"
La sortie qui s’affiche est similaire à l’exemple suivant :
ID : 1000
Nom : Service des prêts
Description : Client du service des prêts
Nombre de domaines : 2
Domaine :
ID : 1003
Nom : Central USA
Description : Région du Middle West américain
Domaine :
ID : 1006
Nom : USA
Description : Toutes les régions des Etats-Unis
Voir aussi
scmd sdc displayAllCustomers, scmd sdc displayCustomerByID, scmd sdc
displayCustomerFromSLAID
Chapitre 12. Commandes de base de données SLM 191
scmd sdc displayCustomerByID
Affiche les informations client relatives à un ID client.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayCustomerByID <ID_client>
Description
La commande scmd sdc displayCustomerByID affiche les informations client
associées à l’ID client indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
<ID_client>
Indique l’ID du client.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives au client dont l’ID est 1000.
scmd sdc displayCustomerByID 1000
La sortie qui s’affiche est similaire à l’exemple suivant :
ID : 1000
Nom : Service des prêts de la banque Omni
Description : Service des prêts - Succursale de Chicago
Nombre de domaines : 2
Domaine :
ID : 1003
Nom : Central USA
Description : Région du Middle West américain
Domaine :
ID : 1006
Nom : USA
Description : Toutes les régions des Etats-Unis
Voir aussi
scmd sdc displayAllCustomers, scmd sdc displayCustomer, scmd sdc
displayCustomerFromSLAID
192 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayCustomerFromSLAID
Affiche les informations client relatives à un contrat SLA.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayCustomerFromSLAID
<ID_contrat_SLA>
Description
La commande scmd sdc displayCustomerFromSLAID affiche les informations
client associées au contrat SLA indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations clients associées au contrat SLA 1000.
scmd sdc displayCustomerFromSLAID 1001
La sortie qui s’affiche est similaire à l’exemple suivant :
ID : 1001
Nom : Service des prêts de la banque Omni
Description : Service des prêts - Succursale de Chicago
Nombre de domaines : 2
Domaine :
ID : 1005
Nom : Central USA
Description : Région du Middle West américain
Domaine :
ID : 2001
Nom : USA
Description : Toutes les régions des Etats-Unis
Voir aussi
scmd sdc displayAllCustomers, scmd sdc displayCustomer, scmd sdc
displayCustomerByID
Chapitre 12. Commandes de base de données SLM 193
scmd sdc displayDataCollectorType
Affiche le type de collecteur de données d’un gestionnaire d’élément de service.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayDataCollectorType
<ID_gestionnaire_élément_service>
Description
La commande scmd sdc displayDataCollectorType affiche le type de collecteur de
données du gestionnaire d’élément de service indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_gestionnaire_élément_service>
Indique l’ID du gestionnaire d’élément de service.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Dans la mesure où IBM Tivoli Service Level Advisor extrait des données
uniquement de Tivoli Data Warehouse, ce dernier ne contient qu’un seul
gestionnaire d’élément de service pris en charge, dont l’ID est 1000. Affichez le
type de collecteur de données du gestionnaire d’élément de service dont l’ID est
1000.
scmd sdc displayDataCollectorType 1000
La sortie qui s’affiche est similaire à l’exemple suivant :
com.tivoli.managed.dc.twh.TWHDataCollector
Voir aussi
Néant.
194 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayMilestoneSchedules
Affiche tous les calendriers de repère.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayMilestoneSchedules
Description
La commande scmd sdc displayMilestoneSchedules affiche tous les calendriers de
repère. Un calendrier de repère est un calendrier interne qui est créé par IBM
Tivoli Service Level Advisor lorsqu’un calendrier est associé à une offre de service.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les calendriers de repère.
scmd sdc displayMilestoneSchedules
Pour chaque calendrier de repère, la sortie est similaire à l’exemple suivant :
Nombre de calendriers=10
ID : 1039
Nom : 1039
Auxiliaire : false
Dernière modification : 6 août 2004 9:44:44 PM EDT
Repère de calendrier :
Action : EVALUATE
Intervalle : 134217534
Délai d’attente : -1
Exclusif : false
Date répétée
Formule de date : -1
Repère de calendrier :
Action : TREND
Intervalle : 134217534
Délai d’attente : -1
Exclusif : false
Date répétée
Formule de date : -1
Voir aussi
scmd sdc displayAllSchedules, scmd sdc displayBusinessSchedules
Chapitre 12. Commandes de base de données SLM 195
scmd sdc displayObsoleteServiceElements
Renvoie la liste des éléments de service obsolètes de la base de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayObsoleteServiceElements
<code_source_mesure_application_source>
Description
La commande scmd sdc displayObsoleteServiceElements affiche la liste des
éléments de service obsolètes de la base de données pour un code source de
mesure d’application source indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<code_source_mesure_application_source>
Code source de mesure de l’application source.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez tous les éléments de service obsolètes de l’application source dont le code
source de mesure est BWM.
scmd sdc displayObsoleteServiceElements BWM
La sortie qui s’affiche est similaire à l’exemple suivant :
Nombre d’éléments de service=1
Elément de service :
ID élément de service : 1001
ID SEM : 1000
ID instance : 1001
Nom : CompTyp.CompTyp_Nm.BWM_QOS
Etat : Retiré
Version de portée : 1.0
Intervention de l’homme demandée : false
Responsabilité : MONITOR
Etat : STATUS_BUSY
Nom de classe : com.tivoli.managed.util.TWHBundle
Classe de service : BWM_QOS
Classe d’élément : BWM
Voir aussi
scmd sdc displayActiveServiceElements
196 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayOfferingElementList
Affiche tous les éléments associés à une offre de service.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayOfferingElementList <ID_offre>
Description
La commande scmd sdc displayOfferingElementList affiche tous les éléments
associés à l’offre de service indiquée.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_offre> Indique l’ID de l’offre de service.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les éléments associés à l’offre de service dont l’ID est 1001.
scmd sdc displayOfferingElementList 1001
La sortie de cette commande peut être longue ; par conséquent, aucun exemple
n’est présenté dans cette section.
Voir aussi
scmd sdc displayOfferingScheduleName, scmd sdc displayOfferingState
Chapitre 12. Commandes de base de données SLM 197
scmd sdc displayOfferingScheduleName
Affiche le nom du calendrier associé à une offre de service.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayOfferingScheduleName <ID_offre>
Description
La commande scmd sdc displayOfferingScheduleName affiche le nom du
calendrier d’activité qui est associé à l’ID offre de service indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_offre> Indique l’ID de l’offre de service.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez le nom du calendrier associé à l’offre de service 1001.
scmd sdc displayOfferingScheduleName 1001
La sortie correspond au nom du calendrier et est similaire à l’exemple suivant :
Calendrier de service des horaires de bureau
Voir aussi
scmd sdc displayOfferingElementList, scmd sdc displayOfferingState
198 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayOfferingState
Affiche l’état d’une offre de service.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayOfferingState <ID_offre>
Description
La commande scmd sdc displayOfferingState affiche l’état de l’offre de service
indiquée (Brouillon, Publiée ou Retirée).
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_offre> Indique l’ID de l’offre de service.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’état de l’offre de service 1001.
scmd sdc displayOfferingState 1001
La sortie qui s’affiche est similaire à l’exemple suivant :
Publiée
Voir aussi
Néant.
Chapitre 12. Commandes de base de données SLM 199
scmd sdc displayRealm
Affiche les informations relatives à un nom de domaine indiqué.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayRealm <nom_domaine>
Description
La commande scmd sdc displayRealm affiche les informations associées au nom
de domaine indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
<nom_domaine>
Indique le nom du domaine à afficher. Si le nom contient un espace, il doit
être placé entre guillemets, par exemple, Côte Est.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives au domaine dont le nom est Côte Est.
scmd sdc displayRealm "Côte Est"
La sortie qui s’affiche est similaire à l’exemple suivant :
ID : 1000
Nom : Côte Est
Description : Tous les clients de la Côte Est des Etats-Unis
Voir aussi
scmd sdc displayAllRealms, scmd sdc createRealm, scmd sdc displayCustomer
200 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayScheduleByName
Affiche le contenu d’un calendrier d’activité.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayScheduleByName <nom_calendrier>
Description
La commande scmd sdc displayScheduleByName affiche les informations relatives
au calendrier indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<nom_calendrier>
Indique le nom du calendrier. Si le nom de calendrier contient un
espace, il doit être placé entre guillemets, par exemple, ″Calendrier
A100″.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives au calendrier intitulé MonCalendrier.
scmd sdc displayScheduleByName MonCalendrier
La sortie qui s’affiche est similaire à l’exemple suivant :
ID : 1013
Nom : MonCalendrier
Description : Calendrier de mes opérations
Auxiliaire : false
Dernière modification : 10 février 2004 11:22:54 AM EST
Etats de calendrier :
Critique
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : Amérique/New_York
Heure de début : 0
Heure de fin : 86400000
Date unique
Date : 19 janvier 2004
Période de calendrier :
Etat du calendrier : Critique
Fuseau horaire : GMT
Heure de début : 0
Heure de fin : 86399999
Date répétée
Formule de date : 134217534 Hex: 7ffff3e
Calendriers associés :
ID : 1014
Nom : Aux1
Description : Calendrier auxiliaire
Auxiliaire : true
Dernière modification : 10 février 2004 11:20:12 AM EST
Chapitre 12. Commandes de base de données SLM 201
Voir aussi
scmd sdc displayAllSchedules, scmd sdc displayBusinessSchedules, scmd sdc
displayMilestoneSchedules, scmd sdc displayOfferingScheduleName
202 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayServiceOfferingByID
Affiche le contenu d’une offre de service.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayServiceOfferingByID <ID_offre>
Description
La commande scmd sdc displayServiceOfferingByID affiche le contenu de l’offre
de service indiquée.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_offre> Indique l’ID de l’offre de service.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez les informations relatives à l’offre de service 1001.
scmd sdc displayServiceOfferingByID 1001
La sortie qui s’affiche est similaire à l’exemple suivant :
ID : 1000
Nom : Offre 1
Description : Offre 1
Etat : Publiée
Environnement local : en_US
Nom du calendrier : Calendrier A
Type : TYPE_INTERNAL
Dernière modification : 15 janvier 2004 3:51:06 PM EST
Classe d’offre : com.tivoli.managed.sdml.OfferingClass@6badf74d
L’offre de service contient 3 éléments de service
Elément de service numéro 0
Elément de service :
ID élément de service : 1001
ID SEM : 1000
ID instance : 1000
Nom : Tivoli Web Transaction Performance QoS Job
Description : Test de l’évaluateur de mesures A
(Tous les intervalles quotidiens)
Etat : Actif
Intervention de l’homme demandée : false
ID instance de l’élément d’offre : 1000
Etat : STATUS_BUSY
Elément de service numéro 1
Elément de service :
ID élément de service : 1006
ID SEM : 1000
ID instance : 1001
Nom : Gravité d’événement TEC
Description : Evaluateur de mesures de type B (total)
Etat : Actif
Intervention de l’homme demandée : false
Chapitre 12. Commandes de base de données SLM 203
ID instance de l’élément d’offre : 1001
Etat : STATUS_BUSY
Elément de service numéro 2
Elément de service :
ID élément de service : 1002
ID SEM : 1000
ID instance : 1002
Nom : Tivoli Web Transaction Performance STI Job
Description : Evaluateur de mesures de type A (moyenne)
Etat : Actif
Intervention de l’homme demandée : false
ID instance de l’élément d’offre : 1002
Etat : STATUS_BUSY
Nombre de SLA dans l’offre (si plusieurs niveaux) : 0
Voir aussi
scmd sdc displayAllServiceOfferings, scmd sdc displayServiceOfferingID, scmd
sdc displayServiceOfferingName, scmd sdc displayServiceOfferingsByState
204 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayServiceOfferingID
Affiche l’ID offre de service associé à un contrat SLA.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayServiceOfferingID <ID_contrat_SLA>
Description
La commande scmd sdc displayServiceOfferingID affiche l’ID offre de service
associé au contrat SLA indiqué par <ID_contrat_SLA>.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’ID de l’offre de service associée au contrat SLA 1001.
scmd sdc displayServiceOfferingID 1001
Si l’ID de l’offre de service associée est 1000, la sortie de la commande est la
suivante :
1000
Voir aussi
scmd sdc displayAllServiceOfferings, scmd sdc displayServiceOfferingByID,
scmd sdc displayServiceOfferingName, scmd sdc displayServiceOfferingsByState
Chapitre 12. Commandes de base de données SLM 205
scmd sdc displayServiceOfferingName
Affiche le nom de l’offre de service associée à un contrat SLA.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayServiceOfferingName
<ID_contrat_SLA>
Description
La commande scmd sdc displayServiceOfferingName affiche le nom de l’offre de
service associée au contrat SLA indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez le nom de l’offre de service associée au contrat SLA 1001.
scmd sdc displayServiceOfferingName 1001
Si le nom de l’offre de service associée est Disponibilité de stockage UNIX, la sortie
de cette commande est la suivante :
Disponibilité de stockage UNIX
Voir aussi
scmd sdc displayAllServiceOfferings, scmd sdc displayServiceOfferingID, scmd
sdc displayServiceOfferingByID, scmd sdc displayServiceOfferingsByState
206 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displayServiceOfferingsByState
Affiche toutes les offres de service à un état particulier indiqué par l’utilisateur.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displayServiceOfferingsByState <état>
Description
La commande scmd sdc displayServiceOfferingsByState affiche la liste des offres
de service de la base de données qui sont dans un état particulier indiqué par
vous-même. Les états valides pouvant être indiqués sont publiée, brouillon, obsolète
ou active.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<état> Indique l’état d’offre de service pour lequel vous souhaitez afficher
la liste des offres de service.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste des offres de service dont l’état en cours est publiée.
scmd sdc displayServiceOfferingsByState published
La sortie qui s’affiche est similaire à l’exemple suivant :
Nombre d’offres de service=3
ID : 1000
Nom : Offre Argent
Description : Offre de niveau Argent
Etat : Publiée
Environnement local : en_US
Nom du calendrier : Calendrier Silv1000
Type : TYPE_INTERNAL
Dernière modification : 6 août 2004 9:44:46 PM EDT
Classe d’offre : com.tivoli.managed.sdml.OfferingClass@7544515
L’offre de service contient 3 éléments de service
Elément de service numéro 0
Elément de service :
ID élément de service : 1001
ID SEM : 1000
ID instance : 1000
Nom : Tivoli Web Transaction Performance QoS Job
Description : Test de l’évaluateur de mesures A
(Tous les intervalles quotidiens)
Etat : Actif
Intervention de l’homme demandée : false
ID instance de l’élément d’offre : 1000
Etat : STATUS_BUSY
Elément de service numéro 1
Elément de service :
ID élément de service : 1006
ID SEM : 1000
ID instance : 1001
Chapitre 12. Commandes de base de données SLM 207
Nom : Gravité d’événement TEC
Description : Evaluateur de mesures de type B (total)
Etat : Actif
Intervention de l’homme demandée : false
ID instance de l’élément d’offre : 1001
Etat : STATUS_BUSY
Elément de service numéro 2
Elément de service :
ID élément de service : 1002
ID SEM : 1000
ID instance : 1002
Nom : Tivoli Web Transaction Performance STI Job
Description : Evaluateur de mesures de type A (moyenne)
Etat : Actif
Intervention de l’homme demandée : false
ID instance de l’élément d’offre : 1002
Etat : STATUS_BUSY
Nombre de SLA dans l’offre (si plusieurs niveaux) : 0
Si aucune offre de service n’est à l’état actif, la sortie de la commande est la
suivante :
DYKSD2508I La base de données ne contient aucune offre de services.
Voir aussi
scmd sdc displayAllServiceOfferings, scmd sdc displayServiceOfferingID, scmd
sdc displayServiceOfferingByID, scmd sdc displayServiceOfferingName
208 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displaySLAByID
Affiche des informations relatives au contrat SLA associé à l’ID contrat SLA
indiqué.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displaySLAByID<ID_contrat_SLA>
Description
La commande scmd sdc displaySLAByID affiche des informations relatives au
contrat SLA associé à l’ID contrat SLA indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Il se peut que cette commande affiche une grande quantité d’informations.
Exemples
Affichez des informations relatives au contrat SLA associé à l’ID 1001.
scmd sdc displaySLAByID 1001
La sortie de cette commande peut être longue ; par conséquent, aucun exemple
n’est présenté dans cette section.
Voir aussi
scmd sdc displayAllSLAs, scmd sdc displaySLAMetricPropertyID, scmd sdc
displaySLAState
Chapitre 12. Commandes de base de données SLM 209
scmd sdc displaySLAMetricPropertyID
Recherche un identificateur interne sur la base d’un nom de mesure et d’un ID
contrat SLA fournis.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displaySLAMetricPropertyID <nom_mesure>
<ID_contrat_SLA>
Description
La commande scmd sdc displaySLAMetricPropertyID affiche l’identificateur
interne du nom de mesure indiqué qui est défini dans le contrat SLA spécifié.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<nom_mesure> Spécifie le nom de la mesure.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’ID propriété de la mesure TOTAL_RESPONSE_TI ME du contrat SLA
dont l’ID est 1001.
scmd sdc displaySLAMetricPropertyID TOTAL_RESPONSE_TIME 1001
Voir aussi
Néant.
210 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc displaySLAState
Affiche l’état d’un contrat SLA.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc displaySLAState <ID_contrat_SLA>
Description
La commande scmd sdc displaySLAState affiche l’état du contrat SLA associé à
l’ID contrat SLA indiqué.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe a été
activée. Pour plus d’informations, reportez-vous aux commandes scmd
setPassword et scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’état du contrat SLA 1010.
scmd sdc displaySLAState 1010
La sortie qui s’affiche est similaire à l’exemple suivant :
Terminé
Voir aussi
Néant.
Chapitre 12. Commandes de base de données SLM 211
scmd sdc getAssociatedSLAID
Extrait l’ID contrat SLA associé à un ID SLA d’annulation ou de modification.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc getAssociatedSLAID <ID_contrat_SLA>
Description
Lors du processus de modification ou d’annulation d’un contrat SLA, un nouvel
enregistrement SLA provisoire est créé dans la base de données à l’aide des
informations modifiées. Cet enregistrement provisoire est généralement fusionné
avec l’enregistrement SLA d’origine de sorte qu’un enregistrement SLA mis à jour
unique soit créé dans la base de données. Si un incident se produit au cours de ce
processus, cet enregistrement SLA provisoire reste à l’état Echec de la modification ou
Echec de l’annulation. Il en résulte deux enregistrements SLA dans la base de
données : l’enregistrement SLA d’origine avant la modification ou l’annulation et
l’enregistrement SLA ayant échoué qui contient les modifications relatives au
contrat SLA d’origine depuis l’échec du processus de modification ou d’annulation.
La commande scmd sdc getAssociatedSLAID extrait l’ID contrat SLA d’origine
associé à l’ID SLA d’annulation ou de modification indiqué, si l’état du contrat
SLA est Echec de la modification ou Echec de l’annulation.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<ID_contrat_SLA>
Indique l’ID du contrat SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Valeurs de retour
La commande scmd sdc getAssociatedSLAID renvoie une des valeurs suivantes :
v ID contrat SLA d’origine associé à l’ID SLA indiqué.
v Si aucun ID contrat SLA d’origine n’a été détecté pour l’ID SLA indiqué, un
message d’erreur est renvoyé.
Exemples
Affichez l’ID contrat SLA d’origine associé à l’ID SLA 1012.
scmd sdc getAssociatedSLAID 1012
Voir aussi
Néant.
212 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd sdc.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc help
Description
La commande scmd sdc help affiche la syntaxe et des exemples pour le
regroupement de commandes sdc.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’aide relative au regroupement de commandes sdc.
scmd sdc help
Voir aussi
Néant.
Chapitre 12. Commandes de base de données SLM 213
scmd sdc list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd sdc.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc list
Description
La commande scmd sdc list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes sdc.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes scmd sdc disponibles.
scmd sdc list
Voir aussi
Néant.
214 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc purgeIntermediateResults
Purge les résultats d’évaluation intermédiaires stockés antérieurs à l’heure
indiquée.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc purgeIntermediateResults <année> <mois>
<jour du mois>
Description
La commande scmd sdc purgeIntermediateResults supprime les résultats
d’évaluation intermédiaires stockés de sorte que la base de données ne soit pas
saturée. Vous pouvez indiquer une date pour que toutes les données de résultats
d’évaluation intermédiaires antérieurs à cette date soient supprimés de la base de
données. Vous devez exécuter cette commande périodiquement lorsque des
évaluations intermédiaires sont activées dans vos contrats SLA, car le volume des
résultats d’évaluation intermédiaires peut s’agrandir avec le temps.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<année> <mois> <jour du mois>
Les résultats d’évaluation intermédiaires antérieurs à la date
indiquée sont supprimés de la base de données. L’argument
<année> doit correspondre à un entier de quatre chiffres supérieur
à 999 et inférieur à 9999 (par exemple, 2004). L’argument <mois>
doit être un entier compris entre 1 et 12. L’argument <jour du mois>
correspond au jour du mois indiqué, exprimé sous la forme d’un
entier compris entre 1 et 31.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Purgez tous les résultats d’évaluation intermédiaires antérieurs au 15 mars 2004.
scmd sdc purgeIntermediateResults 2004 3 15
Voir aussi
scmd sdc purgeOldData
Chapitre 12. Commandes de base de données SLM 215
scmd sdc purgeOldData
Purge les résultats d’évaluation stockés qui sont antérieurs à l’heure indiquée.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc purgeOldData <année> <mois> <jour du mois>
Description
La commande scmd sdc purgeOldData supprime les résultats d’évaluation
d’objectifs de niveau de service stockés de sorte que la base de données SLM ne
soit pas saturée. Indiquez une date pour cette commande, de sorte que tous les
résultats d’évaluation d’objectifs de niveau de service ainsi que les données de
violation et de tendance antérieurs à cette date soient supprimés de la base de
données. Exécutez cette commande périodiquement, selon vos besoins, lorsque le
volume des résultats d’évaluation d’objectifs de niveau de service s’agrandit avec
le temps.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
<année> <mois> <jour du mois>
Les résultats d’évaluation d’objectifs de niveau de service, les
violations et les tendances antérieurs à la date indiquée sont
supprimés de la base de données. L’argument <année> doit
correspondre à un entier de quatre chiffres supérieur à 999 et
inférieur à 9999 (par exemple, 2004). L’argument <mois> doit être
un entier compris entre 1 et 12. L’argument <jour du mois>
correspond au jour du mois indiqué, exprimé sous la forme d’un
entier compris entre 1 et 31.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Purgez tous les résultats d’évaluation d’objectifs de niveau de service, les
violations et les tendances antérieurs au 15 mars 2004.
scmd sdc purgeOldData 2004 3 15
Voir aussi
scmd sdc purgeIntermediateResults
216 IBM Tivoli Service Level Advisor - Guide des commandes
scmd sdc registerWarehouseData
Enregistre des données d’entrepôt dans le serveur SLM, de sorte qu’elles soient
utilisés lors de la création d’offres.
Syntaxe
scmd [–p <motdepasse_en_cours>] sdc registerWarehouseData
Description
Lors de l’exécution de l’ETL d’enregistrement, les données sont déplacées de la
base de données Tivoli Data Warehouse (désignée également par entrepôt de
données central) vers la base de données SLM. La commande scmd sdc
registerWarehouseData enregistre ces données dans le serveur SLM, de sorte
qu’elles soient utilisées lors de la création d’offres et de contrats SLA. Avant que
cette commande soit émise, le processus ETL d’enregistrement doit placer les
données vers la base de données SLM.
Remarque : Le serveur SLM examine automatiquement la base de données SLM
toutes les dix minutes et enregistre, le cas échéant, toutes les nouvelles
données reçues de la base de données Tivoli Data Warehouse. Dans la
mesure où ces données sont enregistrées régulièrement dans le cadre
du processus normal, vous ne devez utiliser la commande scmd sdc
registerWarehouseData que lorsque vous ne voulez pas attendre la
prochaine vérification automatique.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours si la protection par mot de passe
a été activée. Pour plus d’informations, reportez-vous aux
commandes scmd setPassword et scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Enregistrez des données d’entrepôt pour les utiliser lors de la création d’offres.
scmd sdc registerWarehouseData
Voir aussi
Néant.
Chapitre 12. Commandes de base de données SLM 217
218 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 13. Commandes de gestion de composants
Le présent chapitre décrit les commandes CLI liées à la gestion des composants
d’IBM Tivoli Service Level Advisor, telles qu’elles sont présentées dans le
tableau 15.
Tableau 15. Commandes CLI liées à la gestion des adaptateurs et des composants
Commande CLI Page
scmd slm getComponentStatus 220
scmd slm getStatus 222
scmd slm help 224
scmd slm list 225
scmd slm listComponents 226
scmd slm shutdown 227
scmd slm startComponent 228
scmd slm stopComponent 230
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 219
scmd slm getComponentStatus
Affiche l’état d’un composant ou de l’ensemble des composants d’IBM Tivoli
Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm getComponentStatus [<nom_composant>]
Description
La commande scmd slm getComponentStatus affiche l’état d’un composant
spécifié d’IBM Tivoli Service Level Advisor. Si un nom de composant particulier
n’est pas indiqué, l’état de tous les composants s’affiche.
La sortie de la commande scmd slm getComponentStatus inclut le nom et l’état
du composant. Les états suivants sont disponibles :
v Démarrage en cours
v En cours d’exécution
v Arrêt en cours
v Arrêté
v Echec
Voici un exemple de sortie :
mySystem.raleigh.tivoli.com:ADPCLI:1 En cours d’exécution
Cela indique que le composant CLI adaptateur (ADPCLI) d’IBM Tivoli Service
Level Advisor sur la machine dont le nom d’hôte complet est
myComputer.raleigh.tivoli.com est à l’état En cours d’exécution.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nom_composant>
Indique le nom complet du composant. Vous pouvez obtenir ce
nom de composant en exécutant la commande scmd slm
listComponents (voir «scmd slm listComponents» à la page 226).
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’état du composant intitulé myComputer.raleigh.ibm.com:SLA:1.
scmd slm getComponentStatus myComputer.raleigh.ibm.com:SLA:1
2. Affichez l’état de tous les composants.
scmd slm getComponentStatus
220 IBM Tivoli Service Level Advisor - Guide des commandes
Voir aussi
scmd slm listComponents, scmd slm getStatus
Chapitre 13. Commandes de gestion de composants 221
scmd slm getStatus
Affiche des informations d’état relatives au serveur SLM d’IBM Tivoli Service Level
Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm getStatus
Description
La commande scmd slm getStatus affiche toutes les informations d’état relatives
au serveur SLM d’IBM Tivoli Service Level Advisor. Ces informations comprennent
l’état du serveur et de tous les composants recensés.
La sortie de la commande scmd slm getStatus inclut les informations suivantes :
v Nom du serveur
v Date de démarrage du serveur
v Etat en cours du serveur, qui peut correspondre à un des états suivants :
– En cours d’exécution
– Démarrage en cours
– Arrêt en coursv Liste de tous les composants et des états associés (il s’agit de la même sortie que
celle de la commande scmd slm listComponents). Les états peuvent comporter
les valeurs suivantes :
– Démarrage en cours
– En cours d’exécution
– Arrêt en cours
– Arrêté
– Echec
Voici un exemple de format de sortie :
Nom : mySystem.raleigh.ibm.com
Etat : En cours d’exécution
Démarré le mardi 25 mars 2003 11:47:17 AM EST
DYKAL9070I Le nombre de composants est 13.
mySystem.raleigh.ibm.com:ADPCLI:1 En cours d’exécution
mySystem.raleigh.ibm.com:LogCli:1 En cours d’exécution
mySystem.raleigh.ibm.com:RCC:1 En cours d’exécution
mySystem.raleigh.ibm.com:CLI:1 En cours d’exécution
mySystem.raleigh.ibm.com:DS:1 En cours d’exécution
mySystem.raleigh.ibm.com:CfgCli:1 En cours d’exécution
mySystem.raleigh.ibm.com:SDC:1 En cours d’exécution
mySystem.raleigh.ibm.com:ETL:1 En cours d’exécution
mySystem.raleigh.ibm.com:WDcCli:1 En cours d’exécution
mySystem.raleigh.ibm.com:MEM:1 En cours d’exécution
mySystem.raleigh.ibm.com:SLA:1 En cours d’exécution
mySystem.raleigh.ibm.com:OM:1 En cours d’exécution
mySystem.raleigh.ibm.com:OFFLINEUTIL:1 En cours d’exécution
222 IBM Tivoli Service Level Advisor - Guide des commandes
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez des informations d’état relatives au serveur SLM d’IBM Tivoli Service
Level Advisor.
scmd slm getStatus
Voir aussi
scmd slm getComponentStatus, scmd slm listComponents
Chapitre 13. Commandes de gestion de composants 223
scmd slm help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd slm.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm help
Description
La commande scmd slm help affiche la syntaxe de commande et des exemples
pour le regroupement de commandes scmd slm.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez l’aide relative au regroupement de commandes slm.
scmd slm help
Voir aussi
Néant.
224 IBM Tivoli Service Level Advisor - Guide des commandes
scmd slm list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd slm.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm list
Description
La commande scmd slm list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd slm.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes scmd slm disponibles.
scmd slm list
Voir aussi
Néant.
Chapitre 13. Commandes de gestion de composants 225
scmd slm listComponents
Affiche la liste de tous les composants gérés par le serveur SLM d’IBM Tivoli
Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm listComponents
Description
La commande scmd slm listComponents affiche la liste de tous les composants
gérés par le serveur SLM d’IBM Tivoli Service Level Advisor. La sortie comprend
le nombre total de composants et le nom complet de chaque composant associé à
son état en cours, comme présenté dans l’exemple de sortie suivant :
DYKAL9070I Le nombre de composants est 13.
mySystem.raleigh.ibm.com:ADPCLI:1 En cours d’exécution
mySystem.raleigh.ibm.com:LogCli:1 En cours d’exécution
mySystem.raleigh.ibm.com:RCC:1 En cours d’exécution
mySystem.raleigh.ibm.com:CLI:1 En cours d’exécution
mySystem.raleigh.ibm.com:DS:1 En cours d’exécution
mySystem.raleigh.ibm.com:CfgCli:1 En cours d’exécution
mySystem.raleigh.ibm.com:SDC:1 En cours d’exécution
mySystem.raleigh.ibm.com:ETL:1 En cours d’exécution
mySystem.raleigh.ibm.com:WDcCli:1 En cours d’exécution
mySystem.raleigh.ibm.com:MEM:1 En cours d’exécution
mySystem.raleigh.ibm.com:SLA:1 En cours d’exécution
mySystem.raleigh.ibm.com:OM:1 En cours d’exécution
mySystem.raleigh.ibm.com:OFFLINEUTIL:1 En cours d’exécution
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de tous les composants.
scmd slm listComponents
Voir aussi
scmd slm getComponentStatus
226 IBM Tivoli Service Level Advisor - Guide des commandes
scmd slm shutdown
Arrête le serveur SLM d’IBM Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm shutdown
Description
La commande scmd slm shutdown déclenche l’arrêt du serveur SLM d’IBM Tivoli
Service Level Advisor. Cette commande est asynchrone. Pour plus d’informations
sur le déroulement de l’arrêt, consultez le fichier journal.
L’utilisateur est informé, à l’aide du message suivant, que la demande d’arrêt a été
lancée :
DYKAL0250I La demande d’arrêt a été lancée. Consultez
le journal pour plus de détails.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Arrêtez le serveur SLM d’IBM Tivoli Service Level Advisor.
scmd slm shutdown
Voir aussi
Néant.
Chapitre 13. Commandes de gestion de composants 227
scmd slm startComponent
Démarre un composant d’IBM Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm startComponent <nom_composant>
Description
La commande scmd slm startComponent démarre le composant indiqué. Pour que
ce dernier démarre, il doit être à l’état Arrêté ou Echec, sinon un message d’erreur
s’affiche et la commande est annulée.
Un message indiquant la réussite ou l’échec de la commande s’affiche. L’exemple
suivant indique que le composant a été démarré :
DYKAL0254I Le composant myComputer.raleigh.tivoli.com:SLA:1 a été lancé.
Une fois que le démarrage du composant est terminé (réussite ou échec), un
message est imprimé. Le message indiquant que le démarrage a abouti s’affiche
comme suit :
DYKAL0254I Le composant myComputer.raleigh.tivoli.com:SLA:1 a été lancé.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nom_composant>
Indique le nom complet du composant. Vous pouvez obtenir ce
nom de composant en exécutant la commande scmd slm
listComponents. Les noms de composants sont indiqués au format
machine:type:instance, où :
v machine représente le nom d’hôte complet de la machine (par
exemple, myComputer.raleigh.ibm.com)
v type représente le type de composant (par exemple, LogCLI, SLA,
MEM, ADPCLI, etc.). Pour plus d’informations, reportez-vous à
la commande scmd slm listComponents.
v instanceID représente l’instance du composant, par exemple, 1
Un composant standard similaire à l’exemple suivant peut être
indiqué :
myComputer.raleigh.ibm.com:SLA:1
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Démarrez le composant intitulé myComputer.raleigh.tivoli.com:SLA:1.
scmd slm startComponent myComputer.raleigh.tivoli.com:SLA:1
228 IBM Tivoli Service Level Advisor - Guide des commandes
2. Démarrez le composant intitulé myComputer.raleigh.tivoli.com:OM:1.
scmd slm startComponent myComputer.raleigh.tivoli.com:OM:1
Voir aussi
scmd slm listComponents, scmd slm stopComponent
Chapitre 13. Commandes de gestion de composants 229
scmd slm stopComponent
Arrête un composant d’IBM Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] slm stopComponent <nom_composant>
Description
La commande scmd slm stopComponent arrête le composant indiqué. Pour que ce
dernier s’arrête, il doit être à l’état En cours d’exécution, sinon un message
d’erreur s’affiche et la commande est annulée.
Une fois que l’arrêt du composant est terminé (réussite ou échec), un message
s’affiche. La sortie d’un arrêt qui aboutit est similaire à l’exemple suivant :
DYKAL0255I Le composant myComputer.raleigh.tivoli.com:SLA:1 a été arrêté.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nom_composant>
Indique le nom complet du composant, au format
machine:type:instance, où :
v machine représente le nom d’hôte complet de la machine (par
exemple, myComputer.raleigh.ibm.com)
v type représente le type de composant (par exemple, LogCLI, SLA,
MEM, ADPCLI, etc.). Pour plus d’informations, reportez-vous à
la commande scmd slm listComponents.
v instanceID représente l’instance du composant, par exemple, 1
Un composant standard similaire à l’exemple suivant peut être
indiqué :
myComputer.raleigh.ibm.com:SLA:1
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Arrêtez le composant intitulé myComputer.raleigh.tivoli.com:SLA:1.
scmd slm stopComponent myComputer.raleigh.tivoli.com:SLA:1
2. Arrêtez le composant intitulé myComputer.raleigh.tivoli.com:OM:1.
scmd slm stopComponent myComputer.raleigh.tivoli.com:OM:1
Voir aussi
scmd slm listComponents, scmd slm startComponent
230 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 14. Commandes de gestion d’objets SLM
Le présent chapitre décrit les commandes CLI liées à la création de clients,
domaines, calendriers, offres et contrats SLA, en utilisant des commandes CLI au
lieu de passer par la console d’administration SLM (reportez-vous aux annexes du
document Gestion des contrats de service). Les commandes de ce chapitre sont
présentées dans le tableau 16.
Tableau 16. Commandes CLI liées à la gestion des objets SLM
Commande CLI Page
scmd som cancel 232
scmd som create 233
scmd som delete 235
scmd som displayAll 236
scmd som displayTimezones 237
scmd som export 238
scmd som help 240
scmd som list 241
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis. Pour plus
d’informations sur la définition et l’activation des mots de passe,
reportez-vous aux commandes CLI dans les sections «scmd
setPassword» à la page 16, et «scmd setPasswordEnabled» à la page
18.
© Copyright IBM Corp. 2002, 2004 231
scmd som cancel
Annule un contrat SLA indiqué.
Syntaxe
scmd [–p <motdepasse_en_cours>] som cancel –o SLA –id <ID_contrat_SLA>
Description
La commande scmd som cancel remplace l’état d’un contrat SLA par l’état Annulé,
en vue de sa suppression. Il est à noter que l’opération de suppression est une
étape distincte qui est effectuée à l’aide de la commande scmd som delete.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–o Indique le type de l’objet à annuler. Le seul type d’objet valide
actuellement est le contrat SLA.
–id Indique le numéro d’ID du contrat SLA à annuler, par exemple,
1002.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Emettez la commande pour annuler le contrat SLA 1011 :
scmd som cancel -o SLA -id 1011
Voir aussi
scmd som delete
232 IBM Tivoli Service Level Advisor - Guide des commandes
scmd som create
Utilise en entrée un fichier de propriétés pour un objet SLM et crée ce dernier dans
IBM Tivoli Service Level Advisor.
Syntaxe
scmd [–p <motdepasse_en_cours>] som create –o {schedule | offering | customer |
realm | SLA} –file <nom_fichier> [–UTF8]
Description
La commande scmd som create permet de créer un objet SLM (domaine, client,
calendrier, offre ou contrat SLA) à l’aide d’un fichier de propriétés au format texte.
Le nouvel objet SLM est stocké dans la base de données SLM, comme si vous
l’aviez créé à l’aide de la console d’administration SLM. Cette commande est
utilisée dans le cadre de la méthode qui permet de créer un grand nombre d’objets
SLM similaires sans qu’il soit nécessaire d’effectuer à chaque fois les étapes
détaillées de l’assistant de création dans la console d’administration SLM.
En général, vous créez d’abord un exemple ou un modèle d’objet SLM à l’aide de
la console d’administration SLM, puis vous exportez cet objet dans un fichier de
propriétés au format texte, dans lequel les attributs de l’objet SLM sont exprimés
dans une série de paires de mots clés/valeurs. Vous pouvez ensuite modifier ces
mots clés pour définir un nouvel objet SLM, puis utiliser cette commande scmd
som create afin de créer un client, un domaine, un calendrier, une offre ou un
contrat SLA à partir de ce fichier de propriétés modifié.
Si vous avez plusieurs objets SLM à créer, vous pouvez définir plusieurs fichiers de
propriétés à partir d’un fichier modèle unique, puis créer un fichier script
contenant plusieurs commandes scmd som create et exécuter ensuite le script afin
de remplir rapidement la base de données SLM à l’aide de ces nouveaux objets
SLM.
Il est à noter que le contrôle d’erreur est minimal. Un message est émis à la fin de
la commande, pour indiquer si la création a abouti ou non. Si la création a échoué,
vous devez consulter le fichier de propriétés pour déterminer l’incident qui s’est
produit et corriger ce dernier avant de relancer la commande. Pour obtenir plus
d’informations et visualiser des exemples de fichiers de propriétés, reportez-vous
aux annexes du document Gestion des contrats de service.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–o Indique le type de l’objet à créer. Indiquez un des types d’objets
SLM valides suivants : client, domaine, calendrier, offre ou contrat
SLA.
–file Indique le chemin et le nom complets du fichier de propriétés
Chapitre 14. Commandes de gestion d’objets SLM 233
(<nom_fichier>) à utiliser en entrée. Les mots clés indiqués dans le
fichier de propriétés servent à créer l’objet et à stocker le résultat
dans la base de données SLM.
–UTF8 Demande à l’interface de ligne de commande (CLI) d’utiliser le
codage UTF8 pour lire le fichier en entrée. Si cette option n’est pas
spécifiée, le codage par défaut de la machine JVM est utilisé.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Emettez la commande pour créer un calendrier à l’aide du fichier de propriétés
C:\TSLA\Schedule100.txt :
scmd som create -o schedule -file C:\TSLA\Schedule100.txt
2. Emettez la commande pour créer une offre à l’aide du fichier de propriétés
C:\TSLA\OfferABC.txt :
scmd som create -o offering -file C:\TSLA\OfferABC.txt
3. Emettez la commande pour créer un contrat SLA à l’aide du fichier de
propriétés C:\TSLA\AmplBankSLA.txt, en indiquant le codage UTF-8 :
scmd som create -o SLA -file C:\TSLA\AmplBankSLA.txt -UTF8
Voir aussi
scmd som displayAll, scmd som export
234 IBM Tivoli Service Level Advisor - Guide des commandes
scmd som delete
Supprime l’objet SLM indiqué de la base de données SLM.
Syntaxe
scmd [–p <motdepasse_en_cours>] som delete –o {schedule | offering | customer |
realm | SLA} –id <ID_objet>
Description
La commande scmd som delete permet de supprimer de la base de données le
client, le domaine, le calendrier, l’offre ou le contrat SLA indiqué. Si l’objet à
supprimer est un contrat SLA, celui-ci doit être à l’état Annulé , avant qu’il puisse
être supprimé. Si l’objet à supprimer est une offre ou un contrat SLA actif, il ne
peut pas être supprimé.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–o Indique le type de l’objet à supprimer. Indiquez un des types
d’objets SLM valides suivants : client, domaine, calendrier, offre ou
contrat SLA.
–id Indique l’ID de l’objet à supprimer, par exemple, 1000.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Supprimez l’offre dont l’ID est 1022.
scmd som delete -o offering -id 1022
2. Supprimez le client dont l’ID est 1007.
scmd som delete -o customer -id 1007
Voir aussi
scmd som cancel
Chapitre 14. Commandes de gestion d’objets SLM 235
scmd som displayAll
Affiche la liste des clients, domaines, calendriers, offres ou contrats SLA existants,
en fonction du type d’objet demandé.
Syntaxe
scmd [–p <motdepasse_en_cours>] som displayAll –o {schedule | offering |
customer | realm | SLA}
Description
La commande scmd som displayAll affiche le nom et l’ID de tous les objets SLM
existants du type indiqué (client, domaine, calendrier, offre ou contrat SLA). En
général, vous pouvez utiliser la sortie de cette commande pour sélectionner un
objet SLM existant à exporter vers un fichier de propriétés permettant de créer
d’autres objets similaires dans la base de données SLM sans passer par la console
d’administration SLM. Cette commande est utilisée dans le cadre de la méthode de
création de clients, domaines, calendriers, offres et contrats SLA à l’aide de
commandes CLI. Pour plus d’informations, reportez-vous aux annexes du
document Gestion des contrats de service.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–o Indique le type de l’objet à afficher. Indiquez un des types d’objets
SLM valides suivants : client, domaine, calendrier, offre ou contrat
SLA.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez la liste des calendriers qui existent dans la base de données SLM.
scmd som displayAll -o schedule
Le résultat est similaire à l’exemple suivant :
Schedules ... 3/29/04 3:27:14 PM EST
Cnt Name ID Description Global
--- ------------------- ---- ------------------- ---------
0. Schedule1 1000 Schedule1 Non-Global
1. 1001 1001 null Non-Global
2. Affichez la liste des offres qui existent dans la base de données SLM.
scmd som displayAll -o offering
Le résultat est similaire à l’exemple suivant :
ServiceOfferings ... 3/29/04 3:17:28 PM EST
Cnt Name ID State Schedule Description
--- ----------- ------ --------------- -------------- --------------
0. offering1 1000 STATE_PUBLISHED Schedule1 offering1
1. offering2 1001 STATE_PUBLISHED Schedule1 offering2
236 IBM Tivoli Service Level Advisor - Guide des commandes
scmd som displayTimezones
Affiche la liste des fuseaux horaires disponibles que vous pouvez utiliser lorsque
vous indiquez des informations de fuseau horaire dans les fichiers de propriétés
d’objets SLM.
Syntaxe
scmd [–p <motdepasse_en_cours>] som displayTimezones
Description
La commande scmd som displayTimezones affiche la liste des fuseaux horaires
disponibles que vous pouvez utiliser lorsque vous indiquez des informations de
fuseau horaire dans les fichiers de propriétés qui nécessitent ces informations.
Cette commande est similaire à la commande scmd report displayTimezones et est
incluse dans ce regroupement de commandes CLI som par souci de commodité.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez des informations relatives au fuseau horaire.
scmd som displayTimezones
Chapitre 14. Commandes de gestion d’objets SLM 237
scmd som export
Exporte les propriétés de l’objet SLM indiqué vers un fichier texte à des fins
d’édition.
Syntaxe
scmd [–p <motdepasse_en_cours>] som export –o {schedule | offering | customer |
realm | SLA} –id <ID_objet> –file <nom_fichier> [–UTF8]
Description
La commande scmd som export permet d’exporter un objet SLM (domaine, client,
calendrier, offre ou contrat SLA) de la base de données SLM vers un fichier de
propriétés au format texte. Vous pouvez ensuite modifier le fichier de propriétés
pour définir un nouvel objet SLM similaire. Ce fichier de propriétés modifié peut
ensuite être utilisé en entrée de la commande scmd som create pour créer le
nouvel objet SLM sans passer par la console d’administration SLM.
Cette commande est utilisée dans le cadre de la méthode de création de clients,
domaines, calendriers, offres et contrats SLA à l’aide de commandes CLI. Pour
obtenir plus d’informations et visualiser des exemples de fichiers de propriétés
créés à l’aide de cette commande d’exportation, reportez-vous aux annexes du
document Gestion des contrats de service.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
–o Indique le type de l’objet à exporter. Indiquez un des types d’objets
SLM valides suivants : client, domaine, calendrier, offre ou contrat
SLA.
–id Indique l’ID de l’objet à exporter, par exemple, 1000.
–file Indique le chemin et le nom complets du fichier de propriétés de
destination (<nom_fichier>) qui doit contenir les paires mot
clé/valeur qui définissent l’objet à exporter.
–UTF8 Demande à l’interface de ligne de commande (CLI) d’utiliser le
codage UTF8 pour mettre en forme le fichier de propriétés de
destination. Si cette option n’est pas spécifiée, le codage par défaut
de la machine JVM est utilisé.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Exportez les propriétés du contrat SLA dont l’ID est 1021 vers le fichier
C:\SLA1021.txt
scmd som export -o SLA -id 1021 -file C:\SLA1021.txt
238 IBM Tivoli Service Level Advisor - Guide des commandes
2. Exportez les propriétés du client dont l’ID est 1005 vers le fichier
C:\MyCust.txt
scmd som export -o customer -id 1005 -file C:\MyCust.txt
3. Exportez les propriétés de l’offre dont l’ID est 1008 vers le fichier
C:\TSLA\GoldLevelOffering.txt, en indiquant le codage UTF-8 :
scmd som export -o offering -file C:\TSLA\GoldLevelOffering.txt -UTF8
Chapitre 14. Commandes de gestion d’objets SLM 239
scmd som help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd som.
Syntaxe
scmd [–p <motdepasse_en_cours>] som help
Description
La commande scmd som help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd som.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes som.
scmd som help
240 IBM Tivoli Service Level Advisor - Guide des commandes
scmd som list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd som.
Syntaxe
scmd [–p <motdepasse_en_cours>] som list
Description
La commande scmd som list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd som.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd som.
scmd som list
Chapitre 14. Commandes de gestion d’objets SLM 241
242 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 15. Commandes de collecte de données d’entrepôt
La présente section décrit les commandes CLI que vous pouvez utiliser pour la
collecte de données d’entrepôt, telles qu’elles sont présentées dans le tableau 17.
Tableau 17. Commandes CLI pour la collecte de données d’entrepôt
Commande CLI Page
scmd wdccli connections 244
scmd wdccli help 245
scmd wdccli list 246
scmd wdccli listSettings 247
scmd wdccli setConRetries 248
scmd wdccli setConWait 249
scmd wdccli setETLPoll 250
scmd wdccli setLogStartEnd 251
Remarque : Pour toutes les commandes scmd, l’option –p <mot_de_passe> est
requise si la valeur de passwordEnabled du service CLI est true. Dans
le cas contraire, aucun mot de passe n’est requis, sauf dans le cas des
commandes scmd setPasswordEnabled et scmd setPassword qui
nécessitent systématiquement un mot de passe.
© Copyright IBM Corp. 2002, 2004 243
scmd wdccli connections
Renvoie le nombre de connexions à la base de données contrôlées par le
programme de collecte de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli connections
Description
La commande scmd wdccli connections renvoie le nombre de connexions à la base
de données contrôlées par le programme de collecte de données. Le composant de
collecte de données d’IBM Tivoli Service Level Advisor exécute ses opérations à la
demande du composant de gestion de l’évaluateur de mesures. Toutes les
opérations sont de courte durée (un ou deux requêtes de base de données) et le
programme de collecte de données obtient une connexion du pool de serveur SLM
au début de l’opération, puis la renvoie une fois l’opération terminée. Lorsque cette
commande est exécutée, le nombre de connexions contrôlées est renvoyé. Si le
programme de collecte de données est inactif, le nombre de connexions contrôlées
doit être zéro.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Demandez le nombre de connexions de base de données contrôlées par le
programme de collecte de données.
scmd wdccli connections
Lorsque le programme de collecte de données est inactif, la sortie affichée est la
suivante :
DYLWS0031I Connexions de base de données contrôlées par le programme de collecte
de données : 0
244 IBM Tivoli Service Level Advisor - Guide des commandes
scmd wdccli help
Affiche la syntaxe de commande et des exemples pour le regroupement de
commandes scmd wdccli.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli help
Description
La commande scmd wdccli help affiche la syntaxe, les variables, les options et des
exemples pour le regroupement de commandes scmd wdccli.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez l’aide relative au regroupement de commandes wdccli.
scmd wdccli help
Chapitre 15. Commandes de collecte de données d’entrepôt 245
scmd wdccli list
Affiche la liste de toutes les commandes et options disponibles pour le
regroupement de commandes scmd wdccli.
Syntaxe
scmd [–p<motdepasse_en_cours>] wdccli list
Description
La commande scmd wdccli list affiche la liste de toutes les commandes et options
disponibles pour le regroupement de commandes scmd wdccli.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Affichez la liste de toutes les commandes disponibles dans le regroupement de
commandes scmd wdccli.
scmd wdccli list
246 IBM Tivoli Service Level Advisor - Guide des commandes
scmd wdccli listSettings
Affiche la liste des paramètres configurables en cours pour le programme de
collecte de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli listSettings
Description
La commande scmd wdccli listSettings affiche les paramètres configurables en
cours du composant de collecte de données d’IBM Tivoli Service Level Advisor, y
compris les informations suivantes :
v Nombre de tentatives de connexion
v Délai d’attente entre les tentatives de connexion
v Intervalle d’interrogation ETL
v Paramètre de journalisation
Voici un exemple de sortie possible :
ConRetries = 10
ConWait = 20 (secondes)
ETLPoll = 10 (minutes)
logStartEnd = true
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Affichez la liste des paramètres en cours du programme de collecte de données.
scmd wdccli listSettings
Chapitre 15. Commandes de collecte de données d’entrepôt 247
scmd wdccli setConRetries
Définit le nombre de tentatives de connexion possibles à une base de données,
effectuées par le programme de collecte de données.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli setConRetries <nombre_tentatives>
Description
Le programme de collecte de données exécute des nouvelles tentatives de
connexion à la base de données suite à un échec. La commande scmd wdccli
setConRetries configure le nombre de nouvelles tentatives. Si la base de données
est provisoirement inaccessible, le fait de relancer l’opération évite des retards de
collecte de données. Pour optimiser les résultats, limitez le nombre de tentatives et
le délai entre les tentatives à un total d’une heure au maximum, si possible. Par
exemple, vous pouvez paramétrer le nombre de tentatives sur 5 et le délai entre les
tentatives sur 60 secondes, soit un total de 5 minutes. Pour définir le délai entre les
tentatives, reportez-vous à la commande scmd wdccli setConWait.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nombre_tentatives>
Indique le nombre de tentatives de connexion possibles à une base
de données.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Paramétrez le nombre de tentatives sur 10.
scmd wdccli setConRetries 10
Voir aussi
scmd setConWait
248 IBM Tivoli Service Level Advisor - Guide des commandes
scmd wdccli setConWait
Définit le délai d’attente, en secondes, entre les tentatives de connexion à la base
de données suite à un échec.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli setConWait <nombre_secondes>
Description
Le programme de collecte de données exécute des nouvelles tentatives de
connexion à la base de données suite à un échec. La commande scmd wdccli
setConWait définit le délai d’attente, en secondes, entre les tentatives de connexion
à la base de données suite à un échec. Si la base de données est provisoirement
inaccessible, le fait de relancer l’opération évite des retards de collecte de données.
Pour optimiser les résultats, limitez le nombre de tentatives et le délai entre les
tentatives à un total d’une heure au maximum, si possible. Par exemple, vous
pouvez paramétrer le nombre de tentatives sur 5 et le délai entre les tentatives sur
60 secondes, soit un total de 5 minutes. Pour définir le nombre de tentatives,
reportez-vous à la commande scmd wdccli setConRetries.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<nombre_secondes>
Indique le délai d’attente, en secondes, avant une nouvelle
tentative de de connexion à la base de données suite à un échec.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Définissez le délai d’attente entre les tentatives sur 30 secondes.
scmd wdccli setConWait 30
Voir aussi
scmd wdccli setConRetries
Chapitre 15. Commandes de collecte de données d’entrepôt 249
scmd wdccli setETLPoll
Définit l’intervalle d’interrogation de notification ETL.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli setETLPoll <intervalle_interrogation_etl>
Description
Des évaluations de mesures sont lancées lorsque le programme de collecte de
données détecte que le traitement du processus ETL est terminé. La commande CLI
setETLPoll peut modifier la fréquence à laquelle le programme de collecte de
données vérifie (interroge) si le processus ETL est terminé. L’intervalle
d’interrogation par défaut est de 10 minutes et l’intervalle d’interrogation
admissible minimum est égal à 1 minute.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
<intervalle_interrogation_etl>
Indique l’intervalle, en minutes, entre les vérifications de la fin du
processus ETL. La valeur par défaut est 10 et la valeur admissible
minimale est 1.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Paramétrez l’intervalle d’interrogation ETL sur 15 minutes :
scmd wdccli setETLPoll 15
250 IBM Tivoli Service Level Advisor - Guide des commandes
scmd wdccli setLogStartEnd
Active ou désactive les messages du journal chaque fois que la collecte de données
démarre et prend fin.
Syntaxe
scmd [–p <motdepasse_en_cours>] wdccli setLogStartEnd { true | false }
Description
Le programme de collecte de données peut consigner un message de début et de
fin sur la console chaque fois qu’il est appelé à collecter des données. Dans la
mesure où le journal de la console est généralement stocké dans la mémoire du
disque dur du système, ces messages peuvent éventuellement utiliser un espace
disque considérable ; ils sont donc désactivés par défaut. Ces messages peuvent
être utiles dans les situations de débogage ou de temporisation.
La commande scmd wdccli setLogStartEnd active ou désactive ces messages de
journal. Une valeur de true active la consignation des messages de début et de fin
chaque fois que le programme de collecte de données est appelé. Une valeur de
false désactive cette consignation.
L’exemple suivant illustre le format de message :
2002.01.07 16:05:20.015 DYLWS0008I Extraction commencée pour le composant : 3 "twhdc
CLI" 2001-01-01 00:00:01.0 to 2004-12-31 00:00:23.0 (GMT)
2002.01.07 16:05:20.109 DYLWS0009I Extraction terminée pour le composant : 3 "twhdc
CLI" 2 points de données (horaires) extraits pour l’ID type de mesure 1.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
true Active la consignation des messages de début et de fin dans le
journal de la console chaque fois que le programme de collecte de
données est appelé à rassembler des données.
false Désactive la consignation des messages de début et de fin dans le
journal de la console chaque fois que le programme de collecte de
données est appelé à rassembler des données.
Classe d’autorisation
Aucune autorisation n’est requise.
Exemples
Activez la consignation des messages de début et de fin :
scmd wdccli setLogStartEnd true
Désactivez la consignation des messages de début et de fin :
scmd wdccli setLogStartEnd false
Chapitre 15. Commandes de collecte de données d’entrepôt 251
252 IBM Tivoli Service Level Advisor - Guide des commandes
Chapitre 16. Utilitaires de service non CLI
La présente section décrit les utilitaires de service non CLI qui permettent
d’effectuer diverses tâches d’administration, comme présenté dans le tableau 18.
Tableau 18. Utilitaires de service non CLI
Commande utilitaire Page
cliutil 254
diagutil 255
dsutil 257
logutil 260
rcomutil 263
slmbackup 265
slmenv 268
slmrestore 269
slmrestorerestart 273
userdump 275
verutil 276
viewer 278
wasutil 284
Remarque : Pour initialiser l’environnement de commandes, vous devez
obligatoirement lancer l’utilitaire slmenv avant d’exécuter une de ces
autres commandes. Pour plus de détails sur la commande slmenv,
reportez-vous à la page 268.
© Copyright IBM Corp. 2002, 2004 253
cliutil
Définit ou extrait le numéro de port de service CLI, puis définit un nouveau mot
de passe pour le service CLI.
Syntaxe
cliutil {[resetPassword] | [setPort <numéro_port>] | getPort]}
Description
L’utilitaire cliutil définit ou extrait le port d’écoute du service CLI, puis définit un
nouveau mot de passe pour le service CLI.
La commande cliutil getport renvoie le numéro de port du service CLI dans un
message similaire à l’exemple suivant :
Port en cours du service CLI : 9990
Les commandes cliutil resetPassword et cliutil setPort renvoient un message
indiquant si l’opération a abouti. Par exemple, une commande cliutil
resetPassword qui a aboutit renvoie le message suivant :
Le mot de passe a été réinitialisé.
Options
resetPassword Remplace le mot de passe de service CLI par un mot de passe par
défaut connu. Pour plus d’informations, demandez à
l’administrateur SLM cette valeur par défaut ou consultez le Guide
d’administration d’IBM Tivoli Service Level Advisor.
setPort <numéro_port>
Paramètre le port d’écoute du service CLI sur le numéro de port
indiqué. Cette commande modifie les informations de
configuration et le script slmenv (pour plus d’informations,
reportez-vous à l’utilitaire de commande «slmenv» à la page 268).
Avant de modifier ce numéro de port, vérifiez que le numéro que
vous souhaitez utiliser est valide et qu’il n’est pas déjà utilisé par
une autre application.
getPort Extrait le port d’écoute en cours du service CLI.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Extrayez le numéro de port d’écoute en cours du service CLI.
cliutil getPort
2. Affectez au port d’écoute du service CLI la valeur 9991.
cliutil setPort 9991
3. Définissez un nouveau mot de passe pour le service CLI.
cliutil resetPassword
254 IBM Tivoli Service Level Advisor - Guide des commandes
diagutil
Exporte les données de diagnostic à utiliser par le service clients Tivoli.
Syntaxe
diagutil [–p <motdepasse_en_cours>] {dump | zip [-config] [-logs]}
Description
L’utilitaire diagutil exporte les données de diagnostic à utiliser par les techniciens
Tivoli pour les aider à diagnostiquer les incidents. L’utilitaire exécute de
nombreuses commandes scmd, de sorte que l’option –p <motdepasse_en_cours> doit
être utilisée si le service d’interface de ligne de commande est protégé à l’aide d’un
mot de passe. Des informations sont collectées pour une des trois options
d’installation principales d’IBM Tivoli Service Level Advisor (serveur SLM, console
Rapports SLM et serveur d’administration SLM). Quelques informations liées à
DB2 sont également collectées.
La commande diagutil dump affiche des informations sur la console, mais celles-ci
peuvent être réacheminées vers un fichier, à l’aide de l’opérateur >, par exemple,
dump > abc.txt.
La commande diagutil zip effectue l’opération d’exportation et collecte également
des informations de journalisation et de configuration, puis enregistre toutes ces
données dans un fichier zip du répertoire commun Tivoli d’IBM Tivoli Service
Level Advisor, intitulé diag.<horodatage>.zip, qui doit être envoyé au service
clients Tivoli pour les opérations de diagnostic.
Lorsque les options –config ou –logs sont utilisées avec la commande diagutil zip,
seuls les fichiers de configuration ou les fichiers journaux doivent être collectés. Si
–config ou –logs est indiqué, aucune commande scmd n’est exécutée. Pour
comprimer les fichiers de configuration, les fichiers journaux et la sortie scmd,
utilisez la commande diagutil zip.
Options
–p <motdepasse_en_cours>
Indique le mot de passe en cours qui est défini dans la
configuration. Cette option est obligatoire si la protection par mot
de passe a été activée pour le service CLI. Le mot de passe est
défini à l’aide de la commande scmd setPassword. La protection
par mot de passe est activée ou désactivée à l’aide de la commande
scmd setPasswordEnabled.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
v db2profile doit être lancé lors de l’exécution de cette commande sur les systèmes
d’exploitation UNIX.
v Si la sortie de la commande diagutil dump inclut des messages similaires à
l’exemple suivant, il se peut que la variable CLASSPATH soit trop longue :
-------- SLM Server Java Virtual Machine Memory --------
"C:\TSLA\bin\scmd.bat" -p password slm mem
Chapitre 16. Utilitaires de service non CLI 255
The input line is too long.
-------- SLM Server Java Virtual Machine System Properties --------
"C:\TSLA\bin\scmd.bat" -p password slm sysprops
The input line is too long.
-------- SLM Server Status --------
"C:\TSLA\bin\scmd.bat" -p password slm getstatus
The input line is too long.
Vous pouvez corriger cet incident en vérifiant la variable utilisateur CLASSPATH
ou les valeurs des variables d’environnement et en réduisant, si possible, la
valeur de la chaîne de chemin de classes. Vous pouvez émettre la commande set
classpath= pour effacer le chemin de classes.
Exemples
1. Rassemblez des données de diagnostic et affichez-les sur la console.
diagutil dump
2. Collectez et comprimez toutes les données de diagnostic, puis insérez des
informations de journalisation et de configuration et comprimez-les dans un
fichier à envoyer au service clients Tivoli.
diagutil zip
3. Collectez uniquement les les données de diagnostic de journalisation, puis
comprimez-les dans un fichier à envoyer au service clients Tivoli.
diagutil zip -logs
256 IBM Tivoli Service Level Advisor - Guide des commandes
dsutil
Modifie les informations relatives à la source de données indiquée.
Syntaxe
dsutil <nom_source_données> [url=<url>] [driver=<pilote>] [userid=<id_utilisateur>]
[password=<mot_de_passe>] [minconnections=<nombre_minimal_connexions>]
[maxconnections=<nombre_maximal_connexions>]
Description
L’utilitaire dsutil affiche ou met à jour des informations relatives à la source de
données indiquée. Vous pouvez modifier toutes les combinaisons des paramètres
de connexion à la base de données, afin de créer une source de données
remplaçant une source de données déjà existante. Les valeurs entrées doivent être
valides pour la base de données à laquelle vous accédez. Si certaines de ces valeurs
ne sont pas valides, le processus de création de sources de données affiche des
messages d’erreur pendant le redémarrage du serveur SLM et la création de source
de données échoue.
Si IBM Tivoli Service Level Advisor est réparti sur plusieurs systèmes, vous devez
exécuter dsutil sur chaque système doté d’une option d’installation SLM (serveur
SLM, serveur d’administration SLM ou console Rapports SLM).
Une fois ces paramètres modifiés, vous devez redémarrer le serveur SLM pour que
ces modifications prennent effet. Pour la console Rapports SLM et le serveur
d’administration SLM, vous devez redémarrer l’application concernée (SLMReport
ou SLMAdmin), à l’aide de la console d’administration WebSphere, ou redémarrer
le serveur WebSphere Application Server concerné pour que les modifications de
configuration prennent effet.
Pour obtenir l’état en cours d’une source de données particulière, émettez la
commande suivante :
dsutil <nom_source_données>
La sortie de cette commande est similaire à l’exemple suivant :
Pour le serveur <nom_serveur>, la source de données sdc est associée
aux valeurs suivantes :
url = jdbc:db2:db_name
driver = COM.ibm.db2.jdbc.app.DB2Driver
userid = db2user
minconnections = 3
maxconnections = 25
Options
<nom_source_données>
Indique le nom de la source de données à re-créer. Ce paramètre
doit indiquer le nom d’une source de données existante.
Les sources de données valides sont les suivantes :
dmt pour le magasin de données SLM Measurement (dyk_dm)
sdc pour la base de données SLM (dyk_cat)
url=<url> Indique l’URL de connexion JDBC nécessaire qui permet
d’identifier les bases de données et les pilotes appropriés. Pour
Chapitre 16. Utilitaires de service non CLI 257
connaître le format de cette URL, reportez-vous à la documentation
spécifique à votre système de gestion de base de données.
driver=<pilote>
Indique le pilote JDBC utilisé pour établir une connexion à la base
de données. Pour connaître le format de la chaîne du pilote,
reportez-vous à la documentation spécifique à votre système de
gestion de base de données. Pour le pilote d’application DB2, cette
valeur doit être paramétrée sur COM.ibm.db2.jdbc.app.DB2Driver.
userid=<id_utilisateur>
Indique le nom d’utilisateur employé pour la connexion à la base
de données.
password=<mot_de_passe>
Indique le mot de passe utilisé pour la connexion à la base de
données.
minconnections=<nombre_minimal_connexions>
Indique le nombre minimal de connexions à créer dans le pool de
connexions de base de données. Cette valeur doit être supérieure à
zéro et inférieure ou égale à la valeur indiquée dans
maxconnections. Si cette valeur n’est pas définie correctement, une
erreur est renvoyée et le paramètre n’est pas défini.
maxconnections=<nombre_maximal_connexions>
Indique le nombre maximal de connexions à créer dans le pool de
connexions de base de données. Cette valeur doit être supérieure
ou égale à la valeur indiquée dans minconnections. Ce paramètre
de configuration est associé au paramètre de configuration de
niveau base de données DB2, maxappls. Le paramètre de
configuration de base de données maxappls indique le nombre
maximal d’applications pouvant être connectées simultanément à
une base de données. Si vous augmentez la valeur maxconnections
dans dsutil, vous devez également augmenter la valeur de
maxappls. Pour plus d’informations sur les paramètres de
configuration de base de données, reportez-vous au Guide
d’administration DB2. Si cette valeur n’est pas définie correctement,
une erreur est renvoyée et le paramètre n’est pas défini.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez la liste des informations relatives à la base de données SLM (dyk_cat).
dsutil sdc
Pour une machine sur laquelle le serveur SLM et la console Rapports SLM sont
installés, la sortie de cette commande est similaire à l’exemple suivant :
DYKAL9184I Pour le serveur SLM, la source de données sdc est associée
aux valeurs suivantes :
url = jdbc:db2:dyk_cat
driver = COM.ibm.db2.jdbc.app.DB2Driver
userid = iddtest01
minconnections = 3
maxconnections = 25
258 IBM Tivoli Service Level Advisor - Guide des commandes
DYKAL9213I Pour le serveur Rapports SLM, la source de données sdc est associée
aux valeurs suivantes :
url = jdbc:db2:dyk_cat
driver = COM.ibm.db2.jdbc.app.DB2Driver
userid = iddtest01
minconnections = 3
maxconnections = 25
2. Mettez à jour l’URL de connexion de base de données pour la source de
données sdc de sorte qu’elle désigne une base de données différente intitulée
DataSrc2 :
dsutil sdc url=jdbc:db2:DataSrc2
3. Dans le cas d’une source de données dmt, la commande suivante met à jour le
nom d’utilisateur et le mot de passe permettant d’accéder à la base de données
:
dsutil dmt userid=newuser password=newpassword
Remarque : La source de données n’est créée que si le nom d’utilisateur et le
mot de passe sont des paramètres valides de connexion à la base
de données.
4. Dans le cas d’une source de données sdc sur système de gestion DB2, la
commande suivante met à jour le pilote JDBC permettant d’accéder à la base de
données :
dsutil sdc driver=COM.ibm.db2.jdbc.app.DB2Driver
Chapitre 16. Utilitaires de service non CLI 259
logutil
Affiche ou modifie les propriétés des objets de journalisation.
Syntaxe
logutil {filter | handler | message | trace} {[–g <nom_groupe>] | [<nom_objet>]}
{–keys | –get <clé> | –set <clé>=<valeur> | –contents | –list | –listactive}
Description
L’utilitaire logutil affiche ou modifie les propriétés des objets de journalisation. Ces
derniers peuvent correspondre à un des éléments suivants :
v Filtre
v Gestionnaire
v Message
v Trace
L’utilitaire logutil permet d’activer ou de désactiver la journalisation des servlets
de rapport et du serveur d’administration SLM, mais il peut également être
exécuté sur le poste serveur SLM.
L’utilitaire logutil est doté des mêmes fonctionnalités que le regroupement scmd
log ; cependant, il ne nécessite pas de connexion au service CLI. Pour plus de
détails sur le regroupement scmd log, voir Chapitre 5, «Commandes de
journalisation et de trace», à la page 63. Vous pouvez utiliser logutil de la même
manière, en remplaçant scmd log par logutil.
L’activation de la fonction de trace à l’aide de logutil risque de ne pas avoir lieu
immédiatement mais une fois que le service de configuration prend note de la
mise à jour. Si l’application est redémarrée à l’aide de la console d’administration
WebSphere ou si WebSphere Application Server est redémarré, la modification
prend effet immédiatement.
Options
filter | handler | message | trace
Cette commande peut être émise pour n’importe lequel de ces
objets.
–g <nom_groupe>
Indique le nom d’un groupe d’objets. Les modifications apportées
à ce groupe ont une incidence sur les propriétés de tous les objets
du groupe. Les noms de groupes font la distinction entre les
majuscules et les minuscules.
<nom_objet> Indique le nom de l’objet. Les noms d’objets font la distinction
entre les majuscules et les minuscules.
–keys Affiche la liste des propriétés (clés) de l’objet indiqué.
–get <clé> Extrait des informations relatives à la clé indiquée de l’objet. Les
noms de clés font la distinction entre les majuscules et les
minuscules.
–set <clé>=<valeur>
Définit une nouvelle propriété pour l’objet indiqué. Les noms de
clés et les valeurs indiquées font la distinction entre les majuscules
et les minuscules.
260 IBM Tivoli Service Level Advisor - Guide des commandes
–contents Affiche la liste des paires clé=valeur du programme de
journalisation ou de gestion identifié par <nom_objet>.
–list Affiche une liste de tous les objets. Si un nom de groupe est
indiqué, seuls les objets du groupe s’affichent.
–listactive Affiche une liste de tous les objets actifs. Si un nom de groupe est
indiqué, seuls les objets du groupe s’affichent.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez une liste de tous les objets filtre :
logutil filter -list
La sortie qui s’affiche est similaire à l’exemple suivant :
msgFilter
trcFilter
trcFilter/slmlevel3
trcFilter/slmlevel2
trcFilter/slmlevel1
trcFilter/slm
La liste inclut l’objet msgFilter et le nom de groupe trcFilter. Le groupe trcFilter
est également répertorié avec les programmes de journalisation de filtre de ce
groupe, slm, slmlevel1, slmlevel2 et slmlevel3.
2. Affichez la liste des programmes de journalisation de filtre du groupe trcFilter :
logutil filter -g trcFilter -list
La sortie qui s’affiche est similaire à l’exemple suivant :
trcFilter
trcFilter/slmlevel3
trcFilter/slmlevel2
trcFilter/slmlevel1
trcFilter/slm
3. Affichez la liste des clés du programme de journalisation de filtre msgFilter :
logutil filter msgFilter -keys
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/filter/msgFilter :
mask
className
description
Les clés du gestionnaire msgFilter sont mask, className et description.
4. Affichez la liste des clés du programme de journalisation msgFilter, puis le
contenu de chaque clé :
logutil filter msgFilter -contents
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/filter/msgFilter :
mask = TYPE_DEFAULT_MESSAGE
className = com.ibm.logging.AnyMaskFilter
description = filter for messages
Chapitre 16. Utilitaires de service non CLI 261
5. Affichez la liste des messages de trace qui sont consignés à l’aide du filtre
trcFilter/slmlevel2 :
logutil filter trcFilter/slmlevel2 -contents
La sortie qui s’affiche est similaire à l’exemple suivant :
/com/tivoli/util/logging/filter/trcFilter/slmlevel2 :
mask = TYPE_LEVEL1 TYPE_LEVEL2
Cela signifie que le filtre de trace prédéfini, trcFilter/slmlevel2, ne peut afficher
que les messages de trace TYPE_LEVEL1 et TYPE_LEVEL2. Les filtres
prédéfinis et les messages de trace qu’ils peuvent afficher sont les suivants :
trcFilter.slm
(par défaut) Permet d’afficher les messages de trace TYPE_LEVEL1
uniquement
trcFilter.slmlevel1
Permet d’afficher les messages de trace TYPE_LEVEL1 uniquement
trcFilter.slmlevel2
Permet d’afficher les messages de trace TYPE_LEVEL1 et
TYPE_LEVEL2 uniquement
trcFilter.slmlevel3
Permet d’afficher les messages de trace TYPE_LEVEL1, TYPE_LEVEL2
et TYPE_LEVEL36. Tous les programmes de journalisation d’IBM Tivoli Service Level Advisor sont
configurés de sorte que le filtre par défaut trcFilter.slm (TYPE_LEVEL1) soit
utilisé. Pour appliquer une modification à tous les programmes de
journalisation, vous pouvez modifier le masque de ce filtre.
Pour tracer les messages TYPE_LEVEL1 par défaut et les messages
TYPE_LEVEL2, émettez la commande suivante :
logutil filter trcFilter.slm -set mask="TYPE_LEVEL1 TYPE_LEVEL2"
262 IBM Tivoli Service Level Advisor - Guide des commandes
rcomutil
Affiche ou définit le nom d’hôte et le port utilisés pour la communication à
distance avec le composant serveur SLM d’IBM Tivoli Service Level Advisor.
Syntaxe
rcomutil getValues
rcomutil setValues <nom_hôte> <port>
Description
La commande rcomutil getValues affiche le nom d’hôte et le port utilisés pour la
communication à distance entre les composants serveur d’administration SLM et
serveur SLM, ou entre les composants serveur de rapports SLM et serveur SLM
d’IBM Tivoli Service Level Advisor. Le nom d’hôte correspond au nom d’hôte
complet du serveur SLM. Cette commande n’est disponible que sur le poste sur
lequel le serveur d’administration SLM ou le serveur Rapports SLM sont installés.
L’exemple suivant présente un exemple de sortie de la commande rcomutil
getValues qui affiche des informations relatives au poste serveur SLM dont le nom
d’hôte est mySystem.myCompany.com et auquel le numéro de port 9980 est affecté
pour la communication à distance (dans cet exemple, le serveur d’administration
SLM et le serveur Rapports SLM résident sur le même poste) :
DYKAL9156I Paramètres de communication à distance du serveur Rapports SLM :
Serveur SLM : mySystem.myCompany.com
Port : 9980
DYKAL9157I Paramètres de communication à distance du serveur d’administration SLM :
Serveur SLM : mySystem.myCompany.com
Port : 9980
La commande rcomutil setValues permet d’indiquer le nom d’hôte complet du
serveur SLM et de définir le port à utiliser pour la communication à distance avec
le serveur SLM. Le nom d’hôte correspond au nom d’hôte complet du serveur
SLM. Cette commande n’est disponible que sur le poste sur lequel le serveur
d’administration SLM ou le serveur Rapports SLM sont installés.
Si le port est modifié, une modification correspondante doit être apportée sur le
poste serveur SLM, à l’aide de la commande scmd rcc setport, de sorte que les
ports utilisés pour la communication entre le poste serveur SLM et le poste serveur
d’administration SLM ou Rapports SLM soient compatibles (pour plus
d’informations sur la commande scmd rcc setport, voir Chapitre 9, «Commandes
de communication à distance», à la page 141).
Remarque : Pour que le nouveau nom d’hôte et le nouveau port soient reconnus,
les applications SLMAdmin ou SLMReport doivent être redémarrées via
la console d’administration WebSphere ou le serveur WebSphere
Application Server de chaque application doit être redémarré.
Une fois que les valeurs sont modifiées, des messages similaires à l’exemple
suivant s’affichent (l’exemple suivant est le résultat du remplacement du nom
d’hôte par yourcomany.com et du numéro de port par 9981) :
DYKAL9194I Les valeurs ont été modifiées avec succès pour le serveur Rapports SLM.
WebSphere Application Server doit être redémarré avant l’utilisation
des nouvelles valeurs.
Chapitre 16. Utilitaires de service non CLI 263
Options
<nom_hôte> Nom complet du poste sur lequel le composant serveur SLM
d’IBM Tivoli Service Level Advisor est installé.
<port> Numéro de port à utiliser pour la communication à distance avec
le poste serveur SLM.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez le nom d’hôte et le numéro de port en cours pour la communication à
distance.
rcomutil getvalues
2. Remplacez le nom d’hôte par mycompany.com et le port par 9981.
rcomutil setvalues mycompany.com 9981
264 IBM Tivoli Service Level Advisor - Guide des commandes
slmbackup
Permet l’automatisation des étapes de la procédure de sauvegarde d’IBM Tivoli
Service Level Advisor.
Syntaxe
slmbackup {<répertoire_sortie> [–auto] | [–start] [–username <nom_utilisateur>
–password <mot_de_passe>]}
Description
Avant d’émettre des commandes slmbackup, consultez la documentation de
sauvegarde et de restauration dans le Guide d’administration.
L’utilitaire slmbackup exécute des opérations d’arrêt, de démarrage et de
sauvegarde sur les répertoires d’installation d’IBM Tivoli Service Level Advisor
dans le cadre de la procédure de sauvegarde définie.
Une fois que l’exécution des ETL d’enregistrement et de processus d’IBM Tivoli
Service Level Advisor a été interrompue, la commande slmbackup
<répertoire_sortie> peut être émise. La commande slmbackup ne doit pas être
lancée lors de l’exécution des ETL d’enregistrement et de processus ou si ces
derniers sont sur le point d’être exécutés conformément à leur programmation.
La commande slmbackup <répertoire_sortie> arrête les trois composants principaux
d’IBM Tivoli Service Level Advisor (serveur SLM, serveur d’administration SLM et
serveur Rapports SLM). Des images de sauvegarde des répertoires d’installation à
partir desquels la commande a été émise sont créées. Si ces trois composants d’IBM
Tivoli Service Level Advisor sont installés sur des machines ou partitions de
disque distinctes, la commande slmbackup doit être exécutée sur chacune des
machines et doit être émise à peu près en même temps, afin de garantir que tous
les trois composants sont arrêtés et que chacun est contenu dans une image de
sauvegarde. Dans cette situation, avant de créer l’image de sauvegarde, slmbackup
attend la confirmation selon laquelle tous les trois composants d’IBM Tivoli Service
Level Advisor sont arrêtés. Vous pouvez ignorer cette étape de confirmation en
spécifiant l’indicateur –auto.
Si l’indicateur –auto est spécifié ou une fois que la confirmation d’arrêt a été reçue,
le fichier <horodatage>.zip est créé et placé dans le répertoire
<répertoire_sortie>/DYK/<horodatage>. La valeur <horodatage> représente l’heure,
déterminée par l’utilitaire slmbackup, à laquelle la commande a été émise. Les
valeurs exactes utilisées pour les paramètres <répertoire_sortie> et <horodatage> pour
slmbackup doivent être conservées et utilisées ultérieurement pour restaurer cette
image de sauvegarde.
Une fois la commande slmbackup <répertoire_sortie> terminée, vous devez, avant
de redémarrer IBM Tivoli Service Level Advisor, effectuer les étapes restantes afin
d’exécuter la procédure de sauvegarde, telle qu’elle est décrite dans le Guide
d’administration. Une fois que toutes les procédures de sauvegarde ont été
terminées, vous pouvez utiliser slmbackup –start pour redémarrer IBM Tivoli
Service Level Advisor. Comme dans le cas de la procédure de sauvegarde, si IBM
Tivoli Service Level Advisor est installé sur plusieurs machines ou partitions de
disque, la commande slmbackup –start doit être émise sur chaque machine.
Chapitre 16. Utilitaires de service non CLI 265
Options
<répertoire_sortie>
Indique le répertoire principal dans lequel placer le fichier de
sauvegarde <horodatage>.zip. Ce fichier est placé dans le
répertoire suivant, où <horodatage> représente l’heure à laquelle la
commande slmbackup est appelée :
<répertoire_sortie>/DYK/<horodatage>
–auto Indique que la procédure de sauvegarde doit être exécutée sans
attendre la confirmation de l’utilisateur selon laquelle tous les
composants d’IBM Tivoli Service Level Advisor ont été arrêtés.
Cela n’est nécessaire que dans les configurations où les trois
composants résident sur plusieurs machines ou dans plusieurs
répertoires d’installation.
–start Démarre les principaux composants d’IBM Tivoli Service Level
Advisor. Cette option doit être utilisée une fois que toutes les
étapes de sauvegarde ont été terminées.
–username <nom_utilisateur>
Indique le nom d’utilisateur à utiliser lors de l’accès à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque la
sécurité WebSphere a été activée.
Remarque : Si le nom d’utilisateur est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
–password <mot_de_passe>
Indique le mot de passe à utiliser lors de l’accès à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque la
sécurité WebSphere a été activée.
Remarque : Si le mot de passe est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Il est important de comprendre toutes les étapes du processus de sauvegarde
d’IBM Tivoli Service Level Advisor, avant d’exécuter cette commande. Pour plus
d’informations sur la sauvegarde d’IBM Tivoli Service Level Advisor afin de vous
assurer que la commande slmbackup répond aux besoins de votre système et que
les données correctes issues de la commande slmbackup sont stockées,
reportez-vous au Guide d’administration d’IBM Tivoli Service Level Advisor.
Toutes les sauvegardes effectuées à l’aide de la commande slmbackup doivent être
restaurées via la commande slmrestore.
266 IBM Tivoli Service Level Advisor - Guide des commandes
Avant d’exécuter slmbackup, vous devez émettre la commande slmenv pour
configurer l’environnement de commandes IBM Tivoli Service Level Advisor. Pour
plus d’informations, voir «slmenv» à la page 268.
Fichiers
Le fichier suivant est créé :
<répertoire_sortie>/DYK/<horodatage>/<horodatage>.zip
Exemples
1. Sauvegardez le répertoire d’installation d’IBM Tivoli Service Level Advisor
dans l’emplacement suivant :
C:\temp\DYK\200112080908
Le fichier image de sauvegarde 200112080908.zip est placé dans le répertoire,
où 200112080908 représente la date/heure à laquelle la commande slmbackup a
été émise :
slmbackup C:\temp
2. Sauvegardez le répertoire d’installation d’IBM Tivoli Service Level Advisor
dans l’emplacement suivant, sans attendre la confirmation de l’utilisateur selon
laquelle un ou plusieurs des trois principaux composants d’IBM Tivoli Service
Level Advisor non résidant sur cette machine ont été arrêtés :
C:\temp\DYK\200112080908
Le fichier image de sauvegarde 200112080908.zip est placé dans le répertoire.
200112080908 représente la date/heure à laquelle la commande slmbackup a
été émise :
slmbackup C:\temp -auto
3. Lorsque la sécurité WebSphere est activée, redémarrez les trois composants
principaux d’IBM Tivoli Service Level Advisor (serveur SLM, serveur
d’administration SLM et serveur Rapports SLM) contenus dans cette
installation :
slmbackup -start -username userABC -password xyz123
Dans cet exemple, dans la mesure où la sécurité WebSphere est activée, vous
devez indiquer un nom d’utilisateur et un mot de passe valides pour accéder à
WebSphere Administration Server.
Voir aussi
slmrestore, slmenv
Chapitre 16. Utilitaires de service non CLI 267
slmenv
Initialise la fenêtre de commande en cours de sorte que les utilitaires scmd et
serveur puissent être exécutés.
Syntaxe
slmenv
Description
La commande slmenv définit des informations d’environnement nécessaires, de
sorte que les commandes utilitaires scmd et serveur puissent être exécutées
correctement. Sur les systèmes d’exploitation Windows, slmenv peut être exécuté
directement. Sur les systèmes d’exploitation UNIX, vous devez lancer slmenv en
indiquant un point (.) avant l’appel. Par exemple, sous UNIX, pour exécuter
correctement slmenv, entrez la commande suivante dans une invite :
. ./slmenv
La commande slmenv se trouve dans le répertoire d’installation indiqué au
moment de l’installation.
Options
Aucun
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Initialisez l’environnement de commandes sous Windows.
slmenv
2. Initialisez l’environnement de commandes sous UNIX.
. ./slmenv
268 IBM Tivoli Service Level Advisor - Guide des commandes
slmrestore
Permet l’automatisation des étapes de la procédure de restauration d’IBM Tivoli
Service Level Advisor. La commande slmrestore se trouve sur le CD-ROM du
produit IBM Tivoli Service Level Advisor et ne peut être exécutée qu’à partir de ce
CD-ROM.
Syntaxe
slmrestore <répertoire_emplacement_image> [<horodatage>] [–auto] [–username
<nom_utilisateur> –password <mot_de_passe>]
Description
Avant d’émettre des commandes slmrestore, consultez la documentation de
sauvegarde et de restauration dans le Guide d’administration d’IBM Tivoli Service
Level Advisor.
L’utilitaire slmrestore exécute des opérations d’arrêt et de restauration sur les
répertoires d’installation d’IBM Tivoli Service Level Advisor et ré-importe les
servlets de rapports SLM de WebSphere dans le cadre de la procédure de
restauration définie.
Une fois que l’exécution des ETL d’enregistrement et de processus d’IBM Tivoli
Service Level Advisor a été interrompue, la commande slmrestore
<répertoire_emplacement_image> <horodatage> peut être émise. La commande
slmrestore ne doit pas être lancée lors de l’exécution des ETL d’enregistrement et
de processus ou si ces derniers sont sur le point d’être exécutés conformément à
leur programmation.
La commande slmrestore <répertoire_emplacement_image> <horodatage> arrête les
trois composants principaux d’IBM Tivoli Service Level Advisor (serveur SLM,
serveur d’administration SLM et serveur Rapports SLM) et restaure les répertoires
d’installation à partir du fichier image de sauvegarde <horodatage>.zip qui est
situé dans le répertoire <répertoire_emplacement_image>/DYK/<horodatage> vers
son répertoire d’installation d’origine. Les valeurs de
<répertoire_emplacement_image> et <horodatage> doivent être identiques à celles
utilisées ou créées lors de la procédure de sauvegarde d’origine, à l’aide de la
commande slmbackup <répertoire_emplacement_image>.
Si les trois composants principaux d’IBM Tivoli Service Level Advisor sont installés
sur des machines ou partitions de disque distinctes, la commande slmrestore doit
être exécutée sur chacune des machines et doit être émise à peu près en même
temps, afin de garantir que tous les trois composants sont arrêtés et que chacun est
restauré vers des images de sauvegarde compatibles. Dans cette situation, avant
d’effectuer l’opération de restauration, slmrestore attend la confirmation selon
laquelle tous les trois composants d’IBM Tivoli Service Level Advisor sont arrêtés.
Vous pouvez ignorer cette étape de confirmation en spécifiant l’indicateur –auto.
Si l’indicateur –auto est spécifié ou une fois que la confirmation d’arrêt a été reçue,
le fichier, slmrestore ré-importe les servlets de rapports SLM vers WebSphere. Si
l’option Rapports SLM d’IBM Tivoli Service Level Advisor n’est pas installée sur
cette machine, cette étape est ignorée.
Une fois la commande slmrestore <répertoire_emplacement_image><horodatage>
terminée, vous devez, avant de redémarrer IBM Tivoli Service Level Advisor,
effectuer les étapes restantes afin d’exécuter la procédure de restauration, telle
Chapitre 16. Utilitaires de service non CLI 269
qu’elle est décrite dans le Guide d’administration. Une fois que toutes les procédures
de restauration ont été terminées, vous pouvez utiliser slmrestorerestart pour
redémarrer IBM Tivoli Service Level Advisor. Comme dans le cas de la procédure
de restauration, si IBM Tivoli Service Level Advisor est installé sur plusieurs
machines ou partitions de disque, la commande slmrestorerestart doit être émise
sur chaque machine.
La commande slmrestorerestart est une commande de service non CLI et,
contrairement à slmrestore, peut être utilisée dans un shell où l’environnement de
ligne de commande a correctement été initialisé. Pour plus de détails sur son
utilisation, voir «slmrestorerestart» à la page 273.
Options
<répertoire_emplacement_image>
Indique le répertoire principal dans lequel des fichiers de
sauvegarde ont été placés lors de la procédure slmbackup. Le
répertoire indiqué doit contenir le répertoire /DYK/<horodatage>
qui contient le fichier de sauvegarde <horodatage>.zip. Il n’est pas
nécessaire d’indiquer le répertoire /DYK/<horodatage> dans le
cadre du paramètre <répertoire_emplacement_image>.
<horodatage> Définit l’horodatage qui indique une image de sauvegarde prise
par la commande slmbackup. Tous les fichiers de sauvegarde sont
situés dans un répertoire intitulé à l’aide de l’heure à laquelle
l’image a été prise. Ce répertoire <horodatage> est un
sous-répertoire du répertoire DYK contenu dans l’emplacement
<répertoire_emplacement_image>. Le répertoire <horodatage> indiqué
doit contenir le fichier de sauvegarde <horodatage>.zip.
–auto Indique que la procédure de restauration doit être exécutée sans
attendre la confirmation de l’utilisateur selon laquelle tous les
composants d’IBM Tivoli Service Level Advisor ont été arrêtés.
Cela n’est nécessaire que dans les configurations où les trois
composants résident sur plusieurs machines ou dans plusieurs
répertoires d’installation.
–username <nom_utilisateur>
Indique le nom d’utilisateur à utiliser lors de l’accès à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque la
sécurité WebSphere a été activée.
Remarque : Si le nom d’utilisateur est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
–password <mot_de_passe>
Indique le mot de passe à utiliser lors de l’accès à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque la
sécurité WebSphere a été activée.
Remarque : Si le mot de passe est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
270 IBM Tivoli Service Level Advisor - Guide des commandes
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
La commande slmrestore est différente de toutes les autres commandes CLI dans
la mesure où elle est exécutée à partir du CD-ROM du produit IBM Tivoli Service
Level Advisor. Elle se trouve dans le répertoire <image_CD>/tools/restore, où
<image_CD> représente l’emplacement de l’unité de CD-ROM contenant le
CD-ROM du produit IBM Tivoli Service Level Advisor. La commande slmrestore
doit être émise à partir d’un shell de commandes dans lequel
<image_CD>/tools/restore est le répertoire en cours. La commande slmrestore ne
fonctionne qu’à partir de ce répertoire.
Il est important de comprendre toutes les étapes du processus de restauration
d’IBM Tivoli Service Level Advisor, avant d’exécuter cette commande. Pour plus
d’informations sur la restauration d’IBM Tivoli Service Level Advisor afin de vous
assurer que la commande slmrestore répond aux besoins de votre système et que
les données correctes sont utilisées pour chaque restauration, reportez-vous au
Guide d’administration d’IBM Tivoli Service Level Advisor.
Fichiers
Le fichier ci-dessous contient l’image comprimée du répertoire d’installation d’IBM
Tivoli Service Level Advisor. Cette image est décomprimée vers son répertoire
d’installation d’origine :
<répertoire_sortie>/DYK/<horodatage>/<horodatage>.zip
Exemples
1. Restaurez le répertoire d’installation d’IBM Tivoli Service Level Advisor, qui se
trouve dans le répertoire suivant, vers son répertoire d’installation d’origine :
C:\temp\DYK\200112080908
Le fichier 200112080908.zip est contenu dans le répertoire et utilisé lors de la
restauration. La valeur 200112080908 représente la date/heure à laquelle la
commande slmbackup a été émise :
slmrestore C:\temp 200112080908
2. Restaurez l’image de répertoire d’IBM Tivoli Service Level Advisor, qui se
trouve dans le répertoire C:\temp\DYK\200112080908, vers son répertoire
d’installation d’origine, sans attendre la confirmation de l’utilisateur selon
laquelle un ou plusieurs des trois principaux composants d’IBM Tivoli Service
Level Advisor non résidant sur cette machine ont été arrêtés. Le fichier
200112080908.zip est contenu dans le répertoire et est utilisé lors de la
restauration. La valeur 200112080908 représente la date/heure à laquelle la
commande slmbackup a été émise. On part du principe que la sécurité
WebSphere est activée.
slmrestore C:\temp 200112080908 -auto -username user101 -password xyz123
Dans la mesure où la sécurité WebSphere est activée, vous devez indiquer un
nom d’utilisateur et un mot de passe valides pour accéder à WebSphere
Administration Server.
3. Revenez à l’écran d’aide de slmrestore et à la liste des horodatages de toutes
les images de sauvegarde contenues dans le répertoire C:\temp\DYK. Les valeurs
Chapitre 16. Utilitaires de service non CLI 271
renvoyées peuvent être utilisées pour le paramètre <horodatage> dans la
commande slmrestore <répertoire_emplacement_image> <horodatage> :
slmrestore C:/temp
4. Revenez à l’écran d’aide de slmrestore :
slmrestore
Voir aussi
slmbackup, slmrestorerestart
272 IBM Tivoli Service Level Advisor - Guide des commandes
slmrestorerestart
Redémarre un IBM Tivoli Service Level Advisor restauré.
Syntaxe
slmrestorerestart [–username <nom_utilisateur> –password <mot_de_passe>]
Description
Avant d’émettre la commande slmrestorerestart, consultez la documentation de
sauvegarde et de restauration dans le Guide d’administration d’IBM Tivoli Service
Level Advisor.
La commande slmrestorerestart exécute l’étape de démarrage de la procédure de
restauration définie d’IBM Tivoli Service Level Advisor. Elle doit être exécutée une
fois que la commande slmrestore <répertoire_emplacement_image> <horodatage>
aboutit. Comme dans le cas de slmrestore, si les trois composants principaux
d’IBM Tivoli Service Level Advisor sont installés sur des machines ou partitions de
disque distinctes, la commande slmrestorerestart doit être exécutée sur chacune
des machines.
La commande slmrestorerestart peut être utilisée dans n’importe quel shell où
l’environnement de ligne de commande a correctement été initialisé.
Options
–username <nom_utilisateur>
Indique le nom d’utilisateur à utiliser lors de l’accès à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque la
sécurité WebSphere a été activée.
Remarque : Si le nom d’utilisateur est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
–password <mot_de_passe>
Indique le mot de passe à utiliser lors de l’accès à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque la
sécurité WebSphere a été activée.
Remarque : Si le mot de passe est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Chapitre 16. Utilitaires de service non CLI 273
Exemples
1. Démarrez les composants principaux d’IBM Tivoli Service Level Advisor une
fois la commande slmrestore <répertoire_sortie> <horodatage> terminée :
slmrestorerestart
2. Répétez le premier exemple en activant la sécurité WebSphere :
slmrestorerestart -username userABC -password xyz123
Dans la mesure où la sécurité WebSphere est activée, vous devez indiquer un
nom d’utilisateur et un mot de passe valides pour accéder à WebSphere
Administration Server.
Voir aussi
slmbackup, slmenv, slmrestore
274 IBM Tivoli Service Level Advisor - Guide des commandes
userdump
Exporte toutes les données de migration utilisateur vers un fichier texte.
Syntaxe
userdump <nom_fichier>
Description
L’utilitaire userdump exporte toutes les données de migration utilisateur collectées
à partir de Tivoli Presentation Services et des versions précédentes de l’option
Rapports SLM d’IBM Tivoli Service Level Advisor vers un fichier texte. Cet
utilitaire est efficace lors de l’utilisation des registres d’utilisateur de migration non
pris en charge, tels que LDAP ou les registres d’utilisateurs WebSphere
personnalisés. Vous pouvez ensuite utiliser les informations obtenues, afin de créer
manuellement des utilisateurs pour IBM Tivoli Service Level Advisor version 2.1.
L’utilitaire génère une sortie uniquement lorsqu’une migration a eu lieu à partir
d’une précédente version d’IBM Tivoli Service Level Advisor. Vous pouvez
également émettre l’utilitaire à partir de n’importe lequel des serveurs IBM Tivoli
Service Level Advisor.
Options
<nom_fichier>
Nom de chemin complet du fichier de destination dans lequel des données
de migrations doivent être stockées. Si le nom de fichier indiqué n’existe
pas déjà, il est créé automatiquement.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
Exportez des données de migration utilisateur vers le fichier D:\myusers1.out :
userdump D:\myusers1.out
Les données de migration sont enregistrées dans le fichier myusers1.out. Si ce
dernier n’existe pas déjà, il est créé automatiquement.
La sortie de l’utilitaire userdump est similaire à l’exemple suivant :
#
# Jan 7, 2004 11:15:32 AM
#
User Name = jpublic
User Full Name = John Public
User Roles = SLA Specialist,Offering Specialist,SLM Administrator
Admin User = true
Report User = true
#
User Name = RJones
User Full Name = Richard Jones
User Roles = SLA Specialist
Admin User = true
Report User = true
#
Chapitre 16. Utilitaires de service non CLI 275
verutil
Affiche des informations de version relatives à tous les fichiers jar de composant
ou à un fichier individuel, puis recherche les fichiers jar qui ne sont pas
compatibles avec l’édition ou le niveau de correctif en cours.
Syntaxe
verutil {check | dump [<nom_fichier_sortie>] | –f <nom_fichier>}
Description
La commande verutil affiche des informations de version relatives à tous les
fichiers jar de composant ou à un fichier individuel, puis recherche les fichiers jar
qui ne sont pas compatibles avec l’édition ou le niveau de correctif en cours. Ces
informations s’affichent pour une des trois options d’installation d’IBM Tivoli
Service Level Advisor (serveur SLM, console Rapports SLM et serveur
d’administration SLM) et ne sont généralement requises que lors de la remise
d’informations de diagnostic au service clients Tivoli.
La commande verutil check effectue un contrôle de version sur tous les fichiers jar
installés du produit et signale tous les fichiers jar qui ne sont pas compatibles avec
l’édition ou le niveau de correctif en cours.
La commande verutil dump <nom_fichier_sortie> génère un rapport détaillant
toutes les informations de version relatives au produit. Le rapport répertorie la
version du produit complet et celle de chaque fichier jar de composant. Si
<nom_fichier_sortie> est indiqué, le rapport est consigné dans ce fichier ; dans le cas
contraire, le rapport est consigné sur la console.
La commande verutil –f <nom_fichier> signale les informations de version pour le
fichier jar indiqué <nom_fichier>.
Options
<nomfichier_sortie>
Indique le nom du fichier dans lequel le rapport de version est
consigné.
–f <nom_fichier>
Indique le nom du fichier jar particulier sur lequel établir un
rapport des informations de version.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
276 IBM Tivoli Service Level Advisor - Guide des commandes
Exemples
1. Effectuez un contrôle de version sur tous les fichiers jar installés.
verutil check
La sortie de la commande est similaire à l’exemple suivant, lorsque tous les
fichiers jar correspondent à l’édition et au niveau de correctif en cours :
IBM Tivoli Service Level Advisor Version 2.1.0.0 - 3/20/04 12:37 PM
Toutes les versions de fichier jar du serveur SLM correspondent à l’édition
en cours.
Toutes les versions de fichier jar du serveur d’administration SLM correspondent
à l’édition en cours.
Toutes les versions de fichier jar du serveur de rapports SLM correspondent
à l’édition en cours.
2. Générez un rapport de version de produit, affiché sur la console.
verutil dump
3. Générez un rapport de version de produit, en le consignant dans le fichier
C:/temp/version.report :
verutil dump C:/temp/version.report
4. Vérifiez la version du fichier jar intitulé spi.jar.
verutil -f spi.jar
La sortie de cette commande s’affiche sur la console et est similaire à l’exemple
suivant :
DYKAL9007I Rapport sur la version du serveur SLM
spi.jar 2.1.0.0 2/17/04 3:20 AM (427900 octets)
DYKAL9009I Rapport sur la version du serveur Rapports SLM
(WebSphere Application Server:5.0.2)
spi.jar 2.1.0.0 2/17/04 3:20 AM (427900 octets)
DYKAL9008I Rapport sur la version du serveur d’administration SLM
(WebSphere Application Server:5.0.2)
spi.jar 2.1.0.0 2/17/04 3:20 AM (427900 octets)
Chapitre 16. Utilitaires de service non CLI 277
viewer
Traite les fichiers journaux au format XML Tivoli pour les présenter en ASCII ou
HTML.
Syntaxe
viewer [ –q ″<chaîne_requêtes>″ | –f <nom_fichier>] [ –s { ascii | html }] [–h]
<entrée.xml> [<entrée.xml>*] [ > <fichier_sortie>]
Description
La commande viewer traite les fichiers journaux au format XML Tivoli pour les
présenter en ASCII ou HTML. Elle permet la corrélation et le filtrage des fichiers
journaux XML générés par plusieurs produits, en fonction d’une fenêtre de temps,
du niveau de gravité ou de trace, de l’ID unité d’exécution, du composant et de
plusieurs autres zones. Elle requiert le format XML spécifique des journaux Tivoli.
Les fichiers XML qui ne sont pas au format standard Tivoli ne peuvent pas être
traités par l’afficheur de journaux XML.
Vous pouvez entrer une chaîne de requêtes indiquant une ou plusieurs zones à
afficher, ou vous pouvez désigner un fichier contenant la chaîne de requêtes. Vous
pouvez choisir le format de la sortie (ASCII ou HTML) et spécifier un ou plusieurs
fichiers XML en entrée à examiner. Pour finir, vous pouvez acheminer la sortie vers
un fichier ou faire en sorte que la sortie s’affiche par défaut sur la console.
Options
–q ″<chaîne_requêtes>″
Indique les zones qui doivent apparaître dans la sortie générée, et
définit les critères d’affichage des enregistrements de journal. La
chaîne de requêtes doit être placée entre guillemets.
–f <nom_fichier>
Indique le nom d’un fichier contenant une chaîne de requêtes.
–s {ascii | html}
Indique si la sortie doit être générée au format ASCII ou HTML.
HTML est le format par défaut.
–h Affiche le menu d’aide.
<entrée.xml> Indique le nom d’un ou plusieurs fichiers journaux qui sont au
format XML Tivoli.
<fichier_sortie> Indique le nom d’un fichier dans lequel enregistrer la sortie. Par
défaut, la sortie s’affiche sur la console.
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Remarques
Les sections ci-dessus contiennent des détails sur la spécification des commandes
d’affichage (viewer).
Création d’une chaîne de requêtes
La chaîne de requêtes transmise à l’afficheur de journal via l’option –q ou –f
fournit à l’afficheur de journal ses fonctions de filtrage et de corrélation. Vous
pouvez déterminer les requêtes, s’il y a lieu, qui sont utiles lors de la génération
278 IBM Tivoli Service Level Advisor - Guide des commandes
des fichiers journaux. Une chaîne de requêtes permet d’ajuster les informations
contenues dans chaque enregistrement de journal et de choisir les enregistrements
de journal à afficher. Si aucune chaîne de requêtes n’est indiquée, la chaîne de
requêtes par défaut utilisée est ″select default where true″.
La chaîne de requêtes doit être indiquée au format suivant :
select <colonne> [,<colonne>] where <prédicat_filtre>
Définition des colonnes : La variable <colonne> détermine les zones de chaque
enregistrement de journal qui doivent s’afficher dans la sortie générée. Les zones
varient selon si l’enregistrement de journal est destiné aux données de trace ou de
message. Chaque enregistrement de journal peut contenir les zones suivantes :
Tableau 19.
Zone de colonne Informations affichées Exemple
Component Composant interne d’IBM Tivoli Service
Level Advisor dans lequel
l’enregistrement de journal a été créé.
MEM
Element Type d’enregistrement de journal,
Message ou Trace
Message
Exception Informations d’exception Java java.io.IOException
LogText Texte de l’enregistrement de journal Création de la commande
2002
MessageID ID spécifique à un enregistrement de
journal
DYKME1023I
Millis Heure (en millisecondes) 1022029398844
ProductId ID produit Tivoli, DYK pour les
enregistrements IBM Tivoli Service Level
Advisor
DYK
Server Chaîne, nom ou adresse IP du serveur
sur lequel l’enregistrement de journal a
été obtenu
myserver.mydomain.com:1
Severity (voir
remarque 1
ci-dessous)
Niveau de gravité d’un enregistrement
de journal de messages. Les valeurs
admises sont INFO, ERROR ou WARN.
INFO
SourceFile Fichier source dans lequel l’événement a
été généré.
com.Tivoli.managed.
om.OrderManager
SourceMethod Méthode ayant généré l’événement. createOrder()
Thread ID ou nom d’une unité d’exécution. Thread-4
Time Heure au format ISO 2002-06-27 0:06:58.141 EST
TraceLevel (voir
remarque 2
ci-dessous)
Niveau de trace. Les valeurs admises
sont MIN, MID, MAX ou OTHER
MID
Remarques :
1. La zone Severity est réservée uniquement aux journaux de messages. Pour plus
d’informations sur les trois niveaux de gravité INFO, ERROR et WARN utilisés
avec l’afficheur de journal XML, reportez-vous à la section ci-dessous relative à
l’ID message.
Chapitre 16. Utilitaires de service non CLI 279
2. La zone TraceLevel est réservée uniquement aux journaux de trace. Les niveaux
de trace MIN, MID et MAX de l’afficheur de journal XML correspondent
respectivement aux niveaux de trace LEVEL1, LEVEL2 et LEVEL3 d’IBM Tivoli
Service Level Advisor.
Vous pouvez utiliser le mot all à la place d’une colonne, afin d’indiquer que toutes
les colonnes doivent s’afficher. Le mot default sélectionne les colonnes suivantes :
Time, Severity, Message Id, LogText, Server, Product Id, Component et Product
Instance. La zone de colonne ne fait pas la distinction entre les majuscules et les
minuscules.
Remarque : La zone d’instance de produit d’IBM Tivoli Service Level Advisor
reste vide. Si une colonne indiquée n’existe pas pour un
enregistrement de journal, une zone vide s’affiche.
Définition des prédicats de filtre : Le <prédicat de filtre> détermine les
enregistrements de journal particuliers qui sont présents dans la sortie. Il est
indiqué au format d’un expression, ou le mot réservé true, ce qui occasionne la
génération de tous les enregistrements de journal. Cela est utile lorsque vous
souhaitez ajuster uniquement les colonnes qui sont présentes dans les journaux
générés.
Chaque prédicat de filtre est indiqué au format suivant :
<colonne> <opérateur> <valeur>
Les noms de colonne ci-dessus peuvent être utilisés sous forme de clés dans le
prédicat de filtre pour indiquer les valeurs de colonnes particulières pour
lesquelles des enregistrements de journal doivent s’afficher. Par exemple,
l’expression Severity=Error indique que seuls les enregistrements de journal dans
lesquels la colonne Severity comporte la valeur Error doivent s’afficher.
Un <opérateur> sert à déterminer les relations entre la <valeur> et la <colonne>
indiquée. Dans l’exemple ci-dessus, = est l’opérateur conditionnel qui indique que
la colonne Severity doit être de type Erreur. Les opérateurs suivants sont
considérés comme étant valides :
= Egal à
> Supérieur à
< Inférieur à
>= Supérieur ou égal à
<= Inférieur ou égal à
<> Non égal à
MATCH
L’opérateur de forme de correspondance MATCH peut également être
utilisé dans la sélection conditionnelle de la clause where. Match est un
opérateur puissant qui permet de sélectionner des enregistrements de
journal ou de trace à l’aide de la syntaxe d’expression régulière. Les
chaînes de caractères spéciaux utilisées dans l’expression régulière doivent
être placées entre apostrophes. Les chaînes contenant des espaces doivent
également être placées entre apostrophes. Voici un exemple d’opérateur
Match dans une chaîne de requêtes :
“select default where logtext match hostname”
280 IBM Tivoli Service Level Advisor - Guide des commandes
Lors de l’utilisation des opérateurs relationnels avec les zones de niveau de trace et
de gravité dans un prédicat de filtre, il est important de comprendre les valeurs
affectées à chaque opérateur. Les niveaux de gravité de message peuvent avoir
pour valeur INFO, WARN ou ERROR. Ces valeurs sont traitées par ordre
alphabétique ; par exemple, lorsque l’expression Severity > INFO est spécifiée, seuls
les enregistrements de journal de niveau WARN sont renvoyés et, lorsque
l’expression Severity < WARN est indiquée, des enregistrements de journal de
niveau ERROR et INFO sont renvoyés. L’utilisation de l’expression
Severity<ERROR ne renvoie aucun enregistrement de journal. Pour optimiser les
résultats, vous pouvez choisir d’utiliser une expression booléenne pour obtenir les
niveaux de gravité. Par exemple, pour recevoir des enregistrements de journal de
niveau WARN et ERROR, indiquez (Severity = ERROR) OR (Severity = WARN).
Les niveaux de trace peuvent avoir pour valeur MIN, MID, MAX ou OTHER. A
l’instar des niveaux de gravité, ces valeurs sont traitées par ordre alphabétique.
Pour optimiser les résultats, vous pouvez choisir une expression booléenne pour
obtenir les niveaux de trace, par exemple, (TraceLevel=MIN) OR (TraceLevel=MID).
Le prédicat de filtre ne fait pas la distinction entre les majuscules et les minuscules
Utilisation d’opérateurs booléens : Les opérateurs booléens permettre de regrouper
deux expressions dans un prédicat de filtre unique. Les opérateurs OR et AND
peuvent être utilisés au format suivant :
(<expression_filtre>) { OR | AND } (< expression_filtre>)
Chaque expression doit obligatoirement être placée entre des parenthèses.
L’exemple suivant ne contient pas de prédicat de filtre syntaxiquement correct car
il contient trois expressions regroupées dans un prédicat de filtre unique :
viewer -q "select default where (server = ’myserver’) AND (element = ’trace’)
AND (messageID=’DYKAL0001E’)"
Il en résulte l’erreur suivante :
2002.04.10 14:52:19.755 com.tivoli.log.viewer.QueryTree labels Tivoli IVR 1
log viewer
myserver.mydoman.com IP IVR0019E unexpected character after query: AND
Pour éviter cette erreur, assurez-vous que chaque expression booléenne est sous
forme de (expression) AND (expression). Dans ce cas, l’exemple doit être écrit de
sorte que les deux premières expressions soient regroupées dans un seul prédicat
de filtre et que le résultat soit associé à la troisième expression (notez les
parenthèses imbriquées) :
viewer -q"select default where ((server = ’myserver’) AND (element = ’trace’))
AND (messageID = ‘DYKAL0001E’)"
Le mot clé true est une expression de filtrage complète. Il indique que le filtrage est
désactivé et que chaque enregistrement de journal et de trace doit être inclus dans
la sortie.
Définition du format de sortie
L’indicateur –s permet de modifier le format HTML par défaut de la sortie de
journal générée. Le format de sortie ASCII est similaire à celui des journaux de
messages et de trace standard d’IBM Tivoli Service Level Advisor, traceTSLA.log et
msgTSLA.log. Cependant, lorsque des fichiers journaux ASCII et HTML sont
générés via l’afficheur de journal, les enregistrements de journal existants peuvent
être remis en forme et filtrés.
Chapitre 16. Utilitaires de service non CLI 281
Définition de fichiers XML d’entrée
Chaque fichier <entrée.xml> indiqué doit correspondre à un des fichiers journaux
XML d’IBM Tivoli Service Level Advisor ou à un autre journal de produit Tivoli au
format XML commun Tivoli. Les fichiers journaux IBM Tivoli Service Level
Advisor, msgTSLAXML.log et traceTSLAXML.log se trouvent dans le répertoire
commun Tivoli et sont indiqués à l’aide du mot clé XML. Lorsque plusieurs
fichiers d’entrée sont spécifiés, les enregistrements de journal sont fusionnés en
fonction de leur horodatage. Tous les fichiers dont le chemin ou le fichier contient
un espace doivent être placés entre guillemets. Pour plus de détails, reportez-vous
aux exemples ci-dessous.
Acheminement de la sortie
La sortie ASCII ou HTML générée par l’afficheur de journal XML est enregistrée
sur la console ou dans l’invite à partir de laquelle la commande a été émise. Pour
enregistrer cette sortie et la visualiser au format HTML à l’aide d’un navigateur
Web, réacheminez la sortie vers un fichier. Vous pouvez acheminer la sortie vers
un fichier en indiquant l’option > <fichier_sortie> de la commande viewer.
Le symbole > (supérieur à) informe le système que la sortie est en cours de
réacheminement vers le nom et l’emplacement du fichier journal généré indiqué
par <fichier_sortie>. Les fichiers au format HTML doivent utiliser l’extension de
fichier .html. Les fichiers au format ASCII peuvent utiliser l’extension de fichier
préférée de l’afficheur ou du système d’exploitation utilisé.
L’emplacement du fichier journal généré est le répertoire en cours à partir duquel
la commande a été émise, à moins que le chemin complet du fichier de sortie soit
indiqué. Vous pouvez choisir de déplacer les fichiers ou d’indiquer l’emplacement
de sortie. A l’instar de la spécification du fichier d’entrée, tous les fichiers de sortie
dont le nom ou le chemin contient un espace doivent être placés entre guillemets.
Exemples
1. Enregistres la liste de zones par défaut de tous les enregistrements de messages
et de trace au format HTML, puis acheminez la sortie vers
msgTSLAHTML1.html dans le répertoire commun Tivoli :
viewer C:\TSLA\DYK\logs\SLMServer\msgTSLAXML1.log
C:\TSLA\DYK\logs\SLMServer\traceTSLAXML1.log
> C:\TSLA\DYK\logs\SLMServer\msgTSLAHTML1.html
Dans l’exemple ci-dessus, deux fichiers journaux sont indiqués en entrée,
msgTSLAXML1.log et traceTSLAXML1.log, et le symbole > est utilisé pour
indiquer que la sortie doit être réacheminée vers le fichier HTML. Le format
HTML est utilisé par défaut.
2. Affichez toutes les zones dont la gravité d’enregistrement de journal de
messages est WARN ou ERROR, ou dont le niveau d’enregistrement de journal
de trace est MIN. La sortie n’est pas réacheminée vers un fichier de sortie, mais
elle est écrite dans l’invite de commande de la console.
viewer -q "select all where ((Severity=WARN) OR (Severity=ERROR)) OR
(TraceLevel=MIN)" –s ascii
C:\TSLA\DYK\logs\SLMServer\msgTSLAXML1.log
C:\TSLA\DYK\logs\SLMServer\traceTSLAXML1.log
Dans cet exemple, la chaîne de requêtes est indiquée à l’aide du mot clé all.
Lorsque l’expression Severity=WARN OR Severity=ERROR est spécifiée, tous les
messages dont le niveau de gravité est WARN ou ERROR sont renvoyés. Il est à
noter que le format demandé est ASCII et que les deux fichiers journaux
282 IBM Tivoli Service Level Advisor - Guide des commandes
d’entrée sont indiqués mais aucun fichier de sortie n’est spécifié, ce qui
achemine le résultat vers la console ou l’invite à partir de laquelle la commande
a été émise.
3. Affichez les colonnes Component, SourceFile, SourceMethod, Message ID et
LogText, ainsi que les zones dont l’horodatage est inférieur à 1007067881373.
L’horodatage est le seul nom de colonne qui admet un argument numérique à
la place d’une chaîne. La sortie est au format ASCII, écrite dans stdout, et tous
les fichiers XML du répertoire en cours sont traités.
viewer -q "select component, sourcefile, sourcemethod, messageid, logtext where
Millis < 1007067881373" –s ascii *XML*.log
Dans cet exemple, les colonnes sont séparées par des virgules et l’horodatage
est indiqué en millisecondes. Les format de sortie est spécifié en ASCII à l’aide
de l’option –s et l’astérisque (*) sert à pour indiquer tous les fichiers journaux
d’entrée dont le nom contient les caractères XML.
Chapitre 16. Utilitaires de service non CLI 283
wasutil
Permet le mappage des utilisateurs et groupes vers les rôles du serveur
d’administration SLM dans WebSphere, ainsi que la recherche des informations
relatives aux rôles.
Syntaxe
wasutil[help | list | –username <nom_utilisateur> –password <mot_de_passe>]
[–port <port>] {–listapps | –listroles –app <nom_app> | –maprole –app
<nom_app>–role <nom_rôle> {–users <utilisateur1>[, <utilisateur2>, ...] | –groups
<groupe1>[, <groupe2>, ...]}}
Description
L’utilitaire wasutil permet le mappage des utilisateurs et des groupes aux rôles qui
sont reconnus par le serveur d’administration SLM et la console Rapports SLM.
Vous pouvez également faire appel à cet utilitaire pour afficher des informations
relatives aux utilisateurs et groupes, ainsi qu’aux rôles qui leur sont associés.
Vous pouvez répertorier les applications qui sont installées dans l’environnement
WebSphere et afficher les utilisateurs et rôles existants qui ont été mappés vers une
application particulière. Vous pouvez ensuite utiliser ces informations pour mapper
des utilisateurs et groupes nouveaux ou supplémentaires aux rôles de cette
application.
Options
help Affiche des informations d’aide relatives à l’utilitaire wasutil.
list Affiche la syntaxe et les options valides de l’utilitaire wasutil.
–username <nom_utilisateur>
Indique le nom d’utilisateur à utiliser lors de la connexion à
WebSphere Application Server. Ce paramètre est requis
uniquement lorsque la sécurité WebSphere a été activée.
Remarque : Si le nom d’utilisateur est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
–password <mot_de_passe>
Indique le mot de passe à utiliser lors de la connexion à
WebSphere Application Server. Ce paramètre est requis
uniquement lorsque la sécurité WebSphere a été activée.
Remarque : Si le mot de passe est indiqué sur la ligne de
commande, il peut être visualisé par d’autres
utilisateurs à l’aide des commandes de requête de
processus système. Vous êtes invité à entrer cette
valeur si la sécurité WebSphere est activée et que la
valeur n’est pas indiquée sur la ligne de commande.
–port <port> Indique le port SOAP à utiliser lors de la connexion à WebSphere
Application Server. Ce paramètre est requis uniquement lorsque le
284 IBM Tivoli Service Level Advisor - Guide des commandes
numéro de port ne correspond pas à 8880. Pour plus
d’informations sur le port SOAP, consultez la documentation
WebSphere.
–listapps Affiche la liste de toutes les applications qui ont été installées dans
WebSphere. Pour IBM Tivoli Service Level Advisor, les applications
qui vous intéressent sont SLMAdmin (pour l’option d’installation
Serveur d’administration SLM) et SLMReport (pour l’option
d’installation Rapports SLM).
–listroles Affiche tous les rôles connus et les données de mappage
correspondant à une application spécifique installée dans
WebSphere.
–app <nom_application>
Indique le nom de l’application installée dans WebSphere, sur
laquelle vous demandez des informations ou pour laquelle vous
mappez des utilisateurs, groupes et rôles, par exemple, SLMAdmin
ou SLMReport.
–maprole Associe le rôle indiqué à la liste d’utilisateurs ou de groupes
correspondant à une application spécifique de WebSphere. Cette
application doit être redémarrée sur WebSphere Application Server
pour que les mappages de rôles puissent être appliqués.
–role <nom_rôle>
Indique le rôle vers lequel mapper des utilisateurs ou groupes. Les
rôles concernant l’application SLMAdmin sont les suivants :
v Spécialiste en offres
v Spécialiste en contrats SLA
v Administrateur SLM
v Adjudicateur SLA
Remarque : Dans la mesure où chacun de ces noms de rôles
comprend un espace, ils doivent être placés entre
guillemets lorsqu’ils sont spécifiés pour le mappage
(par exemple, ″Adjudicateur SLA″)
Les rôles concernant l’application SLMReport sont les suivants :
v SLMReportUser
–users <utilisateur1>[,<utilisateur2>, ...]
Indique un ou plusieurs noms d’utilisateur, séparés par des
virgules, qui doivent être mappés vers le rôle indiqué de
l’application en question.
Remarque : Si vous indiquez un ou plusieurs noms, n’insérez pas
de blanc à la suite de chaque virgule. Si un nom
contient un espace, celui-ci doit être placé entre
guillemets. Par exemple,
Utilisateur1,Utilisateur2,″Utilisateur 3″,Utilisateur4
–groups <groupe1>[,<groupe2>, ...]
Indique un ou plusieurs noms de groupe, séparés par des virgules,
qui doivent être mappés vers le rôle indiqué de l’application en
question.
Remarque : Si vous indiquez un ou plusieurs noms, n’insérez pas
de blanc à la suite de chaque virgule. Si un nom
Chapitre 16. Utilitaires de service non CLI 285
contient un espace, celui-ci doit être placé entre
guillemets. Par exemple, Groupe1,Groupe2,″Groupe
3″,Groupe4
Classe d’autorisation
Cette commande ne nécessite aucune autorisation.
Exemples
1. Affichez toutes les applications qui ont été installées dans WebSphere.
wasutil -listapps
Le résultat est similaire à l’exemple suivant :
PlantsByWebSphere
MDBSamples
adminconsole
SLMAdmin
ivtApp
SLMReport
SamplesGallery
DefaultApplication
TechnologySamples
petstore
Il est à noter que SLMAdmin et SLMReport figurent dans cette liste.
2. Affichez toutes les applications qui ont été installées dans WebSphere. Le port
SOAP utilisé pour la connexion à WebSphere Application Server est 8094.
wasutil -port 8094 -listapps
Dans la mesure où vous n’utilisez pas le numéro de port SOAP par défaut de
8088, vous devez indiquer le numéro de port dans cette commande.
3. Affichez les informations de rôle relatives à l’application SLMAdmin.
wasutil -listroles -app SLMAdmin
Le résultat est similaire à l’exemple suivant :
Application : SLMAdmin
Rôle : Spécialiste en offres
Tous les utilisateurs : false
Tous les utilisateurs authentifiés : false
Utilisateurs : jsmith,billj,user121
Groupes :
Rôle : Administrateur SLM
Tous les utilisateurs : false
Tous les utilisateurs authentifiés : false
Utilisateurs : RJones
Groupes : SLMAdmins
Rôle : Adjudicateur SLA
Tous les utilisateurs : false
Tous les utilisateurs authentifiés : false
Utilisateurs :
Groupes et adjudicateurs
Rôle : Spécialiste en contrats SLA
Tous les utilisateurs : false
Tous les utilisateurs authentifiés : false
Utilisateurs : RogerL,JBaker
Groupes : SLASpecGroup1,SLATeam2
286 IBM Tivoli Service Level Advisor - Guide des commandes
4. Affichez des informations de rôle relatives à l’application SLMReport lorsque la
sécurité WebSphere est activée.
wasutil -name admin001 -password xyz123 -listroles -app SLMReport
Dans cet exemple, vous devez indiquer un nom d’utilisateur et un mot de
passe valides lorsque la sécurité WebSphere a été activée.
5. Mappez le nom d’utilisateur JSummers vers le rôle Administrateur SLM pour
l’application SLMAdmin.
wasutil -maprole -app SLMAdmin -role "Administrateur SLM" -users JSummers
Remarque : Dans la mesure où le nom de rôle indiqué contient un espace,
celui-ci doit être placé entre guillemets. Si le mappage aboutit, le message
suivant est émis :
DYKAL9227I Le mappage de rôles a abouti.
6. Mappez les noms de groupes Grp 3 et ReportUsers au rôle SLMReportUser de
l’application SLMReport.
wasutil -maprole -app SLMReport -role SLMReportUser -groups "Grp 3",ReportUsers
Remarque : Dans la mesure où un des noms de groupes indiqués contient des
espaces, celui-ci doit être placé entre guillemets. Si le mappage aboutit, le
message suivant est émis :
DYKAL9227I Le mappage de rôles a abouti.
7. Affichez des informations d’aide relatives à l’utilitaire wasutil.
wasutil help
8. Affichez des informations de syntaxe relatives à l’utilitaire wasutil.
wasutil list
Chapitre 16. Utilitaires de service non CLI 287
288 IBM Tivoli Service Level Advisor - Guide des commandes
Annexe. 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. Cependant, il est de la responsabilité de
l’utilisateur d’évaluer et de vérifier lui-même le fonctionnement des produits,
programmes et services d’autres marques.
IBM peut détenir des brevets ou des demandes de brevet 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
La Défense 5
2, avenue Gambetta
92066 - Paris-La Défense CEDEX
France
Pour le Canada, veuillez adresser votre courrier à :
IBM Director of Commercial Relations
IBM Canada Ltd.
3600 Steeles Avenue East
Markham, Ontario
L3R 9Z7
Canada
Le paragraphe suivant ne s’applique ni au Royaume-Uni, ni dans aucun 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, auquel
cas l’exclusion ci-dessus ne vous sera pas applicable.
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
modifier sans préavis les produits et 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é.
© Copyright IBM Corp. 2002, 2004 289
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/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
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 données de performance indiquées dans ce document ont été déterminées dans
un environnement contrôlé. Par conséquent, les résultats peuvent varier de manière
significative selon l’environnement d’exploitation utilisé. Certaines mesures
évaluées sur des systèmes en cours de développement ne sont pas garanties sur
tous les systèmes disponibles. En outre, elles peuvent résulter d’extrapolations. Les
résultats peuvent donc varier. Il incombe aux utilisateurs de ce document de
vérifier si ces données sont applicables à leur environnement d’exploitation.
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.
Toute instruction relative aux intentions d’IBM pour ses opérations à venir est
susceptible d’être modifiée ou annulée sans préavis, et doit être considérée
uniquement comme un objectif.
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.
LICENCE DE COPYRIGHT :
Le présent logiciel contient des exemples de programmes d’application en langage
source destinés à illustrer les techniques de programmation sur différentes
plateformes d’exploitation. Vous avez le droit de copier, de modifier et de
distribuer ces exemples de programmes sous quelque forme que ce soit et sans
paiement d’aucune redevance à IBM, à des fins de développement, d’utilisation, de
vente ou de distribution de programmes d’application conformes aux interfaces de
290 IBM Tivoli Service Level Advisor - Guide des commandes
programmation des plateformes pour lesquels ils ont été écrits ou aux interfaces de
programmation IBM. Ces exemples de programmes n’ont pas été rigoureusement
testés dans toutes les conditions. Par conséquent, IBM ne peut garantir
expressément ou implicitement la fiabilité, la maintenabilité ou le fonctionnement
de ces programmes.
Marques
IBM, le logo IBM, Lotus, Rational, Tivoli, le logo Tivoli, WebSphere, DB2, DB2
Universal Database, eServer, iSeries, NetView, Passport Advantage, pSeries,
Redbooks, Tivoli Enterprise et Tivoli Enterprise Console sont des marques
d’International Business Machines Corporation aux Etats-Unis et/ou dans certains
autres pays.
Microsoft, Windows et le logo Windows 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.
Java ainsi que tous les logos et toutes les marques incluant Java sont
des marques de Sun Microsystems, Inc. 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.
Annexe. Remarques 291
292 IBM Tivoli Service Level Advisor - Guide des commandes
Index
Aactivation de l’application 22
activation de la protection par mot de
passe CLI 18
activation de la transmission
d’événements 49
activation du transfert de données 26
addApplicationData 22
addSingleSchedulePeriod 80
addUser 148
adjustIDGenerator 173
affichage d’objets SLM 236
affichage des IDcommandes de service 109
aideetl 36
rcc 143
aide, transmission 52
analyse des tendances 121
annulation et objets SLA 232
application, ajout à l’environnement
SLM 22
authentificationliste des utilisateurs 163
authentification d’utilisateurmodification de la page d’accueil 154
modification de la vue 154
modification du client 154
modification du domaine 154
Bbase de données SLM
activation du transfert de données
vers 26
désactivation du transfert de données
vers 24
expiration de données 29
obtention de la version 35
redéploiement des commandes sur
MEM 138
soumission de la commande à
OM 140
Ccalendrier
affichage 182
ajout d’une période pour une date
unique 80
contenu, affichage 201
d’activité, affichage 189
exportation 238
nom, affichage 198
repère, affichage 195
suppression d’une période pour une
date unique 102
calendrier, affichage 236
calendrier, création 233, 235
cancel 232
changeUser 154
checkCache 42
CLImot de passe, définition 16
clientaffichage des informations relatives à
la commande associée 193
commande, affichage
d’informations 209
exportation 238
informations, affichage 180, 191, 192
client, affichage 236
client, création 174, 233, 235
cliutil 254
commandeaffichage d’informations 186, 209
affichage de l’état 211
affichage des informations client
associées 193
client de base, affichage 187
ID, associé à l’ID commande
d’annulation ou de
modification 212
commande clientredéploiement 138
soumission 140
commande de serviceaffichage des ID 109
commandesaffichage 109
redéploiement 138
commandes CLIgénérales 11
méthodes list et help 6
commandes de journalisation, liste 71
commandes de service non CLI 5
communication à distanceaffichage, définition du nom
d’hôte 263
affichage, définition du port 263
port, définition 145
composantarrêt 230
démarrage 228
état, affichage 220
composantsgérés par le serveur SLM, liste 226
compteutilisateur, modification de
l’authentification 154
compte utilisateurmodification 154
compte utilisateur, création 148
connections 244
connexionsaffichage du nombre de connexions
contrôlées par le programme de
collecte de données 244
connexions à la base de donnéesaffichage du nombre 244
contrat SLAshowHourlyFrequencyIntervals 110
contrat SLA, affichage 236
contrat SLA, annulation 232
contrat SLA, création 233, 235
contrat SLA, exportation 238
create 233, 235
createCustomer 174
createOfferinginXMLoffline 124
createRealm 176
création d’objets SLM 233, 235
Ddéfinition d’un nouveau mot de passe
CLI 7
deleteUser 158
désactivation de la protection par mot de
passe CLI 18
désactivation de la transmission
d’événements 48
désactivation du transfert de données 24
detectMissingAvailabilityData 83
diagutil 255
displayActiveServiceElements 178
displayAll 236
displayAllCustomerOrders 186
displayAllCustomers 180
displayAllRealms 181
displayAllSchedules 182
displayAllServiceOfferings 184
displayBaseCustomerOrders 187
displayBusinessSchedules 189
displayCustomer 191
displayCustomerByID 192
displayCustomerFromOrderID 193
displayCustomerOrderByID 209
displayCustomerOrderState 211
displayDataCollectorType 194
displayMilestoneSchedules 195
displayObsoleteServiceElements 196
displayOfferingElementList 197
displayOfferingScheduleName 198
displayOfferingState 199
displayOrderMetricPropertyID 210
displayRealm 200
displayScheduleByName 201
displayServiceOfferingByID 203
displayServiceOfferingID 205
displayServiceOfferingName 206
displayServiceOfferingsByState 207
displayTimezones 159, 237
disponibilitédétection des données
manquantes 83
domaineinformations, affichage 181, 200
domaine, affichage 236
domaine, création 176, 233, 235
domaine, exportation 238
© Copyright IBM Corp. 2002, 2004 293
donnéesactivation du transfert 26
désactivation du transfert 24
détection des données de disponibilité
manquantes 83
données, enregistrement dans
l’entrepôt 217
données anciennes, purge 216
données de diagnostic, enregistrement
dans un fichier zip 255
données de diagnostic, exportation 255
données manquantesdisponibilité, détection 83
dsutil 257
dumpData 89
dyk_catobtention de la version 35
dyk_dmobtention de la version 31
Eélément de service
actif, affichage 178
éléments de service obsolètes,
affichage 196
emailnotification, mise à jour de la
configuration 60
entréerelance arrêtée, suppression 104
entrées à l’état de relance arrêtée,
suppression 104
entrepôt de données centralactivation du transfert de données à
partir de 26
désactivation du transfert de données
à partir de 24
environnement de commandesinitialisation 268
escalatecheckCache 42
customize 44
disable 48
help 52
list 53, 54, 56
snmp FormatDateTime 57
test 58, 59
update email 60
vue 62
étataffichage pour un composant 220
serveur SLM, affichage 222
état de relancerelance des tendances et
évaluations 107
état de relance active 104, 107
affichage 117
état de relance arrêtée 104, 107
affichage 117
etlactivation 26
addApplicationData 22
aide 36
désactivation 24
getApps 28
getDataExpiration 29
etl (suite)getDMVersion 31
getIDInfo 32
getMMVersion 35
list 37
évaluateur de mesuresrechargement des commandes 138
évaluateurs de mesuresinstances, affichage
d’informations 113
évaluationdéfinition de la fréquence
horaire 110
intermédiairerésultats de la purge 215
relance de tous les intervalles non
traités 107
résultats de la purge 216
évaluation, définition du nombre
maximal d’unités d’exécution 169
évaluations, exécution de
réévaluations 96
évaluations horaires, définition 110
événementenvoi d’un exemple 58, 59
mise en forme de la valeur
d’horodatage des alarmes
SNMP 57
événementsconservés, transfert 93
mis en mémoire cache 42
événements d’incident d’applicationactivation de la transmission 49
désactivation de la transmission 48
événements mis en mémoire cache,
vérification 42
expirationdonnées de la base de données
SLM 29
expiration de données, extraction du
nombre de jours 29
export 238
exportation d’objets SLM 238
Ffichier de propriétés, exportation 238
fichiers journaux, traitement au format
XML 278
filtre d’applicationactivée/désactivée 28
liste des applications 28
flushEvents 93
format XML, fichiers journaux 278
fuseau horaireaffichage 159
fuseau horaire, affichage 237
Ggénérateur d’ID, ajustement 173
gestionnaire de l’évaluateur de mesurestransfert d’événements 93
vidage de données 89
getApps 28
getAssociatedCustomerOrderID 212
getComponentStatus 220
getDataExpiration 29
getDMVersion 31
getIDInfo 32
getMMVersion 35
getport 142
getStatus 222
groupes, mappage des utilisateurs vers
des rôles 284
Hhelp
commandes CLI 6
log 70
offline 126
regroupement de commandes
om 136
scheduler 166
slm 224
som 240
help mem 94
help scmd, généralités 12
help sla 161
help wdccli 245
heuresnombre maximal pour la planification
des opérations à effectuer, liste 168
IIBM Tivoli Service Level Advisor
arrêt d’un composant 230
démarrage d’un composant 228
procédure de restauration 269
procédure de sauvegarde 265
redémarrage après restauration 273
IDinformations, obtention 32
informations de version, affichage 276
informations de version, vérification de la
compatibilité avec une édition ou un
correctif 276
informations relatives à l’authentification,
modification 154
informations utilisateur, liste 163
initialisation de l’environnement de
commandes 268
instancesévaluateurs de mesures,
affichage 113
interface de ligne de commandeutilisation 5
intervalle d’interrogation, définition pour
la notification ETL 250
intervalle d’interrogation, notification
ETL, définition 250
intervalles de tendance, affichage et
définition 121
intervalles non traités, relance 107
Llist
commandes CLI 6
offline 127
294 IBM Tivoli Service Level Advisor - Guide des commandes
list, escalate 53, 54, 56
list etl 37
list mem 95
list om 137
list rcc 144, 167
list scmd, généralités 14
list sla 162
list slm 225
list som 241
list wdccli 246
listComponents 226
listSettings 168, 247
listUser 163
logexemple scmd 2
filter 64
handler 67
help 70
list 71
message 72
trace 75
logutil 260
Mmagasin de données SLM Measurement
entrées à l’état de relance arrêtéesuppression 104
états de relance, affichage 117
intervalles non traités, relance 107
obtention de la version 31
memaddSingleSchedulePeriod 80
aide 94
analyse des tendances 121
detectMissingAvailabilityData 83
dumpData 89
flushEvents 93
list 95
reEval 96
removeSingleSchedulePeriod 102
removeStoppedRetryEntries 104
retryMissedIntervals 107
showAllOrderIDs 109
showMetricEvaluators 113
showRetrys 117
skipHistoricSLAs 120
messages de journaldébut/fin du programme de collecte
de donnéesactivation/désactivation 251
messages électroniques,
personnalisation 44
mesureID propriété, affichage 210
méthodesyntaxe de la commande scmd 1
migrateSLAsoffline 128
migration, utilisateursuserdump 275
mot de passeactivation de la protection pour les
commandes CLI 18
oublié, CLI 7
service CLI, réinitialisation 254
mot de passe CLIactivation et désactivation 18
mot de passe CLI, définition 7
mot de passe de service CLI,
définition 16
Nnom du regroupement
syntaxe de la commande scmd 1
notificationcourrier électronique,
personnalisation 44
notification par alarme SNMPtest 58, 59
notification par alarme SNMP,
activation 49
notification par alarme SNMP,
désactivation 48
notification par courrier électroniquetest 58, 59
notification par courrier électronique,
activation 49
notification par courrier électronique,
désactivation 48
notification par événement Tivoli
Enterprise Consoletest 58, 59
notification par événement Tivoli
Enterprise Console, activation 49
notification par événement Tivoli
Enterprise Console, désactivation 48
numéro de portservice CLI
définition 254
extraction 254
Oobjet de journalisation
filtre, propriétés 64
objet de journalisation de filtreaffichage des propriétés 64
modification des propriétés 64
objet SLMexportation 238
objets de journalisationaffichage des propriétés 260
modification des propriétés 260
offlinecreateOfferinginXML 124
help 126
list 127
migrateSLAs 128
updateNames 130
updateOffering 132
offreaffichage 184
contenu, affichage 203
éléments, affichage 197
état, affichage 199
état particulier, affichage 207
exportation 238
ID, affichage 205
nom, affichage 206
offre, affichage 236
offres, création 233, 235
omhelp 136
list 137
submitCustomerOrder 140
opération de base de donnéesdélai entre les tentatives,
définition 249
nombre de tentatives, définition 248
optionssyntaxe de la commande scmd 1
Pparamètres
programme de collecte de
données 247
paramètres du planificateur, liste des
états en cours 168
périodeajout pour une date unique 80
suppression pour une date
unique 102
personnalisation de la notification par
courrier électronique 44
planificateurlistSettings 168
planificationdemandes forcées, définition du délai
maximal 170
portcommunication à distance,
définition 145
communications à distance, liste 142
port de communication à distanceliste 142
procédure de restauration 269
procédure de sauvegarde 265
processus de restaurationredémarrage après restauration 273
programme de collecte de donnéesmessages de début/arrêt,
activation 251
messages de début/arrêt,
désactivation 251
nombre de connexions 244
nouvelle tentative, définition du délai
entre les tentatives 249
nouvelle tentative, définition du
nombre de tentatives 248
paramètres, liste 247
programme de journalisation de
messagespropriétés, affichage 72
propriétés, modification 72
programme de journalisation de tracepropriétés, affichage 75
propriétés, modification 75
programme de journalisation du
gestionnairepropriétés, affichage 67
propriétés, modification 67
protection par mot de passe 1, 7
purgeIntermediateResults 215
purgeOldData 216
Index 295
Rrapport
displayTimezones 159
Rapports SLMdonnées partielles ou
manquantes 107
rccgetport 142
help 143
list 144, 167
setport 145
rcomutil 263
reDeployCompletedCustomerOrders 138
reEval 96
registerWarehouseData 217
relance des intervalles non traités 107
removeSingleSchedulePeriod 102
removeStoppedRetryEntries 104
résultats intermédiaires, purge 215
retryMissedIntervals 107
rôle, mappage d’utilisateurs et de
groupes 284
Sscheduler
help 166
setMaxEvaluationThreads 169
setMaxTimeForForcedScheduling 170
scmdaide 12
aide sur la syntaxe 12
escalatecheckCache 42
customize 44
disable 48
help 52
list 53, 54, 56
snmp FormatDateTime 57
test 58, 59
update email 60
view 62
etlactivation 26
addApplicationData 22
aide 36
désactivation 24
getApps 28
getDataExpiration 29
getDMVersion 31
getIDInfo 32
getMMVersion 35
list 37
list 14
logfilter 64
handler 67
help 70
list 71
message 72
trace 75
memaddSingleSchedulePeriod 80
aide 94
analyse des tendances 121
detectMissingAvailabilityData 83
scmd (suite)mem (suite)
dumpData 89
flushEvents 93
list 95
reEval 96
removeSingleSchedulePeriod 102
removeStoppedRetryEntries 104
retryMissedIntervals 107
showAllOrderIDs 109
showHourlyFrequencyIntervals 110
showMetricEvaluators 113
showRetrys 117
skipHistoricSLAs 120
méthode 1
nom du regroupement 1
noms de regroupements 7
offlinecreateOfferinginXML 124
help 126
list 127
migrateSLAs 128
updateNames 130
updateOffering 132
omhelp 136
list 137
submitCustomerOrder 140
options 1
planificateurlistSettings 168
protection par mot de passe 1
rapportdisplayTimezones 159
rccgetport 142
help 143
list 144, 167
setport 145
schedulerhelp 166
setMaxEvaluationThreads 169
sdcadjustIDGenerator 173
createCustomer 174
createRealm 176
displayActiveServiceElements 178
displayAllCustomerOrders 186
displayAllCustomers 180
displayAllRealms 181
displayAllSchedules 182
displayAllServiceOfferings 184
displayBaseCustomerOrders 187
displayBusinessSchedules 189
displayCustomer 191
displayCustomerByID 192
displayCustomerFromOrderID 193
displayCustomerOrderByID 209
displayCustomerOrderState 211
displayDataCollectorType 194
displayMilestoneSchedules 195
displayObsoleteServiceElements 196
displayOfferingElementList 197
displayOfferingScheduleName 198
displayOfferingState 199
displayOrderMetricPropertyID 210
displayRealm 200
scmd (suite)sdc (suite)
displayScheduleByName 201
displayServiceOfferingByID 203
displayServiceOfferingID 205
displayServiceOfferingName 206
displayServiceOfferingsByState 207
getAssociatedCustomerOrderID 212
help 213
list 214
purgeIntermediateResults 215
purgeOldData 216
registerWarehouseData 217
setPassword 16
setPasswordEnabled 18
slaaddUser 148
aide 161
changeUser 154
deleteUser 158
list 162
listUser 163
slmarrêt 227
getComponentStatus 220
getStatus 222
help 224
list 225
listComponents 226
startComponent 228
stopComponent 230
somcancel 232
create 233, 235
displayAll 236
displayTimezones 237
export 238
help 240
list 241
syntaxe 1
transmissionactivation 49
wdccliaide 245
connexions 244
list 246
listSettings 247
setConRetries 248
setConWait 249
setETLPoll 250
setLogStartEnd 251
sdcadjustIDGenerator 173
createCustomer 174
createRealm 176
displayActiveServiceElements 178
displayAllCustomerOrders 186
displayAllCustomers 180
displayAllRealms 181
displayAllSchedules 182
displayAllServiceOfferings 184
displayBaseCustomerOrders 187
displayBusinessSchedules 189
displayCustomer 191
displayCustomerByID 192
displayCustomerFromOrderID 193
displayCustomerOrderByID 209
296 IBM Tivoli Service Level Advisor - Guide des commandes
sdc (suite)displayCustomerOrderState 211
displayDataCollectorType 194
displayMilestoneSchedules 195
displayObsoleteServiceElements 196
displayOfferingElementList 197
displayOfferingScheduleName 198
displayOfferingState 199
displayOrderMetricPropertyID 210
displayRealm 200
displayScheduleByName 201
displayServiceOfferingByID 203
displayServiceOfferingID 205
displayServiceOfferingName 206
displayServiceOfferingsByState 207
getAssociatedCustomerOrderID 212
help 213
list 214
purgeIntermediateResults 215
purgeOldData 216
registerWarehouseData 217
serveur SLMaffichage de l’état 222
arrêt 227
communication à distanceaffichage, définition du nom
d’hôte 263
affichage, définition du port 263
enregistrement des données
d’entrepôt 217
liste des composants gérés par 226
service CLIcommandes 7
connexions 4
informations complémentaires 4
mot de passe, définition 254
numéro de port, définition 254
numéro de port, extraction 254
utilisation 6
setConRetries 248
setConWait 249
setETLPoll 250
setLogStartEnd 251
setMaxEvaluationThreads 169
setMaxTimeForForcedScheduling 170
setPassword 6, 11, 16
setPasswordEnabled 6, 11, 18
setport 145
showAllOrderIDs 109
showHourlyFrequencyIntervals 110
showMetricEvaluators 113
showRetrys 117
shutdownserveur SLM 227
skipHistoricSLAs 120
slaaddUser 148
changeUser 154
deleteUser 158
help 161
list 162
listUser 163
slmgetComponentStatus 220
getStatus 222
help 224
list 225
slm (suite)listComponents 226
shutdown 227
startComponent 228
stopComponent 230
slmbackup 265
slmenv 268
slmrestore 5, 269
slmrestorerestart 273
snmp FormatDateTime, escalate 57
somcancel 232
create 233, 235
displayAll 236
displayTimezones 237
export 238
help 240
list 241
source de donnéesmodification des informations 257
startComponent 228
stopComponent 230
submitCustomerOrder 140
suppression d’utilisateur 158
suppression des entrées à l’état de relance
arrêtée 104
Ttendance
relance de tous les intervalles non
traités 107
test, escalate 58, 59
transmissionactivation 49
événements d’incident d’application,
activation 49
événements d’incident d’application,
désactivation 48
méthodes activées/désactivées,
affichage 62
mise en forme de la valeur
d’horodatage des alarmes
SNMP 57
paramètres, affichage 62
test de la méthode activée 58, 59
transmission d’événements,
activation 49
transmission d’événements,
désactivation 48
type de collecteur, affichage 194
Uunités d’exécution
nombre maximal pour l’évaluation
des mesures, liste 168
unités d’exécution, définition du nombre
maximal à évaluer 169
update email, escalate 60
updateNamesoffline 130
updateOfferingoffline 132
userdump 275
utilisateurmigration, exportation des
détails 275
suppression de la base de
données 158
utilisateur, comptecréation 148
utilisateurs, mappage vers des rôles 284
utilitairesafficheur 278
cliutil 254
diagutil 255
dsutil 257
logutil 260
rcomutil 263
service non CLI 5
slmbackup 265
slmenv 268
slmrestore 269
slmrestorerestart 273
userdump 275
verutil 276
wasutil 284
Vvérification des événements mis en
mémoire cache 42
versionbase de données SLM, obtention 35
magasin de données SLM
Measurement, obtention 31
verutil 276
view escalate 62
viewer 278
violationmessage électronique, tendance
message électronique, tendance
annulée 44
Wwasutil 284
wdccliaide 245
connections 244
list 246
listSettings 247
setConRetries 248
setConWait 249
setETLPoll 250
setLogStartEnd 251
Index 297
298 IBM Tivoli Service Level Advisor - Guide des commandes
���
SC11-2196-00