Instalación
CICS
Si licencia Editran/CICS se recibe:
Licencia (si se contrata esta funcionalidad). Para instalarla debe pasar el JCL ZTBLJG02.
Ejecutables CICS: ZTBPOIF5.
Ejecutables Batch: ZTBXBXML, ZTBXBITS, ZTBGBGPG y ZTBLBLLI.
Procedimientos: ZTBGP1CX y ZTBGP4CX
JCL's: ZTBGJXML
IMS
Si licencia Editran/IMS se recibe.
Licencia (si se contrata esta funcionalidad). Para instalarla debe pasar el JCL ZTBLJG02.
Ejecutables Batch: ZTBXBXML, ZTBXBITS y ZTBGBGPG
Procedimientos: ZTBGP1X y ZTBGP4X
JCL's: ZTBGJXML
z/OS común (Fichero datos de usuario)
El usuario, debe crear un fichero (ó n), ZTBGFDAT, con ciertos parámetros para pasar al conversor (detallado en este documento).
z/OS común (JAVA)
Para la instalación, se realizarán las siguientes actuaciones:
Descarga de software.
Entrar en la página web https://www.onesait.com/editran y seleccionar Recursos. Ir a IBM z/OS y en el apartado Módulos Adicionales descargar el software Editran SEPA.
Inserción del paquete en los servicios UNIX del zos.
Enviar, en modo binario, al USS el paquete sepa-zos.V*.tar. Puede usar cualquier utilidad de transferencia de ficheros, como el ftp.
A modo de ejemplo se puede subir de la siguiente manera:
cmd
ftp
open IP destino (pedirá usuario tso y password)
cd /u/editranxsepa/SEPAv350 (directorio destino donde subiremos la aplicación).
binary (ftp en binario)
lcd c:\ (directorio origen donde se encuentra el .tar)
put EDITRANSepa.tar
quit (salir)
Vemos que queda en el directorio USS.
Instalación del paquete
Descomprimir el archivo sepa-zos.V*.tar en la carpeta de instalación creada para este fin. Se puede usar el comando tar -xof sepa-zos.V*.tar
Quedando la siguiente estructura de directorios a partir de ésta:
Configuración de los script
Los scripts de Editran/SEPA están situados en la carpeta scripts. Primero deberíamos comprobar que los ficheros checkLic.sh, start.sh y stop.sh tienen permisos de ejecución.
Se ejecuta el programa checkLic.sh desde el directorio donde está situado este fichero. Nos dice si tenemos fichero de licencia, si es correcto y si no tenemos fichero nos indica el hostId y el nombre del SO con el que debemos pedir una licencia al soporte del producto. Una vez que se reciba el fichero de licencia en ASCII hay que enviarla al USS en EBCDIC.
A continuación, se edita el fichero start.sh y starSeparador.sh y se da valor a las siguientes variables:
Posteriormente se edita el fichero stop.sh y stopSeparador.sh dando valor a las siguientes variables
PWD=/u/editranxsepa/SEPAv350 (ruta de instalación, donde se ha descomprimido)
Una vez hecho esto ya es posible arrancar la aplicación ejecutando el comando:
Para comprobar que el Servidor ha arrancado correctamente una vez ejecutado el comando editamos el archivo logs/out.log, y debería tener las siguientes trazas (en el puerto y la IP deberán aparecer las que hayamos configurado en el fichero):
Configuración del directorio conf:
Existen tres ficheros en el directorio conf que se detallan a continuación:
Configuracion.properties (Opcional para versiones inferiores a Java 11).
Define ciertos parámetros opcionales del programa Editran/SEPA. En z/OS este fichero no se usa porque son parámetros del JCL. Si se llama directamente al JAVA habría que informar al menos el lenguaje de la máquina.
Los distintos parámetros que se pueden configurar son:
param.lenguaje (Lenguaje de la máquina): Puede ser ‘A’ (ASCII) o ‘E’ (EBCDIC), por defecto debe estar desactivado y que el conversor Editran/SEPA lo calcule automáticamente.
param.alfabeto (Alfabeto): Define el conjunto de caracteres (charset) utilizado para la lectura o escritura del fichero plano durante el proceso de conversión. La versión mínima de Java soportada es Java 8. Los valores permitidos corresponden a los charset soportados por la plataforma Java según la versión de ejecución (por ejemplo, los definidos para Java 8 y Java 11 en la documentación oficial). Se puede consultar para java 11 en la siguiente web. En ausencia de configuración explícita, se utilizará el charset por defecto de la máquina donde se ejecute la aplicación. ⚠️Para Java 11 y superior es obligatorio especificar explícitamente el parámetro de encoding, no siendo recomendable depender del charset por defecto del sistema. Por ejemplo se puede indicar param.alfabeto=IBM-1047.
param.validar.xml (Validar XML): sirve para indicar si se desea validar el XML contra su esquema, siendo sus posibles valores S (Siempre se valida), P (se valida sólo en conversiones de XML a Plano), X (se valida sólo de Plano a XML) o N (Nunca se valida). El valor por defecto es S. Atención: desactivando esta validación, los ficheros obtenidos podrían contener errores.
param.info.libre (Información en el campo libre): En una conversión XML a Plano hay ciertos campos no convertibles y este campo sirve para incluir esta información en la zona libre del fichero plano. La información que escribe en la zona libre se explica en otra sección del manual. Su valor puede ser ‘S’ (Sí) o ‘N’ (No), por defecto no escribiendo en el campo libre.
param.mantener.salida (Mantener fichero de salida en caso de error): En una conversión incorrecta el fichero de salida no se crea ya que su valor es inválido. Este campo indica su queremos conservar el fichero de salida, aunque la conversión haya sido incorrecta, siendo sus posibles valores "S" para conservarlo y "N" para borrarlo. Por defecto se borra el fichero de salida.
param.resp.auto (Mensaje de respuesta automático): Este campo sirve para generar mensajes de respuesta cuando se reciben ciertas normas SEPA, aunque sólo se puede usar para conversiones XML a Plano de las normas 3414 y 19 de tipo Presentaciones, en las que se genera este fichero. El valor de este campo es el nombre del fichero de respuesta automático. Por defecto no se crea el fichero de respuesta.
param.quitar.validaciones (Quitar validaciones): Para usar este parámetro se debe tener licencia para ello, ya que es un campo desarrollado especialmente a petición. Sirve para ignorar validaciones obligatorias del XML que no están impuestas por el esquema XSD, sino por la norma SEPA España. El campo puede valer "S" para ignorar las validaciones obligatorias por SEPA España del XML y "N" para validar la norma SEPA España. Por defecto no las ignora.
param.juntar.xml (Juntar XML): este parámetro permite definir el comportamiento del conversor en transformaciones de ficheros de entrada de formato plano que incluyan más de un fichero lógico. Existen dos posibilidades:
a) siempre que sea posible (coinciden en todos, la fecha de creación, identificación ordenante/acreedor, etc.), unificar toda la información de cada lógico de entrada en un único fichero XML lógico y físico de salida. Para esta opción se configurará el valor S.
b) obtener un fichero de salida con tantos documentos XML lógicos como como ficheros lógicos de formato plano tiene el original. Para esta opción se indicará el valor N. El valor por defecto es S. Atención: para configurar el parámetro con el valor N es imprescindible disponer de la licencia correspondiente (véase el apartado de este manual).
param.cabecera (Cabecera de Transmisión): para las conversiones de XML a plano de la norma 34-14, este parámetro indica si se desea incluir una cabecera adicional al principio del fichero resultante. Los valores posibles del parámetro son T para escribir la cabecera de la Tesorería General de la Seguridad Social y N para no hacerlo, siendo éste el valor por defecto. Cuando este parámetro tiene el valor T, el conversor ignora el parámetro param.resp.auto para los ficheros XML 34-14.
Entidades.properties (Opcional).
El uso de este fichero es opcional y configura una fuente de datos extra necesaria para que la conversión del formato plano a XML sea completa y correcta. Cuando este fichero no esté definido, o los datos que se busquen no se encuentren, las etiquetas correspondientes de los formatos XML quedarán vacías o con el literal “NOTPROVIDED” según permite la norma en cada caso.
En concreto permite informar el BIC de la entidad del ordenante de la norma ISO de transferencias, así como el BIC de la entidad del acreedor de la norma ISO de adeudos. Pueden apuntarse en la lista tantas entidades como sean necesarias.
El fichero contendrá exclusivamente relaciones entre códigos BIC y la pareja de números “entidad + oficina” con los que se corresponden. Para entidades españolas el número “entidad + oficina” indicado se buscará en las posiciones desde la 4 a la 11, empezando a contar por 0, de las cuentas IBAN (comienzan por "ES") correspondientes a la figura de la que se desea informar del BIC (acreedor para adeudos y ordenante para transferencias) en los registros correspondientes del fichero en formato plano.
Ejemplo de localización: ES0001234567000000000000
Contenido inicial del fichero:
Se pueden sustituir las cuatro cifras de la oficina por la máscara ‘*’ para asociar todas las oficinas de una entidad a un mismo BIC.
Así mismo, el fichero se puede utilizar también con cuentas portuguesas.
log4j2.properties.
Es la información de las características del log. Por defecto el log está configurado de la forma en que para cada conversión de ficheros se generen dos informaciones de log situadas en la carpeta logs, uno en el log general de Editran/SEPA llamado out.log y otro particular propio para cada fichero con nombre igual a su fichero de entrada.
Este fichero es editable para poder ajustarse a lo que pueda pedir el cliente. Por ejemplo, en el caso de que queramos hacer las siguientes operaciones:
Desactivar algún log: Podemos desactivar el log EDISEPAFICHERO, anteponer # a todas las líneas del bloque 2.
Editar el log general: Podemos modificar desde el nombre del log (appender.rolling.name), su tamaño máximo (appender.rolling.policies.size.size) o el número de ficheros históricos que se guardan (appender.rolling.strategy.max)
Añadir algún log más: Si quiere realizar esta tarea debe seguir la configuración de logs de log4j bajo su criterio.
Contenido inicial del fichero:
Última actualización