EDItran 5.0. Recuperación de transmisiones. z/os IMS. Manual de usuario e instalación

Transcripción

1 EDItran 5.0 Recuperación de transmisiones z/os IMS Manual de usuario e instalación Indra. Marzo de EE50RECI Recuperación de transmisiones.doc.

2 Indra. La información aquí contenida puede ser objeto de cambios sin previo aviso. Las distintas versiones del producto pueden dar lugar a cambios, adiciones o supresiones de información en este manual. La correspondencia acerca de este manual debe realizarse en la hoja de comentarios aquí incluida y debe ser dirigida a Indra, Producto EDItran, Avda. de Bruselas, 35 Madrid, Comentarios de usuario sobre esta documentación. Exprese, y háganos llegar, su opinión y comentarios acerca de la documentación entregada y así podremos corregirla en las posteriores versiones de este documento. Indra. Producto: EDItran 5.0 z/os IMS Manual de usuario e instalación Referencia: EE50RECI Recuperación de transmisiones.doc Avda. de Bruselas, MADRID. Empresa : Departamento: Contacto : Dirección :

3 EDItran 5.0. z/os IMS Manual de usuario e instalación. Índice 1. INTRODUCCIÓN OPERACIÓN ON-LINE Histórico de presentaciones finalizadas con/sin incidencias PROCESO BATCH DE RECUPERACIÓN DE FICHEROS Procedimiento de recuperación ZTBEPRE INSTALACIÓN CONTENIDO DE LA INSTALACIÓN JCLs Ejecutables PASOS A SEGUIR EN LA INSTALACIÓN Prerrequisitos Obtención de las librerías Definiciones IMS Inicialización de ficheros Adaptación de procedimientos y transacciones Indra. Todos los derechos reservados EE50RECI Recuperación de transmisiones.doc10/03/2008 Pag. i.1

4 1. Introducción. 1. Introducción. La recuperación de trasmisiones permite la repetición de una transmisión efectuada anteriormente. Se apoya en el sistema de estadísticas y permite seleccionar una determinada trasmisión para visualizar los datos que se enviaron y/o enviarlos de nuevo. Si la transmisión se realizó desde ficheros de aplicación ordinarios, el proceso recupera la lista de ficheros y los incluye en la nueva trasmisión. La trasmisión será correcta si estos ficheros existen y contiene los datos que tenían en aquel momento. Un operador podrá visualizar su contenido para cerciorarse. Si la trasmisión se realizó por macroficheros, el sistema de estadísticas no tiene constancia del nombre del macrofichero y, además, el fichero que se asignó a la sesión contendrá datos de la última carga o no existirá. En este caso se agrega un log de macroficheros al proceso de carga por macrofichero que graba la carga realizada y el nombre del macrofichero que se empleó. Este nombre deberá ser distinto para cada emisión, admitiéndose un fichero generacional. La trasmisión se recupera realizando una carga por macrofichero con el macrofichero empleado en aquella ocasión. También se puede visualizar previamente su contenido. En ambos casos el lanzamiento del proceso se realiza eligiendo una presentación desde la consulta de sesiones históricas. Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.1-1

5 2. Operación on-line. 2. Operación on-line DD/MM/AA ESTADISTICAS Y MONITORIZACION EDITRAN HH:MM:SS MENU PRINCIPAL PRESENTACIONES INTERRUMPIDAS 2 - PRESENTACIONES EN CURSO 3 - PRESENTACIONES FINALIZADAS 4 - TRANSMISIONES INTERRUMPIDAS 5 - TRANSMISIONES EN CURSO O EN ESPERA DE FINALIZACION 6 - TRANSMISIONES FINALIZADAS 7 - PRESENTACIONES FINALIZADAS SIN INCIDENCIAS (HISTORICO) 8 - PRESENTACIONES FINALIZADAS CON INCIDENCIAS (HISTORICO) OPCION...: SENTIDO (E/R)...: SESION...: NNNNNNN - NNNNNNN - FECHA - HORA...: DDMMAAAA - HHMMSS (DDMMAAAA - HHMMSS) (* SELECCION GENERICA) < INTRO > REALIZAR CONSULTA < PF3 > SALIR La recuperación de la transmisión se lanza desde las opciones 7 y 8 de la consulta del Sistema de estadísticas y monitorización, que corresponden con las sesiones de presentación históricas Histórico de presentaciones finalizadas con/sin incidencias. En esta pantalla se podrá seleccionar una presentación para su recuperación siempre y cuando la presentación sea de emisión y contenga ficheros. Tecleando R, C,? o V en el campo de selección se lanzará el proceso de recuperación informándose en esta misma pantalla del resultado del lanzamiento. R recupera los ficheros emitidos, los visualiza y solicita una petición de emisión de esta sesión. Si la sesión estaba emitiendo no se producirá carga. C recupera los ficheros (visualizándolos) y solicita una petición de carga sin emisión. Si la sesión estaba cargada o emitiendo se producirá un error.? recupera los ficheros y solicita una inicialización de estados y una petición de emisión. La carga y emisión es incondicional y no dependerá del estado de la emisión. Si la sesión estaba cargada o emitiendo se interrumpirá la emisión y se perderá aquella carga. V recupera los ficheros y únicamente los visualiza. Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.2-1

6 2. Operación on-line. 12/06/00 ESTADISTICAS Y MONITORIZACION EDITRAN 12:18:44 PRESENTACIONES FINALIZADAS SIN INCIDENCIAS 5.0 FECHA-HORA FECHA-HORA S INICIO FIN SESION DE PRESENTACION E/R DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN DDMMAA-HHMMSS DDMMAA-HHMMSS NNNNNNNNNNNNNN <E/T> SELECCION, <PF8> AVANZAR, <PF7> RETROCEDER, <PF3> PANTALLA ANTERIOR El lanzamiento de la recuperación se produce enviando un mensaje a la transacción estándar de interfaz de aplicación ZTBI y ejecutando la región ZTBGJIG que arranca a la interfaz. La interfaz lanzará la ejecución del procedimiento de recuperación ZTBEPRE con las fichas de JCl de la sesión implicada. Los ficheros que se recuperarán serán los que ésa presentación cargó en aquella trasmisión. Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.2-2

7 3. Proceso batch de recuperación de ficheros. 3. Proceso batch de recuperación de ficheros. La recuperación (y envío o carga) se ejecuta en un proceso especial ZTBEPRE que es lanzado por la interfaz de procesos batch de EDItran/P. La ejecución consiste en un EEC PROC de este procedimiento bajo las fichas de JCl de la sesión de presentación de EDItran/G. El proceso tiene varios pasos que se ejecutan condicionalmente según la opción elegida y si la carga se realizó por macroficheros o no. El primer paso determina si la carga utilizó macroficheros. Esto lo deduce de la existencia en la sesión de presentación de PARAMETROS APL. Si la sesión contiene este campo, aunque la carga se realizara ordinariamente, se seguirá el camino de macroficheros. El segundo paso rescata la lista de nombres de ficheros. Si la carga es ordinaria, buscará en el fichero histórico de presentaciones los ficheros que se cargaron en aquella trasmisión. La referencia que toma es la clave de registro que le suministró la transacción de monitorización que lanzó el proceso, por lo que deberá encontrarla (salvo que la trasmisión fuese borrada del histórico entre el lanzamiento y la ejecución del proceso) Si la carga utilizó macroficheros se buscará en el fichero de log de macroficheros una presentación que se cargase entre la fecha de inicio y fin de la presentación. Si la presentación se cargó sin utilizar este log o el log ha sido inicializado( o ha dado la vuelta) no se encontrará la presentación. Si encuentra la carga, llamará al programa de carga de macroficheros para que rellene el fichero de emisión con los datos del macrofichero utilizado en aquella carga. Para que el proceso sea correcto el macrofichero debe existir y contener los datos originales. Cada carga debe emplear un macrofichero con nombre distinto. El resultado en ambos caso es una lista de ficheros para los pasos siguientes. El siguiente paso visualiza los ficheros escribiendo en la DDNAME ZTBEFL03 el contenido de los primeros 10 registros de cada fichero. En el caso de macroficheros el fichero que se lista es el fichero de emisión con los datos cargados previamente. El último paso ejecuta la carga, carga y emisión o inicialización y emisión de la sesión. Si se utilizó macrofichero la carga se realiza a través de proceso de carga por macroficheros, lo que permite recuperar una sesión que se cargó por recuperación. Con opción V de visualización este paso no se ejecuta Procedimiento de recuperación ZTBEPRE. Los pasos descritos anteriormente se identifican como ZTBEBRE1 para la captura de datos. ZTBEBRE2 para la obtención de la lista de ficheros. ZTBEBRE5 para la obtención de la lista por macroficheros. ZTBEBRE3 para el listado de los ficheros. ZTBEBRE4 para su carga / emisión. // PROC FU=,L0=,L1=,L2=,R1=,R2=,AP=,ER=,FHI=,FHF=,CL= //* //* PROCEDIMIENTO DE RECUPERACION DE TRASMISIONES V4.0 * Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.3-1

8 3. Proceso batch de recuperación de ficheros. //* //* DEVUELVE 0 SI ES CARGA ORDINARIA, 1 SI ES MACROFICHERO //ZTBEBRE1 EEC PGM=ZTBEBRE1,REGION=4M, // PARM='&FU&L1&L2&R1&R2&AP&ER&FHI&FHF&CL' //ZTBGFPER DD DSN=KI.EGDI.ZTBG.PERFILES,DISP=SHR //ZTBEFPAR DD DSN=&&PAR,DISP=(NEW,PASS,DELETE), // UNIT=SYSDA,SPACE=(TRK,(1,1),RLSE), // DCB=(RECFM=FB,LRECL=109,BLKSIZE=0,DSORG=PS) // IF (RC = 0) THEN CARGA ORDINARIA //* OBTIENE LISTA DE FICHEROS DE ESTADÍSTICAS //ZTBEBRE2 EEC IMSBATCH,MBR=ZTBEBRE2, // PSB=ZTBEE002,IMSID=IMSP,PREFI=IMS510P //ZTBEFPAR DD DSN=&&PAR,DISP=(OLD,PASS) //ZTBGFCAR DD DSN=&&CAR,DISP=(NEW,PASS,DELETE), // UNIT=SYSDA,SPACE=(TRK,(1,1),RLSE), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0,DSORG=PS) // ELSE CARGA POR MACROFICHEROS //* OBTIENE LISTA DE FICHEROS DEL LOG DE CARGAS DE MACROFICHEROS //ZTBEBRE5 EEC PGM=ZTBEBRE5,REGION=4M,COND=(1,NE,ZTBEBRE1), // PARM='&FU&L1&L2&R1&R2&AP&ER&FHI&FHF&CL' //STEPLIB DD DSN=IMS510P.RESLIB,DISP=SHR // DD DSN=KI.EGDI.LOAD,DISP=SHR //*ZTBGFEST DD DSN=KI.EGDI.ZTBG.ESTADOS,DISP=SHR //ZTBGFPER DD DSN=KI.EGDI.ZTBG.PERFILES,DISP=SHR //ZTBGFLOG DD DSN=KI.EGDI.ZTBG.LOG,DISP=SHR //ZTBGF032 DD DSN=KI.EGDI.ZTBG.ZTBGF032,DISP=SHR //ZTBGFERR DD DSN=KI.EGDI.ZTBG.ZTBGFERR,DISP=SHR //ZTBEFLOG DD DSN=KI.EGDI.ZTBE.LOG,DISP=(SHR) //ZTBGFCAR DD DSN=&&CAR,DISP=(NEW,PASS,DELETE), // UNIT=SYSDA,SPACE=(TRK,(1,1),RLSE), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=6160) //ZTBEFPAR DD DSN=&&PAR,DISP=(OLD,PASS) // ENDIF //* //* LISTA CONTENIDO DE FICHEROS //* //ZTBEBRE3 EEC PGM=ZTBEBRE3,REGION=4M,COND=(1,LT) //STEPLIB DD DSN=KI.EGDI.LOAD,DISP=SHR //ZTBGFCAR DD DSN=&&CAR,DISP=(OLD,PASS) //ZTBEFL03 DD SYSOUT=* //* CARGA EMITE FICHEROS //ZTBEBRE4 EEC PGM=ZTBEBRE4,REGION=4M,COND=(1,LT), // PARM='&FU&L1&L2&R1&R2&AP&ER&FHI&FHF&CL' //*ZTBGFEST DD DSN=KI.EGDI.ZTBG.ESTADOS,DISP=SHR //ZTBGFPER DD DSN=KI.EGDI.ZTBG.PERFILES,DISP=SHR //ZTBGF032 DD DSN=KI.EGDI.ZTBG.ZTBGF032,DISP=SHR //ZTBGFTCO DD DSN=KI.EGDI.ZTBG.ZTBGFTCO,DISP=SHR //ZTBGFERR DD DSN=KI.EGDI.ZTBG.ZTBGFERR,DISP=SHR //ZTBGFCAR DD DSN=&&CAR,DISP=(OLD,PASS) //* UTILIZAMOS LOCAL0 PARA QUE NO DE ERROR DE JCL, PERO ES FICTICIO // SET LOCAL0=&L0 La ejecución procuce la siguiente salida. J E S 2 J O B L O G -- S Y S T E M C P U B -- N O D E N O D O M V S B JOB THURSDAY, 07 FEB JOB01805 IRR010I USERID KIIMSPR IS ASSIGNED TO THIS JOB JOB01805 ICH70001I KIIMSPR LAST ACCESS AT 20:10:10 ON THURSDAY, FEBRUAR JOB01805 $HASP373 KI05AF1I STARTED - INIT 7 - CLASS A - SYS CPUB JOB01805 IEF403I KI05AF1I - STARTED - TIME= JOB TIMINGS (M JOB JOBNAME STEPNAME PROCSTEP RC ECP CONN TCB SRB JOB KI05AF1I PASO1 ZTBEBRE JOB KI05AF1I ZTBEBRE2 G JOB KI05AF1I PASO1 ZTBEBRE5 FLUSH JOB KI05AF1I PASO1 ZTBEBRE JOB KI05AF1I PASO1 ZTBEBRE Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.3-2

9 3. Proceso batch de recuperación de ficheros JOB01805 IEF404I KI05AF1I - ENDED - TIME= JOB KI05AF1I ENDED. NAME-EDITRAN TOTAL TCB CPU TIM JOB01805 $HASP395 KI05AF1I ENDED JES2 JOB STATISTICS NOMBRE FICHERO :KI.EGDI.F01 REGISTRO NUMERO : 1 abcdefghijklmnopqrstuvwxyz EDItran/G: 07/02/ :10:12. Ses-ZTG= / /PRUEBA. ZTG0020: PETICION DE EMISION DE PRESENTACION EDItran/G: 07/02/ :10:14. Ses-ZTG= / /PRUEBA.Ses- EDItran= / /PRUEBA ZTG0015: SE SOLICITA PETICION DE EMISION A EDITRAN (A1R) Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.3-3

10 4. Instalación 4. INSTALACIÓN Se relacionan en estas especificaciones los elementos que componen el Sistema de Monitorización y Estadísticas EDItran/E versión 4.1 en el entorno IMS y los pasos a seguir para su instalación. Los nombres de los elementos están normalizados y empiezan todos por ZTBE CONTENIDO DE LA INSTALACIÓN JCLs ZTBEJRE0 ZTBEPRE Ejecutables ZTBEBRE0 ZTBEBRE1 ZTBEBRE2 ZTBEBRE3 ZTBEBRE4 ZTBEBRE5 ZTBEBRE PASOS A SEGUIR EN LA INSTALACIÓN Prerrequisitos Para la instalación de la facilidad de Recuperación de transmisiones es necesario tener instalada la fase 8 de EDItran 4.0. Además se deberá tener operativo el Subsistema de monitorización y estadísticas EDItran/E Obtención de las librerías Se obtendrán, normalmente, ficheros formato IEBCOPY vía el propio EDItran que se volcarán en las librerías correspondientes verificando que su contenido coincide con la lista de módulos indicada anteriormente Definiciones IMS La transacción estándar de consulta de estadísticas ZTBC deberá estar autorizada a emitir el comando /START REGION Inicialización de ficheros Se inicializa el fichero de log de macroficheros mediante el JCL ZTBEJRE0. Este fichero se incluirá en los procedimientos de carga por macroficheros con DDNAME ZTBEFLOG y coincidirá con el fichero ZTBEFLOG del procedimiento de recuperación ZTBEPRE Adaptación de procedimientos y transacciones La ejecución del proceso de recuperación se realizará lanzando, desde IMS, un mensaje a la transacción ZTBI y arrancado la región ZTBPJIG. Los nombres no pueden ser modificados. La transacción y el proceso deberán corresponderse con la transacción de Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.4-1

11 4. Instalación Interfase de Aplicación (IGA), que genera los procesos batch de EDItran/G, en su nomenclatura estándar. Deberá existir un procedimiento, en la librería de procedimientos de EDItran/G, con nombre ZTBEPRE para la recuperación de trasmisiones. Para recuperar las transmisiones cargadas por el procedimiento de macroficheros el procedimiento de carga (ZTBGPMCR en su nombre estándar) se modificará para incluir el fichero de log de macroficheros. Se incluirá bajo la DDNAME ZTBEFLOG y coincidirá el utilizado en el procedimiento ZTBEPRE. //ZTBEFLOG DD DSN=KI.EGDI.ZTBE.LOG,DISP=SHR Indra EE50RECI Recuperación de transmisiones.doc 10/03/2008 Pag.4-2

12 BARCELONA Avda. Diagonal, 218, 3ª BARCELONA BILBAO Henao, 4, 4ºA BILBAO MADRID Avda. de Bruselas, MADRID SEVILLA Avda. San Francisco Javier, 22, 6º SEVILLA VALENCIA Colón, VALENCIA