Onesait · Editran

Gestor de Perfiles
Manual de usuario
Windows/Linux

Junio 2022
 Índice

Índice
1 Introducción General .................................................................................................................................................. 6
1.1 Propósito ............................................................................................................................................................... 6
1.2 Audiencia ............................................................................................................................................................... 6
1.3 Definiciones ........................................................................................................................................................... 6
1.4 Documentos relacionados ..................................................................................................................................... 6
2 Alta Perfiles ................................................................................................................................................................. 7
2.1 Fichero de comandos ............................................................................................................................................ 7
2.2 Comandos para perfil local de Onesait · Editran ................................................................................................. 10
2.2.1 Operación ................................................................................................................................................... 10
2.2.2 Perfil ........................................................................................................................................................... 10
2.2.3 Código Local ............................................................................................................................................... 10
2.2.4 Nombre local .............................................................................................................................................. 10
2.2.5 Num Max sesiones ..................................................................................................................................... 11
2.2.6 Dirección IP Local ....................................................................................................................................... 11
2.2.7 TOUT Conexión TCP .................................................................................................................................... 11
2.3 Comandos para editran/P ................................................................................................................................... 11
2.3.1 Operación ................................................................................................................................................... 11
2.3.2 Perfil ........................................................................................................................................................... 11
2.3.3 Sesión ......................................................................................................................................................... 11
2.3.4 Código local ................................................................................................................................................ 11
2.3.5 Nombre local .............................................................................................................................................. 11
2.3.6 Código remoto ........................................................................................................................................... 11
2.3.7 Nombre remoto ......................................................................................................................................... 12
2.3.8 Aplic ............................................................................................................................................................ 12
2.3.9 Nombre aplic .............................................................................................................................................. 12
2.3.10 ID acceso .................................................................................................................................................... 12
2.3.11 NUM VERSION ............................................................................................................................................ 12
2.3.12 Extremo llamante ....................................................................................................................................... 12
2.3.13 Sentido trafico ............................................................................................................................................ 12
2.3.14 Llamada automática ................................................................................................................................... 12
2.3.15 Desconexión automática ............................................................................................................................ 12
2.3.16 Time out ..................................................................................................................................................... 13
2.3.17 Timeout sincronización .............................................................................................................................. 13
2.3.18 Reintentos .................................................................................................................................................. 13
2.3.19 Guardar rotaciones .................................................................................................................................... 13
2.3.20 CRC ............................................................................................................................................................. 13

Onesait Editran

2
 Índice

2.3.21 Servidor/cliente .......................................................................................................................................... 13

2.3.22 ASCII/EBCDIC .............................................................................................................................................. 13
2.3.23 Compresión ................................................................................................................................................ 13
2.3.24 Hora inicio .................................................................................................................................................. 13
2.3.25 Hora fin ....................................................................................................................................................... 14
2.3.26 Bloque emisión ........................................................................................................................................... 14
2.3.27 Longitud Tampon ....................................................................................................................................... 14
2.3.28 Procesos Emisión ........................................................................................................................................ 14
2.3.29 Procesos recepción .................................................................................................................................... 14
2.3.30 Criptografía ................................................................................................................................................ 14
2.3.31 Versión criptografía .................................................................................................................................... 14
2.3.32 Cambio clave .............................................................................................................................................. 14
2.3.33 Gestión claves ............................................................................................................................................ 14
2.3.34 Confidencialidad ......................................................................................................................................... 15
2.3.35 Autenticación ............................................................................................................................................. 15
2.3.36 LABEL CLAVE LOCAL ................................................................................................................................... 15
2.3.37 Label clave remota ..................................................................................................................................... 15
2.3.38 Dirección IP remota .................................................................................................................................... 15
2.3.39 Validar IP remota........................................................................................................................................ 15
2.3.40 Proxy Editran .............................................................................................................................................. 15
2.3.41 Dirección IP PROXY ..................................................................................................................................... 16
2.3.42 Usar pasarela SWIFT ................................................................................................................................... 16
2.4 Comandos para editran/G ................................................................................................................................... 16
2.4.1 Operación ................................................................................................................................................... 16
2.4.2 Perfil ........................................................................................................................................................... 16
2.4.3 Presentación............................................................................................................................................... 16
2.4.4 Tipo perfil ................................................................................................................................................... 16
2.4.5 Código local ................................................................................................................................................ 16
2.4.6 Nombre local .............................................................................................................................................. 16
2.4.7 Código remoto ........................................................................................................................................... 16
2.4.8 Descripción remoto .................................................................................................................................... 17
2.4.9 Ver iga remota ............................................................................................................................................ 17
2.4.10 Criptografía ................................................................................................................................................ 17
2.4.11 Versión criptografía .................................................................................................................................... 17
2.4.12 Confidencialidad ......................................................................................................................................... 17
2.4.13 AUTENTICACION ......................................................................................................................................... 17
2.4.14 Gestión claves ............................................................................................................................................ 17

Onesait Editran

3
 Índice

2.4.15 Label local ................................................................................................................................................... 17

2.4.16 Label remota .............................................................................................................................................. 17
2.4.17 ASCII/EBCDIC .............................................................................................................................................. 18
2.4.18 APLIC .......................................................................................................................................................... 18
2.4.19 Descripción aplic ........................................................................................................................................ 18
2.4.20 Tabla conversión emisión ........................................................................................................................... 18
2.4.21 Tabla conversión recepción........................................................................................................................ 18
2.4.22 PRV emisión................................................................................................................................................ 18
2.4.23 PRV recepción ............................................................................................................................................ 18
2.4.24 PST emisión ................................................................................................................................................ 18
2.4.25 PST recepción ............................................................................................................................................. 18
2.4.26 Excepción ................................................................................................................................................... 18
2.4.27 INC sesión presentación ............................................................................................................................. 19
2.4.28 Tipo de carga .............................................................................................................................................. 19
2.4.29 Num sesiones EDI ....................................................................................................................................... 19
2.4.30 APLIC EDI .................................................................................................................................................... 19
2.4.31 Criterio división .......................................................................................................................................... 19
2.4.32 DESTINO RECEPCION .................................................................................................................................. 19
2.4.33 Traducir en recepción ................................................................................................................................ 19
2.4.34 Delimitador en recepción ........................................................................................................................... 19
2.4.35 Comprobar firmas ...................................................................................................................................... 19
2.4.36 Confirmar descarga .................................................................................................................................... 20
2.4.37 Orden fichero ............................................................................................................................................. 20
2.4.38 Nombre fichero .......................................................................................................................................... 20
2.4.39 Formato ...................................................................................................................................................... 20
2.4.40 Longitud registro ........................................................................................................................................ 20
2.4.41 Delimitador ................................................................................................................................................ 20
2.4.42 Compresión ................................................................................................................................................ 20
2.4.43 Alfabeto ...................................................................................................................................................... 20
2.4.44 Traducir ...................................................................................................................................................... 20
2.5 Actualización de configuración ........................................................................................................................... 21
2.5.1 Ayuda ......................................................................................................................................................... 21
2.5.2 Procesado de un fichero de comandos ...................................................................................................... 24
2.6 Indicación directa de comandos .......................................................................................................................... 24
2.6.1 Volcado a fichero de sesiones. ................................................................................................................... 24
2.6.2 Trucos ......................................................................................................................................................... 25
2.7 Errores ................................................................................................................................................................. 26

Onesait Editran

4
 Índice

2.8 Perfiles de editran/P ............................................................................................................................................ 26

2.9 Perfiles de editran/G ........................................................................................................................................... 27
2.10 Migración de perfiles en proceso de instalación ............................................................................................ 27
2.11 Variable CFG_PERFIL ....................................................................................................................................... 28
3 MODIPERFI ................................................................................................................................................................ 29
3.1 Introducción. ....................................................................................................................................................... 29
3.2 Modo de empleo ................................................................................................................................................. 29
3.2.1 Modificación perfiles editran/P y editran/G .............................................................................................. 30
3.2.2 Baja de perfiles editran/P y editran/G ....................................................................................................... 30
3.2.3 Ejemplos de aplicación. .............................................................................................................................. 31
3.2.3.2 Baja de los perfiles de editran/p ......................................................................................................................................................................... 31
3.2.3.3 Modificación de los perfiles de editran/g ........................................................................................................................................................ 31
3.2.3.4 Baja de perfiles editran/g ...................................................................................................................................................................................... 32
3.2.3.5 Ejemplos de salida ..................................................................................................................................................................................................... 32

Onesait Editran

5
 1. Introducción General

1 Introducción General
1.1 Propósito
El propósito de los comandos cfgupt, ediperfi, igaperfi y modiperfi es dotar al usuario de editran/P y editran/G de un
mecanismo de administración no guiado por menús apto para administración desatendida. Con estos comandos el
usuario puede dar de alta, dar de baja y modificar presentaciones editran/G y sesiones editran/P.
El propósito del presente documento es guiar al usuario en el manejo de los comandos de actualización entregados con
el Software de editran.

1.2 Audiencia
El presente documento está destinado a los usuarios de los comandos cfgupt, ediperfi, igaperfi y modiperfi. También a
aquellas personas encargadas de administrar editran de modo desatendido.

1.3 Definiciones
 fichero de comandos: Un fichero que contiene comandos para efectuar operaciones de administración.
 comando: Una expresión de la forma "a = b" que indica una acción elemental a tomar. También denominado
parámetro.
 operación: Un conjunto de comandos que constituyen un alta, una baja o una modificación para editran.

1.4 Documentos relacionados

Los documentos que pueden complementar a este son:
 "editran/P Manual de Usuario". Contiene información relativa a la administración del sistema editran/P. Es útil para
comprender la semántica de las operaciones de administración efectuadas con el software al que pertenece el
presente manual.
 "editran/G Manual de Usuario". Contiene información relativa a la administración del sistema editran/G. Es útil
para comprender la semántica de las operaciones de administración efectuadas con el software al que pertenece
el presente manual.

Onesait Editran

6
 2. Alta Perfiles

2 Alta Perfiles
2.1 Fichero de comandos
Vamos a ver aquí el formato de un fichero de comandos. El fichero está formado por una secuencia de operaciones a
realizar:
-- Esto es un comentario...
Operación 1
%%=
Operación 2
-- Esto también...
%%=
...
Operación N
%%=
Donde %%= es el fin de operación. Es en este punto donde se ejecutarán los comandos que componen dicha operación.
Los comentarios son orientados a línea, es decir, se ignora el resto de ella a partir del signo de comentario. Un mismo
fichero puede contener simultáneamente operaciones relativas a editran/P y editran/G.
Una operación estará compuesta de una serie de comandos. Cada comando dará un valor a un campo de un perfil o
identificará el tipo de operación a realizar.
Para identificar el tipo de operación a realizar es necesario escribir los siguientes comandos.

Para una sesión editran/P:

OPERACION = op
PERFIL = perfil
SESION = sesión

Para una presentación editran/G:

OPERACION = op
PERFIL = perfil
TIPO PERFIL = tipo
PRESENTACION = presentación

Las palabras en cursiva deben sustituirse por valores adecuados. Es importante identificar la operación antes de indicar
en que consiste. Esto es, los comandos anteriores deben ponerse siempre y antes de ningún otro comando de la misma
operación. Por lo demás, el orden de comandos, salvo casos puntuales, es irrelevante y pueden ponerse como se desee.
Resumiendo, estas líneas deben aparecer antes de ninguna otra en cada operación a realizar.
Con los comandos anteriores hemos indicado que queremos efectuar una alta, baja o modificación mediante
OPERACION, que nos referimos a editran/P o editran/G mediante PERFIL y a qué presentación (en el caso de editran/G)
o sesión (en el caso de editran/P) nos referimos. El resto de los comandos hasta el fin de operación harán referencia
exclusivamente a dicha sesión o presentación.
Si op hubiese sido “B” estaríamos pidiendo una baja. En este caso no habría sido necesario indicar más comandos. Para
un alta o modificación podemos indicar tantos comandos como deseemos.
Si resulta que no hemos dado suficiente información, el comando correspondiente dará un mensaje de error.
La siguiente tabla indica cómo dar altas, bajas y modificar:

Operación Comando
Alta OPERACION = A

Onesait Editran

7
 2. Alta Perfiles

Baja OPERACION = B
Modificación OPERACION = M

Los valores posibles de PERFIL pueden ser LOC, si queremos actualizar el perfil local, EDI, si se trata de una sesión
editran/P, IGA si se trata de una presentación editran/G y FILE para los ficheros de emisión asociados a una presentación
editran/G. Los comandos desprecian espacios en blanco y líneas vacías en el fichero de entrada, pero sólo puede haber
un espacio en blanco entre palabras que identifiquen un campo de un perfil. Por ejemplo:
CODIGO LOCAL = 9991

Está mal porque hay tres espacios entre CODIGO y LOCAL. Debería haber un solo espacio en blanco.
A modo de ejemplo, mencionaremos las operaciones mínimas para efectuar altas, bajas y modificaciones.
Para realizar un alta en editran/P haremos:
OPERACION = A
PERFIL = EDI
SESION = EJEMPLO
CODIGO REMOTO = 1234
APLIC = PRUEB1
...
%%=
Para realizar un alta en editran/G haremos:
OPERACION = A
PERFIL = IGA
TIPO PERFIL = P
PRESENTACION = EJEMPLO
CODIGO REMOTO = 1234
APLIC = PRUEBA
...1

1- O sea, que las operaciones normales tendrán al menos los comandos indicados.

Onesait Editran

8
 2. Alta Perfiles

Para realizar un alta de un fichero de emisión de la presentación anterior en editran/G haremos:

OPERACION = A
PERFIL = FILE
PRESENTACION = EJEMPLO
NOMBRE FICHERO = pruebas.dat
...
%%=
Para realizar un alta del perfil local editran/P haremos:
OPERACION = A
PERFIL = LOC
CODIGO LOCAL = 1234
...
%%=
En el lugar de los puntos suspensivos se indican los valores de los distintos campos (que serán descritos posteriormente).
Conviene hacer notar que, en el caso de un alta, aquellos campos que no se especifiquen tomarán el valor por defecto,
en caso de que esto fuera posible.
Si el campo contiene información imprescindible para dar de alta la sesión como, por ejemplo, no haber especificado el
CODIGO REMOTO o la APLICACION, el programa se quejará de ello generando el mensaje de error adecuado a la
situación en particular.
Existen campos que no admiten valor por defecto pero que no contienen información fundamental para dar de alta la
sesión como, por ejemplo, NRI REMOTO. En dichos casos el campo quedará sin rellenar (y habrá que recurrir a una
operación de modificación de perfiles posterior, ya sea a través del menú o haciendo uso de nuevo del comando
apropiado).
Para realizar una baja en editran/P (la de editran/G es similar con la excepción que se especifica una presentación no
una sesión) haremos:
OPERACION = B
PERFIL = EDI
SESION = EJEMPLO
%%=
Para eliminar alguno de los ficheros de una presentación de editran/G haremos:
OPERACION = B
PERFIL = FILE
PRESENTACION = EJEMPLO
ORDEN FICHERO = 3
%%=
Normalmente no indicaremos nada más al efectuar una baja. Conviene advertir que no se puede dar de baja el perfil
local de editran/P.

Onesait Editran

9
 2. Alta Perfiles

Para realizar una modificación en editran/G haremos:

OPERACION = M
PERFIL = IGA
TIPO PERFIL = P
PRESENTACION = EJEMPLO
DESTINO RECEPCION = .\nuevodestino -- Esta es la modificación
%%=
Para realizar una modificación en el perfil local haremos:
OPERACION = M
PERFIL = LOC
-- Modificamos el código local
CODIGO LOCAL = 4321
NOMBRE LOCAL = PRUEBA MODIFICACION.
%%=
En una modificación, aquellos campos que no se especifiquen conservarán su valor.
A continuación, indicamos los distintos parámetros que pueden estar en un comando, así como los valores que pueden
tomar.
Antes de empezar con la enumeración, conviene apuntar un par de detalles. En primer lugar, hay que decir que los
nombres de cada uno de los parámetros coinciden casi siempre con los nombres asociados al mismo campo en los
menús de editran/P y editran/G. Sin embargo, en algunos casos, con intención de simplificar, se han abreviado algunas
palabras y eliminado otras que no resultaban imprescindibles para identificar el campo y que sólo conducían a tener
que escribir parámetros más largos, con la posibilidad de cometer algún error al teclear. Resulta recomendable, por
tanto, tener cerca este manual hasta familiarizarse con el nombre concreto de cada uno de los parámetros.
En segundo lugar, es necesario comentar que los parámetros no están descritos de forma exhaustiva; sólo se da una
breve descripción del campo y un ejemplo de uso. En caso de estar ya familiarizado con editran/P y editran/G, no tendrá
ningún problema para identificar a qué corresponde cada uno de los parámetros. Si no lo está, deberá consultar el
manual de usuario correspondiente.

2.2 Comandos para perfil local de Onesait · Editran

2.2.1 Operación
 Descripción: Tipo de operación a realizar.
 Valores: A (alta) o M (modificación).
 Ejemplo: OPERACION = A

2.2.2 Perfil
 Descripción: Identifica que la operación se realizará sobre el perfil local de editran/P.
 Valores: LOC (LOCAL).
 Ejemplo: PERFIL = LOC

2.2.3 Código Local

 Descripción: Es el código de identificación del centro local.
 Valores: Un número de 9 cifras como máximo. En caso de especificar menos cifras se formateará
convenientemente.
 Ejemplo: CODIGO LOCAL = 9991

2.2.4 Nombre local

 Descripción: Nombre descriptivo de la entidad local.
 Valores: Cadena alfanumérica.

Onesait Editran

10
 2. Alta Perfiles

 Ejemplo: NOMBRE LOCAL = PC 23

2.2.5 Num Max sesiones

 Descripción: Es el número de conexiones que pueden estar operativas simultáneamente.
 Valores: Un número entre 1 y 100.
 Ejemplo: NUM MAX SESIONES = 10

2.2.6 Dirección IP Local

 Descripción: Dirección IP del centro local. Este parámetro puede repetirse hasta tres veces.
 Valores: Dirección IP o nombre de la máquina en un dominio.
 Ejemplo: DIRECCION IP LOCAL = 140.30.5.3:7778

2.2.7 TOUT Conexión TCP

 Descripción: Intervalo de tiempo, expresado en segundos, en el que editran espera recibir los datos de sesión desde
que se acepta la conexión de un socket remoto.
 Valores: Un número entre 1 y 999.
 Ejemplo: MODO CONEXION = 015

2.3 Comandos para editran/P

2.3.1 Operación
 Descripción: Tipo de operación a realizar.
 Valores: A (alta), B (baja) o M (modificación).
 Ejemplo: OPERACION = A

2.3.2 Perfil
 Descripción: Identifica que la operación se realizará sobre una sesión editran/P.
 Valores: EDI (editran/P).
 Ejemplo: PERFIL = EDI

2.3.3 Sesión
 Descripción: Nemónico que identifica de forma sencilla una sesión editran/P, es decir, identifica el conjunto
formado por un código local, un código remoto y una aplicación.
 Valores: Cadena alfanumérica.
 Ejemplo: SESION = EJEMPLO

2.3.4 Código local

 Descripción: Código que identificará al local para la sesión que está siendo definida.
 Valores: Un número de 9 cifras como máximo. Si se especifican menos cifras el campo será debidamente
formateado.
 Ejemplo: CODIGO LOCAL = 7778

2.3.5 Nombre local

 Descripción: Nombre descriptivo de la entidad local en la sesión que está siendo definida.
 Valores: Cadena alfanumérica.
 Ejemplo: NOMBRE LOCAL = MI PC

2.3.6 Código remoto

 Descripción: Es el código de identificación del centro remoto.

Onesait Editran

11
 2. Alta Perfiles

 Valores: Un número de 9 cifras como máximo. En caso de especificar menos cifras se formateará
convenientemente.
 Ejemplo: CODIGO REMOTO = 9991

2.3.7 Nombre remoto

 Descripción: Nombre descriptivo de la entidad remota.
 Valores: Cadena alfanumérica.
 Ejemplo: NOMBRE REMOTO = CICS1

2.3.8 Aplic
 Descripción: Es el código que identifica la aplicación.
 Valores: Cadena alfanumérica de exactamente de 6 caracteres.
 Ejemplo: APLIC = PRUEBA

2.3.9 Nombre aplic

 Descripción: Nombre descriptivo de la aplicación editran/P.
 Valores: Cadena alfanumérica.
 Ejemplo: NOMBRE APLIC = PRUEBA

2.3.10 ID acceso
 Descripción: Identificador que complementa la tupla ORIGEN-DESTINO-APLICACION, conteniendo una clave
utilizada durante la conexión representando al DESTINO de la petición entrante. Numérico de 0-9. Debe coincidir
en los dos extremos de la sesión.
 Valores: 0 a 9.
 Ejemplo: ID ACCESO = 0

2.3.11 NUM VERSION

 Descripción: Versión del editran/P remoto.
 Valores: Una versión (4.1, 5.0, etc.).
 Ejemplo: NUM VERSION = 4.1

2.3.12 Extremo llamante

 Descripción: Quién puede iniciar llamadas.
 Valores: L (sólo yo), R (el remoto) y X (cualquiera). En conexiones vía PAD sólo se permite la llamada desde el
extremo local, ya que no hay un mecanismo inverso de direccionamiento del PAD hacia el módem.
 Ejemplo: EXTREMO LLAMANTE = X

2.3.13 Sentido trafico

 Descripción: Qué sentido tiene el tráfico.
 Valores: E (sólo de emisión), R (recepción) y X (ambos).
 Ejemplo: SENTIDO TRAFICO = X

2.3.14 Llamada automática

 Descripción: Se generan peticiones de conexión automáticas al solicitarse el comienzo de la emisión o recepción.
 Valores: S o N.
 Ejemplo: LLAMADA AUTOMATICA = S

2.3.15 Desconexión automática

 Descripción: Se generan liberaciones de conexión automática al finalizar la emisión o recepción.
 Valores: S o N.

Onesait Editran

12
 2. Alta Perfiles

 Ejemplo: DESCONEXION AUTOMATICA = S

2.3.16 Time out

 Descripción: Intervalo de tiempo, expresado en segundos, con el que editran/P espera recibir desde el remoto un
mensaje de respuesta a uno de control previamente enviado.
 Valores: Un número de 3 cifras como máximo.
 Ejemplo: TIME OUT = 30

2.3.17 Timeout sincronización

 Descripción: Intervalo de tiempo, expresado en segundos, en el que editran/P espera recibir desde el remoto el
mensaje de respuesta al de sincronización del envío de datos.
 Valores: Un número de 3 cifras como máximo.
 Ejemplo: TIME OUT = 30

2.3.18 Reintentos
 Descripción: número máximo de reintentos en retransmisión.
 Valores: Un número.
 Ejemplo: REINTENTOS = 3

2.3.19 Guardar rotaciones

 Descripción: Se desea guardar las direcciones remotas según el orden de conexión.
 Valores: S, N.
 Ejemplo: GUARDAR ROTACIONES = N

2.3.20 CRC
 Descripción: Se emplean códigos de redundancia cíclicos en cada mensaje transmitido.
 Valores: S o N.
 Ejemplo: CRC = S

2.3.21 Servidor/cliente
 Descripción: Modo de operación.
 Valores: S (servidor) o C (cliente, normalmente).
 Ejemplo: SERVIDOR/CLIENTE = C

2.3.22 ASCII/EBCDIC
 Descripción: Alfabeto utilizado en el remoto.
 Valores: A (ascii) o E (ebcdic).
 Ejemplo: ASCII/EBCDIC = E

2.3.23 Compresión
 Descripción: Transmisión comprimida de datos.
 Valores: S, N, L o V.
 Ejemplo: COMPRESION = N

2.3.24 Hora inicio

 Descripción: Hora mínima de la ventana en que se permiten transmisiones.
 Valores: Una hora expresada como HH:MM:SS o HHMMSS.
 Ejemplo: HORA INICIO = 00:00:00

Onesait Editran

13
 2. Alta Perfiles

2.3.25 Hora fin

 Descripción: Hora máxima de la ventana en que se permiten transmisiones.
 Valores: Una hora expresada como HH:MM:SS o HHMMSS.
 Ejemplo:
 HORA FIN = 23:59:59

2.3.26 Bloque emisión

 Descripción: Tamaño de la ráfaga de transmisión.
 Valores: Un número de tres cifras como máximo.
 Ejemplo: BLOQUE EMISION = 10

2.3.27 Longitud Tampon

 Descripción: Longitud de los registros de los ficheros tampones.
 Valores: Valores entre 252 y 4050.
 Ejemplo: LONGITUD TAMPON = 4050

2.3.28 Procesos Emisión

 Descripción: Identifica al proceso encargado de las fases previa y posterior a una emisión.
 Valores: editran/G o editran/SW.
 Ejemplo: PROCESOS EMISION = editran/G

2.3.29 Procesos recepción

 Descripción: Identifica al proceso encargado de las fases previa y posterior a una recepción.
 Valores: editran/G o editran/SW.
 Ejemplo: PROCESOS RECEPCION = editran/G

2.3.30 Criptografía
 Descripción: Cifrado de datos durante la transmisión.
 Valores: S, N.
 Ejemplo: CRIPTOGRAFIA = S

2.3.31 Versión criptografía

 Descripción: Versión de los procesos criptográficos usados.
 Valores: 2.2, 3.0 y 4.0.
 Ejemplo:
 VERSION CRIPTOGRAFIA = 2.2

2.3.32 Cambio clave

 Descripción: Indica si se cambia de clave en cada emisión (suponiendo que usamos criptografía 2.2).
 Valores: S o N.
 Ejemplo: CAMBIO CLAVE = N

2.3.33 Gestión claves

 Descripción: Se utiliza el módulo editran/GC para acceder a las claves auxiliares. Sólo disponible en versión de
criptografía superior a 3.0.
 Valores: S o N.
 Ejemplo: GESTION CLAVES = N

Onesait Editran

14
 2. Alta Perfiles

2.3.34 Confidencialidad
 Descripción: Algoritmo usado para el cifrado de datos.
 Valores: DES, TD2, TD3, AES, AE2 y AE3.
 Ejemplo: CONFIDENCIALIDAD = TD3

2.3.35 Autenticación
 Descripción: Algoritmo usado en la autenticación de las claves de sesión.
 Valores: DES o RSA.
 Ejemplo: AUTENTICACION = RSA

2.3.36 LABEL CLAVE LOCAL

 Descripción: Etiqueta asociada a una clave almacenada en el fichero CKDS o un subsistema propio en editran/GC.
 Valores: Cadena alfanumérica de hasta 14 caracteres.
 Ejemplo: LABEL CLAVE LOCAL = LABELRSAPC0020

2.3.37 Label clave remota

 Descripción: Etiqueta asociada a una clave almacenada en el fichero CKDS o un subsistema remoto en editran/GC.
 Valores: Cadena alfanumérica de hasta 14 caracteres.
 Ejemplo: LABEL CLAVE REMOTA = LABELRSACICS01

2.3.38 Dirección IP remota

 Descripción: Dirección IP de la entidad remota. Este parámetro puede repetirse hasta seis veces.
 Valores: Una dirección IP.
 Ejemplo: DIRECCION IP REMOTA = 123.30.10.5:7778

2.3.39 Validar IP remota

 Descripción: Se desea comprobar que las IPs de las conexiones TCP entrantes coinciden con las del perfil.
 Valores: S, N.
 Ejemplo: VALIDAR IP REMOTA = N

2.3.40 Proxy Editran

 Descripción: Se usará el módulo editran/PX como proxy en la transmisión por TCP.
 Valores: S, N.
 Ejemplo: Proxy editran = N

Onesait Editran

15
 2. Alta Perfiles

2.3.41 Dirección IP PROXY

 Descripción: Dirección IP del Proxy editran. Este parámetro puede repetirse hasta dos veces.
 Valores: Una dirección IP.
 Ejemplo: DIRECCION IP PROXY = 123.30.10.5:7778

2.3.42 Usar pasarela SWIFT

 Descripción: La sesión transmite a un editran que está funcionando como pasarela de acceso a la red SWIFT.
 Valores: S o N.
 Ejemplo: USAR PASARELA SWIFT = N

2.4 Comandos para editran/G

2.4.1 Operación
 Descripción: Tipo de operación a realizar.
 Valores: A (alta), B (baja) o M (modificación).
 Ejemplo: OPERACION = A

2.4.2 Perfil
 Descripción: Identifica si la operación se realizará sobre una Presentación o un Fichero de editran/G.
 Valores: IGA (Presentación), FILE(Fichero).
 Ejemplo: PERFIL = IGA

2.4.3 Presentación
 Descripción: Nemónico que identifica de forma sencilla una presentación editran/G, es decir, identifica el conjunto
formado por un código local, un código remoto y una aplicación.
 Valores: Cadena alfanumérica.
 Ejemplo: PRESENTACION = EJEMPLO
Los parámetros correspondientes a PERFIL = IGA son:

2.4.4 Tipo perfil

 Descripción: Identifica si la operación se realizará sobre un Remoto, una Aplicación o una Presentación.
 Valores: R (Remoto), A (Aplicación) o P(Presentación).
 Ejemplo: TIPO PERFIL = P

2.4.5 Código local

 Descripción: Código que identificará al local para la presentación que está siendo definida.
 Valores: Un número de 9 cifras como máximo. Si se especifican menos cifras el campo será debidamente
formateado.
 Ejemplo: CODIGO LOCAL = 7778

2.4.6 Nombre local

 Descripción: Nombre descriptivo de la entidad local en la presentación que está siendo definida.
 Valores: Cadena alfanumérica.
 Ejemplo: NOMBRE LOCAL = MI PC

2.4.7 Código remoto

 Descripción: Es el código de identificación del centro remoto.
 Valores: Un número de 9 cifras como máximo. En caso de especificar menos cifras se formateará adecuadamente.

Onesait Editran

16
 2. Alta Perfiles

 Ejemplo: CODIGO REMOTO = 9991

2.4.8 Descripción remoto

 Descripción: Nombre descriptivo de la entidad remota.
 Valores: Cadena alfanumérica.
 Ejemplo: DESCRIPCION REMOTO = CICS1

2.4.9 Ver iga remota

 Descripción: Es la versión de editran/G remoto.
 Valores: Una versión válida de editran/G.
 Ejemplo: VER IGA REMOTA = 5.1

2.4.10 Criptografía
 Descripción: Uso de criptografía
 Valores: S o N.
 Ejemplo: CRIPTOGRAFÍA = S

2.4.11 Versión criptografía

 Descripción: Indica el tipo de proceso criptográfico que se aplica a los ficheros.
 Valores: 2.2, 3.0 o 4.0
 Ejemplo: VERSION CRIPTOGRAFIA = 3.0

2.4.12 Confidencialidad
 Descripción: Algoritmo usado en el cifrado de la información.
 Valores: DES, TD2, TD3, AES, AE2 o AE3.
 Ejemplo: CONFIDENCIALIDAD = AES

2.4.13 AUTENTICACION
 Descripción: Algoritmo para autentificar la entidad emisora.
 Valores: DES, RSA.
 Ejemplo: AUTENTICACION = RSA

2.4.14 Gestión claves

 Descripción: Se utiliza el módulo editran/GC para acceder a las claves auxiliares. Sólo disponible con versión de
criptografía superior a 3.0.
 Valores: S o N.
 Ejemplo: GESTION CLAVES = N

2.4.15 Label local

 Descripción: Etiqueta asociada a una clave almacenada en el fichero CKDS o un subsistema propio en editran/GC.
 Valores: Cadena alfanumérica de longitud 14 (etiqueta) ó 1 (subsistema).
 Ejemplo: LABEL CLAVE LOCAL = LABELRSAPC0020

2.4.16 Label remota

 Descripción: Etiqueta asociada a una clave almacenada en el fichero CKDS o un subsistema remoto en editran/GC.
 Valores: Cadena alfanumérica de longitud 14 (etiqueta) ó 1 (subsistema).
 Ejemplo: LABEL CLAVE REMOTA = LABELRSACICS01

Onesait Editran

17
 2. Alta Perfiles

2.4.17 ASCII/EBCDIC
 Descripción: Alfabeto utilizado en el remoto. Debería corresponder con el indicado en la sesión editran/P asociada.
Sólo se usa con remotos de versión inferior a 5.0.
 Valores: A (ascii) o E (ebcdic).
 Ejemplo: ASCII/EBCDIC = E

2.4.18 APLIC
 Descripción: Es el código de la aplicación.
 Valores: Cadena alfanumérica de exactamente 6 caracteres.
 Ejemplo: APLIC = PRUEBA

2.4.19 Descripción aplic

 Descripción: Descripción de la aplicación de presentación editran/G.
 Valores: Cadena alfanumérica.
 Ejemplo: DESCRIPCION APLIC = Una prueba

2.4.20 Tabla conversión emisión

 Descripción: Nombre del fichero con los valores de los caracteres que se van a modificar antes de la emisión.
 Valores: Cadena alfanumérica de longitud máxima 15.
 Ejemplo: TABLA CONVERSION EMISION = tablaemi

2.4.21 Tabla conversión recepción

 Descripción: Nombre del fichero con los valores de los caracteres que se van a modificar tras la recepción.
 Valores: Cadena alfanumérica de longitud máxima 15.
 Ejemplo: TABLA CONVERSION RECEPCION = tablarec

2.4.22 PRV emisión

 Descripción: Nombre del automatismo de usuario previo a la emisión.
 Valores: Un nombre de un ejecutable.
 Ejemplo: PRV EMISION = U_PRVEMI

2.4.23 PRV recepción

 Descripción: Nombre del automatismo de usuario previo a la recepción.
 Valores: Un nombre de un ejecutable.
 Ejemplo: PRV RECEPCION = U_PRVREC

2.4.24 PST emisión

 Descripción: Nombre del automatismo de usuario posterior a la emisión.
 Valores: Un nombre de un ejecutable.
 Ejemplo: PST EMISION = U_PSTEMI

2.4.25 PST recepción

 Descripción: Nombre del automatismo de usuario posterior a la recepción.
 Valores: Un nombre de un ejecutable.
 Ejemplo: PST RECEPCION = U_PSTREC

2.4.26 Excepción
 Descripción: Nombre del automatismo de usuario en caso de excepción.
 Valores: Un nombre de un ejecutable.

Onesait Editran

18
 2. Alta Perfiles

 Ejemplo: EXCEPCION = U_EXCEPT

2.4.27 INC sesión presentación

 Descripción: Indica si se desea incrementar el identificador de sesión de presentación.
 Valores: S o N.
 Ejemplo: INC SESION PRESENTACION = S

2.4.28 Tipo de carga

 Descripción: El tipo de carga puede ser Normal o Acumulativa.
 Valores: N o A.
 Ejemplo: TIPO DE CARGA = N

2.4.29 Num sesiones EDI

 Descripción: Número de sesiones editran/P para una presentación.
 Valores: Un número entre 1 y 20.
 Ejemplo: NUM SESIONES EDI = 3

2.4.30 APLIC EDI

 Descripción: Aplicación editran/P a utilizar para esta presentación. Se repetirá este campo tantas veces como
sesiones editran/P deseemos especificar hasta un máximo de 20.
 Valores: Un nombre de una aplicación editran/P.
 Ejemplo: APLIC EDI = PRUEBA

2.4.31 Criterio división

 Descripción: Reparto de carga entre sesiones editran/P si se van a utilizar varias.
 Valores: V (volumen),F (fichero), N (ninguno).
 Ejemplo: CRITERIO DIVISION = F

2.4.32 DESTINO RECEPCION

 Descripción: El nombre del directorio o fichero donde situar el/los fichero/s recibido/s.
 Valores: Un nombre de directorio o fichero.
 Ejemplo: DESTINO RECEPCION = .\destino

2.4.33 Traducir en recepción

 Descripción: Selector de traducción entre Juegos de Caracteres en la descarga de ficheros.
 Valores: E (se traducen a EBCDIC los que lleguen en ASCCII). A (se traducen a ASCCII los que llegan en EBCDIC). N
(no se traduce).
 Ejemplo: TRADUCIR EN RECEPCION = N

2.4.34 Delimitador en recepción

 Descripción: Delimitador a utilizar en la descarga de ficheros Fijos.
 Valores: N(Ninguno), D(DOS) y U(UNIX).
 Ejemplo: DELIMITADOR EN RECEPCION = D

2.4.35 Comprobar firmas

 Descripción: Si se tiene contratada la funcionalidad editran/FF, verificar que los ficheros a emitir no han sido
modificados y se ha autorizado su envío.
 Valores: S o N.
 Ejemplo: COMPROBAR FIRMAS = N

Onesait Editran

19
 2. Alta Perfiles

2.4.36 Confirmar descarga

 Descripción: Con esta opción los envíos realizados no se dan por finalizados hasta recibir del remoto la notificación
con el resultado de su descarga.
 Valores: S o N.
 Ejemplo: CONFIRMAR DESCARGA = N
Los parámetros correspondientes a PERFIL = FILE son:

2.4.37 Orden fichero

 Descripción: Las presentaciones editran/G llevan asociadas una lista de ficheros para emisión. Este parámetro
identifica el fichero sobre el que realizamos la operación en función de su orden en la lista. Sólo se tiene en cuenta
cuando la operación es borrar o modificar.
 Valores: Numérico.
 Ejemplo: ORDEN FICHERO = 5

2.4.38 Nombre fichero

 Descripción: Conjunto de ficheros con las mismas características que se toman como origen de la transferencia.
 Valores: Un nombre de fichero. Admite el uso de metacaracteres.
 Ejemplo: NOMBRE FICHERO = .\origen\*.txt

2.4.39 Formato
 Descripción: Describe la forma en la que se organizará la información a transmitir.
 Valores: F (Fijo), V (Variable), H (Híbrido) y B (Binario).
 Ejemplo: FORMATO = F

2.4.40 Longitud registro

 Descripción: Longitud de los registros de los ficheros de aplicación.
 Valores: Número de cinco cifras como máximo.
 Ejemplo: LONGITUD REGISTRO = 80

2.4.41 Delimitador
 Descripción: Delimitador utilizado en la carga de ficheros con formato Fijo.
 Valores: N (Ninguno), D (Dos) y U (UNIX).
 Ejemplo: DELIMITADOR = N

2.4.42 Compresión
 Descripción: Uso de compresión de ficheros.
 Valores: F (se hace uso de la compresión) o N.
 Ejemplo: COMPRESION = F

2.4.43 Alfabeto
 Descripción: Selector del Juego de Caracteres de los ficheros a emitir.
 Valores: E (EBCDIC), A (ASCII) o N (Ninguno).
 Ejemplo: ALFABETO = A

2.4.44 Traducir
 Descripción: Selector de traducción entre Juegos de Caracteres.
 Valores: S (se traduce a EBCDIC si ALFABETO es A o a ASCII si ALFABETO es E). N (no se traduce).
 Ejemplo: TRADUCIR = N

Onesait Editran

20
 2. Alta Perfiles

2.5 Actualización de configuración

El comando cfgupt es el encargado de realizar este trabajo. Es el encargado de interpretar ficheros de comandos y
opciones en la línea de argumentos. Además, permite volcar sesiones editran/P y editran/G a un fichero de texto con
la sintaxis de comandos anteriormente descrita.
Normalmente se le invocará para:
 obtener ayuda
 ejecutar un fichero de comandos
 ejecutar comandos que le damos como argumentos
 volcar sesiones a fichero de texto.

2.5.1 Ayuda
En su primera faceta, cuando lo invocamos como cfgupt -h nos informa de su uso y cuando lo invocamos como cfgupt
-H nos informa además de los posibles parámetros que podemos modificar en perfiles 2:
> cfgupt -h
uso : cfgupt [-h|-H]
[-r {[-a[ei]] | [-l] |
[-e<sesion> ...][-i<presentacion> ...]}[-ofichout]] |
[-icmd][-ecmd][-Exx=yy ...][-Ixx=yy ...] |
[-ffichin]]
-h: ayuda.
-H: ayuda (lista completa de comandos -E y -I).
-r: volcado de sesiones a fichero de texto.
-ae: volcado de todas las sesiones y del perfil local editran/P.
-ai: volcado de todas las presentaciones editran/G.
-l: volcado del perfil local editran/P.
-e<sesion>: volcado de sesiones editran/P
-i<presentacion>: volcado de presentaciones editran/G.
-ofichout: volcar sesiones al fichero fichout.
-ecmd: usar 'cmd' como intérprete de opciones -E.
-icmd: usar 'cmd' como intérprete de opciones -I.
-ffichin: leer comandos desde fichero fichin.
-Exx=yy: poner parámetro perfil editran/P 'xx' a 'yy'.
-Ixx=yy: poner parámetro perfil editran/G 'xx' a 'yy'.
Para ver cómo utilizar -E y -I y códigos de retorno use la opcion -H.
O bien
> cfgupt -H
uso : cfgupt [-h|-H]
[-r {[-a[ei]] | [-l] |
[-e<sesión> ...][-i<presentacion> ...]}[-ofichout]] |
[-icmd][-ecmd][-Exx=yy ...][-Ixx=yy ...] |
[-ffichin]]
-h: ayuda.
-H: ayuda (lista completa de comandos -E y -I).
-r: volcado de sesiones a fichero de texto.
-ae: volcado de todas las sesiones y del perfil local editran/P.
-ai: volcado de todas las presentaciones editran/G.
-l: volcado del perfil local editran/P.
-e<sesión>: volcado de sesiones editran/P.
-i<presentación>: volcado de presentaciones editran/G.

2 En lo que sigue, > será el 'prompt' del sistema.

Onesait Editran

21
 2. Alta Perfiles

-ofichout: volcar sesiones al fichero fichout.

-ecmd: usar 'cmd' como intérprete de opciones -E.
-icmd: usar 'cmd' como intérprete de opciones -I.
-ffichin: leer comandos desde fichero fichin.
-Exx=yy: poner parámetro perfil editran/P 'xx' a 'yy'.
-Ixx=yy: poner parámetro perfil editran/G 'xx' a 'yy'.
Para ver cómo utilizar -E y -I y códigos de retorno use la opción -H.

Las opciones -E<campo>=<valor> ponen 'campo' a 'valor' en el perfil de editran/P (-E) o de editran/G (-I) pueden
mezclarse. Ha de indicarse op=A o B o M según sea alta, baja o modificación. También ha de indicarse perfil=EDI o
perfil=IGA según se vaya a modificar un perfil editran/P o editran/G.
Pueden indicarse diversas operaciones. Una operación deberá ser de la forma:
-Eop=X -Eperfil=X -Exx=yy ...

El comienzo de otra operación o el fin de argumentos indica el fin de la operación en curso.

No pueden mezclarse -E y -I con -f.
Los valores que puede tomar xx en -Exx=yy son:
alfabeto ASCII/EBCDIC
aplic APLIC
autentic AUTENTICACION
auto LLAMADA AUTOMATICA
autodisc DESCONEXION AUTOMATICA
cclave CAMBIO CLAVE
cifrado CRIPTOGRAFIA
codloc CODIGO LOCAL
codrem CODIGO REMOTO
compr COMPRESION
conex TIPO CONEXION
confidencial  CONFIDENCIALIDAD
crc CRC
gclaves GESTION CLAVES
idacceso ID ACCESO
iploc DIRECCION IP LOCAL
ipproxy DIRECCION IP PROXY
iprem DIRECCION IP REMOTA
labelloc LABEL CLAVE LOCAL
labelrem LABEL CLAVE REMOTA
llamante EXTREMO LLAMANTE
nomaplic NOMBRE APLIC
nomloc NOMBRE LOCAL
nomrem NOMBRE REMOTO
op OPERACION
perfil PERFIL
prcemi PROCESOS EMISION
prcrec PROCESOS RECEPCION
proxy PROXY EDITRAN
rafaga BLOQUE EMISION
reint REINTENTOS
rotac GUARDAR ROTACIONES
senttraf SENTIDO TRAFICO
servcli SERVIDOR/CLIENTE
sesion SESION
sicrap SINCRONISMO APLIC
swiftp USAR PASARELA SWIFT
tampon LONGITUD TAMPON
tfin HORA FIN
timeout TIME OUT

Onesait Editran

22
 2. Alta Perfiles

tinicio HORA INICIO

toutdesc TOUT DESCONEXION
toutsinc TIMEOUT SINCRONIZACION
valip VALIDAR IP REMOTA
verscifrado  VERSION CRIPTOGRAFIA
versrem NUM VERSION

Los valores que puede tomar xx en -Ixx=yy son:

ackcarga  CONFIRMAR DESCARGAS

alfabeto  ASCII/EBCDIC
alffich  ALFABETO
aplcedi  APLIC EDI
aplic  APLIC
autentica  AUTENTICACION
carga TIPO DE CARGA
cifrado  CRIPTOGRAFIA
clavelocal  LABEL LOCAL
claveremota  LABEL REMOTA
codloc CODIGO LOCAL
codrem CODIGO REMOTO
compres  COMPRESION
confidenc  CONFIDENCIALIDAD
delimemi  DELIMITADOR
delimrec  DELIMITADOR EN RECEPCION
div CRITERIO DIVISION
dstrec DESTINO RECEPCION
ediff  COMPROBAR FIRMAS
formato  FORMATO
gclaves  GESTION CLAVES
incses INC SESION PRES
longreg  LONGITUD REGISTRO
nomaplic  DESCRIPCION APLIC
nomfich  NOMBRE FICHERO
nomloc NOMBRE LOCAL
nomrem DESCRIPCION REMOTO
numses NUM SESIONES EDI
op OPERACION
orden ORDEN FICHERO
perfil  PERFIL
present  PRESENTACION
prvemi PRV EMISION
prvrec PRV RECEPCION
pstemi PST EMISION
pstrec PST RECEPCION
tablaemi  TABLA CONVERSION EMISION
tablarec  TABLA CONVERSION RECEPCION
tipo TIPO PERFIL
traduc TRADUCIR
traducrec  TRADUCIR EN RECEPCION
usrexc EXCEPCION
verscifrado  VERSION CRIPTOGRAFIA
versigarem  VER IGA REMOTA

Los valores de retorno (al sistema) son:

Todo bien: 0
Error en argumentos: 1
Error de funcionamiento: 2
Error en ediperfi: 4
Error en igaperfi: 5

Onesait Editran

23
 2. Alta Perfiles

2.5.2 Procesado de un fichero de comandos

Si, en cambio, queremos ejecutar comandos procedentes de ficheros lo invocaremos como cfgupt -ffichero, donde
"fichero" es el fichero que contiene los comandos. Una posible sesión sería:
> cfgupt -fALTAS.cmd
>

Tras lo cual, las operaciones contenidas en ALTAS.cmd habrán sido ejecutadas.

2.6 Indicación directa de comandos

En este caso se indica la actualización directamente en la línea de comandos, como en:
> cfgupt -Eop=A -Eperfil=EDI -Esesion=EJEMPLO -Ecodrem=9991 -Eaplic=PRUEBA
> cfgupt -Eop=B -Eperfil=EDI -Esesion=EJEMPLO
>
Donde primero damos de alta la sesión EJEMPLO y luego la damos de baja. A la hora de indicar operaciones en la línea
de argumentos rigen las mismas reglas que a la hora de redactarlas en un fichero de comandos. Las únicas notas
adicionales son:
 Se utiliza "-E" para indicar comandos destinados a editran/P.
 Se utiliza "-I" para indicar comandos destinados a editran/G.
Cada parámetro posible en un fichero de comandos tiene una opción asociada en la línea de argumentos.
Como ejemplo de las notas anteriores, el fichero correspondiente a las invocaciones anteriores de cfgupt sería:
Para la primera invocación:

-- *** begin of command file generated by cfgupt ***

OPERACION = A --(0)
PERFIL = EDI --(1)
SESION = EJEMPLO --(2)
CODIGO REMOTO = 9991 --(3)
APLIC = PRUEBA --(4)
-- End of operation. (5 commands sent)
%%=
-- *** total: 5 commands sent
-- *** end of command file generated by cfgupt ***
Para la segunda invocación:
-- *** begin of command file generated by cfgupt ***
OPERACION = B --(0)
PERFIL = EDI --(1)
SESION = EJEMPLO --(2)
-- End of operation. (3 commands sent)
%%=
-- *** total: 3 commands sent
-- *** end of command file generated by cfgupt ***

2.6.1 Volcado a fichero de sesiones.

También es posible volcar el contenido de sesiones editran/P y editran/G a un fichero de texto. La sintaxis de fichero
generado es la misma que se emplea para actualización de perfiles de forma desatendida (es decir, a partir de un fichero
de entrada), con lo que los ficheros de comandos obtenidos de esta forma pueden ser modificados para su posterior
incorporación en los ficheros de configuración de editran/P y editran/G (haciendo uso para ello de nuevo del comando
cfgupt). Se puede decir, por tanto, que esta opción complementa a la que permitía la actualización de sesiones a partir
de un fichero de texto.
La sintaxis del comando cfgupt en este caso es la siguiente:
cfgupt -r {[-a[ei] | [-l | [-e<sesion>][-i<presentacion>]}[-o<fichero>]

Onesait Editran

24
 2. Alta Perfiles

donde:
-r: indica que se solicita una operación de volcado.
-a[ei]: especifica que se vuelquen todas las sesiones. “-ae” vuelca el perfil local y todas las sesiones editran/P; “-ai” vuelca
todas las presentaciones editran/G. Pueden especificarse ambas opciones a la vez o incluso en una única expresion “-aei”.
-l: especifica que se vuelque el perfil local. La opción anterior y esta son mutuamente excluyentes.
-e<sesion>: especifica la sesión editran/P que se quiere volcar.
-i<presentacion>: especifica la presentación editran/G que se quiere volcar.
-o<fichero>: especifica el fichero al que se volcarán la sesiones. Si no existe, se crea. Si ya existe, las sesiones se añaden al
final de dicho fichero. Si no se especifica esta opción, se considerará por defecto la salida estándar.

Vamos a ver a continuación algunos ejemplos de uso. La siguiente línea:

cfgupt -r -eEJEMPLO

Vuelca a la salida estándar la sesión editran/P “EJEMPLO”.

Si hubiéramos escrito:
cfgupt -r -iEJEMPLO -oout

se volcaría el contenido de la presentación “EJEMPLO” de editran/G al fichero out.

El siguiente ejemplo muestra cómo se volcarían varias sesiones y presentaciones:
cfgupt -r -eEJEMPLO1EDI -iEJEMPLO1IGA -e-EJEMPLO2EDI -iEJEMPLO2IGA -oout

Si alguna de las sesiones no está dada de alta en el fichero de configuración correspondiente, se generará un mensaje
de error.
Si quisiéramos volcar el perfil local y todas las sesiones editran/P definidas:
cfgupt -r -ae -oout

Si quisiéramos volcar el perfil local:

cfgupt -r -l -oout

Si quisiéramos volcar todas las presentaciones editran/G definidas:

cfgupt -r -ai -oout
Por último, para volcar el contenido de los ficheros de perfiles a fichero escribiríamos lo siguiente:
cfgupt -r -aei -oout

2.6.2 Trucos
Como suele ocurrir, hay ciertos trucos que pueden resultar útiles. Uno de ellos es utilizar las opciones "-e" y "-i" de
cfgupt. La opcion "-e" permite indicar que programa se va a encargar de ejecutar operaciones para administración de
editran/P (normalmente ediperfi).
La opción "-i" permite indicar que programa se va a encargar de ejecutar operaciones para la administración de
editran/G (normalmente igaperfi).
El programa cfgupt, cuando toma operaciones de la línea de argumentos, construye un fichero de comandos que pasa
al interprete adecuado (ediperfi o igaperfi normalmente).
No obstante, podemos crear el siguiente "script" en el fichero volcar:
#!/bin/sh
cat >VOLCADO
tras lo cual, una invocación

Onesait Editran

25
 2. Alta Perfiles

> cfgupt -evolcar -Eop=B -Eperfil=EDI -Esesion=EJEMPLO

dejará en el fichero VOLCADO un fichero de comandos equivalente a las opciones que hemos indicado.

2.7 Errores
Los mensajes de error pueden deberse a problemas en cfgupt o en los intérpretes. En cualquier caso, los códigos
devueltos al sistema son los indicados en la ayuda (cero si todo va bien, no-cero si hay problemas).

2.8 Perfiles de editran/P

El comando ediperfi es el encargado de interpretar (y ejecutar) operaciones de administración de editran/P. Su sintaxis
es la siguiente:
ediperfi: Comando de Introduccion Desatendida de Perfiles editran.
V5.1 R0 - Apr 30 2013
Copyright (C) 1991-2011 INDRA
Uso: ediperfi [-h] [-f<inputfile>]
[-r {[-a [-V<v>] [-R<r>] [-n]] | [-l] | [-s<sesion>]} [-o<outputfile>]]
-h: ayuda (esta)
-f<inputfile>: nombre del fichero con comandos de
modificacion de perfil. (defecto=stdin)
-r: volcado de sesiones editran a fichero.
-s<sesion>: sesion editran a volcar.
-a: volcado de todas las sesiones y del perfil local a fichero.
-l: volcado del perfil local a fichero
-R<r>: Release del fichero a volcar
Valores posibles para <r> : 0..8
-V<v>: Version del fichero a volcar
Valores posibles para <v> : 30, 31, 40, 41, 50 y 51
-n: no volcar sesiones sin datos de red
-o<outputfile>: nombre del fichero en el cual se
volcara la sesion. (defecto=stdout)

Dada su similitud con la sintaxis de cfgupt, los ejemplos de utilización de éste son aplicables de forma prácticamente
directa (restringiéndonos, claro está, a las opciones que están disponibles en ediperfi).

Onesait Editran

26
 2. Alta Perfiles

2.9 Perfiles de editran/G

El comando igaperfi es el encargado de interpretar (y ejecutar) operaciones de administración de editran/G. Su
sintaxis es la siguiente:
igaperfi: Comando de Introduccion Desatendida de Perfiles editran/G.
V5.1 R0 - Apr 30 2013
Copyright (C) 1991-2011 INDRA
Uso: igaperfi [-h] [-f<inputfile>]
[-r {[-a [-V<v>] [-R<r>]] | [-s<presentacion>]} [-o<outputfile>]]
-h: ayuda (esta)
-f<inputfile>: nombre del fichero con comandos de
modificacion de perfil. (defecto=stdin)
-r: volcado de presentaciones editran/G a fichero.
-s<presentacion>: presentacion editran/G a volcar.
-a: volcado de todas las presentaciones a fichero.
-R<r>: Release del fichero a volcar.
Valores validos de <r> 1..8
-V<v>: Version del fichero a volcar.
Valores validos de <v> 30, 31, 40, 41, 50 y 51
-o<outputfile>: nombre del fichero en el cual se
volcara la sesion. (defecto=stdout)

Dada su similitud con la sintaxis de cfgupt, los ejemplos de utilización de éste son aplicables de forma prácticamente
directa (restringiéndonos, claro está, a las opciones que están disponibles en igaperfi).
Conviene notar que tanto con igaperfi como con ediperfi es posible especificar una operación directa (actualización de
perfiles a partir de un fichero de comandos) simultáneamente con una o más operaciones inversas (volcado a fichero
de texto de sesiones editran/P y editran/G), cosa que no es posible con cfgupt.

2.10 Migración de perfiles en proceso de instalación

Los comandos ediperfi e igaperfi pueden usarse como una utilidad que permita la portabilidad de los ficheros de
configuración cuando sean necesarias actualizaciones del Software de editran. Las actualizaciones a versiones
superiores podrían provocar que los ficheros de configuración antiguos no fueran compatibles con la nueva instalación,
para poder mantener la configuración de partida usaremos los comandos con las opciones -V y -R comentadas en los
apartados anteriores y que nos permiten recuperar en formato texto los perfiles definidos para otras versiones editran.
Conviene notar que el uso de los comandos para la actualización de perfiles de versiones anteriores está pensado como
una ayuda durante el proceso de instalación, por lo que tiene algunas restricciones que comentamos. Los ficheros de
configuración antiguos sólo pueden ser volcados a formato texto en su totalidad, es decir, las opciones -V y -R son
incompatibles con -s y -l. No obstante, el usuario siempre podrá editar el fichero texto resultante si quiere realizar alguna
modificación antes de generar los nuevos ficheros de configuración. Además, es conveniente que la recuperación de
los perfiles antiguos se realice cuando todavía no existen ficheros de perfiles para la nueva instalación.

Onesait Editran

27
 2. Alta Perfiles

A continuación, se comentan los pasos a seguir con un ejemplo en el que se recuperan los perfiles de editran Ver. 4.1
Rel. 7 en un entorno UNIX:
> cp editranp.cfg editranp.cfg.bak
> cp editrang.cfg editrang.cfg.bak

Es conveniente guardar una copia de seguridad de los ficheros de partida.

> ediperfi –r -a –V41 –R7 -operfiles.txt
> igaperfi –r -a –V41 –R7 -operfiles.txt

Leer los perfiles de editran/P y editran/G indicando la versión y release a la que corresponde los ficheros de
configuración, y volcando la información en el fichero de comandos perfiles.txt. Salvo algunos casos concretos que más
adelante se explicarán, no es necesario modificar este fichero.
> rm editranp.cfg
> rm editrang.cfg
Borrar los antiguos ficheros de perfiles.
> ediperfi -fperfiles.txt
> igaperfi -fperfiles.txt

Generar los ficheros de perfiles de la nueva instalación.

Como se comentaba en el ejemplo de uso pueden existir algunos casos en los que no es posible portar la antigua
configuración sin realizar antes alguna modificación en el fichero de comandos. Vamos a explicar algunos casos prácticos
de estas situaciones:
 Perfiles que por error se han podido dar de alta en versiones anteriores y que en esta versión sí se validan.
 Si la actualización de versión implicase un cambio del protocolo soportado, por ejemplo, se pasase de una versión
X.25 a una TCP/IP, el usuario deberá modificar los parámetros de las sesiones dependientes del nivel de red. Por
ejemplo, en este caso, habría que asignar los nuevos valores de DIRECCION IP LOCAL y DIRECCION IP REMOTA.
Aspectos de la migración relacionados con la Criptografía:
 el fichero ckds.des de la antigua instalación debe copiarse en la nueva, puesto que las sesiones mantienen las claves
que tenían antes de la actualización.
 El fichero ckds.rsa de versiones anteriores desaparece. La migración de las claves RSA se hará mediante el comando
migra_rsa.

2.11 Variable CFG_PERFIL

En principio, los comandos ediperfi e igaperfi trabajan con los ficheros de configuración que se encuentran en el
directorio de datos editran (por defecto <home-editran>/cfg). Sin embargo, cuando se utilizan para migrar perfiles de
versiones anteriores los antiguos ficheros de configuración deberían copiarse al directorio en el que se encuentran los
programas a no ser que se use la variable CFG_PERFIL para definir la ruta completa del fichero a migrar. A continuación,
se muestra un ejemplo de migración utilizando la variable.
Suponiendo que la versión anterior estaba instalada en /opt/editran/v417 en un entorno Unix con shell sh , situarse en
el directorio de la nueva instalación y ejecutar:
> CFG_PERFIL=/opt/editran/v417/editranp.cfg
> ediperfi –r –a –V41 –R7 –operfiles.txt
> CFG_PERFIL=/opt/Editran/v417/editrang.cfg

Onesait Editran

28
 3. MODIPERFI

3 MODIPERFI
3.1 Introducción.
El propósito del comando modiperfi es dotar al usuario de editran/P y de editran/G 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.

3.2 Modo de empleo

El comando modiperfi se basa en la utilización reiterada del comando cfgupt en los modos modificación y baja de
perfiles de editran/P o en los modos modificación y baja de perfiles de editran/G. Así se añade la posibilidad de modificar
los parámetros de más de una sesión o de más de una presentación en una sola línea de comandos o de dar de baja
más de un perfil.
La sintaxis del programa es la siguiente:
modiperfi [-h] | {-o<P|G|F [-c]> [-r<remoto>] [-a<aplicación>] [-l<local>] [-s<sesión>|-p<presentacion>] –m<-Exx=yy …|-
Ixx=yy …>|} | {-b –o<P|G> -s<sesion>|-p<presentacion>}
Donde:
 h: Salida por pantalla de la ayuda.
 o<P|G|F> es el argumento con el que el usuario especificará si desea modificar/dar de baja los perfiles de editran/P,
en cuyo caso escribirá P tras el identificador “-o”, si desea modificar/dar de baja los perfiles de editran/G,
escribiendo en este caso G, o bien F para el caso particular de modificaciones en el perfil de editran/G referidas a
los parámetros de los ficheros de emisión.
 c para los cambios referidos a ficheros de emisión, primero se intenta modificar, pero si falla se intenta crear.
 r<remoto> es el argumento que servirá para limitar las sesiones (si se ha escrito P) o presentaciones (si se ha escrito
G o F), cuyos parámetros se desean modificar, a aquellas cuyo código de remoto coincida con el introducido. Existe
la posibilidad de introducir únicamente las cifras significativas.
 a<aplicación> es el argumento con el que se filtrarán las sesiones (si se ha escrito P) o presentaciones (si se ha
escrito G o F), cuyos parámetros se desean modificar, que coincidan con el código de aplicación introducido. Admite
el carácter ‘*’ como comodín, de manera que, cuando éste se utilice, el comando modificará los perfiles de tantas
sesiones o presentaciones cuya aplicación comience por las letras que anteceden al asterisco.
 l<local> es el argumento que restringirá los cambios a las sesiones (si se ha escrito P) o presentaciones (si se ha
escrito G o F) con el código de local escrito tras el identificador “-l”. Existe la posibilidad de introducir únicamente
las cifras significativas.
 s<sesión>|-p<presentacion> es el argumento adecuado para filtrar, o bien las sesiones o bien las presentaciones a
modificar/dar de baja, a aquellas cuya sesión/es o presentación/es coincida/n, o comience/n en el caso de utilizar
el carácter ‘*’ como comodín, con el literal introducido tras el identificador “-s” o “-p”. Este argumento debe ser
coherente con el argumento con identificador “-o”, el argumento en el que se escoge la opción de los perfiles a
modificar. Así, si en aquel argumento se introdujo P, en este se escribirá –s<sesión> y si se escribió G o F ahora
habrá que introducir –p<presentación>.
 m<-Exx=yy …|-Ixx=yy …|-Iorden=n …> es el argumento a través del cual el usuario especificará los parámetros que
desea modificar asignando el valor ‘yy’ al campo ‘xx’. Como ocurre con el anterior, este argumento debe ser
coherente con aquel en el que se escoge la opción P, G o F. Para la primera, perfiles de editran/P, se escribirá –
Exx=yy y para las segunda y tercera, perfiles de editran/G y parámetros de ficheros, –Ixx=yy. En el caso concreto de
F, el primer –Ixx=yy debe ser el referido al orden del fichero que se va a modificar, por tanto –Iorden=n, siendo n el
número que identifica la posición del fichero en la lista de ficheros de emisión. Después se deben colocar la/s
modificación/es a realizar sobre los parámetros de dicho fichero.
 b es el argumento mediante el que se identifica que se van a dar de baja los perfiles de una o varias sesiones o de
una o varias presentaciones.

Onesait Editran

29
 3. MODIPERFI

3.2.1 Modificación perfiles editran/P y editran/G

Esta opción de uso de comando permite filtrar, en cada caso, según cuatro parámetros del perfil.
La manera de hacer esto, en cada caso, es la misma que se utiliza en el comando cfgupt y está ampliamente detallada
en este manual de usuario. Ver apartado 2.5.1 para consultar las etiquetas de los campos o parámetros que puede
tomar xx en -Exx=yy y/o Ixx=yy.
Si se desea modificar más de un parámetro, se irán colocando uno a continuación de otro, separados por un espacio, y
con comillas al principio y al final de la serie. En este caso la forma del argumento sería: -m”-Exx=yy –Exx=yy –Exx=yy …”
o bien -m”-Ixx=yy –Ixx=yy –Ixx=yy …”.
Si el valor que se desea dar a un parámetro contiene espacios en blanco, se debe delimitar dicho valor con los caracteres
\” de la siguiente manera: -m”-Exx=\”yy\”…” …” o bien -m”-Ixx=\”yy\” …”.
A excepción del argumento de la opción, identificado con “–o”, y el de las modificaciones, identificado con “-m”, todos
los demás son opcionales. Cuando un argumento no aparezca no se filtrará según ese parámetro y se modificarán todas
las sesiones o presentaciones respecto a dicho argumento.
Una vez ejecutado el comando se irán mostrando por pantalla las sesiones o presentaciones que se están modificando
y al final el número de sesiones o presentaciones en las que se ha modificado el perfil con éxito.

3.2.2 Baja de perfiles editran/P y editran/G

Esta opción de uso de comando permite filtrar según nombre de sesión y nombre de presentación, siendo obligatorios,
y los únicos admitidos, los argumentos: -b –o<P|G> -s<sesion>|-p<presentacion>.
Una vez ejecutado el comando se irán mostrando por pantalla las sesiones o presentaciones cuyos perfiles se están
dando de baja y al final el número de sesiones o presentaciones en las que se logrado dicha tarea con éxito.

Onesait Editran

30
 3. MODIPERFI

3.2.3 Ejemplos de aplicación.

A continuación, se muestran algunos ejemplos de utilización del comando. En cada caso aparecerá en primer lugar la
línea de comando en sí y seguidamente la ejecución que realiza:

3.2.3.1.1 Modificación de los perfiles de editran/P

 modiperfi –oP –m-Eversrem=31
Modificará el campo versión en el perfil de todas las sesiones de EDITRAN/P aplicando en todas ellas el valor 31 a dicho
campo.
 modiperfi –oP –r000002030 –m-Eversrem=31 o modiperfi –oP –r203 –m-Eversrem=31
Modificará el campo versión en el perfil de todas las sesiones cuyo código de remoto sea 000002030, asignándole el
valor 31. Como se observa, el código de remoto puede escribirse con todas sus cifras o únicamente con las significativas.
 modiperfi –oP –r203 –aPR* -m-Eversrem=31
Modificará el campo versión en el perfil de todas las sesiones cuyo código de remoto sea 000002030 y cuyo código de
aplicación comience por ‘PR’, asignándole el valor 31.
 modiperfi –oP –r000002030 –aPR* -l1111 -m-Eversrem=31
Modificará el campo versión en el perfil de todas las sesiones cuyo código de remoto sea 000002030, cuyo código de
aplicación comience por ‘PR’ y con código de local igual a 000011110, asignándole el valor 31.
 modiperfi –oP –r000002030 –aPR* -l000011110 –sLOCAL -m-Eversrem=31
Modificará el campo versión en el perfil de todas las sesiones cuyo código de remoto sea 000002030, cuyo código de
aplicación comience por ‘PR’, con código de local igual a 000011110 y con el nombre de sesión LOCAL, asignándole el
valor 31.
 modiperfi –oP –r203 –aPR* -l1111 –sLOCAL –m”-Eversrem=31 –Eaplic=TCP001”
Modificará los campos versión y código de la aplicación en el perfil de todas las sesiones cuyo código de remoto sea
000002030, cuyo código de aplicación comience por ‘PR’, con código de local igual a 000011110 y con el nombre de
sesión LOCAL, asignándoles el valor 31 y TCP001 respectivamente. Como se observa, al introducir más de un –Exx=yy
debe añadirse un espacio entre cada uno y el siguiente así como comillas al principio y al final de la serie.
 modiperfi –oP –r000002030 –m”-Eversrem=31 –Eaplic=TCP001 –Ereint=3”
Modificará los campos versión, código de la aplicación y número máximo de reintentos en el perfil de todas las sesiones
cuyo código de remoto sea 000002030, asignándoles el valor 31, TCP001 y 3 respectivamente.
 modiperfi –oP –sPRUEBA –m"-Enomaplic=\"Aplicacion 2023\""
Modifica en la sesión PRUEBA el campo nombre de la aplicación asignándole el valor Aplicación 2023. Nótese que se ha
delimitado el nombre nuevo de la aplicación con los caracteres \” ya que contiene espacios en blanco.

3.2.3.2 Baja de los perfiles de editran/p

 modiperfi –b –oP –sE*
Dará de baja los perfiles de las sesiones de editran/P cuyos nombres comiencen por “E”.

3.2.3.3 Modificación de los perfiles de editran/g

 modiperfi –oG –m-Idstrec=.\destino
Modificará el campo destino recepción en el perfil de todas las presentaciones aplicando en todas ellas el valor .\destino
a dicho campo.
 modiperfi –oG –r000002030 –m-Idstrec=.\destino o modiperfi –oG –r203 –m-Idstrec=.\destino
modificará el campo destino recepción en el perfil de todas las presentaciones cuyo código de remoto sea 000002030,
asignándole el valor .\destino. Como se observa, el código de remoto puede escribirse entero o únicamente las cifras
significativas.
 modiperfi –oG –r000002030 –aPR* -m-Idstrec=.\destino

Onesait Editran

31
 3. MODIPERFI

Modificará el campo destino recepción en el perfil de todas las presentaciones cuyo código de remoto sea 000002030
y cuyo código de aplicación comience por ‘PR’, asignándole el valor .\destino.
 modiperfi –oG –r203 –aPR* -l1111 -m-Idstrec=.\destino
Modificará el campo destino recepción en el perfil de todas las presentaciones cuyo código de remoto sea 000002030,
cuyo código de aplicación comience por ‘PR’ y con código de local igual a 000011110, asignándole el valor .\destino.
 modiperfi –oG –r000002030 –aPR* -l1111 –pLOCAL -m-Idstrec=.\destino
Modificará el campo destino recepción en el perfil de todas las presentaciones cuyo código de remoto sea 000002030,
cuyo código de aplicación comience por ‘PR’, con código de local igual a 000011110 y con el nombre de presentación
LOCAL, asignándole el valor .\destino.
 modiperfi –oG –r203 –pM* -m”-Iautentica=DES –Iusrexc=U_EXCEPT”
Modificará los campos autenticación y excepción en los perfiles de todas las presentaciones con código de remoto igual
a 000002030 y cuyo nombre de presentación comience por ‘M’, asignándoles los valores DES y U_EXCEPT
respectivamente. Como se observa, al introducir más de un –Ixx=yy debe añadirse un espacio entre cada uno y el
siguiente así como comillas al principio y al final de la serie.
 modiperfi –oF –r203 –aPR* -l000011110 –pLOCAL –m”-Iorden=1 –Inomfich=nuevo.c”
Modificará el campo nombre del fichero, en el primer fichero de la lista de ficheros de emisión, en el perfil de todas las
presentaciones cuyo código de remoto sea 000002030, cuyo código de aplicación comience por ‘PR’, con código de local
igual a 000011110 y con el nombre de presentación LOCAL, asignándole el valor nuevo.c. Especificar el orden del fichero
cuyos parámetros se quieren especificar es obligatorio.
 modiperfi –oF –r000002030 –m”-Iorden=1 –Inomfich=nuevo.c –Ialffich=N”
Modificará los campos nombre del fichero y alfabeto en el primer fichero de la lista de ficheros de emisión del perfil de
todas las presentaciones cuyo código de remoto sea 000002030, asignándoles el valor nuevo.c y N respectivamente.

3.2.3.4 Baja de perfiles editran/g

 modiperfi –b –oG –pPRUEBA
Dará de baja el perfil de editran/G de la presentación “PRUEBA”.

3.2.3.5 Ejemplos de salida

A continuación, se muestra las salidas por pantalla que se obtiene a partir de dos comandos.
 modiperfi -oP –l204 –m”-Eversrem=31 –Ealfabeto=A”
Modificando la/s sesion/es...
EDITRAN TCP1
EDITRAN TCP2
EDITRAN TCP3
EDITRAN TCP4
EDITRAN TCP5
GODELLO TCP1
Se han modificado los perfiles de 6 sesiones.

 modiperfi –oG –l204 –pG* -m”-Ialfabeto=A –Iusrexc=U_EXCEPT”

Modificando la/s presentacion/es...
GODELLO TCP1
Se ha modificado el perfil de una presentacion.
 modiperfi -oF –r99991 –pE* –m”-Iorden=1 -Inomfich=nuevo.c –Icompres=N”
Modificando la/s presentacion/es...
EDITRAN TCP1
EDITRAN TCP2
EDITRAN TCP4
EDITRAN TCP5

Onesait Editran

32
 3. MODIPERFI

Se han modificado los perfiles de 4 presentaciones.

 modiperfi -b -oG –pE*
Se está/n dando de baja la/s presentacion/es...
EDITRAN TCP1
EDITRAN TCP2
EDITRAN TCP4
EDITRAN TCP5
Se han dado de baja 4 presentaciones.

Onesait Editran

33
Persona de contacto
[email protected]

Avda. de Bruselas 35
28108 Alcobendas,
Madrid, España
T +34 91 480 50 00
F +34 91 480 50 80

www.minsait.com