Entorno de modalidad interactiva de los mandatos administrativos utilizando scripts wsadmin
Un mandato administrativo puede ejecutarse en modalidad interactiva si se especifica la opción -interactive en la cadena de opciones al invocar el mandato.
Puede proporcionar otras opciones incluso si utiliza la opción interactiva. Los valores de las opciones especificados se aplican al mandato antes de que los datos del mandato se visualicen. Con independencia de si se visualizan otras opciones, la herramienta wsadmin guía al usuario paso a paso en el uso del mandato para recopilar la información del mandato.
- Recopile las entradas de usuario para los objetos de destino y los parámetros.
- Si el mandato no incluye un paso, se muestra el menú de ejecución del mandato para ejecutar o cancelar el mandato.
- Si el mandato incluye un paso, se muestra el menú para seleccionar el paso. Cuando se han especificado todas las entradas necesarias, el menú incluye la ejecución del mandato.
- Cuando se ha seleccionado un paso, si el paso soporta la recopilación, se mostrará el menú para seleccionar el objeto en la recopilación y puede salir del paso. Si sale del paso, repita los pasos del 1 al 3.
- Recopile entradas de usuario para el paso o el objeto seleccionados en la recopilación.
- Repita los pasos 4 y 5 si se encuentra en el menú de pasos de recopilación
- Repita los pasos del 3 al 5 si se encuentra en el menú de selección de pasos
Dependiendo de qué área de entrada esté habilitada por un mandato administrativo, puede seguir toda la secuencia del flujo interactivo o sólo parte de la misma. Si un mandato administrativo se ejecuta en modalidad interactiva, la sintaxis para la ejecución del mandato, excepto la supresión del objeto de recopilación en la modalidad por lotes, se genera y se anota como mensaje WASX7278I en la sesión interactiva y en el archivo de rastreo de wsadmin.
Recopile las entradas de usuario para los objetos de destino y los parámetros.
El indicador interactivo siguiente se utiliza para recopilar entradas para las áreas de entrada Objeto de destino y Argumentos que aparecen en la ayuda específica del mandato:
Título del mandato
Descripción del mandato
*título objeto destino [valor actual o por omisión]:
*título parám1 (nombre parám1) [opción1, opción2, ...]: [valor actual/por omisión]
título parám2 (nombre parám2) [opción1, opción2, ...]: [valor actual/por omisión]
...
Mostrar el menú de ejecución del mandato
Si un mandato administrativo no contiene ningún paso, se presentará el menú siguiente después de recopilar los valores del objeto de destino y los parámetros:
Command title
F (Finalizar)
C (Cancelar)
Seleccione [F, C]: F
La opción Finalizar ejecuta el mandato y la opción Cancelar lo cancela. La selección por omisión es F (Finalizar). Este es el último menú que se visualiza en el caso de un mandato sin pasos para salir de la modalidad interactiva mediante la opción de cancelación o la ejecución del mandato.
Mostrar el menú de selección y ejecución de pasos del mandato
Si un mandato administrativo contiene pasos, se mostrará el menú siguiente después de recopilar los valores del objeto de destino y los parámetros:
Command title
Descripción del mandato
-> *1. título paso1 (nombre paso1)
2. título paso2 (nombre paso2)
*3. título paso3 (nombre paso3)
(4. título paso4 (nombre paso4))
…
n. título pason (nombre pason)
S (Seleccionar)
S (Siguiente)
A (Anterior)
F (Finalizar)
C (Cancelar)
A (Ayuda)
Seleccione [S, N, P, F, C, H]: S
El número de pasos que aparece en el menú depende del mandato administrativo. El nombre del paso se ofrece como información y es el nombre que se utiliza para establecer los datos de este paso en la modalidad por lotes. La notación que se indica a continuación se utiliza para la descripción de un paso:
- Un signo “->” antes del paso indica la posición actual del paso.
- Un signo “*” antes del paso indica un paso obligatorio.
- Un signo ( ) encerrando todo el paso indica que el paso está inhabilitado. No puede llegar a este paso utilizando las opciones Siguiente o Anterior.
Con el menú, puede acceder a los pasos de forma secuencial seleccionando Anterior o Siguiente. La opción Seleccionar selecciona el paso actual, Finalizar ejecuta el mandato, Cancel cancela el mandato y Ayuda proporciona la ayuda en línea para ese mandato. No todas las opciones están disponibles. Por ejemplo, la opción Anterior no está disponible si se encuentra en el primer paso. La opción Siguiente no está disponible si se encuentra en el último paso. Finalizar no está disponible si todavía falta información de entrada obligatoria. La selección por omisión es S (Seleccionar) si el paso actual es válido y aún quedan pasos que precisan entradas obligatorias. La opción por omisión es F (Finalizar) si se proporcionan todas las entradas obligatorias para los pasos.
Para los mandatos con pasos, puede salir de la modalidad interactiva en este menú mediante la opción de cancelación o la ejecución del mandato.
Mostrar el menú de pasos de recopilación
Un paso puede o no dar soporte a la recopilación. Una recopilación se refiere a objetos del mismo tipo. En un mandato administrativo, una recopilación contiene objetos que tienen el mismo conjunto de parámetros. Si se selecciona un paso que soporta recopilación, la herramienta wsadmin mostrará el menú siguiente para añadir y seleccionar un objeto de la recopilación:
Título del paso (nombre del paso)
| titulo parám1 clave (nombre parám1 clave), titulo parám2 clave (nombre parám2 clave), ...
---------------------------------------------------------------------------
-> | objeto1 valor parám1 clave, valor parám2 clave, ...
*| objeto2 valor parám1 clave, valor parám2 clave, ...
...
titulo parám1 clave, titulo parám2 clave, ... deben proporcionarse para especificar una
fila en modalidad por lotes.
S (Seleccionar fila)
S (Siguiente)
A (Anterior)
A (Añadir fila o Añadir fila antes)
S (Suprimir fila)
F (Finalizar)
A (Ayuda)
Seleccione [S, N, P, A, D, F, H]: F
El número de objetos que aparece en el menú depende del paso del mandato. Los parámetros clave se identifican por el paso a utilizar para que identifiquen de forma exclusiva un objeto en una recopilación. Los valores de los parámetros clave se visualizan para identificar el objeto que debe seleccionarse. Como en el menú de selección de pasos del mandato, se utiliza una flecha (->) para indicar la posición del objeto actual y un asterisco (*) para indicar que falta la entrada obligatoria en el objeto.
Utilice el menú para navegar por los objetos de forma secuencial seleccionando Anterior o Siguiente. La opción Seleccionar fila selecciona el objeto actual, Añadir fila añade un objeto nuevo, Añadir fila antes añade un objeto nuevo antes del objeto actual, Suprimir fila suprime el objeto actual, Finalizar devuelve el control al menú de selección y ejecución de pasos, y Ayuda proporciona ayuda en línea para el paso. No todas las opciones están disponibles. La opción Anterior no estará disponible si no hay ningún objeto en la recopilación o si el primer objeto es el actual. La opción Siguiente no estará disponible si no hay ningún objeto en la recopilación o si el objeto actual es el último. Seleccionar fila está disponible sólo si existe un objeto actual. Añadir fila sólo se proporciona si no hay ningún objeto en la recopilación y el paso admite añadir nuevos objetos. Añadir fila antes se proporciona si el paso admite añadir un nuevo objeto y la recopilación contiene objetos existentes. Suprimir fila sólo se proporciona si hay un objeto actual y el paso soporta suprimir un objeto. Finalizar no está disponible si todavía falta información obligatoria en algún objeto. La opción por omisión es A (Añadir fila) si no hay ningún objeto en la recopilación y el paso admite añadir nuevos objetos. La selección por omisión es S (Seleccionar fila) si hay un objeto actual y aún quedan objetos que precisen entradas obligatorias. La opción por omisión es F (Finalizar) si no falta ninguna entrada obligatoria en ningún objeto.
Recopilar entradas de usuario para parámetros de un objeto de recopilación
Después de que se ha seleccionado un objeto de recopilación, el valor del parámetro para cada parámetro se indica de forma secuencial como se muestra en el ejemplo siguiente:
*título parám1 (nombre parám1) [opción1, opción2, ...]: [valor actual/por omisión]
título parám2 (nombre parám2) [opción1, opción2, ...]: [valor actual/por omisión]
...
El número de parámetros depende del número de argumentos del área Argumento de la ayuda específica del paso del mandato. Se utiliza la misma notación de asterisco (*) para denotar un parámetro necesario. Si el valor de un parámetro está restringido a un conjunto de valores, se muestran las opciones válidas. Si el valor actual o el valor predeterminado está disponible, se muestra. Para cada parámetro que se puede escribir, puede aceptar el valor existente pulsando Intro. Para añadir o cambiar un valor existente, entre un valor nuevo y pulse Intro. En el caso de los parámetros de sólo lectura, se muestra el parámetro y su valor. No se le proporcionará la opción de modificar su valor. Después de pasar por todos los parámetros, la herramienta wsadmin vuelve al menú de pasos de recopilación.
Recopile las entradas de usuario para pasos sin recopilación
Este paso tiene dos partes. La primera parte muestra los valores de los parámetros actuales o por omisión del paso seleccionado, tal como se muestra en el ejemplo siguiente:
Título del paso (nombre del paso)
*título parám1 (nombre parám1) [opción1, opción2, ...]: [valor actual/por omisión]
título parám2 (nombre parám2) [opción1, opción2, ...]: [valor actual/por omisión]
...
Seleccione [C (Cancelar), E (Editar)]: [E]
En esta parte no se incluye ninguna solicitud. Por el contrario, esta parte es más bien una función de ayuda que le proporciona información sobre los parámetros del paso seleccionado. El número de parámetros depende del número de argumentos del área argument de la ayuda específica del paso del mandato. La notación de asterisco (*) denota un parámetro necesario. Si el valor de un parámetro está restringido a un conjunto de valores, se muestran las opciones válidas. Si el valor actual o el valor predeterminado está disponible, se muestra. Puede elegir cancelar el paso o continuar con la parte siguiente para proporcionar entradas de parámetro. La selección predeterminada es Edit. Como es posible que vea valores predeterminados asignados a nuevos datos que no se han establecido en el paso, puede aceptar la selección por omisión para continuar con la parte siguiente. De lo contrario, si no existen datos en el paso seleccionado, la selección de Cancelar no da como resultado la creación de datos.
Si acepta la selección Editar por omisión, recopile las entradas de parámetros del usuario de forma secuencial, como Recopilar entradas de usuario para parámetros de un objeto de recopilación.
*título param1 (nombre param1) [opción1, opción2, ...]: [valor actual/por omisión]
título parám2 (nombre parám2) [opción1, opción2, ...]: [valor actual/por omisión]
...
Para cada parámetro que se puede escribir, puede aceptar el valor existente pulsando Intro. Para añadir o cambiar un valor existente, entre un valor nuevo y pulse Intro. En el caso de los parámetros de sólo lectura, se muestra el parámetro y su valor. No se le proporcionará la opción de modificar el valor del parámetro. Tan pronto como pase por todos los parámetros, la herramienta wsadmin le llevará de nuevo al menú de ejecución y selección de pasos del mandato.