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.

- completeObjectName
- getAttribute
- getAttribute_jmx
- getAttributes
- getAttributes_jmx.
- getCell
- getConfigId
- getDefaultDomain
- getDomainName
- getHost
- getMBeanCount
- getMBeanInfo_jmx.
- getNode
- getObjectInstance
- getPort
- getPropertiesForDataSource (en desuso)
- getType
- help
- invoke
- invoke_jmx
- isRegistered
- isRegistered_jmx
- makeObjectName
- queryMBeans
- queryNames
- queryNames_jmx
- reconnect
- setAttribute
- setAttribute_jmx
- setAttributes
- setAttributes_jmx
- startServer
- stopServer
- testConnection
- trace
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.
- 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
'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
'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
'[ [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
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:
set threadpoolCID [$AdminControl getConfigId node=mynode,type=ThreadPool,*]
set serverConfigId [$AdminControl getConfigId node=SY1,type=Server,*]
- Utilizando Jython:
threadpoolCID = AdminControl.getConfigId('node=mynode,type=ThreadPool,*')
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
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
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
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
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
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
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
javax.management.modelmbean.RequiredModelMBean
Ejemplos
- Utilizando Jacl:
Utilice el siguiente ejemplo para manipular el valor de retorno del mandato getObjectInstance:set server [$AdminControl completeObjectName type=Server,*] set serverOI [$AdminControl getObjectInstance $server]
puts [$serverOI getClassName]
- Utilizando Jython:
Utilice el siguiente ejemplo para manipular el valor de retorno del mandato getObjectInstance:server = AdminControl.completeObjectName('type=Server,*') serverOI = AdminControl.getObjectInstance(server)
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
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
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
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
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
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: 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
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
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
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:
Utilice el siguiente ejemplo para manipular el valor de retorno del mandato queryMBeans:set apps [$AdminControl queryMBeans type=Application,* [java::null]]
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:
Utilice el siguiente ejemplo para manipular el valor de retorno del mandato queryMBeans:apps = AdminControl.queryMBeans('type=Application,*',None)
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
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
[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
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
'[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
'[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
- 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
- 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
- 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 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.

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
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
- 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
- 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
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')