Grupo de mandatos WebServicesAdmin para el objeto AdminTask
Puede utilizar los lenguajes de script Jython o Jacl para configurar la seguridad con la herramienta wsadmin. Utilice los mandatos del grupo WebServicesAdmin para listar todos los servicios web, las referencias de servicio y atributos, buscar atributos de un servicio web específico, determinar el punto final de un servicio web y determinar el nombre de operación de un servicio web.
Utilice los mandatos del grupo WebServicesAdmin para consultar información sobre los servicios web instalados. Para obtener más información sobre el objeto AdminTask, consulte la información sobre los mandatos del objeto AdminTask.
getWebService
El mandato getWebService recupera los atributos de un servicio web. Este mandato se aplica sólo a aplicaciones empresariales.
Objeto de destino
Ninguno.
Parámetros necesarios
- -application
- Especifica el nombre de la aplicación empresarial desplegada. (String, obligatorio)
- -module
- Especifica el nombre del módulo. (String, obligatorio)
- -service
- Especifica el nombre del servicio web. (String, obligatorio)
Parámetros opcionales
- -client
- Especifica si el servicio web es un proveedor o un cliente. El valor predeterminado es false (proveedor de servicios). Cuando se establece en true, el mandato sólo devuelve los clientes del servicio web. (Boolean, opcional)
Valor de retorno
Devuelve una lista de atributos, incluido el nombre del servicio, si el servicio es un proveedor o un cliente y el tipo de servicio. El atributo de tipo de servicio sólo se aplica a los proveedores de servicio.
Uso del ejemplo de modalidad de proceso por lotes
AdminTask.getWebService('[–application nombre_aplicación -module nombre_módulo -service nombre_servicio_web
-client false]')
'[[service {http://www.ibm.com}service1][type JAX-WS][client false]]'
Ejemplo de utilización de la modalidad interactiva
AdminTask.getWebService ('-interactive')
listServices
El mandato listServices consulta la configuración de los servicios, los puntos finales y las operaciones. Este mandato proporciona funciones de consulta más genéricas que el resto de los mandatos de este grupo. Se puede aplicar a las aplicaciones de Java, así como a otros activos como los clientes de WSN (Web Services Notification).
Objeto de destino
Ninguno.
Parámetros opcionales
- -queryProps
- Especifica las propiedades utilizadas para ubicar al cliente o el proveedor de servicios de interés. Por ejemplo, si especifica [[type=JAX-WS][client=true]],
el mandato devuelve cada referencia de cliente JAX-WS en las aplicaciones empresariales. (Properties, opcional)El parámetro -queryProps acepta varias propiedades. Puede utilizar una o varias propiedades para especificar sus criterios de consulta. No mezcle las propiedades de consulta entre distintos tipos de activos. Por ejemplo, si especifica application y bus, el mandato informará sobre un error.
- Especifique las propiedades siguientes con el parámetro -queryProps para consultar las aplicaciones empresariales:
Tabla 1. Propiedades para el parámetro -queryProps para aplicaciones empresariales. Utilice estas propiedades para consultar aplicaciones empresariales. Propiedad y valor Descripción assetType=J2EE Application Consulte a cada aplicación de Java EE. application=nombre_aplicación Consulta a una aplicación específica de Java EE. module=nombre_módulo Consulta a una módulo específico de la aplicación Java EE. Debe especificar las propiedades application y module para consultar los módulos de las aplicaciones. - Especifique las propiedades siguientes con el parámetro -queryProps para consultar los clientes WSN:
Tabla 2. Propiedades para consultar los clientes WSN. Utilice estas propiedades para consultar los clientes WSN. Propiedad y valor Descripción assetType=WSN Service Consulta a cada cliente de servicio WSN. bus=nombre_bus Consulta un bus específico. WSNService=nombre_servicio_WSN Consulta un servicio WSN específico. Debe especificar las propiedades bus y WSNService para consultar un servicio WSN específico. - Especifique las propiedades siguientes con el parámetro -queryProps para consultar todos los activos:
Tabla 3. Propiedades para el parámetro -queryProps para consultar todos los activos. Utilice estas propiedades para consultar todos los activos. Propiedad y valor Descripción serviceType=tipo_servicio Consulta por tipo de servicio. Especifique JAX-WS para consultar los activos de JAX-WS (Java API for XML-Based Web Services). Especifique JAX-WS (WSN) para consultar los activos de WSN (Web Services Notification). client=booleano Consultas de clientes o proveedores. Especifique true para consultar clientes. Especifique false para consultar proveedores. service=nombre_servicio Consulta las operaciones y los puntos finales lógicos de un servicio específico. - Especifique las propiedades siguientes con el parámetro -queryProps para consultar todas las referencias de servicio o una referencia de servicio específica cuando client=true:
Tabla 4. Propiedades para el parámetro -queryProps para consultar las referencias de servicio. Utilice estas propiedades para consultar todas las referencias de servicio para clientes de servicio. Propiedad y valor Descripción serviceRef=nombre_refservicio Consultas para una referencia de servicio específica.
También puede utilizar un asterisco (*) como carácter comodín para especificar que se devuelvan todas las referencias de servicio bajo el cliente de servicio coincidente.
- Especifique las propiedades siguientes con el parámetro -queryProps para consultar las aplicaciones empresariales:
- -expandResource
- Especifica si sólo se devuelven nombres de servicio o bien servicios e información detallada de recursos. Especifique logicalEndpoint u operation. Si especifica el valor logicalEndpoint, el mandato devuelve los servicios coincidentes y cada punto final de los servicios. Si especifica el valor operation, el mandato devuelve los servicios coincidentes y los puntos finales y operaciones correspondientes. (String, opcional)
- Puede utilizar el parámetro -expandResource para devolver información detallada de recursos para los puntos finales y operaciones en la referencia de servicio.
Valor de retorno
El mandato devuelve una lista de propiedades de cada servicio, así como información detallada sobre la operación y el punto final si se consultan los puntos finales y las operaciones.
Uso del ejemplo de modalidad de proceso por lotes
[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {http://www.ibm.com}EchoService]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS]
[logicalEndpoint EchoServicePort] ]
[ [service {http://www.ibm.com}PingService] [assetType [J2EE Application]]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {http://www.ibm.com}PingService]
[client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS]
[logicalEndpoint PingServicePort] ]
AdminTask.listServices('[-queryProps [[application MyWSApplication][client false]] -expandResource
logicalEndpoint]')
AdminTask.listServices(['–queryProps', '[[application myApplication][client false]]', '-expandResource',
'logicalEndpoint'])
En los ejemplos siguientes se consulta cada cliente de servicio del bus myBus. Los ejemplos no devuelven las operaciones ni los puntos finales lógicos de cada cliente de servicio porque no especifica el parámetro -expandResource.
AdminTask.listServices('[–queryProps [[bus myBus][client true]] ]')
AdminTask.listServices(['–queryProps', '[[bus myBus][client true]]'])
En los ejemplos siguientes el servicio de consulta hace referencia al nombre testRef para cada cliente de servicio para la aplicación JaxWSServicesSamples. Los ejemplos devuelven información detallada de recursos para los puntos finales lógicos o las operaciones de cada referencia de servicio porque se especifica el parámetro -expandResource.
AdminTask.listServices('[-queryProps [[client true] [application JaxWSServicesSamples] [module SampleClientSei.war]
[serviceRef testRef] -expandResource logicalEndpoint]')
AdminTask.listServices(['-queryProps', '[[application JaxWSServicesSamples][client true][module SampleClientSei.war]
[serviceRef testRef]', '-expandResource', 'logicalEndpoint'])
'[ [serviceRef testRef] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [client true]
[application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ]
[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true]
[service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [logicalEndpoint portA]
[application JaxWSServicesSamples] ]
[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true]
[service {http://www.ibm.com/}TestService] [assetType [J2EE Application]] [logicalEndpoint portB]
[application JaxWSServicesSamples] ]'
Ejemplo de utilización de la modalidad interactiva
AdminTask.listServices('-interactive')
listWebServices
El mandato listWebServices recupera una lista de servicios web disponibles para una o todas las aplicaciones. Si no se proporciona un nombre de aplicación, el mandato lista todos los servicios web. Este mandato se aplica sólo a aplicaciones empresariales.
Objeto de destino
Ninguno.
Parámetros necesarios
Ninguno.
Parámetros opcionales
- -application
- Especifica el nombre de la aplicación empresarial desplegada. Si no especifica este parámetro, el mandato devuelve todos los servicios web de la célula. (String, opcional)
- -client
- Especifica si el servicio web es un proveedor o un cliente. El valor predeterminado es false (proveedor de servicios). Cuando se establece en true, el mandato sólo devuelve los clientes del servicio web. (Boolean, opcional)
Valor de retorno
Todos los servicios web para la aplicación especificada. Para cada servicio web, el mandato devuelve los atributos siguientes y los valores correspondientes: nombre de la aplicación, nombre del módulo, nombre de servicio, si el servicio web es un proveedor de servicios o un cliente y el tipo de servicio. El tipo de servicio sólo se especifica si el servicio web es un proveedor de servicios.
Uso del ejemplo de modalidad de proceso por lotes
AdminTask.listWebServices('[–application application1 -client false]')
AdminTask.listWebServices(['–application', 'application1', '-client', 'false'])
'[[service {http://www.ibm.com}service1][application application1][module webapp1.war][type JAX-WS][client false]]'
Ejemplo de utilización de la modalidad interactiva
AdminTask.listWebServices('-interactive')
listWebServiceEndpoints
El mandato listWebServiceEndpoints devuelve una lista de puntos finales lógicos de un servicio web. El nombre de punto final lógico es el nombre de puerto del documento WSDL (Web Services Description Language. Este mandato se aplica sólo a aplicaciones empresariales.
Objeto de destino
Ninguno.
Parámetros necesarios
- -application
- Especifica el nombre de la aplicación empresarial desplegada. (String, obligatorio)
- -module
- Especifica el nombre del módulo. (String, obligatorio)
- -service
- Especifica el nombre del servicio web. (String, obligatorio)
Parámetros opcionales
- -client
- Especifica si el servicio web es un proveedor o un cliente. El valor predeterminado es false (proveedor de servicios). Cuando se establece en true, el mandato sólo devuelve los clientes del servicio web. (Boolean, opcional)
Valor de retorno
Devuelve el nombre del punto final lógico para el servicio web especificado.
Uso del ejemplo de modalidad de proceso por lotes
AdminTask.listWebServiceEndpoints('[–application nombre_aplicación -module nombre_módulo
-service nombre_servicio_web -client false]')
AdminTask.listWebServiceEndpoints(['–application', 'nombre_aplicación', '-module', 'nombre_módulo', '-service', 'nombre_servicioweb', '-client', 'false'])
'[[logicalEndpoint QuotePort01]]'
Ejemplo de utilización de la modalidad interactiva
AdminTask.listWebServiceEndpoints('-interactive')
listWebServiceOperations
El mandato listWebServiceOperations devuelve una lista de operaciones de servicios web. Este mandato se aplica sólo a aplicaciones empresariales.
Objeto de destino
Ninguno.
Parámetros necesarios
- -application
- Especifica el nombre de la aplicación empresarial desplegada. (String, obligatorio)
- -module
- Especifica el nombre del módulo. (String, obligatorio)
- -service
- Especifica el nombre del servicio web. (String, obligatorio)
- -logicalEndpoint
- El nombre de puerto del documento WSDL (Web Services Description Language). (String, obligatorio)
Parámetros opcionales
- -client
- Si el servicio web es un proveedor o un cliente. El valor predeterminado es false (proveedor de servicios). Cuando se establece en true, el mandato sólo devuelve los clientes del servicio web. (Boolean, opcional)
Valor de retorno
Devuelve el nombre de la operación del servicio web especificado.
Uso del ejemplo de modalidad de proceso por lotes
AdminTask.listWebServiceOperations('[–application nombre_aplicación -module
nombre_módulo -service nombre_servicio_web -client false
-logicalEndpoint endpoint_name]')
AdminTask.listWebServiceOperations(['–application', 'nombre_aplicación', '-module', 'nombre_módulo', '-service', 'nombre_servicioweb', '-client',
'false', '-logicalEndpoint', 'endpoint_name'])
'[[operation ivt_app_op1][operation ivt_app_op2]]'
Ejemplo de utilización de la modalidad interactiva
AdminTask.listWebServiceOperations('-interactive')