Grupo de mandatos JobManagerNode para el objeto AdminTask con scripts wsadmin

Puede utilizar el lenguaje de scripts Jython para gestionar los valores del gestor de trabajos con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo JobManagerNode para registrar destinos que no contengan un agente administrativo con el gestor de trabajos.

Utilice los mandatos que tengan Target en los nombres de mandato: cleanupTarget, queryTargets, getTargetProperties, modifyTargetProperties y getTargetKeys. Estos mandatos sustituyen los mandatos en desuso que tienen ManagedNode en los nombres de mandato.

Deprecated feature Deprecated feature: Los mandatos del grupo de mandatos JobManagerNode que tienen ManagedNode en los nombres de mandato y que están en desuso en la versión 8.0 de WebSphere Application Server incluyen cleanupManagedNode, queryManagedNodes, getManagedNodeProperties , modifyManagedNodeProperties y getManagedNodeKeys. En su lugar, utilice mandatos que tengan Target en los nombres de mandato. depfeat

cleanupManagedNode (en desuso)

El mandato cleanupManagedNode limpia la información de registro de un nodo gestionado. Si el sistema falla cuando elimina un nodo del gestor de trabajos, utilice este mandato para borrar de forma explícita la información de registro en el gestor de trabajos. El mandato no elimina el historial de trabajos para el nodo. Los trabajos en progreso se siguen ejecutando, pero los trabajos nuevos no se inician para el nodo.

Objeto de destino

Ninguna.

Parámetros necesarios

-managedNodeName
Especifica el nombre del nodo de interés. (Serie, obligatorio)

Valor de retorno

El mandato devuelve el UUID del gestor de trabajos que ha borrado el sistema.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.cleanupManagedNode('-managedNodeName Node1')
  • Utilizando la lista de Jython:
    AdminTask.cleanupManagedNode(['-managedNodeName', 'Node1'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.cleanupManagedNode('-interactive')

cleanupTarget

El mandato cleanupTarget limpia la información de registro de un destino. Si el sistema falla cuando elimina un destino del gestor de trabajos, utilice este mandato para borrar de forma explícita la información de registro en el gestor de trabajos. El mandato no elimina el historial de trabajos para el destino. Los trabajos en progreso se siguen ejecutando, pero los trabajos nuevos no se inician para el destino.

Objeto de destino

Ninguna.

Parámetros necesarios

-targetName
Especifica el nombre del destino de interés. (Serie, obligatorio)

Valor de retorno

El mandato devuelve el UUID del gestor de trabajos que ha borrado el sistema.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.cleanupTarget('-targetName Target1')
  • Utilizando la lista de Jython:
    AdminTask.cleanupTarget(['-targetName', 'Target1'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.cleanupTarget('-interactive')

getContexts

El mandato getContexts muestra todos los contextos del modelo de gestión, incluidos los nodos y los servidores.

Objeto de destino

Ninguna.

Parámetros necesarios

Ninguna.

Valor de retorno

El mandato devuelve una lista de todas las vías de acceso de contexto.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getContexts()
  • Utilizando la lista de Jython:
    AdminTask.getContexts()

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getContexts('-interactive')

getManagedNodeKeys (en desuso)

El mandato getManagedNodeKeys muestra las claves que se van a utilizar para consultar los nodos gestionados, incluidas las claves name, alias y uuid.

Objeto de destino

Ninguna.

Parámetros opcionales

-managedNodeName
Especifica el nombre del nodo de interés. (String, opcional)

Valor de retorno

El mandato devuelve una lista de las claves.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getManagedNodeKeys('-managedNodeName Node1')
  • Utilizando la lista de Jython:
    AdminTask.getManagedNodeKeys(['-managedNodeName', 'Node1'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getManagedNodeKeys('-interactive')

getTargetKeys

El mandato getTargetKeys muestra las claves que se van a utilizar para consultar los destinos, incluidas las claves name, alias y uuid.

Objeto de destino

Ninguna.

Parámetros opcionales

-targetName
Especifica el nombre del destino de interés. (String, opcional)

Valor de retorno

El mandato devuelve una lista de las claves.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getTargetKeys('-targetName Target1')
  • Utilizando la lista de Jython:
    AdminTask.getTargetKeys(['-targetName', 'Target1'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getTargetKeys('-interactive')

getManagedNodeProperties (en desuso)

El mandato getManagedNodeProperties muestra las propiedades de uno o varios nodos gestionados o no gestionados.

Objeto de destino

Ninguna.

Parámetros opcionales

-managedNodeNameList
Especifica una lista de nombres de los nodos de interés. (String[], opcional)

Valor de retorno

El mandato devuelve una lista de propiedades para cada nodo especificado con el parámetro -managedNodeNameList.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getManagedNodeProperties('-managedNodeNameList "[Node1 Node2]"')
  • Utilizando la lista de Jython:
    AdminTask.getManagedNodeProperties(['-managedNodeNameList', '[Node1 Node2]'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getManagedNodeProperties('-interactive')

getTargetProperties

El mandato getTargetProperties muestra las propiedades de uno ovarios destinos.

Objeto de destino

Ninguna.

Parámetros opcionales

-targetNameList
Especifica una lista de nombres de los destinos de interés. (String[], opcional)

Valor de retorno

El mandato devuelve una lista de propiedades para cada destino especificado con el parámetro -targetNameList.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getTargetProperties('-targetNameList "[Target1 Target2]"')
  • Utilizando la lista de Jython:
    AdminTask.getTargetProperties(['-targetNameList', '[Target1 Target2]'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getTargetProperties('-interactive')

getManagedResourceProperties

El mandato getManagedResourceProperties muestra las propiedades de uno o varios recursos gestionados. Los recursos gestionados son instancias dentro de un contexto de nodo o un contexto de servidor. Por ejemplo, dentro de un contexto de servidor puede tener el servidor1, servidor2 o servidor3 de recursos gestionados.

Objeto de destino

Ninguna.

Parámetros necesarios

-resourceIdList
Especifica una lista de identificadores exclusivos para el recurso de interés. (String, opcional)

Valor de retorno

El mandato devuelve una lista de propiedades para cada recurso gestionado.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getManagedResourceProperties('-resourceIdList AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
    /nodes/myNode/servers/server1')  
  • Utilizando la lista de Jython:
    AdminTask.getManagedResourceProperties('-resourceIdList', 'AppSrv01-BASE-b83dc35c-69d4-40af-af60-127de7002cfb
    /nodes/myNode/servers/server1')  

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getManagedResourceProperties('-interactive')

getManagedResourcePropertyKeys

El mandato getManagedResourcePropertyKeys muestra las claves de propiedad para un tipo específico de recursos gestionados.

Objeto de destino

Ninguna.

Parámetros necesarios

-resourceType
Especifica el tipo de recurso gestionado de interés. (Serie, obligatorio)

Valor de retorno

El mandato devuelve una lista de claves de recurso gestionado para el tipo de recurso específico.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getManagedResourcePropertyKeys('-resourceType servidor')
  • Utilizando la lista de Jython:
    AdminTask.getManagedResourcePropertyKeys('-resourceType', 'servidor')

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getManagedResourcePropertyKeys('-interactive')

getManagedResourceTypes

El mandato getManagedResourceTypes muestra cada uno de los tipos de recursos gestionados.

Objeto de destino

Ninguna.

Parámetros necesarios

Ninguna.

Valor de retorno

El mandato devuelve una lista de los tipos de recurso gestionado.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.getManagedResourceTypes()
  • Utilizando la lista de Jython:
    AdminTask.getManagedResourceTypes()

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.getManagedResourceTypes('-interactive')

modifyManagedNodeProperties (en desuso)

El mandato modifyManagedNodeProperties sustituye las propiedades de una configuración de nodo gestionado. Si el nodo gestionado tiene un agente administrativo, el mandato sólo modifica la propiedad alias. Si el nodo gestionado no tiene un agente administrativo, el mandato sustituye todas las propiedades.

Objeto de destino

Ninguna.

Parámetros necesarios

-managedNodeName
Especifica el nombre del nodo de interés. (Serie, obligatorio)
-managedNodeProps
Especifica los pares de propiedad nombre y valor que se van a modificar para el nodo de interés. (Properties, obligatorio)

Parámetros opcionales

-replace
Especifica si se van a sustituir las propiedades existentes. Especifique true para sustituir las propiedades existentes. Especifique false para fusionar las propiedades. El valor predeterminado es false. (Booleano, opcional)

Valor de retorno

El mandato no devuelve ninguna salida.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.modifyManagedNodeProperties('-managedNodeName Node1 -managedNodeProps "[alias miNuevoAlias]"')
  • Utilizando la lista de Jython:
    AdminTask.modifyManagedNodeProperties('-managedNodeName', 'Node1', '-managedNodeProps', '[alias miNuevoAlias]')

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.modifyManagedNodeProperties('-interactive')

modifyTargetProperties

El mandato modifyTargetProperties sustituye las propiedades de una configuración de destino. Si el destino tiene un agente administrativo, el mandato sólo modifica la propiedad alias. Si el destino no tiene ningún agente administrativo, el mandato sustituye todas las propiedades.

Objeto de destino

Ninguna.

Parámetros necesarios

-targetName
Especifica el nombre del destino de interés. (Serie, obligatorio)
-targetProps
Especifica los pares de propiedad nombre y valor que se van a modificar para el destino de interés. (Properties, obligatorio)

Parámetros opcionales

-replace
Especifica si se van a sustituir las propiedades existentes. Especifique true para sustituir las propiedades existentes. Especifique false para fusionar las propiedades. El valor predeterminado es false. (Booleano, opcional)

Valor de retorno

El mandato no devuelve ninguna salida.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.modifyTargetProperties('-targetName Target1 -targetProps "[alias miNuevoAlias]"')
  • Utilizando la lista de Jython:
    AdminTask.modifyTargetProperties('-targetName', 'Target1', '-targetProps', '[alias miNuevoAlias]')

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.modifyTargetProperties('-interactive')

queryManagedNodes (en desuso)

El mandato queryManagedNodes busca los nodos gestionados en función de una expresión de consulta. Si no especifica ninguna expresión de consulta, el mandato devuelve todos los nodos gestionados.

Objeto de destino

Ninguna.

Parámetros necesarios

-maxReturn
Especifica el número máximo de nodos gestionados que se van a devolver. (Integer, obligatorio)

Parámetros opcionales

-query
Especifica una consulta que está formada por una o más expresiones de consulta separadas por espacios. Si no especifica este parámetro, el mandato devuelve todos los nodos gestionados. (String, opcional)
Genere las consultas de acuerdo con las directrices siguientes:
  • Cada expresión de consulta está formada por los elementos key, operator y value.
  • Los operadores siguientes están soportados:
    Tabla 1. Operadores de queryManagedNodes -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
  • Puede especificar un valor o varios valores separados por comas.
  • Puede utilizar un patrón coincidente para especificar el valor.
-validate
Especifica si se va a validar la consulta de búsqueda. (Booleano, opcional)

Valor de retorno

El mandato devuelve el número de coincidencias que ha encontrado la consulta. En segundo lugar, el mandato devuelve una lista de los nodos gestionados que cumplen el criterio de la consulta de búsqueda.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.queryManagedNodes('-maxReturn 20 -query "managedNodeName=Node1" -validate true')
  • Utilizando la lista de Jython:
    AdminTask.queryManagedNodes(['-maxReturn', '20', '-query', 'managedNodeName=Node1', '-validate', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.queryManagedNodes('-interactive')

queryTargets

El mandato queryTargets busca los destinos en función de una expresión de consulta. Si no especifica ninguna expresión de consulta, el mandato devuelve todos los destinos.

Objeto de destino

Ninguna.

Parámetros necesarios

-maxReturn
Especifica el número máximo de destinos que se van a devolver. (Entero, obligatorio)

Parámetros opcionales

-query
Especifica una consulta que está formada por una o más expresiones de consulta separadas por espacios. Si no especifica este parámetro, el mandato devuelve todos los destinos. (String, opcional)
Genere las consultas de acuerdo con las directrices siguientes:
  • Cada expresión de consulta está formada por los elementos key, operator y value.
  • Los operadores siguientes están soportados:
    Tabla 2. Operadores queryTargets -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
  • Puede especificar un valor o varios valores separados por comas.
  • Puede utilizar un patrón coincidente para especificar el valor.
-validate
Especifica si se va a validar la consulta de búsqueda. (Booleano, opcional)

Valor de retorno

El mandato devuelve el número de coincidencias que ha encontrado la consulta. En segundo lugar, el mandato devuelve una lista de los destinos que cumplen el criterio de la consulta de búsqueda.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.queryTargets('-maxReturn 20 -query "targetName=target1" -validate true')
  • Utilizando la lista de Jython:
    AdminTask.queryTargets(['-maxReturn', '20', '-query', 'targetName=target1', '-validate', 'true'])

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.queryTargets('-interactive')

queryManagedResources

El mandato queryManagedResources consulta los recursos gestionados en busca de los nodos gestionados, en función de una expresión de consulta.

Objeto de destino

Ninguna.

Parámetros necesarios

-maxReturn
Especifica el número máximo de recursos gestionados que se van a devolver. (Entero, obligatorio)

Parámetros opcionales

-query
Especifica una consulta que está formada por una o más expresiones de consulta separadas por espacios. Si no especifica este parámetro, el mandato devuelve todos los nodos gestionados. (String, opcional)
Genere las consultas de acuerdo con las directrices siguientes:
  • Cada expresión de consulta está formada por los elementos key, operator y value.
  • Los operadores siguientes están soportados:
    Tabla 3. Operadores queryManagedResources -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
  • Puede especificar un valor o varios valores separados por comas.
  • Puede utilizar un patrón coincidente para especificar el valor.
-validate
Especifica si se va a validar la consulta de búsqueda. (Booleano, opcional)

Valor de retorno

El mandato devuelve el número de coincidencias que ha encontrado la consulta. En segundo lugar, el mandato devuelve una lista de los UUID de los nodos gestionados que cumplen el criterio de la consulta de búsqueda.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.queryManagedResources('-maxReturn 20 -query "alias=managedNode1"')
  • Utilizando la lista de Jython:
    AdminTask.queryManagedResources('-maxReturn', '20', '-query', '"alias=managedNode1"')

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.queryManagedResources('-interactive')

registerHost

El mandato registerHost define un destino de host remoto para el gestor de trabajos. Utilice el mandato registerHost para:

  • Registrar un destino de host remoto con el gestor de trabajos. A diferencia de los destinos que son perfiles de WebSphere Application Server y se registran utilizando el mandato registerWithJobManager en el gestor de despliegue o el agente administrativo, no es necesario que un destino de host remoto tenga instalado ninguno de los productos WebSphere Application Server. No existe ningún requisito de software para este host a parte de su sistema operativo.
  • Recopile un inventario del host remoto. Tras la ejecución satisfactoria del mandato registerHost, dispondrá de información sobre los recursos gestionados y los tipos de trabajo.

Puede trabajar con destinos de host remoto de la misma forma que registrados utilizando registerWithJobManager, pero los tipos de trabajos disponibles para un destino de host remoto son diferentes.

Objeto de destino

Ninguna.

Parámetros necesarios

-host
Especifica el nombre del sistema remoto que se debe registrar con el gestor de trabajos. (String, necesario)
-hostProps
Especifica las propiedades del host. Puede definir las propiedades que desee. Las propiedades definidas en la tabla afectan al comportamiento del mandato. (Serie, obligatorio)
Tabla 4. Propiedades definidas de registerHost -hostProps. Puede especificar una o más propiedades definidas para el mandato registerHost o especificar propiedades sin definir para el mandato.
Nombre de propiedad Descripción de la propiedad
osType El tipo de sistema operativo. Especifique osType para permitir que el mandato finalice más rápido. Esta propiedad opcional determina los medios para la conexión con el host. Los valores válidos son:
  • aix
  • hpux
  • os400
  • linux
  • solaris
  • windows
  • os390
username Un usuario con autoridad para iniciar sesión en el host. Esta propiedad es obligatoria.
password La contraseña del usuario especificado. Se debe especificar un valor para password o privateKeyFile. Si el host no requiere una contraseña, puede especificar un valor de serie nula mediante "".
privateKeyFile La vía de acceso al archivo de clave privada. Si no especifica un valor para la contraseña, debe especificar un valor para privateKeyFile.
passphrase Una frase se contraseña para privateKeyFile, si es necesaria.
saveSecurity Especifica si se deben almacenar las propiedades de seguridad (username, password, privateKeyFile, passphrase) en el host y si se deben utilizar como valores predeterminados para someter trabajos. Si se asigna un valor de true a esta propiedad, las propiedades de seguridad se almacenan en el host y se utilizan para los posteriores sometimientos de trabajos a este host.

Parámetros opcionales

-imDataLocations
Especifique la vía de acceso completa de las ubicaciones de los datos de Installation Manager. Puede especificar diversas vías de acceso separadas por un signo de punto y coma. Esta propiedad resulta útil si tiene ubicaciones no predeterminadas de los datos de Installation Manager en los destinos. Por ejemplo, si ha especificado las ubicaciones de datos al instalar Installation Manager, es posible que el trabajo de inventario de CIM no encuentre las ubicaciones de datos no predeterminadas. Por consiguiente, es posible que tenga que especificar ubicaciones de datos adicionales al registrar un host. Si se especifica una ubicación de datos no válida, ésta no se guardará. Si la ubicación de datos especificada puede ser detectada por el trabajo de inventario, ésta no se guardará. También puede utilizar el trabajo de búsqueda de ubicación de datos para buscar ubicaciones de datos en el sistema. El trabajo de búsqueda de ubicación de datos actualiza automáticamente esta propiedad. Por ejemplo:
AdminTask.registerHost('[-host hostname -hostProps [ [imDataLocations datalocation1; datalocation2] 
[password ****] [saveSecurity true] [username username] ]]') 
Puede utilizar el mandato registerHost para especificar vías de acceso para las variables de Liberty; por ejemplo:
AdminTask.registerHost('-host hostname -hostProps [ [username admin][password password][saveSecurity true]
 [WLP_WORKING_DIR C:/working][WLP_SHARED_DIR C:/shared][WLP_ADDITIONAL_DIRS C:/addl] ]')

Valor de retorno

El mandato devuelve un inventario del host remoto.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.registerHost('-host mi_host.acme.com -hostProps [ [osType linux][username root]
     [privateKeyFile /root/.ssh/id_dsa] [passphrase mi_frase_contraseña] [saveSecurity true] ]')
  • Utilizando la lista de Jython:
    AdminTask.registerHost('-host', 'myHost.acme.com', '-hostProps', '[ [osType linux] [username root]
     [privateKeyFile /root/.ssh/id_dsa] [passphrase myPassphrase] [saveSecurity true]' ]')

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.registerHost('-interactive')

unregisterHost

El mandato unregisterHost elimina el host remoto del gestor de trabajos.Utilice el mandato unregisterHost para anular del gestor de trabajos el registro de un destino de host remoto. Una vez anulado el registro de host, el gestor de trabajos no puede ejecutar trabajos en el destino.

Objeto de destino

Ninguna.

Parámetros necesarios

-host
Especifica el nombre del sistema remoto cuyo registro se debe anular del gestor de trabajos. (String, necesario)

Parámetros opcionales

Ninguna

Valor de retorno

Ninguna

Ejemplo de utilización de la modalidad por lotes

  • Utilizando la serie Jython:
    AdminTask.unregisterHost('-host mi_host.acme.com')
  • Utilizando la lista de Jython:
    AdminTask.unregisterHost('-host', 'myHost.acme.com')

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.unregisterHost('-interactive')

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_7sysmannode
File name: rxml_7sysmannode.html