Scripts de programa de utilidad
La biblioteca de scripts proporciona varios procedimientos de script para automatizar las configuraciones de aplicación. Consulte la información de utilización para scripts que definen opciones de notificación, guardan cambios de configuración y visualizan información sobre bibliotecas de scripts.
convertToList
Este mandato convierte una serie en una lista. Por ejemplo, el mandato AdminApp.list() devuelve una serie de nombres de aplicación. Utilice el script convertToList para cambiar la salida en un formato de lista, como por ejemplo ['DefaultApplication', 'a1', 'a2', 'ivtApp', 'query'].
Argumento | Descripción |
---|---|
variable | Especifica el nombre de la variable que contiene la serie que debe convertirse en una lista. |
Sintaxis
AdminUtilities.convertToList(variable)
Ejemplo de uso
apps=AdminApp.list()
AdminUtilities.convertToList(apps)
debugNotice
Este script define el texto de aviso de depuración.
Argumento | Descripción |
---|---|
message | Especifica el texto del mensaje para el aviso de depuración. |
Sintaxis
AdminUtilities.debugNotice(mensaje)
Ejemplo de uso
AdminUtilities.debugNotice("Server is started")
getExceptionText
Este script muestra el mensaje de excepción para un tipo o valor de excepción determinado, o información de seguimiento de rastreo.
Argumento | Descripción |
---|---|
type | Especifica el tipo de excepción de interés. El tipo de excepción representa el objeto de clase de la excepción. |
value | Especifica el valor de excepción de interés. El valor representa el objeto de instancia que es el argumento de la excepción o el segundo argumento de la sentencia de emisión. |
traceback | Especifica información de seguimiento de rastreo de interés. El objeto traceback contiene atributos especiales, incluido el número de línea en el que se ha producido el error. No asigne traceback a una variable local en la función que gestiona la excepción, ya que este argumento crea una referencia circular. |
Sintaxis
AdminUtilities.getExceptionText(type, value, traceback)
Ejemplo de uso
AdminUtilities.getExceptionText("com.ibm.ws.scripting.ScriptingException"
, "com.ibm.ws.scripting.ScriptingException: el servicio AdminControl no está disponible"
, "")
fail
Este script establece el mensaje de anomalía.
Argumento | Descripción |
---|---|
message | Especifica el texto del mensaje para el aviso de anomalía. |
Sintaxis
AdminUtilities.fail(mensaje)
Ejemplo de uso
AdminUtilities.fail("The script failed")
fileSearch
Este script busca en el sistema de archivos en función de una vía de acceso o un directorio determinado.
Argumento | Descripción |
---|---|
path | Especifica la vía de acceso del archivo para buscar un archivo determinado. |
directory | Especifica el directorio en el que se debe buscar un archivo determinado. |
Sintaxis
AdminUtilities.fileSearch(path, directory)
Ejemplo de uso
![[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
Este script muestra una instancia del paquete de recursos de interés.
Argumento | Descripción |
---|---|
bundleName | Especifica el nombre del paquete de interés. Por ejemplo, para obtener un objeto de mensaje del paquete de recursos ScriptingLibraryMessage, especifique com.ibm.ws.scripting.resources.scriptLibraryMessage. |
Sintaxis
AdminUtilities.getResourceBundle(bundleName)
Ejemplo de uso
AdminUtilities.getResourceBundle("com.ibm.ws.scripting.resources.scriptLibraryMessage")
getScriptLibraryFiles
Este script muestra la vía de acceso del archivo y los nombres de archivo para cada archivo de la biblioteca de scripts.
Sintaxis
AdminUtilities.getScriptLibraryFiles()
Ejemplo de uso
AdminUtilities.getScriptLibraryFiles()
getScriptLibraryList
Este script muestra el nombre de cada script de la biblioteca de scripts.
Sintaxis
AdminUtilities.getScriptLibraryList()
Ejemplo de uso
AdminUtilities.getScriptLibraryList()
getScriptLibraryPath
Este script muestra la vía de acceso del archivo para obtener los archivos de la biblioteca de scripts del sistema de archivos.
Sintaxis
AdminUtilities.getScriptLibraryPath()
Ejemplo de uso
AdminUtilities.getScriptLibraryPath()
help
Este script muestra información de ayuda para la biblioteca de scripts AdminUtilities, incluyendo información general sobre la biblioteca, nombres de los scripts y descripciones de los scripts.
Argumento | Descripción |
---|---|
scriptName | Opcionalmente, especifica el nombre del script AdminUtilities de interés. |
Sintaxis
AdminUtilities.help(scriptName)
Ejemplo de uso
AdminUtilities.help("sleepDelay")
infoNotice
Este script establece el texto para el aviso de información del mandato o el script.
Argumento | Descripción |
---|---|
message | Especifica el texto del mensaje o un ID de mensaje, como "La aplicación está instalada" o resourceBundle.getString("WASX7115I"). |
Sintaxis
AdminUtilities.infoNotice(message)
Ejemplo de uso
AdminUtilities.infoNotice(resourceBundle.getString("WASX7115I"))
save
Este script guarda los cambios de configuración en el sistema.
Sintaxis
AdminUtilities.save()
Ejemplo de uso
AdminUtilities.save()
setDebugNotices
Este script habilita e inhabilita los avisos de depuración.
Argumento | Descripción |
---|---|
debug | Especifica si deben habilitarse o inhabilitarse los avisos de depuración. Especifique true para habilitar los avisos de depuración, o false, para inhabilitarlos. |
Sintaxis
AdminUtilities.setDebugNotices(debug)
Ejemplo de uso
AdminUtilities.setDebugNotices("true")
setFailOnErrorDefault
Este script habilita o inhabilita el comportamiento de anomalía en caso de error.
Argumento | Descripción |
---|---|
failOnError | Especifica si debe habilitarse o inhabilitarse el comportamiento de anomalía tras error. Especifique true para habilitar el comportamiento de anomalía en caso de error, o false, para inhabilitarlo. |
Sintaxis
AdminUtilities.setFailOnErrorDefault(failOnError)
Ejemplo de uso
AdminUtilities.setFailOnErrorDefault("false")
sleepDelay
Este script establece el número de segundos durante los que el sistema espera la finalización durante dos operaciones.
Argumento | Descripción |
---|---|
delaySeconds | Especifica el número de segundos durante los que se espera que finalice una operación. |
Sintaxis
AdminUtilities.sleepDelay(delaySeconds)
Ejemplo de uso
AdminUtilities.sleepDelay("10")
warningNotice
Este script establece el texto que debe visualizarse como mensaje de aviso.
Argumento | Descripción |
---|---|
message | Especifica texto no traducido para el mensaje de aviso o un ID de mensaje, como resourceBundle.getString("WASX7411W"). |
Sintaxis
AdminUtilities.warningNotice(message)
Ejemplo de uso
AdminUtilities.warningNotice(resourceBundle.getString("WASX7411W"))
configureAutoSave
Este script habilita e inhabilita el guardado automático de los cambios de la configuración en el repositorio de configuración maestro.
Argumento | Descripción |
---|---|
autosave | Especifica si se han de guardar los cambios de configuración en el repositorio de configuración maestro de forma automática. El valor predeterminado es true. |
Sintaxis
AdminUtilities.configureAutoSave(autosave)
Ejemplo de uso
AdminUtilities.configureAutoSave(false)