Scripts d'utilitaire

La bibliothèque de scripts propose de nombreuses procédures de script pour automatiser la configuration des applications. Consultez les informations sur la syntaxe des scripts qui définissent les options de notification, enregistrent les modifications de configuration et affichent les informations de la bibliothèque de création de scripts.

Chaque procédure de script d'utilitaire se trouve dans le répertoire racine_serveur_app/scriptLibraries/utilities/V70. Utilisez les procédures de script suivantes pour exécuter les fonctions d'utilitaire :

convertToList

Ce script convertit une chaîne en liste. Par exemple, la commande AdminApp.list() renvoie une chaîne de noms d'applications. Utilisez le script convertToList pour convertir la sortie au format liste, par exemple ['DefaultApplication', 'a1', 'a2', 'ivtApp', 'query'].

Tableau 1. Description des arguments de convertToList. Exécutez le script pour renvoyer une sortie sous forme de chaîne et paramétrer la sortie sur une variable.
Argument Description
variable Indique le nom de la variable qui contient la chaîne à convertir en liste.

Syntaxe

AdminUtilities.convertToList(variable)

Exemple de syntaxe

apps=AdminApp.list()
AdminUtilities.convertToList(apps)

debugNotice

Ce script définit le texte de notification de débogage.

Tableau 2. Description des arguments de debugNotice. Exécutez le script pour indiquer l'argument de message.
Argument Description
message Indique le texte du message de notification de débogage.

Syntaxe

AdminUtilities.debugNotice(message)

Exemple de syntaxe

AdminUtilities.debugNotice("Server is started")

getExceptionText

Ce script affiche le message d'exception correspondant à un type d'exception spécifique, à une valeur d'exception ou à des informations de rétrotraçage.

Tableau 3. Description des arguments de getExceptionText. Exécutez le script pour indiquer les arguments de type, de valeur ou de rétrotraçage.
Argument Description
type Indique le type d'exception qui vous intéresse. Le type d'exception représente l'objet de classe de l'exception.
value Indique la valeur d'exception qui vous intéresse. La valeur représente l'objet d'instance qui est l'argument de l'exception ou le deuxième argument de l'instruction mise au premier plan.
traceback Indique les informations de rétrotraçage qui vous intéressent. L'objet de rétrotraçage contient des attributs spéciaux, y compris le numéro de la ligne où l'erreur s'est produite. N'affectez pas le rétrotraçage à une variable locale dans la fonction qui gère l'exception, car cette affectation crée une référence circulaire.

Syntaxe

AdminUtilities.getExceptionText(type, value, traceback)

Exemple de syntaxe

AdminUtilities.getExceptionText("com.ibm.ws.scripting.ScriptingException"
, "com.ibm.ws.scripting.ScriptingException: AdminControl service not available"
, "")

fail

Ce script indique le message d'échec.

Tableau 4. Description des arguments de fail. Exécutez le script pour indiquer l'argument de message.
Argument Description
message Indique le texte du message de notification d'échec.

Syntaxe

AdminUtilities.fail(message)

Exemple de syntaxe

AdminUtilities.fail("The script failed")

fileSearch

Ce script recherche dans système de fichiers, dans un chemin d'accès ou un répertoire spécifiques.

Tableau 5. Description des arguments de fileSearch. Exécutez le script pour indiquer les arguments de chemin d'accès ou de répertoire.
Argument Description
path Indique le chemin d'accès au fichier où il faut rechercher un fichier spécifique.
directory Indique le répertoire dans lequel chercher un fichier spécifique.

Syntaxe

AdminUtilities.fileSearch(path, directory)

Exemple de syntaxe

[Windows]
Paths = []
Directory = java.io.File("c:\\WebSphere\\AppServer\\scriptLibraries")
AdminUtilities.fileSearch(directory, paths)
[Linux][AIX][HP-UX][Solaris][IBM i][z/OS]
Paths = []
Directory = java.io.File("//WebSphere//AppServer//scriptLibraries")
AdminUtilities.fileSearch(directory, paths)

getResourceBundle

Ce script affiche une instance de l'ensemble de ressources qui vous intéresse.

Tableau 6. Description des arguments de getResourceBundle. Exécutez le script pour indiquer l'argument de nom d'ensemble.
Argument Description
bundleName Indique le nom de l'ensemble qui vous intéresse. Par exemple, pour obtenir un objet de message depuis l'ensemble de ressources ScriptingLibraryMessage, indiquez com.ibm.ws.scripting.resources.scriptLibraryMessage.

Syntaxe

AdminUtilities.getResourceBundle(bundleName)

Exemple de syntaxe

AdminUtilities.getResourceBundle("com.ibm.ws.scripting.resources.scriptLibraryMessage")

getScriptLibraryFiles

Ce script affiche le chemin d'accès au fichier et les noms de fichier par chaque fichier de bibliothèque de script.

Syntaxe

AdminUtilities.getScriptLibraryFiles()

Exemple de syntaxe

AdminUtilities.getScriptLibraryFiles()

getScriptLibraryList

Ce script affiche chaque nom de script de la bibliothèque de scripts.

Syntaxe

AdminUtilities.getScriptLibraryList()

Exemple de syntaxe

AdminUtilities.getScriptLibraryList()

getScriptLibraryPath

Ce script affiche le chemin d'accès au fichier pour obtenir les fichiers de la bibliothèque de scripts sur votre système de fichiers.

Syntaxe

AdminUtilities.getScriptLibraryPath()

Exemple de syntaxe

AdminUtilities.getScriptLibraryPath()

help

Ce script affiche l'aide de la bibliothèque de scripts AdminUtilities, y compris les informations relatives à la bibliothèque générale, les noms de scripts et les descriptions de scripts.

Tableau 7. Description des arguments de help. Exécutez le script pour obtenir des informations relatives au script qui vous intéresse.
Argument Description
scriptName Indique, de manière facultative, le nom du script AdminUtilities qui vous intéresse.

Syntaxe

AdminUtilities.help(scriptName)

Exemple de syntaxe

AdminUtilities.help("sleepDelay")

infoNotice

Ce script définit le texte de la notification d'informations d'une commande ou d'un script.

Tableau 8. Description des arguments de infoNotice. Exécutez le script pour indiquer l'argument de message.
Argument Description
message Indique le texte du message ou un ID message tel que "L'application est installée" ou resourceBundle.getString("WASX7115I").

Syntaxe

AdminUtilities.infoNotice(message)

Exemple de syntaxe

AdminUtilities.infoNotice(resourceBundle.getString("WASX7115I"))

save

Ce script enregistre les modifications de configuration apportées à votre système.

Syntaxe

AdminUtilities.save()

Exemple de syntaxe

AdminUtilities.save()

setDebugNotices

Ce script active et désactive les notifications de débogage.

Tableau 9. Description des arguments de setDebugNotices. Exécutez le script pour indiquer l'argument de débogage.
Argument Description
debug Indique si les notifications de débogage sont activées ou désactivées. Indiquez true pour activer les notifications de débogage ou false pour les désactiver.

Syntaxe

AdminUtilities.setDebugNotices(debug)

Exemple de syntaxe

AdminUtilities.setDebugNotices("true")

setFailOnErrorDefault

Ce script active ou désactive le comportement d'échec en cas d'erreur.

Tableau 10. Description des arguments de setFailOnErrorDefault. Exécutez le script pour indiquer l'argument d'échec en cas d'erreur.
Argument Description
failOnError Indique si le comportement d'échec en cas d'erreur doit ou non être activé. Indiquez true pour activer le comportement d'échec en cas d'erreur, ou false pour le désactiver.

Syntaxe

AdminUtilities.setFailOnErrorDefault(failOnError)

Exemple de syntaxe

AdminUtilities.setFailOnErrorDefault("false")

sleepDelay

Ce script définit le nombre de secondes pendant lesquelles le système attend la fin de l'exécution pendant deux opérations en cours.

Tableau 11. Description des arguments de sleepDelay. Exécutez le script pour définir le indiquer l'argument de délai d'attente en secondes.
Argument Description
delaySeconds Indique le nombre de secondes pendant lequel la fin de l'exécution est attendue.

Syntaxe

AdminUtilities.sleepDelay(delaySeconds)

Exemple de syntaxe

AdminUtilities.sleepDelay("10")

warningNotice

Ce script définit le texte à afficher dans le message d'avertissement.

Tableau 12. Description des arguments de warningNotice. Exécutez le script pour indiquer l'argument de message.
Argument Description
message Indique le texte non traduit pour le notification d'avertissement ou un ID message, tel que resourceBundle.getString("WASX7411W").

Syntaxe

AdminUtilities.warningNotice(message)

Exemple de syntaxe

AdminUtilities.warningNotice(resourceBundle.getString("WASX7411W"))

configureAutoSave

Ce script permet d'activer et de désactiver la sauvegarde automatique des modifications apportées au référentiel de la configuration principale.

Tableau 13. Description des arguments de configureAutoSave. Exécutez le script pour indiquer l'argument de sauvegarde automatique.
Argument Description
autosave Indique si les modifications de configuration doivent être sauvegardées dans le référentiel de la configuration maîtresse. La valeur par défaut est true.

Syntaxe

AdminUtilities.configureAutoSave(autosave)

Exemple de syntaxe

AdminUtilities.configureAutoSave(false)

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libutility
Nom du fichier : rxml_7libutility.html