> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/open-v5.2.1/linux/interfaz_generica.md). # Gestión de Editran/G ## Gestión de Onesait Editran/G Al ejecutar **menug** en el directorio de Editran se activará el menú general del gestor de Editran /G que se presenta a continuación: ![assets/image4.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-19cca8bfa388eb5b5486c831b6fbeeb4e6be92ab%2Fimage4.png?alt=media) ### Interfaz de operación En las pantallas que se incluyen en este documento, los diferentes tipos de campos se representan de la forma siguiente: #### Pantallas En las pantallas del sistema de menús de Editran/G se pueden distinguir tres áreas: ![assets/image5.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-f9061d7645b5b567afbe54c7ccfd2b8a0d814be5%2Fimage5.png?alt=media) En el área de título aparece información general de Editran /G: * Fecha y hora actual (en el momento de activar la pantalla). * Objeto de la pantalla: administrador, operador, etc. * Versión. * **Opciones** En esta área pueden aparecer las diferentes opciones de un menú, los parámetros que debe introducir el operador o los resultados de las peticiones solicitadas. * **Información** En esta área aparece la información de progreso de las presentaciones que el sistema envía al operador: * Presentación. * Estados de emisión y recepción. * Texto de información de progreso. #### Ayuda Dispone de un sistema de ayuda sensible al contexto. De esta forma, cuando se pulsan las teclas F1 ó ? aparece una ventana con el texto de ayuda asociado al campo o pantalla donde se encuentre el cursor en ese momento. #### Teclas En Editran/G, y dentro del menú, pueden utilizarse las siguientes teclas: | | | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | F1 ? | Ayuda sensible al contexto. | | F2 | Introduce los valores por defecto del campo actual, siempre que sea posible. | | F3 | Finaliza la introducción de datos de la pantalla actual,validando todos los campos. | | F4 | Introduce los valores por defecto de toda la pantalla actual, siempre que sea posible. | | F6 | Realiza una salida al sistema operativo para ejecutar otros comandos (shell), dejando residente EDITRAN/G. Para volver a EDITRAN/G se debe ejecutar el comando de exit. | | Intro | Finaliza la introducción de datos del campo presente, actualizando su valor. Si no se ha introducido ningún valor inserta el de la última petición. | | Espacio | Selecciona el valor del campo dentro una lista de valores enumerados: | | | A (o) B ( ) C ( ) | | | o activa/desactiva el valor del campo de sólo dos valores | | | posibles: | | | D \[X] | | Esc | Aborta la introducción de datos y vuelve al menú anterior. | | Borrar | Borra el carácter anterior al cursor. | | Tab | Avanza al siguiente campo sin actualizar o modificar el valor. | | Flechas | Desplazan el cursor en la pantalla al siguiente/anterior campo o al siguiente/anterior valor dentro del campo. | | PgUp | Retroceso de página. | | Control-U | | | PgDn | Avance de página. | | Control-D | | | | | #### Selección por Lista En los menús de **Operador** y **Administrador** que se describen a continuación, el usuario debe introducir un nombre de presentación. En estos casos, si en vez de un nombre concreto se pone un filtro de búsqueda con una máscara válida (como \*, **?**), se mostrará una pantalla con la lista de presentaciones que cumplen el filtro dada. La siguiente pantalla es un ejemplo en la que se lanzan emisiones desde la lista resultante de seleccionar las presentaciones que terminan en 14 (\*14). ![assets/image6.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-1ab3594a28e87cf5711881b0a8eaf5a6c2dcf4e9%2Fimage6.png?alt=media) ### Operador de Onesait Editran/G Para operar sobre las presentaciones de intercambio, seleccionar la opción 1 del menú principal GESTOR DE Editran/G. Se presentarán las siguientes opciones: ![assets/image7.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-8291e1ab03952634eb8342d79cb229b6b5f64a92%2Fimage7.png?alt=media) #### Cargar Presentación de Emisión * Sólo se permite esta opción cuando la Presentación no tiene actividad 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. #### 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. #### 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. #### Interrumpir Presentación de 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. #### 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. #### Descargar Presentación de 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. #### 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 falla el proceso de descarga. En este caso se puede reintentar una vez solucionado el problema mediante la opción *Descargar Presentación de Recepción*. En la imagen, una secuencia típica de mensajes de log asociados a una petición de recepción de una presentación con una sola sesión de transmisión. #### Interrumpir Presentación de 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 #### Consulta de Estados de Presentación Para consultar una presentación particular teclear la presentación y pulsar Intro. En el área de información de la pantalla (parte inferior) aparecerá la información de los estados de emisión y recepción de la presentación solicitada. ### Gestor de Ficheros de Control ![assets/image8.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-3d6b49f61201ad34526f124d8ffc18015730eb92%2Fimage8.png?alt=media) Seleccione la opción deseada y pulse Intro. #### Consulta de Estados de Presentación ![assets/image9.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-6ef6ae4644d132d109a279fc95fc022fdd20e4a4%2Fimage9.png?alt=media) Seleccione la presentación a consultar y pulse Intro. ![assets/image10.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-cb9763c76e794b2312302dc6ba4c222435569289%2Fimage10.png?alt=media) **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. | | | | #### Modificación de Estados de Presentación * **Presentación Pendiente** * Su valor es **Sí** cuando se ha producido una carga y todavía no se ha emitido. * **Presentación** * El número de presentación se inicializa a 1. Se incrementa una unidad cada vez que se realiza la carga de emisión de presentación y más concretamente, cuando el estado de la presentación de emisión pasa de NO CARGADO a CARGADO TAMPON, aunque este estado evoluciona automáticamente a CARGADO TAMPON y posteriormente a TRANSMITIENDO. * **Sesiones editran** * Aparecen tantas líneas como sesiones de transmisión se utilicen en la presentación, hasta un máximo de 20. Aparecen en cada línea: sesión y descripción del estado de la sesión y fecha y hora del cambio de estado. La modificación de los estados de presentación es una operación extraordinaria que sólo debe realizarse en circunstancias anómalas, habiendo activado la opción de "Incrementar número de presentación" ![assets/image11.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-921a348cdb0b5f4dd6109b11598af265f9fe312e%2Fimage11.png?alt=media) 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. Introducir S o N; si S, los estados pasarán a NO CARGADA. Con Intro se realiza la modificación y con Esc se cancela. ![assets/image12.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-eeb4e40294ea75421bebf7a600b277e2bdb4c459%2Fimage12.png?alt=media) #### Consulta de LOG ![assets/image13.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-34a30eed00a918b73d316df311ed546d94584241%2Fimage13.png?alt=media) Estos datos se emplean en los criterios de selección para la consulta del log. Se presentan los mensajes generados a partir de la fecha introducida. * **PRESENTACION**: Una concreta, una máscara (por ejemplo, P\* para ver todas las que empiezan por P) o ceros o en blanco para todas. * **FECHA**: A partir de una concreta o ninguna para mostrar la última información registrada. * **HORA**: A partir de una concreta dentro de una fecha ![assets/image14.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-be032b22baa947e87147109581f170cfe02e7882%2Fimage14.png?alt=media) Una vez dentro de la consulta del log, se navegará por el mismo utilizando PgUp o Ctrl-U para ver la página anterior y PgDn o Ctrl-D para ver la página siguiente. Con Esc se volverá a la pantalla de opciones de la consulta. Se muestran la sesión de presentación y la fecha, la hora y el texto del mensaje. ### Administrador de Onesait Editran/G Se accede al administrador de Editran/G seleccionando la opción 3 desde el menú principal, presentándose la siguiente pantalla. ![assets/image15.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-f312bc5d11decae631d075a7ebc3cb2b231a3f8d%2Fimage15.png?alt=media) #### Perfil Entidad Remota ![assets/image16.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-76b83d26cd9b7e37db82aea82e1984aa64a8a112%2Fimage16.png?alt=media) Introducir la opción deseada y el código de la entidad remota, que debe ser el mismo que el empleado en Editran/P. ![assets/image17.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-d3864d974dcf04a9a05c0094f050ed4435fe5632%2Fimage17.png?alt=media) * **DESCRIPCIÓN** Nombre descriptivo de la entidad remota. * **VERSION EDITRAN/G REMOTA** | | | | ------- | -------------------------------------------------- | | **4.1** | Si la entidad remota va a utilizar Editran/G v4.1. | | **5.0** | Si la entidad remota va a utilizar Editran/G v5.0. | | **5.1** | Si la entidad remota va a utilizar Editran/G v5.1. | | **5.2** | Si la entidad remota va a utilizar Editran/G v5.2. | | | | * **ASCII/EBCDIC** * **A** ASCII * **E** EBCDIC * Es necesario proporcionar el juego de caracteres que utiliza la máquina remota, ASCII o EBCDIC, siempre que la versión remota sea inferior a 5.0. Esto no implica que se vaya a efectuar traducción de datos, cosa que se determina en la lista de ficheros a emitir. * **PARAMETROS DE 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. * **CRIPTOGRAFIA (S/N)** * **S** Si desea Criptografía EDITRAN/G. * **N** Si no desea utilizar la Criptografía EDITRAN/G Si selecciona **S** se establecen el resto de ajustes que configuran el sistema criptográfico. * **VERSION CRIPTOGRAFIA** * 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. * 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 CONFIDENCIALIDAD** * Algoritmo a utilizar para cifrar los datos. Dejar vacío si no desea cifrado de datos. * **DES** si desea cifrado DES. * **TD2** cifrado TRIPLE-DES con clave doble. * **TD3** cifrado TRIPLE-DES con clave triple. * **AES** cifrado AES-128. * **AE2** cifrado AES-192. * **AE3** cifrado AES-256 * **ALGORITMO AUTENTICACION** * Algoritmo a utilizar para cifrar las claves, siendo obligatorio si está activada la criptografía. * **DES** si desea autenticar los extremos (válido solo para 3.0). * **RSA** si desea autenticar los extremos (válido para versión 3.0 y 4.0) * **GESTION CLAVES V3.0** 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 este campo se pone a **S** (Sí), se usa la clave activa de los subsistemas configurados. Consultar el manual de usuario de E*ditran/GC Gestión de claves* para ampliar información sobre la utilidad. * **CLAVE LOCAL** * Etiqueta de la clave auxiliar DES, RSA privada, siendo obligatoria cuando la versión de Criptografía es 3.0 y hay autenticación. * **CLAVE REMOTA** * Etiqueta de la clave auxiliar DES, RSA pública, siendo obligatoria cuando la versión de Criptografía es 3.0 y hay autenticación Con Intro se realiza el alta. Con Esc se abandona. Los valores de los datos de una entidad remota se pasan a las presentaciones de dicha entidad, cuando éstas son dadas de alta, como valores por defecto. La modificación y la consulta del perfil de una entidad remota se realizan de la misma forma que el alta, pero el perfil debe existir previamente. Los valores modificados no se trasladan a los coincidentes de las presentaciones de la misma entidad. En la baja de perfil de entidad remota aparece una pantalla igual a la descrita en primer lugar. Con Intro se confirma la baja y con Esc se cancela. En todas las opciones, excepto el alta, pueden utilizarse filtros para seleccionar la presentación de la lista de las posibles. #### Perfil Aplicación ![assets/image18.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-6b1a47071f772198820aaf7ca70041048ab85d5a%2Fimage18.png?alt=media) ![assets/image19.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-17aa7585ee368e4f52afc0b7f5ba14de2f431534%2Fimage19.png?alt=media) * **DESCRIPCIÓN** Nombre de la aplicación de presentación. * **TABLAS DE CONVERSION** 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: \ \ 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. > Los ficheros de tablas deben estar ubicados en la subcarpeta *bin* de Editran. * **PROGRAMAS DE USUARIO** Llamados por Editran/G antes y después de emitir y recibir. El programa de excepción se ejecuta siempre que se produzca un error en el envío. 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 scripts 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. Con Intro se realiza el alta. Con Esc se abandona. Los valores de los datos de una aplicación de presentación se pasan a las presentaciones de dicha entidad, cuando éstas son dadas de alta, como valores por defecto. La modificación y la consulta del perfil de una aplicación de presentación se realizan de la misma forma que el alta, pero el perfil debe existir previamente. Los valores modificados no se trasladan a los coincidentes de las presentaciones de la misma entidad. #### Presentación ![assets/image20.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-f0eba8fdb0e689f87b98dcd66c4f3193882d3c17%2Fimage20.png?alt=media) Introducir la opción deseada y los códigos de la entidad remota y de la aplicación de presentación. Si esos perfiles ya existen las pantallas tomarán sus datos como plantilla, si no el usuario deberá rellenarlos en este momento. Para navegar por ellas debe utilizar las flechas, la tecla Esc para cancelar el alta, Intro para avanzar y para ejecutar el alta y F3 para finalizar la introducción de datos de la pantalla actual, validando todos los campos. Se validan los datos introducidos en todos los casos excepto cuando se pulsa Esc. \**\** * **Datos de identificación de la Presentación** ![assets/image21.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-4418bc8e25dfe33a6410f15471fe39807ad0d13f%2Fimage21.png?alt=media) * **Datos del Remoto** ![assets/image22.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-639ae77bf7dd0a69c65314ed09b94932654f79a4%2Fimage22.png?alt=media) Son los descritos en el apartado **PERFIL ENTIDAD REMOTA.** * **Datos de la Aplicación** ![assets/image23.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-39c6079fc6826cfe3f54790f8d63f5f9597ff87d%2Fimage23.png?alt=media) En el apartado **PERFIL APLICACIÓN** se describen datos generales y programas de Usuario. * **EDITRAN FF - COMPROBAR LAS FIRMAS** > Si se activa esta funcionalidad (con opción S), en el proceso de carga de Editran/G se llama a un servicio de Editran/FF que le comunica la lista de ficheros que cumplen el workflow de firmas establecido en el perfil de una Aplicación FF. > > En el apartado [Operación de envíos utilizando Editran/FF integrado](https://gitlab.devops.onesait.com/onesait/disruptors/ecosystems-editran/editran-documentation/-/blob/public/open/5.2.1/linux/interfaz_generica/README.md#operación-de-envíos-utilizando-editranff-integrado) se explica con más detalle esta opción. * **Datos de la Presentación** ![assets/image24.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-4a6313b21d8643ffca465cc3202d34510b93caef%2Fimage24.png?alt=media) * **INCREMENTAR Nº PRESENTACIÓN (S/N)** > 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/P asociadas a la misma en los procesos previos de emisión y recepción. * **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. > > **N** Una única carga por emisión. > > **A** Permite cargar varias veces antes de emitir. * **PEDIR CONFIRMACION 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. * **NUMERO DE SESIONES DE TRANSMISIÓN** > Número de sesiones EDITRAN/P asociadas a la presentación editran /G. A continuación, se debe especificar cuáles son. Estas sesiones tienen que haber sido dadas de alta previamente. Todas las sesiones EDITRAN/P tendrán los mismos códigos local y remoto que la presentación de editran /G. * **CRITERIO DE DIVISIÓN (V/S/F/N)** > Sólo si se van a utilizar varias sesiones de transmisión para la de presentación. Pueden especificarse los valores siguientes: > > **V** 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. > > **F** Reparto por fichero. Se irían asignando a cada tampón de emisión sucesivos ficheros completos. > > **N** No se realiza división. * **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 completarán tantos elementos como indica el campo número de sesiones. Se valida que las sesiones introducidas existen. * **Datos de los ficheros** ![assets/image25.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-2b73b868f97e64acf5659a0a45515bb5a098b4eb%2Fimage25.png?alt=media) * **FICHEROS DE EMISION DE LA PRESENTACION** > La sección consta de 7 columnas: * Primera columna: **COM** > Se refiere a la compresión del fichero o ficheros que queremos enviar y puede tener los siguientes valores: > > **F** Compresión activada. > > **N** Compresión inhibida. * Segunda columna: **FMT** > Se refiere al formato de los ficheros que queremos enviar y puede tener los siguientes valores: > > **F** Fijo. Los ficheros de aplicación se leen en forma de registros de longitud fija. La longitud la determina el parámetro siguiente. > > En este formato existe la posibilidad opcional de eliminar delimitadores (salto de línea). > > **V** Variable. Los ficheros de aplicación son leídos línea a línea, siendo el delimitador de línea los caracteres CR-LF en PC's y CR en máquinas UNIX. Estos caracteres de delimitación no se envían al sistema remoto; en el proceso de conversión remoto se realiza la operación inversa, insertando los caracteres de delimitación de línea adecuados para el sistema receptor. Este es el formato que debe utilizarse para transmitir ficheros de texto entre entornos heterogéneos (UNIX PC, UNIX CICS, etc.). > > **H** Híbrido. Los ficheros se leen como variables y se envían al sistema remoto como fijos rellenando con espacios cada línea hasta completar la longitud de registro definida en el campo **LONG**. > > **B** Binario. Modo transparente (sin transformaciones). > > Solo para entornos homogéneos si la versión remota es superior a 4.1. * Tercera columna: **LONG** > Se refiere a la longitud de registro del fichero o ficheros que queremos enviar. * Cuarta columna: **DEL** > Solo aplica a ficheros con formato Fijo. En estos casos se indica si cada registro finaliza o no con salto de línea, y si es formato Unix (**U**) o windows (**D**). * Quinta columna: **ALF** > Se refiere al alfabeto que tienen el fichero o ficheros que queremos enviar y puede tener los siguientes valores: > > **A Ascii**. Los datos del fichero o ficheros están en Ascii. > > **E Ebcdic**. Los datos del fichero o ficheros están en Ebcdic. * Sexta columna: **TRA** > Se refiere a si queremos traducir el alfabeto de los ficheros que queremos enviar y puede tener los siguientes valores: > > **S** si se quiere traducir. > > **N** si no se quiere traducir. > > Actualmente hay gran variedad de codificaciones que extienden US-ASCII (códigos de 0 a 127), por lo que hay que tener en cuenta que para la correcta visualización del fichero en ambos extremos es necesario que ambas plataformas trabajen con tablas compatibles. Por ejemplo, si en su plataforma trabaja con ISO 8859-1, que incluye entre otros el carácter 'ñ', al traducirlo a EBCDIC es necesario que el entorno mainframe tenga el codepage equivalente para que se vea de igual manera. * Séptima columna: **NOMBRE** > Se refiere al path donde se encuentra el fichero o ficheros a enviar. * **DESTINO DE RECEPCIÓN** > Es el path donde se dejarán los ficheros recibidos. Como nombre de fichero se puede especificar una máscara utilizando los comodines que se comentan a continuación. Durante la descarga se realiza la transformación de los nombres de los ficheros uno a uno aplicando el formato dado. No se pueden definir caracteres no admitidos por el sistema operativo (\\, /, :, ?, \*, ", <, >, etc.). > > Se pueden utilizar comodines en la recepción. * **DELIMITADOR (D/U/N):** > **D** Descarga los ficheros Fijos con el delimitador de Windows. > > **U** Descarga los ficheros Fijos con el delimitador de Unix. > > **N** Descarga los ficheros Fijos sin añadir delimitador. * **TRADUCIR (A/E/N):** > **A** Se traduce a ASCII si se reciben en EBCDIC. > > **E** Se traduce a EBCDIC si se reciben en ASCII. > > **N** No se traduce. #### Consulta genérica de perfiles ![assets/image26.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-2fa744c7678e59faf258233c4b5800f025af2d62%2Fimage26.png?alt=media) **Entidades remotas** Se obtiene una relación de entidades remotas con los datos de las Presentaciones en que están siendo utilizadas. Si ocupan más de una pantalla, se navega entre ellas con PgUp o Ctrl-U para página anterior y PgDn o Ctrl-D para página siguiente. Con ESC se retorna al menú de consultas genéricas. ![assets/image27.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-16106dafbdecb2e421079d0bdb5ee0a6943efaae%2Fimage27.png?alt=media) **Aplicaciones** Se obtiene una relación de aplicaciones con los datos de las presentaciones en que se están utilizando. Si ocupan más de una pantalla, se navega por ellas con PgUp o Ctrl-U para página anterior y PgDn o Ctrl-D para página siguiente. Con Esc se retorna al menú de consultas genéricas. ![assets/image28.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-4cda7f2a7d06fe724a458fd878e9a7cea22086cd%2Fimage28.png?alt=media) **Presentaciones** Se obtiene una relación de presentación con su descripción. Si ocupan más de una pantalla, se navega entre ellas con PgUp o Ctrl-U para pagina anterior y PgDn o Ctrl-D para página siguiente. Con Esc se retorna al menú de consultas genéricas. ![assets/image29.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-3557212ed101f0e58611cab25c7544a6908bf2db%2Fimage29.png?alt=media) ### Operación de envíos utilizando Editran/FF integrado #### Configuración de Editran/G para conectar con el servidor Editran/FF Para poder utilizar la funcionalidad de envío de ficheros firmados por FF se debe configurar el entorno de Editran para comunicarse con el servidor de Editran/FF disponible. En Unix, esta configuración se encuentra en las carpetas **cfg** y **bin** del producto, donde se establecen los datos que permiten la comunicación entre Editran y el servidor FF. En **cfg** Fichero: **distribuido.cfg** ![assets/image30.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-947ec7c2cb3c30de5c10c21feb3aeb35dedb17f0%2Fimage30.png?alt=media) Se debe configurar con la dirección IP o *hostname*, más el puerto de escucha de la máquina donde esté instalado el servidor de Editran/FF (el puerto por defecto es el **8300**). Si el servidor FF se encuentra instalado en la misma máquina donde se instaló Editran, la dirección IP que se indique será: 127.0.0.1:8300 En **bin** Fichero: **EDItran** ![assets/image31.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-3766f33b1b47ef49760da7f2dca387c2f7c118ee%2Fimage31.png?alt=media) En esta variable se indicará el directorio de envíos configurado a nivel general en el servidor de Editran/FF, en el cual Editran buscará los ficheros firmados y listos para enviar. #### Envío de ficheros firmados con Editran/FF Se deberá configurar una presentación de Editran/G para que tome como origen de datos las aplicaciones de Editran/FF que tienen archivos disponibles para su envío. Para ello, hay que crear una nueva presentación en Editran/G o editar una ya existente. Una vez en el menuG, en los datos de aplicación del perfil de la presentación, tenemos la opción de "**Comprobar las firmas (S/N)**": ![assets/image32.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-cc9fe3c39c7da0fbdb8a9637a3c6e8566e061723%2Fimage32.png?alt=media) Si la comunicación con el servidor de FF es correcta aparecerá la pantalla de elección de Aplicaciones FF, similar al diálogo de elección de ficheros a emitir. Si la comunicación no ha sido posible aparecerá un mensaje de error notificando el problema. En lugar de los ficheros, se indicarán las aplicaciones de Editran/FF que han sido configuradas para el envío con Editran. Se podrán indicar tantas aplicaciones como se deseen enviar por la misma presentación de Editran/G: ![assets/image33.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-c10a320754e92b6f9c60b63f00dc3ea4b2ae301a%2Fimage33.png?alt=media) ## Funcionalidad adicional ### Informe de ficheros transmitidos La generación del informe diario de ficheros transmitidos es una funcionalidad opcional que puede activar el administrador del sistema a nivel de aplicación. Es decir, si se activa el informe, registrará los ficheros transmitidos por todas las Presentaciones. Para configurar esta funcionalidad se debe modificar en el script *EDItran* el entorno de ejecución de la aplicación. Con el servicio detenido, editar el script para modificar las siguientes líneas: ![assets/image34.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-6ef6b3ca5356eff32e89019da2aa444c6e4067fc%2Fimage34.png?alt=media) Se debe establecer la variable de entorno *EDI\_REPORT\_PATH* con el path donde se quiere que se dejen los informes generados. Ese path debe ser la ruta absoluta de un directorio que exista. Por ejemplo: ![assets/image35.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-a4a7f24ac9aff29fe2610d9ca5dc1358fee19f82%2Fimage35.png?alt=media) El nombre de los informes generados es *FicherosEditran.\.txt*, siendo yyyymmdd el año, mes y día en curso. Son archivos en formato csv con columnas separadas por ','. Adicionalmente, en el script *EDItran,* se puede establecer el nivel de detalle de los datos mostrados en los informes mediante la variable EDI\_REPORT\_LEVEL: ![assets/image36.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-62a7e90ce1299415fa4e1a58b60646b4c6978ce3%2Fimage36.png?alt=media) Si no se informa esta variable, Editran tomará como valor por defecto el 0. Para darle otro valor, bastará con editar el script de la siguiente manera: ![assets/image37.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-cb3ea9376105eec7c852b9bd61166fb443a52890%2Fimage37.png?alt=media) A continuación, se detallan los campos mostrados en el informe diario de ficheros transmitidos: *** | **Campo** | **Valor mínimo de ReportLevel para mostrarlo** | | ---------------------------- | ---------------------------------------------- | | Fecha-hora | 0 | | Emisión/recepción | 0 | | Presentación | 0 | | Código local | 0 | | Código Remoto | 0 | | Aplicación | 0 | | Ruta del fichero | 0 | | Formato | 0 | | Alfabeto en origen | 0 | | Comprimido | 0 | | Cifrado | 0 | | Tamaño en bytes | 0 | | Delimitador | 1 | | Alfabeto en destino | 1 | | Firmado | 1 | | Nombre del fichero en origen | 1 | | Longitud de registro | 1 | | Número de registros | 1 | | Fichero concatenado | 1 | ## Anexos ### 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 > Configuramos el siguiente destino de recepción: **../directorio\_destino/+banco\_%D-%M-%Y\_%h-%m-%s** *** | Ficheros enviados | **Ficheros descargados** | | ----------------- | -------------------------------------------------- | | 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 > Configuramos el siguiente destino de recepción: **../directorio\_destino/banco-%D-%M-%Y\_%4c** *** | **Ficheros enviados** | **Ficheros descargados** | | --------------------- | --------------------------------------------- | | 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 > Configuramos el siguiente destino de recepción: **../directorio\_destino/banco\_%o** *** | **Ficheros enviados** | **Ficheros descargados** | | --------------------- | ----------------------------------- | | 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). * Caso 5 > Configuramos el siguiente destino de recepción: **../directorio\_destino/+fichero\_unico** *** | **Ficheros enviados** | **Ficheros descargados** | | --------------------- | ------------------------------------- | | 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 + d, debido al +. * Caso 6 > Configuramos el siguiente destino de recepción: **../directorio\_destino/fichero\_unico** *** | **Ficheros enviados** | **Ficheros descargados** | | --------------------- | ------------------------------------- | | 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 d.txt. * Caso 7 Configuramos el siguiente destino de recepción: **../directorio-destino/%o\_%D-%M-%Y** *** | Ficheros enviados | **Ficheros descargados** | | ----------------- | -------------------------------------- | | a.txt | ../directorio\_destino/a.txt\_17-10-20 | | b.txt | ../directorio\_destino/b.txt\_17-10-20 | | c.txt | ../directorio\_destino/c.txt\_17-10-20 | | d.txt | ../directorio\_destino/d.txt\_17-10-20 | | | | > 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. ### Programas de Usuario Estos programas serán aportados por el usuario y se llamarán durante los procesos de la presentación. 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** 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: * **0** Nombre del programa. * **1** Presentación. * **2** Indica emisión (E) o recepción (R). * **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. Nuevo en v5.2 Cada archivo de listado de ficheros emitidos/recibidos tiene los siguientes campos separados por ',': | **Campo de fichero** | **Valor mínimo de EDI\_REPORT\_LEVEL para mostrarlo** | | -------------------- | ----------------------------------------------------- | | Ruta del fichero | 0 | | Formato | 1 | | Longitud de registro | 1 | | Número de registros | 1 | | Fichero concatenado | 1 | | | | * **Ejemplo:** script que elimina los ficheros emitidos (con formato EDI\_REPORT\_LEVEL=0) \#!/bin/sh \#Argumentos: \# $1 - Presentacion \# $2 - Sentido \# $3 - Codigo local \# $4 - Codigo remoto \# $5 - Aplicacion \# $6 - Path del fichero con la lista de ficheros transmitidos EXIT\_STATUS="" echo "################################################################################" echo "Se borra ficheros emitidos por \[ $0 ]" echo "\`date\`" echo "PRESENTACION: $2-$1 ($3-$4-$5)" echo "FICHEROS: \[$6]" while read fclave do if \[ "$fclave" != "" ]; then echo "Fichero $fclave eliminado" rm "$fclave" fi done < $6 EXIT\_STATUS="$?" echo "EXIT CODE : ${EXIT\_STATUS}" echo "##############################################################" exit ${EXIT\_STATUS} * **Ejemplo:** script que elimina los ficheros emitidos (con formato EDI\_REPORT\_LEVEL=1) \#!/bin/sh \#Argumentos: \# $1 - Presentacion \# $2 - Sentido \# $3 - Codigo local \# $4 - Codigo remoto \# $5 - Aplicacion \# $6 - Path del fichero con la lista de ficheros transmitidos EXIT\_STATUS="" echo "################################################################################" echo "Se borra ficheros emitidos por \[ $0 ]" echo "\`date\`" echo "PRESENTACION: $2-$1 ($3-$4-$5)" echo "FICHEROS: \[$6]" awk -F',' '{if ($1 != "") print $1}' $6 | while read fclave do if \[ -f "${fclave}" ]; then rm "${fclave}" echo "Fichero $fclave eliminado" fi fi done EXIT\_STATUS="$?" echo "EXIT CODE : ${EXIT\_STATUS}" echo "##############################################################" exit ${EXIT\_STATUS} * **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: * **0** Nombre del programa. * **1** Presentación. * **2** Indica emisión (E) o recepción (R). * **3** Resultado * **4** Código Local * **5** Código Remoto * **6** Aplicación **Compatibilidad con versiones previas** Los parámetros que Editran pasa a los programas de usuario han cambiado en esta versión. Se recomienda adaptar los programas desarrollados en versiones anteriores al actualizar el producto. Si no es posible, puede seguir trabajando con los programas antiguos configurando la instalación para que funcione en modo compatible. Este modo se establece añadiendo en el script **EDItran** las siguientes líneas: \################# \#EDI\_GUPGRADE: Compatibilidad con programas de usuario de versiones previas EDI\_GUPGRADE=1 export EDI\_GUPGRADE #### Comandos **gload52** * Descripción 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 \ \ \ : Identidad de la presentacion. #### 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] \ \ \: Identidad de la presentacion. #### 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 \ \ \: Identidad de la presentacion. #### 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] \ \ \: Identidad de la presentacion. #### 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. 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 han cambiado 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). > > -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 #### 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. V2.0 R0 - Apr 30 2013 Copyright (C) 1991-2011 INDRA Uso : igacmd -o \ -p \ \[-v] \[-w] Siendo : -o \: 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 \ : 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** En general los códigos de retorno del comando son los listados en el apartado [códigos de error de editrang](#códigos-de-error-editrang) y que corresponden al resultado de la operación realizada por EDITRAN/G cuando la petición se realiza con la opción -w. Además, hay otros valores para indicar los problemas de comunicación con EDITRAN/G. | | | | -- | ------------------------------------------------------- | | 0 | Resultado correcto | | 60 | Sintaxis incorrecta | | 61 | Sistema EDITRAN/G no iniciado | | 62 | Error al comunicar con EDITRAN/G al enviar petición | | 63 | Error al comunicar con EDITRAN/G para recibir resultado | | | | #### menug * **Descripción** Este comando permite acceder de forma directa al menú del gestor de editran/G. #### estcmd * **Descripción** Este comando se utiliza para conocer el estado de una presentación editran/G. * **Sintaxis** > estcmd. Utilidad de impresion estado de presentacion de EDItran/G. > > V5.2.1 - Feb 6 2023 > > Copyright (C) Editran INDRA > > Uso : estcmd E|R \[presentacion] > > \ > > E|R : Emision o recepcion. > > \[presentacion#] : Identificador de la presentación. * **Códigos de retorno:** Valor numérico de 0 a 6 que corresponde a los siguientes estados > SIN ACTIVIDAD 0 > > CARGA/DESCARGA 1 > > CARGADA 2 > > TRANSMITIENDO 3 > > TRANSMITIDA 4 > > INTERRUMPIDA 6 #### igaperfi * **Descripción** Este comando se utiliza para la gestión de los perfiles de editran/G en modo comando. Puede consultar información detallada sobre esta utilidad en el documento **Manual de Usuario Gestor de Perfiles.** #### modiperfi * **Descripción** El propósito del comando ***modiperfi*** es dotar al usuario de un mecanismo de administración no guiado por menús apto para administración desatendida. Con este comando el usuario puede modificar, simultáneamente, tantos parámetros como desee en múltiples sesiones **editran/P** o en distintas presentaciones **editran/G**, así como dar de baja los perfiles. Más información sobre el modo de empleo en **Manual de Usuario Gestor de Perfiles.** #### igacode * **Descripción** Este comando se utiliza para mostrar la descripción de un código de resultado de editran/G. * **Sintaxis** > Descripción de los codigos de resultado EDItranG. > > V51.0 R0 - Apr 19 2013 > > Copyright (C) 1991-2011 INDRA > > Uso : igacode \ > > Siendo : > > \ : codigo de resultado. ### Ficheros de datos #### Subcarpeta CFG * **editrang.cfg** Fichero de configuración de editran/G. Almacena los perfiles de las presentaciones. No es un fichero editable, sólo debe modificarse desde la interfaz de usuario. * **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. #### Subcarpeta BIN * **editrang.msg** Fichero donde están almacenados los mensajes que se presentan al operador de Editran/G. * **editrang.hlp** Fichero donde están almacenados los textos de ayuda del comando interactivo **menug**. **Subcarpeta SL** * **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. **Subcarpeta utils** * **U\_PREVIO, U\_POSTERIOR, U\_EXCEPCION** En esta carpeta se entregan scripts 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 solo contenga esos archivos. * **PSTEMIGC, PSTRECGC** Scripts 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 el intercambio de las claves RSA. #### Subcarpeta LOG * **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.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. > NOTA: Los ficheros con extensión "out" son texto sin formato y podrían cambiar de una versión a otra. Las aplicaciones no deben procesar ese fichero para extraer de ellos información ya que podrían dejar de funcionar con las actualizaciones del producto. A continuación, se listan algunos casos a modo de ejemplo. Información registrada de una emisión correcta \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* CONVERSION EN EMISION DE LA PRESENTACION \[TEST] FECHA-HORA: \[02/02/2023 10:27:49] VERSION: \[52] \# C F A T D L.Reg Fecha modificacion Tamaño Enviados Cargados Nombre \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ 1 N B N N 04020 05022019 124708 000000547005 000000547005 000000547005 /home/editran/tmp/ED41GestionClavesWindows.pdf 2 N B N N 04020 04062012 171736 000000000501 000000000501 000000000501 /home/editran/tmp/VerificaXades.log RESULTADO: \[0] \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* Salida de una emisión que falla por no existir ficheros pendientes, y configurada con el programa de excepción entregado en la instalación. \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* CONVERSION EN EMISION DE LA PRESENTACION \[TEST] FECHA-HORA: \[02/02/2023 10:25:40] VERSION: \[52] RESULTADO: CFG\_NO\_FILES \[90] \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* \################################################################################ SCRIPT DE USUARIO DE EXCEPCION: ./utils/U\_EXCEPCION. Thu 2 Feb 10:25:40 CET 2023 PRESENTACION : E-TEST (000000010-000000020-PRUEBA) RESULTADO : \[0090] EXIT CODE : 0 \################################################################################ **Salida Editran/G diferenciada por Presentación** Existe la posibilidad de tener la información anterior separada en ficheros por Presentación. Para ello bastará con que el usuario descomente las siguientes líneas del script *EDItran* para establecer como variable de entorno *EDI\_MLOG* antes de arrancar el servicio. ![assets/image38.png](https://261070666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2W4cn5C1WDTJzDOR25es%2Fuploads%2Fgit-blob-46ec98fe1c65b2f2a2f8991e6b096f8919ac78af%2Fimage38.png?alt=media) En este caso, los ficheros se dejan en el subdirectorio ***log*** de la instalación, y se nombran ***\.log***. A diferencia de lo que ocurre con el fichero *editrang.out,* estos ficheros pueden ser movidos o eliminados sin necesidad de detener Editran. Solo debe asegurarse de que esa Presentación no tenga transmisiones en curso. ### Códigos y mensajes al operador #### 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, según corresponda: | MENSAJE | EXPLICACIÓN/ACCIÓN RECOMENDADA | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Petición de carga de emisión | Se ha realizado una petición de carga depresentació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 la 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 cancelad | Se ha procesado correctamente la petición de inicialización de la emisión de la presentación. | | Petición de instalación de recepción | Se ha pedido cancelar la recepción en curso de la presentación. | | 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 está 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 (\) | 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) *\* | 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) *\* | 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 y se ha realizado correctamente. | | Error en el proceso de concersió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) *\* | 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) *\* | 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) *\* | 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) *\* | 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) *\* | 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) *\* | 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. | | Sesión editran interrumpida (A7I) *\* | 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 aditran (A4R) | Respuesta a editran/P del mensaje A4P. | | No hay tampón disponible (A1R-) *\* | 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 | Se ha lanzado el proceso de usuario indicado en perfiles. | | Proceso de usuario posterior finalizado | El proceso de usuario indicado en perfiles ha finalizado correctamente. | | Error en proceso de usuario posterior | El proceso de usuario indicado en perfiles ha finalizado con error. Consultar la causa en el fichero editrang.out. | | Lanza proceso de usuario de excepción | Se ha lanzado el proceso de usuario indicado en perfiles. | | Proceso de usuario de excepción finalizado | El proceso de usuario indicado en perfiles ha finalizado correctamente. | | Error en proceso de usuario de excepción | El proceso de usuario indicado en perfiles ha finalizado con error. Consultar la causa en el fichero editrang.out. | | No hay tampón disponible (A2R-) *\* | 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: *\* | 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 \[*\*] | Mensaje informativo al finalizar una EMISION o RECEPCION. | | Excepción: *\* | Se ha producido un error en runtime. | | | | #### 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 es el que se pasa como parámetro a los scripts de usuario y el valor devuelto por el API Editran/G. 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. | | 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. | | | | | #### Códigos de Excepción 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 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. | | 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 registros totales 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 estadom incorrecto. En estos casos, es aconsejable inicializar la Presentación. | | | | | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.editran.onesait.com/documentacion-editran/open-v5.2.1/linux/interfaz_generica.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.