Append system messages

The SIHOT.PMS semaphore provides information as to any disturbances of the system within the hotel environment. Just like a traffic light, the semaphore – located at the bottom of the SIHOT.PMS screen - indicates in green, yellow and red lights the status of the system.

Using the request <OC>SYSMESSAGE</OC>, you can add any system message to the SIHOT.PMS semaphore mechanism.

Operationcode: SYSMESSAGE

SYSMESSAGE

Request

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
        <TN>4730</TN>
        <OC>SYSMESSAGE</OC>
        <MSG>semaphore message</MSG>
        <LEVEL>priority level</LEVEL>
        <SYSTEM>external system name</SYSTEM>
</SIHOT-Document>

Attributes Message

Attribute Denotation Data Type Usage
OC

Action type:

SYSMESSAGE = add SIHOT.PMS semaphore message

 String Mandatory
TN Transaction number Integer Mandatory
MSG Message to be shown to the SIHOT.PMS users String Mandatory
LEVEL

Semaphore priority level:

0: Error – red light ( = Default)

1: Warning level 1 – yellow light

2: Warning level 2 – yellow light

3: Information – green light

 Integer Optional
SYSTEM Name of the external system. If blank, the SIHOT.PMS User ID for the interface is used. String Optional

Response

<?xml version="1.0" encoding="iso-8859-1"?>
<SIHOT-Document>
        <SIHOT-Version>
                <Version>9.0.0.0055</Version>
                <EXE>D:\\sihot\\sinetres.exe</EXE>
        </SIHOT-Version>
        <TN>4732</TN>
        <OC>SYSMESSAGE</OC>
        <RC>0</RC>
</SIHOT-Document>

Any other value than 0 represents an error. The message is not shown in the semaphore, then.

Example 1 – error message

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
    <TN>4730</TN>
    <OC>SYSMESSAGE</OC>
    <MSG>No connection to SIHOT.HQ</MSG>
    <SYSTEM>SIHOT.Channelmanager</SYSTEM>
</SIHOT-Document>

Example 2 – warning message

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
    <TN>4731</TN>
    <OC>SYSMESSAGE</OC>
    <MSG>Free disk space below 1GB</MSG>
    <LEVEL>1</LEVEL>
</SIHOT-Document>

Example 3 – information message

<?xml version="1.0" encoding="ISO-8859-1"?>
<SIHOT-Document>
    <TN>4732</TN>
    <OC>SYSMESSAGE</OC>
    <MSG>Everyday use is the norm. Reliability is everything. SIHOT
    works.</MSG>
    <LEVEL>3</LEVEL>
    <SYSTEM>SIHOT.SaaS</SYSTEM>
</SIHOT-Document>

Results

The error level for the message light is the highest of the available semaphore message levels, i.e. if there is any semaphore message with level ‚Error‘, the message light is red.