Manual de usuario Chgman S/390

Control de versiones

08/12/21 Control de versiones 1

 Índice

Contenido
1. Objetivos
2. Chgman
3. Creación de paquetes
4. Listar paquetes
5. Stage
6. Checkout
7. Audit
8. Freeze
9. Promote/Demote
10. Approve
11. Backout
12. Revert
13. Opciones List package
14. Opciones componet
15. Synch
16. Esquema de flujo
08/12/21 Control de versiones 2
 Objetivos
Conocer cual es el uso, es decir para que sirve chgman, su funcionamiento y sus
alcances.

08/12/21 Control de versiones 3

 Chgman
El producto Chgman es el encargado de administrar los componentes (pgms, jcls,
procs, etc.) desde su creación hasta su puesta en producción, así como
modificaciones posteriores, generando respaldos en producción (versionar), el
acceso al producto en desarrollo méxico es con la opción 17.

S1 BASELINE
C1
Lib.Usuario BASELINE
BASELINE

PROD
A1 PROD
STAGE PROD
B1

PD PD

PD

1.-DESA 2.-TEST 3.-IMPL

08/12/21 Control de versiones 4

 Chgman
Opción de menú principal Partición desarrollo MXD1

08/12/21 Control de versiones 5

 Chgman
El producto Chgman es el encargado de administrar los componentes (pgms, jcls,
procs, etc.) desde su creación hasta su puesta en producción, así como
modificaciones posteriores, generando respaldos en producción (versionar), el
acceso al producto en desarrollo méxico es con la opción 17.

08/12/21 Control de versiones 6

 Chgman
La opción de acceso al producto puede variar dependiendo del procedimiento de
logon que se este usando o ambiente en el que se este laborando. Además del
control de componentes en el producto se compila, realiza link, bind, newcopy,
cambia estandares en los entornos y ejecuta el módulo de calidad.

08/12/21 Control de versiones 7

 Creación de paquetes
Un paquete(package) o expediente como también se le conoce, es la unidad de
manejo en chgman, en él se integran los diferentes componentes a migrar a
producción, a continuación veremos las opciones para creaer un paquete.

08/12/21 Control de versiones 8

 Creación de paquetes
Con la creación de un paquete, iniciamos en chgman el camino hacia producción,
paso a paso veremos las opciones principales y sus diferentes funciones, así como
los productos relacionados y entornos.

08/12/21 Control de versiones 9

 Creación de paquetes
Los tipos de paquetes que se pueden crear son (Simple, Complex y Participating)
Nos refreriremos al tipo Simple, ya que es el de uso común.
Es importante mencionar que el producto no te permitirá avanzar si no cumples con
los campos obligatorios.

08/12/21 Control de versiones 10

 Creación de paquetes
Dos de los campos obligatorios son la fecha y hora de instalación del paquete, para
el manejo de paquetes la fecha debe ser la actual o posterior.

08/12/21 Control de versiones 11

 Creación de paquetes
Una vez cumpliendo con los requisitos chgman te enviará en la parte superior
derecha la identificación de tu paquete, la cuál se compone del nombre de la
aplicación y un número asignado. Se procederá a introducir componentes al
paquete.

08/12/21 Control de versiones 12

 Listar paquetes
Para listar y manejar los paquetes tenemos la opción 5 del menú principal, se
puede navegar entre menús usando el signo =, y la opción requerida, en este caso

sería =5.

08/12/21 Control de versiones 13

 Listar paquetes
En este panel se requiere especificar la identificación del paquete para acceder a
éste y se puede ampliar la vista de uno o varios paquetes mediante las diferentes
opciones que muestra el panel. (aplicación, tipo, fecha de instalación, creador del
paquete, status, etc. )

08/12/21 Control de versiones 14

 Opción stage
En el panel de listar paquetes (Change Package list) podemos podemos aplicar
diferentes acciones sobre un paquete sin regresar a menus previos para realizarlas,
estas opciones se pueden ver aplicando el comando OPTIONS en la linea de
comandos, la opción S1 es una de estas opciones.

08/12/21 Control de versiones 15

 Opción stage
Para llegar a este panel dimos a la izquierda del paquete la opción S1 (stage), esta
opción nos permite alimentar componentes a un paquete siempre y cuando no
existan en producción, es decir componentes nuevos. Por lo tanto requerirá
especificarle la librería(externa al producto) donde se encuentran los componentes.

08/12/21 Control de versiones 16

 Opción stage
Una vez cumpliendo los requisitos del panel anterior nos mostrará el contenido de
la librería especificada, donde seleccionaremos los componentes a incluir en el
paquete, dependiendo el tipo de componente chgman tomará diferentes acciones.

08/12/21 Control de versiones 17

 Opción stage
En el caso de stage a programas mostrará el panel de compilación donde se
tendrán que definir la opciones que requiere el programa para su compilación, es
importante y requisito que se incluyan las tarjetas de Job.
(JOB STATEMENT INFORMATION),

08/12/21 Control de versiones 18

 Opción stage
En los casos de que el programa contenga instrucciones de DB2 y se haya marcado
en la opción del panel anterior, se presentará el siguiente panel donde se debe
seleccionar el subsistema de DB2 con el cuál trabajará la compilación, debe ser el
de desarrollo

08/12/21 Control de versiones 19

 Opción stage
Una vez cumplidos los pasos anteriores enviará el mensage de que el componente
ha sido puesto en el paquete (staged), si fue pgm. y se procedió a compilarlo se
estará ejecutando un job. Al termino de éste el pgm. debe aparecer en estado
ACTIVE. en el paquete.

08/12/21 Control de versiones 20

 Opción stage
Este panel aparecerá por si deseamos dar stage a otros componentes, de lo
contrario presionaremos la tecla F3, para regresar a la opción PACKAGE LIST.

08/12/21 Control de versiones 21

 Opción stage
En este panel que es opción de DA de SDSF; nos muestra la ejecución del job de
compilación, este se identificará de acuerdo a nuestras tarjetas de job que estemos
utilizando.

08/12/21 Control de versiones 22

 Opción stage
Con la opción S2 validaremos que se encuentren en el paquete los componentes a
los cuales le realizamos stage.

08/12/21 Control de versiones 23

 Opción stage
Dentro del paquete mostrará el componente y su estado, en este momento se
encuentra INCOMP, el job de compilación puede estar ejecutandose aún, o tuvo
alguna falla, es necesario monitorear el job.

08/12/21 Control de versiones 24

 Opción stage
Ahora nos muestra el estado ACTIVE, que es el correcto despues de una
compilación satisfactoria.
En este panel se aplicó un comando invalido por lo que el producto nos envía el
mensaje de INVALID COMMAND y la lista de comandos correctos.

08/12/21 Control de versiones 25

 Opción checkout
La opción CHECKOUT, a diferencia de la de STAGE, es que ésta se usa para
componentes que ya estan en produccíon (baseline) y el objetivo es el mismo,
alimentar un paquete con componentes para su recompilación y/o modificación.

08/12/21 Control de versiones 26

 Opción checkout
Estas son las opciones del panel de checkout, es importante especificar que la
ultima versión que es la que esta en producción es la 0, el modo de checkout es
Online

08/12/21 Control de versiones 27

 Opción checkout
Ya que el componente se encuentra en el paquete se procederá a realizar las
modificaciones y compilación. Al final el estado de éste debe ser Active.

08/12/21 Control de versiones 28

 Opción checkout
Cuando se realiza una modificación a un componente, el producto nos envía un
reporte de comparación y opciónes de manejo de este reporte, posterior a esto,
nos solicitará compilación si es necesaria.

08/12/21 Control de versiones 29

 Audit package
Esta opción valída la sincronía de los componentes entre el paquete y Baseline.

08/12/21 Control de versiones 30

 Audit package
Este es el panel de audit y las opciones con las cuales se debe ejecutar.
El proceso de audit se ejecuta en modo Batch y los resultados aparecen en las
salidas (sysouts) del job.

08/12/21 Control de versiones 31

 Audit package
El resultado del proceso de audit es reflejado abajo del campo AUD. y este no debe
ser mayor a 4. Ya que de ser mayor es que encuentra errores y no te permitirá
promover mas allá de entornos básicos. Ni dar freeze al paquete.

08/12/21 Control de versiones 32

 Opción freeze
Cuando tu paquete a sido auditado satisfactoriamente se procede a dar freeze a
éste, con esta opción congelas tu paquete para que no sea modificado.

08/12/21 Control de versiones 33

 Opción freeze
Este panel te lo muestra al momento de dar freeze a tu paquete, ademas de
congelarlo esta contruyendo los jobs que usará al momento de instalación.

08/12/21 Control de versiones 34

 Opción freeze
Una vez congelado tu paquete el campo de estado (STA) aparecerá como FRZ. Con
lo que te permitirá llevarlo a los entornos de calidad (QA) y una vez realizadas las
pruebas satisfactoriamente llevarlo a producción.

08/12/21 Control de versiones 35

 Opción promote/demote
La opción de promote / Demote se aplica dando a la izquierda del paquete PD y
nos muestra este panel donde seleccionamos lo requerido. El promote es
secuencial por cada uno de los entornos, el demote es siempre a STAGING. O
STAGE .

08/12/21 Control de versiones 36

 Opción promote/demote
Es recomendable el manejo de estas opciónes de forma FULL, la opción promote se
ejecuta de foma batch y realiza una copia de componentes del paquete a el
entorno o nivel indicado. El demote solo cambia el estado del nivel de promoción a
staging con esto nos permite modificaciónes nuevamente al paquete.

08/12/21 Control de versiones 37

 Opción promote/demote
Las acciones de promote y demote son reflejadas en el campo PROMOTE.
Dentro del job de promoción se realizan (binds, newcopys y estandarización de
componetes de acuerdo al entorno).

08/12/21 Control de versiones 38

 Opción approve
Una vez probada y autorizada la funcionalidad de los componentes que integran el
paquete se procede a su puesta a producción y baseline, esta se realiza con la
opción approve.

08/12/21 Control de versiones 39

 Opción approve
Requerirá la intervención de el o los departamentos involucrados para su
autorización

08/12/21 Control de versiones 40

 Opción approve
Validará la correcta construcción de los jobs de instalación

08/12/21 Control de versiones 41

 Opción approve
Cambiará su estado al de APR, en estos momentos valída fecha de instalación si
esta su cumple inicia su instalación en producción, esta consta de respaldos y
actualización de producció, además realiza (bind y newcopy) a los que lo
requieran.

08/12/21 Control de versiones 42

 Opción approve
Una vez realizada su instalación INS, continuará con el proceso y actualizará
baseline, generando respaldo y actualizaciones.

08/12/21 Control de versiones 43

 Opción approve
Concluido el proceso el estado del paquete se reflejará como BAS y el proceso de
instalación se ha terminado.

08/12/21 Control de versiones 44

 Opción backout
Esta opción nos permite dar regreso completo a la instalación del paquete.

08/12/21 Control de versiones 45

 Opción backout
Es necesario especifiacar la causa de su regreso.

08/12/21 Control de versiones 46

 Opción backout
El paquete mostrará el estado de BAK. En este estado no esta disponible para
modificarse el paquete.

08/12/21 Control de versiones 47

 Opción revert
Esta opción nos sirve para poner disponible un paquete despues de un revert o
tambien para quitarle la opción freeze.

08/12/21 Control de versiones 48

 Opción revert
Requiere de especificar las causas del revert.

08/12/21 Control de versiones 49

 Opciones List Package
Estas opciones estan disponible en diferentes menus del producto pero pueden ser
eccesadas desde package list y estan limitadas por autoridad o instalación del
producto.

08/12/21 Control de versiones 50

 Opciones List Package
Ejemplos:
La opcion A1, solo personal autorizado la puede realizar.
La opcion Freeze y Stage, se realizan de manera Online.

08/12/21 Control de versiones 51

 Opciones a nivel componente
A continuación tenemos las opciones a nivel componente las cuales nos muestran
las diferentes acciones que se pueden realizar sobre un componente en chgman.

08/12/21 Control de versiones 52

 Errores Synch, en audit
Estos son los diferentes errores de sincronía por lo cuál no termina
satisfactoriamente el audit de un paquete, en el job de audit muestra las acciones a
tomar por cada tipo de error synch.

08/12/21 Control de versiones 53

 Esquema del flujo en chgman
Aquí tenemos el esquema de flujo dentro de chgman hacia producción.

S1
C1
Lib.Usuario
BASELINE

A1
STAGE PROD
B1

PD PD

PD

1.-DESA 2.-TEST 3.-IMPL

08/12/21 Control de versiones 54