Skip to content

SIHOT Developer Pages

INTR Append system messages

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.