Configuración

comunicaciones Pos/Vitatest

17/11/2010
Informática hites
Sub Gerencia Operaciones
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 2 de 11

Comercio Adherido

Contenido

1. Objetivo.....................................................................................................................................3

2. Alcance.....................................................................................................................................3

2. Descripción...............................................................................................................................3

4. Flujo de la transacción............................................................................................................6

5. Configuración Vitates..............................................................................................................7

6. Configuración POS..................................................................................................................8

7. Glosario.....................................................................................................................................8
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 3 de 11

Comercio Adherido

1. Objetivo

Documentar toda la información referente a la configuración de comunicaciones y

parámetros en los equipos para realizar QA de POS sobre el equipo vitatest.

2. Alcance

Aplica a las configuraciones de comunicaciones POS (servidor) a la maquina iseries

vitatest y las configuraciones propias de comunicaciones para locales

3. Descripción

Para definir las estructuras de comunicaciones de un ambiente de tienda se deben tener

claro los conceptos que en ella se utilizan.

Comercio adherido:
Los comercios se conectan a nuestros sistemas a través de socket y lo único que se
chequea es que la trama que se está recibiendo sea acorde con las estructuras definidas
para esta comunicación (se encuentra en el manual de mensajería para comercios).
En este caso el programa autorizador también cumple las funciones de decodificador, por
lo tanto, en el caso de comercio adherido solo se tiene autorizador y un programa
actualizador (no existe decodificador como tal).
Las transacciones una vez ingresadas al sistema tienen el mismo tratamiento que una
transacción de tiendas hites.
El subsistema donde quedan las comunicaciones de comercio es COMUNICA

Tiendas hites
Los POS para interactuar con el sistema central Iseries deben realizarlo a través de los
servidores de POS existentes en cada local, para esto en cada POS se configuran las ip’s
tanto del servidor primario como secundario (si existe)

Cada servidor es independiente y tiene un juego de programas de comunicaciones

particular para él, por lo cual, en cada servidor se deben identificar en los programas los
socket a utilizar del sistema central.

Para identificar el sokect que le corresponde asignar se utiliza la siguiente nomenclatura.

Puerto XYYZ donde:

X: identifica si es primario o secundario (4: primario, 5: secundario)
YY: Numero de local
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 4 de 11

Comercio Adherido

Z: Servicio (1: query, 4:TSL, 6: Autorizador)

Si consideramos el local de Puente 696 (local 01) sus puertos a configurar sobre el
servidor primario son

Query: 4011
Tsl : 4014
Autorizador: 4016

Una vez que la transacción llega al Iseries pasa por 3 etapas

Entrada: Evento en el cual se recibe una Transacción en el socket y se graba en el hosdato
asignado al servidor del local y se graba en la cola comunicxx (donde xx es un correlativo
asignado a ese servidor).

Decodificación: Evento donde el programa decodificador lee la cola cominicxx y separa las
transacción en ventas y pagos, esta acción incluye grabar los datos en los archivos
respectivos y en las colas de datos (como entrada) que leen los actualizadores

Actualización: Evento donde se produce la actualización del registro cambiando su estado

en los archivos respectivos y grabando la transacción sobre las bases maestras.

Para poder saber que levantar se ordenaron por local las colas asignadas al igual que las
comunicaciones a utilizar.
La información de los socket del TSL y hosdato a usar esta dentro de los programas cl’s
que levantan los servicios.

A continuación se muestran los extractos de los programas que suben las comunicaciones,
nótese que la variable &servicio contiene el puerto del socket

Para el TSL
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 5 de 11

Comercio Adherido

Para el query

Para el autorizador

En el caso del TSL el programa tiene una tabla para asignar la cola de datos respectiva,
en el caso de puente 696 para su servidor primario es 03, por lo cual la cola a utilizar es
comunic03.

El siguiente paso es el decodificador donde el programa DECODTSL tiene la misma lógica,

a través de la variable “store number” asigna las colas de datos tanto de lectura como de
escritura.
En el paso anterior el TSL grabo en la comunic03 por lo cual al pasar “store number” = 03
el deco leerá de la cola comunic3 y grabara en las colas colavta03 y colatra03.

Finalmente los actualizadores de pagos y ventas mantienen la misma lógica por lo cual
leerán de las colas de ventas y pagos asociados a su store number.

Por arquitectura de seguridad se definió que cada local tenga 2 servidores, por lo cual se
definieron 2 grupos de programas de comunicaciones (autorizador, query y tsl) dos
decodificadores y un solo programa para actualizar ya sea pagos o ventas por local, en
otras palabras los tsl de cada servidor graban en sus colas particulares, existe un
decodificador para cada cola comunicxx pero los decodificadores del mismo local graban
en la misma cola de ventas (colavtaxx) y en la misma cola de pagos (colatraxx) para ser
leídas por un único actualizador de pagos o un único actualizador de ventas para el local.

Cada paso no solo graba colas, también graba información en los archivos ya sean diarios
o históricos, pero no son críticos para explicar el flujo de la comunicación

Como medio de seguridad en cada paso se graba adicional a la cola indicada, cola auxiliar
con el mismo nombre que la cola principal pero con una extensión AUX en caso de
reproceso.

Tanto el decodificador como los actualizadores leen esta cola antes que la principal, asi en
caso de caída lo primero que realiza el programa es procesar toda la información de la cola
auxiliar, por esta razón es importante crear diariamente las colas de datos.
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 6 de 11

Comercio Adherido

Como se indicó, las colas son estructuras diarias (se borran todos los días)

Como en los locales existe 2 servidores (en el caso de alameda son 3) no se puede utilizar
el mismo “store number” o numero de local, por lo cual esta variable quedo como número
de referencia y se asigna a razón del número correlativo que está disponible para su uso.

La utilización de una estructura de comunicaciones u otra no afecta a la información que

viaja, es decir, se puede mandar la información de la tienda alameda utilizando los
programas de comunicación que habitualmente se usan para Osorno y el resultado es el
mismo, la única restricción es que dos servidores no pueden usar los mismos socket.

En el caso de vitates se decidió usar los programas de comunicación y actualización del

local 01, llamado puente 696 con store number 03.

El local de pruebas asignado al servidor de POS y las cajas es independiente a las

comunicaciones.

4. Flujo de una transacción

Para saber como chequear cada etapa del flujo de una transacción se indican los tip’s en
cada paso que realiza:

POS
1.- Genera la transacción, en este caso en el servidor de pos existe un log de todas las
transacciones de todos los POS, si no está aquí la transacción la caja está fuera de línea.

Servidor POS
2.- El servidor envía las transacciones al iseries en este caso genera un log en el
programa TSL, si no está en este log no fue enviado al Iseries.
Si está en el log y no está en el siguiente paso, hay un problema en las comunicaciones.

Iseries
3.- El programa TSL conversa con su equivalente del servidor de pos, en este caso junto
con grabar en la cola comunic la transacción es grabada en el archivo hosdato
correspondiente al servidor de pos.
Si no está en el hosdato no llego la transacción al Iseries.
4.- Decodificador, el programa lee la cola comunic y graba en la cola colavta o colatra
según corresponda, pero adicionalmente graba el registro de venta en el archivo Ivtaca2 y
el registro de pago en el archivo Ipgoca2, en ambos casos el registro en su campo estado
queda con valor 0 (cero).
Si existe el registro y estado = 0, el registro fue decodificado pero aun no actualizado
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 7 de 11

Comercio Adherido

5.- Actualizadores, los programas actualizadores leen sus colas respectivas y cambian el
valor del registro del archivo (ivtaca2 o ipgoca2) en su campo estado a distinto de 0 (cero),
Si el campo estado es distinto de cero el ciclo está completo.

El análisis parte a la inversa de la transacción, primero se ve si esta actualizado,luego si el

registro fue decodificado y así hacia atrás hasta que se encuentre donde esta el problema.
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 8 de 11

Comercio Adherido

5. Configuracion Vitates
En vitates deben existir los siguientes programas en sus respectivos subsistemas.
Servicios de comunicación Comercio adherido, cada uno es independiente entre sí, los
puertos (socket) asignados son el 4700 y el 4701

Servicios de comunicación POS laboratorio Vitatest, los puertos (socket) asignados se

pueden ver en el nombre del trabajo (ej. 4246)

Servicio de Decodificador, Actualizadores, podemos observar el actualizador de comercio,

actualizador de cheques, actualizadores manuales, actualizadores “vita” que corresponden
a las comunicaciones utilizadas (local 01), actualizador de seguros y finalmente
decodificador.
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 9 de 11

Comercio Adherido

6. Configuracion POS
Los archivos involucrados en la configuración a nivel de servidor de pos son:

Autorizador.ini, en este archivo están definidas las configuración de los socket del autorizador y
del query (ip del Iseries y número de puerto)

Extracto del archivo

Tsl.ini, en este archivo están definidas las configuraciones del socket del TSL
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 10 de 11

Comercio Adherido

A nivel del servidor existen servicios que tomando estos dos archivos (.ini), levantan entre otros
las comunicaciones hacia el Iseries

Los servicios que deben estar activos son:

De todos estos servicios los que afectan las comunicaciones son rspauto y rspdcol.
 Código:
SUB GERENCIA OPERACIONES Fecha: 12/05/11
Arquitectura y Administración de sistemas Página 11 de 11

Comercio Adherido

7. Glosario

Store number: Originalmente estaba asociado al número de tienda, hoy se refiere al

número que identifica algunos programas de comunicaciones y su relación con los
servidores de tienda.

Numero Local: Número por el cual se conoce la tienda

Cola de datos: estructura dentro del Iseries que permite grabar información como si fuera
una pila y permite una lectura secuencial (en este caso fifo), estas estructuras permiten
que el programa que las utiliza este sobre ella a la espera de que “se grabe” un registro
nuevo, mientras no ocurra el programa no consume recursos.

Socket: puerto de un servidor en el cual hay un programa a la espera de una transacción.

Autorizador: programa (tipo socket) que permite la autorización de una transacción de

venta o pago.

Query: programa (tipo socket) que permite realizar consultas desde los servidores de POS
al servidor central

TSL: Programa (tipo socket) que permite transmitir las transacciones validas desde el
servidor de POS al servidor central Iseries.

Decodificador: programa que recibe una trama desde el TSL y decide que tipo de
transacción es (venta o pago) y la manda a las colas de actualización respectivas.

Actualizador: Programa que actualiza las transacciones decodificadas..