Mandatos del objeto AdminControl con scripts wsadmin

Utilice el objeto AdminControl para invocar mandatos operativos que gestionan objetos para el servidor de aplicaciones.

Muchos de los mandatos AdminControl tienen varias signaturas, por lo tanto se pueden invocar en la modalidad sin procesar con parámetros especificados mediante JMX (Java Management Extensions) o utilizando series para parámetros. Además de los mandatos operativos, el objeto AdminControl da soporte a algunos mandatos de rastreo, reconexión con un servidor y conversión de tipos de datos.

Avoid trouble Avoid trouble: Al utilizar los mandatos disponibles en el objeto AdminControl en grandes topologías, consulta y búsqueda con process=dmgr y type=Cluster. Este método de búsqueda es más eficaz, consume menos tiempo y evita la búsqueda en todos los nodos.gotcha

completeObjectName

Utilice el mandato completeObjectName para crear una representación de serie de un valor ObjectName basado en un fragmento. Este mandato no se comunica con el servidor para encontrar los valores de ObjectName coincidentes. Si el sistema encuentra varios MBeans que coinciden con el fragmento, el mandato devuelve el primero.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto que se ha de completar. (ObjectName)
plantilla
Especifica el nombre de la plantilla que se debe utilizar. Por ejemplo, la plantilla puede ser type=Server,*. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato no devuelve ninguna salida.

Ejemplos

  • Utilizando Jacl:
    set serverON [$AdminControl completeObjectName node=mynode,type=Server,*] 
  • Utilizando Jython:
    serverON = AdminControl.completeObjectName('node=mynode,type=Server,*')

getAttribute

Utilice el mandato getAttribute para devolver el valor del atributo correspondiente al nombre que especifica.

Si utiliza el mandato getAttribute para determinar el estado de una aplicación, se devuelve uno de los siguientes valores:
  • 0 - que indica que la aplicación se está iniciando
  • 1 - que indica que la aplicación se ha iniciado
  • 2 - que indica que la aplicación se está deteniendo
  • 3 - que indica que la aplicación se ha detenido
  • 4 - que indica que la aplicación no se ha podido iniciar

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)
attribute
Especifica el nombre del atributo que se ha de consultar. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el valor del atributo que consulta, como se muestra en el ejemplo siguiente:
'DeploymentManager'

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
    $AdminControl getAttribute $objNameString processType 
  • Utilizando Jython:
    objNameString = AdminControl.completeObjectName('WebSphere:type=Server,*') 
    print AdminControl.getAttribute(objNameString, 'processType')

getAttribute_jmx

Consulte el mandato getAttribute_jmx para devolver el valor del atributo del nombre que proporciona.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)
attribute
Especifica el nombre del atributo que se ha de consultar. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el valor del atributo que consulta, como se muestra en el ejemplo siguiente:
'DeploymentManager'

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
    set objName [java::new javax.management.ObjectName $objNameString]
    $AdminControl getAttribute_jmx $objName processType
  • Utilizando Jython:
    objNameString = AdminControl.completeObjectName('WebSphere:=type=Server,*') 
    import  javax.management  as  mgmt 
    objName =  mgmt.ObjectName(objNameString) 
    print AdminControl.getAttribute_jmx(objName, 'processType')

getAttributes

Utilice el mandato getAttributes para devolver los valores de atributos de los nombres que proporciona.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)
attribute
Especifica el nombre de los atributos que se han de consultar. (java.lang.String[] o java.lang.Object[])

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el valor del atributo que consulta, como se muestra en el ejemplo siguiente:
'[ [cellName myCell01] [nodeName myCellManager01] ]'

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
    $AdminControl getAttributes $objNameString "cellName nodeName"
  • Utilizando Jython con atributos de serie:
    objNameString = AdminControl.completeObjectname('WebSphere:type=Server,*)
    print AdminControl.getAttributes(objNameString, '[cellName nodeName]')
  • Utilizando Jython con atributos de objeto:
    objNameString = AdminControl.completeObjectname('WebSphere:type=Server,*)
    print AdminControl.getAttributes(objNameString, ['cellName', 'nodeName'])

getAttributes_jmx.

Utilice el mandato getAttributes_jmx para devolver los valores de atributos de los nombres que proporciona.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)
attribute
Especifica el nombre de los atributos que se han de consultar. (java.lang.String[] o java.lang.Object[])

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una lista de atributos.

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName WebSphere:type=Server,*]
    set objName [$AdminControl makeObjectName $objectNameString]
    set attrs [java::new {String[]} 2 {cellName nodeName}] 
    $AdminControl getAttributes_jmx $objName $attrs
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('type=Server,*') 
    objName = AdminControl.makeObjectName(objectNameString)
    attrs = ['cellName', 'nodeName']
    print AdminControl.getAttributes_jmx(objName, attrs)

getCell

Utilice el mandato getCell para obtener el nombre de la célula conectada.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve el nombre de la célula que consulta, como se muestra en el ejemplo siguiente:
Mycell

Ejemplos

  • Utilizando Jacl:
    $AdminControl getCell
  • Utilizando Jython:
    print AdminControl.getCell()

getConfigId

Utilice el mandato getConfigId para crear un ID de configuración a partir de un ObjectName o de un fragmento de un ObjectName. Cada MBean no tiene objetos de configuración correspondientes. Si varios MBeans se corresponden con un fragmento de ObjectName, se creará un aviso y un ID de configuración para el primer MBean que encuentre el sistema.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto de interés. La serie del nombre de objeto puede ser un comodín, especificado un carácter de asterisco (*).

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el ID de configuración de interés.

Ejemplos

  • Utilizando Jacl:
    [AIX Solaris HP-UX Linux Windows]
    set threadpoolCID [$AdminControl getConfigId node=mynode,type=ThreadPool,*]  
    [z/OS]
    set serverConfigId [$AdminControl getConfigId node=SY1,type=Server,*]
  • Utilizando Jython:
    [AIX Solaris HP-UX Linux Windows]
    threadpoolCID = AdminControl.getConfigId('node=mynode,type=ThreadPool,*')
    [z/OS]
    serverConfigId = AdminControl.getConfigId('node=SY1,type=Server,*')

getDefaultDomain

Utilice el mandato getDefaultDomain para obtener el nombre de dominio predeterminado del servidor.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el nombre de dominio predeterminado de interés, como se muestra en el ejemplo siguiente:
WebSphere

Ejemplos

  • Utilizando Jacl:
    $AdminControl getDefaultDomain 
  • Utilizando Jython:
    print AdminControl.getDefaultDomain()

getDomainName

Utilice el mandato getDomainName para obtener el nombre de dominio del servidor.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el nombre de dominio de interés, como se muestra en el ejemplo siguiente:
WebSphere

Ejemplos

  • Utilizando Jacl:
    $AdminControl getDomainName
  • Utilizando Jython:
    print AdminControl.getDomainName()

getHost

Utilice el mandato getHost para obtener el nombre del host.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el nombre del host de interés, como se muestra en el ejemplo siguiente:
myHost

Ejemplos

  • Utilizando Jacl:
    $AdminControl getHost
  • Utilizando Jython:
    print AdminControl.getHost()

getMBeanCount

Utilice el mandato getMBeanCount para obtener el número de MBean registrados en el servidor.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un valor de entero que contiene el número de los MBean registrados en el servidor, como se muestra en el ejemplo siguiente:
151

Ejemplos

  • Utilizando Jacl:
    $AdminControl getMBeanCount 
  • Utilizando Jython:
    print AdminControl.getMBeanCount()

getMBeanInfo_jmx.

Utilice el mandato getMBeanInfo_jmx para obtener la estructura MBeanInfo JMX (Java Management Extension) que corresponde a un valor de ObjectName. No existe ninguna signatura de serie para este mandato, porque el objeto Help muestra la mayor parte de la información disponible del mandato getMBeanInfo_jmx.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un objeto javax.management.MBeanInfo, como se muestra en el ejemplo siguiente:
javax.management.modelmbean.ModelMBeanInfoSupport@10dd5f35

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName type=Server,*] 
    set objName [$AdminControl makeObjectName $objectNameString]
    $AdminControl getMBeanInfo_jmx $objName 
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('type=Server,*') 
    objName = AdminControl.makeObjectName(objectNameString)
    print AdminControl.getMBeanInfo_jmx(objName)

getNode

Utilice el mandato getNode para obtener el nombre del nodo conectado.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el nombre del nodo, como se muestra en el ejemplo siguiente:
myNode01

Ejemplos

  • Utilizando Jacl:
    $AdminControl getNode
  • Utilizando Jython:
    print AdminControl.getNode()

getObjectInstance

Utilice el mandato getObjectInstance para obtener la instancia de objeto coincide con el nombre de objeto de entrada.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto de interés. (ObjectName)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve la instancia del objeto que coincide con el nombre del objeto de entrada, como se muestra en el ejemplo siguiente:
javax.management.modelmbean.RequiredModelMBean

Ejemplos

  • Utilizando Jacl:
    set server [$AdminControl completeObjectName type=Server,*]
    set serverOI [$AdminControl getObjectInstance $server]
    Utilice el siguiente ejemplo para manipular el valor de retorno del mandato getObjectInstance:
    puts [$serverOI getClassName]
  • Utilizando Jython:
    server = AdminControl.completeObjectName('type=Server,*')
    serverOI = AdminControl.getObjectInstance(server)
    Utilice el siguiente ejemplo para manipular el valor de retorno del mandato getObjectInstance:
    print serverOI.getClassName()

getPort

Utilice el mandato getPort para obtener el nombre del puerto que se utiliza para la conexión de script.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve el número de puerto del puerto que utiliza el sistema para establecer la conexión de script, como se muestra en el ejemplo siguiente:
8877

Ejemplos

  • Utilizando Jacl:
    $AdminControl getPort
  • Utilizando Jython:
    print AdminControl.getPort()

getPropertiesForDataSource (en desuso)

El mandato getPropertiesForDataSource está en desuso y no existe un sustituto. Este mandato asume incorrectamente la disponibilidad de un servicio de configuración cuando se ejecuta en modalidad conectada.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve el mensaje siguiente:
WASX7389E: Operación no soportada - el mandato getPropertiesForDataSource no está soportado.

Ejemplos

  • Utilizando Jacl:
    set ds [lindex [$AdminConfig list DataSource] 0] 
    $AdminControl getPropertiesForDataSource $ds
  • Utilizando Jython:
    ds = AdminConfig.list('DataSource')
    
    # get line separator 
    import  java.lang.System  as sys
    lineSeparator = sys.getProperty('line.separator')
    
    dsArray = ds.split(lineSeparator)
    print AdminControl.getPropertiesForDataSource(dsArray[0])

getType

Utilice el mandato getType para obtener el tipo de conexión utilizado para la conexión de script.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene el tipo de conexión para la conexión de script, como se muestra en el ejemplo siguiente:
SOAP

Ejemplos

  • Utilizando Jacl:
    $AdminControl getType
  • Utilizando Jython:
    print AdminControl.getType()

help

Utilice el mandato help para devolver el texto de ayuda general para el objeto AdminControl.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

mandato
Especifica el mandato para el que se devuelve la información de ayuda. El nombre de mandato no distingue entre mayúsculas y minúsculas.

Salida de ejemplo

El mandato devuelve una serie que describe detalladamente las opciones específicas del mandato help, como se muestra en el ejemplo siguiente:
WASX7027I: El objeto AdminControl permite la manipulación de los MBeans que se ejecutan en un proceso de WebSphere Application Server. El número y el tipo de los MBean
disponibles para el cliente de script dependen del servidor al que se conecta el cliente.
Si el cliente está conectado a un gestor de despliegue, todos los MBeans que se ejecutan en el gestor de despliegue
estarán visibles, así como todos los MBeans que se ejecuten en el nodo agentsthat estarán conectados a este gestor de despliegue  y todos los MBeans que se ejecuten en los servidores de aplicaciones de dichos nodos. 
El objeto AdminControl da soporte a los mandatos siguientes. Para obtener información más detallada acerca de cada uno 
de estos mandato puede utilizar el mandato "help" del objeto AdminControl y proporcionar el nombre del 
mandato como un argumento.

Muchos de estos mandato dan soporte a dos conjuntos de signaturas: uno que acepta y devuelve serie y otro 
conjunto de nivel inferior que trabaja con objetos JMX como ObjectName y AttributeList. En la mayor parte de las situaciones, 
las signaturas resultarán probablemente más útiles pero también se proporcionan versiones de signaturas de objetos JMX.  Cada uno de
En los mandatos de signaturas de objetos JMX se añade "_jmx" al nombre de mandato, de modo que se da soporte a un mandato "invoke" y también a un mandato 
"invoke_jmx".

completeObjectName		Devuelve una versión de serie de un nombre de objeto dado un nombre de plantilla
getAttribute_jmx			 Dados ObjectName y el nombre de atributo, devuelve el valor de atributo
getAttribute        Dados ObjectName y el nombre de atributo, devuelve el valor de atributo
getAttributes_jmx			Dados ObjectName y la matriz de nombres de atributos, devuelve AttributeList
getAttributes   			 Dados la versión de serie de ObjectName y los nombres de atributos, devuelve una serie con los pares de nombre y valor
getCell         			 Devuelve el nombre de célula del servidor conectado
getConfigId     			 Dada la versión de serie de ObjectName, devuelve un ID de configuración para la configuración correspondiente 
																				si lo hay.
getDefaultDomain			Devuelve "WebSphere"
getDomainName      Devuelve "WebSphere"
getHost            Devuelve la representación de serie del host conectado
getMBeanCount   			Devuelve el número de beans registrados
getMBeanInfo_jmx			Dado ObjectName, devuelve la estructura de MBeanInfo para MBean
getNode         			Devuelve el nombre de nodo del servidor conectado
getPort            Devuelve la representación de serie del puerto en uso
getType         			Devuelve la representación de serie del tipo de conexión que se utiliza
help	help				      Muestra información de ayuda
invoke_jmx      			Dados ObjectName, el nombre del mandato, la matriz de parámetros y la signatura, el mandato invoke
										en el MBean especificado
invoke          			Invoca un mandato en el MBean especificado
isRegistered_jmx			Es true si el ObjectName proporcionado está registrado
isRegistered       Es true si la versión de serie suministrada de ObjectName está registrada
makeObjectName  			Devuelve un ObjectName creado con la serie proporcionada
queryNames_jmx  			Dados ObjectName y QueryExp, recupera el conjunto de ObjectNames que coinciden
queryNames         Dada la versión de serie de ObjectName, recupera la serie de ObjectNames que coinciden.
reconnect       			Vuelve a conectar con serversetAttribute_jmx. Dados ObjectName y el objeto Attribute,
										establece el atributo para el MBean especificado 
setAttribute    			Dados la versión de serie de ObjectName, el nombre y el valor del atributo, establece el atributo para
										en el MBean especificado
setAttributes_jmx		Dados ObjectName y el objeto AttributeList, establece los atributos para el MBean especificado
startServer     			Dado el nombre de un servidor, inicia dicho servidor
stopServer      			Dado el nombre de un servidor, detiene dicho servidor
testConnection  			Prueba la conexión con un objeto DataSource 
trace           			Establece la especificación de rastreo de wsadmin
Si especifica un mandato específico con el mandato help, la herramienta wsadmin devuelve ayuda detallada acerca del mandato, como se muestra en el ejemplo siguiente:
WASX7043I: Mandato: getAttribute
Argumentos: nombre de objeto, atributo
Descripción: Devuelve el valor de "atributo" del MBean descrito por el "nombre
de objeto"

Ejemplos

  • Utilizando Jacl:
    $AdminControl help 
    $AdminControl help getAttribute 
  • Utilizando Jython:
    print AdminControl.help()
    print AdminControl.help('getAttribute')

invoke

Utilice el mandato invoke para invocar una operación MBean específica basándose en el número de parámetros que requiere la operación. Si esta restricción no es suficiente para seleccionar una operación exclusiva, utilice invoke_jmx. Los parámetros suministrados se convierten en los tipos de objetos requeridos por la firma de la operación seleccionada antes de que se invoque la operación. Los valores devueltos se convierten en su representación de serie.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés.
operation
Especifica la operación que se ha de invocar.

Parámetros opcionales

argumentos
Especifica los argumentos necesarios para la operación. Si no se necesitan argumentos para la operación de interés, puede omitir el parámetro de argumentos.

El parámetro arguments es una sola serie. Cada argumento individual de la serie puede contener espacios.

Salida de ejemplo

El mandato devuelve una serie que muestra el resultado de la invocación.

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
    $AdminControl invoke $objNameString stop
    set objNameString [$AdminControl completeObjectName WebSphere:type=DynaCache,*] 
    $AdminControl invoke $mbean getCacheStatistics {"DiskCacheSizeInMB ObjectsReadFromDisk4000K RemoteObjectMisses"}
    Avoid trouble Avoid trouble: Asegúrese de que la variable mbean, $mbean, se ha definido antes de emitir el mandato anterior gotcha
  • Utilizando Jython:
    objNameString = AdminControl.completeObjectName('WebSphere:type=Server,*') 
    print AdminControl.invoke(objNameString, 'stop')
    objNameString = AdminControl.completeObjectName("WebSpheretype=DynaCache,*")
    		AdminControl.invoke(dc, "getCacheStatistics", '["DiskCacheSizeInMB ObjectReadFromDisk4000K RemoteObjectMisses"]')
  • Utilizando la lista Jython:
    objNameString = AdminControl.completeObjectName("WebSphere:type=DynaCache,*") 
    AdminControl.invoke(dc, "getCacheStatistics", [["DiskCacheSizeInMB", "ObjectReadFromDisk4000K", 
    "RemoteObjectMisses"]])

invoke_jmx

Utilice el mandato invoke_jmx para invocar la operación de objeto ajustando la lista de parámetros a la signatura. El mandato devuelve el resultado de la invocación.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)
operation
Especifica la operación que se ha de invocar. (java.lang.String)

Parámetros opcionales

argumentos
Especifica los argumentos necesarios para la operación. Si no se necesitan argumentos para la operación de interés, puede omitir el parámetro de argumentos. (java.lang.String[] o java.lang.Object[])

Salida de ejemplo

El mandato devuelve una serie que muestra el resultado de la invocación.

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
    set objName [java::new javax.management.ObjectName $objNameString] 
    set parms [java::new {java.lang.Object[]} 1 com.ibm.ejs.sm.*=all=disabled] 
    set signature [java::new {java.lang.String[]} 1 java.lang.String] 
    $AdminControl invoke_jmx $objName $parms $signature
  • Utilizando Jython:
    objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
    import  javax.management  as  mgmt 
    objName =  mgmt.ObjectName(objNameString) 
    parms = ['com.ibm.ejs.sm.*=all=disabled'] 
    signature = ['java.lang.String'] 
    print AdminControl.invoke_jmx(objName, parms, signature)

isRegistered

Utilice el mandato isRegistered para determinar si se ha registrado un nombre de objeto específico.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre de objeto de interés. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un valor booleano para el objeto de interés. Si el valor de ObjectName se ha registrado en el servidor, entonces el valor es 1, como se muestra en el ejemplo siguiente:
wsadmin>s = AdminControl.queryNames( 'type=Server,*' ).splitlines()[ 0 ]
wsadmin>AdminControl.isRegistered( s )
1
wsadmin>

Si el valor de ObjectName no se ha registrado en el servidor, entonces el valor es 0.

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=Server,*] 
    $AdminControl isRegistered $objNameString 
  • Utilizando Jython:
    objNameString = AdminControl.completeObjectName('WebSphere:type=Server,*') 
    print AdminControl.isRegistered(objNameString)

isRegistered_jmx

Utilice el mandato isRegistered_jmx para determinar si se ha registrado un nombre de objeto específico.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre de objeto de interés. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un valor booleano para el objeto de interés. Si el valor de ObjectName se ha registrado en el servidor, entonces el valor es true, como se muestra en el ejemplo siguiente:
true

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName type=Server,*] 
    set objName [$AdminControl makeObjectName $objNameString]
    $AdminControl isRegistered_jmx $objName 
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('type=Server,*') 
    objName = AdminControl.makeObjectName(objectNameString)
    print AdminControl.isRegistered_jmx(objName)

makeObjectName

Utilice el mandato makeObjectName para crear un valor de ObjectName que está basado en la entrada de serie. Este mandato no se comunica con el servidor, por lo tanto, es posible que no exista el valor de ObjectName resultante. Si la serie especificada contiene un conjunto de dobles comillas adicional, se eliminará. Si la serie no empieza por un dominio JMX (Java Management Extensions) o una serie seguida de dos puntos, entonces el WebSphere Application Server se anexa al nombre la serie.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre de objeto de interés. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un objeto Objectname creado a partir de la serie de nombre de objeto.

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName type=Server,node=mynode,*]
    set objName [$AdminControl makeObjectName $objNameString]
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('type=Server,node=mynode,*')
    objName = AdminControl.makeObjectName(objectNameString)

queryMBeans

Utilice el mandato queryMBeans para consultar una lista de instancias de objeto que coinciden con el nombre de objeto que ha suministrado.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre de objeto de interés. (ObjectName)

Parámetros opcionales

query
Especifica la expresión de consulta. (QueryExp)

Salida de ejemplo

El mandato devuelve una lista de las instancias de objetos para el nombre de objeto especificado, como se muestra en el ejemplo siguiente:
WebSphere:name=PlantsByWebSphere,process=server1,platform=dynamicproxy,node=Goodog,
J2EEName=PlantsByWebSphere,Server=server1,version=6.1.0.0,type=Application,
mbeanIdentifier=cells/GooddogNode02Cell/applications/PlantsByWebSphere.ear/
deployments/PlantsByWebSphere/deployment.xml#ApplicationDeployment_1126623343902,
cell=GooddogNode02Cell

Ejemplos

  • Utilizando Jacl:
    set apps [$AdminControl queryMBeans type=Application,*]
    Utilice el siguiente ejemplo para manipular el valor de retorno del mandato queryMBeans:
    set appArray [$apps toArray]
    set app1 [java::cast javax.management.ObjectInstance [$appArray get 0]]
    puts [[$app1 getObjectName] toString]
    El ejemplo siguiente especifica el nombre de objeto y la expresión de consulta:
    set apps [$AdminControl queryMBeans type=Application,* [java::null]]
    Utilice el siguiente ejemplo para manipular el valor de retorno del mandato queryMBeans:
    set appArray [$apps toArray]
    set app1 [java::cast javax.management.ObjectInstance [$appArray get 0]]
    puts [[$app1 getObjectName] toString] 
  • Utilizando Jython:
    apps = AdminControl.queryMBeans('type=Application,*')
    Utilice el siguiente ejemplo para manipular el valor de retorno del mandato queryMBeans:
    appArray = apps.toArray()
    app1 = appArray[0]
    print app1.getObjectName().toString()
    El ejemplo siguiente especifica el nombre de objeto y la expresión de consulta:
    apps = AdminControl.queryMBeans('type=Application,*',None)
    Utilice el siguiente ejemplo para manipular el valor de retorno del mandato queryMBeans:
    appArray = apps.toArray()
    app1 = appArray[0]
    print app1.getObjectName().toString()

queryNames

utilice el mandato queryNames para consultar una lista de cada uno de los objetos ObjectName basados en la plantilla de nombres.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre de objeto de interés. Puede especificar un comodín para el parámetro de nombre de objeto con el carácter asterisco (*). (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene los ObjectName que coinciden con el nombre del objeto de entrada, como se muestra en el ejemplo siguiente:
WebSphere:cell=BaseApplicationServerCell,
name=server1,mbeanIdentifier=server1,
type=Server,node=mynode,process=server1 

Ejemplos

  • Utilizando Jacl:
    $AdminControl queryNames WebSphere:type=Server,* 
  • Utilizando Jython:
    print AdminControl.queryNames('WebSphere:type=Server,*')

queryNames_jmx

Utilice el mandato queryNames_jmx para consultar una lista de cada uno de los objetos ObjectName basados en la plantilla de nombres y en las condiciones de consulta que especifique.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre de objeto de interés. Puede especificar un comodín para el parámetro de nombre de objeto con el carácter asterisco (*). (ObjectName)
query
Especifica la expresión de consulta que se ha de utilizar. (javax.management.QueryExp)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una serie que contiene los ObjectName que coinciden con el nombre del objeto de entrada, como se muestra en el ejemplo siguiente:
[WebSphere:cell=BaseApplicationServerCell,name=server1,mbeanIdentifier=
server1,type=Server,node=mynode,process=server1] 

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName type=Server,*] 
    set objName [$AdminControl makeObjectName $objNameString]
    set null [java::null]
    $AdminControl queryNames_jmx $objName $null
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('type=Server,*') 
    objName = AdminControl.makeObjectName(objectNameString)
    print AdminControl.queryNames_jmx(objName, None)

reconnect

Utilice el mandato reconnect para volver a conectarse con el servidor y borrar la información de la memoria caché local.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguno.

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un mensaje que muestra el estado de la operación, como se muestra en el ejemplo siguiente:
WASX7074I: Ha finalizado la reconexión del conector SOAP con el host myhost.

Ejemplos

  • Utilizando Jacl:
    $AdminControl reconnect 
  • Utilizando Jython:
    print AdminControl.reconnect()

setAttribute

Utilice el mandato setAttribute para establecer el valor del atributo para el nombre que proporcione.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (java.lang.String)
nombre de atributo
Especifica el nombre del atributo que se ha de establecer. (java.lang.String)
valor de atributo
Especifica el valor del atributo de interés. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato no devuelve ninguna salida.

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
    $AdminControl setAttribute $objNameString traceSpecification com.ibm.*=all=disabled 
  • Utilizando Jython:
    objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
    print AdminControl.setAttribute(objNameString, 'traceSpecification',  'com.ibm.*=all=disabled')

setAttribute_jmx

Utilice el mandato setAttribute_jmx para establecer el valor del atributo para el nombre que proporcione.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (ObjectName)
attribute
Especifica el nombre del atributo que se ha de establecer. (Attribute)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato no devuelve ninguna salida.

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
    set objName [$AdminControl makeObjectName $objectNameString]
    set attr [java::new javax.management.Attribute traceSpecification com.ibm.*=all=disabled] 
    $AdminControl setAttribute_jmx $objName $attr 
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*')
    import  javax.management  as  mgmt
    objName = AdminControl.makeObjectName(objectNameString)
    attr = mgmt.Attribute('traceSpecification', 'com.ibm.*=all=disabled')
    print AdminControl.setAttribute_jmx(objName, attr)

setAttributes

Utilice el mandato setAttributes para establecer los valores de atributos para los nombres de objetos que proporcione.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (String)
attributes
Especifica los nombres de los atributos que se han de establecer. (java.lang.String[] o java.lang.Object[])

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una lista de los nombres de objetos que se han establecido correctamente al invocar el mandato, como se muestra en el ejemplo siguiente:
'[traceSpecification com.ibm.ws.*=all=enabled]'

Ejemplos

  • Utilizando Jacl:
    set objNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
    $AdminControl setAttributes $objNameString {{traceSpecification com.ibm.ws.*=all=enabled}} 
  • Utilizando Jython con atributos de serie:
    objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
    AdminControl.setAttributes(objNameString, '[[traceSpecification "com.ibm.ws.*=all=enabled"]]')
  • Utilizando Jython con atributos de objeto:
    objNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*') 
    print AdminControl.setAttributes(objNameString, [['traceSpecification', 'com.ibm.ws.*=all=enabled']])

setAttributes_jmx

Utilice el mandato setAttributes_jmx para establecer los valores de atributos para los nombres de objetos que proporcione.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de objeto
Especifica el nombre del objeto del MBean de interés. (String)
attributes
Especifica los nombres de los atributos que se han de establecer. (javax.management.AttributeList)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve una lista de atributos de los nombres de objetos que se han establecido correctamente al invocar el mandato, como se muestra en el ejemplo siguiente:
'[traceSpecification com.ibm.ws.*=all=enabled]'

Ejemplos

  • Utilizando Jacl:
    set objectNameString [$AdminControl completeObjectName WebSphere:type=TraceService,*] 
    set objName [$AdminControl makeObjectName $objectNameString] 
    set attr [java::new javax.management.Attribute traceSpecification com.ibm.ws.*=all=enabled] 
    set alist [java::new javax.management.AttributeList] 
    $alist add $attr 
    $AdminControl setAttributes_jmx $objName $alist
  • Utilizando Jython:
    objectNameString = AdminControl.completeObjectName('WebSphere:type=TraceService,*')
    import  javax.management  as  mgmt 
    objName = AdminControl.makeObjectName(objectNameString) 
    attr = mgmt.Attribute('traceSpecification', 'com.ibm.ws.*=all=enabled') 
    alist = mgmt.AttributeList() 
    alist.add(attr)
    print AdminControl.setAttributes_jmx(objName, alist)

startServer

Utilice el mandato startServer para iniciar el servidor de aplicaciones especificado localizándolo en la configuración. Este mandato utiliza el tiempo de espera predeterminado. Utilice las siguientes directrices para determinar los parámetros que se han de utilizar:
  • Si el proceso de script está asociado a un servidor del agente de nodos, debe especificar el nombre del servidor. También puede especificar los parámetros opcionales de tiempo de espera y nombre de nodo.
  • Si el proceso de script está asociado a un proceso de gestor de despliegue, debe especificar el nombre del servidor y el nombre del nodo. También puede especificar el parámetro opcional de tiempo de espera.

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de servidor
Especifica el nombre del servidor que se va a iniciar. (java.lang.String)

Parámetros opcionales

nombre de nodo
Especifica el nombre del nodo de interés. (java.lang.String)
tiempo de espera
Especifica el número de segundos que espera el proceso de inicio a que se inicie el servidor. El tiempo de espera predeterminado es de 1200 segundos. (java.lang.String)

Salida de ejemplo

El servidor se ha iniciado. Esperando el estado de inicialización. Servidor server1 abierto para e-business; el ID de proceso es 1932.

Ejemplos

Utilizando Jacl:
  • El ejemplo siguiente especifica únicamente el nombre del servidor que se ha de iniciar:
    $AdminControl startServer server1
  • El ejemplo siguiente especifica el nombre del servidor que se ha de iniciar y el tiempo de espera:
    $AdminControl startServer server1 100
  • El ejemplo siguiente especifica el nombre del servidor que se ha de iniciar y el nombre del nodo:
    $AdminControl startServer server1 myNode
  • El ejemplo siguiente especifica el nombre del servidor, el nombre del nodo y el tiempo de espera:
    $AdminControl startServer server1 myNode 100
Utilizando Jython:
  • El ejemplo siguiente especifica únicamente el nombre del servidor que se ha de iniciar:
    AdminControl.startServer('server1')
  • El ejemplo siguiente especifica el nombre del servidor que se ha de iniciar y el tiempo de espera:
    AdminControl.startServer('server1', 100)
  • El ejemplo siguiente especifica el nombre del servidor que se ha de iniciar y el nombre del nodo:
    AdminControl.startServer('server1', 'myNode')
  • El ejemplo siguiente especifica el nombre del servidor, el nombre del nodo y el tiempo de espera:
    AdminControl.startServer('server1', 'myNode', 100)

stopServer

Utilice el mandato stopServer para detener el servidor de aplicaciones especificado. Cuando se ejecuta el mandato stopServer sin los distintivos inmediate o terminate, el servidor finaliza cualquier trabajo que esté en proceso pero no acepta ningún trabajo nuevo una vez comenzado el proceso de detención. Utilice las opciones siguientes para determinar los parámetros que ha de utilizar:
  • Utilice los parámetros de nombre de servidor y nombre de nodo para detener un servidor de un nodo específico.
  • Utilice el parámetro de nombre de servidor y el distintivo inmediate para detener el servidor inmediatamente. Si no se especifica este parámetro, el sistema detiene el servidor con normalidad.
  • Utilice los parámetros de nombre de servidor, nombre de nodo y el distintivo inmediate para detener inmediatamente un servidor para un nodo específico.
Avoid trouble Avoid trouble: Un mensaje de error se emite si sólo especifica el nombre de servidor cuando intenta detener dicho servidor. gotcha

Objeto de destino

Ninguno.

Parámetros necesarios

nombre de servidor
Especifica el nombre del servidor que se va a iniciar. (java.lang.String)

Parámetros opcionales

nombre de nodo
Especifica el nombre del nodo de interés. (java.lang.String)
distintivo inmediate
Especifica que se ha de detener el servidor inmediatamente si el valor se establece en immediate. Si especifica el distintivo inmediate, el servidor no finaliza el proceso de ningún trabajo que esté en progreso, ni acepta ningún trabajo nuevo ni finaliza el proceso del servidor. (java.lang.String)
distintivo terminate
Especifica que el proceso del servidor lo debe finalizar el sistema operativo. (String)

Salida de ejemplo

El mandato devuelve un mensaje para indicar si el servidor se detiene correctamente, como muestra el ejemplo siguiente:
WASX7337I: Se ha invocado que el servidor "server1" se detenga. Esperando que se complete.
'WASX7264I: Ha terminado de concluirse el servidor "server1" en el nodo "myNode"'

Ejemplos

Utilizando Jacl:
  • El ejemplo siguiente especifica únicamente el nombre del servidor que se ha detener:
    $AdminControl stopServer server1
  • El ejemplo siguiente especifica el nombre del servidor que se ha de detener e indica que el servidor se debe detener inmediatamente:
    $AdminControl stopServer server1 immediate
  • El ejemplo siguiente especifica el nombre del servidor que se ha de detener y el nombre del nodo:
    $AdminControl stopServer server1 myNode
  • El ejemplo siguiente especifica el nombre del servidor, el nombre del nodo e indica que el servidor se ha de detener inmediatamente:
    $AdminControl stopServer server1 myNode immediate
Utilizando Jython:
  • El ejemplo siguiente especifica el nombre del servidor que se ha de detener e indica que el servidor se debe detener inmediatamente:
    AdminControl.stopServer('server1','immediate')
  • El ejemplo siguiente especifica el nombre del servidor que se ha de detener y el nombre del nodo:
    AdminControl.stopServer('server1','myNode')
  • El ejemplo siguiente especifica el nombre del servidor, el nombre del nodo e indica que el servidor se ha de detener inmediatamente:
    AdminControl.stopServer('server1','myNode','immediate')

testConnection

Utilice el mandato testConnection para probar una conexión con el origen de datos. Este mandato funciona con el origen de datos que reside en el repositorio de configuración. Si el origen de datos que se va a probar está en el espacio de trabajo temporal que contiene la actualización en el repositorio, deberá guardar la actualización en el repositorio de configuración antes de ejecutar este mandato. Utilice este mandato con el ID de configuración que corresponde al origen de datos y a los tipos de objetos WAS40DataSource.

Objeto de destino

Ninguno.

Parámetros necesarios

ID de configuración
Especifica el ID de configuración del objeto de origen de datos de interés. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato devuelve un mensaje que indica una conexión correcta o una conexión con un aviso. Si la conexión falla, se crea una excepción desde el servidor para indicar el error. Por ejemplo:
WASX7217I: La conexión al origen de datos proporcionado ha sido satisfactoria.

Ejemplos

  • Utilizando Jacl:
    set ds [lindex [$AdminConfig list DataSource] 0] 
    $AdminControl testConnection $ds
  • Utilizando Jython:
    # get line separator 
    import  java.lang.System  as sys
    lineSeparator = sys.getProperty('line.separator')
    ds = AdminConfig.list('DataSource').split(lineSeparator)[0]
    print AdminControl.testConnection(ds)

trace

Utilice el mandato trace para establecer la especificación de rastreo para el proceso de script en el valor que especifique.

Objeto de destino

Ninguno.

Parámetros necesarios

especificación de rastreo
Especifica el rastreo para habilitar el proceso de script. (java.lang.String)

Parámetros opcionales

Ninguno.

Salida de ejemplo

El mandato no devuelve ninguna salida.

Ejemplos

  • Utilizando Jacl:
    $AdminControl trace com.ibm.ws.scripting.*=all=enabled
  • Utilizando Jython:
    print AdminControl.trace('com.ibm.ws.scripting.*=all=enabled')

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_admincontrol
File name: rxml_admincontrol.html