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.
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'].
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.
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.
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.
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.
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]](../images/windows.gif)
Paths = []
Directory = java.io.File("c:\\WebSphere\\AppServer\\scriptLibraries")
AdminUtilities.fileSearch(directory, paths)
![[Linux]](../images/linux.gif)
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
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.
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.
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.
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.
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.
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.
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.
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.
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)