Acciones para gestionar modelos de agrupación

Mediante la herramienta bizappscli, puede exportar e importar modelos de agrupación y controlar cómo se ejecutan.

Puede utilizar las siguientes acciones, por ejemplo, cuando se copian modelos de agrupación entre entornos de desarrollo, pruebas o producción.

exportPatterns

Esta acción exporta las definiciones del modelo de agrupación. Puede importarlas posteriormente a otra o a la misma instancia de TADDM. Puede personalizar individualmente la modalidad de exportación de la configuración (la opción -C) y la planificación (la opción -S). Dispone de los siguientes valores:
  • NEVER: la configuración o planificación asociada no se exporta nunca.
  • ALWAYS: la configuración o planificación asociada se exporta siempre.
  • NONDEFAULT: la configuración o planificación asociada se si no es el valor predeterminado.
Están disponibles las siguientes opciones:
  • -C, --configurationExportMode < arg> : define la modalidad de exportación de la configuración. El valor predeterminado es NONDEFAULT.
  • -f, --filename < arg> : define el archivo de destino donde se exportan los patrones. Si no especifica una vía de acceso, el archivo se creará en el directorio de trabajo actual. Si no especifica este archivo, los resultados se mostrarán en la salida estándar.
  • -g, --guid < arg> : define el GUID del patrón.
  • -n, --name < arg> : define el nombre del patrón.
  • -S, --scheduleExportMode < arg> : define la modalidad de exportación de la planificación. El valor predeterminado es NONDEFAULT.
Por ejemplo, para exportar un modelo de agrupación con el nombre gp2 a un archivo new_pattern.xml pero sin una planificación, ejecute la herramienta del modo siguiente:
bizappscli.sh exportPatterns -n gp2 -f new_pattern.xml -S NEVER

importPatterns

Esta acción carga las definiciones del modelo de agrupación, que se han exportado a un archivo XML. Si es necesario, las definiciones contienen planificaciones y configuraciones. Puede personalizar la modalidad de importación del modelo (la opción -I) y la planificación (la opción -S) y la configuración (la opción -C). La siguiente lista contiene los valores disponibles.
Nota: En la siguiente descripción de los valores disponibles, el objeto representa un patrón, planificación o configuración, en función de la opción que utilice.
  • DEFAULT: para la planificación y configuración, esta opción adjunta el modelo a un objeto predeterminado. Los datos importados se omiten.
  • ATTACH: busca los objetos existentes por su nombre. Si se encuentra el objeto, se asocia al mismo el modelo, la planificación o la configuración. Si no se encuentra el objeto, el mandato falla. Los datos importados se omiten.
  • CREATE: crea un objeto. Si existe un objeto con el mismo nombre, el mandato falla.
  • UPDATE: busca los objetos existentes por su nombre y los actualiza con los datos importados. Si no existe un objeto, se crea.
Están disponibles las siguientes opciones:
  • -C, --configurationImportMode < arg> : define la modalidad de importación de una configuración. El valor predeterminado es CREATE.
  • -f, --filename < arg> : define el archivo de origen desde el que se importan los patrones.
  • -I, --patternImportMode < arg> : define la modalidad de importación de un patrón. El valor predeterminado es CREATE.
  • -r, --filter < arg> : selecciona los patrones que se importan del archivo de origen. El valor de esta opción es el nombre del modelo de agrupación. Opcionalmente, puede utilizar un signo de interrogación (?) y un asterisco (*) como comodín. Por ejemplo, para importar modelos con nombres que comienzan por la letra "c", especifique el valor c*.
  • -S, --scheduleImportMode < arg> : define la modalidad de importación de la planificación. El valor predeterminado es CREATE.
  • -X, --prefix < arg> : define una frase opcional que puede utilizar para añadir un prefijo a los nombres de los patrones, planificaciones y configuraciones importados.
Importante: La opción -f es necesaria.
Por ejemplo, para importar un modelo que ha guardado en el archivo my_pattern.xml, añada al nombre el prefijo 10_Jun, asegúrese de que tenga asignada la planificación predeterminada y ejecute la herramienta de este modo:
bizappscli.sh importPatterns -f my_pattern.xml -X 10_Jun -S DEFAULT

restoreExamplePatterns

Esta acción vuelve a crear las definiciones de modelo de ejemplo disponibles después de la instalación de TADDM. Puede utilizar las siguientes opciones de la modalidad de importación para especificar cómo se han de importar los modelos de ejemplo:
  • -C, --configurationImportMode < arg> : define la modalidad de importación de la configuración. El valor predeterminado es CREATE.
  • -I, --patternImportMode < arg> : define la modalidad de importación del patrón. El valor predeterminado es CREATE.
  • -S, --scheduleImportMode < arg> : define la modalidad de importación de la planificación. El valor predeterminado es CREATE.
  • -X, --prefix < arg> : define una frase opcional que puede utilizar para añadir un prefijo a los nombres de los patrones, planificaciones y configuraciones importados.
Por ejemplo, para restaurar los modelos de agrupación de ejemplo predeterminados y asegurarse de que tienen asignada la configuración predeterminada, ejecute la herramienta de este modo:
bizappscli.sh restoreExamplePatterns -C DEFAULT

listPatterns

Esta acción lista los modelos de agrupación y la información general acerca de los mismos. De forma predeterminada, muestra el ID de grupo de ejecución, el nombre de planificación, el nombre del modelo de agrupación y la hora de la siguiente ejecución del modelo.

Están disponibles las siguientes opciones:
  • -A, --sort: ordena los resultados de los grupos de ejecución y planificaciones.
  • -C, --showConfig: muestra configuraciones de los modelos.
  • -F, --dateFormat < arg> -especifica el formato de fecha. El formato predeterminado es M/d/yy h:mm a, por ejemplo 03/25/15 2:38 PM. Para obtener más información acerca de otros formatos de fecha, consulte la información acerca de la clase Java SimpleDateFormat.
  • -g, --guid < arg> : limita los resultados a un patrón específico.
  • -G, --showGuids: muestra los GUID de los modelos.
  • -N, --hideNames: oculta los nombres de los modelos. Normalmente, esta opción se utiliza con la opción -G.
  • -S, --separator < arg> : define el separador de los valores. El separador predeterminado es un espacio " ".
Por ejemplo, para visualizar información únicamente acerca de un modelo con el GUID 00000000000000000000000000000000 y añadir información de la zona horaria en la hora de la siguiente ejecución del modelo, ejecute la herramienta de este modo:
bizappscli.sh listPatterns -g 00000000000000000000000000000000 -F "M/d/yy h:mm a z" 
Sample output:
EXECUTION_GROUP   SCHEDULE_NAME   PATTERN_NAME   NEXT_EXECUTION_TIME
default   schedule1   my_pattern1   7/16/15 3:38 AM GMT-12:00

showPatternsRunning

Esta acción lista los trabajos que se están ejecutando actualmente en todos los planificadores y las instancias de dichos planificadores. De forma predeterminada, solo se muestra el nombre del modelo de agrupación que se está ejecutando. Están disponibles las siguientes opciones:
  • -G, --showGuids: muestra los GUID de los modelos.
  • -I, --showServerID: muestra el servidor de procesos.
  • -N, --hideNames: oculta los nombres de los modelos. Normalmente, esta opción se utiliza con la opción -G.
  • -S, --separator < arg> : define el separador de los valores. El separador predeterminado es un espacio " ".
Por ejemplo, el mandato siguiente muestra los GUID y el servidor que procesa los modelos de agrupación. Adicionalmente, se separan los valores con signos de punto y coma (;) para diferenciar los valores que tienen espacios en los nombres.
bizappscli.sh showPatternsRunning -G -I -S ;
Sample output:
00000000000000000000000000000000;my pattern 1;taddmserverA.ibm.com
11111111111111111111111111111111;my pattern 2;taddmserverB.ibm.com
22222222222222222222222222222222;my pattern 3;taddmserverA.ibm.com

runPattern

Esta acción planifica un modelo para que se ejecute inmediatamente después de que una hebra pase a estar disponible. Están disponibles las siguientes opciones:
  • -e, --executionGroupId < arg> : define el nombre del grupo de ejecución desde el que se ejecutan los patrones.
  • -g, --guid < arg> : define el GUID del patrón.
  • -l, --infoLevel < arg> : define el nivel de detalles de los archivos de registro. Dispone de los siguientes valores:
    • NOINFO: sin información.
    • DEFAULT: información acerca de cómo iniciar y detener la aplicación empresarial únicamente.
    • GENERAL: la información DEFAULT y los datos del CI de núcleo.
    • DETAILS: la información GENERAL y los detalles de ruta de cruce de motor de composición.
    • MAXINFO: nivel de detalle máximo, actualmente el mismo que para el nivel DETAILS.
    Si no especifica ningún valor, el nivel de detalles es el mismo que en la configuración de modelo de agrupación que se ejecuta.
  • -n, --name < arg> : define el nombre del patrón.
  • -w, --wait: define si se ha de esperar hasta que finalice la ejecución del modelo. El valor predeterminado de esta opción es false.
Importante: Se necesita una de las opciones siguientes: -e, -go -n.
Por ejemplo, para planificar el modelo con el nombre my pattern 5 de modo que se ejecute cuando haya una hebra disponible, y establecer los detalles del archivo de registro a su nivel más alto, ejecute la herramienta de este modo:
bizappscli.sh runPattern -n "my pattern 5" -l MAXINFO

stopPatternRun

Esta acción detiene el trabajo que se está ejecutando actualmente. Están disponibles las siguientes opciones:
  • -g, --guid < arg> : define el GUID del patrón que desea detener.
  • -n, --name < arg> : define el nombre del patrón que desea detener.
Importante: Es necesaria una de las opciones siguientes: -go -n.
Por ejemplo, para detener un modelo con el GUID 00000000000000000000000000000000, ejecute la herramienta de este modo:
bizappscli.sh stopPatternRun -g 00000000000000000000000000000000

deletePatterns

Esta acción elimina uno o varios modelos. Adicionalmente, se borran todas las ejecuciones planificadas en el futuro. Están disponibles las siguientes opciones:
  • -f, --filter < arg> : define los nombres de los patrones que se van a eliminar. Opcionalmente, puede utilizar un signo de interrogación (?) y un asterisco (*) como comodín. Por ejemplo, para importar modelos con nombres que comienzan por la letra "c", especifique el valor c*.
  • -g, --guid < arg> : define el GUID del patrón que desea eliminar.
Importante: Es necesaria una de las opciones siguientes: -fo -g.
Por ejemplo, para eliminar todos los modelos de agrupación que tienen nombres que comienzan por la letra "p", ejecute la herramienta de este modo:
bizappscli.sh deletePattern -f p*