Utilidades

Se exponen en este capítulo algunas utilidades que se pueden emplear para realizar determinadas peticiones al núcleo del módulo de transmisión, para obtener listados auxiliares o para realizar altas de perfiles en batch.

Generación de mensajes A5P y E00

El JCL ZTBPJA5P, se utiliza para enviar al núcleo del módulo de transmisión mensajes A5P de tipo 1 a 4, 8 o A, ordenando el lanzamiento incondicional de los procedimientos previos / posteriores a emisión / recepción. También se puede enviar el mensaje E00 de petición de conexión. Se muestra un ejemplo a continuación.

//KI0E8A25 JOB (EGDI,KIT,,99),ZTBPJA5P,MSGCLASS=H,CLASS=A,
//             MSGLEVEL=1,NOTIFY=&SYSUID
//LIBPROC JCLLIB  ORDER=IMS510P.PROCLIB
//*------------------- EDITRAN ------------------------------------
//*             GENERACION DE A5P Y E00
//*    SYSIN: LOCAL REMOTO APLICACION TIPO
//*           LLLLLLLLLRRRRRRRRRAAAAAAT
//*      TIPO : A5P  1  PREPARACION E INICIO DE EMISION   LANZA A1P
//*                  8  PREPARACION DE EMISION             "    A8P
//*                  2  PREPARACION E INICIO DE RECEPCION  "    A2P
//*                  A  PREPARACION DE RECEPCION           "    AAP
//*                  3  DESCARGA DE EMISION                "    A3P
//*                  4  DESCARGA DE RECEPCION              "    A4P
//*             EOO  0  PETICION DE CONEXION
//*-----------------------------------------------------------------
//P1  EXEC IMSBATCH,MBR=ZTBPEA5P,PSB=ZTBPEA5P,IMSID=IMSP,PREFIX=IMS510P
//STEPLIB  DD DSN=IMS510P.RESLIB,DISP=SHR
//         DD DSN=IMS510P.PGMLIB,DISP=SHR
//         DD DSN=KI.EGDI.LOAD,DISP=SHR
//IMS      DD DSN=KI.EGDI.PSBLIB,DISP=SHR
//         DD DSN=KI.EGDI.DBDLIB,DISP=SHR
//DFSVAMP DD DSN=IMS510P.PROCLIB(DFSVSAMP),DISP=SHR
//SYSOUT   DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//PRINTDD  DD SYSOUT=*
//SYSDBOUT DD SYSOUT=*
//ABENDAID DD SYSOUT=*
//SYSIN    DD *
000099980000099940PRUEBA2
/*
// 

Se suministran los siguientes parámetros:

  • Código Local.

  • Código Remoto.

  • Código de Aplicación.

  • Cualificador o tipo de petición.

    • 1. Proceso previo a emisión y petición de emisión.

    • 2. Proceso previo a recepción y petición de recepción.

    • 3. Proceso posterior a emisión.

    • 4. Proceso posterior a recepción.

    • 8. Proceso previo a emisión sin petición de emisión.

    • A. Proceso previo a recepción sin petición de recepción.

    • 0. Petición de conexión.

El proceso realizado es el siguiente:

  • El programa batch inserta un mensaje A5P o E00, con la Sesión y el Cualificador, con destino a la transacción ZTD del módulo de transmisión

  • Esta transacción comprueba la existencia de la Sesión solicitada y si existe toma la transacción del núcleo del módulo de transmisión, normalmente ZTB1, del perfil de la misma, derivando el mensaje hacia dicha transacción.

  • Proceso de mensajes A5P.

    • El núcleo comprueba el estado de la Sesión correspondiente y si no está transmitiendo lanza el procedimiento solicitado tomado del perfil de la Sesión. El lanzamiento consiste generalmente en el arranque de una región (BMP orientada a transacción) y en la inserción de una petición de proceso contra una transacción.

    • El proceso lanzado dará eventualmente respuesta a Módulo de transmisión al finalizar, indicando si debe iniciarse la transmisión (caso de ser un procedimiento previo a emisión o recepción con petición de transmisión).

  • Proceso de mensajes E00.

    • El núcleo comprueba el estado de la Sesión y si no está conectada solicita la conexión.

Listado de la traza

La B.D. de traza se puede listar de forma selectiva con el JCL ZTBPJLTR del que se acompaña un ejemplo a continuación:

Los parámetros a introducir y las opciones de proceso están suficientemente comentados en el propio JCL.

Se puede observar que en el paso LISTEDI se obtiene el listado de la traza en un fichero, el cual puede enviarse a Indra, para análisis de posibles problemas e incidencias, utilizando el propio Editran.

Listado del log

La B.D. de log se puede listar de forma selectiva con el JCL ZTBPJLLO del que se acompaña un ejemplo a continuación:

Los parámetros a introducir y las opciones de proceso están suficientemente comentados en el propio JCL.

Se puede observar que en el paso LISTEDI se obtiene el listado del log en un fichero, el cual puede enviarse a Indra, para análisis de posibles problemas e incidencias, utilizando el propio Editran.

Listado de sesiones

Las Sesiones contenidas en la B.D. de perfiles se pueden listar de forma selectiva con el JCL ZTBPJLSE del que se acompaña un ejemplo a continuación:

Los parámetros a introducir están comentados en la cabecera del propio JCL.

Mensaje A6P

El mensaje A6P se puede enviar al núcleo de Módulo de transmisión para pedirle información sobre una sesión determinada. Dicho núcleo enviaría la respuesta A6R a una transacción IMS de usuario proporcionada en el propio A6P.

Este mensaje podría ser enviado por una aplicación usuaria que podría realizar funciones de planificación y monitorización de las transmisiones de Módulo de transmisión.

No existe constancia de que se haya usado este mensaje por parte de alguna entidad usuaria en versiones anteriores a la 3.0, y es muy probable que no se vaya a utilizar en el futuro, ya que se requerirían desarrollos por parte del usuario y además Indra puede proporcionar herramientas estándar de monitorización.

En todo caso, ya que es posible en Editran 5.1 el empleo del mensaje A6P, se acompaña una breve descripción que podría ser ampliada, en caso de necesidad, contactando con Indra.

El diseño mensaje A6P, ya preparado para ser insertado desde un programa COBOL a una transacción de núcleo de Módulo de transmisión, es el siguiente:

Habría que rellenar:

  • LL-ENT con la longitud del mensaje

  • COD-TRAN-ENT con la transacción del núcleo tomado de perfiles, normalmente ZTB1.

  • ID-OENT = A

  • CLAVE-OENT = A6P

  • SESION-OENT con la Sesión del módulo de transmisión

  • APLIC-USER-A6P-OENT con el código de transacción del usuario que debe recibir la respuesta A6R.

El diseño del mensaje A6R, que recibiría la transacción de usuario especificada en el A6P, es el siguiente:

Los campos ESTADO-EMISION y ESTADO-RECEPCION pueden tener los valores siguientes:

  • 0 No conectado

  • 1 En sesión

  • >1 En transmisión

Los campos CONTADOR-EMISION y CONTADOR-RECEPCION tienen el número de registros emitidos y recibidos respectivamente.

Altas de perfiles Batch Onesait Editran

Consulte el manual Gestor Batch de Perfiles.

Modificación de perfiles Batch Onesait Editran

Consulte el manual Gestor Batch de Perfiles.

Última actualización