EDItran TX 4.1 CICS (Windows-UNIX) Manual de instalación y usuario. Indra. Julio - 2003. ETX41USIC.doc. Indra. La información aquí contenida puede ser objeto de cambios sin previo aviso. Las distintas versiones del producto pueden dar lugar a cambios, adiciones o supresiones de información en este manual. La correspondencia acerca de este manual debe realizarse en la hoja de comentarios aquí incluida y debe ser dirigida a Indra, Producto EDItran, Avda. de Bruselas 35 (Edificio VIO-1), 28108 - Arroyo de la Vega - Alcobendas, Madrid. Comentarios de usuario sobre esta documentación. Exprese, y háganos llegar, su opinión y comentarios acerca de la documentación entregada y así podremos corregirla en las posteriores versiones de este documento. Indra. Producto : EDItran TX 4.1 CICS Manual de instalación y usuario. Referencia: ETX41USIC.doc Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas. 28108 MADRID. _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ Empresa : ____________________________________________________________________________________ Departamento: ____________________________________________________________________________________ Contacto : ____________________________________________________________________________________ Dirección : ____________________________________________________________________________________ Manual de Instalación y usuario Indice 1. INTRODUCCION Y REQUERIMIENTOS.....................................................................................................1-1 2. DEFINICIONES Y CAMBIOS (OS/390 – Z/OS). ............................................................................................2-1 2.1. DEFINICIONES................................................................................................................................................2-1 2.2. CAMBIOS EN EDITRAN/P................................................................................................................................2-2 2.2.1. CAMPOS NUEVOS EDItran/P (PERFILES). ...........................................................................................2-2 2.2.2. CONSULTA DE LA TRAZA.......................................................................................................................2-4 2.3. BACKUP. ..........................................................................................................................................................2-6 2.4. MENSAJES DE ERROR X’20’ Y LIBERACIÓN X’13’................................................................................................2-6 3. 3.1. 3.2. 3.3. 3.4. 3.5. 3.6. EDITRAN/TX EN UNIX Y WINDOWS ...........................................................................................................3-1 INSTALACIÓN DE EDITRAN/TX EN UNIX ..........................................................................................................3-1 INSTALACIÓN DE EDITRAN/TX EN WINDOWS.................................................................................................3-1 CONFIGURACIÓN DE EDITRAN/TX WINDOWS ................................................................................................3-1 ARRANQUE Y PARADA WINDOWS....................................................................................................................3-1 CONFIGURACIÓN DE EDITRAN/TX UNIX ..........................................................................................................3-2 ARRANQUE Y PARADA UNIX .............................................................................................................................3-2 Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag. I-1 EDItran TX 4.1 CICS. 1. INTRODUCCION Y REQUERIMIENTOS. Se ha desarrollado una nueva utilidad que consiste en evitar la 3745 para poder establecer conexiones con remotos x25. Esta utilidad, se contrata de forma independiente al propio EDItran, y requiere: EDItran/TX y software pasarela de datos para entorno UNIX-WINDOWS. El sistema se basa en los siguientes elementos: • El host (CICS), dialoga a través de TCP/IP con PASARELA EDItran que corren en el entorno WINDOWS-UNIX, encapsulando y desencapsulando datos. • PASARELA que corre en la plataforma UNIX-WINDOWS, dialoga a través de x25 con los extremos remotos. • En llamadas salientes desde CICS, éste, proporciona a PASARELA UNIX-WINDOWS información x25 necesaria para esa conexión. • En llamadas entrantes al CICS, PASARELA UNIX-WINDOWS proporciona al anterior la información x25 disponible. • Una vez que hay conectividad entre ambos extremos, PASARELA UNIX-WINDOWS es un mero transmisor de datos: • Cuando EDItran CICS quiere enviar un datos al extremo remoto, se lo envía a PASARELA unix-windows a través del socket establecido. PASARELA, recibe ese dato y lo envía al extremo remoto a través del cvc x25. • Cuando el remoto envía un dato, le llega a PASARELA UNIX-WINDOWS a través del circuito x25 conectado entre ambos. Pasarela, envía ese dato al CICS a través del socket ip que ambos tienen conectados. Esta utilidad tiene las siguientes características: • Se requiere una plataforma UNIX-WINDOWS • Se contrata de forma independiente al propio EDItran, y requiere : EDItran/TX y pasarela de datos (software para entorno UNIX-WINDOWS). • No sirve para otro producto que no sea EDItran. • No requiere que el extremo remoto cambie nada (a no ser que se cambie el nri local x25 de host, el cual estará enganchado en la plataforma unix-windows). • No requiere que el remoto tenga instalada esta utilidad, puesto que para ese remoto se continua siendo x25. • Se tratan y se generan las liberaciones como en el mundo x25, a diferencia del mundo tcp/ip nativo, en donde para liberar se cierra el socket. • EDItran puede funcionar simultáneamente con varios tipos de conexión (x25, TCP/IP y TX), es decir puede tener simultáneamente una sesiones conectadas por x25, otras por lu6.2, otras contra pad privados, otras contra pad públicos, otras contra tcp/ip y otras por tcp contra remotos x25. En resumen, EDItran TX permite: 1. Conexiones EDItran desde un host (CICS) hacia remotos x25, sin necesidad de disponer de una 3745, de forma que sea para esos remotos un proceso transparente. Para ello, desde el Indra. Todos los derechos reservados ETX41USIC.doc 04/06/2007 Pag. 1-1 EDItran TX 4.1 CICS. host se realizan conexiones ip contra un unix-windows, el cual dispone de una tarjeta de red x25, que es la que se comunica con los extremos remotos. 2. Conexiones EDItran x25 y x28 desde centros remotos a un host (CICS). Para ello, dichos remotos se conectan vía x25 a un windows-unix, y éste se engancha vía ip al host (cics), que en definitiva es el destino final de la conexión remota. De esta manera, se evita también la 3745 y el proceso es transparente para las entidades remotas. EDItran/TX requiere por tanto de los siguientes elementos: 1.- Una ó más máquinas UNIX (SOLARIS, AIX, HP) ó WINDOWS (NT ó 2000) con n tarjetas de red x25 (en un UNIX pueden ir varias tarjetas mientras que en un windows sólo puede ir una tarjeta, que además debe ser dedicada a EDItran/TX). Las placas x25 no requieren modem y deben ser SAGEM (modelo PRIMA ó XMEM) ó EICON (múltiples modelos). 2.- Software EDItran/TX para UNIX-WINDOWS. 3.- TCP/IP desde host (cics) a las máquinas unix-windows. 4.- Software EDItran/TX para CICS. Pasarela remota EDItran TCP/IP WAN EDItran EDItran Pasarela 1-n TCP/IP LAN Indra. Todos los derechos reservados X25 PAD ETX41USIC.doc 04/06/2007 EDItran Pag. 1-2 Manual de Instalación y usuario 2. DEFINICIONES Y CAMBIOS (OS/390 – Z/OS). 2.1. DEFINICIONES. Son necesarias todas las definiciones descritas en el manual de EDItran TCP/IP (consulte el manual IP41USIC) excepto: Definición del fichero EZACONFG. Al definir el listener, se especificará SECEXIT = EDITR-TX, de forma que se sepa que este listener va a atender a este tipo de conexiones. Si se dispone de EDItran/TCP, se definirá otro listener (asociado a otro puerto y otra transid con el mismo programa), con SECEXIT = EDITRAN EZAC,ALTER,LISTENER APPLID ===> BMCIDATR TRANID ===> ZTBA PORT ===> 07777 IMMEDIATE ===> NO BACKLOG ===> 020 NUMSOCK ===> 100 MINMSGL ===> 004 ACCTIME ===> 060 GIVTIME ===> 010 REATIME ===> 000 FASTRD (*) ===> YES TRANTRN ===> NO TRANUSR ===> NO SECEXIT ===> EDITR-TX APPLID of CICS System Transaction Name of Listener Port Number of Listener Immediate Startup Yes|No Backlog Value for Listener Number of Sockets in Listener Minimum Message Length Timeout Value for ACCEPT Timeout Value for GIVESOCKET Timeout Value for READ Read Immediately Yes|No Translate TRNID Yes|No Translate User Data Yes|No Name of Security Exit (*) FASTRD DESAPARECE EN VERSIONES ALTAS DE ZOS En CICS, ADEMAS de todos los programas EDItran/TCP/IP, deben darse de alta los programas ZTBPO202 y ZTBPOTPA. DEFINE PROGRAM(ZTBPO202) GROUP(EDITRAN) LANGUAGE(COBOL) DATALOCATION(ANY) DEFINE PROGRAM(ZTBPOTPA) GROUP(EDITRAN) LANGUAGE(COBOL) DATALOCATION(ANY) Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag 2-1 Manual de Instalación y usuario 2.2. CAMBIOS EN EDItran/P. 2.2.1. CAMPOS NUEVOS EDItran/P (PERFILES). Para ver las definiciones, consulte el manual ED41USUC (capítulo 1.3.1, 1.3.2). Vea las pantallas de entorno local (segunda pantalla) y sesión (primera pantalla). TRANSACCIONES EDITRAN: NUCLEO....: ZTB0 INTERFASE.: ZTBI RED.......: ZTBX MENSAJES..: ZTB8 T/O.......: ZTBT MENU......: ZTBM OPERADOR..: ZTBO FICHEROS..: ZTBF ADMINIST..: ZTBD LISTAS....: ZTBL INCIDENCIA: ZTB9 C.ESTADIST: ZTBE G.ESTADIST: ZTB3 TERMINALES: ZT88 EXCI(CICS): ZTBG API TCP...: ZTBB PLTINI TCP: ZTBZ GEST.CLAVE: ZTB2 CAMPOS TCP/IP: TCPNAME...: TCPIPB TIME-OUT USER DATA MAX(MSS)..: 020 NRO.CONEX.SIMULT.LISTENER....: 004 USAR SERVER DNS EN LLAM.ENT..: S TO.MILISEG ENVIOS (001-999)..: 999 CAMPOS SERVER CRIPTOGRAF.EDITRAN/CD: TIEMPO CONEX. SERVIDOR (SS)..: 060 LINEA TCP/IP SERVER EDITRAN/CD (DNS/IP-ADDR + PUERTO REMOTO) 172.022.164.079 08089 CAMPOS SERVER EDITRAN/PROXY: LINEAS TCP/IP SERVER EDITRAN/PROXY (DNS/IP-ADDR + PUERTO REMOTO) OS390B 07779 192.168.172.088 07779 OS390B 07779 CAMPOS CIFRADO: LABEL LOCAL.....: LEDICICS LABEL REMOTO....: REDICICS PF7 - RETROCEDER LOCAL : X NNNNNNN X NOM: XXXXXXXXXXXXXXXXXXXX VERS.EDITRAN REMOTA.: n . n REMOTO: x nnnnnnn x NOM: xxxxxxxxxxxxxxxxxxxx IDENTIFICADOR ACCESO....: n APLIC.: xxxxxx NOM: xxxxxxxxxxxxxxxxxxxx VALIDAR IND-LLA(L/R/X/N): X TIPO CONEXION (X=X25,T=PAD,P=TX-X25,S=TX-PAD,I=TCP/IP,Y=PROXY,2=LU62)..: P TERMINAL LOCAL : xxxx IDNUM/REC.REMOTO: xxxxx SWIFT (S/N)........: x TIPO CVCS (C/P) : x COBRO REV. (S/N): x EXT.LLAM.(L/R/X)...: x TIPO PAGO(L/R/X): x TRAFICO (E/R/X) : x ROTA DIR.(L/R/X/N)..:x LLAM. AUTO.(S/N): x DESC.AUTO.(S/N) : x TERMID. OPERADOR: xxxx LINEAS REMOTAS TCP/IP (DNS/IP-ADDRESS + PUERTO REMOTO) : xxxxxxxxxxxxxxxxxxxxxxxx nnnnn xxxxxxxxxxxxxxxxxxxxxxxx nnnnn xxxxxxxxxxxxxxxxxxxxxxxx nnnnn LINEAS REMOTAS X25: -1-2-3LONG Y NRIS : nn nnnnnnnnnnnnnnn nn nnnnnnnnnnnnnnn nn nnnnnnnnnnnnnnn LINEAS LOCALES: <-------- NPSI DATE - NPSI GATE --------> <GATE> < NRO. RED IBERPAC > LU <RANGOS CVCS> LETRA PRIM. TAM. TAM. LNRI NRI TC FICT MENOR MAYOR CNID TERM. TERM. V.N.3 PAQ. TIPO nn nnnnnnnnnnnnnnn xx xxxx nnnn nnnn n x nnn nnn nnnn n nn nnnnnnnnnnnnnnn xx xxxx nnnn nnnn n x nnn nnn nnnn n nn nnnnnnnnnnnnnnn xx xxxx nnnn nnnn n x nnn nnn nnnn n - PF8 - AVANZAR, -PF7 - RETROCEDER En el registro de sesión, el significado es el siguiente: • TIPO DE CONEXION (P = EDItran/TX dialogando en modo x25 ó S = EDItran/TX dialogando en modo PAD). Si el remoto no tiene EDItran/TX, en su perfil el tipo de conexión será X (X25). Si el remoto tiene a su vez un EDItran/TX, ambos extremos codifican P. Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .2-2 Manual de Instalación y usuario • LINEAS REMOTAS TCP/IP. Dirección ip y puerto de la máquina UNIX-WINDOWS que contiene el resto de software EDItran/TX. Se codificarán tantas líneas remotas tcp/ip como líneas locales x25. Cada línea remota tcp/ip es en definitiva un nri local • LINEAS REMOTAS X25: Nris remotos x25 • LINEAS LOCALES X25 (NRI Y TC). Nri local (el de la tarjeta x25 del unix – windows). El terminal code para pad es 01. Se codificarán tantos nris locales como líneas remotas tcp. Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .2-3 Manual de Instalación y usuario 2.2.2. CONSULTA DE LA TRAZA. Se ha implementado un protocolo de mensajes de red que es fácilmente interpretable por su similitud a X25, con solicitud de llamada X0B, aceptación X0F y liberación X13 El cvc es el número de tarea CICS y la lu es el puerto local ó remoto (dependiendo de si es llamada entrante ó saliente). Se incluye un mensaje x20 para visualizar errores (consulte el log con causa-diagnóstico. La documentación sobre ERRNO, RETCODE y mensajes de error en la TCPCICS, proporcionados por las macros utilizadas para SOCKET EXTENDIDOS se encuentra disponible en el apéndice C del manual IBM TCP/IP for MVS. CICS TCP/IP Socket Interface Guide and Reference. Document Number SC31-7131-03. Program number 5655 HAL. File Number S370/4300/30xx-50. Ver también Document Number: SC31-8518-00. Si no aparece el errno correspondiente puede que el error se trate de OS390 V2R5 OPEN EDITION, de modo que venga en F1AF9000 IP Planning and Migration Guide 16/06/2004 08:33:02 CONSULTA DE FICHEROS CONSULTA DE TRAZA SESION : SEL SESION = ============================= S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 S00DI S00TI EDITX1 HORA ====== 083230 083230 083233 083233 083233 083237 083249 083249 083249 083258 083258 083258 083302 083302 S = S S E S S E E S E E S S E S MSJE ==== STC ETX ETX SAP STN SAR+ E11 SAB ETX ETX ETX STS SAP SAR+ EDITRAN 4.1 FECHA : 16/06/2004 NSM/LU T COMENTARIO ====== = =================== T/O DE CONEXION 07777 0B 0002 07777 0F 00D8 0002 PET. NOTIFICACION 00 T/O DE NOTIFICACION RESP. NOTIFICACION 00 PETICION LIBERACION SOL. LIBERACION 02 07777 13 00D8 0000 00 0F 03827 0B 00FD 03827 0F 00FD T/O DE ESPERA DE SAP IND. NOTIFICACION 00 RESP. NOTIFICACION 00 El significado de la traza previa es el siguiente, por ejemplo para el mensaje marcado: 1. En las columnas S y Comentario aparece un mensaje entrante (E) y se trata de un mensaje x’0B’ (indicación de llamada). 2. En la columna NSM/LU aparece el puerto remoto (3827). 3. En la columna Comentario aparece un cvc , x’00FD’ ó 253 en decimal, que es en realidad el número de tarea CICS (transid ZTBB) que trata la indicación de conexión. Es importante resaltar que si en un tiempo muy corto dicho número va pegando saltos muy grandes, nos encontraremos con que el CICS se encuentra muy cargado (está ejecutando muchas tareas simultáneamente). Si se detectan problemas en el CICS, revise el entorno local (nro conexiones por listener), la parametrización de la definición CICS a VTAM, en concreto el parámetro EAS (número de comunicaciones activas simultáneamente) y la relación de os parámetros Tclass de las transacciones con el parámetro CMXT de la SIT (las transid se pueden apuntar a una clase, y en la SIT se limita en número de transid de cada una de las clases. En la SIT está el parámetro MXT para indicar el número de transid CICS. Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .2-4 Manual de Instalación y usuario 4. En algunos casos, aparecen unos dígitos, que se corresponden con el CNID (identificador de aplicación, en caso de solicitud de llamada, para que devuelva lo mismo en llamada aceptada. 5. Otros tipos de mensaje son x’0F’ (llamada aceptada), x’13’ (liberación) y x’20’ (error), además del propio x’0B’ que si tiene sentido S significa solicitud de llamada. 6. En caso de EDItran/TX la clave de mensaje es ETX. Si seleccionamos el mensaje anterior (traza expandida), vemos el contenido completo de la llamada entrante (entre otras cosas aparecen los campos anteriormente descritos x’0B’): x’C5E3E740’ es la clave ‘ETX ‘. X’0B’ indica sol-lla. X’0EF3’ es el puerto remoto (3827). X’00FD’ es el identificador del número de tarea (253). X’D7’ Indica el tipo de conexión (P). X’0F’ es la longitud de datos de usuario (15) X’C0....0A’ son los datos de usuario x25. X’F1F7....F6’ es la ip de EDItran/TX (172.022.164.076) X’0A’ es la longitud del nri llamante (10) X’3171328302’ el nri llamante x25 X’0A’ es la longitud del nri llamando, es decir, el de la placa x25 de EDItran /TX (10) X’3151362507’ el nri llamado, es decir, el de la placa x25 de EDItran /TX X’16’ es la longitud del dns asociado a la ip anterior(22) X’94...4B’ es el dns de la ip anterior. 16/06/2004 08:43:19 CONSULTA DE FICHEROS CONSULTA DE TRAZA EDITRAN 4.1 SESION TRAZA...: S00DI S00TI EDITX1 FECHA SSAAMMDD.: 20040616 HORA HHMMSS....: 083258 ENTRADA/SALIDA.: E ....+....1....+....2....+....3....+....4....+....5....+....6....+....7.... C5E3E7400B00000EF300FD00000000000000000000D70000000000000000000FC0A3300000 9999304544495458310A000000000000000000000000000000000000000000000000404040 40404040404040404040404040404040404040404040404040404040404040404040404040 404040404040404040F1F7F24BF0F2F24BF1F6F44BF0F7F60A00000031713283020A000000 31513625070000000000000000000000000000000000000000000000000000169481848199 99938197819394814B89958499814B40404040404040404040404040404040404040404040 40404040404040404040404040404040404040404040404040404040404040404040404040 01B34040400000404040F0F8F3F2F5F8404040404040 PF2: SWITCH HEXADECIMAL - CARACTER Si pulsamos pf2, se visualiza en mensaje en formato texto y además se incluye información sobre la hora real de proceso (no tiene porqué ser la misma que la de la traza) y sobre la longitud del mensaje tratado (no tiene porqué ser el mismo que el que está en red). 16/06/2004 08:53:06 CONSULTA DE FICHEROS CONSULTA DE TRAZA SESION TRAZA...: S00DI S00TI EDITX1 FECHA SSAAMMDD.: 20040616 HORA HHMMSS....: 083258 EDITRAN 4.1 ENTRADA/SALIDA.: E ....+....1....+....2....+....3....+....4....+....5....+....6....+....7.... ETX . .3 . P .{t. rr........ 172.022.164.076. ...c.. ..... .madarrlapalma.indra. .. Indra. Todos derechos reservados 083258 ETX41USIC.doc 04/06/2007 Pag .2-5 Manual de Instalación y usuario HORA DE PROCESO DE MENSAJE : 083258 LONGITUD DE MENSAJE TRATADO: 000435 PF2: SWITCH HEXADECIMAL - CARACTER Para trazas de más detalle de INDRA, codificar sistema-operativo = EDTX, versión-sistema-operativo = spaces ó MULT, y Número-cvcs-máximos = 999. En este caso, se crean cola ts ZTBPEDTX (MULT) ó colas TS ZTBH+(MMSS, minuto y segundo), con datos sobre escrituras y lecturas de la red, a ser analizados por INDRA. 2.3. BACKUP. El sistema de backup, en caso de que falle una llamada es el siguiente: Dir-ip-remota (1) + Nri-local (1) – Nri-remoto (1). Dir-ip-remota (1) + Nri-local (1) – Nri-remoto (2). Dir-ip-remota (1) + Nri-local (1) – Nri-remoto (3). Dir-ip-remota (2) + Nri-local (2) – Nri-remoto (1). Dir-ip-remota (2) + Nri-local (2) – Nri-remoto (2). Dir-ip-remota (2) + Nri-local (2) – Nri-remoto (3). Dir-ip-remota (3) + Nri-local (3) – Nri-remoto (1). Dir-ip-remota (3) + Nri-local (3) – Nri-remoto (2). Dir-ip-remota (3) + Nri-local (3) – Nri-remoto (3). 2.4. Mensajes de error x’20’ y liberación x’13’ Consulte el manual IP41USIC. Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .2-6 Manual de Instalación y usuario 3. EDItran/TX EN UNIX Y WINDOWS Los elementos necesarios para el correcto funcionamiento del sistema EDItran/TX en los entornos UNIX-WINDOWS son: • Adaptador y Software X25 instalado y configurado. Este paso es distinto dependiendo del entorno de trabajo. En el manual EDItran 4.1 Manual de Instalación UNIX, WINDOWS se describen los requisitos y ejemplos de configuración para cada entorno soportado. • Protocolo TCP/IP instalado. • Software EDItran/TX instalado y con licencia de uso. 3.1. Instalación de EDItran/TX en UNIX En los entornos UNIX el Software EDItran/TX se distribuye como un fichero tar comprimido con GNU Zip. Por ejemplo, si se ha recibido el fichero editx.sparc-sunsolaris2.6.V413-2003-06-24.tar.gz deberá ejecutar lo siguiente: gunzip editx.sparc-sun-solaris2.6.V413-2003-06-24.tar.gz tar –xf editx.sparc-sun-solaris2.6.V413-2003-06-24.tar 3.2. Instalación de EDItran/TX en WINDOWS En Windows se proporciona un programa de instalación. Para llevar a cabo la instalación se debe seleccionar el botón de INICIO y al desplegarse el menú elegir la opción Ejecutar. Si la unidad donde se encuentra el producto para instalar fuera “E:”, teclee lo siguiente: E:\EDItranTX413.exe Siga las instrucciones que vayan apareciendo por la pantalla. 3.3. Configuración de EDItran/TX WINDOWS En el mismo proceso de instalación se deben indicar las direcciones IP locales y puertos de escucha, las direcciones de X.25 y la dirección IP del CICS y puerto de escucha, también se indica el modelo de tarjeta X.25, SAGEM o EICON. 3.4. Arranque y parada WINDOWS En el menú de inicio elegir programas y aparece la opción EDItranTX Windows 413, ejecutando dicha opción da la posibilidad de Arrancar EDItranTX, Parar EDItranTX y documentación de EDItranTX. Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag 3-1 Manual de Instalación y usuario 3.5. Configuración de EDItran/TX UNIX Una vez instalado es necesario establecer algunos parámetros necesarios para el funcionamiento de la pasarela. Para ello se proporciona el siguiente comando que hay que ejecutar antes de arrancar el sistema por primera vez. Uso: TxCfg –ip <ip1> [<ip2> <ip3>] –nri <nri1> [<nri2> <nri3>] Siendo: -ip: Direcciones IP locales. -nri: NRIs locales. Con la opción –ip se establecen hasta tres direcciones IP y puertos de escucha. Con la opción –nri se establecen hasta tres direcciones X25 locales. Por ejemplo, TxCfg –ip 172.25.145.80:7888 172.25.145.80:7889 –nri 312456789 configura la pasarela para escuchar en TCP por la dirección 172.25.145.80 y dos puertos distintos 7888 y 7889 y por X25 aceptará las llamadas que lleguen al NRI 312456789. Además, es necesario tener definida como variable de entorno IP_ROUTE_TX que establece la dirección y puerto IP del HOST. 3.6. Arranque y parada UNIX Para arrancar y parar EDItran/TX ejecute EdiTX start y EdiTX stop. En los entornos Windows también se puede establecer el valor de la variable IP_ROUTE_TX al arrancar mediante la opción –h del comando EdiTX. Si por ejemplo el EDItran/TX del Host tiene como IP de escucha 156.122.34.12 y puerto 8888 debería ejecutar EdiTx start –h156.122.34.12:8888 En los entornos UNIX EdiTX es el script que se lista a continuación. Se recomienda definir la variable IP_ROUTE_TX en este script descomentando la línea adecuada y asignandola el valor que proceda. #!/bin/sh ################# #SUN, DEC y LINUX LD_LIBRARY_PATH=`pwd`:$LD_LIBRARY_PATH export LD_LIBRARY_PATH ################# #AIX LIBPATH=`pwd` export LIBPATH ################# #HP SHLIB_PATH=`pwd` export SHLIB_PATH Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .3-2 Manual de Instalación y usuario #export X25_IFNAME_A=NXL0 #export X25_IFNAME_B=NXL1 ################# #DEC DTE CLASS DEFINITION #X25_DTE_CLASS_A=llc2-class-a #export X25_DTE_CLASS_A #X25_DTE_CLASS_B=llc2-class-b #export X25_DTE_CLASS_B ################# #IP_ROUTE_TX DEFINITION #IP_ROUTE_TX=IP:PUERTO HOST #export IP_ROUTE_TX PROC_STAR="editrantx editcp edix25" PROC_STOP="editrantx editcp edix25" N=`tput rmso` B=`tput smso` if ps -ef > /dev/null 2>&1; then PS="ps -ef" else PS="ps -x" fi # arranque del proceso dado startproc() { if [ -f $1 ]; then echo '*** Arranque ***' - $USER - `date` >>$1.out if [ ! -z "$traza" ] ; then EDI_DEBUG=$1.traza else EDI_DEBUG= fi $1 >> $1.out 2>&1 & sleep 8 pid=`$PS | grep $! | grep $1 | grep -v grep | awk '{print $2}'` if [ "$pid" != "" ] ; then echo "\tProceso $1 arrancado." return 0 else echo "\tProceso $1 NO ARRANCADO." return 1 fi fi } # parada del proceso dado stopproc() { pid=`$PS | grep $1 | grep -v grep | awk '{print $2}'` Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .3-3 Manual de Instalación y usuario if [ "$pid" != "" ] ; then kill -2 $pid > /dev/null 2>&1 if [ $? = 0 ] ; then echo "\tProceso $1 detenido." return 0 else echo "\tProceso $1 NO DETENIDO." return 1 fi else echo "\tProceso $1 no encontrado." fi sleep 4 } # estado del proceso dado statusproc() { pid=`$PS | grep $1 | grep -v grep | awk '{print $2}'` if [ "$pid" != "" ] ; then return 0 else return 1 fi } ################################## traza= force= while getopts tf opcion do case $opcion in t) traza=1 ;; f) force=1 ;; \?) printf "Opcion invalida\n" ;; esac done shift `expr $OPTIND - 1` case $1 in 'start') echo "Arrancando sistema EDItran/TX..." if [ -z "$force" ] ; then statusproc editrantx if [ $? = 0 ]; then echo "${B}Hay otro sistema EDItran/TX arrancado${N}." exit 1 fi fi for PROCESO in $PROC_STAR; do startproc $PROCESO done; statusproc editrantx Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .3-4 Manual de Instalación y usuario if [ $? = 0 ]; then echo "Sistema EDItran/TX arrancado." exit 0 else echo "${B}Sistema EDItran/TX NO ARRANCADO${N}." exit 1 fi ;; 'stop') echo "Deteniendo sistema EDItran/TX..." for PROCESO in $PROC_STOP; do stopproc $PROCESO done; statusproc editrantx if [ $? = 0 ]; then echo "${B}Sistema EDItran/TX NO DETENIDO${N}." exit 0 else echo "Sistema EDItran/TX detenido." exit 1 fi ;; 'status') echo "Estado sistema EDItran/TX..." statusproc editrantx if [ $? = 0 ]; then echo "${B}Sistema EDItran/TX arrancado${N}." exit 0 else echo "Sistema EDItran/TX detenido." exit 1 fi exit 0 ;; *) printf "Usage: %s [-t] [-f] start|stop|status\n" $0 printf "\t-t\t Traza\n" printf "\t-f\t Ignora otro EDItran/TX arrancado\n" printf "\tstart\t Arranca el sistema EDItran/TX\n" printf "\tstop\t Detiene el sistema EDItran/TX\n" printf "\tstatus\t Obtiene el estado del sistema EDItran/TX\n" exit 1 ;; esac Indra. Todos derechos reservados ETX41USIC.doc 04/06/2007 Pag .3-5 . BARCELONA Avda. Diagonal, 218, 3º 08018 BARCELONA BILBAO Henao, 4, 4ºA 48001 BILBAO MADRID Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas 28108 MADRID SEVILLA Avda. San Francisco Javier, 22, 6º 41018 SEVILLA VALENCIA Colón, 60 46004 VALENCIA