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 esNONDEFAULT.-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 esNONDEFAULT.
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 NEVERimportPatterns
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 esCREATE.-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 esCREATE.-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 valorc*.-S,--scheduleImportMode< arg> : define la modalidad de importación de la planificación. El valor predeterminado esCREATE.-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 DEFAULTrestoreExamplePatterns
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 esCREATE.-I,--patternImportMode< arg> : define la modalidad de importación del patrón. El valor predeterminado esCREATE.-S,--scheduleImportMode< arg> : define la modalidad de importación de la planificación. El valor predeterminado esCREATE.-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 DEFAULTlistPatterns
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 esM/d/yy h:mm a, por ejemplo03/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 JavaSimpleDateFormat.-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:00showPatternsRunning
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.comrunPattern
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ónDEFAULTy los datos del CI de núcleo.DETAILS: la informaciónGENERALy los detalles de ruta de cruce de motor de composición.MAXINFO: nivel de detalle máximo, actualmente el mismo que para el nivelDETAILS.
-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 00000000000000000000000000000000deletePatterns
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 valorc*.-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*