PMS I/F

1
Introduction into
Presenter Marcin Cedzidlo
Panasonic PMS Interface Software
2
Introduction
3
What is PMS ?

• PMS (Property Management System )In the
  hospitality industry, a property management
  system (PMS) is a computerized system used to
  manage guest bookings, online reservations, point
  of sale, telephone and other amenities
• FOS (Front Office System)Part of hotel PMS. FOS
  is the software package which the hotel front
  desk use for guest check-in, check-out and
  reservation, etc. FOS name is alternately used
  with Front Desk System.
• Call Accounting SystemCall Accounting System is
  a software application that captures, records,
  and costs telephone usage events. Call accounting
  software cooperates with FOS.

4
What is Panasonic PMS Interface ?

• Panasonic PMS Interface (PMS I/F) is a software
  that allows third party hotel management packages
  (FOS) to fully integrate with the Panasonic PBX
  (KX-TDA/TDE), providing a more efficient level of
  service to customers

5
Basic System Configuration
6
Basic System Configuration
Hotel Front Desk
Guest Rooms
Front Office System ( Hotel Software)
PMS Interface
RS-232C/LAN
PBX
USB/LAN
Basic System Configuration
7
Basic System Configuration
PMS (FOS Hotel Software)
Application
FOS PC
RS-232C/LAN
PMS I/F
Middle-ware (Interface)
TAPI (Windows OS)
3rd Party TSP (PCC Original Interface) (Free of
Charge)
PMS I/F PC
USB/LAN
PBX
8
Structure of PMS I/F
9
Structure of PMS I/F
What is a Device ?

• A system that sends information to another
  system
• A system that receives information from system

Device
Device
PMS I/F
sending
receiving
Information
Information
RS-232C
USB/LAN
RS-232C/LAN
Information
Information
PBX
FOS
sending
receiving
10
Structure of PMS I/F
What is a Message ?

• A message is a block of information sends from a
  device to PMS I/F
• A message is made up of fields
• A field may be used as a trigger for command
• PMS I/F will send a command to the specified
  device when a message is identified

Message
PMS I/F
Device
Device
Information
RS-232C
USB/LAN
RS-232C/LAN
Information
PBX
FOS
Message
11
Structure of PMS I/F
What is a Command ?

• A command is a block of information that PMS I/F
  sends to the specified device
• A command is usually invoked by an incoming
  message
• A command may require a response from the device

Command
PMS I/F
Device
Device
Information
RS-232C
USB/LAN
RS-232C/LAN
Information
PBX
FOS
Command
12
Function of PMS Interface
PMS-I/F is data converter software

• Bridge between device and device (DevicePBX,
  PMS, CA etc...)
• Receives a message from a device
• Converts the message to a command data (Ext. No,
  Time etc)
• Sends the command to the target device
• Monitors the devices activity

Data convert
PMS I/F
Device
Device
Message
Command
RS-232C
USB/LAN
RS-232C/LAN
Command
Message
PBX
FOS
13
FOS gt PBX
Messages sent from FOS to PMS I/F

• Check In (Unblock Ext. / Set Guest Name etc...)
• Check Out (Block Ext. etc...)
• Extension Block / Unblock (COS)
• Wakeup Call Set / Cancel
• Do Not Disturb ON/OFF
• Message Waiting Lamp ON/OFF
• Call Forwarding ON/OFF
• Guest Name Set/Clear
• Change Class of Service
• Set PBXs Date and Time
• Get PBXs Date and Time

PMS I/F
FOS
Messages
Commands
PBX
14
PBX gt FOS
Commands sent from PMS I/F to FOS

• Extension Block / Unblock (Change COS) Report
• Wakeup Call Set / Cancel Report
• Do Not Disturb ON/OFF Report
• Message Waiting Lamp ON/OFF Report
• Call Forwarding ON/OFF Report
• Guest Name Set/Clear Report
• Wake Up Confirm
• System Date and Time Report
• Mini Bar Data
• SMDR Information

PMS I/F
FOS
Commands
Messages
PBX
15
PMSI Data Flow(from FOS to PBX)
16
PMS I/F Data Flow - Module division
PC

PMS I/F





Main Module
Panasonic3rd Party TSP
TAPI(Windows)
PBX I/F
FOS I/F
FOS
PBX
17
Data Flow (From FOS to PBX)
1
2
Check-in Information
- Extension number - Guest Name
FOS
3
Message
PMS I/F
4
5
PBX interface
FOS interface
Trigger
6
Command
7
TSP
PC
8
Change - Extension Name - COS
9
PBX
18
Data Flow (From FOS to PBX)
Sample
1
2
Check-in Information
FOS
- 315 - Mr.Tanaka
3
GIRN315CS3GNMr.Tanaka
FOS Format
PMS I/F
4
5
PBX interface
FOS interface
Trigger
6
LDS 315 28 4 1 3
PMSI TAPI Format
LDS 315 28 13 4 Mr.Tanaka
7
TSP
PC
8
Change - Extension Name - COS
9
PBX
19
Data Flow (From FOS to PBX)
Sample
1
2
Check-in Information
FOS
- 315 - Mr.Tanaka
3
GIRN315CS3GNMr.Tanaka
FOS Format
Trigger
PMS I/F
Ext. No.
Ext.Name
COS
4
COS change command
LDS 315 28 4 1 3
Ext.Name change command
LDS 315 28 13 4 Mr.Tanaka
PMSI TAPI Command
5
TSP
PC
6
Change - Extension Name - COS
7
PBX
20
Data Flow (From PBX to FOS)
8
Charge to Guest
FOS
7
Command
PMS I/F
5
6
PBX interface
FOS interface
Trigger
4
Message
- Extension Number - Call Charge
3
TSP
PC
2
1
Make a call
PBX
21
Data Flow (From PBX to FOS)
Sample
8
Charge to Guest
FOS
FOS Format
7
RN0300PTCDA060124TI183619DD0123456789DU00010
3TA010
PMS I/F
Trigger By SMDR
5
6
PBX interface
FOS interface
Trigger
PMSI TAPI Format
4
SMDR30024.01.2006 1836190001030123456789
0.10
3
TSP
PC
2
1
Make a call
PBX
22
Data Flow (From PBX to FOS)
Sample
6
Charge to Guest
FOS
FOS Format
5
RN0300PTCDA060124TI183619DD0123456789DU00010
3TA010
Trigger
Cost
Time
Date
Ext. No.
Duration
DDI No.
4
SMDR30024.01.2006 1836190001030123456789
0.10
PMSI TAPI Format
3
TSP
PC
2
1
Make a call
PBX
23
PMS I/F Data Flow - Configuration Files
What is the .pmd file?
What is the .pmi file?

• Contains the definition of the Device
• Defines the protocol format
• Messages for a device
• Commands for a device
• Alarm for a device
• Macros for a device
• Date masks for a device
• There will be one pmd file for each device

• Defines a PMS Interface configuration
• Contains a list of Devices(pmd files)
• Contain the Re-map tables
• Contains e-mail server definitions for Alarm

Example PCC-TDA2.pmi
Example FOS-TDA2.pmd
Example PCC-TDA2.pmd
PMS I/F



Main Module
PBX I/F
FOS I/F
Command
Message
Message
Command
FOS
PBX
24
System Configuration 1
PC 1
PC 2
1
Call Accounting Software
LAN/USB
PMS Interface
FOS
Dongle
PBX
COM1
COM1
RS232C/LAN
Hotel Front Desk
Depends on the capability of Call Accounting S/W,
it is possible to combine Call Accounting S/W
with FOS
1
25
System Configuration 1
PC 1
PC 2
2
Call Accounting Software
LAN/USB
PMS Interface
FOS
Dongle
PBX
COM1
COM1
RS232C/LAN
Hotel Front Desk
Depends on the capability of Call Accounting S/W,
it is possible to combine Call Accounting S/W
with FOS or PMS I/F .However if any
problem, it should not work on one PC.
1
2
26
System Configuration 1
PC 1
COM3
COM2
PC 2
2
Call Accounting Software
LAN/USB
PMS Interface
FOS
Dongle
PBX
COM1
COM2
RS232C/LAN
Hotel Front Desk
Depending on the capability of the Call
Accounting software, the PMS I/F PC may need one
more extra COM PORT
27
System Configuration 2
PC 3
COM1
RS232C/LAN
Call Accounting Software
PC 1
COM2
LAN/USB
PMS Interface
COM2
Dongle
RS232C
PBX
COM1
PC 2
COM2
COM1
FOS
RS232C/LAN
Hotel Front Desk
It is ideal to use different PC for different
programs (PMS Interface, Call Accounting and FOS)
to maximize each programs performance
28
System Configuration 3
PC 1
COM2
FOS
RS232C
LAN/USB
PMS Interface
Dongle
COM1
PBX
Hotel Front Desk
Whether PMS I/F and Front Office System can work
on one PCdepends on the capability of the Front
Office System software. If any problem, it should
not work on one PC
29
Installation
30
System Requirements PMSI v3.8
Minimum Requirements (for installing PMS
Interface Software only)
128 Rooms 256 Rooms 960 Rooms CPU PentiumIII 80
0MHz 800MHz 800MHz RAM 256Mb 256Mb 256Mb HDD 20G
b 20Gb 20Gb
Recommended (for installing PMS Interface
Software only)

• 128 Rooms 256 Rooms 960 Rooms
• CPU Pentium4 1.4GHz 1.4GHz 1.4GHz
• RAM 512Mb 512Mb 512Mb
• HDD 20Gb 40Gb 60Gb

The following OS can be used Windows 2000
Professional (English version only) Windows
Server 2003 (English version only) Windows XP
Service (English version only)
31
System Requirements PMSI v3.8
Microsoft Windows Vista (only English)
Recommended requirements (for installing PMS
Interface Software only)

• The following PBXs support the PMSi.
• KX-TDA PBX Series (30/100/200/600)
• KX-TDE PBX Series (100/200/600)
• KX-NCP PBX Series 500/1000

32
Contents of PMS I/F
Contents of PMS Interface Software Package 1)
CD-ROM Software Manual/Operating
Instructions/Getting Started 2) Dongle
(Hardware key for copy protection
Controlling the number of users) 3)
Getting Started Manual / End-User License
33
Installation of hardware
34
Installation of hardware
Connect a TDA and a PC1 by LAN or USB. USB Use
the same cable like for PC programming.
1
PC 1
1
LAN/USB
PMS Interface
PBX
35
Installation of hardware
Connect a TDA and a PC1 by LAN or USB. USB Use
the same cable like for PC programming.
1
Connect the Dongle to the PC
2
PC 1
1
LAN/USB
PMS Interface
Dongle
PBX
2
36
Installation of hardware
Connect a TDA and a PC1 by LAN or USB. USB Use
the same cable like for PC programming.
1
Connect the Dongle to the PC
2
Connect PC1 to PC2 via RS232C or LAN
3
PC 1
PC 2
FOS Call Accounting Software
1
LAN/USB
PMS Interface
Dongle
PBX
2
COM1
COM1
3
RS232C/LAN
37
Installation of hardware
Connect a TDA and a PC1 by LAN or USB. USB Use
the same cable like for PC programming.
1
Connect the Dongle to the PC
2
Connect PC1 to PC2 via RS232C or LAN
3
Power on PBX, PC1, PC2
4
4
4
PC 1
PC 2
4
FOS Call Accounting Software
1
LAN/USB
PMS Interface
Dongle
PBX
2
COM1
COM1
3
RS232C/LAN
38
Installation of TDA-TSP
39
Installation of TDA-TSP
Close all application and click Next
1
Download the latest 3rd Party TSP driver
40
Installation of TDA-TSP
Close all application and click Next
1
Agree to license agreement
2
41
Installation of TDA-TSP
Click Install to start installation
1
42
Installation of TDA-TSP
Click Install to start installation
1
2
Click OK
43
Installation of TDA-TSP
Choose PBX link LAN Connection Set IP address
and port number of PBX USB Connection Install
TDA-USB Driver
1
44
Installation of TDA-TSP
Choose PBX link LAN Connection Set IP address
and port number of PBX USB Connection Install
TDA-USB Driver
1
2
Leave Other Parameters by default
45
Installation of TDA-TSP
1
Click OK
46
Installation of TDA-TSP
1
Click OK
2
Once install has completed, click Finish and
restart PC
47
Installation of PMS I/F
48
Installation of PMS I/F
Extract downloaded file (pmsinst37.zip) and copy
its content (PMSi_Setup_3.7.01d_KME.exe) to any
location on hard disk where PMS-I will be
installed (alternatively run installer from PMS
I/F CD)
2
1
COPY
3
Download the latest PMS I/F Software
49
Installation of PMS I/F
Run PMSi_Setup_3.7.01d_KME.exe with the
Administrator privileges.
50
Installation of PMS I/F
Close all application and click Next
51
Installation of PMS I/F
Select default installation directory
52
Installation of PMS I/F
Select name for Program folder in Menu Start
53
Installation of PMS I/F
Confirm settings and click Next
54
Installation of PMS I/F
Once install has completed, click Finish
55
Installing Panasonic PMS Interface Software on
Vista
56
Installing PMS I/F Software on Vista
User Access Control (UAC) is a new security
system introduced with the advent of the Windows
Vista. The UAC may prevent PMSi from being
installed. Once installed the UAC may hinder
normal operations that write to data files (logs,
configuration files, etc.) To avoid these
problems the following options are available
Installing PMSi as an Administrator Running
PMSi as an Administrator
57
Installing PMS I/F Software on Vista
In case of any problem, UAC can be
disabled/enabled. This may be accomplished as
follows Control Panel gt User Account gt Turn User
Account Control on or off
Check the checkbox to enable UAC, then click OK.
Changing this setting may require a re-start of
Vista.
58
Installing PMS I/F Software on Vista
Installing PMSi as an Administrator To install
PMSi as an administrator, simply logon to Vista
as an administrator and proceed to the Start
Installation section Running PMSi as an
Administrator To run PMSi as an administrator,
follow the procedure below 1. Logon to Vista as
user with administrator rights 2. Open
Compatibility properties screen of NewPMSi.exe 3.
Click the Run this program as an administrator
check box( Defaul PMSI folder is C\Program
Files\PMSI )
59
Installing PMS I/F Software on Vista
Running PMSi as an Administrator
This may be accomplished by right clicking on
NewPMSi.exe and checking the Run program as
Administrator
60
Installing PMS I/F Software on Vista
If when starting PMSi you get the following
prompt
Then you may perform the following in order to
prevent this prompt from appearing ()
61
Installing PMS I/F Software on Vista
Go to Control Panel gtAdministrative Tools gt
Local Security Policy gt Local
Policies gt Security Options
Double click on User Account Control Behavior
of elevation prompt for administrators in Admin
Approval Mode.
Select Elevate without prompting and press OK
62
Installing PMS I/F Software on Vista
Vista Firewall Completely disabling the Firewall
in Vista is not an option. Vista seems to detect
that it is unprotected and at an even lower level
blocks incoming TCP connection attempts. To
enable TSP communications (when using TCP/IP
connection) add the following firewall exception
63
Installing PMS I/F Software on Vista
Vista Firewall For each PMS TCP/IP device that is
configured as a server, add the selected port to
the Firewall exceptions
In this example, the selected port that PMSi is
waiting/listening for a connection, is 51000.
64
Uninstalling PMS I/F and TDA-TSP Software
65
Uninstalling PMS I/F and TDA-TSP Software
Uninstall PMS Interface software 1. Close the
PMS Interface application. 2. Choose
Settings/Control Panel from the Start menu. 3. In
the Control Panel open Add/Remove programs. 4.
From the program list select PMSi and click the
Add/Remove button. 5. PMS Interface and its
components will be removed. 6. To finish the PMS
Interface uninstallation, delete the PMSi
directory. Remove Panasonic KX-TDA TSP 1. Make
sure no other device/program are using the
Panasonic PBX driver before the removal. 1.
Choose Settings/Control Panel from the Start
menu. 2. Open the Add/Remove programs. 3. Select
Panasonic KX-TDA TSP. 4. Click Remove.
66
Starting PMS I/F
67
Starting PMS I/F
1
Start PMS I/F from the All Programs folder
68
Starting PMS I/F
1
Start PMS I/F from the All Programs folder
2
69
Starting PMS I/F
1
Start PMS I/F from the All Programs folder
3
2
70
Starting PMS I/F
1
Start PMS I/F from the All Programs folder
Follow the steps to install HASP driver and then
restart Windows
3
2
71
Starting PMS I/F
1
Start PMS I/F from the All Programs folder
Follow the steps to install HASP driver and then
restart Windows
3
4
2
72
Starting PMS I/F
1
Start PMS I/F from the All Programs folder
Follow the steps to install HASP driver and then
restart Windows
3
4
5
2
73
Starting PMS I/F
PMS I/F Main Display
74
Starting PMS I/F
PMS I/F Main Display
Menu
75
Starting PMS I/F
PMS I/F Main Display
Menu
Device List
76
Starting PMS I/F
PMS I/F Main Display
Menu
Device List
View all the activities between PMS I/F and the
devices
77
Starting PMS I/F
PMS I/F Main Display
Connection State
78
Starting PMS I/F
PMS I/F Main Display
Connection State
79
Starting PMS I/F
PMS I/F Main Display
Connection State
80
Starting PMS I/F
PMS I/F Main Display
Connection State
81
Starting PMS I/F
PMS I/F Main Display
Connection State
82
Starting PMS I/F
Name of the device
83
Starting PMS I/F
The type of communication between PMS Interface
and the device (PMS Interface can support maximum
10 devices)
84
Starting PMS I/F
The examples of supported connection types KME
used by Panasonic KX-TDA PBX seriesCOMM used
by FOSTCP/IP used by FOSDISP used for
Testing and Diagnostics
The type of communication between PMS Interface
and the device (PMS Interface can support maximum
10 devices)
85
Starting PMS I/F
The total number of messages that PMS Interface
received from the device since last PMS Interface
startup.
86
Starting PMS I/F
The total number of commands that PMS Interface
sent to the device since last PMS Interface
startup.
87
Starting PMS I/F
The total number of acknowledgments that PMS
Interface received from the device in response to
command-sequences
88
Starting PMS I/F
The total number of alarms received since last
PMS Interface startup.
89
Starting PMS I/F
The state that PMS Interface currently performs
for the device
90
Starting PMS I/F
The state that PMS Interface currently performs
for the device
For example Startup establishing the
connection to the deviceReceive checking for
messages from the deviceError indicating an
unrecoverable errorDisabled indicating that
the device has been disabled due to some problem
91
Starting PMS I/F
The File menu enables you to handle PMI files
(configuration settings), as follows
Start a new PMS Interface configuration
92
Starting PMS I/F
The File menu enables you to handle PMI files
(configuration settings), as follows
Open a saved PMS Interface configuration
93
Starting PMS I/F
The File menu enables you to handle PMI files
(configuration settings), as follows
Save the changes in the configuration of the PMS
Interface
94
Starting PMS I/F
The File menu enables you to handle PMI files
(configuration settings), as follows
Terminate the PMS Interface session
95
Starting PMS I/F
96
Starting PMS I/F
97
Starting PMS I/F
The Options menu consists of a single option
Define , which allows you to configure the
current PMS Interface session's properties
98
Starting PMS I/F
General defines the system's priority over other
applications running on the computer.
99
Starting PMS I/F
E-mail (optional) the E-mail address for sending
alarm messages
212.123.111.222
mail.panasonic.co.jp
pmsi_at_panasonic.co.jp
Service_at_panasonic.co.jp
100
Starting PMS I/F
Maps (optional) a table used for converting one
type of data into another, for exampleconverting
extension numbers to corresponding room numbers
101
Starting PMS I/F
Log Enable/disable the log files of PMS I/F
activities under the \PMSi\Logs directory
102
Starting PMS I/F
Security setting the warning message and the
password.
103
Starting PMS I/F
104
Starting PMS I/F
105
Starting PMS I/F
The Devices menu handles the connected devices.
The options in this menu are the following
106
Starting PMS I/F
Configure the properties of devices
107
Starting PMS I/F
Restart all devices and the PMS Interface session
108
Starting PMS I/F
109
Starting PMS I/F
110
Starting PMS I/F
The devices are listed in the upper box
111
Starting PMS I/F
You may add new devices to the list
112
Starting PMS I/F
Save current configuration of devices to PMD file
113
Starting PMS I/F
Remove existing devices
114
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
115
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
1
116
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
2
117
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
3
118
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
4
119
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
5
120
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
6
121
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
7
122
Starting PMS I/F
The attributes of the currently selected
(highlighted) device are presented below in eight
tabs
8
123
Starting PMS I/F
GENERAL - tab enables you to activate/deactivate
the device, and to set such general information
as device description, initial link, etc. This
tab also presents the device's connection type.
124
Starting PMS I/F
CONNECTION - depending on the device's
connection type, this tab presents the
corresponding connection parameters and enables
you to adjust them as necessary.
125
Starting PMS I/F
MESSAGES - tab serves as a translation table,
specifying the destination device and the
corresponding command for each message
126
Starting PMS I/F
Message List
127
Starting PMS I/F
Message List
Internal structure of the currently selected
message
128
Starting PMS I/F
The Messages tab enables you
129
Starting PMS I/F
The Messages tab enables you
Add New Messages
130
Starting PMS I/F
The Messages tab enables you
Edit Messages
131
Starting PMS I/F
The Messages tab enables you
Delete Messages
132
Starting PMS I/F
Edit a Message
133
Starting PMS I/F
Edit a Message
Select the message to be edited from the message
list
134
Starting PMS I/F
Edit a Message
Click EDIT
135
Starting PMS I/F
Edit a Message
PMS I/F interconnects multiple devices by
translating a MESSAGE received from a source
device into a COMMAND sent to the destination
device.
Click EDIT
136
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
Edit the message description
137
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
Select the device that should receive this message
138
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
Select the appropriate command from list of the
commands of Destination device
139
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
If the message is an event, use the Event field
to specify its name
140
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
2
3
4
1
The message layout consist of fields(1). You can
add (2), edit (3) or delete (4) data fields
141
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
The XML checkbox indicates that this message will
be a valid XML document.
142
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
The High Priority checkbox is used to instruct
PMSi to place this command in the high priority
queue
143
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
This enables a single message to trigger off same
command on several devices. For exampleIf the
Destination device name is PBX, then in addition
to sending the command to the PBX device, the
command will be sent to device PBX2 and PBX3 as
well as MYPBX4.
144
Devices gt Setup gt Messages gt Edit
Edit a Message
The command that is triggered by the message must
be defined for each message
Click EDIT
145
Devices gt Setup gt Messages gt Edit
Edit a Data Field
Edit the description
146
Devices gt Setup gt Messages gt Edit
Edit a Data Field
Select the field's type from the Type drop-down
list
147
Devices gt Setup gt Messages gt Edit
Edit a Data Field
In the General group, the meaning of this section
changes according to the field type
148
Devices gt Setup gt Messages gt Edit
Edit a Data Field
In case the field serves as the command
identifier, check the Trigger box, then key-in
the identification string in the Trigger Pattern
boxes.Compare Type Use this field to set the
criteria for checking this field against the
Trigger Pattern(s) specified below.
149
Devices gt Setup gt Messages gt Edit
Edit a Data Field
XML Used in cases where a data field is to be
extracted from an XML document).
150
Devices gt Setup gt Messages gt Edit
Edit a Data Field
Sometimes values of data fields, sent by the
source device, have to be changed before the
command is send to the destination device.
151
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Fixed Position
Fixed Position (1) The start position and
length of this field are fixed as specified in
the Start Position (2) and Length setting (3).
1
2
3
Example Position 12345678 Message
ABCDEFGH If set the Start position to 2 and
length is 4, then the data captured will be BCDE
152
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Fixed Position
Start Position is counted from the end
153
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Fixed Position
When checked instructs PMSi to remove all non
printable characters from the field (such as CR
(Carriage Return and LF (Line Feed) according to
the field type.
154
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Fixed Position
When checked instructs PMSi to remove all leading
and trailing spaces from a field
155
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Fixed Position
Instructs PMSiI to validate and standardize the
field. This is most useful when processing a date
field from a devices message and validating the
numeric data.
156
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Fixed Position
Example Date(Non-Delimited) YYYYMMDD -gt
20081101 Date(Delimited) M/D/Y - gt
11/01/2008 All of the Date masks standardize
the date into YYYY-MM-DD format
157
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Delimited
Delimited (1) where the field is separated from
its neighboring fields by a certain character
called "delimiter". Using this method, fields
that are not in fixed positions may be isolated.
158
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Delimited
Delimited (1) where the field is separated from
its neighboring fields by a certain character
called "delimiter". Using this method, fields
that are not in fixed positions may be isolated.
1
2
3
The start position (2) and length (3) parameters
further specify which portion of the data found
within the boundaries are to be used.
159
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Delimited
Delimited (1) where the field is separated from
its neighboring fields by a certain character
called "delimiter". Using this method, fields
that are not in fixed positions may be isolated.
Specifies a position from PMS I/F should start to
parse delimited fields. Sometimes used when
beginning of data is in fixed positions and end
of data string is variable.
160
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Delimited
Delimited (1) where the field is separated from
its neighboring fields by a certain character
called "delimiter". Using this method, fields
that are not in fixed positions may be isolated.
Specify the Delimiter character and the Field No.
within the message. The delimiter should be one
character only.
161
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Delimited
Delimited (1) where the field is separated from
its neighboring fields by a certain character
called "delimiter". Using this method, fields
that are not in fixed positions may be isolated.
Example 1 111222333444444 A delimiter
would be specified111 is field no.1 and 333
is field no.3.
162
Devices gt Setup gt Messages gt Edit gt Edit Field
Field Type Constant
Constant (1) Used in cases where a data field is
not found in the record, but the invoked command
requires a value in some field. The field defined
of type constant will always be passed to the
command with the value specified (2).
1
2
163
Devices gt Setup gt Commands
PMS Interface translates a message received from
a source device into command sent to any one of
the destination devices
List of Command-Sequences
The commands included in the currently
selected Sequence
164
Devices gt Setup gt Commands
PMS Interface translates a message received from
a source device into command sent to any one of
the destination devices
Commands tab enables you to compose 1(), edit (2)
or delete (3) commands (command-sequences)
165
Devices gt Setup gt Commands
PMS Interface translates a message received from
a source device into command sent to any one of
the destination devices
Commands tab enables you to compose 1(), edit (2)
or delete (3) commands (command-sequences)
1
166
Devices gt Setup gt Commands
PMS Interface translates a message received from
a source device into command sent to any one of
the destination devices
Commands tab enables you to compose 1(), edit (2)
or delete (3) commands (command-sequences)
2
167
Devices gt Setup gt Commands
PMS Interface translates a message received from
a source device into command sent to any one of
the destination devices
Commands tab enables you to compose 1(), edit (2)
or delete (3) commands (command-sequences)
3
168
Devices gt Setup gt Commands
Edit Command
169
Devices gt Setup gt Commands
Edit Command
Click EDIT
170
Devices gt Setup gt Commands
Edit Command
Click EDIT
171
Devices gt Setup gt Commands
Edit Command
The command description
172
Devices gt Setup gt Commands
Edit Command
Insert the Command Name to be used by PMS
Interface (you may use all characters except for
commas ","). The name must be unique within this
device.
173
Devices gt Setup gt Commands
Edit Command
Amount of time that PMS Interface will wait for a
response. The wait interval is only used if an
expected reply is specified in the command. If
a reply is not received within the time
specified, PMS Interface will re-send the command
sequence from the beginning of the sequence.
174
Devices gt Setup gt Commands
Edit Command
Use the Command Action to instruct PMS Interface
what to do with the command specified
belowSend / Wait Send the strings and if
indicated wait for responses. PMSi Device Control
This action instructs PMS Interface to use the
command specified below as a command to control
PMS Interface
175
Devices gt Setup gt Commands
Edit Command
Command will be written to the DataLog
176
Devices gt Setup gt Commands
Edit Command
Timeout Action field specifies what action PMSi
should take in the event that it fails to send a
command
177
Devices gt Setup gt Commands
Edit Command
178
Devices gt Setup gt Commands
Edit Command
179
Devices gt Setup gt Alarms
Alarms
180
Devices gt Setup gt Alarms
Alarms
When PMS Interface identifies a device, which has
been no response/message for some time, it issues
an alarm. One or more successive alarms can
automatically start an "action", which is either
a recovery operation or an inactivity
notification.
181
Devices gt Setup gt Alarms
Alarms
The Alarms tab enables you to compose 1(), edit
(2) or delete (3) an alarm
182
Devices gt Setup gt Alarms
Alarms
The Alarms tab enables you to compose 1(), edit
(2) or delete (3) an alarm
1
2
3
183
Devices gt Setup gt Alarms
Alarms
The Alarms tab enables you to compose 1(), edit
(2) or delete (3) an alarm
1
List of actions
2
3
Alarm ruler
184
Devices gt Setup gt Alarms
Alarm Setup
Alarms setup
The value below each hour is the period of
inactivity (in minutes) that would issue an
alarm.For example if put 1 in the value then PMS
I/F will recognize an inactivity when no message
was received from the device in any 1 minute in
the hour.
185
Devices gt Setup gt Alarms
Edit Alarm
The number of successive alarms needed to
activate the action
Action Name the action to be performed. The
available actions are
MsgShow display a message on the screen
MsgPrint print a message
Email send E-mail to the address specified in
the Options/Define window.
Play File the audio/video file to be played (as
an alert) upon activation.
RestartDevice restart the device
RestartPMSI restart PMS Interface
Reboot reboot the PC
Shell The bat, com, or exe specified in the
Play File field is executed
186
Devices gt Setup gt Macros
Macros tab enables you to define alternative
names (short cuts) for commands or command
sequences.
1
2
1
The name must be unique within the device.
2
In the Value field, enter the command sequence.
This may be text, number or unprintable
characters such as 10-LF and 13- CR.
187
Devices gt Setup gt Masks
Masks tab enables you to define the Default Date
Mask that will be used by messages and commands
for this device.
1
1
Either select a date mask from the drop down
combo box or enter any valid date mask.
188
Devices gt Setup gt Data log
Data log tab enables you to define a data log for
a device. A Data Log may be defined to contain
all messages or commands.
To specify the runtime file, into which PMSi will
write the selected data
You may choose to rename the on-line work file or
to append the data (in the online work file) to
anther file. In both cases, the on-line work file
will be cleared.
The frequency as to when the data is rolled over
to the off-line file may be defined as follows
This parameter specifies the name of the off-line
data log file.
189
Customizing the PMS I/F
190
Customizing the PMS I/F
Select a pre-programmed converter data (File)
PCC provides pre-programmed converter data for
Fidelio, HIS and Eltrax. Using the data, it is
easy to integrate the TDA with the FOS.
PC 2
PC 1
LAN/USB
PMS Interface (Fidelio, HIS or Eltrax)
FOS (Fidelio, HIS or Eltrax)
Dongle
COM1
COM1
RS232C
Hotel Front Desk
191
Customizing the PMS I/F
Sometimes, it is necessary to customize the PMS
I/F to adjust FOS requirements, for example
COS Level
COS level sent from FOS represents as
follows, FOS COS 0 for Block, to change PBX COS
4 FOS COS 1 for Local Call, to change PBX COS
1 FOS COS 2 for National Call , to change PBX COS
2 FOS COS 3 for Unblock All Call, to change PBX
COS 3
Call Charge Format
Format1 Charge information (Default) ? Format2
Meter Pulse information
Format1 PSRN ExtNumberPTCDA DateTI TimeDD
DialedNumberDU DurationTA ChargeWS1SO1
Format2 PSRN ExtNumberPTTDA DateTI TimeDD
DialedNumberDU DurationMP Meter Pulse WS1SO1
192
Customizing the PMS I/F
Customer wants to use the meter pulse mode
instead of the actual value for call charge
Call charge Actual value Pulse Euro 0.10 1 Euro
0.20 2 Euro 0.30 3 .. Euro 1.10 11
PC 2
PC 1
Euro 0.30
LAN/USB
PMS Interface
FOS (Fidelio)
Pulse 3
COM1
COM1
RS232C
193
Customizing the PMS I/F
Customer wants to use the meter pulse mode
instead of the actual value for call charge
Format1 (Default) PSRN ExtNumberPTCDA DateTI
TimeDD DialedNumberDU DurationTA
ChargeWS1SO1
Format2 (The Customer want to use) PSRN
ExtNumberPTTDA DateTI TimeDD DialedNumberDU
DurationMP Meter Pulse WS1SO1
194
Customizing the PMS I/F
Step-1 Changing the format
195
Customizing the PMS I/F
196
Customizing the PMS I/F
Format1
Format2
197
Troubleshooting
198
Troubleshooting
When you have trouble with the PMS I/F, please
send the following data
1- xxxx.pmi file 2- xxxx.pmd (FOS and PBX) 3. PMS
I/F Log data 4. TDA system data (Model, Software
Version, DSYS) 5. PMS I/F connection (USB,
LAN?) 6. Symptom
199
Troubleshooting
1- xxxx.pmi file
Please send this file
The current pmi file name.
200
Troubleshooting
2- xxxx.pmd file
Please send these files
201
Troubleshooting
3- PMS I/F Log file (C\Program Files\PMSi\Logs)
Please send this file
Please zip it, because this original file size is
large.
202
Thank you for your patient THE END