Syntaxe des commandes
LasyntaxedescommandesDB2Alphabloxestlasuivante:
COMMANDE objet [valeur(s)] COMMANDE objet [valeur(s)] objet [valeur(s)]
où :
v l’objetest :
– SERVER(par défaut)
– CONSOLEIDconsole(oùIDconsoleest l’IDd’uneconsoleactiveparticulière, par exempleC1)
– lenomd’unobjetdeserveur.VouspouvezutiliserlescaractèresA-Z,a-z,0-9, letraitde soulignementetdescaractèresspéciaux(parexemple,des
caractères accentués).L’affichagedunomestdépendant des majuscules/minuscules tandisquelenomréelauthentifién’estpas
dépendant desmajuscules/minuscules. Lesnoms Public,PrivateetProperties étantréservés, ilsnepeuventpasêtreutilisésentantquenomd’objet.
v lavaleur quisuitqualifiel’objet
Par exemple,danslalignesuivante,getest lacommande, userestlenomd’un objetde serveuretadminestlenomd’unobjetutilisateurparticulier.
get user admin
Lorsque vousentrezunecommandesuivied’unobjet,unmessageindique laou lesvaleursrequisespour cettecommande. Parexemple,sivousentrezla
commandesuivante : create data source
Le messagesuivants’affiche:
La création de la source de données requiert d’autres paramètres :
nom_source_données nom_adaptateur SERVER nom_serveur [valeur de propriété]...
Lesnoms depropriétécorrespondentauxnomsdespagesde l’interfaceutilisateur.
Par exemple,sivouscréezunesourcede donnéesDB2OLAPServerouHyperion Essbase,lesnoms despropriétéssontapplication,database,username,password, maxrows,maxcolsetuseaasuserauth.
Abréviation des commandes
Pour saisirlescommandesplusrapidementsurlaconsole,vouspouvez utiliser desabréviations.Par exemple,l’abréviationH correspondà lacommandeHELP.Si plusieurscommandescommencentparlamêmelettre,entrezdavantage de
caractères afinquel’abréviationsoitunique. Parexemple,lescommandesSTART etSTATISTICS commencentpar STA.Enajoutantlalettresuivante,l’abréviation devientunique(STARpourSTARTetSTATpour STATISTICS).
Conseil: Conseilssurl’utilisation descommandes:
v Laconsoleprendenchargelesabréviationspourl’ensembledelasyntaxede la lignedecommande.Par exemple,H Cpermet d’obtenirde l’aidesur la
commandeCREATE. GULpermet d’obtenirlespropriétésrelativesà l’utilisateurdontlenomcommencepar L.
v Iln’estpasnécessairedemettreleschaînes entreguillemets,sauflenomde l’adaptateurdebasededonnées (parexemple,“ibmdb2olapserver”).
v Lorsquevousutilisezdesabréviationspourlespropriétésgénérales,utilisezles premièrelettresdu nomdelapropriétéetnondesadescription.Par exemple,
pourlapropriété DefaultMessageLeveldontladescriptionest Niveauinitial du message de la console, utilisez l’abréviation DEFAULTM.
Liste des commandes de la console
Vouspouvezsaisirlaplupartdescommandessur l’écrandelaConsole(accessible par lelienLaunchDB2Alphablox ConsoledelapageGeneralde l’onglet
Administration)oubiensurl’écrande commandesdeDB2Alphablox.Cependant, quelquescommandessontprises enchargeuniquementsurl’un oul’autre.De plus, touteslescommandesnesontpasprisesenchargeviaTelnet.Pourobtenir la liste descommandesde laconsoledeDB2AlphabloxCubeServer,voirDB2 AlphabloxCubeServer-Guided’administration.Pourobtenir laliste descommandes enenvironnementgroupé (cluster),voir«Commandesdelaconsoledecluster»,à lapage138.Pour obtenirlalistedescommandesspécifiquesà ExtensibleUser Manager,voir«Commandede consoleTelnetpourExtensibleUser Manager»,àla page102.
Remarque: Lescommandessuivantesdelaconsoles’appliquentuniquementà DB2Alphablox.Par exemple,sivoussupprimezuneapplication de DB2Alphabloxsur unserveurWebSphere, elleestsupprimée uniquementdeDB2Alphablox.Poursupprimerl’applicationdu serveurWebSphere,vousdevez lefairesurlaconsoled’administration deWebSphereApplicationServer.
Commandeetexemple Fonctionetexplications ADDobjetvaleurobjetvaleur
addgroupadminuserradams
Ajoutelesecondobjetaupremier
Ajoutel’utilisateurnomméradamsaugroupenommé admin
CREATEobjetvaleur createuserradamshaggis createdatasourceTBCibmdb2 olapserveradapterserver db2erver1applicationdemo databasebasicusernameuser1 passwordpassword1maxrows1000 maxcols1000useaasuserauthfalse
Créeunobjetdetypeutilisateurougroupe.
Créeunnouvelutilisateurdontlenomestradamset lemotdepasseesthaggis
CréeunesourcededonnéesappeléeTBCquiaccède àl’applicationTBC(démo/standard)surleserveur IBMDB2OLAPServerappelédb2server1.
DELETEobjetvaleur deleteuserradams deleteoutlinecache...
SupprimeunobjetdeDB2Alphabloxetdu référentielDB2Alphablox.Lasuppressiond’une applicationdeDB2Alphabloxnesupprimepas l’applicationcorrespondanteduserveurWebSphere.
Supprimel’utilisateurappeléradamsdeDB2 Alphablox.
SupprimeuneentréedelamémoirecachedeDB2 OLAPServerouEssbase.
EXIT ArrêteDB2Alphabloxlaconsoleetfermel’écrande
celle-ci.Celan’estpossiblequedepuisl’écrande commandesdeDB2Alphablox,etnondepuisl’écran delaconsoleaffichévialapaged’accueildeDB2 Alphablox.
ExtUserManager Pourobtenirlalistedescommandesdelaconsole ExtensibleUserManager,voir«Commandede consoleTelnetpourExtensibleUserManager»,àla page102.
Commandeetexemple Fonctionetexplications GETobjetvaleur
get
getuserradams
Affichedesinformationssurunobjet
Affichedesinformationssurl’objetServer(caril s’agitdel’objetpardéfaut)
Affichelespropriétésdel’utilisateurnomméradams HELPobjet
Aide helpcreate
Affichelesinformationsd’aiderelativesàla commandeindiquée
Affichelalistecomplètedescommandes
Afficheladescriptionetlasyntaxedelacommande create
KILLobjet
kill1046976892932726235
Arrêtel’instanceencoursdel’objetindiqué(en généralunesessionutilisateur)
Arrêtelasessiondontl’IDest1046976892932726235.
LOADobjetvaleur
loaduser<NomUtilisateur>
loadtheme loadlicense
Chargeunobjetdansl’espacedetravailduserveur Chargel’utilisateur<NomUtilisateur>dansl’espace detravailduserveur
Chargetouslesthèmesdisponiblesdansl’espacede travailduserveur.(Notezquelacommandeneprend pasenchargelechargementd’unthèmeseul).
Charge(metàjour)lefichierdelicence(license.xml ),placédanslerépertoireDB2Alphabloxbin. LOCK Verrouillel’accèslocalauserveur.PouraccéderàDB2
Alphabloxaprèslasaisiedecettecommande,entrez votrenomd’utilisateuretvotremotdepasse.Cela n’estpossiblequedepuisl’écrandelaconsoleDB2 AlphabloxetTelnet.
MESSAGEobjetvaleur(s) messagereview20 messagereviewdebug20 messageC2Testing
Envoieunmessagesystèmeàd’autresconsolesou fichiersjournaux
Envoieles20derniersmessagesàlaconsoleencours Envoieles20derniersmessagesDEBUGàlaconsole encours
Envoielemessage“Testing”àlaconsoleC2 OBJECTSobjet
objects objectsuser
Affichedesinformationssurlesobjetsadministrables Affichelahiérarchiedesobjetsadministrables Affichedesinformationssurlesutilisateurs RELEASE Libèrelaconsoledeserveurdistantesurlaquellea
étélancéecettecommande.Celan’estpossibleque depuisl’écrandelaconsoleDB2Alphablox.
REMOVEobjetobjet REMOVEgroupadminuser radams
Supprimel’objetsourcedel’objetcible.
Supprimel’utilisateurradamsdugroupeadmin.
Commandeetexemple Fonctionetexplications REPORTobjet
reportdebug
Attribueauxmessagesdelaconsoleencoursle niveauDEBUG,VERBOSE,INFO,SYSTEM, WARNING,ERRORouFATAL.
Attribueauxmessagesleniveaudebug(débogage).
RESUMEobjet resumeuser
Lanceleserviceindiquéquiétaitàl’étatd’attente.
Lancelegestionnaired’utilisateursquiétaitàl’état d’attente.
RUNobjet runabc.console runcreateUsers.txt
Exécutelefichierdecommandesindiquéparlacible.
Exécutelefichierdecommandesabc.console.
ExécutelefichiercreateUsers.txt.(Cefichierpeutêtre unfichierdetraitementparlotscontenantune séquencedecommandescreateuserdestinéesàcréer denouveauxutilisateursetdéfinirleurmotdepasse initial.Voirlaremarque2quicontientunexemple).
SAVEobjetvaleur Enregistrer saveuserradams
Enregistrelespropriétésdelacible
Enregistretouteslespropriétésgénérales(carGeneral estl’objetpardéfaut).Lesmodificationssaisiessurla consoles’appliquentàlasessionencours
uniquementetellessontperdues,saufsicette commandeestlancéeousilavaleurdelapropriété EnregistrerlorsdelafermeturedeDB2Alphabloxest oui.
Enregistrelespropriétésdel’utilisateurradams SETobjetvaleurobjetvaleur
setuserradamspasswordcastle setsmtpservermail
setresolveAliasesToBaseMembers
Attribueunevaleuràl’objet.
Attribuelemotdepassecastleàl’utilisateurradams.
Attribueleserveurdemessagerienommémailau serveurSMTP.
Commandeetexemple Fonctionetexplications SHOWobjet
showtopics showserver showuserradams showtheme showoutlinecache showhosts show
Récupèredesinformationspourlacible.
Affichelalistedesrubriquesassociéesàdes informations.
Affichetouteslesrubriquesrelativesauxserveurs,y comprislesutilisateurs.
Affichedesinformationssurl’utilisateurappelé radams.
Affichelenometladescriptionduthème.
AffichetouteslesentréesdelamémoirecacheDB2 OLAPServerouEssbase.
Affichelenomdechaquemachineduclusterdansle casd’unenvironnementgroupé.
Affichelalistedesobjets.LacommandeSHOW afficheégalementlaversiondel’APIdebibliothèque clientDB2OLAPServerouHyperionEssbase,sielle n’apasencoreétéchargée.
STARTobjet startuser
Lanceleservicequiestàl’étatarrêté.
Lancelegestionnaired’utilisateursquiestàl’état arrêté.
STATISTICSobjetvaleur statisticsuser
statisticsuserradams
Affichelesstatistiquesdisponiblesrelativesàlacible.
Affichelesstatistiquerelativesàtouslesutilisateurs.
Affichelesstatistiquesdel’utilisateurradams.
STOPobjet stopuser
Arrêteunserviceencoursd’exécutionouenattente.
UtilisezlacommandeSTARTpourlancerunservice quiestarrêté.
Remarque: N’utilisezpaslacommandeSTOPpour arrêterCubeManagersaufsitouslescubesDB2 Alphabloxencoursd’exécutionontétéarrêtés.
Arrêtelegestionnaired’utilisateurs.
SUSPENDobjet suspenduser
Metunserviceàl’étatd’attente.Parexemple,sivous mettezleservicedegestionnaired’utilisateursen attente,aucuneautresessionutilisateurnepeutêtre instanciée.UtilisezlacommandeRESUMEpour relancerunservicequisetrouveenattente.
Metleservicedegestionnaired’utilisateursenattente
Commandes de console spécifiques à Essbase
DB2AlphabloxstockelesstructuresDB2OLAPServer etHyperionEssbasemises enmémoirecacheafind’améliorerlesperformances.Cettesectiondécrit lasyntaxe de deuxcommandesdestinéesà gérerlacachede structureetdelacommandede résolution desnoms d’aliasennomdemembredebase.Lescommandesincluses sont lessuivantes:
v «CommandesRESOLVEALIASESTOBASEMEMBERS»,à lapage147 v «CommandeSHOWOUTLINECACHE»,àlapage147
v «CommandeDELETEOUTLINECACHE»,à lapage148
Commandes RESOLVEALIASESTOBASEMEMBERS
Dans unebase dedonnéesDB2 OLAPServerou Essbase,vouspouvez configurer lesaliasennoms demembre.Lapropriétédeserveur
RESOLVEALIASESTOBASEMEMBERSpeut êtreutiliséeaveclessignetsquienregistrent desrequêtesavecdesaliasquipeuventêtrerésolus ennomde membreà différents moments.Parexemple,sivouscréezunsignetpour unerequête qui référenceunaliasappelé Cetrimestre,lemembreencoursdanslabasede données DB2OLAPServer ouEssbaseauquelseréfèrelarequêteseradifférentde celuid’ilya sixmois.Sivoussouhaitezquevossignetsrécupèrent lesdonnéesde cetrimestre, vousdevezattribuerlavaleurTRUEàlapropriété
RESOLVEALIASESTOBASEMEMBERS.
LasyntaxedelacommandedeconsoleRESOLVEALIASESTOBASEMEMBERSest la suivante :
set resolvealiasestobasemembers true | false
Lacommandesuivanterenvoiel’étatencoursdelapropriétédeserveur RESOLVEALIASESTOBASEMEMBERS:
get resolvealiasestobasemembers
ResolveAliasesToBaseMembers .... false
(ResolveAliasesToBaseMembers)
Pour activercettefonction, entrezlacommandesuivante surlaconsole: set resolvealiasestobasemembers true
Conseil: Pourabrégercettecommande,entrezsuffisamment delettres afin d’obtenirunnomunique, commesuit :
set resolve true
Commande SHOW OUTLINECACHE
LasyntaxedelacommandedeconsoleSHOWOUTLINECACHEpourlessources de donnéesDB2OLAPServerouHyperionEssbaseest lasuivante:
show outlinecache [essbasecachemanager [entry [entryname]]]
Cettecommandepermetd’afficherdesinformationssur legestionnairede cache ou lesentrées qu’ilgère.Par exemple,lacommandesuivantepermetd’afficher toutes lesentréesgéréespar legestionnairede cachede DB2OLAPServer ou Essbase :
show outlinecache essbasecachemanager entry Le systèmeenvoielemessagesuivant : Entry
Entry MDB1.Financial.Current
....Total accesses: 7
....Current accessors: 1
Cetteréponse indiquequelegestionnairedecachedeDB2 OLAPServerou Essbase gèreuneseuleentréeappeléeMDB1.Financial.Current.Lenombred’accès à cettecacheest sept(nombrecumulatif)etlacacheutiliseactuellementune connexion.
Commande DELETE OUTLINECACHE
LasyntaxedelacommandeDELETEOUTLINECACHEpourlessourcesde données DB2OLAPServer ouHyperionEssbaseest lasuivante :
delete outlinecache [essbasecachemanager [entry [entryname]]]
Cettecommandepermetde supprimerde lacachel’entréeindiquée.DB2 Alphabloxsupprimel’entréeuniquementsilenombre deconnexionsencours (accessors)est égalà 0.Siuneentréeestsupprimée,toutes lesressourcesen mémoireassociéesà l’entréesontlibérées. Parexemple,lacommandesuivante permet desupprimerl’entréenomméeMDB1.Financial.Currentde lamémoire cache:
delete outlinecache essbasecachemanager entry MDB1.Financial.Current
Laréponse dusystèmeestlasuivante,laquelle indiquequel’entréeindiquéea été supprimée :
MDB1.Financial.Current Entrée de cache supprimée.
Lacommandesuivanteetlaréponse correspondanteconfirmentquel’entréen’est plusdanslamémoirecache:
show outlinecache essbasecachemanager
EssbaseCache Manager
Total entries: 0
Remarques relatives aux commandes de la console
Cettesectiondécrit certainscomportementsparticuliers etfournitquelquesconseils pour l’utilisationdelaconsoleDB2Alphablox. Lesrubriques présentessontles suivantes:
v «Affichagedespropriétésgénérales»,à lapage148 v «Niveaudesmessages»,à lapage149
v «Exécutiond’unfichiertextevialaconsole»,àlapage149 v «Messagesdu journaldeDB2Alphablox»,àlapage150
Affichage des propriétés générales
LaconsoleDB2Alphabloxpermetd’afficher lespropriétésgénéralesetlesobjets.
Laplupartdesmodificationsdespropriétéssont appliquéesimmédiatement,sinon unmessageindiquequ’il estnécessairederedémarrer DB2Alphabloxpourqueles modificationssoientprisesencompte.Pourobtenirlalistecomplètedespropriétés encoursde DB2Alphablox, utilisezlacommandeGET.
Lesliensprésentsaubasdelalaconsolepermettentd’accéderauxinformations fréquemmentdemandées:
v AideprésentelalistedescommandesdeDB2Alphablox.
v Etatfournitdesinformationsd’étatsurDB2Alphablox.
v Messagesprésente unevuedéroulantedujournalde DB2Alphablox.
v Sessionsprésentelesinformationsd’étatsurtoutes lessessionsencoursdecette instancedeDB2Alphablox.
v Utilisateursaffichelalistedesutilisateurs(qu’ilssoientconnectés ounon).
v Servicesindiquel’étatducomposantdeDB2Alphablox.Pourobtenir laliste desservices,voir«ArchitectureDB2Alphablox»,àlapage9.
v Paramètresindiqueleparamétrageencoursdechaque propriétédeDB2 Alphablox(de démarrageetavancé).
v Afficherprésentelalistehiérarchiquedesrubriquesde DB2Alphablox.
v Historiqueprésentel’historiquedescommandeslancéessur cetteconsole.
Pour plusd’informationssurl’accèsàlaconsole,voir«Accèsà laconsole»,à la page141.
Niveau des messages
Lesmessagesgénéréspar DB2Alphabloxpeuventêtreenvoyés àtoutesles consolesactives etaufichierjournalactif. Lesmessages contiennentles informations suivantes:
v dateetheure v niveaudumessage v textedu message
v sourcedumessage(serviceounomd’utilisateur) Exempledemessage courant:
01/9/99 12:25:33 PM [VERBOSE] Requête 4223: Traitement de la requête
’/servlet/AnalysisServer/console/consolestyle.css’ [Session 41, Utilisateur radams]
Voicilesdifférentsniveauxdemessage,présentésparordredegravité(delaplus faibleàlaplusélevée):
v DEBUG:informations dedébogage.
v VERBOSE:tous lesmessages dusystème.
v INFO:événementssystèmemineurspourlesquelsaucuneaction n’est nécessairedelapartdel’administrateur.
v SYSTEM:événementssystème normaux,telsquelacréationd’unutilisateur.
v WARNING:erreurrécupérable,maisnécessitantéventuellementdesrecherches delapartdel’administrateur.
v ERROR:erreurnonrécupérable.
v FATAL:erreurentraînantl’arrêtduserveur.
Exécution d’un fichier texte via la console
Lacommanderunpermet d’exécutersurlaconsoleunfichiertextecontenantune sériede commandesDB2Alphablox. Parexemple,unfichier nommé
d:\CreateUser.txt contientleslignessuivantes: create user radams blue
create user sadams green create user lplanting purple create user klawrence yellow create user dmessink orange
Vouspouvezexécutercefichieràl’aidedelaconsoleaveclacommanderun pour créercinqnouveauxutilisateursetdéfinirleurmot depasseinitial enexécutantla commandesuivante surlaconsole:
run d:/CreateUser.txt
Remarque: Lenomdu fichierdoitêtrequalifiécomplet.
Messages du journal de DB2 Alphablox
Des messagessansgravitédu typesuivantpeuventapparaître danslefichier journal deDB2Alphablox(par défaut,Server.log):
[VERBOSE] Requête 36: Fichier non trouvé ’...\resources\basic_en_US.class’
[VERBOSE] Requête 37: Fichier non trouvé ’...\resources\basic_en_US.properties’
[VERBOSE] Requête 38: Fichier non trouvé ’...\resources\basic_en.class’
[VERBOSE] Requête 39: Fichier non trouvé ’...\resources\basic_en.properties’ ...
[VERBOSE] Requête 45: Fichier non trouvé ’...\resources\metal_en_US.class’
[VERBOSE] Requête 46: Fichier non trouvé ’...\resources\metal_en_US.properties’
[VERBOSE] Requête 47: Fichier non trouvé ’...\resources\metal_en.class’
[VERBOSE] Requête 48: Fichier non trouvé ’...\resources\metal_en.properties’
...
Dans cetexemple,lamachineJVMtentedetrouverleregroupementderessources leplusadéquatpourlelangageetl’emplacementdel’environnementlocaldu client.Celan’estpasindispensableaufonctionnementde DB2Alphablox:vous pouvez nepasentenircomptesansrisques.