> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/open-v5.2.1/linux/gestor_perfiles.md). # Gestión de perfiles ## Introducción General ### 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*. ### 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. ### 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**. ### 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. ## Alta Perfiles ### 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 | | 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 ... %%= ``` **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. **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. ### Comandos para perfil local de Onesait · Editran #### Operación * **Descripción:** Tipo de operación a realizar. * **Valores:** A (alta) o M (modificación). * **Ejemplo:** OPERACION = A #### Perfil * **Descripción:** Identifica que la operación se realizará sobre el perfil local de editran/P\*.\* * **Valores:** LOC (*LOCAL*). * **Ejemplo:** PERFIL = LOC #### 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 #### Nombre local * **Descripción**: Nombre descriptivo de la entidad local. * **Valores**: Cadena alfanumérica. * **Ejemplo**: NOMBRE LOCAL = PC 23 #### 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 #### 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 #### 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 ### Comandos para editran/P #### Operación * **Descripción:** Tipo de operación a realizar. * **Valores:** A (alta), B (baja) o M (modificación). * **Ejemplo:** OPERACION = A #### Perfil * **Descripción:** Identifica que la operación se realizará sobre una sesión *editran/P.* * **Valores:** EDI (editran/P). * **Ejemplo:** PERFIL = EDI #### 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 #### 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 #### 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 #### 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á convenientemente. * **Ejemplo:** CODIGO REMOTO = 9991 #### Nombre remoto * **Descripción:** Nombre descriptivo de la entidad remota. * **Valores:** Cadena alfanumérica. * **Ejemplo**: NOMBRE REMOTO = CICS1 #### Aplic * **Descripción:** Es el código que identifica la aplicación. * **Valores:** Cadena alfanumérica de exactamente de 6 caracteres. * **Ejemplo:** APLIC = PRUEBA #### Nombre aplic * **Descripción:** Nombre descriptivo de la aplicación editran/P. * **Valores:** Cadena alfanumérica. * **Ejemplo:** NOMBRE APLIC = PRUEBA #### 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 #### NUM VERSION * **Descripción:** Versión del editran/P remoto. * **Valores:** Una versión (4.1, 5.0, etc.). * **Ejemplo:** NUM VERSION = 4.1 #### 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 #### 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 #### 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 #### 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. * **Ejemplo:** DESCONEXION AUTOMATICA = S #### 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 #### 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 #### Reintentos * **Descripción:** número máximo de reintentos en retransmisión. * **Valores:** Un número. * **Ejemplo:** REINTENTOS = 3 #### Guardar rotaciones * **Descripción:** Se desea guardar las direcciones remotas según el orden de conexión. * **Valores:** S, N. * **Ejemplo:** GUARDAR ROTACIONES = N #### CRC * **Descripción:** Se emplean códigos de redundancia cíclicos en cada mensaje transmitido. * **Valores:** S o N. * **Ejemplo:** CRC = S #### Servidor/cliente * **Descripción:** Modo de operación. * **Valores:** S (servidor) o C (cliente, normalmente). * **Ejemplo:** SERVIDOR/CLIENTE = C #### ASCII/EBCDIC * **Descripción:** Alfabeto utilizado en el remoto. * **Valores:** A (ascii) o E (ebcdic). * **Ejemplo:** ASCII/EBCDIC = E #### Compresión * **Descripción**: Transmisión comprimida de datos. * **Valores**: S, N, L o V. * **Ejemplo**: COMPRESION = N #### 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 #### 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 #### 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 #### Longitud Tampon * **Descripción:** Longitud de los registros de los ficheros tampones. * **Valores:** Valores entre 252 y 4050. * **Ejemplo:** LONGITUD TAMPON = 4050 #### 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 #### 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 #### Criptografía * **Descripción:** Cifrado de datos durante la transmisión. * **Valores:** S, N. * **Ejemplo:** CRIPTOGRAFIA = S #### 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 #### 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 #### 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 #### Confidencialidad * **Descripción:** Algoritmo usado para el cifrado de datos. * **Valores:** DES, TD2, TD3, AES, AE2 y AE3. * **Ejemplo:** CONFIDENCIALIDAD = TD3 #### Autenticación * **Descripción:** Algoritmo usado en la autenticación de las claves de sesión. * **Valores:** DES o RSA. * **Ejemplo:** AUTENTICACION = RSA #### 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 #### 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 #### 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 #### 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 #### 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 #### 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 #### 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 ### Comandos para editran/G #### Operación * **Descripción:** Tipo de operación a realizar. * **Valores:** A (alta), B (baja) o M (modificación). * **Ejemplo:** OPERACION = A #### 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 #### 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: #### 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 #### 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 #### 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 #### 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. * **Ejemplo:** CODIGO REMOTO = 9991 #### Descripción remoto * **Descripción:** Nombre descriptivo de la entidad remota. * **Valores:** Cadena alfanumérica. * **Ejemplo:** DESCRIPCION REMOTO = CICS1 #### 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 #### Criptografía * **Descripción:** Uso de criptografía * **Valores:** S o N. * **Ejemplo:** CRIPTOGRAFÍA = S #### 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 #### Confidencialidad * **Descripción:** Algoritmo usado en el cifrado de la información. * **Valores:** DES, TD2, TD3, AES, AE2 o AE3. * **Ejemplo:** CONFIDENCIALIDAD = AES #### AUTENTICACION * **Descripción:** Algoritmo para autentificar la entidad emisora. * **Valores:** DES, RSA. * **Ejemplo:** AUTENTICACION = RSA #### 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 #### 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 #### 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 #### 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 #### APLIC * **Descripción:** Es el código de la aplicación. * **Valores:** Cadena alfanumérica de exactamente 6 caracteres. * **Ejemplo:** APLIC = PRUEBA #### 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 #### 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 #### 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 #### 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 #### 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 #### 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 #### 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 #### Excepción * **Descripción:** Nombre del automatismo de usuario en caso de excepción. * **Valores:** Un nombre de un ejecutable. * **Ejemplo:** EXCEPCION = U\_EXCEPT #### 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 #### Tipo de carga * **Descripción:** El tipo de carga puede ser Normal o Acumulativa. * **Valores:** N o A. * **Ejemplo:** TIPO DE CARGA = N #### 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 #### APLIC EDI * **Descripción:** Aplicación *e*ditran/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 #### 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 #### 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 #### 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 #### 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 #### 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 #### 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: #### 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 #### 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 #### 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 #### 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 #### Delimitador * **Descripción:** Delimitador utilizado en la carga de ficheros con formato Fijo. * **Valores:** N (Ninguno), D (Dos) y U (UNIX). * **Ejemplo:** DELIMITADOR = N #### Compresión * **Descripción:** Uso de compresión de ficheros. * **Valores:** F (se hace uso de la compresión) o N. * **Ejemplo:** COMPRESION = F #### Alfabeto * **Descripción:** Selector del Juego de Caracteres de los ficheros a emitir. * **Valores:** E (*EBCDIC*), A (*ASCII)* o N (*Ninguno*). * **Ejemplo:** ALFABETO = A #### 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 ### 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. #### 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]: ``` uso: cfgupt [ -h | -H] [-r {[-a[ei]] | [-l] | [-e ...] [-i ...]} [-o]] | [-i] [-e] [-E= ...] [-I= ...] | [-f [-w]] -h: ayuda (esta) -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: volcado de sesiones EDItran/P -i: volcado de presentaciones EDItran/G -o: volcar sesiones al fichero . -e: usar 'cmd' como interprete de opciones -E -i: usar 'cmd' como interprete de opciones -I -E=: poner parametro perfil EDItran/P 'xx' a 'yy' -I=: poner parametro perfil EDItran/G 'xx' a 'yy' -f: leer comandos desde fichero -f -w: ejecuta de forma sincrona los comando leidos desde fichero para ver como utilizar -E y -I y codigos de retorno use la opcion -H. 'cfgupt -H' ``` Para ver cómo utilizar -E y -I y códigos de retorno use la opción -H. Las opciones -E\=\ 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 | | 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 | | | | #### Procesado de un fichero de comandos Si, en cambio, queremos ejecutar comandos procedentes de ficheros lo invocaremos como ***cfgupt -f**fichero*, 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. ### 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 *** ``` #### 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\]\[-i\]}\[-o\] 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\: especifica la sesión editran/P que se quiere volcar. > > -i\: especifica la presentación editran/G que se quiere volcar. > > -o\: 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 #### 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*: ```sh #!/bin/sh cat >VOLCADO ``` tras lo cual, una invocación `>cfgupt -evolcar -Eop=B -Eperfil=EDI -Esesion=EJEMPLO`\ dejará en el fichero VOLCADO un fichero de comandos equivalente a las opciones que hemos indicado. ### 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). ### 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. > > Uso: ediperfi \[-h] \[-f\] > > \[-r {\[-a \[-V\] \[-R\] \[-n]] | \[-l] | \[-s\]} \[-o\]] > > -h: ayuda (esta) > > -f\: nombre del fichero con comandos de > > modificacion de perfil. (defecto=stdin) > > -r: volcado de sesiones editran a fichero. > > -s\: sesion editran a volcar. > > -a: volcado de todas las sesiones y del perfil local a fichero. > > -l: volcado del perfil local a fichero > > -R\: Release del fichero a volcar > > Valores posibles para \ : 0..8 > > -V\: Version del fichero a volcar > > Valores posibles para \ : 30, 31, 40, 41, 50 y 51 > > -n: no volcar sesiones sin datos de red > > -o\: 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***). ### 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*. > > 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 \ 1..8 > > -V\: Version del fichero a volcar. > > Valores validos de \ 30, 31, 40, 41, 50 y 51 > > -o\: 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***. ### 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. 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. ### 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 \/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 ## MODIPERFI ### 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. ### 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\ \[-r\] \[-a\] \[-l\] \[-s\|-p\] -m<-Exx=yy ...|-Ixx=yy ...>|} | {-b -o\ -s\|-p\} Donde: * h: Salida por pantalla de la ayuda. * o\ 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\ 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\ 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\ 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\|-p\ 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\ y si se escribió *G* o *F* ahora habrá que introducir -p\. * 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. #### 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. 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. #### 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\ -s\|-p\. 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. #### 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: **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. **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". **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** 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. **Baja de perfiles editran/g** * **modiperfi -b -oG -pPRUEBA** Dará de baja el perfil de editran/G de la presentación "PRUEBA". **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 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.editran.onesait.com/documentacion-editran/open-v5.2.1/linux/gestor_perfiles.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.