EDItran TX 4.1. IMS (Windows-UNIX) Manual de instalación y usuario. Indra. Julio ETX41USII.doc.

EDItran TX 4.1

IMS (Windows-UNIX)

Manual de instalación y usuario.

Indra.

Julio

- 2003.

ETX41USII.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 IMS

Manual de instalación y usuario.

Referencia: ETX41USII.doc

Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas.

28108 MADRID.

_______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________

Empresa

: ____________________________________________________________________________________

Departamento

: ____________________________________________________________________________________

Contacto

: ____________________________________________________________________________________

Dirección

: ____________________________________________________________________________________

Manual de Instalación y usuario

Indice

Indra. Todos derechos reservados ETX41USII.doc 02/02/2006 Pag. I-1

1.

INTRODUCCION Y REQUERIMIENTOS. ...1-1

2.

DEFINICIONES Y CAMBIOS (OS/390 – Z/OS). ...2-1

3.

EDITRAN/TX EN UNIX Y WINDOWS ...3-1

3.1.

INSTALACIÓN DE EDITRAN/TX EN UNIX ...3-1

3.2.

INSTALACIÓN DE EDITRAN/TX EN WINDOWS...3-1

3.3.

CONFIGURACIÓN DE EDITRAN/TX WINDOWS ...3-1

3.4.

ARRANQUE Y PARADA WINDOWS...3-1

3.5.

CONFIGURACIÓN DE EDITRAN/TX UNIX ...3-2

3.6.

ARRANQUE Y PARADA UNIX ...3-2

EDItran TX 4.1 IMS.

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 IMS, éste, proporciona a PASARELA UNIX-WINDOWS información

x25 necesaria para esa conexión.

• En llamadas entrantes al IMS, 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 IMS quiere enviar un dato 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 IMS 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 continúa

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 (IMS) hacia remotos x25, sin necesidad de disponer de

una 3745, de forma que sea para esos remotos un proceso transparente. Para ello, desde el

EDItran TX 4.1 IMS.

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 (IMS). Para ello, dichos

remotos se conectan vía x25 a un windows-unix, y éste se engancha vía ip al host (IMS), 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 (IMS) a las máquinas unix-windows.

4.- Software EDItran/TX para IMS.

Pasarela 1-n

_X25

TCP/IP LAN EDItran EDItran TCP/IP WAN PAD

Pasarela remota

EDItran

EDItran

Manual de Instalación y usuario

2.

DEFINICIONES Y CAMBIOS (OS/390 – Z/OS).

Se requiere la misma instalación que para EDItran/TCP. Las definiciones están

descritas en el manual Interfaz TCP/IP 4.1. Manual de instalación y usuario (

IP41USII

)

Los parámetros afectados de los perfiles de EDItran/P se enumeran en el citado

manual y están descritos en el manual de usuario de EDItran/P (

EP41USUI

).

En la consulta de la traza se han introducido nuevos mensajes para las sesiones que

utilizan la pasarela, que incluyen mensajes de TCP/IP y mensajes de X25.

Manual de Instalación y usuario

31/03/05 CONSULTA DE LA TRAZA EDITRAN 15:34:17 4.1 SESION FECHA HORA S CLA C NSM COMENTARIO --- --- --- - --- - --- --- 000000000000000000000000 30-03 15:23:41 E CON 1 INDICACION CONEXION TCP 000099930000099980TELEGC 30-03 15:23:41 E TAK 1 ACEPTA CONEX. TCP-X25 000099930000099980TELEGC 30-03 15:23:41 E X25 0B 000099930000099980TELEGC 30-03 15:23:41 S X25 0F 000099930000099980TELEGC 30-03 15:23:41 S X00 INDICACION CONEXION 000099930000099980TELEGC 30-03 15:23:42 E X00 INDICACION CONEXION 000099930000099980TELEGC 30-03 15:24:09 E SAP PETICION SESION REMOTA 000099930000099980TELEGC 30-03 15:24:09 S SAR ACEPTACION PET. SESION 000099930000099980TELEGC 30-03 15:24:13 E SCP 0 0 PETICION DE RECEPCION 000099930000099980TELEGC 30-03 15:24:13 S A2P SOLICITA PREVIO RECEPC. 000099930000099980TELEGC 30-03 15:24:13 S SDR 3 0 FICH.INCORRECTO EN RECEP 000099930000099980TELEGC 30-03 15:24:13 S EAB PETICION FIN DE SESION 000099930000099980TELEGC 30-03 15:24:13 E EAB PETICION FIN DE SESION 000099930000099980TELEGC 30-03 15:24:13 S SAB LIBERACION DE APLICACION 000099930000099980TELEGC 30-03 15:24:13 S E11 PETICION LIBERACION 000099930000099980TELEGC 30-03 15:24:15 E E11 PETICION LIBERACION

31/03/05 CONSULTA DE LA TRAZA EDITRAN 15:35:32 4.1 SESION FECHA HORA S CLA C NSM COMENTARIO --- --- --- - --- - --- --- 000099930000099980TELEGC 30-03 15:21:21 S E00 PETICION DE CONEXION 000099930000099980TELEGC 30-03 15:21:21 E E00 PETICION DE CONEXION 000099930000099980TELEGC 30-03 15:21:21 S SOC 1 PETICION CONEXION TCP 000099930000099980TELEGC 30-03 15:21:21 S CON 1 PETICION CONEXION TCP 000099930000099980TELEGC 30-03 15:21:21 S X25 0B 000099930000099980TELEGC 30-03 15:21:23 S X11 INDICACION LIBERACION 000099930000099980TELEGC 30-03 15:21:24 E X11 INDICACION LIBERACION 000099930000099980TELEGC 30-03 15:21:41 E X25 0F 000099930000099980TELEGC 30-03 15:21:41 S X00 INDICACION CONEXION 000099930000099980TELEGC 30-03 15:21:41 E X00 INDICACION CONEXION 000099930000099980TELEGC 30-03 15:21:42 S SAP PETICION SESION 000099930000099980TELEGC 30-03 15:21:45 E SAR ACEPTACION PET. SESION 000099930000099980TELEGC 30-03 15:21:45 S SCP 0 0 PET. INICIO DE EMISION 000099930000099980TELEGC 30-03 15:21:49 E SDR 3 0 FICH.INCORRECTO EN EMIS. 000099930000099980TELEGC 30-03 15:21:49 S A7I INFORMATIVO A LA APLICA. 000099930000099980TELEGC 30-03 15:21:49 S EAB PETICION FIN DE SESION

Los mensajes de la red X25 se incluyen con la clave ‘X25’ y son similares a los

mensajes XAI y GAT de las interfaces de conexión ISAR o NPSI/GATE para X25.

En la consulta expandida puede verse el contenido completo de los mensajes X25 que

se intercambian entre EDItran IMS y la Pasarela UNIX-Windows.

Manual de Instalación y usuario

--- | 31/03/05 GESTOR DEL EDITRAN EDITRAN | | 15:48:02 CONSULTA DE LA TRAZA 4.1 | --- | | | CODIGO LOCAL: CODIGO REMOTO: APLICACION: | | | | 30/03/2005 15:23:41.24 000099930000099980TELEGC E X25 | | 430B000FB0A330000099983054454C4547430A0000000000000000000000 | | 0000000000000000000A00000031713283030A0000003151362514000000 | | | | | | | | 30/03/2005 15:23:41.25 000099930000099980TELEGC S X25 | | 130F00000000000000000000000000000000000000000000000000000000 | | 000000000000000000000000000000000000000000000000000000000000 | | | | | | | | | | | | | | | ---

En el mensaje de solicitud de llamada ‘0B’ tenemos

43

· que es la longitud del mensaje en hexadecimal

0B

es el tipo de mensaje X25 (solicitud de llamada)

000F

indica la longitud de datos de usuario

B0A330000099983054454C4547430A

son los datos de usuario

0A0000003171328303

es la longitud, en hexadecimal, y el nri llamante

0A0000003151362514

es el nri llamado.

.

La indicación de llamada entrante (0B) es idéntica a la solicitud de llamada

El mensaje de aceptación de llamada, o de llamada aceptada (0F) sólo incluye,

generalmente, la longitud y el código de mensaje. En ocasiones pueden aparecer datos de

parámetros negociados

130F00000000000000000000000000000000000000

Las indicaciones de liberación o las peticiones de liberación (13) están compuestas de

longitud, tipo de mensaje y causa y diagnóstico de liberación. La causa y diagnóstico se

corresponde con los códigos estándar de X25.

0313497F

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-sun-solaris2.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.

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

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}'`

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

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

.

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