onesait ecosystems editranmontilla.indra.es › doc › win_unix › editran › win ›...

Onesait Ecosystems

Editran

Interfaz genérica de aplicación

Manual de usuario

Windows

Septiembre 2019

Onesait Ecosystems Editran

Índice

2

Índice

1 Introducción ........................................................................................................................................................ 4

2 Descripción .......................................................................................................................................................... 5

2.1 Características generales ................................................................................................................................ 5

2.2 Características específicas .............................................................................................................................. 6

2.2.1 Versión 4.0 ............................................................................................................................................ 6

2.2.2 Versión 4.1 ............................................................................................................................................. 6

2.2.3 Versión 5.0 ............................................................................................................................................ 6

2.2.4 Versión 5.1 ............................................................................................................................................. 6

2.2.5 Versión 5.2 ............................................................................................................................................ 6

3 Gestión de Onesait Ecosystems · Editran/G ......................................................................................................... 7

3.1 Interfaz de operación ..................................................................................................................................... 7

3.1.1 Pantallas ................................................................................................................................................ 7

3.2 Arranque y parada de Onesait Ecosystems · Editran ....................................................................................... 8

3.3 Operador de Onesait Ecosystems · Editran /G ................................................................................................ 9

3.3.1 Cargar presentación de emisión. ............................................................................................................ 9

3.3.2 Emitir presentación. ............................................................................................................................ 10

3.3.3 Interrumpir emisión. ............................................................................................................................ 10

3.3.4 Inicializar presentación de emisión ...................................................................................................... 10

3.3.5 Recibir presentación ............................................................................................................................ 11

3.3.6 Descargar recepción. ........................................................................................................................... 11

3.3.7 Inicializar presentación de recepción. .................................................................................................. 11

3.3.8 Interrumpir recepción. ......................................................................................................................... 12

3.4 Consulta de ficheros ..................................................................................................................................... 13

3.4.1 Consulta de Estados de presentación. .................................................................................................. 13

3.4.2 Modificación de estados de presentación ............................................................................................ 14

3.4.3 Consulta de log. ................................................................................................................................... 15

3.5 Administrador de Onesait Ecosystems · Editran /G ....................................................................................... 16

3.5.1 Entorno local. ...................................................................................................................................... 17

3.5.2 Perfil de presentación. ......................................................................................................................... 17

3.5.3 Consulta genérica de perfiles ............................................................................................................... 24

4 Anexos............................................................................................................................................................... 27

4.1 Comodines destino de recepción .................................................................................................................. 27

4.2 COMANDOS ................................................................................................................................................ 29

4.2.1 gload52 ............................................................................................................................................... 29

4.2.2 gload[41|50|51] .................................................................................................................................... 30

4.2.3 gunload52 ........................................................................................................................................... 30


Índice

3

4.2.4 gunload[41|50|51] ................................................................................................................................ 30

4.2.5 traduct ................................................................................................................................................ 30

4.2.6 igacmd ................................................................................................................................................ 32

4.2.7 menug ................................................................................................................................................. 33

4.2.8 estcmd ................................................................................................................................................ 33

4.2.9 igaperfi ................................................................................................................................................ 33

4.2.10 modiperfi ............................................................................................................................................. 34

4.2.11 PROGRAMAS DE USUARIO ................................................................................................................ 34

4.3 Ficheros ....................................................................................................................................................... 35

4.3.1 Subcarpeta CFG................................................................................................................................... 35

4.3.2 Subcarpeta DOC .................................................................................................................................. 36

4.3.3 Subcarpeta BIN ................................................................................................................................... 36

4.3.3.1 Subcarpeta utils ......................................................................................................................................................................................................... 37

4.3.4 Subcarpeta LOG .................................................................................................................................. 37

4.3.4.1 Log diferenciado por presentación .................................................................................................................................................................... 38

4.4 CÓDIGOS Y MENSAJES AL OPERADOR ...................................................................................................... 38

4.4.1 Mensajes Editran/G ............................................................................................................................. 38

4.4.2 Códigos de error editran/G .................................................................................................................. 41

4.4.2.1 Tabla de códigos A7I ................................................................................................................................................................................................ 42


1. Introducción

4

1 Introducción

La plataforma editran de Indra se articula en dos componentes indispensables:

Plataforma de Comunicaciones (editran/P). Incluye todos los servicios comunes directamente relacionados con las facilidades de la comunicación (protocolo, interfaces con los servicios de transmisión TCP, redes locales, etc.).

Módulo Genérico de Interfaces de Aplicación (editran/G). Aísla los servicios de comunicaciones proporcionados por editran/P de las aplicaciones usuarias, siendo el nexo de unión entre las mismas y los procesos de transmisión.

editran/P transmite ficheros con una estructura determinada de un extremo local a uno remoto. Estos ficheros se denominan tampones de emisión y recepción.

Para obtener tampones de emisión a partir de ficheros convencionales de aplicación y, por contra, obtener estos ficheros de aplicación a partir de tampones de recepción, se hace necesario el uso de programas de carga y descarga que, en conjunto, se pueden denominar como interfaz de aplicación.

En el presente documento se describen los procedimientos para la correcta operación del módulo editran/G.

Aplicación Emisor

edit ran/ G

Carga en el Emisor

Traducción y

Conversión

Compresión

Cifrado

edit ran/ P

Gest ión de

conexiones

Autent if icación

extremos

Sincronización

Aplicación Receptor

edit ran/ G

Descarga en el

Receptor

Traducción y

Conversión

Descompresión

Descifrado

edit ran/ P

Gest ión de

conexiones

Autent if icación

extremos

Sincronización

Sesión de

Presentación

Sesión de

Transmisión

Online


2. Descripción

5

2 Descripción

Para funcionar con editran/G es necesario mantener un fichero de perfiles con información sobre:

Entidad local. Se utilizan para su identificación 9 caracteres numéricos.

Entidad remota. Igual que la anterior.

Aplicación de presentación. Identificada por 6 caracteres alfanuméricos. Se utiliza para definir la naturaleza de la información a intercambiar.

Sesión de presentación. Identificada por un nombre que recomendamos definir con el código (o nombre) de la entidad remota + la aplicación de presentación (por ejemplo, 9999-PRUEBA). La información contenida en este perfil viene, en gran medida, de los tres perfiles anteriores que le corresponden.

Una sesión de presentación puede constar de hasta 20 sesiones de transmisión editran o, lo que es lo mismo, la información a intercambiar se puede transmitir fraccionada por hasta 20 circuitos al mismo tiempo.

La sesión de presentación pasa por diferentes estados que reflejan el momento en que se encuentra la emisión y recepción de ficheros. En el apartado Operador de Onesait Ecosystems · Editran /G se explican los diferentes estados y las operaciones que se permiten o no en cada caso.

En un fichero de log se graban los mensajes generados por los diversos componentes de editran/G. Este fichero se puede consultar y listar aplicando varios criterios de selección.

Existen unos comandos suministrados en la instalación con los que se pueden invocar las mismas funciones que desde el menú operador.

Se puede funcionar con editran/G en modo compatible con versiones 4.1, 5.0 y 5.1, y en modo nativo con versiones 5.2. El modo de funcionamiento lo determina la versión de editran/G remota del perfil de la Presentación.

2.1 Características generales

En funcionamiento en modo nativo, existen funciones generales (especificadas en los perfiles de las presentaciones) y funciones específicas (determinadas por los conversores empleados).

Son funciones generales, entre otras:

Posibilidad de procesar ficheros de aplicación de emisión con registros de longitud fija, variable, híbridos y/o ficheros binarios.

Una sesión de presentación puede utilizar hasta 20 sesiones de transmisión editran; de ahí que la identificación de la aplicación de presentación no se corresponda con la de la aplicación de transmisión definida en editran. Esto también puede ocurrir en el caso de que sólo haya una sesión de transmisión asociada a una sesión de presentación.

La información de aplicación de emisión, se puede someter a varias funciones opcionales de presentación (criptografía, compresión y traducción EBCDIC/ASCII) y se carga en tampones específicos, hasta un máximo de 20, dependiendo del número de sesiones de transmisión especificadas y del criterio de división elegido.

Se lleva cuenta del número de sesión de presentación entre dos extremos, de manera que se va incrementando con los sucesivos intercambios. Este número se pasará al número de sesión de intercambio en los tampones emisores y receptores, de manera que no se permitirá la transmisión si no coincide en los dos extremos.

editran/P emitirá al remoto utilizando las sesiones de transmisión especificadas en editran/G local que tendrán que estar en concordancia con las definidas en editran/G remota. En estas sesiones de transmisión se podrían definir las funciones de presentación a realizar por editran/P, criptografía, compresión y/o CRC, pero no tendría mucho sentido si ya se han efectuado a los datos de aplicación.

En el extremo remoto, se recibirá la información en tampones, hasta un máximo de 20, dependiendo de las sesiones de transmisión empleadas. Dentro de esta información vendrán datos de cabecera para que editran/G remota compruebe que las opciones empleadas en el emisor son coherentes con las del receptor, y sobre características de la información recibida. La información del tampón o tampones de recepción se descarga en


2. Descripción

6

tantos ficheros de aplicación como los empleados en la carga de emisión en el otro extremo, después de haber efectuado las funciones de presentación a la inversa.

2.2 Características específicas

Las funciones específicas van asociadas a la versión de editran/G remota indicada en los perfiles de las presentaciones. Es decir, cuando una instalación 5.2 se comunica con una entidad con una versión inferior sólo podrá utilizar las funcionalidades compatibles con esa versión. A continuación, se listan las principales funcionalidades específicas de cada versión. Para información más detallada, consultar los documentos de nuevas funcionalidades.

2.2.1 Versión 4.0

El número máximo de ficheros que se pueden transmitir es de 9999 entre entornos homogéneos (Unix, Windows) y 99 para el resto.

Se permite el envío de ficheros en modo a binario a cualquier entorno.

Características como la compresión y la traducción se aplican a partir de esta versión a nivel de fichero.

Se incorpora la traducción opcional en recepción.

El usuario podrá definir tablas para adaptar los juegos de caracteres de editran a los locales de cada entidad.

2.2.2 Versión 4.1

Verificación de Firma de los ficheros transmitidos.

Criptografía Triple DES.

Se genera un fichero por Presentación con la lista de los ficheros emitidos/recibidos.

Integración con el subsistema editran/GC para el intercambio externo de claves RSA.

2.2.3 Versión 5.0

No hay límite en cuanto al número de ficheros que pueden enviarse en cada transmisión.

No hay límite en cuanto al tamaño del fichero de aplicación. Se soportan ficheros de más de 2 Gbytes.

No es necesario definir el alfabeto de la entidad remota.

2.2.4 Versión 5.1

Incorporación de envíos con confirmación de descarga remota.

2.2.5 Versión 5.2

Mejora de la seguridad: cifrado AES y claves RSA de 2048 y 4096.


3. Gestión de Onesait Ecosystems Editran/G

7

3 Gestión de Onesait Ecosystems · Editran/G

La instalación del producto crea en el menú Inicio de Windows la carpeta de programas editran. Pulsar la opción “Menú G” que mostrará la ventana del gestor de editran/G.

Si es la primera vez que arranca editran/G lo primero que debe hacer es introducir los datos del entorno local (véase el capítulo 3.5 Administrador de Onesait Ecosystems · Editran /G).

3.1 Interfaz de operación

En las pantallas que se incluyen en este documento, los diferentes tipos de campos se representan de la forma siguiente:

3.1.1 Pantallas

En las pantallas de editran WINDOWS se pueden diferenciar tres áreas:

(1) Menús

En el área de menús se eligen las diferentes opciones para manejar editran.

Arranque y parada de editran, informes, administración del sistema.

Son activados por el cursor, por letras que aparecen subrayadas.

(2) Barra de herramientas

En el área aparecen diferentes iconos que indican acciones equivalentes a las que están en los menús; situándose encima de cada icono aparece en la parte inferior de la pantalla información que lleva asociada la acción de dicho icono.

(3) Información

En esta área aparece la información que editran envía al operador:

Presentación.

Estados de emisión y recepción.



8

Texto de información o mensajes del operador remoto.

(4) AYUDA

editran/G dispone de un sistema de ayuda. De esta forma, cuando se pulsa la tecla F1 aparece una ventana con el texto de ayuda.

3.2 Arranque y parada de Onesait Ecosystems · Editran

Para arrancar y parar editran debe seleccionar la opción Archivo del Menú General y a continuación elegir la opción de Arrancar editran o bien Parar editran.

El siguiente icono de la barra de herramientas es equivalente al arranque y parada de editran por medio del menú:

Situando el cursor y presionando sobre el semáforo produce la acción de arranque en editran/G y editran/P, quedando el semáforo en verde.

Situando el cursor y presionando sobre el símbolo de semáforo en verde produce la acción de parada de editran/G y editran/P, quedando el semáforo en rojo:



9

3.3 Operador de Onesait Ecosystems · Editran /G

Para operar sobre las presentaciones, seleccionar en el menú principal la opción editran/G > Operador. Tener en cuenta que si queremos actuar sobre una presentación determinada deberemos pulsar el cursor sobre ella y seleccionarla (el fondo blanco aparecerá en azul). Si no hay ninguna seleccionada, aparecerá una ventana que le pide elegir la presentación a utilizar:

Se presentarán las siguientes opciones:

También puede pulsar el botón derecho del ratón para desplegar un menú contextual con las mismas opciones.

3.3.1 Cargar presentación de emisión.

Sólo se permite esta opción cuando la Presentación no tiene actividad (estado representado con …) o bien cuando

está CARGADA y el perfil está configurado para permitir carga acumulativa. En cualquier otro caso, se mostrará

al usuario el mensaje “Estado de la presentación incompatible con la petición”.

Si se admite la petición, la presentación pasa al estado temporal CARGANDO en el que se realizan los siguientes

pasos:

Se ejecuta el programa de usuario previo a emisión, si existe en el perfil.

Se ejecuta el programa conversor correspondiente a la versión de la entidad remota. Este programa es el que crea los archivos tampón que empaquetan los datos para ser transmitidos.

Si el proceso de carga finaliza correctamente, el estado final será CARGADA. Si se produce un error se mostrará

el mensaje correspondiente y quedará en el estado inicial. En la imagen un ejemplo de la petición de carga de una presentación para la que no existen ficheros a transmitir.



10

Este botón es el equivalente a la acción por medio de menús:

3.3.2 Emitir presentación.

Esta operación es aceptada cuando el estado de la emisión de la presentación es: inactiva (…), CARGADA o

INTERRUMPIDA. Por lo general, es la única petición que se hace para emitir ya que, si es preciso, se realiza antes el proceso de carga comentado en el punto anterior.

Una vez CARGADA se envían a editran/P tantos mensajes A1R como sesiones de transmisión use la presentación. Lo

mismo se hace si estuviera INTERRUMPIDA salvo que en este caso, la transmisión se retomará en el punto en que se detuvo.

El estado de la emisión pasa a TRANSMITIENDO y queda a la espera de recibir la notificación de editran/P del final de la/s transmisión/es.

En la imagen, una secuencia típica de mensajes de log asociados a una petición de emisión de una presentación con una sola sesión de transmisión.

Pulsando este botón es equivalente a la acción por medio de menús:

3.3.3 Interrumpir emisión.

Opción que permite al operador de editran detener la emisión en curso (estado TRANSMITIENDO). Para ello, se notifica a cada sesión de transmisión de la presentación que se interrumpa mediante el mensaje EDP. El estado de la

presentación pasa temporalmente a INTERRUMPIDA pero podrá retomarse pidiendo de nuevo la emisión.

Pulsar este botón es equivalente a la acción por medio de menús:

3.3.4 Inicializar presentación de emisión

Cada vez que finaliza con éxito la transmisión de una presentación, ésta vuelve a quedarse en el estado inicial. Si por algún motivo una emisión se interrumpe y se quisiera cancelar para empezar otra desde cero, debe seleccionar esta opción para inicializar la presentación. El único momento en que no se permite inicializar es cuando la presentación se

encuentra en estado TRANSMITIENDO, en ese caso es necesario interrumpir primero.



11

Está botón es equivalente a la acción desde menú:

3.3.5 Recibir presentación

Cada presentación en editran se puede configurar para aceptar que la entidad remota se conecte y envíe (modo servidor) o bien que sólo desde la propia entidad se hagan las peticiones de transmisión, tanto para emitir como recibir (modo cliente).

Siempre que se quiera iniciar una conexión con el editran remoto para traer los ficheros que tenga disponibles para la presentación, se elegirá esta opción. Dependiendo del estado en que se encuentre dicha presentación, la respuesta será diferente.

Si la presentación está sin actividad (…), es decir comienza una nueva recepción, se lanza el programa de usuario que tenga configurado como previo, y se envía a cada sesión de transmisión el mensaje A2R. El estado de la presentación

pasa a TRANSMITIENDO hasta recibir la notificación de editran/P del fin de la/s transmisión/es (A4P). En estado

INTERRUMPIDA el comportamiento es igual, salvo que no se lanza programa de usuario previo ya que la transmisión se reinicia en el punto en que se quedó evitando retransmitir el volumen ya intercambiado.

En cualquier otro estado, se mostrará al usuario el mensaje “Estado de la presentación incompatible con la petición” ya

que una presentación puede tener sólo una transmisión en curso. Un caso especial es el estado TRANSMITIDA en el que se han recibido los tampones, pero no ha finalizado la descarga. Ver el apartado 3.3.6 para ver cómo operar en este caso.

Este botón es equivalente a la acción desde menú.

3.3.6 Descargar recepción.

En el proceso de recepción, la descarga o transformación de los ficheros tampones recibidos se realiza de forma automática. Eso hace que esta opción sólo tenga que realizarse de forma excepcional cuando por algún fallo el estado

de la presentación quede en TRANSMITIDA. En estos casos, hay que analizar la información de log del producto para ver si es un error local que pueda ser corregido e intentar de nuevo la descarga.

En estado INTERRUMPIDA también se admite esta opción, pero en este caso hay una comprobación adicional de que realmente se haya transmitido el total de los datos.

El estado de la presentación que se verá en la interfaz de usuario durante el proceso de descarga es DESCARGANDO. Y al finalizar quedará listo para comenzar una nueva recepción (…).

Sólo cuando el proceso de descarga finaliza con éxito, se ejecuta el programa de usuario posterior a la recepción. Si falla se lanzará el programa de usuario de excepción indicando el código del error. Si el usuario quiere que se realicen acciones en esos casos debe ponerlos en el perfil de la presentación, ya que por defecto estos campos se dejan en blanco en esta versión.


3.3.7 Inicializar presentación de recepción.

Tal y como se explicaba para las emisiones, cada vez que finaliza con éxito la transmisión de una presentación, ésta vuelve a quedarse en el estado inicial lista para realizar la siguiente. Sólo si por algún motivo una recepción

INTERRUMPIDA o TRANSMITIDA se quisiera cancelar, debe resetearse mediante esta opción.

El proceso de inicialización elimina toda la información de control de la transmisión en curso para que la siguiente comience de cero.

Está opción es equivalente a la acción de menús:



12

3.3.8 Interrumpir recepción.

El operador de editran puede interrumpir cualquier recepción en curso (estado TRANSMITIENDO). Para ello, se notifica a cada sesión de transmisión de la presentación que se desconecte mediante el mensaje EDR. El estado de la

presentación pasa temporalmente a INTERRUMPIDA pero podrá retomarse pidiendo de nuevo la recepción.

Si la presentación tiene configurado proceso de usuario de excepción, se ejecuta y el código de error que llega es 110 (ver apartado 4.4.2.1).




13

3.4 Consulta de ficheros

3.4.1 Consulta de Estados de presentación.

Para consultar una presentación particular seleccionar la presentación y a continuación elegir el tipo de envío (emisión o recepción). En el área de información de la ventana (parte inferior) aparecerá la información que resume el estado de la presentación y de sus sesiones de transmisión.



14

ESTADO PRESENTACIÓN

Puede tener los siguientes valores:

… La presentación está lista para iniciar una nueva emisión/recepción. No hay ninguna transmisión en curso.

CARGADA Se han generado los ficheros tampones de la presentación pero no ha comenzado el envío a la entidad remota.

TRANSMITIENDO Alguna de las sesiones de transmisión de la presentación está conectada y transmitiendo.

TRANSMITIDA La transmisión ha finalizado. En emisión este estado indica que falta recibir la confirmación remota de descarga. En recepción queda en este estado cuando falla el proceso de descarga.

INTERRUMPIDA Alguna de las sesiones de transmisión de la presentación está interrumpida.

Nº PRESENTACIÓN

En las presentaciones configuradas para incrementar el número de presentación, se lleva un contador de las transmisiones realizadas que debe coincidir en ambos extremos. Este es el valor que se muestra en este campo. Cuando la presentación no está usando esta característica, el campo aparece vacío como en el ejemplo.

FECHA CAMBIO

Fecha y hora UTC del último cambio de estado de la presentación.

SESIONES editran

Aparecen tantas líneas como sesiones de transmisión se utilicen en la presentación, hasta un máximo de 20. En cada línea aparece: sesión, fecha y hora de creación del fichero tampón y la ratio de información transmitida con la relación entre registros totales y confirmados.

3.4.2 Modificación de estados de presentación

En circunstancias normales, la forma de inicializar el estado de una presentación, cancelando la transmisión que estuviera pendiente y dejándola lista para comenzar una nueva, es desde Editran/G > Operador > Inicializar presentación.

Hay algunos casos excepcionales que pueden requerir una modificación especial del estado de la presentación. Por ejemplo, cuando habiendo activado la opción de “Incrementar número de presentación” ambos extremos no estén sincronizados y sea preciso indicar el número correcto para poder continuar con las transmisiones.



15

Al seleccionar Editran/G > Consulta de ficheros > Modificación de estados de presentación > Emisión o Recepción, aparece la pantalla de confirmación en la que se advierte de que esta operación afecta al emisor y al receptor y es necesario que ambos extremos estén de acuerdo. Se muestra el número de sesión de presentación, que puede ser modificado, y se pregunta si se desea inicializar los estados de presentación. Al pulsar OK el estado se reseteará y la presentación quedará en el estado inicial.

3.4.3 Consulta de log.

Se accede desde el menú principal seleccionando la opción Editran/G > Consulta de ficheros > Consulta de log. La ventana de consulta de log se compone de un filtro de búsqueda y el listado de los resultados obtenidos. Los criterios de filtrado son:

Presentación. No se admiten máscaras, se selecciona una presentación en concreto o todas (<Todas>).

Fecha y hora. Los mensajes se muestran desde la fecha y hora definida hasta la fecha actual de la consulta.



16

Una vez establecido el filtro, pulsar el botón “Selección OK” para aplicarlo.

3.5 Administrador de Onesait Ecosystems · Editran /G

Se accede al administrador de editran/G seleccionando la opción Administrador desde el menú principal, presentándose la siguiente pantalla:



17

3.5.1 Entorno local.

Se definen un conjunto de parámetros dentro del propio producto que le permiten conocer la instalación donde el producto va a estar funcionando, además de la Identificación de la instalación de editran/G local, hacia los demás.

Sólo existe en perfiles de editran/G un registro de entorno local que deberá ser dado de alta en la instalación; posteriormente podrá ser modificado o consultado.

Código editran/G local (El mismo que el definido en editran/P.)

Nombre editran/G local

Los valores aquí introducidos se toman como valores por defecto en el alta de las presentaciones.

La modificación y la consulta del entorno local se realizan exactamente igual al alta, pero en este caso el perfil correspondiente deberá estar creado previamente.

El entorno local no puede ser dado de baja.

3.5.2 Perfil de presentación.

Para poder realizar una transmisión por editran es necesario haber definido previamente lo que se denomina perfil de presentación. En él se establecen todos los parámetros que rigen un tipo de intercambio de información organizados por: datos de presentación, datos de entidad remota, datos de aplicación y datos de ficheros.

Al elegir la opción Perfil de presentación aparecerá una ventana con las pestañas que se explican a continuación. Pulsar el botón Guardar para aplicar los cambios realizados.



18

PESTAÑA DE PRESENTACIONES:

Presentación

Elegir el nombre de la Presentación que desee dar de alta o modificar.

Código Local

Valores tomados del entorno local. Sólo puede modificarse si la instalación tiene licencia para trabajar con múltiples códigos locales.

Datos de la presentación

Incrementar número de presentación (Sí/No)

Especifica si se debe incrementar o no el número de presentación y por lo tanto el número de sesión de intercambio de cada una de las sesiones editran asociadas a la misma en los procesos previos de emisión y recepción.

Número de sesiones de presentación

Número de sesiones de transmisión asociadas a la presentación. Estas sesiones deben haber sido dadas de alta previamente con el administrador de editran/P. En la tabla “Aplicaciones editran/P” se debe especificar cuáles son.

Criterio de División

Sólo aplica cuando se utilizan varias sesiones de transmisión para la de presentación. Pueden especificarse los valores siguientes:

Ninguno: No se realiza división.

Por volumen: Se repartiría la información de aplicación de emisión a partes iguales entre los diferentes tampones, con un mínimo de 400.000 octetos por tampón. Esto significa que podrían no utilizarse en la presentación algunas de las sesiones de transmisión que se hayan definido en ella.

Por fichero: Reparto por fichero. Se irían asignando a cada tampón de emisión sucesivos ficheros completos.



19

Tipo de carga

Con tipo de carga acumulativa se permite la recarga del tampón con nuevos ficheros de aplicación, siempre que no haya comenzado la transmisión. La carga acumulativa obliga a utilizar una única sesión de transmisión.

Normal: Una única carga por emisión.

Acumulativa: Permite cargar varias veces antes de emitir.

Pedir confirmación de descarga

Con confirmación de descarga remota, la emisión no se dará por finalizada hasta que se reciba del remoto el resultado de su descarga. Cuando la descarga finaliza con error, el proceso de usuario posterior a recepción recibirá en el parámetro resultado el valor que lo indica. En recepción, se devuelve el resultado de la última descarga siempre que lo pida el remoto.

Aplicaciones editran/P

Nombre de las aplicaciones de editran/P correspondientes a las sesiones de transmisión de la presentación. En la tabla se habilitan tantos elementos como indica el campo número de sesiones y en cada uno se permite elegir de la lista que muestra las configuradas en editran/P para el mismo código local y remoto.

PESTAÑA DE ENTIDAD REMOTA:



20

Código de entidad remota:

Introducir el código de la entidad remota, que debe ser el mismo que el empleado en editran/P.

Descripción:

Nombre descriptivo de la entidad remota.

Versión editran/G remoto:

La versión de editran/G del remoto, también determina el conversor de emisión y recepción a usar.

4.1 Si la entidad remota es editran/G V4.1




Juego de caracteres:

Cuando la versión remota es 4.1, es necesario proporcionar el juego de caracteres alfanuméricos que utiliza la máquina remota: ASCII o EBCDIC. Este parámetro no afecta al tratamiento de los datos transmitidos, sólo a cierta información de control del protocolo.

Criptografía:

En el apartado datos de criptografía se establece el tipo de seguridad usada para proteger la información intercambiada por esta presentación. Las opciones configuradas aquí sólo afectan al tratamiento que se hace de los datos durante el proceso de creación de los tampones editran. Aunque se aconseja usar la criptografía en este nivel del protocolo, también se podría seleccionar No y proteger sólo la transmisión configurando de forma adecuada las sesiones de editran/P.

Al seleccionar Si se habilitan el resto de ajustes que configuran el sistema criptográfico.

Versión de criptografía

2.2

En este modo se hace cifrado DES de los ficheros tampón. Las claves usadas son simples y se tienen que haber intercambiado previamente mediante una conexión con la entidad remota configurada para ello.

3.0

En este modo cada fichero transmitido se cifra con una clave diferente al formar el tampón. La clave de cifrado de datos se envía adjunta protegida según el algoritmo de autenticación elegido. Con autenticación RSA, además se firma el fichero para garantizar la autenticidad del origen y la integridad de los datos. El algoritmo de hash utilizado es sha-1.



21

4.0

Amplía la funcionalidad del modo 3.0 incorporando algoritmos de cifrado de clave simétrica más seguros (AES). En esta versión el único algoritmo de autenticación admitido es RSA ampliando la longitud de las claves hasta 4096. El algoritmo de hash usado en la firma es sha-256.

Algoritmo de Confidencialidad

Algoritmos de cifrado de clave simétrica disponibles para versión de criptografía 3.0 o superior. Se puede seleccionar No cifrar si lo único que se desea es firmar los ficheros enviados.

DES, TDES-2 (Triple DES con clave doble), TDES-3 (Triple DES con clave triple).

AES-128, AES-192, AES-256. Sólo disponibles para versión 4.0.

Algoritmo Autenticación

Algoritmo usado por editran para proteger la clave de cifrado de los datos. También proporciona la autenticación del origen y la integridad de los datos transmitidos.

DES: Se mantiene por compatibilidad con versiones anteriores del producto. Se recomienda el uso de RSA.

RSA: Es el algoritmo obligatorio cuando se trabaja en modo 4.0.

Intercambio de claves editran/GC

Las claves utilizadas en la criptografía de clave pública (RSA) se intercambian entre las entidades con la utilidad del producto diseñada para ello: editran/GC. Si se marca este “check” se usa la clave activa de los subsistemas configurados. Consultar el manual de usuario de editran/GC Gestión de claves para ampliar información sobre la utilidad.

Clave/Subsistema Local y Remoto

Etiquetas de claves auxiliares con autenticación DES o subsistemas de editran/GC con autenticación RSA.

PESTAÑA DE APLICACIÓN

Aplicación

Nombre de la Aplicación. Junto a los códigos local y remoto forma el identificador único de la presentación. No es obligatorio que coincida con la aplicación de editran/P aunque se recomienda que sea así cuando sólo se use una sesión en la presentación.

Descripción

Texto descriptivo de la aplicación.



22

Tablas de conversión

Son ficheros de texto editados por el usuario con la tabla de correspondencia entre el esquema de codificación de caracteres local y el propio de editran, tanto para emisión como para recepción. Cada línea será del siguiente tipo, definiendo los caracteres en hexadecimal:

<carácter-editran> <carácter-local>

Si no se necesita ninguna traducción local, estos campos se dejarán en blanco. En otro caso se pondrá el nombre del fichero, pero sin el último carácter que sólo sirve para identificar el alfabeto: A si es ASCII, o E si es EBCDIC. Por

ejemplo, suponiendo que el usuario crea el fichero mitablaA para traducir caracteres ASCII en el perfil sólo se

pondría mitabla.

Programas de usuario

Llamados por editran/G en los procesos previos y posteriores a emisión y recepción y de excepción, estos programas serán aportados por el usuario cuando quiera utilizar esta característica para integrar el producto con otros sistemas. Con el software de editran se entregan unos programas batch de ejemplo que pueden usarse como plantilla.

Estos campos se dejan en blanco por defecto. Se puede utilizar el programa de excepción utils\U_EXCEPCION si se quiere dejar registro en los ficheros de log de las transmisiones que se interrumpen.



23

PESTAÑA DE FICHEROS

Ficheros de Emisión de la Presentación

Cada presentación establece de antemano el conjunto de ficheros que se transmitirá cada vez que se pida una emisión. Pulsar el botón Añadir Fichero para configurar un nuevo origen de emisión y las características del envío.

Origen de Emisión

Ruta de los ficheros a emitir. Se admiten rutas absolutas, relativas referidas al directorio bin de editran o recursos compartidos en notación UNC. En todos los casos se pueden utilizar los comodines admitidos por el SO (*, ?, etc.).

Compresión (Sí/No)

Compresión LZW del fichero cargado. En recepción se descomprime en función de los campos de control del tampón recibido.

Formato de Fichero de Aplicación

Se establecen las condiciones de formato que deben cumplir los ficheros para asegurar que son compatibles con lo esperado en otros entornos: zOS, iSeries.

Fijo: Los ficheros de aplicación se leen en bloques de longitud fija (valor del parámetro Longitud de registros de aplicación). Opcionalmente estos ficheros pueden tener cada bloque separado por salto de línea, en este caso es necesario especificar que delimitador se usa (CRLF o LF). Los delimitadores no llegan al receptor, se eliminan al cargar el fichero.

Variable: Los ficheros de aplicación son leídos línea a línea. Como delimitador se admite CRLF o LF independientemente del valor del parámetro Delimitador. En estos casos la longitud del registro es el valor máximo. Al igual que en los fijos, el delimitador se elimina durante el proceso de carga.

Híbrido: Los ficheros de aplicación son variables, pero se envían al remoto como fijos. Cada línea se completa con espacios hasta la longitud de registro especificada.

Binario: Transmisión en modo binario. No se realiza ningún tratamiento ni de formato, ni de alfabeto.



24

Longitud de registros de aplicación

Junto al formato de los ficheros se envía a la instalación remota. En entornos zOS e iSeries es necesario para poder crear los ficheros recibidos.

Alfabeto

Es el alfabeto original de los ficheros que se van a emitir. Editran sólo admite como alfabetos posibles ASCII (iso-8859-1) o EBCDIC (ibm-1145).

Traducción ASCII/EBCDIC (Sí/No)

Al poner traducir a Sí, cuando el alfabeto original es ASCII se traduce a EBCDIC y si es EBCDIC se traduce a ASCII.

Delimitador

Código de control que marca el salto de línea (registro). Se admite DOS (CRLF) o UNIX (LF).

Ficheros de Recepción

Destino de recepción

Por lo general, es el directorio dónde se dejan los ficheros recibidos. En este caso, el nombre de los ficheros es el indicado por la entidad emisora. Si viniera algún carácter no admitido por el SO (:,<,>, etc.) se sustituye por ‘-‘.

Si lo que se desea es normalizar en destino la nomenclatura de los ficheros recibidos, es posible utilizar comodines especiales que son interpretados por editran. Consulte el apartado ¡Error! No se encuentra el origen de la referencia. para más detalles.

Delimitador

Sólo aplica a los ficheros recibidos con formato Fijo. En estos casos se añade el delimitador seleccionado al final de cada registro. En los ficheros variables se añade siempre el delimitador DOS (CRLF).

Traducir en recepción

Los ficheros binarios no se traducen nunca. Si se elige ASCII se traducirán los recibidos en EBCDIC y al revés.

3.5.3 Consulta genérica de perfiles

Las consultas se pueden filtrar por:

Presentación

Se obtiene una relación de las presentaciones con sus identificadores.

Entidad remota



25

Se obtiene una relación de entidades remotas con su descripción.



26

Aplicación

Se obtiene una relación de aplicaciones con su descripción.


4. Anexos

27

4 Anexos

4.1 Comodines destino de recepción

Los comodines que pueden especificarse son:

+ Si el fichero existe, añadir al anterior

- Si el fichero existe, destruir el anterior

%o Nombre original fichero descargado (incluida la extensión)

%D Día (DD)

%M Mes (MM)

%Y Año (YYYY)

%h Hora (hh)

%m Minutos (mm)

%s Segundos (ss)

%c Contador de ficheros (c)

En los comodines %Y y %c se puede definir la precisión de los dígitos a definir, añadiendo un número antes de la letra del comodín. Por ejemplo, si se define %4c se escribirán 4 dígitos.

Ejemplos de destino de recepción

En los ejemplos, la entidad remota nos envía 4 ficheros.

Caso 1

Configuramos el siguiente destino de recepción:

../directorio_destino o ../directorio_destino/%o

Ficheros enviados Ficheros descargados

a.txt ../directorio_destino/a.txt

b.txt ../directorio_destino/b.txt

c.txt ../directorio_destino/c.txt

d.txt ../directorio_destino/d.txt

Si existiera alguno de los ficheros antes de descargar, se destruiría por el nuevo descargado.

Caso 2


../directorio_destino/+banco_%D-%M-%Y_%h-%m-%s


4. Anexos

28


a.txt ../directorio_destino/banco_17-10-2014_14-00-01

b.txt ../directorio_destino/banco_17-10-2014_14-00-02

c.txt ../directorio_destino/banco_17-10-2014_14-00-03

d.txt ../directorio_destino/banco_17-10-2014_14-00-03

Se descargan varios ficheros, se les define el día, mes, año, hora, minuto y segundo, y en el caso de los ficheros c.txt y d.txt, como ambos se descargan en el mismo segundo, el contenido de banco_17-10-2014_14-00-03 sería el de dichos ficheros.

Caso 3


../directorio_destino/banco-%D-%M-%Y_%4c


a.txt ../directorio_destino/banco_17-10-2014-0000

b.txt ../directorio_destino/banco_17-10-2014-0001

c.txt ../directorio_destino/banco_17-10-2014-0002

d.txt ../directorio_destino/banco_17-10-2014-0003

Se descargan varios ficheros por la misma sesión y a cada uno se le define el día, mes y año y un contador de 4 cifras (%4c).

Caso 4


../directorio_destino/banco_%o


a.txt ../directorio_destino/banco_a.txt

b.txt ../directorio_destino/banco_b.txt

c.txt ../directorio_destino/banco_c.txt

d.txt ../directorio_destino/banco_d.txt

Los ficheros descargados tendrán el nombre definido más el de origen (incluida la extensión).


4. Anexos

29

Caso 5


../directorio_destino/+fichero_unico


a.txt ../directorio_destino/fichero_unico

b.txt ../directorio_destino/fichero_unico

c.txt ../directorio_destino/fichero_unico

d.txt ../directorio_destino/fichero_unico

El contenido del fichero descargado será el de los ficheros a + b + c, debido al +.

Caso 6


../directorio_destino/fichero_unico


a.txt ../directorio_destino/fichero_unico

b.txt ../directorio_destino/fichero_unico

c.txt ../directorio_destino/fichero_unico

d.txt ../directorio_destino/fichero_unico

Al no diferenciar los ficheros se irán sobrescribiendo según se descargan, quedando el contenido final el del fichero c.txt.

Caso 7


../directorio-destino/%o_%D-%M-%Y


a.txt ../directorio_destino/a.txt_17-10-2014

b.txt ../directorio_destino/b.txt_17-10-2014

c.txt ../directorio_destino/c.txt_17-10-2014

d.txt ../directorio_destino/d.txt_17-10-2014

Se descargan varios ficheros por la misma sesión y a cada uno se le define el nombre original definido por el remoto (incluida la extensión), el día, mes y año.

4.2 COMANDOS

4.2.1 gload52

Descripción


4. Anexos

30

Comando de procesamiento de los ficheros de aplicación a emitir. El procesamiento consiste en transformar y empaquetar los ficheros de aplicación en el fichero tampón. Este comando es invocado por el proceso editrang cuando la versión remota del perfil es 5.2.

Sintaxis

gload52 <presentacion>

<Opciones> <presentacion> : Identidad de la presentacion.

4.2.2 gload[41|50|51]

Descripción

Comando de procesamiento de ficheros de aplicación cuando la versión remota del perfil es 5.1 o inferior.

Sintaxis

gload[41|50|51] <presentacion>

<Opciones> <presentacion>: Identidad de la presentacion.

4.2.3 gunload52

Descripción

Comando de procesamiento de los ficheros de aplicación recibidos. El procesamiento consiste en desempaquetar y transformar los ficheros de aplicación recibidos en el fichero tampón. Este comando es invocado por el proceso editrang cuando la versión remota del perfil es 5.2.

Sintaxis

gunload52 <presentacion>


4.2.4 gunload[41|50|51]

Descripción

Comando de procesamiento de los ficheros de aplicación recibidos cuando la versión remota del perfil es 5.1 o inferior.

Sintaxis

gunload[41|50|51] <presentacion>


4.2.5 traduct

Descripción

Este comando permite traducir ficheros de ASCII-EBCDIC y de EBCDIC-ASCII.

Si se desea cambiar determinados caracteres de las tablas estándar se deben generar las siguientes tablas:

Las modificaciones de la tabla ASCII->EBCDIC se deben escribir en el fichero toebcdic.tbl.

Las modificaciones de la tabla EBCDIC->ASCII se deben escribir en el fichero toascii.tbl.

Los caracteres modificables son los no alfanuméricos (a-z, A-Z, 0-9).

Los caracteres especificados en los ficheros de texto se deben escribir en formato hexadecimal.

Cada modificación se debe escribir en una línea.


4. Anexos

31

En cada línea se escribe el carácter a traducir y a continuación el carácter traducido separados por un espacio en blanco.

Ejemplo:

Para modificar la traducción de los caracteres: Ñ ñ Ç ç (hexadecimal [decimal] en

ASCII: A5[165], A4[164], 80[128] y 87[135] respectivamente), traducidos actualmente a EBCDIC por: AC, 8F, 66 y 8E respectivamente, se desea que los traduzca por: 7B, 6A, 68 y 67.

Se debe escribir en el fichero "toebcdic.tbl” lo siguiente: A5 7B A4 6A 80 68 87 67

En la versión 5.0 se cambiaron las tablas estándar ASCII/EBCDIC usadas por editran. Para facilitar la actualización, en los casos en que se haya tenido que utilizar tablas de conversión locales, se ha incluido la nueva opción –m. Con esta opción, especificando el nombre del fichero que almacena las modificaciones actuales, se actualiza con los valores adecuados a las nuevas tablas.

Ejemplo:

Supongamos que una entidad tenía la siguiente tabla ASCII en recepción tablaA para adaptar los caracteres Ñ ñ a su entorno: A4 F1 A5 D1

Al ejecutar el comando: traduct –m r tablaA tabla5A

A -> E(41) -> A(50) A ==========================

a4 -> 6a -> f1 = f1 a5 -> 7b -> d1 = d1

Cada línea de la salida se interpreta así: el carácter ASCII 0xA4 que resultaba según las tablas de traducción antiguas del carácter EBCDIC 0x6A, en la versión 50 se recibiría como 0xF1, que es igual al carácter final de la tabla local.

En el caso de que el nuevo carácter recibido sea el que esperamos, como sucede en este caso, se eliminará la línea de la nueva tabla local tabla5A.

Sintaxis

traduct. Utilidad de traduccion ASCII-EBCDIC. V2.0 R0 - Apr 30 2013

Copyright (C) 1991-2011 INDRA

Uso : traduct -a|e origen destino Uso : traduct -t a -t e -c -d -o -x

Uso : traduct -v Uso : traduct -m [e|r] tablaIn [tablaOut]

Siendo : -a : Traduccion a ASCII.

-e : Traduccion a EBCDIC. origen : Fichero a traducir (stdin por defecto)

destino: Fichero traducido (stdout por defecto)

-t a : Impresion de la tabla ASCII. -t e : Impresion de la tabla EBCDIC (defecto).


4. Anexos

32

-c : Caracter. -d : Decimal.

-o : Octal. -x : Hexadecimal (defecto).

-v : Verificacion

-m [e|r]: Migracion tabla de conversion local emison/recepcion

tablaIn : Fichero con la tabla a migrar tablaOut: Fichero con la tabla migrada

4.2.6 igacmd

Descripción

Este comando establece un mecanismo de comunicación entre aplicaciones o programas de usuario y editran/G, permitiendo invocar operaciones de forma desatendida y automática. Es el comando equivalente al gestor de editran/G menug interactivo.

Permite construir procedimientos asociados a envíos y/o recepciones, con encadenamientos de nuevas emisiones o recepciones.

Sintaxis

igacmd. Peticionario de EDItran/G en modo comando.

Uso : igacmd -o <operacion> -p <presentacion> [-v] [-w]

Siendo : -o <operacion> : Operacion a realizar.

InitE - Inicializar emision LoadE - Cargar emision

Send - Emitir EndE - Interrumpir emision InitR - Inicializar recepcion

UnloadR - Descargar recepcion Recv - Recibir.

EndR - Interrumpir recepcion. -p <presentacion#> : Identificador de la presentacion.

-v : Modo verboso. -w : Espera finalizacion de la peticion.

Ejemplo:

Se desea que al final de la recepción de una determinada presentación se genere una emisión al sistema editran remoto cuya presentación es PRUEBA.

Para ello, el fichero de usuario posterior a recepción incluirá la llamada siguiente:

...

igacmd –o Send –p PRUEBA -v

...

Cuando editran/G invoque el automatismo asociado al final de recepción (comando anterior), igacmd enviará, a su vez, una señal a editran/G indicando que el usuario ha solicitado una operación de comienzo de emisión para la presentación PRUEBA.

Códigos de retorno


4. Anexos

33

En general los códigos de retorno del comando son los listados en el apartado 4.4.2 Códigos de error editran/G y que corresponden al resultado de la operación realizada por editran/G cuando la petición se realiza con la opción –w.

4.2.7 menug

Descripción

Este comando permite acceder de forma directa al menú del gestor de editran/G.

4.2.8 estcmd

Descripción

Este comando se utiliza para conocer el estado de las presentaciones editran/G. Si no se especifica el identificador de la presentación, se lista el estado de todas las emisiones o recepciones pendientes.

Sintaxis

estcmd. Utilidad de impresion estado de presentacion de EDItran/G. V52.0 – MMM DD YYYY

Copyright (C) editran INDRA

Uso : estcmd E|R [presentacion] <Opciones>

E|R : Emision o recepcion. [presentacion#] : Identificador de la presentacion.

Códigos de retorno:

Valor numérico que corresponde a los siguientes estados INACTIVA 0

CARGANDO/DESCARGANDO 1 CARGADA 2

TRANSMITIENDO 3 TRANSMITIDA 4

INTERRUMPIDA 6

4.2.9 igaperfi

Descripción

Este comando se utiliza para la gestión de los perfiles de editran/G en modo comando. Existe información detallada sobre esta utilidad en el documento “Gestión de Perfiles editran/P y editran/G. Manual de usuario.”

Sintaxis

Uso: igaperfi: Comando de Introduccion Desatendida de Perfiles EDItran/G. V52.0 – MMM DD YYY

Copyright (C) editran INDRA Uso: igaperfi [-h] [-f<inputfile>]

[-r {[-a [-V<v>] [-R<r>]] | [-s<presentacion>]} [-o<outputfile>]] -h: ayuda (esta)

-f<inputfile>: nombre del fichero con comandos de modificacion de perfil. (defecto=stdin)

-r: volcado de presentaciones EDItran/G a fichero. -s<presentacion>: presentacion EDItran/G a volcar.

-a: volcado de todas las presentaciones a fichero. -R<r>: Release del fichero a volcar.

Valores validos de <r> 2..8 -V<v>: Version del fichero a volcar.

Valores validos de <v> 22, 30, 31, 40 y 41


4. Anexos

34

-o<outputfile>: nombre del fichero en el cual se volcara la sesion. (defecto=stdout)

4.2.10 modiperfi

Descripción

Este comando se utiliza para modificar o dar de baja los perfiles de editran/P y editran/G, tanto de una sesión/presentación como de varias simultáneamente.

Sintaxis

modiperfi. Utilidad para modificacion y baja de perfiles. V52.0 – MMM DD YYYY

Copyright (C) editran INDRA

Uso: modiperfi [-h] | {-o<P|G|F [-c]> [-r<remoto>] [-a<aplicacion>] [-l<local>]

[-s<sesion>|-p<presentacion>] -m<-Exx=yy ...|-Ixx=yy ...>} | {-b -o<P|G> -s<sesion|-p<presentacion>}

<Opciones> -h: Informacion de ayuda.

-o<P|G|F>: Identificador de la opcion de los perfiles que se desean modificar.'P' para modificar los perfiles de EDItran/P, 'G' para los de EDItran/G y 'F' para las modificaciones

relativas a ficheros.

-c: Solo compatible con la opcion "-oF". Si el fichero a modificar no existe se crea.

-r<remoto>: Identificador del remoto. Admite escribir unicamente las cifras significativas.

-a<aplicacion>: Identificador de la aplicacion. Admite los metacaracteres '*' y '?' como comodines.

-l<local>: Identificador del local. Admite escribir unicamente las cifras significativas.

-s<sesion>|-p<presentacion>: Identificadores de la sesion y de la presentacion respectivamente. Admiten los

metacaracteres '*' y '?' como comodines. -m<-Exx=yy ...|-Ixx=yy ...>: Identificador de las modificaciones. Pone

el/los parametro/s del perfil EDItran/P o EDItran/G 'xx' a 'yy' (vease el manual del

comando cfgupt o ejecutese "cfgupt -H"). -b: Identifica que se va a dar de baja una sesion o una presentacion.

4.2.11 PROGRAMAS DE USUARIO

Descripción

Estos programas serán aportados por el usuario y se llamarán durante los procesos de la presentación.

Sintaxis

Dependiendo del momento en que se ejecutan hay tres tipos de programas de usuario:

Previos a la Emisión/Recepción. Si el usuario establece en la configuración algún programa, será el primer paso realizado cuando comienza un envío. Estos programas son invocados con los siguientes argumentos:

0 Nombre del programa.

1 Presentación.

2 Indica emisión (E) o recepción (R).

3 Código Local


4. Anexos

35

4 Código Remoto

5 Aplicación

Posterior a la Emisión/Recepción. Si el usuario establece en la configuración algún programa, se lanzará cuando la transmisión finaliza con éxito. Cada vez que se emite o recibe por una presentación se genera un fichero con el listado de los ficheros transmitidos. Este fichero es el que se recomienda que se use para integración con otras aplicaciones. Se podría, por ejemplo, utilizar para guardar en BBDD la ruta de los ficheros transmitidos. Estos programas son invocados con los siguientes argumentos:


1 Presentación.


3 Código Local

4 Código Remoto

5 Aplicación

6 Ruta absoluta del archivo que guarda el listado de ficheros emitidos o recibidos.

Ejemplo: Programa batch que elimina los ficheros emitidos

@echo off echo ###############################################

echo SCRIPT DE USUARIO POSTERIOR A EMISION: %0. timestamp

echo PRESENTACION : %2-%1 (%3-%4-%5) echo ###############################################

FOR /F %%p IN (%6) DO del /Q %%p > NUL 2>NUL

goto:EOF

Excepción. Si el usuario establece en la configuración algún programa de excepción, se lanzará cuando se produzca cualquier error durante la emisión o recepción. De esta manera se podría integrar editran con algún mecanismo de alertas desarrollado por el usuario. Estos programas son invocados con los siguientes argumentos:


1 Presentación.


3 Resultado

4 Código Local

5 Código Remoto

6 Aplicación

4.3 Ficheros

4.3.1 Subcarpeta CFG

editrang.cfg

Fichero de configuración de editran/G. Almacena el perfil local y los perfiles de las presentaciones. No es un fichero editable, sólo debe modificarse desde la interfaz de usuario.


4. Anexos

36

4.3.2 Subcarpeta DOC

editran.html

Documentación de editran que contiene guías rápidas de configuración y consulta.

4.3.3 Subcarpeta BIN

ckds.des

Fichero que almacena las claves auxiliares para el intercambio de las claves de sesión en el cifrado DES en versión 2.2.

editrang.log

Fichero creado con el comando makelog. Almacena de forma cíclica el resumen de las operaciones realizadas por editran/G, por lo que una vez alcanzado el número máximo de entradas sobrescribe la más antigua.

Puede consultarse desde el menú de Editran/G y mediante el comando printlog descrito en el manual de usuario de editran/P.

editrang.msg

Fichero donde están almacenados los mensajes que se presentan al operador de editran/G.

licencia.dat

Fichero de licencia de editran. Se utiliza para controlar la funcionalidad contratada. Si no existe este fichero o su contenido es alterado, no se podrá iniciar el servicio editran.


4. Anexos

37

licencia.publick

Fichero con la clave pública entregada por Indra para la verificación de la licencia. Al igual que el fichero licencia.dat no debe ser manipulado.

4.3.3.1 Subcarpeta utils

U_PREVIO, U_POSTERIOR, U_EXCEPCION

En esta carpeta se entregan unos programas en batch que sirven como ejemplo para los programas de integración que desarrollen los usuarios como previos y posteriores. Funcionalmente sólo imprimen mensajes de log que quedarán en editrang.out.

NOTA: Se recomienda que los nuevos programas de usuario se dejen en esta subcarpeta o se cree una específica que sólo contenga esos

archivos.

PSTEMIGC, PSTRECGC

Programas en batch que automatizan el intercambio de claves RSA. Son los programas de usuario posteriores a emisión y recepción de la presentación empleada por editran/GC para la transmisión de las claves.

4.3.4 Subcarpeta LOG

editrang.out

Fichero donde se registran todas las salidas producidas por editran/G y los procedimientos y comandos que este proceso lanza. Es el fichero dónde el usuario encontrará el detalle de los errores producidos durante los procesos de carga y descarga. A continuación, se listan algunos casos a modo de ejemplo.

NOTA: Los ficheros con extensión “out” son texto sin formato y podrían cambiar de una versión a otra. Se recomienda que las aplicaciones no procesen ese fichero para extraer de ellos información

ya que podrían dejar de funcionar con las actualizaciones del producto.

Salida de una emisión correcta configurada con el programa posterior entregado en la instalación.

********************************************************************** CONVERSION EN EMISION DE LA PRESENTACION [CICS-TCP-02]

FECHA-HORA: [13/06/2019 10:15:33] VERSION: [52]

# C F A T D L.Reg Fecha modificacion Tamaño Enviados Cargados Nombre

_____________________________________________________________________________________________ 1 N F A N D 00080 23042009 103514 000001112166 000001085040 000001085040 fichfijo.txt 2 N V A N 00047 23042009 103622 000001152669 000001070727 000001070727 variable.txt 3 N H A N 00100 11102017 094055 000001115010 000003159000 000003159000 hibrido.txt

4 N B N N 04020 30112005 104408 000000547005 000000547005 000000547005 binario.pdf 5 N F A N N 00100 11102017 123929 000000000000 000000000000 000000000000 vacio.txt

RESULTADO: [0] **********************************************************************

################################################################################ SCRIPT DE USUARIO POSTERIOR A TRANSMISION: utils\U_POSTERIOR.bat.

Thu Jun 13 10:16:24 2019 PRESENTACION : E-CICS-TCP-02 (W00099910-000099990-PRTCP2)

FICHEROS : C:\EDITRAN_DATA/tmp/CICS-TCP-02E.ficheros


4. Anexos

38

################################################################################ [13/06/2019 10:16:24][FIN PRESENTACION][CICS-TCP-02][EMISION]: RESULTADO [0][Resultado correcto]

Salida de una emisión que falla por no existir el fichero configurado *********************************************************************

CONVERSION EN EMISION DE LA PRESENTACION [CICS-TCP-01] FECHA-HORA: [13/06/2019 10:33:14]

VERSION: [52] RESULTADO: CFG_NO_FILES [-90]

********************************************************************** ################################################################################

SCRIPT DE USUARIO DE EXCEPCION: utils\U_EXCEPCION.bat. Thu Jun 13 10:33:14 2019

PRESENTACION : E-CICS-TCP-01 (W00099910-000099990-PRTCP1) RESULTADO: 0090

################################################################################ [13/06/2019 10:33:14][FIN PRESENTACION][CICS-TCP-01][EMISION]: RESULTADO [90][No hay ficheros de aplicación para emitir]

4.3.4.1 Log diferenciado por presentación

En esta versión se puede configurar editran para que la información del fichero editrang.out se separe diferenciada por presentación. Para cambiarlo, crear en el registro de Windows el valor DWORD GLogPresentacion en la clave editran como se muestra en la imagen. Los distintos ficheros se dejarán también en la subcarpeta log de la instalación y se nombran <presentación>.log. A diferencia de lo que ocurre con el fichero editrang.out, éstos si pueden ser movidos o eliminados sin necesidad de detener el servicio.

4.4 CÓDIGOS Y MENSAJES AL OPERADOR

4.4.1 Mensajes Editran/G

Estos códigos son los que quedan reflejados en el fichero editrang.log para indicar los distintos estados por los

que pasa una presentación. En la pantalla del operador de editran/G, aparecen en forma de mensajes.

Seguidamente, se detallan dichos códigos y mensajes dando una breve explicación o acción recomendada:

MENSAJE EXPLICACIÓN/ACCIÓN RECOMENDADA

Petición de carga de emisión Se ha realizado una petición de carga de presentación de emisión.

Petición de emisión Se ha recibido una petición de emisión de presentación.

Petición de fin de emisión Se ha pedido interrumpir la emisión en curso de la presentación.

Petición de inicialización de emisión

Se ha pedido cancelar la emisión en curso de la presentación.

Emisión cancelada Se ha procesado correctamente la petición de inicialización de la emisión de la presentación.

Petición de inicialización de recepción

Se ha pedido cancelar la recepción en curso de la presentación.


4. Anexos

39


Recepción cancelada

Petición de descarga de recepción

Se ha realizado una petición de descarga de presentación de recepción.

Petición de recepción Se ha recibido una petición de recepción de presentación.

Petición de fin de recepción Se ha pedido interrumpir la recepción en curso de la presentación.

La presentación esta inicializada

Se ha pedido inicializar una emisión o recepción y la presentación no tiene ninguna transmisión pendiente.

La presentación se está transmitiendo

Se ha realizado una petición de emisión/recepción de una presentación que ya se está transmitiendo.

Estado de la presentación incompatible con la petición (<estado>)

Se ha realizado una petición incompatible con el estado de la presentación. Por ejemplo: petición de inicialización de una presentación de emisión que se está transmitiendo.

No existe el perfil de la presentación

Dar de alta el perfil de presentación correspondiente en el administrador de editran/G.

No existe el perfil de la sesión Dar de alta el perfil de sesión correspondiente en el administrador de editran/P.

Solicita emisión a editran (A1R) <sesión>

Se notifica a editran/P que inicie la emisión de una sesión de transmisión de la presentación.

Solicita fin de emisión a editran (EDP) <sesión>

Se notifica a editran/P que se interrumpa una sesión de transmisión de la presentación.

Emisión interrumpida Se ha procesado correctamente la petición de fin de emisión de la presentación.

Conversión de emisión correcta y finalizada

El proceso de carga de los tampones a emitir se ha realizado correctamente.

Conversor de recepción correcta y finalizada

El proceso de descarga de los tampones recibidos se ha realizado correctamente.

Error en el proceso de conversión de emisión

No se puede realizar la carga de tampones a emitir. Consultar el fichero editrang.out para más detalles del error.

Error en el proceso de conversión de recepción

No se puede realizar la descarga de los tampones recibidos. Consultar el fichero editrang.out para más detalles del error.

Solicita recepción a editran (A2R) <sesión>

Se notifica a editran/P que inicie la recepción de una sesión de transmisión de la presentación.

Solicita fin de recepción a editran (EDR) <sesión>

Se notifica a editran/P que interrumpa la recepción de una sesión de transmisión de la presentación.

Recepción interrumpida Se ha procesado correctamente una petición de fin de recepción.

Petición de emisión editran (A1P) <sesión>

editran/P notifica que se ha recibido una petición remota para que se emita la sesión de transmisión indicada. Se ordena la carga de tampones si no existen.

Petición de recepción editran (A2P) <sesión>

editran/P notifica que se ha recibido una petición remota para comenzar a recibir por la sesión de transmisión indicada.

Sesión editran emitida (A3P) <sesión>

editran/P notifica que ha terminado la emisión del fichero tampón de la sesión indicada. La emisión termina cuando se reciban los mensajes A3P de todas las sesiones de transmisión de la presentación.

Sesión editran recibida (A4P) <sesión>

editran/P notifica que ha terminado la recepción del fichero tampón de la sesión indicada. Cuando se reciben todos los mensajes A4P de las sesiones de transmisión de la presentación, se realiza el proceso de descarga de los tampones que finaliza la recepción.


4. Anexos

40


Sesión editran interrumpida (A7I) <sesión>

editran/P notifica que se ha interrumpido la sesión de transmisión indicada.

Fin posterior emisión sesión editran (A3R)

Respuesta a editran/P del mensaje A3P.

Fin posterior recepción sesión editran (A4R)

Respuesta a editran/P del mensaje A4P.

No hay tampón disponible (A1R-) <sesión>

Respuesta que se envía a editran/P cuando al recibir el mensaje A1P falla el proceso de carga. Al remoto que hizo la petición le llegara un mensaje A7I con código 121.

Lanza proceso de usuario previo

Se ha lanzado el proceso de usuario indicado en perfiles.

Proceso de usuario previo finalizado

El proceso de usuario indicado en perfiles ha finalizado correctamente.

Error en proceso de usuario previo

El proceso de usuario indicado en perfiles ha finalizado con error. Consultar la causa en el fichero editrang.out.

Lanza proceso de usuario posterior


Proceso de usuario posterior finalizado


Error en proceso de usuario posterior


Lanza proceso de usuario de excepción


Proceso de usuario de excepción finalizado


Error en proceso de usuario de excepción


No hay tampón disponible (A2R-) <sesión>

Respuesta que se envía a editran/P cuando al recibir el mensaje A2P falla el proceso de preparación de la recepción.

Esperando confirmación de descarga remota

La emisión está TRANSMITIDA pero se espera el resultado de la descarga remota para darla por finalizada.

Petición de confirmación Se pide a la entidad remota que confirme el estado de su recepción.

Resultado de confirmación recepción: <estado>

Respuesta recibida de la entidad remota sobre el estado de su recepción.

Cancelada espera de confirmación de descarga remota

El usuario ha decidido inicializar una emisión que estaba pendiente de recibir la confirmación remota de descarga.

Transmisión finalizada con éxito [<sentido>]

Mensaje informativo al finalizar una EMISION o RECEPCION.

Excepción: <msg> Se ha producido un error en runtime.


4. Anexos

41

4.4.2 Códigos de error editran/G

En esta tabla se documentan los diferentes códigos de error que pueden producirse durante una transmisión.

En la tabla se muestra:

COD es el valor numérico que se pasa como parámetro al script de usuario de excepción que se ejecuta cuando la transmisión falla. Si se usa el comando igacmd como API de editran/G es el valor devuelto cuando se usa con la opción –w (esperar fin de la transmisión).

ID es el alias que identifica al error en los mensajes que se graban en el fichero de Log.

MENSAJE es una breve descripción sobre el motivo del error.

COD ID MENSAJE

0 Resultado correcto

1 CMD_EXEC Error sistema: creación de proceso.

50 APIG_SNTX APIG: parámetros incorrectos.

51 APIG_INIT APIG: editran/G no iniciado o no accesible.

52 APIG_GREQ APIG: Error al comunicar con editran/G (request).

54 APIG_GRES APIG: Error al comunicar con editran/G (response).

62 NO_TAMPON Formato de fichero tampón incorrecto.

64 OPEN_IN Error al abrir fichero de aplicación que se emite.

65 OPEN_OUT Error al abrir fichero de aplicación que se recibe.

66 READ_CTRL Error al leer información de control en TAMPON o CSB.

67 WRITE_CTRL Error al escribir información de control en TAMPON o CSB.

68 WRITE_DATA Error al escribir datos en TAMPON o CSB.

69 ZERO_REC Fichero TAMPON sin registros cargados.

70 ALLOC_ERROR Error sistema: manejo de memoria.

71 SAVE_REL Error al guardar lista de ficheros transmitidos.

73 WRITE_OUT Error al escribir fichero de aplicación que se recibe.

74 SEQUENCE_CSB Fichero CSB erróneo: error de secuencia.

75 TOTAL_FILES Fichero CSB erróneo: error en el número total de ficheros.

76 TYPE_FILE Formato de fichero desconocido.

77 LENGTH_CSBREC Fichero CSB erróneo: error en la longitud de los ficheros.

78 HASH_FILE Error al calcular/verificar hash del fichero de aplicación.

79 SIZE_FILERECS Descuadre en el número de registros del fichero de aplicación. El número total de registros indicado en campos de control del CSB no coincide con los realmente descargados.

80 TOTAL_CSBRECS Fichero CSB erróneo: error en el número total de registros.

81 SIZE_FILEBYTES Descuadre en el total de bytes del fichero de aplicación. El número de bytes indicado en campos de control del CSB no coincide con los realmente descargados.

82 SYNCS_CSB Descuadre en el número de sincronismos en CSB.

83 CFG_LENGTH Fichero de aplicación con registro menor que el dado en perfil. Revisar las características de los ficheros a emitir.


4. Anexos

42

COD ID MENSAJE

84 STS_RECV Error en proceso de descarga por no haberse recibido todos los ficheros tampones de la presentación.

85 OPEN_CSB Error al abrir/crear fichero CSB.

86 NO_PERFILG_LOCAL No existe perfil local de editran/G.

87 NO_PERFILG No existe perfil de la Presentación.

90 CFG_NO_FILES No existen o no se encuentra ninguno de los ficheros especificados en perfil como ficheros de emisión.

91 USER_SCRIPT Error al ejecutar script de usuario.

93 PROFILES Perfil de la Presentación incompatible con proceso de carga/descarga.

94 CANCELED_REQ Transmisión cancelada.

95 PROC_ERROR Error interno: creación de tareas en carga/descarga.

96 RUNTIME_EXCEPT Error sistema: “runtime excepction”.

97 NO_LICENSE Problema de licencia para realizar alguna de las funciones requeridas.

98 CRYPT_ERROR Error en el tratamiento criptográfico de los datos.

99 HDRFILE Error interno: cabeceras de control inválidas.

200 NO_ACK No se ha podido confirmar la descarga remota.

201 NO_STATE Petición incompatible con estado de la transmisión.

104 EXCEPT_P Editran/P: Aborto

110 EXCEPT_P Editran/P: Operador

120 EXCEPT_P Editran/P: Tampón remoto incorrecto. Lanza previo.

121 EXCEPT_P Editran/P: Tampón remoto incorrecto. No existe previo.

122 EXCEPT_P Editran/P: Tampón remoto incorrecto. Previo en posible ejecución

123 EXCEPT_P Editran/P: Tampón remoto incorrecto. Número de sesión de intercambio incorrecto

124 EXCEPT_P Editran/P: Tampón remoto incorrecto. Número de registros totales

130 EXCEPT_P Editran/P: Liberación.

140 EXCEPT_P Editran/P: Exceso de reintentos para emitir.

160 EXCEPT_P Editran/P: Descuadre de totales.

170 EXCEPT_P Editran/P: Exceso de reintentos de sincronismo.

190 EXCEPT_P Editran/P: Exceso de reintentos de fin de emisión.

240 EXCEPT_P Editran/P: Perfiles.

250 EXCEPT_P Editran/P: Fichero no preparado.

4.4.2.1 Tabla de códigos A7I

En la lista anterior de códigos de error hay algunos que se deben a problemas con las sesiones de transmisión. En estos

casos en el log de editran/G sólo aparece el siguiente mensaje: “Sesión editran interrumpida (A7I)

[E|R]COD”. Para cada valor se explica más en detalle el motivo y si se puede solucionar sin intervención del operador.

CÓD. CAUSA EXPLICACIÓN

104 Aborto Interrupción inesperada debida a causa desconocida.


4. Anexos

43

CÓD. CAUSA EXPLICACIÓN

110 Operador Interrupción solicitada por el operador.

120 Tampón remoto incorrecto. Lanza previo

La entidad remota no tiene su Fichero Tampón disponible. El editran remoto iniciará de forma automática el proceso que prepara el Fichero Tampón y pedirá la transmisión si el perfil lo permite. Este código sólo se da cuando las entidades remotas son zOS o iSeries.

121 Tampón remoto incorrecto. No existe previo

La entidad remota no tiene su Fichero Tampón disponible. El editran remoto no está configurado para lanzar de forma automática el proceso que lo prepara por tanto no se saldrá de esta situación hasta que el operador remoto actúe.

122 Tampón remoto incorrecto. Previo en posible ejecución

La entidad remota no tiene su Fichero Tampón disponible porque está todavía en uso. En muchos casos esto puede deberse a que el editran remoto está todavía en el proceso de descarga.

123 Tampón remoto incorrecto. Número de sesión de intercambio incorrecto

El Tampón remoto se encuentra en un estado incorrecto. No coincide el número de intercambio. Es necesario inicializar la presentación, al menos en un extremo.

124 Tampón remoto incorrecto. Número de registros totales

El Tampón remoto se encuentra en un estado incorrecto. No coincide el número de registros totales. Es necesario que inicialice el receptor.

130 Liberación Interrupción debida a una liberación de la conexión.

140 Exceso de reintentos para emitir

La entidad que pide la emisión no recibe respuesta del remoto. Suele ser debido a algún problema temporal de las comunicaciones pero debería ser analizado por el operador.

170 Exceso de reintentos de sincronismo

La entidad que emite no recibe la confirmación remota de haber recibido una ráfaga de datos. Puede deberse a lentitud en las comunicaciones y podría resolverse disminuyendo el parámetro Nº reg. por bloque de emisión en el perfil de la sesión de transmisión.

190 Exceso de reintentos de fin de emisión

La entidad que emite no recibe la confirmación del remoto del fin de emisión. Esta situación puede hacer necesario que ambas entidades queden en estados diferentes y que sea necesario inicializar en alguno de los extremos.

240 Perfiles Se interrumpe la transmisión porque alguno de los parámetros del perfil de la sesión no es compatible con el fichero tampón cargado. Por ejemplo, si está cifrado y la sesión está configurada para comprimir durante la transmisión. No es recuperable sin intervención del operador.

250 Fichero no preparado Se interrumpe la transmisión porque el Fichero Tampón local se encuentra en un estado incorrecto. En estos casos, es aconsejable inicializar la Presentación.

Persona de contacto

[email protected]

Avda. de Bruselas 35

28108 Alcobendas,

Madrid, España

T +34 91 480 50 00

F +34 91 480 50 80

www.minsait.com

mailto:[email protected]

onesait ecosystems editranmontilla.indra.es › doc › win_unix › editran › win ›...

Documents