EDITRAN/T
Contents
1. 7 2 7 4 PRUEDAS E 7 2 8 ANEXO ai a E aaa aaae raaa aeaaea apra eaaa aaraa aa a Rae RR Rara 8 1 8 1 DIAGRAMA BLOQUES 32n4aua ibas tanata doan asana enoaan ae Saraan eana aaeanoa ADA EEUU TEIN 8 1 8 2 REA DE COMUNICACI N ENTRE INTERFAZ Y LA APLICACI N 5 8 2 2 1 LONGITUD M XIMA DEDOS aa iaa a i aaa iiaia 8 2 8 2 2 C DIGOS DE RESULTADO Y RAZ N inicio rs 8 4 8 6 3 CONTENIDO DEL ATRIBUTO deciden dea donde 8 4 INDRA Todos los derechos reservados EDITRAN T EDITRAN T CICS Manual de usuario e Instalaci n 1 INTRODUCCION 1 INTRODUCCION Existe un n mero apreciable de aplicaciones con la necesidad de realizar consultas de ordenador a ordenador en las que la exigencia de la rapidez prima frente a la posibilidad de perder una respuesta que por ser una consulta puede repetirse sin ning n problema Una soluci n a esta necesidad es la utilizaci n por parte de las aplicaciones usuarias de los servicios facilitados por EDITRAN T que a su vez se apoya en la funcionalidad de EDITRAN P El presente documento especifica los pasos a seguir para la implementaci n de soluciones de comunicaciones avanzadas basadas en el produc2. Una vez completada el rea de comunicaci n de la interfaz de EDITRAN T con los datos del punto anterior se realizar la petici n de env o con Funci n 01 y Primitiva 00 Con una CALL din mica CALL USING DFHEIBLK O mediante el comando CICS LINK COMMAREA AREA ZTBTO001 En el caso de abend en la interfaz si la llamada se hizo con CALL din mica la transacci n devolver el control al CICS Si se realiz mediante el comando CICS el m dulo entregar el c digo de resultado 99 a la aplicaci n llamante En cualquier caso el c digo de resultado de la interfaz debe analizarse para detectar un posible problema utilizando la tabla de c digos de resultado raz n y contenido del atributo resultado de los apartados 8 2 2 y 8 2 3 del anexo 5 1 3 SOLICITUD DE RECEPCI N DE LOS DATOS RECIBIDOS DEL REMOTO La aplicaci n detecta la llegada de una respuesta del remoto con el arranque del proceso especificado en el campo Recursos de Comunicaci n o en el perfil de EDITRAN P seg n se hubiera cumplimentado la petici n de env o de la pregunta El mensaje asociado al arranque de la transacci n se solicitar a EDITRAN T llamando al mismo m dulo que en la petici n con todos los campos inicializados excepto el de funci n 00 EDITRAN T entregar los datos de la respuesta junto con la Primitiva 01 la sesi n y el identificador de aplicaci n mas los recu
3. a el siguiente Ldatos 4044 7 99 7 99 3832 bytes INDRA Todos los derechos reservados EDITRAN T P g 8 3 EDITRAN T CICS Manual de usuario e Instalaci n 8 ANEXO 8 2 2 C DIGOS DE RESULTADO Y RAZ N Resultado Descripci n resultado Raz n Descripci n raz n 00 Tratamiento correcto 00 01 Error en el rea de comunicaci n Funci n desconocida C digo de sesi n no especificado Primitiva desconocida Longitud de datos no num rica o fuera del rango Longitud Identificador de aplicaci n no num rica Longitud recursos no num rica Indicador de recursos err neo Variable recursos sin datos con long distinta de cero Long recursos err nea para las preguntas Long rec cero para respuesta con ind de recurso Identificador de aplicaci n sin datos con longitud distinta de cero Indicador de respuesta err neo Indicador de lenguaje no num rico o desconocido No existen datos que recibir C digo de mensaje desconocido Lenguaje de control desconocido Indicador de respuesta desconocido Longitud de mensaje mayor que la permitida C digo de resultado no num rico Error en el formato de una variable Error en variable Versi n 5 0 0 O r uI N D 02 Error en par metros fijos del mensaje recibido ex w N 08 AAA recibido del SER que tambi n El valor del atributo se indica en un 4 7 02 Error en variab
4. Interfaz de EDITRAN T se ha implementado una aplicaci n que utiliza los servicios de la misma Consiste en el env o de unos datos desde el extremo cliente al extremo servidor devolviendo este ltimo los datos modificados al extremo cliente 6 1 EXTREMO CLIENTE 6 1 1 APLICACI N EMISORA Inicialmente despu s de teclear el c digo de transacci n ZTJT se presenta la siguiente pantalla DD MM AAAAS APLICACION DE PRUEBAS EDITRAN T shh mm ss MENU PRINCIPAL NSA DA AM do dase DA E AAA IR IMA SESION XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX IDENTIFICADOR XXXXXXXXXXXXXXXXXX LONGITUD DE DATOS XXXXX DATOS XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX DESEA RESPUESTA S N X Desde este mapa se solicita la petici n de env o de los datos a la aplicaci n remota El c digo de la Sesi n es obligatorio y se corresponde con la sesi n interna de EDITRAN P que se desea utilizar El Identificador es opcional En caso de rellenarse ser devuelto junto con la respuesta para que pueda ser relacionada con la pregunta Si se rellena se le ha asignado una longitud de 18 caracteres La Longitud de los Datos es obligatoria La longitud m xima permitida es variable En el apartado 8 2 1 del anexo existe un estudio de como calcular la longitud m xima de datos que puede enviarse en un mensaje El campo de Datos se rellena con la informaci n que se desea enviar al remoto Si la longitud especi
5. Todos los derechos reservados EDITRAN T P g 7 2 EDITRAN T CICS Manual de usuario e Instalaci n 8 ANEXO 8 ANEXO 8 1 DIAGRAMA DE BLOQUES INDRA Todos los derechos reservados EDITRAN T P g 8 1 EDITRAN T CICS Manual de usuario e Instalaci n 8 ANEXO 8 2 READE COMUNICACI N ENTRE INTERFAZ Y LA APLICACI N USUARIA Nivel Nombre Tipo Long Descripci n 1 rea control 500 rea reservada para campos de control 2 Resultado num 4 C digo de resultado de la petici n 2 Raz n tnm 4 Motivo de un c digo de resultado negativo 2 Control errores 50 rea donde se aporta informaci n sobre los errores ocurridos durante el proceso de la interfaz En el caso de CICS el EIBFN y el EIBRESP 3 EIBFN alfan 4 Cuando Resultado 98 C digo EIBFN en hexadecimal expandido que indica el comando CICS que se ejecut con error 3 EIBRESP 4 Cuando Resultado 98 C digo de respuesta que especifica el error resultante del comando CICS EIBRESP del comando 3 Resultado atributo 3 Con Resultado 03 Contenido del atributo resultado de la variable err nea especificada en la Raz n 3 rea reserva atan rea de reserva a espacios 2 Funci n Tipo de servicio que se solicita 00 Recepci n de una pregunta respuesta 01 Env o de pregunta respuesta 2 Primitiva 2 Tipo de mensaje en curso 00 Pregunta 01 Respuesta 2 Ind Respuesta alfan Especifica si se espera respuesta a la pregunta en curso O L
6. GRUPZTBT DEFINE PROGRAM ZTBTO000 GROUP GRUPZTBT LANGUAGE COBOL DEFINE PROGRAM ZTBTO001 GROUP GRUPZTBT LANGUAGE COBOL DEFINE PROGRAM ZTBTO002 GROUP GRUPZTBT LANGUAGE COBOL NOTA Si el entorno de la instalaci n es LE 370 se debe especificar LE370 en el par metro LANGUAGE al definir los programas en la PPT 7 3 ALTA DE LA SESI N EN PERFILES DE EDITRAN P El alta de la sesi n de EDITRAN P se realiza como la de cualquier otra sesi n de EDITRAN P que se utilice para comunicar cualquiera de las posibles aplicaciones de la plataforma EDITRAN G EDITRAN MQ De hecho EDITRAN T puede utilizarse conjuntamente con cualquiera de ellas Los nicos par metros del perfil de la sesi n concernientes a EDITRAN T son la Transacci n EDITRAN T y el Terminal EDITRAN T que deben rellenarse en la segunda pantalla del perfil de la sesi n que se desea utilizar para transmitir los mensajes consulte el manual ED51USUC cap tulo 1 3 2 La transacci n incluida en el perfil es la que se arranca cuando EDITRAN P recibe un mensaje pregunta del extremo remoto ejecut ndose en el terminal indicado en el par metro Terminal EDITRAN T o sin l si se deja a espacios Tambi n se utilizar n estos par metros en el caso del mensaje respuesta si la pregunta se env a sin la variable Recursos o si se ha detectado alg n error en la misma 7 4 PRUEBAS Las pruebas se realizar n con la transacci n ZTJT descrita anteriormente INDRA
7. a Primitiva 00 y la sesi n Los recursos de comunicaci n y el identificador de aplicaci n se entregan si se cumplimentaron en la petici n asociada Siempre que se solicite un servicio a EDITRAN T debe preguntarse por el c digo de resultado para asegurarse de que la operaci n se ha realizado con xito Ver anexo apartados 8 2 2 y 8 2 3 5 2 2 TRATAMIENTO DE LOS DATOS RECIBIDOS Y PREPARACI N DE LA RESPUESTA El tratamiento de los datos es espec fico de la aplicaci n pero durante el mismo hay que conservar el resto de los campos que se entregaron en la recepci n de la pregunta para poder enviarlos junto con la respuesta Estos datos son la Sesi n el Identificador de Aplicaci n y los Recursos de Comunicaci n 5 2 3 SOLICITUD DE ENV O DE LA RESPUESTA A LA APLICACI N REMOTA Una vez completada el rea de comunicaci n de la interfaz de EDITRAN T con la respuesta y el resto de par metros asociados al mensaje se realizar la petici n de env o al mismo m dulo que en el resto de los casos pero con Funci n 01 y Primitiva 01 Como siempre el c digo de resultado de la interfaz debe analizarse para detectar un posible problema Ver anexo apartados 8 2 2 y 8 2 3 INDRA Todos los derechos reservados EDITRAN T P g 5 3 EDITRAN T CICS Manual de usuario e Instalaci n 6 EJEMPLO DE APLICACI N USUARIA 6 EJEMPLO DE APLICACI N USUARIA A modo de ejemplo y para realizar las pruebas posteriores a la instalaci n de la
8. a pregunta no requiere respuesta 1 La pregunta requiere respuesta 2 e an dl C digo interno de la sesi n de transmisi n especificada en los perfiles de EDITRAN P 2 Identificador Apl alfan Identificador asignado al dato por la aplicaci n 3 Longitud del identificador de datos de la aplicaci n 00 si no existe identificador 3 rea reservada para el identificador de aplicaci n 2 Recursos com 3 A Indica si el mensaje contiene la variable recursos o no 0 mensaje sin la variable recursos 1 mensaje con la variable recursos 3 Long recursos Longitud del campo de recursos necesarios para entregar una respuesta al punto origen de la petici n 3 Datos necesarios para dirigir la respuesta al lugar donde se realiz la pregunta Transacci n terminal etc 2 MN Indica el juego de caracteres en el que se desean enviar los datos con Funci n 01 y en el que se desean recibirlos con Funci n 00 O Binario 1 ASCII 2 EBCDIC 3 BCD 2 rea de reserva a espacios 1_ readedatos 2 2 Datos alfan xxxxx rea de datos a enviar 8 2 1 LONGITUD M XIMA DE DATOS La longitud de los datos del mensaje queda limitada por la m xima longitud que EDITRAN P env a al remoto 4096 menos los campos de control que acompa an a los datos Hay que tener en cuenta que INDRA Todos los derechos reservados EDITRAN T P g 8 2 EDITRAN T CICS Manual de usuario e Instalaci n 8 ANEXO O Cada variable lleva al m
9. a transacci n arrancada en el extremo servidor ser la especificada en el perfil de la sesi n de EDITRAN P en el par metro Transacci n EDITRAN T y se ejecutar sobre terminal o no en funci n de si se ha rellenado o no el par metro Terminal EDITRAN T de dicho perfil Al iniciarse el proceso la aplicaci n llama a la Interfaz para que obtenga los datos enviados por el remoto Si el resultado de la llamada es satisfactorio y desde la Aplicaci n Cliente se indic que se desea respuesta modifica las posiciones 1 39 y 77 de los datos recibidos con una A y solicita a la interfaz el env o de la respuesta devolviendo en los campos Identificador y Recursos del rea de comunicaci n el mismo contenido recibido previamente Si el resultado fuera negativo no se genera respuesta hacia el extremo cliente INDRA Todos los derechos reservados EDITRAN T P g 6 3 EDITRAN T CICS Manual de usuario e Instalaci n 7 INSTALACI N 7 INSTALACI N Esta secci n especifica los pasos a seguir para la instalaci n de EDITRAN T Al ser una aplicaci n usuaria de EDITRAN P es requisito fundamental que dicho producto est instalado El proceso se realiza en un conjunto de pasos que se indican a continuaci n 9 Actualizaci n de librer as O Definiciones CICS O Alta de la sesi n en perfiles de EDITRAN P O Pruebas de instalaci n 7 1 ACTUALIZACI N DE LIBRER AS Las librer as a utilizar son
10. aranararrrrrrrrrrrarrrrrrrrrrnrrarrrrnaranaraaana 5 2 5 1 4 TRATAMIENTO DE LOS DATOS DE LA RESPUESTA ENVIADA POR LA APLICACI N 5 5 2 5 2 APLICACI N SERVIDORA cti lios 5 3 5 2 1 SOLICITUD DE RECEPCI N DE LOS DATOS RECIBIDOS DEL REMOTO ccoo 5 3 5 2 2 TRATAMIENTO DE LOS DATOS RECIBIDOS Y PREPARACI N DE LA RESPUESTA cnica 5 3 5 2 3 SOLICITUD DE ENV O DE LA RESPUESTA A LA APLICACI N REMOTA cinco 5 3 6 EJEMPLO DE APLICACI N USUARlA cococoonccnocionocnanonenansnenenesne nene nece necesa 6 1 6 1 EXTREMO CLIENTE n 6 1 6 1 1 6 1 2 6 2 EXTREMO SERVIDOR Isi doado raa eaa TO canon 6 3 Te INSTALACI N oa E donos dO To Duo 7 1 7 1 ACTUALIZACI N DE LIBRER AS soii ios 7 1 7 1 1 LIBRER A DE 5 FAN MUIBRERIA DE AA ESTA ACTA 7 1 2 1 DEFINICIONES ClES ion 7 1 2 2 FORMATO DE COMUNICACI N CON APLICACI N USUARIA cnica 7 1 7 2 a AAA de dada saaana Oonan Oa aad TiNa ainin 7 2 1 TRANSACCIONES PCT Tlie PROGRAMAS PP T ee ende et A tait E 7 3 ALTA DE LA SESI N PERFILES DE
11. enos 7 bytes de control Lcv 7 mas lo que ocupa el valor de la variable excepto la variable datos que tiene 9 dos atributos y longitud de datos menor de 256 o 10 dos atributos y longitud de datos mayor de 255 9 Existen unos campos fijos que acompa an por delante a los datos que son 10 bytes Lc fijos 10 Cod msje 3 Resultado 1 Ind resp 1 leng control 1 long var 4 O Adem s est n los campos de la cola del mensaje que son a adidos por EDITRAN P Lcola msje 24 Ldir transp 18 LERC 2 Lident ver 3 Ldelim 0A 1 O La variable versi n siempre se incluye en los mensajes Lvar vers 8 Por tanto el n mero de bytes fijos a restar a la longitud total del mensaje es Le fijos 10 Lcola msje 24 Lvar var 8 Lev datos 9 10 51 52 la f rmula para calcular la longitud m xima de los datos ser Ldatos 4044 Lvar rec Lcv 7 Lurec Lvar ident Lur 7 Lvident Las longitudes correspondientes a las variables Identificador de aplicaci n y recursos solo hay que tenerlas en cuenta si se utilizan Por tanto el rango en el que est la longitud m xima de los datos es el siguiente O L mite superior con el m nimo de variables Para un SMP suponiendo que la aplicaci n no utiliza ni Identificador de Aplicaci n ni variable Recursos ser a Ldatos 4044 bytes O L mite inferior con el m ximo de variables Suponiendo que se utilizasen las variables Recursos e Identificador con su longitud m xima el c lculo ser
12. ficada en el campo anterior es mayor que 35 los datos tecleados se repiten hasta completar la longitud deseada Si se teclea S en el campo Desea Respuesta la interfaz remota enviar una respuesta negativa independientemente de la aplicaci n servidora si detecta alg n error en el mensaje La Aplicaci n Servidora responder a los mensajes recibidos sin error en funci n del valor del campo Desea Respuesta S N Despu s de introducir los datos la aplicaci n realiza lo siguiente INDRA Todos los derechos reservados EDITRAN T P g 6 1 EDITRAN T CICS Manual de usuario e Instalaci n 6 EJEMPLO DE APLICACI N USUARIA Asume siempre que la variable Recursos se forma con la transacci n y terminal en curso Formatea el mensaje de datos hasta completar la longitud especificada concatenando el rea de datos introducida tantas veces como sea necesario Llama al con el rea de comunicaci n formada a partir de los datos tecleados El resultado devuelto por dicho m dulo se muestra en la misma pantalla indicando si se ha realizado la petici n o si ha ocurrido alg n error En la l nea de mensajes pueden aparecer indicaciones como ZTTO0030004 Error variables en resp recibida vble datos Attr 130 Donde los cuatro primeros caracteres num ricos 0003 indican el c digo de resultado devuelto por la Interfaz que se describen en el apartado 8 2 2 del anexo y los cuatro segundos los correspondientes a
13. indra EDITRAN T Modelo Transaccional de Consultas CICS Manual de usuario e Instalaci n INDRA 07 de enero de 2015 EDITRAN T CICS Manual de usuario e Instalaci n NDICE T INTRODUCCI N O OOUO O OON0 0 OAPAAAA AA A mooooAA 1 1 2 ARQUITECTURA oocconcccccncccnnccnnncnannanonanocnaonono nono rnnr cnn cancer arranca 2 1 8 SERVICIOS co onncocccccnccanccanonannnanonan anna RRA 8 3 1 EDITRAN T EXTREMO CLlENTE oooococcccccncccnncconncccnnccnnncnnnnc canon cnn crac cnn ecc nene recen rre racer eran 3 1 3 2 EDITRAN T EXTREMO SERVIDOR c ooocoocccccncconncconnccnnnccnnnc a Da RR cnn cnn rre 3 1 3 3 EDITRAN P coc cocoa dada 3 1 4 PRIMITIVAS oonnncccnoncconcconcconccnanonanocanocan cnn oran aandaa naaa daa anar rn rara 4 1 5 MODO DE FUNCIONAMIENTO coooncicncconcccncconcconoconccnanonnnocnccnn ocn on DO anna ar nn OU AD Da DD AO DU arrancan rara rra 5 1 5 1 APLICACI N CUENTE 00 a 5 1 5 1 1 FORMACI N DE LOS DATOS DE LA PETICI N DE CONSULTA cnica 5 1 5 1 2 SOLICITUD DE ENV O DE DICHA CONSULTA A LA APLICACI N REMOTA sisisihin inania 5 2 5 1 3 SOLICITUD DE RECEPCI N DE LOS DATOS RECIBIDOS DEL REMOT O unnnnnnnnnnnannnannnnnnnnnannnnnanninnanaananaananaananr
14. la raz n El texto es una interpretaci n de dichos c digos de resultado y raz n El valor del atributo especifica el error detectado en la variable indicada en la raz n y se pueden consultar en la tabla de c digos del atributo resultado Apartado 8 2 3 6 1 2 APLICACI N RECEPTORA Su proceso se inicia como consecuencia de la llegada de un mensaje respuesta recibido del extremo remoto Al iniciarse la transacci n se llama a la interfaz de EDITRAN T para que obtenga los datos de la respuesta Con los datos recibidos se presenta la pantalla siguiente DD MM AAAAS APLICACION DE PRUEBAS EDITRAN T hh mm ss CONSULTA DE LOS DATOS SESION XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX LONG MSJ 9999 IDENTIF PETICION POSICION CONSULTA 9999 TERMINAL PETICION TERMINAL ACTUAL XXXX AZ A A A O MENS PF3 SALIR PF2 CAMBIO HEXADECIMAL CARACTER Para situar en la primera posici n del mapa un byte determinado del registro se teclea en el campo posici n y se pulsa INTRO Para pasar de modo car cter a hexadecimal o viceversa se pulsa PF2 En el modo car cter se muestran 7 l neas y en modo hexadecimal 14 Si se desea abandonar la consulta del mensaje se pulsar PF3 INDRA Todos los derechos reservados EDITRAN T P g 6 2 EDITRAN T CICS Manual de usuario e Instalaci n 6 EJEMPLO DE APLICACI N USUARIA 6 2 EXTREMO SERVIDOR L
15. las de ejecutables y jcl s que existan para EDITRAN La aplicaci n se compone de un conjunto de miembros ejecutables definiciones de las tablas de CICS y la copy utilizada como rea de comunicaci n de la Interfaz de EDITRAN T Estos m dulos se recibir n mediante cinta cartucho o con la Aplicaci n de Telecarga del producto EDITRAN Los ejecutables se incluir n en la librer a de ejecutables de EDITRAN y el resto en la de 7 1 1 LIBRER A DE EJECUTABLES ZTBTOOO2 ZTBTMOO 7 1 2 LIBRER A DE JCLS 7 1 2 1 DEFINICIONES CICS ZTBTPCT ZTBTPPT 7 1 2 2 DE COMUNICACI N CON APLICACI N USUARIA ZTBTCOO1 7 2 DEFINICIONES CICS Las definiciones de las tablas est n contenidas en los miembros ZTBTPCT ZTBTPPT y se especifican a continuaci n INDRA Todos los derechos reservados EDITRAN T P g 7 1 EDITRAN T CICS Manual de usuario e Instalaci n 7 INSTALACI N 7 2 1 TRANSACCIONES PCT PASOL EXEC PGM DFHCSDUP STEPLIB DD DSN CICS300 SDFHLOAD DISP SHR DFHCSD DD DSN FICHERO DFHCSD DISP SHR SYSPRINT DD SYSOUT SYSIN DD DEFINE TRANSACTION ZTMT GROUP GRUPZTBT PROGRAM ZTBTO000 TWASIZE 2000 SPURGE YES TPURGE YES TASKDATALOC ANY 7 2 2 PROGRAMAS PPT PASO1 EXEC PGM DFHCSDUP STEPLIB DD DSN CICS300 SDFHLOAD DISP SHR DFHCSD DD DSN FICHERO DFHCSD DISP SHR SYSPRINT DD SYSOUT SYSIN DD DEFINE MAPSET GROUP
16. le Recursos 03 Error en variable Identificador el campo Resultado atributo del 04 Error en variable Datos rea de comunicaci n EPA Variable desconocida 04 Error en c digo resultado del Variable con atributo resultado en mensaje con c digo mensaje recibido de resultado cero xx indica la variable con atributo de resultado El valor del atributo viene indicado en el campo Resultado atributo del rea de comunicaci n No existe la cola de estados de EDITRAN P No existe la sesi n en estados de EDITRAN P La sesi n no est establecida Se devuelven los y EIBRESP resultantes en la zona de control de errores Error en el c lculo del Error de proceso No existe rea de comunicaci n con la Interfaz Longitud de la TWA inferior a la requerida x lt 05 Sesi n no establecida oo OS 98 Error en comando CICS 99 Abend en la Interfaz o 8 2 3 CONTENIDO DEL ATRIBUTO RESULTADO El atributo resultado se a ade a una variable determinada del mensaje de respuesta para indicar un error en dicha variable o simplemente que para la versi n existente en el extremo servidor le es desconocida Los posibles c digos asignar a una variable se indican en la siguiente tabla C digo C digo Descripci n decimal hexa 0 X O0 Modificaci n de Contenido en variable negociable INDRA Todos los derechos reservados EDITRAN T P g 8 4 EDITRAN T CICS Manual de us
17. ma de comunicaciones utilizada por EDITRAN T para la transmisi n de los datos INDRA Todos los derechos reservados EDITRAN T P g 2 1 EDITRAN T CICS Manual de usuario e Instalaci n 3 SERVICIOS 3 SERVICIOS 3 1 EDITRAN T EXTREMO CLIENTE Control del estado de la sesi n de EDITRAN P Formaci n del mensaje pregunta a partir de los datos entregados por la aplicaci n Solicitud a EDITRAN P de env o del mensaje al extremo remoto Recepci n y validaci n de la respuesta O O Entrega a la aplicaci n de los datos obtenidos a partir de la respuesta 3 2 EDITRAN T EXTREMO SERVIDOR 9 Control del estado de la sesi n de EDITRAN P O Recepci n y validaci n de la pregunta recibida O Generaci n de respuestas como consecuencia de las validaciones realizadas a la pregunta recibida O Entrega a la aplicaci n de los datos obtenidos a partir de la pregunta recibida Formaci n del mensaje respuesta a partir de los datos entregados por la aplicaci n Solicitud a EDITRAN P de env o del mensaje respuesta al extremo remoto 3 3 EDITRAN P O Conexi n asociaci n y liberaci n de la sesi n Compresi n descompresi n de datos Cifrado descifrado de datos O Transmisi n de mensajes INDRA Todos los derechos reservados EDITRAN T P g 3 1 EDITRAN T CICS Manual de usuario e Instalaci n 4 PRIMITIVAS 4 PRIMITIVAS En este apartado se describe el modo de invocar los distintos servicios aportados
18. on las peticiones de consulta correspondientes puede generar un identificador de aplicaci n para cada una de las peticiones que realice el identificador ser entregado junto con la respuesta relacionando de esta manera los dos mensajes O Recursos de comunicaci n Son recursos del sistema diferentes en cada entorno gracias a los cuales la respuesta puede recibirse en el procedimiento y dispositivo deseados por la Aplicaci n usuaria que realiza la pregunta la transacci n y terminal en el caso de CICS INDRA Todos los derechos reservados EDITRAN T P g 5 1 EDITRAN T CICS Manual de usuario e Instalaci n 5 M0DO DE FUNCIONAMIENTO e Indicador respuesta Con el valor O no se incorpora la variable recursos al mensaje pregunta y por lo tanto la respuesta se procesar en el proceso y dispositivo especificados en los perfiles de EDITRAN P Con el valor 1 se incorpora la variable recursos al mensaje pregunta El contenido de la variable se toma de los datos pasados en el campo Recursos del rea de comunicaci n de la Interfaz y si sta viene a espacios se toman unos recursos por defecto en el caso de CICS si el campo no se rellena se tomar n por defecto el terminal y transacci n en curso O Lenguaje Especifica el lenguaje en que se encuentran los caracteres intercambiados en el campo datos del rea de comunicaci n Por el momento EBCDIC valor 2 5 1 2 SOLICITUD DE ENV O DE DICHA CONSULTA A LA APLICACI N REMOTA
19. por EDITRAN T El rea de comunicaci n de las llamadas as como los posibles c digos de resultado se especifican en el apartado 8 2 del Anexo Tanto la Aplicaci n Cliente como la Servidora efectuar n su peticiones a la misma Interfaz rellenando en cada caso los datos del rea de comunicaci n correspondientes al tipo de petici n realizado Para procesos CICS se puede realizar de dos maneras CALL USING DFHEIBLK EXEC CICS LINK COMMAREA AREA ZTBTO001 La diferencia entre los dos tipos de llamadas consiste en que se produce un abend en el m dulo en el primer caso se devuelve el control al CICS y en el segundo se pasa el control a la Aplicaci n Usuaria con un c digo de resultado 99 Los valores a entregar a la Interfaz para requerir los distintos servicios son los siguientes Servicio solicitado Funci n Primitiva Emisi n de una pregunta Emisi n de una respuesta or a Recepci n de una pregunta Cia Recepci n de una respuesta 00 INDRA Todos los derechos reservados EDITRAN T P g 4 1 EDITRAN T CICS Manual de usuario e Instalaci n 5 M0DO DE FUNCIONAMIENTO 5 MODO DE FUNCIONAMIENTO 5 1 APLICACI N CLIENTE La aplicaci n cliente realiza las funciones de O Formaci n de los datos de la petici n de consulta O Solicitud de env o de dicha consulta a la aplicaci n remota O Solicit
20. rsos de comunicaci n si se rellenaron en la petici n asociada Siempre que se solicite un servicio a EDITRAN T debe preguntarse por el c digo de resultado para asegurarse de que la operaci n se ha realizado con xito Ver anexo apartados 8 2 2 y 8 2 3 5 1 4 TRATAMIENTO DE LOS DATOS DE LA RESPUESTA ENVIADA POR LA APLICACI N SERVIDORA Cada aplicaci n realizar su tratamiento espec fico de la respuesta pudiendo utilizar el identificador de aplicaci n para relacionarlos con los datos de la pregunta asociada INDRA Todos los derechos reservados EDITRAN T P g 5 2 EDITRAN T CICS Manual de usuario e Instalaci n 5 M0DO DE FUNCIONAMIENTO 5 2 APLICACI N SERVIDORA La aplicaci n servidora realiza las funciones de O Solicitud de recepci n de los datos recibidos del remoto Tratamiento de los datos recibidos y preparaci n de la respuesta O Solicitud de env o de la respuesta a la pregunta recibida A continuaci n se describen cada uno de los puntos mencionados 5 2 1 SOLICITUD DE RECEPCI N DE LOS DATOS RECIBIDOS DEL REMOTO La aplicaci n detecta la llegada de una pregunta del remoto con el arranque del proceso de usuario especificado en el perfil de la sesi n de EDITRAN P El mensaje asociado al arranque de la transacci n se solicitar a EDITRAN T llamando al mismo m dulo que en la petici n con todos los campos inicializados excepto el de Funci n 00 EDITRAN T entregar los datos de la petici n junto con l
21. to EDITRAN T para transmisi n de datos en tiempo real entre aplicaciones usuarias que se ejecutan en sistemas inform ticos remotos INDRA Todos los derechos reservados EDITRAN T P g 1 1 EDITRAN T CICS Manual de usuario e Instalaci n 2 ARQUITECTURA 2 ARQUITECTURA EDITRAN T se compone de un subsistema cliente y otro servidor El diagrama de bloques se describe en el apartado 8 1 del Anexo Los elementos de la arquitectura son O Aplicaci n Cliente Desarrollo propio de cada instalaci n que por medio de los servicios de la interfaz realizan las peticiones de env o de mensajes pregunta y la recepci n de mensajes respuesta O Aplicaci n Servidora Desarrollo propio de cada instalaci n que por medio de los servicios de la interfaz recibe los mensajes pregunta y env a las respuestas a dichas preguntas Interfaz EDITRAN T Aplicaci n Cliente Conjunto de m dulos de EDITRAN T que a solicitud de la Aplicaci n Cliente y mediante los servicios aportados por EDITRAN P env a el mensaje pregunta al extremo remoto y recibe el mensaje respuesta Interfaz EDITRAN T Aplicaci n Servidora Conjunto de m dulos de EDITRAN T que a solicitud de la Aplicaci n Servidora y mediante los servicios aportados por EDITRAN P recibe el mensaje pregunta y env a el mensaje respuesta al extremo remoto O EDITRAN T Establece el enlace entre las necesidades de la Aplicaci n y los servicios de EDITRAN P O EDITRAN P Platafor
22. uario e Instalaci n 8 ANEXO 1 X O1 Variable opcional desconocida 2 Atributo de var opcional desconocido 3 Juego de atributos err neo en variable opcional 4 Longitud desconocida en variable opcional 5 Contenido desconocido en var opcional 6 Contenido distinto a perfiles en variable opcional 129 Variable obligatoria desconocida 130 Atributo de var obligatoria desconocido 131 Juego de atributos err neo de variable obligatoria 132 Longitud desconocida en variable obligatoria 133 Contenido desconocido var obligatoria 134 Contenido distinto de perfiles 135 No recibida variable dependiente de un grupo 136 Var obligatoria de perfiles no recibida 137 No recibida variable dependiente de grupo esperada 138 Atributo tipo de tratamiento falta en mensaje 139 Contenido del atributo tipo de tratamiento desconocido 140 x8c Falta recibir variable obligatoria INDRA Todos los derechos reservados EDITRAN T P g 8 5 i Indra Centros de Competencia eCommerce Avda de Bruselas 35 28108 Alcobendas Madrid Espa a T 34 91 480 80 80 34 91 480 50 00 www indracompany com
23. ud de recepci n de los datos recibidos del remoto Tratamiento de los datos de la respuesta enviada por la aplicaci n servidora A continuaci n se describen cada uno de los puntos mencionados 5 1 1 FORMACI N DE LOS DATOS DE LA PETICI N DE CONSULTA El rea de comunicaci n con la Interfaz de EDITRAN T est descrita en el apartado 8 2 del Anexo Adem s de los datos del mensaje a enviar que son particulares de la aplicaci n existen otros campos que deben tenerse en cuenta 9 Funci n Expresa la intenci n de enviar 01 o recibir 00 un mensaje O Primitiva Indica si lo que se desea es enviar una pregunta 00 o una respuesta 01 Indicador respuesta O Cuando no se desea respuesta a la pregunta que se est realizando 1 Cuando se espera respuesta En el caso de generar la pregunta indicando que se desea respuesta si la interfaz remota detecta alg n error en el mensaje enviar una respuesta negativa antes de indicar el resultado a la Aplicaci n Servidora En los mensajes recibidos sin error quien realmente decide enviar o no una respuesta es la Aplicaci n Servidora que debe estar proyectada de acuerdo a lo que espera la Aplicaci n Cliente O Sesi n interna C digo de la sesi n de EDITRAN P Dicha sesi n debe estar definida en los perfiles de EDITRAN P y debe ser conocida por la aplicaci n Cliente O Identificador de aplicaci n Si la aplicaci n cliente desea relacionar las respuestas recibidas c
Download Pdf Manuals
Related Search