MANUAL DE CHANGEMAN

CHANGE MAN

51
 MANUAL DE CHANGEMAN

INDICE
CHANGE MAN .................................................................................................... 51

¿QUÉ ES CHANGE MAN? .................................................................................. 53

PASOS A SEGUIR PARA LA CREACIÓN DE UN EXPEDIENTE: .................... 54

LISTA DE OPCIONES A UN EXPEDIENTE...................................................... 63

LISTA DE OPCIONES A UN COMPONENTE................................................... 65

PASOS A SEGUIR PARA HACER AUDIT DE UN EXPEDIENTE DE CAMBIOS

.......................................................................................................................... 67

PASOS A SEGUIR PARA HACER FREEZE DE EXPEDIENTES ..................... 69

PASOS A SEGUIR EN LA APROBACIÓN DE UN “EXPEDIENTE DE CAMBIO”

.......................................................................................................................... 70

PASOS A SEGUIR PARA HACER CHECKOUT DE LOS COMPONENTES DE

UN EXPEDIENTE DE CAMBIOS ...................................................................... 73

INFORMACIÓN SOBRE UN EXPEDIENTE ...................................................... 76

ERRORES DE SINCRONISMO ..................................................................... 77

52
 MANUAL DE CHANGEMAN

¿QUÉ ES CHANGE MAN?

CHANGE MAN(Change Manager) es un producto para la gestión y automatización
del tratamiento de traslado del software, desde Desarrollo hasta Versión Final
(Base-Line).

El primer concepto que debemos de tener claro es el de “expediente” y cómo crear un

“expediente”.

EXPEDIENTE:
Es un grupo de componentes o elementos (fuentes, copys, dclgen, etc.) Dependiendo del
“tipo” de componente, determinará el tratamiento que debemos de darle a ese expediente
por cada uno de los escenarios que pasará.
En el manual de recomendaciones de chgman se detalla este concepto, es muy
importante saber con que tipo de componente estamos trabajando.

53
 MANUAL DE CHANGEMAN

PASOS A SEGUIR PARA LA CREACIÓN DE UN EXPEDIENTE:

Conexión a Change Man.

(Menú principal del ISPF) Opción = P.

Opción = H CHANGEMAN.

(Menú principal del CHGMAN) Opción = 1 BUILD.

Opción = 1 CREATE A NEW PACKAGE.

Opción = S SHORT METHOD.

PACKAGE LEVEL=

1 Simple: Es el nivel de expediente más común, este expediente depende de sí mismo, no

está relacionado con ningún otro expediente.

2 Complex: Es un directorio de todos los expedientes relacionados.

3 Participado: Expediente que está relacionado con otros expedientes, en el paso AUDIT,
auditará todos los expedientes relacionados. Todos los que están en el complejo.

54
 MANUAL DE CHANGEMAN

En la siguiente pantalla tendremos en cuenta la fecha y hora de instalación del

expediente, ya que cuando queramos instalarlo (paso a Base-Line) tomará como fecha de
referencia la que especifiquemos aquí. Es un error muy común olvidar la fecha de
instalación del expediente. No es definitiva, podremos cambiarla cuando queramos,
menos en el paso a Base-Line.

El comando para cambiar la fecha y hora de instalación es: U7.

Respecto a la hora de la instalación del expediente, tener también en cuanta que

debemos de poner una hora de comienzo y una hora de fin. Es un error muy común
poner como hora de comienzo las 0000, para el Chgman no tiene sentido y el expediente
jamas se instalará en Base-Line.

Ejemplo válido:

FROM TO
0800 2300

55
 MANUAL DE CHANGEMAN

En la esquina superior derecha de la siguiente pantalla nos indica nombre del expediente
y número de expediente que hemos creado. Esta será la referencia a tener en cuenta
para su posterior utilización.

YA TENEMOS NUESTRO EXPEDIENTE, PERO VACIO. CONTAREMOS AHORA LOS

PASOS A SEGUIR PARA IMPLANTAR LOS COMPONENTES EN EL NUEVO
EXPEDIENTE.

56
 MANUAL DE CHANGEMAN

Menú principal de CHGMAN Opción = 5 LIST

A la izquierda de la descripción del expediente, daremos el comando S1.

57
 MANUAL DE CHANGEMAN

COMANDO = S1 Stage components (Dev Lib list)

Daremos intro y nos muestra la siguiente pantalla:

En el campo activo DATASET NAME: escribiremos el nombre de la librería donde están

los componentes que queremos en nuestro expediente y daremos intro.

En esta pantalla nos muestra los distintos tipos de componentes que existen.
Con S seleccionamos el tipo de componente para el Stage.

58
 MANUAL DE CHANGEMAN

Dependiendo del tipo de componente que seleccionemos, creara las correspondientes

librerías.

59
 MANUAL DE CHANGEMAN

A continuación nos mostrara los miembros de la librería seleccionada.

COMANDO = S Con la S seleccionaremos todos los miembros (componentes) que

queramos dentro de nuestro expediente. El Stage From es uno a uno.

60
 MANUAL DE CHANGEMAN

Al seleccionar el componente o los componentes que queramos, al darle intro nos pedirá
uno a uno el tipo de lenguaje del componente o componentes seleccionados.

COBOL: Por defecto

ASM: Por si hubiera algún PGM Assembler.
BMS: Para mapas.

Con “S” seleccionamos el tipo de lenguaje.

En esta otra pantalla tenemos las distintas OPCIONES DE COMPILACION, tener en

cuenta que si es la primera vez que entrais en Chgman, la ficha job, deberíais de
customizarla. Es importante que en la ficha job ponga REGION=4M

61
 MANUAL DE CHANGEMAN

Estas son las distintas opciones de compilación:

PROGRAMA
1C Cics sin DB2
2C Cics con DB2
3C Batch sin DB2
4C Batch con DB2
6C Cics sin DB2
7C Cics con DB2
MODULOS
8C Batch sin DB2
9C Batch con DB2

En la pantalla anterior, una vez rellenado todos los campos, daremos intro y se submitira
un job. En este paso se hace la primera compilación de los componentes seleccionados.

62
 MANUAL DE CHANGEMAN

NAME: Nombre del componente.

TYPE: Tipo del componente.
STATUS: Incompleto / Activo.

Para poder seguir trabajando con el expediente, todos los componentes deben de estar
en STATUS ACTIVO. Tenemos en el SPOOL la salida del job donde podremos ver como
ha ido la ejecución de la primera compilación.

LISTA DE OPCIONES A UN EXPEDIENTE

Los comandos se darán a la izquierda del expediente correspondiente. Si no recordamos
los comandos disponibles, introduciremos OPTIONS en el campo COMMAND para
disponer de una relación, tal como se muestra en el siguiente ejemplo. Volveremos al
panel anterior con PF3.

63
MANUAL DE CHANGEMAN

64
 MANUAL DE CHANGEMAN

LISTA DE OPCIONES A UN COMPONENTE

Pondremos un X al lado del componente y daremos intro, nos mostrara la lista de
opciones. Volveremos al panel anterior con PF3.

LA UTILIZACIÓN DE LOS COMANDOS DESCRITOS ESTARÁ LIMITADA POR EL

NIVEL DE AUTORIZACIÓN QUE POSEA EL USUARIO.

65
 MANUAL DE CHANGEMAN

EL TRATAMIENTO DEL TRASLADO DEL SOFTWARE HASTA VERSION FINAL

PASARA POR LOS SIGUIENTES ESCENARIOS:

DEV /STAGE: Entorno de RECEPCION de los distintos componentes seleccionados.

Se realiza la primera compilación.

Ejemplo de una librería: CHGMAN.STAGE.ZMNT.Ñ000123.* (Tipo de Componente)

DESA: Entorno de DESARROLLO. En este entorno efectuaremos todos los

cambios necesarios a los componentes.

Ejemplo de una librería: MBVD.*.*

CALI: Entorno de CALIDAD. Entorno de Prueba Integrada. Nuestro expediente

estará en estado de congelación.

Ejemplo de una librería: MBVD.*.*

BASE-LINE: Versión final de los componentes (sujetos a cambios).

Ejemplo de una librería: MBDV.BASE.*

66
 MANUAL DE CHANGEMAN

PASOS A SEGUIR PARA HACER AUDIT DE UN EXPEDIENTE DE

CAMBIOS
Una vez seleccionada la opción 1 del menú principal, seleccionaremos la opción 7 del
menú “Audit a package”

En el menú que aparece a continuación seleccionamos el CHANGE PACKAGE ID que

vamos a auditar y elegimos las opciones siguientes:

AUDIT STAGING LIBRARIES ONLY ===> NO (Y/N)

Con la opción YES audita unicamente las librerías de Stage.

AUTO RESOLVE OF OUT-OF-SYNCHS ===> NO (Y/N)

Con la opción YES Change Man resuelve errores de sincronismo.

Los parámetros de la ficha JOB pueden adaptarse a las preferencias del usuario.

Change Man submite un job, el resultado del audit lo veremos en el Spool, Chgman
siempre nos dara una recomendación si obtenemos algún error de sincronismo.

67
 MANUAL DE CHANGEMAN

Antes de explicar el paso de congelación de expedientes (FREEZE), comprobaremos el

estado del expediente. Si no vemos el resultado del JOB correspondiente al AUDIT, en
esta pantalla podemos comprobarlo en la columna AUD, el “return-code”. En este caso12.

68
 MANUAL DE CHANGEMAN

PASOS A SEGUIR PARA HACER FREEZE DE EXPEDIENTES

Seleccionamos la opción 2 del menú principal

PACKAGE ID ===> Aplicación y número de expediente.

1 Online - Freeze package online.

2 Batch - Freeze package in batch.
3 Selective - Selectively unfreeze/refreeze package components.
4 Reset - Reset indicator after unsuccessful batch freez.

Con la opción 3 Selective, seleccionaremos los componentes que queremos congelar.

Con la opción 4 descongelamos los componentes que selecionemos.

69
 MANUAL DE CHANGEMAN

PASOS A SEGUIR EN LA APROBACIÓN DE UN “EXPEDIENTE DE

CAMBIO”

Esta opción se podrá realizar dependiendo de la categoria , mínimo Jefe de Equipo.

Seleccionaremos la Opción 4 del menú principal

En esta pantalla si conocemos el expediente y en el campo activo PACKAGE ID le

ponemos el nombre de la aplicación y número de expediente nos mostrará sólo el
expediente seleccionado.

La lista que aparece a continuación contiene:

 expedientes que están esperando aprobación del usuario que hace la

consulta

 expedientes que han sido rechazados por el usuario que hace la consulta

70
 MANUAL DE CHANGEMAN

 expedientes que han sido aprobados por el usuario que consulta pero
rechazados por algún otro integrante de la lista de aprobadores.

Buscamos en la lista el expediente que deseamos aprobar y tecleamos a su

izquierda la opción A1 de aprobar.

71
 MANUAL DE CHANGEMAN

Daremos el comando “A” a la izquierda de la linea Jefe de Equipo…..

Chgman, submitira dos jobs internos. Para poder ver la salida en el spool, el nombre de
los jobs sera Nombre de la Aplicación el numero 20 en el primer caso job y numero 30 en
el segundo caso y los tres ultimo digitos de nuestro expediente.

Ejemplo con la aplicación SP$:

SP$20123
SP$30123

72
 MANUAL DE CHANGEMAN

PASOS A SEGUIR PARA HACER CHECKOUT DE LOS

COMPONENTES DE UN EXPEDIENTE DE CAMBIOS
Tener presente que CHECKOUT de un componente es una copia del componente a un
expediente que o bien ya lo hemos creado o lo vamos a crear nuevo, nunca se hará
checkout sobre un expediente que esté en base-line.

Opción 1 del menú principal.

Opción 5 Checkout.

Opción 1 Base/Prom

Seleccionamos la opción 1 para hacer checkout de las librerías de Baseline.

Con la opción 2 entraríamos a seleccionar entre los componentes de un expediente

73
 MANUAL DE CHANGEMAN

Indicamos, en el “CHANGE PACKAGE ID”, el nombre del expediente donde incluiremos

nuestro componente de base-line.

Rellenar, comenzando con el nombre del expediente, los campos correspondientes a:

LIBRARY TYPE = (SRC, LOD, CPY, JCL, etc.) o * para opciones

SOURCE LIBRARY = nivel del entorno de donde se toman los componentes
CHECK OUT TO = librerías de destino de los componentes
CONFIRM REQUEST = Es conveniente seleccionar la opción YES

El resto de campos se rellenaría en situaciones en que se escogen, como destino, las

librerías de usuario o para casos especiales.

Entre los componentes de la librería origen que seleccionamos dependiendo del tipo del
componente, vamos seleccionando (con la opción S a la izquierda del componente)
aquellos que deseemos copiar a las librerías de destino.

74
 MANUAL DE CHANGEMAN

El STATUS del componente pasa a ser “Checkout” si la selección ha sido aceptada.

75
 MANUAL DE CHANGEMAN

INFORMACIÓN SOBRE UN EXPEDIENTE

Desde el panel Change Package List, daremos el comando QP (Query change package
information).

Obtendremos 19 tipos distintos de opciones informativas sobre nuestro expediente.

Esta opción (QP) nos permite solicitar información de las características, estado y/o
componentes del expediente.

76
 MANUAL DE CHANGEMAN

ERRORES DE SINCRONISMO

DUPLIC (Staging duplicates baseline)

Duplicados. Misma versión en Stage y en Base-Line. Es informativo, se puede
continuar con normalidad

SYNCH0 (Unknown to Change Man)

Desconocido para CHGMAN. Es informativo, se puede continuar con
normalidad.

SYNCH1 (PDF statistics not available)

Estadísticas ISPF no disponibles. Es informativo, se puede continuar con
normalidad.

SYNCH2 (Compile/designated proc differ)

Fuentes sin GOBACK o STOP RUN.

SYNCH3 (Unparsable load module)

Existen componentes que el Chgman no puede analizar.

SYNCH4 (CPY problem in staging)

Problemas con la copy que está en Staging.

SYNCH5 (CPY high-date problem in baseline)

Pide recompliar los fuentes que están en Base-Line. La relación de los fuentes
afectados se puede sacar de la ejecución del Job en el Spool.

SYNCH6 (Activity file not checked out)

Problemas en la asociación de componentes. Hacer CHECKOUT.

SYNCH7 (Called subroutine in staging)

Problemas en llamadas a rutinas en Staging.

SYNCH8 (Called subroutine in baseline)

Problemas en llamadas a rutinas en Base-Line.

SYNCH9 (Source and load discrepancy)

Discrepancia en fuente y carga.

SYNCH10 (Version regression problem)

Cambios en componentes que tienen miembros correspondientes en Base-
Line. Hacer CHECKOUT.

SYNCH11 (Component hash discrepancy)

Se han realizado cambios a los componentes por fuera del Chgman, hacer
stage de nuevo.

SYNCH12 (Orphan module in staging)

Componentes extraños en las librerias del expediente (restos de un cargas sin
el fuente) Borrar el ejecutable de la librerías del expediente.

77
 MANUAL DE CHANGEMAN

SYNCH13 (Baseline/staging discrepancy)

La versión que está en Base-Line tiene fecha mas reciente que la versión de
Stage.

SYNCH14 (Components not in active status)

Componentes no activos. Recompilar los componentes no ACTIVOS del
Expediente.

SYNCH15 (Source to relationship problem)

Diferente versión de copy, recompilar los fuentes de Base-Line afectados.

SYNCH16 (CPY low-date problem in baseline)

Error en un componente de copy. Recompilar Base-Line.

78