Obtención de ayuda en línea mediante scripts wsadmin
Puede seleccionar tres niveles de ayuda en línea para mandatos administrativos.
Antes de empezar
Inicie la herramienta wsadmin.
Acerca de esta tarea
El nivel superior proporciona información general para el objeto AdminTask y los mandatos asociados con él. El segundo nivel proporciona información acerca de todos los mandatos y grupos de mandatos administrativos disponibles. El tercer nivel de ayuda proporciona ayuda específica para un grupo de mandatos, para un mandato o para un paso. La ayuda específica para un grupo de mandatos proporciona descripciones del grupo de mandatos que especifique y de los mandatos que pertenecen al grupo asociado. La ayuda específica del mandato proporciona una descripción del mandato especificado, de sus parámetros y de sus pasos. La ayuda específica de pasos proporciona una descripción del paso específico y de los parámetros asociados. Si desea ayuda específica para un paso o un mandato, los parámetros necesarios llevan la marca (*) en la salida de la ayuda.
Procedimiento
- Para obtener ayuda general, ejecute el mandato help. Utilizando Jacl:
$AdminTask help
Utilizando Jython:print AdminTask.help()
Resultado de ejemplo:WASX8001I: El objeto AdminTask permite la ejecución de los mandatos de administración. Los mandatos de AdminTask funcionan en dos modalidades: la modalidad predeterminada es aquélla en la que AdminTask se comunica con el servidor WebSphere para llevar a cabo la tarea. También está disponible una modalidad local, en la que no se lleva a cabo ninguna comunicación con el servidor. La modalidad local de operación se invoca activando el cliente de scripts utilizando la opción de línea de mandatos "-conntype NONE" o establezca la propiedad "com.ibm.ws.scripting.connectiontype=NONE" en el archivo wsadmin.properties. El número de mandatos de administración varía y depende de la instalación de WebSphere. Utilice los siguientes mandatos de ayuda para obtener una lista de los mandatos soportados y sus parámetros: help -commands Lista todos los mandatos de administración help -commands <pattern> Lista los mandatos de administración que coinciden con el comodín "pattern" help -commandGroups lista todos los grupos de mandatos de administración help -commandGroups <pattern> Lista los grupos de mandatos de administración que coinciden con el comodín "pattern" help commandName Muestra información detallada acerca del mandato especificado help commandName stepName Muestra información detallada acerca del paso especificado perteneciente al mandato especificado help commandGroupName Muestra información detallada para el grupo de mandatos especificado Hay distintos modos de invocar un mandato de administración: commandName Invoca un mandato de administración que no requiere ningún argumento. commandName targetObject Invoca un mandato de administración con la serie del objeto de destino, por ejemplo, el nombre del objeto de configuración de un adaptador de recursos. El objeto de destino esperado varía con cada mandato administrativo. Utilice el mandato help para obtener información sobre el objeto de destino de un mandato admin. commandName options Invoca un mandato de administración con las series de opciones especificadas. Esta sintaxis de invocación se utiliza para invocar un mandato de administración que no requiera un objeto de destino. También se utiliza para entrar en modalidad interactiva si se incluye la modalidad "-interactive" en la serie de opciones. commandName targetObject options Invoca un mandato de administración con el objeto de destino y las series de opciones especificados. Si se incluye "-interactive " en la serie de opciones, se entra en modalidad interactiva. El objeto de destino y las series de opciones varían según el mandato administrativo invocado. Utilice el mandato de ayuda para obtener información sobre el objeto de destino y las opciones.
- Para listar los grupos de mandatos disponibles, ejecute el mandato help con el parámetro -commandGroups. Utilizando Jacl:
$AdminTask help -commandGroups
Utilizando Jython:print AdminTask.help('-commandGroups')
Resultado de ejemplo:WASX8005I: Grupos de mandatos de administración disponibles: AdminAgentNode - Tareas relacionadas del nodo gestionado por el agente de administración AdminAgentSecurityCommands - Mandatos utilizados para configurar los elementos relacionados con la seguridad durante el registro del agente de administración. AdminReports - Informes de configuración de la administración AdminSDKCmds - Mandatos de administración relacionados con los SDK conectables AdministrativeJobs - Este grupo de mandatos contiene todos los mandatos de gestión de trabajos . AppManagementCommands - Mandatos de gestión de aplicaciones. ...
- Para listar los mandatos disponibles, ejecute el mandato help con el parámetro -commands. Utilizando Jacl:
$AdminTask help -commands
Utilizando Jython:print AdminTask.help('-commands')
Resultado de ejemplo:WASX8004I: Mandatos de administración disponibles: copyResourceAdapter - Copia el adaptador de recursos de J2C especificado en el ámbito especificado. createCluster - Crea un nuevo clúster de servidores de aplicaciones. createClusterMember - Crea un nuevo miembro de un clúster de servidores de aplicaciones. createJ2CConnectionFactory - Crea una fábrica de conexiones J2C deleteCluster - Suprime la configuración de un clúster de servidores de aplicaciones. deleteClusterMember - Suprime un miembro de un clúster de servidores de aplicaciones. listConnectionFactoryInterfaces - lista todas las interfaces de fábricas de conexiones definidas en el adaptador de recursos de J2C especificado. listJ2CConnectionFactories - Lista las fábricas de conexiones J2C que tienen una interfaz de fábrica de conexiones especificada definida en el adaptador de recursos de J2C especificado createJ2CAdminObject - Crea un objeto administrativo J2C. listAdminObjectInterfaces - Lista todas las interfaces de objetos administrativas definidas en el adaptador de recursos de J2C especificado. adminobject en el adaptador de recursos J2C especificado. listJ2CAdminObjects - Lista los objetos administrativos J2C que tienen una interfaz de objetos administrativos especificada definida en el adaptador de recursos de J2C especificado. createJ2CActivationSpec - Crea una especificación de activación J2C. listMessageListenerTypes - Lista todos los tipos de messageListener definidos en el adaptador de recursos de J2C especificado. listJ2CActivationSpecs - Lista las especificaciones de activación J2C que tienen un tipo de escucha de mensajes especificada definida en el adaptador de recursos de J2C especificado.
- Para obtener ayuda acerca de un grupo de mandatos, ejecute el mandato help con el nombre de grupo. Utilizando Jacl:
$AdminTask help JCAManagement
Utilizando Jython:print AdminTask.help('JCAManagement')
Resultado de ejemplo:WASX8007I: Ayuda detallada sobre el grupo de mandatos: JCAManagement Descripción: grupo de mandatos administrativos que le ayudan a configurar recursos relacionados con J2C (Java 2 Connector Architecture). Mandatos: createJ2CConnectionFactory - Crea una fábrica de conexiones J2C listConnectionFactoryInterfaces - Lista todas las interfaces de fábricas conexiones definidas en el adaptador de recursos de J2C especificado. listJ2CConnectionFactories - Lista las fábricas de conexiones J2C que tienen una interfaz de fábrica de conexiones especificada definida en el adaptador de recursos de J2C especificado. createJ2CAdminObject - Crea un objeto administrativo J2C. listAdminObjectInterfaces - Lista todas las interfaces de objetos administrativas definidas en el adaptador de recursos J2C especificado. listJ2CAdminObjects - Lista los objetos administrativos J2C que tienen una interfaz de objetos administrativos especificada definida en el adaptador de recursos de J2C especificado. createJ2CActivationSpec - Crea una especificación de activación J2C. listMessageListenerTypes - Lista todos los tipos de escucha de mensajes definidos en el adaptador de recursos de J2C especificado. listJ2CActivationSpecs - Lista las especificaciones de activación J2C que tienen un tipo de escucha de mensaje especificado definido en el adaptador de recursos de J2C especificado. copyResourceAdapter - copia el adaptador de recursos J2C especificado en el ámbito especificado.
- Para obtener ayuda acerca de un mandato de administración, ejecute ejecute el mandato help con el nombre del parámetro. Utilizando Jacl:
$AdminTask help createJ2CConnectionFactory
Utilizando Jython:print AdminTask.help('createJ2CConnectionFactory')
Resultado de ejemplo:En la salida de la ayuda de cada uno de los mandatos indicados anteriormente, un mandato de administración de divide en tres áreas de entrada: objeto de destino, argumentos y pasos. Los datos que es necesario especificar en cada área dependerán del mandato de administración. Si un área precisa de entrada, cada entrada se describe por su nombre y descripción; excepto para el área de objeto de destino que sólo contiene la descripción del objeto de destino. Cuando utiliza un mandato de administración en modalidad de proceso por lotes, puede utilizar como nombre de argumento cualquier nombre de entrada que resida en el área de argumentos.WASX8006I: Ayuda detallada sobre el mandato: createJ2CConnectionFactory Descripción: Crea una fábrica de conexiones J2C *Objeto de destino: Adaptador de recursos de J2C padre de la fábrica de conexiones J2C creada. Argumentos: *connectionFactoryInterface - interfaz de fábrica de conexiones definida en la descripción adaptador de recursos de J2C especificado padre. *name: nombre de la fábrica de conexiones J2C. *jndiName: nombre JNDI de la fábrica de conexiones J2C creada. description: descripción de la fábrica de conexiones J2C creada. authDataAlias: alias de datos de autenticación de la fábrica de conexiones J2C creada. Pasos: Ninguno
El signo * precediendo al nombre indica que se precisa una entrada. Si no se precisa de una entrada, se indica mediante Ninguna. En el ejemplo siguiente se utiliza la salida de ayuda para el mandato createJ2CConnectionFactory:- El área de objeto de destino requiere el nombre del objeto de configuración de un J2CResourceAdapter.
- En el área de argumentos, hay cinco entradas y tres de ellas son necesarias. Los nombres de argumentos son connectionFactoryInterface, name, jndiName, description y authDataAlias. Estos nombres se utilizan como nombres de parámetro en la cadena de opciones para
ejecutar un mandato administrativo en modalidad por lotes, por ejemplo:
Para obtener más información acerca de cómo especificar opciones de argumentos, consulte la sintaxis de invocación del mandato administrativo.-connectionFactoryInterface javax.resource.cci.ConnectionFactory -name newConnectionFactory -jndiName CF/newConnectionFactory
- No hay ningún paso asociado a este mandato administrativo.
- Para obtener ayuda sobre un paso de mandato, utilice la ayuda de cada uno de los pasos: La ayuda específica para un paso proporciona los siguientes datos:
- Descripción del paso de mandato.
- Información que indica si este paso soporta la recopilación. Una recopilación incluye objetos del mismo tipo. En un paso de mandato, una recopilación contiene objetos que tienen el mismo conjunto de parámetros.
- Información sobre cada parámetro de paso con su nombre y descripción. Si se necesita un parámetro de paso, aparece un asterisco (*) precediendo al nombre.
En el siguiente objeto se obtiene ayuda sobre un paso de mandato:
Utilizando Jacl:$AdminTask help createCluster clusterConfig
Utilizando Jython:print AdminTask.help('createCluster', 'clusterConfig')
Resultado de ejemplo:WASX8013I: Ayuda detallada sobre el paso: clusterConfig Descripción: Especifica la configuración del nuevo clúster de servidores. Recopilación: No Argumentos: *clusterName - Nombre del clúster de servidores. preferLocal - Habilita la optimización de direccionamiento con ámbito de nodo para el clúster.
En este ejemplo se indica la siguiente información sobre el paso clusterConfig:- Este paso no da soporte a la recopilación. Sólo un conjunto de valores de parámetro se permite para los parámetros clusterName y perferLocal.
- Este paso contiene dos argumentos de entrada con un argumento indicado como necesario. El argumento necesario es clusterName y el parámetro no necesario es preferLocal. La sintaxis para proporcionar valores de parámetros de pasos es distinta de la sintaxis para proporcionar valores de argumentos de mandatos. Deben proporcionarse todos los valores de un pasos e indicarlos en el orden exacto que se muestra en la ayuda específica del paso. Para los argumentos opcionales para los que no desea especificar un valor, especifique comillas ("") en lugar de un valor. Si un paso del mandato es un tipo de colección, por ejemplo, contiene varios
objetos donde cada objeto tiene el mismo conjunto de parámetros, puede especificar varios objetos con cada uno
de los objetos especificados entre corchetes. Para ejecutar un mandato administrativo en modalidad por lotes en la cadena de opciones, utilice la sintaxis siguiente:
Utilizando Jacl:
-clusterConfig {{newCluster false}}
Utilizando Jython:
Para obtener más información acerca de cómo especificar opciones de parámetros, consulte la sintaxis de invocación del mandato administrativo.-clusterConfig [[newCluster false]]
- Utilice un carácter comodín para buscar la ayuda de un determinado mandato.
Puede utilizar un patrón de expresión Java regular o un patrón de comodín para especificar el nombre del mandato para las funciones AdminTask.help('–commands') y AdminConfig list, types y listTemplates.
- Para utilizar un patrón de expresión Java regular para buscar los nombres de los
mandatos administrativos que empiezan por create, especifique:
print AdminTask.help("-commands", "create.*")
- Para utilizar un patrón de búsqueda de comodín para buscar los nombres de los
mandatos administrativos que empiezan por create, especifique:
print AdminTask.help("-commands", "create*")
- Para utilizar un patrón de expresión Java para buscar los nombres de los
mandatos administrativos que contienen SSLConfig, especifique:
print AdminTask.help("-commands", ".*SSLConfig.*")
- Para utilizar un patrón de búsqueda de comodín para buscar los nombres de los
mandatos administrativos que contienen SSLConfig, especifique:
print AdminTask.help("-commands", "*SSLConfig*")
- Para utilizar un patrón de expresión Java regular para buscar los nombres de los
mandatos administrativos que empiezan por create, especifique:


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_gethelp
File name: txml_gethelp.html