Manual Changeman

CHANGE MAN
Manual de Usuario
Elabor: Lic. Daniel Arellano Barrera.
Banco Bilbao Vizcaya-Mxico.

Gestin de Cambios.
INDICE
INDICE PAGINA
1) Qu es Change Man?.1
2) Ciclo de vida de un Paquete con Change Man1
3) Ingreso a Change Man.2
4) Uso de Acceso Directo de Navegacin... 3
5) Creacin del Paquete de Cambios... 3
6) Checkout de Componentes a Modificar .9
7) Lista del Paquete12
8) Stage de Componentes. 15
9) Audit del Paquete de Cambios. 18
10) Freeze del Paquete de Cambios 21
11) Consideraciones Adicionales 23
12) Otras Funciones de Change Man.. 24
12.1) Recompilacin de Componentes.. 24
12.2) Revisin de Versiones en Baseline 25

Gestin de Cambios.
Change Man. Manual de Usuario

Gestin de Cambios. 2
1) Qu es Change Man?
Change Man es una herramienta de Gestin de Cambios que integra, automatiza y controla los
componentes en ciclo de vida del software. Con Change Man la implementacin y control de las
aplicaciones se simplifica. Esta herramienta esta basada en la arquitectura de Paquete de Cambios.
2) Ciclo de Vida de un Paquete con Change Man.
El ciclo de vida de un Paquete de Cambios involucra siete pasos esenciales: Creacin del Paquete,
Checkout, Stage, Audit, Freeze, Promocin y Aprobacin. Estos pasos sern descritos posteriormente. El
siguiente diagrama muestra de manera general un ciclo completo.
Checkout Modificacin Stage
Revert
Creacin Audit
Despromocin
Instalacin en Promocin Freeze

Produccin
Backout
Recorrido de
Versiones
Diagrama del Ciclo de Vida

3) Ingreso a Change Man.
Desde el men principal de TSO/ISPF de desarrollo se accede a Change Man seleccionando la opcin
CH.
OS/390 MENU PARA USUARIOS DESARROLLO

Select Option ===> CH
--- PDF Functions --- --- Local Functions --- - End User Functions -
0 Settings L0 SDFS U0 DB2/I

1 Browse U1 Job/Scan
2 Edit U2 Docu/Text
3 Utilities U3 CONNECT-Direct
4 Foreground U4 IOA V500
5 Batch U5 CONNECT-Direct Msg
6 Command U6 STOBE
7 Dialog Test CH Change Man
8 LM Utilities
C Changes
T Tutorial
X Exit
Men Principal TSO/ISPF
Se muestra el men principal.
------------- CHANGE MAN 4.1.6A PRIMARY OPTION MENU

-----------
OPTION ===>
1 Build - Create, update and review package data

2 Freeze - Freeze or unfreeze a package
3 Promote - Promote or demote a package
4 Approve - Approve or reject a package
5 List - Display (to process) package list
A Admin - Perform administrative functions
B Backout - Back out a package in production
C CDF - Concurrent Development Facility
D Delete - Delete or undelete a package
L Log - Browse the activity log
M Monitor - Monitor internal scheduler or packages in limbo
N Notify - Browse the Global Notification File
Q Query - Query packages, components and relationships
R Revert - Revert a package to DEV status
T Tutorial - Display information about Change Man
X Exit - Exit Change Man
Press ENTER to process; enter END command to exit.
Men Principal Change Man.

4) Uso de Acceso Directo de Navegacin.

En la lnea de comando OPTION introducir un signo de suma (+) o signo de igual (=) precedido de la
secuencia de nmeros o letras, separados por un punto (.) entre cada uno para acceder directamente al
panel deseado. Por ejemplo:
COMMAND === > + A.B.C
COMMAND ===> = 1.2.1
5) Creacin del Paquete de Cambios.
Desde el men principal de Change Man seleccionar la opcin 1 Build.
------------- CHANGE MAN 4.1.6A PRIMARY OPTION MENU

-----------
OPTION ===>
1 Build - Create, update and review package data

2 Freeze - Freeze or unfreeze a package
3 Promote - Promote or demote a package
4 Approve - Approve or reject a package
5 List - Display (to process) package list
A Admin - Perform administrative functions
B Backout - Back out a package in production
C CDF - Concurrent Development Facility
D Delete - Delete or undelete a package
L Log - Browse the activity log
M Monitor - Monitor internal scheduler or packages in limbo
N Notify - Browse the Global Notification File
Q Query - Query packages, components and relationships
R Revert - Revert a package to DEV status
T Tutorial - Display information about Change Man
X Exit - Exit Change Man
Creacin del Paquete de Cambios

Aparece la siguiente pantalla de la cual se debe seleccionar la opcin 1 Create. Este men cubre, adems
de la creacin del Paquete de Cambios, los servicios previstos para Desarrollo, como Checkout, Stage,
Audit, Recompile.
---------------------------------- BUILD OPTIONS

----------------------------
OPTION ===>
0 Dates - Display the installation calendar

1 Create - Create a new package
2 Update - Update package information
3 Custom - Create, update, approve or review custom forms
4 Utility - Rename and Scratch information
5 Checkout - Check out components from baseline or promotion
6 Stage - Stage, edit, browse and delete components
7 Audit - Audit a package
8 Recompile - Recompile source code from baseline or promotion
9 Relink - Relink load modules
B Browse - Browse\print\copy baseline or promotion
C Compare - Compare staging to baseline or promotion
L Listing - Browse compressed listings
S Scan - Scan baseline for character strings
Z Compress - Compress change package Staging Libraries
Men de Desarrollo
Se presenta la siguiente pantalla que permite la creacin del nuevo paquete.
------------------------- CREATE: CREATE A NEW PACKAGE

----------------------
OPTION ===>
L Long method - Prompt for package description and special instructions

S Short method - Use default package description and instructions
PACKAGE TITLE
===>
APPLICATION ===> (Blank or pattern for list)

REQUESTER'S NAME ===>
REQUESTER'S PHONE ===>
NUMBER REQUIREMENT IMA ===>
DEPARTMENT ===>
PACKAGE LEVEL ===> (1-Simple, 2-Complex,
3-Super, 4-
Participating)
PACKAGE TYPE ===> (Planned or Unplanned)
PACKAGE TIME SPAN ===> (Permanent or
Temporary)
PACKAGE TO COPY FORWARD ===> (Optional package name)
Panel de Creacin del Paquete de Cambios

Campo Descripcin
OPTION L
Crea un Paquete por el mtodo largo. Se debe proporcionar informacin muy
detallada. Permite la descripcin del motivo de creacin en un mximo de 46
lneas y dar instrucciones especficas en caso de contingencia. Esta opcin es
la que se debe utilizar.
S
Crea un Paquete por el mtodo corto. Se debe de proveer la informacin
mnima necesaria del Paquete. Principalmente, dicha informacin es
descriptiva. Esta opcin no debe utilizarse.
PACKAGE TITLE Permite introducir una breve descripcin del motivo de creacin del Paquete.
Mximo 72 caracteres.
APPLICATION En un mximo de 4 caracteres se debe sealar el mdulo al que pertenecer

el nuevo Paquete.
REQUESTERS NAME Nombre del Solicitante.
REQUESTERS PHONE Nmero telefnico o extensin del solicitante.
NUMBER Nmero de requerimiento IMA.

REQUIREMENT IMA
DEPARTMENT Departamento del solicitante (cuatro caractres).
PACKAGE LEVEL Simple

El Paquete contiene un elemento que no esta relacionado con algn otro
Paquete.
Complex/Super
Un Paquete Complejo o Super es el padre de dos o ms Paquetes
Participativos. Contiene la lista de dichos paquetes, as como la informacin
general. No contiene ningn elemento a ser instalado.
Participating
El Paquete est relacionado con uno o ms Paquetes.

Campo Descripcin
PACKAGE TYPE Planned

Un Paquete planeado es creado durante un horario normal de trabajo
(definido en los Parmetros globales).
Unplanned
Un paquete implaneado es creado para un cambio de emergencia, despus
del horario normal de trabajo. Este tipo no se utiliza.
PACKAGE TIME SPAN Permanent

Cambios calendarizados que actualizan las bibliotecas de Produccin
(Baseline). Esta es la forma normal de instalar los cambios.
Temporary
Cambios que corren en un periodo de tiempo predeterminado. Una vez que
ha expirado, Change Man automticamente borra el cambio. Los cambios
temporales no actualizan las bibliotecas de Produccin (Baseline).
UNPLANNED REASON Si se cre un Paquete implaneado se deber introducir el cdigo de la razn

CODE correspondiente.
TEMPORARY CHANGE Si se cre un Paquete temporal se deber introducir el nmero de das que se
DURATION requiera el cambio.
Con los datos correspondientes se va llenado la Pantalla de Creacin.
------------------------- CREATE: CREATE A NEW PACKAGE ----------------------

OPTION ===> S

PACKAGE TITLE
===> Pruebas sobre modificaciones de liquidacin de tarjetas parametrizadas.
APPLICATION ===> (Blank or pattern for list)

REQUESTER'S NAME ===> Emilio Ybarra
REQUESTER'S PHONE ===> 1512
NUMBER REQUIREMENT IMA ===> BK168
DEPARTMENT ===> Pres
PACKAGE LEVEL ===> 1 (1-Simple, 2-Complex,
3-Super, 4-Participating)
PACKAGE TYPE ===> Planned (Planned or Unplanned)
PACKAGE TIME SPAN ===> Perm (Permanent or Temporary)
UNPLANNED REASON CODE ===> (* for list)
TEMPORARY CHANGE DURATION ===> (In days)
Press ENTER to process; Enter END command to exit.

En caso de no introducir datos en el campo APPLICATION Change Man desplegar una lista de los
mdulos que tenga dados de alta, pudindose efectuar la seleccin correspondiente.
-------------------------- APPLICATION SELECTION LIST ------ Row 1 to 19 of 71

COMMAND ===> SCROLL ===>
0000
APPL DESCRIPTION HIGHEST

_ AJ@ Modulo de Ajenos de Altamira 000065
_ AU@ Modulo de Auditoria Altamira 000032
S BG@ Modulo de Cuentas de Altamira 003757
_ CAR Modulo de Cartera SCAB Antiguo 000699
_ CS@ Modulo de Credit Scoring Altamira 000095
_ DRP Modulo de DRP 000036
_ DX@ Modulo de Mex-Der 000043
_ ECO Modulo de enlace contable Casa de Bolsa 000064
_ ECT Modulo de Estados de Cuenta C.B. 000225
_ SIE Modulo de Sistema Estadistico Casa de Bolsa 000170
_ SIN Modulo de Sociedades de Inversion C.B. 000460
_ SO@ Modulo de Sorteos BBV 000009
_ SP@ Modulo de Mis Productos 000187
_ SRI Modulo de Recaudacion de Impuestos 000080
_ UG@ Modulo de Prestamos de Altamira 000946
Lista de seleccin
Quedando as completa la pantalla de creacin. Cabe sealar que la informacin proporcionada ser la
que caracterizar al Paquete de Cambios.
--------------------------------------- CREATE: CREATE A NEW PACKAGE ----------------

OPTION ===> S
PACKAGE TITLE
===> Pruebas sobre modificaciones de liquidacin de tarjetas parametrizadas.
APPLICATION ===> BG@ (Blank or pattern for list)

REQUESTER'S NAME ===> Emilio Ybarra
REQUESTER'S PHONE ===> 1500
NUMBER REQUIREMENT IMA ===> BK168
DEPARTMENT ===> Pres
PACKAGE LEVEL ===> 1 (1-Simple, 2-Complex,
PACKAGE TYPE ===> Planned (Planned or Unplanned)
PACKAGE TIME SPAN ===> Perm (Permanent or Temporary)
UNPLANNED REASON CODE ===> (* for list)
TEMPORARY CHANGE DURATION ===> (In days)

Pantalla de Creacin Completa

En el siguiente panel se indica la fecha y horario previsto de la instalacin del Paquete en el ambiente de
Produccin (este horario es determinado por el personal de Gestin de Cambios), as como el
responsable(s) y su nmero o extensin telefnica.
-------------------------------------- CREATE: ON SITE INFORMATION ---------------------------

COMMAND ===>
Press ENTER to create the package or type CANCEL to exit.
INSTALL DATE/TIME
YYYYMMDD FROM TO PRIMARY/BACKUP CONTACTS PHONE
NUMBERS
20000629 0000 2359 Maribel Zavala 8513
Esteban Germn. 8221
Panel de Fecha de Instalacin
Es importante sealar que cuando la fecha del Paquete ha sido sobrepasada, con respecto a la fecha del
sistema, el Paquete no puede ser alterado y Change Man desplegar el error correspondiente. Para poder
trabajar con el Paquete es necesario actualizar este panel por medio de las opciones 1 Build del panel
principal, 2 Update del submen y 7 Install Dates del siguiente panel.
--------------------------- UPDATE: SITE INFORMATION ------ INSTALL DATE ERROR

COMMAND ===>
CMN1041A - Install date must be current or future.
PACKAGE ID: BG@ 003771 CREATOR: IDAEX19 STATUS: DEV
INSTALL DATE AND TIME:
YYYYMMDD FROM TO PRIMARY/BACKUP CONTACTS PHONE

NUMBERS
20000629 0000 2359 Maribel Zavala 8513
Esteban Germn. 8221
Error en Fecha de Instalacin

Al finalizar el proceso, vuelve al submen con el mensaje, en el extremo superior derecho, de la creacin
del Paquete. Es importante recordadar el nmero asignado pues ser utilizado en todas las funciones
posteriores y en todos los mensajes que realice Change Man.
-------------------------------- BUILD OPTIONS ------------BG@ 003771

CREATED
OPTION ===>
0 Dates - Display the installation calendar

1 Create - Create a new package
2 Update - Update package information
3 Custom - Create, update, approve or review custom forms
4 Utility - Rename and Scratch information
5 Checkout - Check out components from baseline or promotion
6 Stage - Stage, edit, browse and delete components
7 Audit - Audit a package
8 Recompile - Recompile source code from baseline or promotion
9 Relink - Relink load modules
B Browse - Browse\print\copy baseline or promotion
C Compare - Compare staging to baseline or promotion
L Listing - Browse compressed listings
S Scan - Scan baseline for character strings
Z Compress - Compress change package Staging Libraries

Asignacin del Mdulo y Nmero de Paquete
6) Checkout de Componentes a Modificar.
El proceso de Checkout obtiene una copia del elemento a modificar de las bibliotecas de produccin. Es
posible recuperar la versin productiva (0) o versiones anteriores (-n). El nmero de versiones existentes
depender de cuantas veces se haya liberado dicho componente. Si el elemento es nuevo, esta etapa no
aplica pasando directamente al proceso de Stage.
Desde el men principal seleccionar la opcin 1 Build y del submen la opcin 5 Checkout. Aparecer la
siguiente pantalla:
---------------------------- CHECKOUT OPTIONS

----------------------
OPTION ===> 1
PACKAGE ID ===> BG@ 003771
1 Base/Prom - Checkout from baseline or promotion

libraries
2 Package - Checkout package components

Panel de Opciones para Checkout

De la cual se seleccionar la opcin 1.
--------------------------------------------------- CHECKOUT -------------------------LANGUAJE

ASSUMED
OPTION ===>
L - List libraries where component is located
PACKAGE ID ===> BG@ 003771 (Package name)

COMPONENT NAME ===> BG2C5210 (Blank or pattern for list; * for all members)
LIBRARY TYPE ===> SRC (Blank for list)
LANGUAGE ===> COBOL2 (Applies to source code; * for list)
SOURCE LIBRARY ===> 0 (Baseline 0 to -n; Promotion +1 to +n)
CHECK OUT TO ===> P (S-Staging library, P-Personal library)

PERSONAL LIBRARY ===> MBVD.BGG.FONTS
LIBRARY DSORG ===> PDS (Personal library: PDS, PDSE, SEQ, PAN, LIB)
CONFIRM REQUEST ===> YES (Y/N)

Panel de Checkout
Campo Descripcin
PACKAGE ID Mdulo y Nmero de Paquete sobre el cual se efectuar el Checkout.
COMPONENT NAME Nombre del elemento a ser copiado. Si se deja en blanco aparecer la lista de
todos los elementos en Baseline y se podr efectuar la seleccin (siempre y
cuando los dems campos presenten datos.
LIBRARY TYPE Corresponde a la nomenclatura que siguen los elementos:
Bind: DBB.
Copy: CPY.
Dclgen: DCL.
Disparador: JCL.
Fuente: SRC.
Mapa: MPS.
Procedimiento: PRC.
Rutina: RUS.
Spufi: SQL.
Tarjeta de Control: CTC.
Tambin es posible desplegar la lista de tipos dejando el campo en blanco.
LANGUAJE Nombre del lenguaje en el que est escrito el elemento fuente. Tambin este
campo despliega lista de seleccin:
ASM
COBOL2
MAPAS

Campo Descripcin
SOURCE LIBRARY Establece el nmero de versin que se quiere recuperar. Versin productiva
(0) o una anterior (-n).
CHECK OUT TO S
Efecta la copia en las bibliotecas de Stage de Change Man.
P
Efecta la copia en la biblioteca de traspaso (terminacin G).
PERSONAL LIBRARY Si se seleccion la opcin P en el campo CHECK OUT TO, se deber

introducir el nombre de la biblioteca de traspaso (G), en la que se desea la
copia del elemento.
LIBRARY DSORG Como consecuencia de haber seleccionado la opcin P se deber introducir

el tipo de organizacin de la biblioteca destino.
CONFIRM REQUEST Con la opcin Y Change Man notifica el estatus de todos los Paquetes que
incluyeron el elemento sobre el que se est actuando.
---------------------------------------------- BG2C5210.SRC ------------------------- Row 1 to 9 of 9

COMMAND ===> SCROLL ===> 0000
Press ENTER or END to process or enter CANCEL command to exit.
This component is included in the following packages:
PACKAGE ID STA PROMOTION VV.MM LAST ACTION SIZE PROCNAME ID

QG@ 000389 DEV 01.00 2000/06/08 17:49
IDAEX05
BG@ 003763 FRZ 01.01 2000/07/07 18:02 8806 CMNCOB2
IDARBR
BG@ 003758 FRZ 01.01 2000/07/06 14:00 8806 CMNCOB2
IDARBR
BG@ 003752 FRZ 01.01 2000/07/05 15:33 8806 CMNCOB2 IDALSA
BG@ 003470 DEV 02.00 2000/04/06 09:31 7984 CMNCOB2
IDAVRD
BG@ 003375 FRZ CONFIRM
01.01 REQUEST
2000/02/18 Y
19:02 7984 CMNCOB2
IDAVRD
Confirm Request Y
Al concluir el proceso con xito, desplegar en el ngulo superior derecho de la pantalla de Checkout el
mensaje: LANGUAJE ASSUMED.

7) Lista del Paquete
Por medio de la opcin Lista de Paquete se puede accesar directamente a diversos paneles sin la
necesidad de salir de la pantalla actual. Otra facilidad que presenta es la verificacin de los elementos
incluidos y comprobar visualmente su estado. Tambin es posible realizar una serie de funciones a los
componentes como edicin, visualizacin, borrado, etc.
Para acceder a esta opcin desde el men principal seleccionar la opcin 5 List. Aparecer la siguiente
pantalla:
----------------------------------- PACKAGE LIST PARAMETERS

---------------------------------
COMMAND ===>
SPECIFY SELECTION CRITERIA:

PACKAGE ID ===> BG@ 003771 (Full name or pattern; blank for list,
or '*' for all packages)
PACKAGE STATUS ===> (DEV, FRZ, APR, REJ, DIS, INS,
BAS, BAK, OPN, CLO, TCC or
DEL)
CREATOR'S TSO-ID ===>
NUM REQUIREMENT IMA ===>
DEPARTMENT ===>
PACKAGE LEVEL ===> (1-Simple, 2-Complex,
PACKAGE TYPE ===> (Planned or Unplanned)
PACKAGE TIME SPAN ===> (Permanent or Temporary)
FROM INSTALL DATE ===> (YYYYMMDD)
TO INSTALL DATE ===> (YYYYMMDD)
FROM CREATION DATE ===> (YYYYMMDD)
TO CREATION DATE ===> (YYYYMMDD)
OTHER PARAMETERS ===> (Y/N)
Panel de Lista de Paquetes
En esta pantalla el nico campo requerido es el de PACKAGE ID, los dems son tiles en el caso de
efectuar bsquedas especficas; por ejemplo, si no se recuerda que Paquete es el que est utilizando es
posible realizar un desplegado de todos aquellos creados por un usuario, en alguna fecha especfica, por
estado, etc. Cuando se utiliza este mtodo, el campo PACKAGE ID queda en blanco y de los restantes es
posible requisitar uno o varios, lo que conlleva a una bsqueda ms especfica.
Aparece el Panel del Paquete donde se observa que los datos proporcionados en la pantalla de creacin
son los que lo caracterizan (LVL, TYPE, NUM REQ IMA, DEP). El estado hasta este momento es de
desarrollo (DEV) y la informacin para los campos de PROMOTE y AUD es generada y validada
conforme se continua en el ciclo.
-------------------------------------------- CHANGE PACKAGE LIST --------------------------- Row 1 to 1 of

1
COMMAND ===> OPTIONS SCROLL ===> CSR
PACKAGE ID STA INSTALL LVL TYPE NUM REQ IMA DEPT PROMOTE AUD CREATOR
__BG@ 003771 DEV 20000720 SMPL PLN/PRM BK168 PRES IDAEX19
Panel del Paquete
Lnea del Paquete

Al introducir la palabra OPTIONS se despliega la lista de opciones que se pueden utilizar directamente
sobre la Lnea del Paquete. Es importante sealar que este desplegado no funciona como lista de
seleccin.
--------------------------------------- PACKAGE LIST OPTIONS -----------------------------

0000
OPTION DESCRIPTION
-------------------------------------------------------------------------------
U1 Update control information
U2 Update general information
U3 Update implementation information
U4 Update scheduling information
U5 Update affected application information
U6 Update participating package information
U7 Update site(remote) information
U8 Change complex/super package to CLO status
U9 Change complex/super package to OPN status
CU Work with Custom forms
UA Rename and Scratch components (Package driven)
UB Rename and Scratch components (Baseline driven)
C1 Check out components (Baseline/promotion)
C2 Check out components (Package list)
S1 Stage components (Dev Lib list)
S2 Stage components (Package list)
S3 Specify package driven selection parameters
AP Audit package
RC Recompile source code from baseline/promotion libraries
RL Relink load modules.
BB Browse/Print Baseline/Promotion libraries
BL Browse compressed listing
CC Compare staging changes against baseline/promotion libraries
ZP Compress change package staging libraries
F1 Freeze the change package online
F2 Freeze the change package in batch
F3 Selectively unfreeze or refreeze package components
F4 Reset Freeze in Progress indicator
PD Promote/demote a change package
A1 Approve/Reject a change package
A2 Display reject reasons
A4 Reset Approval in Progress indicator
D1 Memo delete a change package
D2 Undelete a memo deleted change package
RV Revert a change package back to DEVelopment status
QP Query change package information
B1 Back out a change package
SC Scan baseline for character strings
******************************* Bottom of
Funciones en la Lnea del Paquete

Se selecciona la opcin S2 que despliega los elementos contenidos.
-------------------------------------------- CHANGE PACKAGE LIST --------------------------- Row 1 to 1 of

1
COMMAND ===> SCROLL ===> CSR
PACKAGE ID STA INSTALL LVL TYPE NUM REQ IMA DEPT PROMOTE AUD CREATOR
S2BG@ 003771 DEV 20000720 SMPL PLN/PRM BK168 PRES
------------------------------------- STAGE: BG@ 003771 COMPONENTS -------------- Row 1 to 1 of 1

0000
NAME TYPE STATUS CHANGED PROCNAME ID REQUEST
__ BG2C5210 SRC CHECKOUT 20000711 134542 CMNCOB2 IDAEX19
******************************* Bottom of data ********************************
Lnea del Elemento
Conforme se contine con el ciclo, el estado del elemento se ir modificando.
En la lnea del elemento se pueden utilizar los siguientes comandos:
------------------------ VALID STAGING SELECTION CODE Enter required field

OPTION ===>
PACKAGE ID: BG@ 003771 COMPONENT: BG2C5210 LIBRARY TYPE: SRC
Select a valid code. The component will be processed from this panel.
B - Browse component from personal or staging library

BA - Browse component activity file
BD - Browse component general description
D - Delete component from staging library
. E - Edit and stage component from personal or staging library
EA - Edit and stage component activity file
ED - Edit component general description
H - Display component history
R - Recompile component from the staging library
ST - Stage component into the staging library (S will also work)
SB - Stage component in batch mode
SL - Display Source to Load relationship
UL - Display Component Userid Work List (If turned on by administrator)
UC - Unlock Component to allow for Checkout/Stage
LC - Lock Component to disallow Checkout/Stage
Press ENTER to process or enter END command to exit.
Funciones en la Lnea del Elemento

8) Stage de Componentes.
El proceso de Stage consiste en la inclusin de un componente, previamente modificado o nuevo, en el
Paquete de Cambios para la promocin en los entornos de pruebas hasta la instalacin en Produccin.
Del men principal seleccionar la opcin 1 Build y del submen la opcin 6 Stage.
-------------------------------- STAGE OPTIONS

--------------------------
OPTION ===> 1
1 Dev - Stage components from development libraries

2 Package - Process package components
3 Parms - Specify component list selection criteria

Panel de Opciones de Stage
La opcin que se selecciona es la 1 Dev, que obtiene el elemento de una biblioteca de desarrollo.
----------------------------------- STAGE: FROM DEVELOPMENT -------------------------------

COMMAND ===>
PACKAGE ID: BG@ 003771 STATUS: DEV INSTALL DATE: 20000720
ISPF LIBRARY:
PROJECT ===> MBVD
GROUP ===> BGG
TYPE ===> FONTS
MEMBER ===> BG2C5210 (Blank or pattern for list; * for all
members)
OTHER PARTITIONED OR SEQUENTIAL DATASET:

DATASET NAME ===>
ORGANIZATION ===> (PDS, SEQ, PAN, LIB, OTH)

LANGUAGE ===> COBOL2 (Blank for list; applies to source code)
STAGE NAME ===> (Optional if organization not SEQ)
CONFIRM REQUEST ===> YES (Y/N)
SUPPRESS MESSAGES ===> YES (Y/N; applies to batch stage)

Panel de Stage

Campo Descripcin
ISPF LIBRARY Nombre de la biblioteca de traspaso (G), que cumpla con los estndares de
PROJECT TSO ISPF; es decir, tres calificadores.
GROUP
TYPE
MEMBER Nombre del elemento a incluir. El campo en blanco desplega lista de

seleccin. Con un * se incluyen en el Paquete todos los elementos de la
biblioteca.
DATA SET NAME Si los elementos se seleccionarn de una biblioteca que no cumple con los
estndares de TSO ISPF (ms de tres calificadores) este es el campo a
utilizar.
ORGANIZATION Si la biblioteca es un archivo secuencial, el campo queda vaco, en caso

contrario el tipo de organizacin debe ser especificada.
LIBRARY TYPE Nomenclatura con la que se identifica cada tipo de elemento (descrita
anteriormente). Es importante sealar que Change Man no valida este campo
con el elemento; por ejemplo, si se est incluyendo un elemento fuente y en
vez de asignarle el tipo SRC se le asigna JCL es el tipo con el que ser
incluido en el Paquete, y al promocionarlo se copiar en las bibliotecas de
JCL. Lo que si valida es el tipo Fuente (SRC, RUS, MPS) con en nico fin
de presentar la pantalla de compilacin.
LANGUAJE Nombre del lenguaje en el que est escrito el elemento fuente.
STAGE NAME Si se desea que el nombre del elemento sea diferente al asignado en la
biblioteca de desarrollo, en este campo se deber de introducir el nuevo
nombre.
CONFIRM REQUEST Con la opcin Y Change Man notifica el estado de todos los Paquetes que
incluyeron el elemento sobre el que se est actuando.

Cuando el componente es de tipo Fuente requiere compilacin, por tanto se presenta el panel para que se
compruebe las opciones y en su caso se modifiquen.
--------------------------------------- STAGE: COMPILE AND LINK EDIT ----------------------------

COMMAND ===>
PACKAGE ID: BG@ 003771 STATUS: DEV INSTALL DATE: 20000720
STAGED NAME: BG2C5210

LIBRARY TYPE: SRC - Fuentes de Programas
LANGUAGE: COBOL2
DATASET NAME: CHGSTG.BG@.003771.SRC
COMPILE PROCEDURE ===> CMNCOB2 (Blank for list; ? for designated procedure)
DB2 PRE-COMPILE ===> Y (Y/N) TCP/IP Sockets ===> (Y/N)

CICS ===> Y (Y/N) Mq/Series ===> (Y/N)
DL/I ===> (Y/N) Smart/test ===> (Y/N)
AMB C Bol o Sar ===> (P/N) Kripto ===> (Y/N)
===> //IDAEX19 JOB (ACCOUNT),'CHANGE MAN', <=== CHANGE ACCORDINGLY___

===> // CLASS=A,MSGLEVEL=(1,1), <=== CHANGE ACCORDINGLY___
===> // NOTIFY=IDAEX19, <=== CHANGE ACCORDINGLY___
===> // MSGCLASS=X <=== CHANGE ACCORDINGLY___
Panel de Opciones de Compilacin
En caso de tener acceso a DB2, muestra la siguiente pantalla para la seleccin correspondiente:
--------------------------- DB2 PHYSICAL SUBSYSTEMS ---------- Row 1 to 6 of 6

VERSION ===> ___________________________________________________
Enter S to select a DB2 subsystem and continue.

Enter END command to exit.
DB2 REMOTE DB2 SYSTEM

SUBSYS SITE LOAD LIBRARY
S DBD1 LDB2MXD0.DBD1.SDSNLOAD
_ DB21 DB21.SDSNLOAD
_ DB2P DB2P.SDSNLOAD
_ DB2C DB2P.SDSNLOAD
_ DB2I DB2P.SDSNLOAD
_ DB2 DB2.SDSNLOAD
Panel de Seleccin para DB2

Cuando el elemento esta en el proceso de compilacin, el estado que marca en el paquete es de INCOMP
(se conservar en caso de terminacin fallida de Job), si la terminacin es exitosa, este estado cambiar a
ACTIVE. Cuando el elemento no es fuente se copia directamente quedando en ACTIVE.
-------------------------------- STAGE: BG@ 003771 COMPONENTS ------------------ Row 1 to 1 of

1
0000
NAME TYPE STATUS CHANGED PROCNAME ID
REQUEST
Estado Activo del Elemento
9) Audit del Paquete de Cambios.
La funcin de Audit es usada para validar la integridad del contenido de las bibliotecas de Staging con
respecto al las bibliotecas de produccin (Baseline).
Para acceder al panel seleccionar del men principal la opcin 1 Bild y del submen la opcin 7 Audit.
-------------------------------------------- AUDIT CHANGE PACKAGE

-----------------------------------
COMMAND ===>

AUDIT STAGING LIBRARIES ONLY ===> NO (Y/N)
AUTO RESOLVE OF OUT-OF-SYNCHS ===> NO (Y/N)
INCLUDE HISTORY RECORDS ===> NO (Y/N)
FORMAT REPORT FOR PRINTING ===> NO (Y/N)
AUDIT PARTICIPATING PACKAGE
AS A SIMPLE PACKAGE ===> NO (Y/N)
AS A PRIMARY PACKAGE ===> NO (Y/N)
BY DEPARTMENT NUMBER ===> NO (Y/N)
CROSS APPLICATION AUDIT ===> NO (Y/N) - (Simple package only)
JOB STATEMENT INFORMATION:
===> //IDAEX19 JOB (ACCOUNT),'CHANGE MAN', <=== CHANGE
ACCORDINGLY___ ===> // CLASS=A,MSGLEVEL=(1,1), <=== CHANGE
ACCORDINGLY___
===> // NOTIFY=IDAEX19, <=== CHANGE
ACCORDINGLY___
===> // MSGCLASS=X <=== CHANGE
Panel del Audit

Campo Descripcin
PACKAGE ID Mdulo y nmero de Paquete sobre el cual se

efectuar el Audit.
AUDIT STAGIN LIBRARIES ONLY Seleccionar la opcin Y si se quiere checar

condiciones fuera de sincrona en las Biblioteca de
Staging.
AUTO RESOLVE OUT-OF-SYNCH Seleccionar Y si se desea que Change Man

automticamente resuelva algunas situaciones fuera
de sincrona. Esta opcin soluciona: SYNCH2,
SYNCH4, SYNCH5, SYNCH7, SYNCH8 y
SYNCH9.
Las validaciones de sincronismo que efecta Change Man son las siguientes:
SYNCH Situacin de No-Sincronismo Cdigo de Solucin

Retorno
DUPLIC (Staging Duplicates Baseline) 4 Borrar del Paquete (Slo en casos

especiales no se borrar).
.
SYNCH0 (Component Unknown) 0 Instalar con Change Man si es posible.
SYNCH1 (ISPF Statistics not Available) 0 No requiere solucin.
SYNCH2 (Compile/Designated Proc Difer) 12 Recompilar con procedimiento designado.
SYNCH3 (Unparsable Load Module) 0 No requiere solucin.
SYNCH4 (CPY Problem in Staging) 12 Recompilar la versin de staging.
SYNCH5 (CPY problem in baseline) 8 Recompilar desde Baseline.
SYNCH6 (Activity File not Checked out) 12 Hacer Check Out del archivo de actividad.
SYNCH7 (Called Subroutine in Staging) 12 Recompilar la versin de staging.
SYNCH8 (Called Subroutine in Baseline) 8 Recompilar la versin de Baseline.

SYNCH Situacin de No-Sincronismo Cdigo de Solucin

Retorno
SYNCH9 (Source and Load Discrepancy) 12 Realizar stage.
SYNCH10 (Version Regression Problem) 12 Rrealizar Check Out
SYNCH11 (Component Hash Discrepancy) 12 Realizar stage.
SYNCH12 (Orphan Module in Staging) 12 Borrar manualmente el componente de la

biblioteca de staging indicada en el Audit.
SYNCH13 (Baseline/Staging Discrepancy) 12 Realizar checkout y restage.
SYNCH14 (Components not in Active 12 Realizar stage.

Status)
SYNCH15 (Source to Copy Relationship 12 Realizar restage.

Problem)
SYNCH16 (Source to Copy Relationship 8 Recompilar desde baseline.

Problem)
SYNCH17 (CPY Deleted Problem in 12 Realizar stage del copy borrado.

Staging)
SYNCH18 (LOD Deleted Problem in 12 Realizar stage del load eliminado.

Staging)
El Cdigo de Retorno tendr que ser 0 para que sea vlido, pudiendo as continuar con el ciclo. En la
pantalla del Paquete el campo AUD se actualiza.
------------------------------------------- CHANGE PACKAGE LIST ------------------------------ Row 1 to 1 of

1
COMMAND ===> SCROLL ===> 0000
PACKAGE ID STA INSTALL LVL TYPE WORK REQUEST DEPT PROMOTE AUD CREATOR
__ BG@ 003771 DEV 20000720 SMPL PLN/PRM BK168 PRES STAGING 0 IDAEX19
************************************** Bottom of data
Cdigo de Retorno del Audit con 0

10) Freeze del Paquete de Cambios.
El proceso de Freeze es ejecutado para prevenir actualizaciones al Paquete una vez que los elementos han
sido copiados y compilados correctamente. Cuando se disponen a ejecutar esta opcin, Change Man
checa que el cdigo de retorno del Audit haya terminado con cero para as poder ejecutar el Freeze. Para
acceder al panel seleccionar la opcin 2 Freeze del men principal.
------------------------------------ FREEZE OPTIONS

--------------------------------
OPTION ===>
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 freeze
Automatic promotion after freeze ===> NO (Y/N)

Online or batch promotion ===> B (O-Online, B-Batch)

Panel de Opciones para Freeze
El Frezee se puede mandar del modo Online o Batch.
En caso de haber seleccionado la opcin Online se presenta la pantalla de ejecucin.
-------------------------------IN
PROGESS-------------------------------
Your screen is locked - please wait
Date: 2000/07/31 Time: 12:26
==============================================
| The Freeze function is performing the following task:
|
Pantalla de Ejecucin Online

Para el modo Batch se presenta la pantalla de Job.
----------------------------------------- FREEZE PACKAGE IN BATCH

-----------------------------------------
OPTION ===>
PACKAGE ID: BG@ 003771
JOB STATEMENT INFORMATION:

===> //IDAEX19 JOB (ACCOUNT),'CHANGE MAN', <=== CHANGE ACCORDINGLY___
===> // CLASS=A,MSGLEVEL=(1,1), <=== CHANGE ACCORDINGLY___
===> // NOTIFY=IDAEX19, <=== CHANGE ACCORDINGLY___
===> // MSGCLASS=X <=== CHANGE ACCORDINGLY___
Press ENTER to process; Enter END or CANCEL command to exit.

Pantalla de Freeze en modo Batch
El estado del elemento pasa de ACTIVE a FROZEN.
------------------------- -----------STAGE: BG@ 003771 COMPONENTS ----------------- Row 1 to 1 of 1

NAME TYPE STATUS CHANGED PROCNAME ID REQUEST
__ BG2C5210 SRC FROZEN 20001002 122705 CMNCOB2 IGCDAB
************************************ Bottom of data *********************************
Elemento en estado Frozen
El estado del Paquete tambin cambia a FRZ.
------------------------------------------ CHANGE PACKAGE LIST ---------------------- Row 1 to 1 of 1

CSR
PACKAGE ID STA INSTALL LVL TYPE WORK REQUEST DEPT PROMOT AUDCREATOR
__BG@ 003771 FRZ 20000820 SMPL PLN/PRM BK168 PRES STAGING 0 IGCDAB
*********************************** Bottom of data
Paquete en estado FRZ
Una vez concluido con xito esta fase, el Paquete de Cambios esta listo para ser Promocionado a los
ambientes de pruebas y aprobado en el ambiente de Produccin. A partir de este momento el campo
PROMOT se ir actualizando de acuerdo al ambiente donde se est promocionado, pudiendo quedar
como: CALI, TEST o FORM.

CSR
__BG@ 003771 FRZ 20000820 SMPL PLN/PRM BK168 PRES TEST 0 IGCDAB
*********************************** Bottom of data
Paquete Promocionado

Cuando el Paquete se encuentra en cualquiera de los ambientes prueba y se requiere efectuar

modificaciones, se deber solicitar la Despromocin de mismo al rea de Gestin de Cambios.
Cuando la Despromocin ha sido efectuada, el campo PROMOT queda nuevamente en STAGING, el

Audit y Freeze se siguen conservando. Para poder tener acceso a los elementos, el usuario deber dar
Revert al Paquete (lo que elimina la condicin de Freeze), por medio del comando RV en la Lnea del
Paquete. Aparecer una pantalla en la cual se deber proporcionar una breve descripcin del motivo del
Revert. El Paquete queda nuevamente en estado DEV.
---------------------------------------- REVERT REASONS

--------------------------------------
COMMAND ===>
PACKAGE ID: BG@ 003771 STATUS: FRZ INSTALL DATE: 20000820
===> Anexar Nuevo Elemento.

===>
===>
Descripcin del Motivo del Revert
11) Consideraciones Adicionales.

Una vez que el Paquete ha sido aprobado para ser instalado en el ambiente de Produccin, el campo STA
pasar de FRZ a APR. Si se desea conocer la fecha y hora de instalacin, en la Lnea del Paquete
introducir el comando U7 apareciendo el Panel de Fecha de Instalacin.

__BG@ 003771 APR 20000820 SMPL PLN/PRM BK168 PRES FORM 0 IGCDAB
******************************* Bottom of data ********************************
Paquete Aprobado para Instalacin en Produccin
Una vez que los Jobs de Aprobacin e Instalacin corrieron satisfactoriamente el estado del Paquete pasa
de APR a BAS (un estado intermedio es el de INS). Cuando el Paquete ya esta en Produccin, el nombre
del ambiente que el campo PROMOT tena, desaparece.

CSR
__BG@ 003771 BAS 20000820 SMPL PLN/PRM BK168 PRES 0 IGCDAB
********************************* Bottom of data ************************************
Paquete Instalado en Produccin

12) Otras Funciones de Change Man.

12.1) Recompilacin de Componentes.
El proceso de Recompilacin es similar al proceso de Staging, la diferencia radica en que al recompilar el

elemento fuente no es copiado a las bibliotecas de Staging del Paquete, solamente el mdulo de carga es
el que se incluye.
Se puede usar la funcin de Recompilacin para resolver algunos tipos de errores de sincrona
encontrados en el proceso de Audit.
Para acceder a este servicio seleccionar la opcin 1 Build del panel principal, y la opcin 8 Recompile
del submen.
----------------------------------- RECOMPILE SOURCE

---------------------------------
OPTION ===>
L - List libraries where component is found

blank - Display member selection list

COMPONENT NAME ===> (Blank or pattern for list)
SOURCE LIBRARY TYPE ===> SRC (Blank for list)
LANGUAGE ===> COBOL2 (Blank for list)
LIBRARY LEVEL ===> 0 (Baseline 0, Promotion 1 to
nn)
Panel de Recompilacin
Campo Descripcin
OPTION R
Recompilar un componente.
L
Listar bibliotecas donde el elemento sea
encontrado.
Blank
Despliega lista de seleccin
PACKAGE ID Mdulo y nmero de Paquete sobre el cual se

efectuar la recompilacin.
COMPONENT NAME Nombre del elemento a recompilar.

Campo Descripcin
SOURCE LIBRARY TYPE Nomenclatura del elemento.
LANGUAJE Nombre del lenguaje en el que est escrito el

elemento fuente.
LIBRARY LEVEL Seleccionar si se quiere recompilar desde Baseline

o de alguna biblioteca de Promocin.
RECOMPILE MODE Seleccionar si se desea recompilar en Lnea o

Batch.
12.2) Revisin de Versiones en Baseline.
Change Man permite visualizar los elementos que se encuentran en el ambiente de produccin evitando
as la creacin de un Paquete para efectuar un Checkout. Es posible utilizar el modo Browse o Edit. En
caso de que el elemento sea editado y modificado, al terminar la sesin, los cambios no se salvan;
asegurando as la integridad del componente.
Para acceder a esta funcin seleccionar la opcin 1 Build del panel principal, y la opcin B Browse del
submen .
----------------------------- BASELINE BROWSE/PRINT FACILITY

---------------------------
OPTION ===> B
L - List libraries where component is located

B - Browse C - Copy E - Browse in edit mode X - Print expanded
P - Print H - History S - View Stack of SRD
APPLICATION ===> BG@ (Blank for list)

LIBRARY LEVEL ===> 0 (Baseline 0 to -n; Promotion +1 to +n)
COMPONENT NAME ===> BG2C5210 (Blank or pattern for list)
MEMBER LIST SCAN ===> N (Y/N to build member list from scan
results)
RECORDS TO SELECT ===> 0 (0 = all)
CASE SENSITIVE ===> N (Y/N)
FROM COLUMN ===> 0 (0 = all)
TO COLUMN ===> 0 (Max = 80)
DATA STRING ===>
Panel para Visualizar/Editar Elementos en Produccin

Campo Descripcin
OPTION L
Lista todas las bibliotecas de Baseline o de
Promocin que contienen el componente
especificado.
B
Despliega el contenido de cualquier versin del
elemento indicado.
C
Copia el elemento a una biblioteca.
E
Edita el elemento en modo ISPF.
X
Imprime el componente incluyendo copys.
P
Imprime el componente sin incluir copys.
H
Muestra todos los Paquetes en que ha sido incluido
el elemento.
APPLICATION Mdulo al que pertenece el elemento.
LIBRARY TYPE Nomenclatura del componente.
LIBRARY LEVEL Nmero de versin que se quiere revisar.
COMPONENT NAME Nombre del elemento.
MEMBER LIST SCAN Con la opcin Y se genera una lista basada en una
bsqueda de cadena de caracteres.
RECORDS TO SELECT Nmero de registros a los que se le aplicar la

bsqueda.
CASE SENSITIVE Seleccionar Y si se requiere una bsqueda exacta de

la cadena introducida.
FROM/TO COLUMN Marcar el inicio y fin de las columnas a aplicar la

bsqueda.
DATA STRING Especificar la cadena de datos a buscar.

Existen muchas ms funciones y facilidades en Change Man que deben ser exploradas. No es objetivo de
este manual describirlas todas, sino acompaar al lector, a modo de resumen, por los principales pasos en
el ciclo de vida del Software.


Manual Changeman

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Manual Changeman

Hochgeladen von

Copyright:

Verfügbare Formate

CHANGE MAN

Elabor: Lic. Daniel Arellano Barrera.

Banco Bilbao Vizcaya-Mxico.

2) Ciclo de vida de un Paquete con Change Man1

3) Ingreso a Change Man.2

4) Uso de Acceso Directo de Navegacin... 3

5) Creacin del Paquete de Cambios... 3

6) Checkout de Componentes a Modificar .9

7) Lista del Paquete12

9) Audit del Paquete de Cambios. 18

10) Freeze del Paquete de Cambios 21

11) Consideraciones Adicionales 23

12) Otras Funciones de Change Man.. 24

12.1) Recompilacin de Componentes.. 24

12.2) Revisin de Versiones en Baseline 25

Banco Bilbao Vizcaya-Mxico.

Banco Bilbao Vizcaya-Mxico.

2) Ciclo de Vida de un Paquete con Change Man.

Checkout Modificacin Stage

Instalacin en Promocin Freeze

Diagrama del Ciclo de Vida

Banco Bilbao Vizcaya-Mxico.

3) Ingreso a Change Man.

OS/390 MENU PARA USUARIOS DESARROLLO

0 Settings L0 SDFS U0 DB2/I

Se muestra el men principal.

------------- CHANGE MAN 4.1.6A PRIMARY OPTION MENU

1 Build - Create, update and review package data

Press ENTER to process; enter END command to exit.

Men Principal Change Man.

Banco Bilbao Vizcaya-Mxico.

4) Uso de Acceso Directo de Navegacin.

COMMAND === > + A.B.C

COMMAND ===> = 1.2.1

5) Creacin del Paquete de Cambios.

Desde el men principal de Change Man seleccionar la opcin 1 Build.

------------- CHANGE MAN 4.1.6A PRIMARY OPTION MENU

1 Build - Create, update and review package data

Press ENTER to process; enter END command to exit.

Creacin del Paquete de Cambios

Banco Bilbao Vizcaya-Mxico.

---------------------------------- BUILD OPTIONS

0 Dates - Display the installation calendar

Se presenta la siguiente pantalla que permite la creacin del nuevo paquete.

------------------------- CREATE: CREATE A NEW PACKAGE

L Long method - Prompt for package description and special instructions

APPLICATION ===> (Blank or pattern for list)

Banco Bilbao Vizcaya-Mxico.

APPLICATION En un mximo de 4 caracteres se debe sealar el mdulo al que pertenecer

REQUESTERS NAME Nombre del Solicitante.

REQUESTERS PHONE Nmero telefnico o extensin del solicitante.

NUMBER Nmero de requerimiento IMA.

DEPARTMENT Departamento del solicitante (cuatro caractres).

PACKAGE LEVEL Simple

Banco Bilbao Vizcaya-Mxico.

PACKAGE TYPE Planned

PACKAGE TIME SPAN Permanent

UNPLANNED REASON Si se cre un Paquete implaneado se deber introducir el cdigo de la razn

Con los datos correspondientes se va llenado la Pantalla de Creacin.

------------------------- CREATE: CREATE A NEW PACKAGE ----------------------

L Long method - Prompt for package description and special instructions

APPLICATION ===> (Blank or pattern for list)

Press ENTER to process; Enter END command to exit.

Banco Bilbao Vizcaya-Mxico.