Guía Control-M Versión 9 Distribuido

Entornos Previos Distribuidos 1/27 Versión 1.0.0

Septiembre 2013
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Tabla de contenido
Guía Control-M Versión 9 Distribuido ....................................................................................... 1

1 Introducción ................................................................................................................... 3

1.1 Objetivos del documento................................................................................... 3

1.2 Objetivos de las guías de uso............................................................................. 3
1.3 Acerca de este documento................................................................................. 3
1.4 A quién está dirigido este documento ................................................................ 3
1.5 Registro y control de cambios al Documento..................................................... 4
2 Creación de Job nuevo ..................................................................................................... 5

3 Datos generales de un job. ............................................................................................... 6

4 Calendarización de un job................................................................................................. 7

5 Especificaciones de ejecución del job.................................................................................. 9

6 Condiciones de Entrada y Salida ...................................................................................... 12

7 Manejo de variables en Control-M .................................................................................... 13

8 Manejo de validaciones y acciones en Control-M ................................................................ 13

9 Manejo de mensajes de alerta en Control-M ...................................................................... 16

10 Manejo del Filewatcher................................................................................................... 17

10.1 Búsqueda de 1 único archivo ........................................................................... 17

10.2 Manejo de errores con el file watcher (búsqueda de 1 archivo)....................... 19
11 Escribir los jobs en la tabla de Control-M........................................................................... 20

12 Como ver las mallas en Control-M versión 9. ..................................................................... 24

13 Exportar XML a Control-M versión 9. ................................................................................ 26

Entornos Previos Distribuidos 2/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

1 Introducción
1.1 Objetivos del documento
El objetivo de este documento es oficializar y difundir un grupo de guías de uso que habrán de observarse
en las instalaciones de Informática de América del grupo BBVA.

1.2 Objetivos de las guías de uso

El objetivo del establecimiento de guías de uso en el grupo BBVA es que existan documentos que sir van
de apoyo en la utilización de las herramientas, con el fin de lograr un manejo eficiente resolviendo dudas y
ofreciendo información técnica. Las guías contienen imágenes asociadas al tema descr ito par a una fácil
comprensión, así como los pasos a realizar por el usuario para llevar acabo las distintas opciones
disponibles, usando un lenguaje sencillo.

1.3 Acerca de este documento

El objetivo de este documento es difundir las guías de uso referentes a las diferentes herramientas que se
utilizan en Servicios de Procesamiento América.

1.4 A quién está dirigido este documento

Este documento está dirigido al personal técnico encargado del diseño y desarrollo, que hace uso de las
herramientas administradas por SPA.

Entornos Previos Distribuidos 3/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

1.5 Registro y control de cambios al Documento

Con el fin de llevar el control de movimientos y modificaciones se generara una tabla que integre el
registro y control de todos los cambios necesarios para la optimización y el mejoramiento en el uso y
funcionalidad de los recursos en que viven nuestros sistemas.

Fecha de
Versión. Descripción de Tipo de Paginas
revisión (día- Aprobación
Observación Modificación Actualización Afectadas
mes-año)
1.0.0 14-Febrero- Se actualiza el Cesar García Todas Cesar García
2017 manual con Basulto Basulto
base a los
cambios en la
versión de
Control-M 9
Registro y control de cambios al documento.

Entornos Previos Distribuidos 4/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

2 Creación de Job nuevo

1.-Ingresar a Control-M versión 9, en esta opción vamos desarrollar y correr
nuestras mallas.

Nota: en esta versión ya no se ocupa el Control-M Desktop todo se realiza en el

"Control-M Workload Automation". Y se realiza el desarrollo en la opción "Planning" ingresamos y creamos
un nuevo "Blank Workspace".

2.- En la siguiente opción creamos un nuevo Job seleccionando en la parte superior izquierda en "New" el
template "OS". Como se muestra en la figura, la arrastramos hacía el espacio de trabajo y nos crea el
Folder nuevo con el job tipo "OS".

Entornos Previos Distribuidos 5/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Damos clic sobre Folder para asignar el nombre de la Tabla al mismo. Con la opción "Save" guardamos los
cambios y ponemos el nombre de la Tabla en la opción "Name" y la breve descripción de la aplicación
como se solicita.

Nota: El Nombre del "Parent Table" en la versión 7 ahora en la 9 cambia por el "Folder".

3 Datos generales de un job.

Nota importante: Ningún campo deberá contener acentos o caracteres especiales, ya que esto puede
dañar la integridad de la Base de Datos de Control-M. LOS NOMBRES DE LOS CAMPOS SE DEBEN
DEFINIR CON BASE A L DOCUMENTO ÉSTANDARES CONTROL-M DESARROLLO.

1- Se especifica el nombre del Control-M en el que correrá el job en base al documento de estándares de
Control-M.
2- Se especifica el nombre del job en base al documento de estándares de Control-M.
3- Tipo de job que es (job o comando).
4- Nombre del script (UNIX) o bat (Windows) a ejecutar.
5- Ruta del script o bat que se ejecutará.
6- Ruta completa y el script (en caso de que el job sea configurado como comando).
7- Nombre de la tabla en la que se encuentra el job en base al documento de estándares de Control -M.
8- Se especifica la Aplicación a la que pertenece el job en base al documento de estándares de Control -M.
9- Se especifica el tipo de job, seguido por la vista CCR o BMR respectivamente (ver documento de
estándares de Ctrl-M).
10- Se especifica el usuario aplicativo con el que correrá el script o bat especificado en el campo 4.
11- Se especifica el nombre y apellido de la persona que programo el job (Nombre_PrimerApellido)
12- Breve descripción acerca de lo que realiza el script o bat.

Entornos Previos Distribuidos 6/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

12

4,5,6

10

4 Calendarización de un job
13- Seleccionar días naturales del mes que correrá el job (no se necesita usar calendario)
14- Especificar si el job correrá únicamente en días hábiles, por ejemplo (Primer día hábil D1, Último día
hábil
L1) en este caso si se necesita especificar calendario en el campo 15.
15- Especificar calendario (de la lista existente), en base a las necesidades de la ejecución del job.
16- Seleccionar los meses del año que el job deba ejecutarse.
17- Días de la semana que correrá el job
18- Este campo se llena en automático, al seleccionar los días en el número 17.
19- Especificar calendario (de la lista existente) para que el job se ejecute únicamente en los días
definidos en el mismo.

Nota: Es importante tomar en cuenta los operadores lógicos And y Or.

Or – Para la ejecución del job tomará en cuenta MonthDays o Week Days, es decir se puede ejecutar si se
cumple una u otra.
And – Para la ejecución del job tomará en cuenta la configuración realizada en MonthDays y WeekDays, es
decir se deben cumplir ambas para ejecutarse.

Entornos Previos Distribuidos 7/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

15

13
3

14

19

17

18

16

Entornos Previos Distribuidos 8/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Para revisar como quedo nuestros días configurados, damos clic en la opción "View Schedule" y nos
mostrara el calendario con los días en los que corre el proceso. Esta opción en la versión 7 se veía con el
"Fore Cast".

5 Especificaciones de ejecución del job

20- Hostname del equipo en el que corre el job.
21- Se especifica si el job cargará en espera de confirmación y/o con que prioridad (Su uso debe ser
justificado).
22- Hora de inicio o rango de ejecución, si recibe condición de entrada no se necesita especificar horario.
23- Zona horaria en la que corre el job. Si no se especifica se toma la de default (México DF).
24- Se especifica si será cíclico y en su caso cada cuando se reejecutará el job (Su uso debe ser
justificado).
25- Se especifica las características de cada cuando se re-ejecutará el job cuando aplique.
26- Número de ejecuciones que se efectuarán en caso de que sea cíclico el job.
27- Máximo de días que esperará el job una condición (Máximo permitido 3).

Entornos Previos Distribuidos 9/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

22

24 25

26

Nota: la opción "Node ID/Group" de la versión 7 en la versión 9 se encuentra en la pestaña "General"

como "Host/Host Group:". Y la opción "Wait for confirmation" de la versión 7 está en la pestaña
Prerequisites como "Requires user confirmation".

20

Entornos Previos Distribuidos 10/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

21

25.1- Se utiliza cuando las ejecuciones serán constantes a lo largo del lapso de tiempo que se ejecute el
Job.
25.2- Se utiliza cuando los intervalos para cada ejecución serán diferentes.
25.3- Se utiliza cuando cada ejecución debe ser en horas especificas con intervalos de tiempo diferentes
entre sí.

25.1

25.2

25.3

Entornos Previos Distribuidos 11/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

6 Condiciones de Entrada y Salida

28- Se especifican condiciones locales y/o globales de entrada para ejecución del job.
29- Se especifican condiciones locales y/o globales de salida en caso de que la ejecución termine
correctamente. Nota: Ver Configuración de Condiciones en Control-M dentro de este documento.

Para declarar las condiciones de entrada en la nueva versión en "Prerequisites", tenemos la opción "In
Conditions", damos clic en el signo de más y nos aparece el recuadro como "Condition Details",
declaramos el nombre de la condición y sí se va a tomar con la fecha del día como se muestra en la
imagen 1, esta opción también cuenta con las opciones que se muestran en la imagen 2. Y se selecciona
la opción de borrado de la condición después de que termine el job.

Para las condiciones de salida, en la opción de "Actions" y "Out Conditions" vamos a encontrar la condición
de Entrada la cual se va a remover cuando termine de ejecutarse el job y vamos a definir una más de
salida con el signo de "+", definimos el nombre y los parámetros de "Order Date" y sí se adiciona o
también se borra después de la ejecución.

Entornos Previos Distribuidos 12/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

7 Manejo de variables en Control-M

32- Como se puede observar en el siguiente ejemplo, se define la variable fecha (la cual tendrá mmdd) en
la pestaña de Set (Ver Anexo 1: Variables de Control-M al final del documento).

La opción para las variables la encontramos en la pestaña "General" damos clic al final de las opciones en
More y nos muestra la opción "Variables", damos clic en la opción "+" y adicionamos en este caso la
variable "fecha", como local y el valor de la variable, la cual apunta a que nos muestre el mes y día en la
fecha.

32

8 Manejo de validaciones y acciones en Control-M

34- Validaciones y acciones a tomar según el código de retorno que arroje el job al terminar.

En este caso, si el script ejecutado termina con un código de retorno (CR) “3”, podrá realizar las siguientes
acciones:
Terminará OK. Terminara en error. Rerun al job Detener cíclico Aplicar variable
Enviar mensaje (Shout)
Force un job en especifico o una tabla entera. Realizar alguna acción con el sysout de la ejecución.
Adicionar/eliminar una condición.
Enviar correo.
Levantar un ticket en remedy

Entornos Previos Distribuidos 13/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

En la pestaña de Actions escogemos la opción On-Do Actions. y adicionamos los parámetros para las
distintas variantes con base a como termine nuestro job. Dentro de las opciones que tiene son las
siguientes:

Programemos un mensaje sí es que falla la ejecución del job. Tomamos la opción "Job ended Not OK", en
"Do" "Notify", Destination "Mail" y ponemos los datos del contacto, el asunto y mensaje en Urgency "Very
Urgent" o la opción que amerite y en Attach Output "Yes", para que nos adjunte la salida de la ejecución.

Entornos Previos Distribuidos 14/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Así quedaría el mensaje definido, como se ve en el mensaje.

Entornos Previos Distribuidos 15/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

9 Manejo de mensajes de alerta en Control-M

35- Mensajes de alerta en caso de que el job exceda su tiempo de ejecución o no reciba la condición de
HOST en el horario estipulado. (Estos mensajes de alerta son obligatorios).

En la pestaña Actions y "Notifications before job completion". damos clic en "+", y nos mostrara las
siguientes opciones:

En la siguiente ventana se pueden ver los siguientes parámetros declarados When "Job not finished by
<time>", y en time especificamos el horario cuando este debería de terminar "Specific Time", En este caso
ponemos las 11:00 hrs. El envió de la notificación lo enviamos a la ventana de alertas de control-m
Destination "Alerts Window" y en Message ponemos el mensaje que nos enviara a las consola de alertas
de control-m, en Urgency en este caso lo ponemos como "Very Urgent".

Entornos Previos Distribuidos 16/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

La definición quedaría de la siguiente manera:

10 Manejo del Filewatcher

El uso del filewatcher debe estar justificado y la ventana de búsqueda no debe ser tan amplia, ya que esto
consume recursos del Control-M.

10.1 Búsqueda de 1 único archivo

1.- El job se debe configurar como tipo comando (Command)
2.- En el campo File Name se debe especificar el nombre de archivo a buscar.
3.- En el campo de Path se especifica la ruta donde buscará el FW.
4.- Definir comando ctmfw, ruta, archivo a buscar, y parámetros del FW, los cuales se
especifican a continuación:
- CREATE A B C D E
Donde:
CREATE es el modo del filewatcher. A es el mínimo de bytes a detectar.
B es el intervalo de tiempo en segundos, que el filewatcher realizará la búsqueda del archivo. (Df
60)
C es el intervalo de tiempo que monitoreará el cambio de bytes en el archivo.(Df 10)
D es el número de intentos que comparará el tamaño del archivo con el mínimo detectado.
E es el tiempo máximo en minutos que el proceso estará censando la existencia del archivo.

ctmfw /entornos/ejemplo/ejemplo.txt CREATE 0 60 10 3 15

Entornos Previos Distribuidos 17/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Para poder correr el file Watcher, en What, lo ponemos como "Command" y en la opción Command
declaramos la ruta y el nombre del archivo con los parámetros de tiempo con el que vamos a comprobar
los datos. El usuario sigue siendo el "ag700" esto para la funcionalidad de file watcher y se declara en la
opción "Run As"

Entornos Previos Distribuidos 18/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

10.2 Manejo de errores con el file watcher (búsqueda de 1 archivo)

Cuando se utilice la búsqueda de 1 archivo con el file watcher, es necesario configurar en la pestaña
Steps del job el manejo del código de retorno (CR) 7 que es cuando no encuentra archivo, esto es para
que no cancele el job.

La configuración debe realizarse como se muestra en la siguiente imagen:

Esta opción se encuentra en la pestaña Actions y en "On-Do Actions" adicionamos una condición más y le
ponemos los siguientes parámetros.

Entornos Previos Distribuidos 19/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

11 Escribir los jobs en la tabla de Control-M

Cuando los jobs de Control-M hayan sido configurados en base a los estándares y se desee
escribirlos en la tabla, se deberá seguir el siguiente procedimiento:

Para guardar los cambios en la tabla y escribirlos en la malla hacemos los siguiente.

En la parte superior vamos al botón de "Save", damos clic y guardamos los cambios

Sí hay algún problema con la definición de parámetros no lo indicara en la parte inferior. En Network
Overview. Esto cuando ejecutemos el "Check In" es el símil del Upload en la versión 7, esta nos enviara el
mensaje como se puede ver en la siguiente imagen:

Entornos Previos Distribuidos 20/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

En este caso nos manda el mensaje de que hay un espacio en el campo con la descripción "Host/Host
Group", en el valor "wlfcmxt", el cual es un espacio en blanco. El cual para poder subirlo tendremos que
corregir y así podremos cargar la malla. El mensaje que debe de salir es el siguiente:

En este nos indica que todos los parámetros están correctos.

Entornos Previos Distribuidos 21/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Para poder modificar la malla una vez que ya la tengamos activa con el "Check In", tendremos que aplicar
el "Check Out".

Una vez que deseemos cargar la malla con base al calendario en el scheduling, vamos a dar clic sobre el
folder para que nos muestre las opciones de carga del lado derecho, como se puede ver en la siguiente
imagen:

Seleccionamos la opción en Order Method "Automatic (Daily)" y aplicamos el "Check In", esto es el símil a
la opción de "SYSTEM" en la versión 7 de ControlM.

Entornos Previos Distribuidos 22/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Para Ordenar una malla y realizar pruebas, se deberá aplicar después del Check Out la opción "Order" esto
para ver la malla cargada en Monitoring que es el símil de Control-M Enterprise Manager y poder correr los
procesos.

En Monitoring veremos el Job Holdeado listo para ejecutarse.

4.- Una vez que hayamos escrito la tabla, es necesario ordenar la malla, para lo cual deberemos ubicar el
botón de Scheduling Table Manager.

Entornos Previos Distribuidos 23/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

12 Como ver las mallas en Control-M versión 9.

Cuando necesitemos ver las mallas cargadas en control-m y a las cuales tenemos acceso tenemos que
ingresar al control-m y en “Planning” En Load Folders and Jobs, ponemos el nombre del folder y el
Control-M Server como se ve en la imagen.

Seleccionamos el Folder y damos clic en “Open”

Nos mostrara los jobs con la opción “Check Out” para poder hacer modificaciones.

Entornos Previos Distribuidos 24/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Sí queremos guardar nuestra malla en un medio alterno como en nuestra maquina debemos ir a la parte
superior izquierda y dar clic en “File” y dar clic en “Save as”. Nos pedirá el nombre con el que vamos a
guardar la malla y le pondrá la extensión “.emf”.

Entornos Previos Distribuidos 25/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

13 Exportar XML a Control-M versión 9.

Entramos a “Planning” y abrimos un nuevo “Blank Workspace”, en la opción “Import” damos clic y nos
abrirá el explorador para localizar el archivo “*.xml”.

Entornos Previos Distribuidos 26/27 Versión 1.0.0

Enero 2017
 MA NUA L CONTROL- M VERSIÓN 9

Test Environment Management

Nos mostrara los jobs creados en nuestro archivo “*.xml”.

Entornos Previos Distribuidos 27/27 Versión 1.0.0

Enero 2017