Grupo de mandatos AdministrativeJobs para el objeto AdminTask con scripts wsadmin
Puede utilizar el lenguaje de script Jython para configurar y gestionar trabajos administrativos con la herramienta wsadmin.
deleteJob
El mandato deleteJob suprime un trabajo existente del gestor de trabajos. Si el trabajo está en ejecución cuando se invoca el mandato, el sistema seguirá devolviendo los resultados del trabajo independientemente de que el trabajo se haya suprimido o no.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobToken
- Especifica el identificador exclusivo del trabajo que se va a suprimir. (String, necesario)
Valor de retorno
El mandato no devuelve ninguna salida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando serie de Jython:
AdminTask.deleteJob('-jobToken myToken')
- Utilizando la lista de Jython:
AdminTask.deleteJob('-jobToken', 'myToken')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.deleteJob('-interactive')
getJobTargets
El mandato getJobTargets muestra el destino de un trabajo de interés. El destino que devuelve el mandato para un trabajo se podría suprimir o bien anular su suscripción.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobToken
- Especifica el identificador exclusivo del trabajo de interés. (String, necesario)
Valor de retorno
El mandato devuelve el nombre de nodo de los destinos para el trabajo de interés.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.getJobTargets('-jobToken myToken')
- Utilizando la lista de Jython:
AdminTask.getJobTargets('-jobToken', 'myToken')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.getJobTargets('-interactive')
getJobTargetStatus
El mandato getJobTargetStatus muestra el estado del destino de trabajo más reciente para el trabajo de interés.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobToken
- Especifica el identificador exclusivo del trabajo de interés. (String, necesario)
Parámetros opcionales
- -targetList
- Especifica una lista de nombres de nodo de destino. (String[], opcional)
Valor de retorno
El mandato devuelve el estado del trabajo más reciente para los destinos. El estado puede ser: NOT_ATTEMPTED, DISTRIBUTED, ASYNC_IN_PROGRESS, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, DELAYED o REJECTED.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.getJobTargetStatus('-jobToken myToken')
- Utilizando la lista de Jython:
AdminTask.getJobTargetStatus('-jobToken', 'myToken')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.getJobTargetStatus('-interactive')
getJobTargetHistory
El mandato getJobTargetHistory muestra el historial de destino del trabajo del trabajo de interés.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobToken
- Especifica el identificador exclusivo del trabajo de interés. (String, necesario)
- -target
- Especifica el nombre de nodo del destino de interés. (Serie, obligatorio)
- -maxReturn
- Especifica el número máximo de resultados que se van a devolver. (Entero, obligatorio)
Parámetros opcionales
- -startingTime
- Especifica la hora a partir de la que el mandato devuelve el historial de destinos del trabajo. (String, opcional)
- -endingTime
- Especifica la hora en la que el mandato deja de devolver el historial de destinos del trabajo. (String, opcional)
- -ascending
- Especifica si los resultados deben devolverse en sentido ascendente o descendente. Especifique true para visualizar los resultados en orden ascendente, o false, para visualizarlos en orden descendente. (Booleano, opcional)
Valor de retorno
El mandato devuelve una lista de atributos, donde el primer atributo especifica el número de coincidencias y el segundo atributo especifica el historial del trabajo en el destino. Cada lista contiene los atributos de indicación de fecha y hora, estado, mensaje y resultado.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.getJobTargetHistory('-jobToken 2846493472984754 -target 3820J37H3017N294 -maxReturn 20')
- Utilizando la lista de Jython:
AdminTask.getJobTargetHistory('-jobToken', '2846493472984754', '-target', '3820J37H3017N294', '-maxReturn', '20')
Ejemplo de utilización de la modalidad interactiva
- Utilizando
Jython:
AdminTask.getJobTargetHistory('-interactive')
getJobTypes
El mandato getJobTypes muestra los tipos de trabajo soportados para un punto final de interés.
Objeto de destino
Ninguna.
Parámetros opcionales
- -targetList
- Especifica una lista de nombres de nodo para el destino. (String[], opcional)
- -group
- Especifica el nombre del grupo para el destino. (String, opcional)
Valor de retorno
El mandato devuelve una lista de los tipos de trabajo que soporta cada destino especificado.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.getJobTypes('-target myProfileKey')
- Utilizando la lista de Jython:
AdminTask.getJobTypes('-target', 'myProfileKey')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.getJobTypes('-interactive')
getJobTypeMetadata
El mandato getJobTypeMetadata muestra los metadatos asociados a un tipo de trabajo específico.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobTypeList
- Especifica una lista de los tipos de trabajo de interés. (String[], opcional)
Valor de retorno
El mandato devuelve una lista de atributos, incluidos los atributos name, label, description, job-properties y job-parameters.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.getJobTypeMetadata('-jobTypeList inventory')
- Utilizando la lista de Jython:
AdminTask.getJobTypeMetadata('-jobTypeList', 'inventory')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.getJobTypeMetadata('-interactive')
getOverallJobStatus
El mandato getOverallJobStatus muestra el estado global del trabajo para un trabajo específico o una lista de trabajos de interés.
Objeto de destino
Ninguna.
Parámetros opcionales
- -jobTokenList
- Especifica uno o más identificadores exclusivos de los trabajos de interés. (String[], opcional)
Valor de retorno
- El atributo STATE especifica el estado actual del trabajo.
- El atributo TOTAL_RESULTS especifica el número total de trabajos.
- El atributo DISTRIBUTED especifica el número de trabajos distribuidos.
- El atributo ASYNC_IN_PROGRESS especifica el número de trabajos asíncronos en progreso.
- El atributo SUCCEEDED especifica el número de trabajos correctos.
- El atributo PARTIALLY_SUCCEEDED especifica el número de trabajos parcialmente completados. Por ejemplo, se puede producir un éxito parcial si un nodo representa a varios servidores y sólo algunos de estos servidores completan el trabajo correctamente.
- El atributo FAILED especifica el número de trabajos incorrectos.
- El atributo NOT_ATTEMPTED especifica el número de trabajos que el sistema no ha intentado.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.getOverallJobStatus('-jobTokenList myJobToken')
- Utilizando la lista de Jython:
AdminTask.getOverallJobStatus('-jobTokenList', 'myJobToken')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.getOverallJobStatus('-interactive')
queryJobs
El mandato queryJobs consulta el gestor de trabajos para cada trabajo enviado.
Objeto de destino
Ninguna.
Parámetros necesarios
- -query
- Especifica la expresión de búsqueda para utilizar para consultar trabajos. (String,
necesario)Utilice las directrices siguientes al crear las consultas de trabajo:
- La consulta está formada por una clave, un operador y un valor, o una lista de valores. Puede especificar un único valor o una lista de valores separados por una coma.
- Varias expresiones separadas con un espacio y el operador AND.
- Se da soporte a las siguientes claves sensibles a mayúsculas y minúsculas:
- jobToken
- Especifica la señal de trabajo para un trabajo específico de la consulta.
- group
- Especifica el nombre del grupo de nodos que se debe consultar.
- descripción
- Especifica la descripción del trabajo para consultar. Si la descripción contiene varias palabras, el formato de la descripción debe utilizar las comillas simples o dobles, por ejemplo, descripción = "descripción de trabajo".
- activationDateTime
- Especifica la fecha y la hora en la que el sistema activa el trabajo, por ejemplo, 2006-05-03T10:30:45-0000. La sección -0000 del valor de la clave activationDateTime representa el formato RFC 822. Puede especificar Z como una abreviatura para la hora media de Greenwich (GMT) como, por ejemplo, 2006-05-03T10:30:45Z. Si no especifica el huso horario, el sistema utiliza el del servidor.
- expirationDateTime
- Especifica la fecha y la hora en la que caduca el trabajo como, por ejemplo, 2006-05-03T10:30:45-0000. La sección -0000 del valor de la clave activationDateTime representa el formato RFC 822. Puede especificar Z como una abreviatura para la hora media de Greenwich (GMT) como, por ejemplo, 2006-05-03T10:30:45Z. Si no especifica el huso horario, el sistema utiliza el del servidor.
- state
- Especifica el estado del trabajo. Entre los valores válidos se incluyen ASYNC_IN_PROGRESS, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, DELAYED, REJECTED y NOT_ATTEMPTED.
- target
- Especifica el nodo de destino para un trabajo. Utilice esta clave para devolver los trabajos para un nodo específico. El mandato devuelve los trabajos para el nodo específico y los grupos de nodos a los que pertenece el nodo. Sólo puede especificar un ID de destino por consulta.
- Los operadores siguientes están soportados:
Tabla 1. Operadores queryJobs -query. Utilice un operador en una consulta. Carácter Value = Igual a. Especifique que el valor es nulo utilizando = NULL. != No igual a. Especifique que el valor no es nulo utilizando != NULL > Mayor que < Menor que >= Mayor que o igual a <= Menor que o igual a
- -maxReturn
- Especifica el número máximo de coincidencias que deben devolverse. (Entero, obligatorio)
Valor de retorno
[ [result [{activationDateTime=2008-03-11T11:56:48-0500,
expirationDateTime=2008-05-10T11:56:48-0500, jobToken=120525460839085191,
description=testSubmitJobToValidBaseTargetList}{activationDateTime=2008-03-11T14:05:33-0500,
expirationDateTime=2008-05-10T14:05:33-0500, jobToken=120526233387582472,
description=testSubmitJobToValidBaseTargetList}]] [size 2] ]
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
print AdminTask.queryJobs('-query activationDateTime>= "2006-01-01" activationDateTime<= "2007-01-01" -maxReturn 20')
print AdminTask.queryJobs('[-query "target = node3" -maxReturn 2]')
- Utilizando la lista de Jython:
AdminTask.queryJobs('-query', 'activationDateTime>= "2006-01-01" activationDateTime<= "2007-01-01"', '-maxReturn', '20')
print AdminTask.queryJobs(['-query', '"target = node3"', '-maxReturn', '2'])
Ejemplo de utilización de la modalidad interactiva
- Utilizando serie de Jython:
AdminTask.queryJobs('-interactive')
resumeJob
El mandato resumeJob reanuda un trabajo previamente iniciado o suspendido.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobToken
- Especifica el identificador exclusivo del trabajo de interés. (String, necesario)
Valor de retorno
El mandato no devuelve ninguna salida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando serie de Jython:
AdminTask.resumeJob('-jobToken myToken')
- Utilizando la lista de Jython:
AdminTask.resumeJob('-jobToken', 'myToken')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.resumeJob('-interactive')
submitJob
El mandato submitJob somete un nuevo trabajo administrativo al gestor de trabajos.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobType
- Especifica el tipo de trabajo para enviar. (Serie, obligatorio)
Parámetros opcionales
- -group
- Especifica el nombre del grupo para el destino. (String, opcional)
- -targetList
- Especifica una lista de nodos para el destino. (String[], opcional)
- -jobParams
- Especifica los parámetros necesarios para el trabajo que se va a enviar. (Properties, opcional)
- -username
- Especifica el nombre de usuario que se utiliza para someter el trabajo cuando la seguridad está habilitada. (String, opcional)
- -password
- Especifica la contraseña para el nombre de usuario que debe utilizarse para someter el trabajo cuando la seguridad está habilitada. (String, opcional)
- -description
- Especifica una descripción para el trabajo. (String, opcional)
- -activationDateTime
- Especifica la fecha y hora a la que se va a activar el trabajo, en el formato "2006-05-03T10:30:45-0000". La sección "-0000" del valor del parámetro activationDateTime representa el formato RFC 822. Puede especificar "Z" como una abreviatura para la hora media de Greenwich (GMT) como, por ejemplo, "2006-05-03T10:30:45Z". Si no especifica el huso horario, el sistema utiliza el del servidor. (String, opcional)
- -expirationDateTime
- Especifica la fecha de caducidad para el trabajo. (String, opcional)
- -executionWindow
- Especifica el intervalo recurrente para el trabajo. (String, opcional)
- -executionWindowUnit
- Especifica la unidad de medida del intervalo de repetición del valor establecido por el parámetro executionWindow. Especifique DAILY para ejecutar el trabajo diariamente, WEEKLY para ejecutarlo semanalmente, MONTHLY para ejecutarlo mensualmente y YEARLY para ejecutarlo anualmente. También puede especificar CONNECTION para ejecutar el trabajo cada vez que el nodo se conecte al gestor de trabajos para sondear trabajos. Cuando especifique CONNECTION, no defina el parámetro executionWindow. (String, opcional)
- Especifica la dirección de correo electrónico a la que el sistema envía las notificaciones de trabajo. (String, opcional)
Valor de retorno
El mandato devuelve una señal de trabajo para el trabajo enviado recientemente.
Ejemplo de utilización de la modalidad por lotes
- Utilizando serie de Jython:
AdminTask.submitJob('[-jobType createApplicationServer -target profileKey -jobParams "[serverName mi_servidor]" ]')
- Utilizando la lista de Jython:
AdminTask.submitJob(['-jobType', 'createApplicationServer', '-target', 'profileKey', '-jobParams', '"[serverName mi_servidor]"'])
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.submitJob('-interactive')
suspendJob
El mandato suspendJob suspende un trabajo que se ha enviado previamente.
Objeto de destino
Ninguna.
Parámetros necesarios
- -jobToken
- Especifica el identificador exclusivo del trabajo que se va a suspender. (String, necesario)
Valor de retorno
El mandato no devuelve ninguna salida.
Uso del ejemplo de modalidad de proceso por lotes
- Utilizando serie de Jython:
AdminTask.suspendJob('-jobToken myToken')
- Utilizando la lista de Jython:
AdminTask.suspendJob('-jobToken', 'myToken')
Ejemplo de utilización de la modalidad interactiva
- En Jython:
AdminTask.suspendJob('-interactive')