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.

Cada procedimiento de script de programa de utilidad se encuentra en el directorio raíz_servidor_aplicaciones/scriptLibraries/utilities/V70. Utilice los procedimientos de scripts siguientes para realizar funciones de programa de utilidad:

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'].

Tabla 1. Descripción de los argumentos de convertToList. Ejecuta el script para devolver una salida de serie y define la salida a una variable.
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.

Tabla 2. Descripción de los argumentos de debugNotice. Ejecute el script para especificar el argumento message.
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.

Tabla 3. Descripciones de los argumentos de getExceptionText. Ejecute el script para especificar los argumentos type, value o traceback.
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.

Tabla 4. Descripción de los argumentos de fail. Ejecute el script para especificar el argumento message.
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.

Tabla 5. Descripciones de los argumentos de fileSearch. Ejecute el script para especificar los argumentos path o directory.
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]
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

Este script muestra una instancia del paquete de recursos de interés.

Tabla 6. Descripción de los argumentos de getResourceBundle. Ejecute el script para especificar el argumento de nombre de paquete.
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.

Tabla 7. Descripción del argumento help. Ejecute el script para obtener información sobre el script de interés.
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.

Tabla 8. Descripción de los argumentos de infoNotice. Ejecute el script para especificar el argumento de mensaje.
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.

Tabla 9. Descripción de los argumentos de setDebugNotices. Ejecute el script para especificar el argumento debug.
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.

Tabla 10. Descripción de los argumentos de setFailOnErrorDefault. Ejecute el script para especificar el argumento de fallo en 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.

Tabla 11. Descripción de los argumentos de sleepDelay. Ejecute el script para especificar el argumento de segundos de retardo.
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.

Tabla 12. Descripción de los argumentos de warningNotice. Ejecute el script para especificar el argumento de mensaje.
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.

Tabla 13. Descripción de los argumentos de configureAutoSave. Ejecute el script para especificar el argumento autosave.
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)

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libutility
File name: rxml_7libutility.html