> 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/windows/interfaz_generica.md).
# Gestión de Editran/G
## Gestión de Onesait 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.6** Administrador de Onesait Editran /G).
### 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 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.
* 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.
### Arranque y parada de Onesait 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:
### Operador de Onesait 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.
#### 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.
Este botón es el equivalente a la acción por medio de menús:
#### 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:
#### 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:
#### 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.
Está botón es equivalente a la acción desde menú:
#### 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.
Este botón es equivalente a la acción desde menú.
#### 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.
Pulsar este botón es equivalente a la acción por medio de menús:
#### 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:
#### 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**).
Pulsar este botón es equivalente a la acción por medio de menús:
### Operación de envíos utilizando Editran/FF integrado
#### Configuración de Editran/G para conectar con el servidor Editran/FF
Antes de realizar el envío de ficheros firmados se debe de configurar el entorno de Editran para comunicarse con el servidor de Editran/FF disponible. Para ello es necesario haber iniciado Editran/G como administrador.
Se puede acceder a los parámetros relativos a Editran/FF desde la opción Ayuda -> Acerca de Editran o directamente pulsando sobre el botón  de la barra de herramientas de Editran/G y pulsando en la opción Distribuido.
En la ventana que aparece se debe configurar el apartado Editran/FF con la dirección IP más el puerto de escucha de la maquina donde esté instalado el servidor de Editran/FF (el puerto por defecto es el 8300).
Si el servidor de FF se encuentra instalado en la misma maquina donde se instaló Editran, la dirección IP será 127.0.0.1:8300
También es necesario 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.
Para aplicar la configuración es necesario pulsar el botón Actualizar y luego el botón OK para cerrar el diálogo.
#### 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 ya una existente y marcar la opción *Enviar los archivos firmados en Editran/FF* de la pestaña *Ficheros.*
En el diálogo se habilitará el botón *Nueva Aplicación FF* y si la comunicación con el servidor de FF es correcta aparecerá la venta de selección de AplicacionesFF, similar al diálogo de selección de ficheros a emitir. Si la comunicación no ha sido posible aparecerá un mensaje de error notificando el problema.
En el desplegable de ficheros se podrá elegir entre todas las aplicaciones de Editran/FF que han sido configuradas para el envío con Editran.
Se podrán elegir tantas aplicaciones como se deseen enviar por la misma presentación de Editran/G.
Se debe pulsar el botón Guardar para aplicar la configuración de la presentación antes de emitir los ficheros.
### Consulta de ficheros
#### 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.
* **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 estadoindica 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**
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.
#### 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.
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.
#### 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 (***\***).
* *Fecha y hora*. Los mensajes se muestran desde la fecha y hora definida hasta la fecha actual de la consulta.
Una vez establecido el filtro, pulsar el botón "Selección OK" para aplicarlo.
### Administrador de Onesait Editran /G
Se accede al administrador de Editran/G seleccionando la opción Administrador desde el menú principal, presentándose la siguiente pantalla:
#### 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.
* **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.
* **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 de excepción recibirá en el parámetro resultado el valor que lo indica.
* **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:**
> 
* **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 V4.1 |
| **5.0** | Si la entidad remota es V5.0 |
| **5.1** | Si la entidad remota es V5.1 |
| **5.2** | Si la entidad remota es V5.2 |
| | |
* **Juego de caracteres:**
Solo si 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.
* 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 E*ditran/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/, 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.
* **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:
\ \
> 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 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.
* **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.
* 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** o **EBCDIC**. El valor **Ninguno** indica que el fichero se trate como binario.
* 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. 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 Windows 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.
* Delimitador
> Código de control que marca el salto de línea (registro). Se admite **DOS** (CRLF) o **UNIX** (LF).
* Enviar los ficheros firmados en Editran/FF
> Al marcar o desmarcar esta casilla se habilita el envío de archivos firmados mediante aplicaciones de Editran/FF. Para conocer más acerca de la funcionalidad de emitir archivos firmados con Editran/FF consultar el apartado Operación de envíos utilizando Editran/FF integrado
* **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.
* 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. Si el fichero recibido ya viene en el alfabeto especificado no se realiza ninguna transformación.
#### 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**
Se obtiene una relación de entidades remotas con su descripción.
* **Aplicación**
Se obtiene una relación de aplicaciones con su descripción.
### Funcionalidad adicional
#### Informe de ficheros transmitidos
La generación del informe diario de ficheros transmitidos es una funcionalidad opcional que se activa en los ajustes de configuración de la aplicación en el Registro de Windows.
Para ello, antes de iniciar el servicio EDITRAN, se debe crear un nuevo valor en la clave `HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\EDITRAN.`
El nombre del nuevo valor es **ReportPath**, es de tipo **REG\_SZ** y establece la **ruta** en la que se crearán los informes diarios.
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, se puede establecer el nivel de detalle de los datos mostrados en los informes mediante el valor de tipo DWORD **ReportLevel**.
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.
### 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 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).
>
> -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.
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 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.
#### 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 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]
\
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
#### 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\]
\[-r {\[-a \[-V\] \[-R\]] | \[-s\]} \[-o\]]
-h: ayuda (esta)
-f\: nombre del fichero con comandos de
modificacion de perfil. (defecto=stdin)
-r: volcado de presentaciones EDItran/G a fichero.
-s\: presentacion EDItran/G a volcar.
-a: volcado de todas las presentaciones a fichero.
-R\: Release del fichero a volcar.
Valores validos de \ 2..8
-V\: Version del fichero a volcar.
Valores validos de \ 22, 30, 31, 40 y 41
-o\: nombre del fichero en el cual se
volcara la sesion. (defecto=stdout)
#### 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\ \[-r\] \[-a\] \[-l\]
\[-s\|-p\] -m<-Exx=yy ...|-Ixx=yy ...>}
\| {-b -o\ -s\}
\
-h: Informacion de ayuda.
-o\: 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\: Identificador del remoto. Admite escribir unicamente las
cifras significativas.
-a\: Identificador de la aplicacion. Admite los
metacaracteres '\*' y '?' como comodines.
-l\: Identificador del local. Admite escribir unicamente las
cifras significativas.
-s\|-p\: 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.
#### 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** 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 ReportLevel para mostrarlo** |
| -------------------- | ---------------------------------------------- |
| Ruta del fichero | 0 |
| Formato | 1 |
| Longitud de registro | 1 |
| Número de registros | 1 |
| Fichero concatenado | 1 |
| | |
* **Ejemplo:** Programa batch que elimina los ficheros emitidos (con formato ReportLevel=0)
@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
* **Ejemplo:** Programa batch que elimina los ficheros emitidos (con formato ReportLevel=1)
@echo off
echo ###############################################
echo SCRIPT DE USUARIO POSTERIOR A EMISION: %0.
timestamp
echo PRESENTACION : %2-%1 (%3-%4-%5)
echo ###############################################
FOR /F "tokens=1 delims=," %%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:
* **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 cuando en el registro de Windows existe el valor DWORD ***GUpgrade*** en la clave *EDITRAN*.
### Ficheros de datos
#### 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.
* **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 DOC
* **editran.html**
Documentación de editran que contiene guías rápidas de configuración y consulta.
#### Subcarpeta BIN
* **editrang.msg**
Fichero donde están almacenados los mensajes que se presentan al operador de Editran/G.
**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 unos programas 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 solo contenga esos archivos.
* **PSTEMIGC, PSTRECGC**
Programas 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.
#### 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. 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. 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.
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
\################################################################################
\[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]
**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 **\.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.
### 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:
***
| 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 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 emisió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 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á iniciada | 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 incomptible 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 (AR1) *\* | Se notifica a editran/P que inicie la emisión deuna 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 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 (AR2)*\* | Se notifica a editran/P que inicie la recepción de una sesión de transmisión de la presentación. |
| Solicita fin de recpció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 editran (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. |
| 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 la descarga remota | 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 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. |
| 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. |
| | | |
**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. |
| 110 | Operador | Interrupción solicitada por el operador. |
| 120 | Tampón remoto incorrecto. Lanza previo. | La entidad remota no tiene su Fichero Tampón. Lanza 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 incorrectp. Nol 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 receptor. | 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 emisión. | La entidad que emite no recibe la confirmación de fin 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. |
| | | |
---
# 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/windows/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.