APÉNDICE A

COMANDOS DEL PROTOCOLO DE COMUNICACIONES

A.1 - Características del canal serie.

 La comunicación PMS - PC interfaz se hace por canal serie tipo RS-232 configurado de
la siguiente manera :

Caracteres de 8 bits (ASCII)

full-duplex
1 start-bit
2 stop-bits
sin paridad
a 1200, 2400, 4800 o 9600 baudios

Todos los caracteres que viajan por dicho canal serie son caracteres ASCII.

La comunicación PMS - PC interfaz se compone de dos partes importantes : el mensaje útil

(text) y su soporte (envelop).

 E l cableado

Es suficiente con cablear 3 puntos : Recepción, Transmisión y Común.

PMS PC Interfaz

2 ------------------------------------------ 3 RX

3 ------------------------------------------ 2 TX

7 ------------------------------------------ 7 (común)

 En los conectores de 9 puntos el común es el punto 5, TX = 3, RX=2

El programa del PC interfaz no precisa de las señales de control de RS-232 (RTS, CTS,
DSR, DTR, ...).
Si la rutina de comunicaciones del PMS no se puede ajustar de manera que funcione sin
exigir los niveles adecuados en estas señales de control, estos niveles deberán ser
físicamente forzados (generalmente puntos 5,6 y 20 unidos).
A.2 - Soporte de la comunicación (envelop)

El protocolo para la transmisión usa los siguientes caracteres ASCII de control :

STX (02H) Principio de la transmisión del mensaje

ETX (03H) Final de la transmisión del mensaje
ACK (06H) Reconocimiento afirmativo
NAK (15H) Reconocimiento negativo (error de LRC)
ENQ (05H) Chequeo de comunicación (enquire)

El mensaje completo tiene el formato siguiente :

STX mensaje útil ETX LRC

 Cada trama debe terminar por un chequeo de redundancia longitudinal LRC

(longitudinal redundancy check). El LRC es el carácter resultante del OR exclusivo
(XOR) de todos los caracteres del mensaje útil más el carácter ETX. Se calcula con la
semilla NUL (00H).

 Si se desea prescindir del LRC enviar en su lugar el carácter ASCII 13 (return). El PC

interfaz lo tomará siempre como un LRC correcto.

 Los caracteres de control ACK y NAK son trasmitidos por el PC interfaz para indicar el
reconocimiento afirmativo o negativo.

 El PC interfaz contesta NAK si no está aún preparado para recibir un nuevo mensaje o el
mensaje recibido es erróneo (con error de LRC).

 Si el PMS recibe NAK deberá repetir el mensaje hasta que reciba ACK por parte del PC
interfaz.

 El PMS puede mandar ENQ para conocer el estado del PC interfaz. Este contestará ACK
si está libre.
 Véase a continuación un ejemplo de comunicaciones:

PMS : PC interfaz :

STX mensaje útil ETX LRC

NAK
ENQ
ACK
STX mensaje útil ETX LRC
ACK
.
. (tarea en proceso)
.
STX resultado tarea ETX LRC

El programa del PMS debe cumplir con los siguientes requisitos:

1. Calcular el LRC de los caracteres posteriores al STX incluido el ETX o remplazarlo por
un return (carácter 13).

2. No mandar un nuevo mensaje hasta recibir el reconocimiento afirmativo del mensaje

anterior (ACK).

3. Si al cabo de dos segundos no recibiese un reconocimiento afirmativo el PMS debe

tomar las disposiciones pertinentes ya que se ha cortado la comunicación con el PC
interfaz.

4. Mostrar en la pantalla del terminal correspondiente los mensajes correspondientes a cada

operación para guiar al operario.

5. En caso de utilizar un grabador/lector de pasada indicar al operario que debe pasar la

tarjeta una segunda vez para comprobación después de cada grabación.

6. Los grabadores/lectores disponen de indicaciones luminosas en su parte frontal que

varían según la fase de la operación.
El PC interfaz cumple con los siguientes requisitos :

1. Chequea el LRC para comprobar la integridad del mensaje recibido.

2. Contestar ACK o NAK antes de ejecutar el mensaje recibido.

3. Contestar NAK si el LRC del mensaje recibido es incorrecto.

4. Mantiene la tarea hasta la ejecución o hasta que el PMS la anula.

A.3 - Descripción del mensaje útil.

El mensaje útil se compone de dos partes :

1. un comando

2. parámetros del comando.

Cada campo va delimitado por separadores. El separador de campos es el carácter

ASCII B3H (179) (representado como | en este documento).
Ojo : Se interpretará como vacío un campo con solo uno o varios espacios.

COMANDO OPERACIÓN

CN(x) Para grabar una tarjeta para un cliente nuevo. Esta tarjeta anulará
automáticamente la tarjeta del cliente anterior.

CC(x) Para grabar una copia para la persona que comparte la habitación.

X toma valores de 1 a 9 para grabar x tarjetas de una misma habitación con

una sola petición desde el PMS. Los comandos CN1 y CC1 Se comportan
como los CN y CC que siguen vigentes en esta versión.

CO Check-Out de un cliente. Todas las tarjetas de cliente de la habitación

correspondiente son dadas de baja.

CA Grabación de una tarjeta de apertura única. Las tarjetas de apertura única

solo son válidas en las cerraduras de habitación. Quedan anuladas al cambiar
de cliente o al ser utilizadas una vez.
EX Anula una tarea y expulsa la tarjeta si ha quedado retenida dentro del
grabador en una operación anterior.

LT Lectura e interpretación de los datos grabados en pista 3 según normas

ONITY.
 P1 Grabación de información en la pista 1 de la tarjeta magnética siguiendo
estrictamente las normas ISO de pista 1.

P2 Grabación de información en la pista 2 de la tarjeta magnética siguiendo

estrictamente las normas ISO de pista 2.

P3 Grabación de información en la pista 3 de la tarjeta magnética siguiendo

estrictamente las normas ISO de pista 3.

L1 Lectura de la información escrita en la pista 1 de la tarjeta magnética

siguiendo estrictamente las normas ISO de pista 1.

L2 Lectura de la información escrita en la pista 2 de la tarjeta magnética

siguiendo estrictamente las normas ISO de pista 2.

L3 Lectura de la información escrita en la pista 3 de la tarjeta magnética

siguiendo estrictamente las normas ISO de pista 3.

 El PC interfaz del sistema ONITY-HT24 confirmará que la operación se ha llevado a

cabo con éxito trasmitiendo el mismo comando recibido y el número de grabador
correspondiente. El formato y número de caracteres del campo "número de grabador" se
respeta en la contestación del PC interfaz.

 La grabación y lectura en pistas 1 y 2 solo es realizable en grabadores/lectores

motorizados.
A.4 - Parámetros de comandos.

A.4.1 - Parámetros de los comandos CN(x), CC(x) y CA

TRECE parámetros como máximo :

1 Número del grabador donde se desea grabar la tarjeta.

2 Retención o expulsión de la tarjeta.
3 Habitación otorgada nº 1. (habitación principal)
4 Habitación otorgada nº 2.
5 Habitación otorgada nº 3.
6 Habitación otorgada nº 4.
7 Autorizaciones otorgadas al cliente.
8 Autorizaciones denegadas al cliente.
9 Fecha de inicio de la tarjeta.
10 Fecha de caducidad de la tarjeta.
11 Datos del operario que graba la tarjeta.
12 Mensaje a grabar en pista 1 según normas ISO.
13 Mensaje a grabar en pista 2 según normas ISO

Importante: El mensaje útil debe contener al menos los tres primeros parámetros. Los
demás parámetros son opcionales.
Si se prescinde de algunos parámetros hay que poner sus campos
correspondientes vacíos hasta llegar al último parámetro no omitido.

Parámetro nº 1 : Número del grabador

Véase en la lista de periféricos del programa HT24 el número otorgado a cada grabador.

Parámetro nº 2 : Expulsión o retención de tarjeta

Al acabar la operación de grabación, la tarjeta puede quedar retenida dentro del grabador
para otras operaciones o ser expulsada.

E : expulsión.
R : retención.
T : expulsión por la parte trasera.
Parámetros nº 3,4,5 y 6 : Habitaciones

Habitaciones que debe de abrir la tarjeta.

El comando CA (tarjeta de apertura única) solo toma en cuenta la primera habitación ya

que el sistema no contempla la posibilidad de editar tarjetas de apertura única para más de
una habitación.

Si el grabador/lector involucrado en la grabación de la tarjeta es un grabador/lector de

pasada se aconseja no grabar tarjetas múltiples de 4 habitaciones.

Parámetro nº 7 : Autorizaciones concedidas

(Máximo 8 autorizaciones)
Mencionar los números de autorizaciones que se otorgan al cliente.

El comando CA (tarjeta de apertura única) no toma en cuenta este campo ya que las tarjetas
de apertura única tienen siempre denegadas todas las autorizaciones.

Parámetro nº 8 : Autorizaciones denegadas

(Máximo 8 autorizaciones)
Mencionar los números de autorizaciones que se deniegan al cliente.
El comando CA (tarjeta de apertura única) no toma en cuenta este campo ya que las tarjetas
de apertura única tienen siempre denegadas todas las autorizaciones.

Ejemplo para asignar/denegar autorizaciones:

Si queremos otorgar a un cliente el uso de la piscina y la caja fuerte (autorizaciones nº 3 y 6

respectivamente en el plan de cierre) y denegarle el uso de la sauna (autorización nº 5) los
campos serán:

|36|5|

 El número adjudicado a cada autorización y su valor por defecto varían según el hotel,
véase su plan de cierre.
Importante: Las autorizaciones que no se mencionen tomarán el valor preestablecido en
el plan de cierre.

Parámetro nº 9 : Fecha de inicio

Ocho caracteres en total : hora (00 a 23), día, mes y año.

Dos caracteres cada uno.

Por ejemplo :

|12100792|

indica que la tarjeta entrará en servicio a las 12 horas del 10 de Julio de 1992.

La omisión completa de este campo implica que la tarjeta puede entrar en servicio nada
más grabarla.

 No se permite la grabación de la fecha de inicio en las tarjetas múltiples de 4

habitaciones. Tal caso provocará el error ES (error de sintaxis).

Parámetro nº 10 : Fecha de caducidad

Fecha a partir de la cual la tarjeta dejará de ser válida. Mismo formato que la fecha de
inicio.

La omisión de este campo indica que la tarjeta no tiene límite en el tiempo.

La caducidad máxima alcanza hasta el 31 de Diciembre del próximo año.

 El sistema solo permite la grabación de una fecha de inicio en una tarjeta si también se
graba una fecha de caducidad. Si solo se pretende grabar una fecha de inicio el PC
interfaz contestará con el mensaje de error de sintaxis (ES).

 En cambio la fecha de caducidad no precisa de una fecha de inicio.

Parámetro nº 11 : Datos del operario

(Máximo 20 caracteres)
 El registro auditor del sistema HT24 registrará la operación de grabación de esta tarjeta a
nombre del operario inscrito en este campo.
La omisión completa de este campo implica que la operación será registrada bajo el nombre
de "PMS".

EJEMPLO:

Supongamos que se desea grabar en el grabador nº 1 una tarjeta de cliente nuevo con los
siguientes requisitos :

- Tarjeta expulsada al final de la grabación.

- Para las habitaciones 101 y 102.
- Garaje (autorización nº 6) otorgado.
- Sin fecha de inicio.
- Que caduque a las 12 horas del 14 de Enero de 1993.

El PMS deberá mandar el mensaje útil siguiente (debidamente integrado dentro de su

soporte) :

STX|CN|1|E|101|102| | |6| | |12140193| |ETXLRC

Obsérvese que los campos no utilizados van vacíos pero que sus separadores existen.

Si la operación se lleva a cabo sin errores el PC interfaz contestará al PMS con el mensaje:

STX|CN|1|ETXLRC

 Si se desea editar más de una tarjeta para la misma habitación la primera ha de ser una
tarjeta nueva (con el comando CN) para cancelar todas las tarjetas del cliente anterior y
luego grabar las demás tarjetas como copias (con el comando CC).

Parámetro nº 12 y 13 Grabación en pistas 1 y/o dos.

Los comandos CN, CN(X), CC, CC(X) y CA admiten dos campos más.
Los campos 12 y 13 solo deben contener el mensaje útil a grabar. El programa HT24 se
encarga de insertar los caracteres de principio y fin correspondientes a cada pista según
normas ISO y el carácter LRC.
Recuerden que los comandos P1 y P2 solo incluyen el LRC. El mensaje debe incluir los
caracteres de principio y de fin.
A.4.2 - Parámetros del comando CO

DOS parámetros:

1 Número de grabador (sin efecto)

2 Número de habitación

EJEMPLO:

Supongamos que queremos dar de baja la tarjeta de la habitación 101 (hacer el

Check-Out del cliente correspondiente).

El PMS deberá mandar el mensaje :

STX|CO|0|101|ETXLRC

Si la operación se lleva a cabo sin errores el Ordenador del sistema ONITY-HT24

contestará al PMS con el mensaje :

STX|CO|0|ETXLRC

 Puesto que el comando CO no hace caso del número de grabador porque ningún
grabador entra en juego, este número puede ser el 0 (cero).

A.4.3 - Parámetro del comando EX

Solamente el número de grabador.

El mensaje

STX|EX|1|ETXLRC

mandado por el PMS provocaría la expulsión de la tarjeta (si la hubiera) en el grabador nº 1

y anularía la tarea pendiente en el grabador nº 1.
Si la expulsión se llevase a cabo correctamente el ordenador ONITY-HT24 contestaría

STX|EX|1|ETXLRC

A.4.4 - Parámetros del comando LT

DOS parámetros.

1. Número del grabador/lector.

2. Expulsión, retención o expulsión trasera.

El PMS puede reconocer cualquier tarjeta del hotel pero solo identifica tarjetas válidas de
cliente.

Después de la orden de lectura de una tarjeta el PC interfaz contesta al PMS con uno entre
cuatro tipos de mensajes:

1.- Tarjeta reconocida e identificada.

2.- Tarjeta reconocida pero no identificada.
3.- Tarjeta no reconocida.
4.- Mensaje de error.

1.- Tarjeta reconocida e identificada

Solamente si es una tarjeta de cliente o apertura única.

La respuesta del PC interfaz después de la lectura repite el nombre del comando (LT) y el
nº del grabador/lector implicado más los siguientes campos:

Habitación nº 1 (principal) que abre la tarjeta.

Este campo nunca está vacío.

Habitación nº 2 que abre la tarjeta

o campo vacío.

Habitación nº 3 que abre la tarjeta

o campo vacío.

Habitación nº 4 que abre la tarjeta

o campo vacío.
 Tarjeta válida o previamente anulada por Check-Out.

CI : tarjeta con código válido de la habitación principal.

CO : tarjeta cuyo código de la habitación principal anulado por Check-Out.

Indicación de número de copia o tarjeta de apertura única (de la habitación principal).

0 : tarjeta original
1 : 1ª copia
2 : 2ª copia
3 : 3ª copia
4 : 4ª copia
I : copia indefinida (quinta o sucesivas)
A : tarjeta de apertura única.

Autorizaciones otorgadas.
Números (de 1 a 8) de las autorizaciones otorgadas a la tarjeta o campo vacío si ninguna
autorización otorgada.

Fecha de inicio de validez de la tarjeta o campo vacío si no tiene fecha de inicio.

Fecha de caducidad de la tarjeta o campo vacío si no tiene caducidad.

Nombre del operario que grabó dicha tarjeta si aún se tiene constancia de ello en el
registro auditor del sistema o campo vacío si no.

2.- Tarjeta reconocida pero no identificada.

La respuesta del PC interfaz después de la lectura repite el nombre del comando (LT) y el
nº del grabador/lector implicado más uno de los siguientes campos:

LC Tarjeta de cliente NO válida

LM Tarjeta maestra o tarjeta especial (programadora, anuladora o bloqueadora)

LR Tarjeta de repuesto para clientes

LS Tarjeta de diagnóstico

3.- Tarjeta desconocida.

La respuesta del PC interfaz después de la lectura repite el nombre del comando (LT) y el
nº del grabador/lector implicado más el campo siguiente.

LD Tarjeta desconocida
(Perteneciente a otro hotel o retirada del plan de cierre)

4.- Mensaje de error.

Error en la lectura de la tarjeta.

Véase más adelante la lista de mensajes de error.

EJEMPLO 1:

El PMS desea reconocer e identificar una tarjeta en el grabador/lector nº 1 y luego

expulsarla. Para ello debe mandar al PC interfaz el mensaje:

STX|LT|1|E|ETXLRC

El PC interfaz ordena al grabador/lector nº 1 leer la tarjeta y contesta al PMS:

STX|LT|1|101|102|||CI|2|126||12150693|PMS|ETXLRC

que significa:

LT Tarjeta leída

1 En el grabador/lector nº 1

101 Abre la habitación 101

102 Abre la habitación 102

(campo vacío)

(campo vacío)

CI Tarjeta con código aún válido.

 2 Copia nº 2 de la habitación principal (101).

126 Autorizaciones 1, 2 y 6 otorgadas.

(campo vacío) Sin fecha de inicio.

12150693 Caduca a las 12 horas del día 15 de junio de 1993.

PMS Grabada por el PMS.

Nótese que la identificación de la lectura lleva todos los campos aunque estén vacíos.

EJEMPLO 2:

El PMS desea reconocer e identificar una tarjeta en el grabador/lector nº 3 y luego

retenerla. Para ello debe mandar al PC interfaz el mensaje:

STX|LT|3|R|ETXLRC

El PC interfaz ordena al grabador/lector nº 1 leer la tarjeta y contesta al PMS:

STX|LT|3|LM|ETXLRC

que significa:

LT Tarjeta leída

3 En grabador/lector nº 3

LM Tarjeta maestra o tarjeta especial.

A.4.5 - Parámetros de los comandos P1, P2 y P3

TRES parámetros.

1 Número del grabador/lector.

2 Expulsión, retención o expulsión trasera.
3 Mensaje a grabar.

Este mensaje debe de cumplir con las normas exigidas según la pista a donde vaya
destinada su grabación.

EJEMPLO:

Deseamos grabar el mensaje

%CLIENTE VIP?

en pista 1 según normas ISO de pista 1 y retener la tarjeta dentro del grabador/lector nº 1.

El PMS deberá mandar el siguiente mensaje:

STX|P1|1|R|%CLIENTE VIP?|ETXLRC

Si la operación se lleva a cabo sin errores el PC interfaz contestará al PMS con el mensaje:

STX|P1|1|ETXLRC

 El PC interfaz traduce los caracteres ASCII del mensaje a grabar a caracteres ISO de
pistas 1,2 o 3. Calcula además la paridad del mensaje y la graba tal como lo fijan las
normas ISO pista 1,2 o 3.

IMPORTANTE: Léase las normas ISO para pistas 1, 2 y 3 para cumplir con los
siguientes requisitos:

1 Caracteres admitidos en cada pista.

2 Máximo número de caracteres por pista.
 3 Caracteres de principio, final y de separación de campos de
cada pista.

A.4.6 - Parámetros de los comandos L1, L2 y L3

DOS parámetros.

1 Número de grabador.
2 Expulsión, retención o expulsión trasera.

EJEMPLO:

Deseamos leer la tarjeta grabada en el ejemplo anterior y expulsarla al final de la operación.

El PMS deberá mandar el mensaje siguiente:

ETX|L1|1|E|ETXLRC

El PC interfaz ordenará leer la tarjeta al grabador/lector nº 1 y contestará al PMS si no ha

habido error con el mensaje siguiente:

ETX|L1|1|%CLIENTE VIP?|ETXLRC
A.4.7 - Sucesión de tareas en los editores.

Sucesión de tareas en el mismo grabador/lector.

Utilidad del parámetro de expulsión, retención o expulsión trasera.

Si se desea operar más de una vez en una misma tarjeta se aconseja retener la tarjeta en las
operaciones iniciales e intermedias y solamente mandar expulsar la tarjeta en la última
operación.
Un caso usual es por ejemplo grabar una tarjeta con información (en pista 3) para
abrir una cerradura y seguidamente grabar una información en pista 1 sobre la
identidad del cliente.
Mandar retener la tarjeta en la primera fase de la operación y luego mandar expulsarla
en la segunda. Así el operario no podrá retirar la tarjeta antes de finalizar la grabación
completa de la tarjeta en las dos pistas.

Sucesión de tareas en distintos grabadores/lectores.

El PC interfaz puede tener más de una tarea pendiente.

En efecto, el PMS puede ordenar grabar una tarjeta más antes de que se lleve a cabo la
grabación de la tarjeta anterior. En tal caso el PC interfaz contestará en primer lugar con el
resultado de la operación que antes se haya llevado a cabo.

EJEMPLO:

El PMS ordena grabar una tarjeta de cliente nuevo para la habitación 101 en el grabador nº1
y una tarjeta copia para la habitación 102 en el grabador nº2.

PMS
PC interfaz

STX|CN|1|E|101|ETXLRC
ACK

STX|CC|2|E|102|ETXLRC
ACK

STX|CC|2|ETXLRC

STX|CN|1|ETXLRC
Obsérvese que el operario encargado de grabar la tarjeta de la habitación 101 ha podido
tardar en introducir una tarjeta virgen en la embocadura del grabador nº1. Por lo tanto la
tarea correspondiente al grabador nº2 ha finalizado y generado su contestación
correspondiente antes que la tarea nº1.

 El PC interfaz guarda una sucesión de tareas para ejecutar en distintos grabadores. Para
mandar ejecutar una segunda tarea en un mismo grabador, se ha de esperar a que
concluya la anterior.
A.5 - Mensajes de error.

Si la operación requerida por el PMS no ha podido ser llevada a cabo véase a continuación
la causa de tal imposibilidad y el mensaje de error que genera el sistema ONITY-HT24.

MENSAJE DE ERROR CAUSA

ES Error de sintaxis.
El mensaje es incorrecto (comando desconocido, parámetros
incorrectos, caracteres prohibidos o demasiados caracteres en
grabación según normas ISO, etc. ...)

NC No contesta el grabador/lector direccionado. Fallo de

comunicaciones, apagado o no existe.

NF No files. Ficheros del PC interfaz dañados o no

encontrados.

OV Overflow. El grabador/lector direccionado no ha

terminado aún la tarea anterior.

EP Error en pista magnética.

Tarjeta introducida del revés o falta pista magnética.

EF Error de formato magnético.

La tarjeta ha sido grabada siguiendo otras normas
(Generalmente este error se dará al querer leer en pista 3
según normas ISO una tarjeta grabada según normas ONITY)
o la banda magnética está defectuosa.

EN Error de nivel.
La tarjeta ha sido grabada con un nivel demasiado bajo.
(Suciedad en la cabeza del grabador o tarjeta de baja calidad).

ET Tarjeta atascada.
La tarjeta no cumple con las medidas físicas requeridas.

TD Tarjeta desconocida.
Al mandar grabar una tarjeta para una habitación que no
existe.
ED Temporización agotada. El grabador/lector anula la
operación en curso si no consigue tragar la tarjeta.

EA Tarjetas de apertura única agotadas. Solo pueden

editarse 4 tarjetas de apertura única por habitación y cliente.
Si se pide editar más se genera este mensaje de error.

OS Habitación fuera de servicio. No se podrá grabar la

tarjeta hasta que la habitación esté de nuevo en servicio
indicándolo en el programa HT24.

El mensaje de error viene seguido del número de grabador al que corresponde.

El PMS debe presentar el mensaje pertinente en su pantalla y repetir el mensaje si el error

no es fatal (tarjeta introducida del revés por ejemplo).

EJEMPLO:

El PMS manda grabar una tarjeta nueva de la habitación 101 en el grabador/lector nº 3.

Todos los demás parámetros por defecto.

El mensaje a enviar es

STX|CN|3|E|101|ETXLRC

Si la tarjeta ha sido introducida del revés el PC interfaz contesta

STX|EP|3|ETXLRC
A.6 - Grabadores de tarjetas disponibles.

Todos los grabadores de tarjetas (hasta un máximo de 100) deben de ser declarados en la
lista de periféricos del programa MODI2 (donde se elabora el plan de cierre de cada hotel)
para más tarde adjudicarles sus correspondientes direcciones por el programa HT24. Véase
la pantalla de diagnóstico de periféricos del programa HT24 (menú mantenimiento) para
comprobar las comunicaciones con todos los grabadores declarados.

 El programa HT24 siempre edita tarjetas en el grabador nº 1.

 El PMS puede ordenar una tarea, a través del PC interfaz, en cualquier grabador
declarado incluido el nº1.

A.7 - Incidencias en periféricos

El PMS dispone también de la posibilidad de obtener los registros de incidencias (aperturas

e intentos fallidos de apertura) de los periféricos (lectores murales cableados,
identificadores de tarjetas) a través del PC interfaz que controla la red de comunicaciones
con los periféricos (HTCOM).

Los periféricos han de ser declarados en el programa MODI2 como de extracción

automática de aperturas para que el PC interfaz mantenga constantemente actualizado el
registro de incidencias en sus archivos.

El PMS deberá gestionar una BASE DE DATOS constantemente actualizada con los
registros de incidencias que irá pidiendo continuamente al PC interfaz.

Para ello ha de hacer uso de los siguientes comandos:

WF Proporciona al PMS la incidencia más antigua de un periférico

WN Proporciona al PMS la incidencia siguiente de un periférico.

WR Repite el envío de la incidencia anteriormente requerida.

A.7.1 - Parámetros de los comandos WF, WN y WR

Solo el número del periférico.

EJEMPLO:

El PMS desea obtener la primera (más antigua) incidencia del lector mural de la piscina
(periférico nº 6). Para ello deberá mandar al PC interfaz

STX|WF|6|ETXLRC

A.7.2 - Parámetros de la contestación a los comandos WF, WN y WR

El PC interfaz manda al PMS la incidencia requerida.

STX|Wx|Nºperif.|Fecha|Hora|Tipo|Sentido|Tarjeta|Nºcopia|usuario|ETXLRC

Wx Repite el comando enviado por el PMS (WF, WN o WR)

Nºperif. Repite el mismo nº de periférico con el mismo formato y número de caracteres

(Si el PMS manda |006| el PC interfaz también contesta |006|)

Fecha Día/Mes de la incidencia (5 caracteres).

Si el sistema HT24 ha sido configurado para dar las fechas en formato USA la
fecha se dará en formato Mes/Día.

Hora Hora:Minutos de la incidencia (5 caracteres)

Tipo Tipo de incidencia (1 carácter).

Es una cifra de 0 a 5. Solo el 0 indica que se ha producido la apertura. Las cifras
de 1 a 5 dan la explicación acerca del rechazo.

0 Apertura
1 Tarjeta ajena al sistema (de otro hotel)
2 Tarjeta no válida (Código no válido, anulada por Check-Out, caducada,
etc.....)
3 Tarjeta no habilitada en el plan de cierre del periférico
 4 Tarjeta fuera de horario habilitado (turno)
5 Tarjeta rechazada por anti pass-back.

Sentido Entrada o salida. 1 carácter.

I : apertura producida en lector de entrada

O: apertura producida en lector de salida

Los lectores murales pueden ser configurados para controlar la entrada y salida
de un recinto.

Tarjeta Nombre de la tarjeta que ha producido la incidencia. 8 caracteres.

Nºcopia Número de copia de la tarjeta. 2 caracteres.

#0 tarjeta original
#1 primera copia
#2 segunda copia
#3 tercera copia
#4 cuarta copia
#D copia indeterminada (5ª copia y sucesivas)
@1 primera apertura única
@2 segunda apertura única
@3 tercera apertura única
@4 cuarta apertura única
MT Maestra temporal

Las tarjetas maestras normales (no temporales) siempre son originales (#0).

Usuario Nombre del usuario de la tarjeta maestra. 20 caracteres.

Este campo no se usa si no se trata de una tarjeta maestra.

Incidencias especiales

Si el campo "tarjeta" está vacío (8 espacios) se trata de una incidencia especial. El campo
"nºcopia" da más información sobre ella.

Tarjeta (8 espacios)
nºcopia S0 Tarjeta anuladora de maestra
S1 Tarjeta de repuesto
S2 Apertura por pulsador
S3 Apertura provocada por el ordenador
S4 Tamper en central
S5 Tamper en lectores 1 o 2
S6 Intrusión en puertas 1 o 2
S7 Puertas 1 o 2 dejadas abiertas
S8 Puertas 1 o 2 cerradas de nuevo
S9 Tarjeta desconocida (Maestra de usuario borrado de la lista, tarjeta de
cliente retirada del plan de cierre, etc.....)

La incidencia especial S3 es una apertura de un lector mural provocada desde el ordenador.

Esta prestación no se contempla en el sistema HT24.
Las incidencias especiales S4 a S8 son alarmas del lector mural. El sistema HT24 no
programa los lectores murales para que detecten alarmas.

A.7.3 - Mensajes de error

Los comandos WF, WN y WR pueden provocar dos mensajes de error.

WE El periférico no existe o no es de extracción automática de aperturas.

WO No hay incidencias. El significado real depende del comando que ha provocado

el error.

Después de WF No hay incidencias registradas

Después de WN No hay más incidencias. Se ha mandado ya al PMS la

última incidencia del periférico (la más reciente)

Después de WR El PMS no ha pedido todavía ninguna incidencia por lo

tanto el PC interfaz no puede repetir la comunicación.

El mensaje de error viene seguido del nº de periférico.

EJEMPLO:

El PMS manda al PC interfaz.

STX|WF|9|ETXLRC
 que significa:
Recoger la primera incidencia del periférico nº 9.

El PC interfaz recibe la comunicación correctamente, contesta ACK y manda el mensaje

STX|WE|9|ETXLRC

que significa:
El periférico nº 9 no existe o no es de extracción automática de aperturas.

A.8 - Funcionamiento con WF, WN y WO

Con estos tres comandos el PMS puede inicializar y actualizar constantemente su base de
datos.

1.- Inicialización de la base de datos del PMS.

Cuando el PMS no posee ningún registro de incidencias.

- Mandar el comando WF para recibir el registro más antiguo

- Mandar repetidamente el comando WN para recibir consecutivamente los demás
registros hasta recibir el mensaje de error WO (no más incidencias).
- Repetir la operación para cada periférico.

2.- Actualización de la base de datos del PMS.

- Mandar periódicamente el comando WN para ir recibiendo los últimos registros.

- Cuando se reciba el mensaje de error WO (no más incidencias) repetir la operación
con el siguiente periférico.

 Si después de un comando WN el PMS no recibe correctamente la comunicación deberá

mandar el comando WR para que el PC interfaz repita la emisión de la última incidencia
enviada.
Todos los campos son de longitud fija. Si la información que contienen no alcanza la
capacidad total del campo el resto se rellena con espacios.

EJEMPLOS:

El PMS manda

STX|WN|2|ETXLRC

El PC interfaz recibe correctamente el mensaje y contesta ACK. Ejecuta la tarea y manda al

PMS

STX|WN|2|10/08|14:27|0|I|101 |#2| |ETXLRC

que significa:
La siguiente incidencia producida en el periférico nº 2 ha sido provocada el 10 de Agosto a
las 14 horas 27 minutos, la apertura ha sido efectuada en entrada por la tarjeta de la
habitación 101 segunda copia.
Como no se trata de una tarjeta maestra el campo "usuario" se rellena con 20 espacios.

Si el PMS no recibe correctamente esta comunicación manda el mensaje

STX|WR|2|ETXLRC

El PC interfaz recibe correctamente el mensaje y contesta ACK. Ejecuta la tarea y manda al

PMS:
STX|WR|2|10/08|14:27|0|I|101 |#2| |ETXLRC

que es el mismo registro mandado anteriormente.

El PMS podrá mantener actualizada una base de datos mandando el comando WN

periódicamente a cada periférico. La presentación en su pantalla de los registros puede ser
filtrada según uno o varios campos (solo de un cliente, entre dos fechas, etc.....).

El sistema HT24 posee un buffer de salvaguarda de las 8000 (ocho mil) últimas incidencias
de cada lector mural y de las 4000 (cuatro mil) últimas incidencias de cada identificador de
tarjetas. El PMS no deberá interrumpir la recogida de incidencias durante mucho tiempo ya
que solo obtendría las 8000 (o 4000) últimas.