Free Seating
From Zenitel Wiki
Contents
Overview
The Free Seating system runs on standard AMC SW using the EventHandler and the AlphaPro WACS module for swapping two users. This function needs to have AlphaPro running and connected to the AlphaCom. It’s not possible to use the function without communication with the PC. The communication module of AlphaPro takes care of the changes and updates the exchange(s). The event handler is used to activate and send data messages to AlphaPro. A station with privilege to perform activation of free seating function must be used. A function code must be dialed and a mail will be sent to this station in order to inform about activation of free seating. When this is done it will be possible to do the free seating command from any other station. When dialing another function code from the special station, the free seating function is disabled. The display text will then be removed/updated. The code from the privileged station activates the event handler to send out data protocol messages to AlphaCom when the command for free seating is used. The command for free seating and the directory number for the station to be moved, must be dialed from the new location. A data protocol message will be sent to AlphaPro, which does a move and change in own database and sends the changes to the AlphaCom. When the message is handled, a mail (display message) will be sent to the new location informing about transfer completed. 1.1 Limitations It is necessary to use unique directory numbers (global numbers) if Free Seating should be available over AlphaNet. If not uniqueness there can be directory number conflicts if an already used number is swapped from another node.
Stations with more than the standard 10 DAK will not have the extra DAK swapped between nodes. If the swapped stations are located at the same node the extra DAKs will still work. Event handler script related to the station will not be swapped. All use of physical number relations to swapped station in scripts/DAK will fail. DAK and general event handler scripts using directory number relations to the swapped user will work if unique directory numbers used. Event triggers to a swapped station will not work. The swapped stations are not tested if they are default member of a conference. Therefore stations that are default member of conference should not be swapped. It is not possible to execute two free seating operations simultaneously.
AlphaPro Event programming
General
Two examples are described below. Use of toggle feature example is less programming, but not so flexible in synchronization of Free Seating enable/disable between nodes from one privileged station. In UserDefinedData example it is possible to let one privileged station in the system to enable/disable the Free Seating feature on several nodes.
Use of Toggle Feature Example
Event Handling Programming Free Seating Swap
Dir. number 9535 Feature type 95 Code dialed from the user where the Free Seating should be activated. Parameter (%2.ref) is directory number for the user to swap with. Event trigger type 25.
Event setting example:
Owner Type: “Station w.UDP” id = “UDP group” Event Type “25 Future use” Sub-type = “0” When Change To “On or OFF” When Related To “All” Id = “ | 0”
Action string:
@01CB M0090 %1.ref %2.ref
Send message type 90 to node 1 AlphaPro device (CB/203 = AlphaPro device number) with info about stations to be swapped.
$DISCON_ST %1.ref 0
Disconnect station without tone
Privileged Station Settings
Use feature 7873 on privileged station to Enable/Disable Free Seating on node
DAK I 7873 I 9535
Use of UserDefinedData Example
Index 1 is used for free seating active = 1, not active = 0
Event Handling Programming Activate Free Seating
Dir. number 7941 Feature 52 Dialing code from privileged station will activate free seating. Send display text to privileged station Script programmed only for privileged station. Set UserDefinedData 1 = 1. Feature 52 Dir. number 7941 Event trigger type 15
Event setting example: Owner Type: “Station id” id = “1” Event Type “15 Event Trigger Feature” Sub-type = “0” When Change To “On or OFF” When Related To “Directory Number” Id = “0 | 7941” Action string: wudd 1 1 $DSPL %1.ref U18 0312 ' Free Se Enabled ' @0241 $DD 4302080001 L7941 Also enable free seating in node 2(superuser on station 1).
Event Handling Programming Deactivate Free Seating
Dir. number 7942 Feature 52 Dialing code from privileged station will deactivate free seating. Set UserDefinedData 1 = 0. Send display text to privileged station Script programmed only for privileged station. Event trigger type 15 Event setting example: Owner Type: “Station id” id = “1” Event Type “15 Event Trigger Feature” Sub-type = “0” When Change To “On or OFF” When Related To “Directory Number” Id = “0 | 7942” Action string: wudd 1 0 $DSPL %1.ref U18 0312 'Free Se Disabled’ @0241 $DD 4302080001 L7942 Also enable free seating in node 2 (superuser on station 1).
Event Handling Programming Free Seating Swap
Dir. number 7943 Feature type 95 Code dialed from the user where the Free Seating should be activated. Parameter (%2.ref) is directory number for the user to swap with. Event trigger type 25.
Event setting example: Owner Type: “Station w.UDP” id = “UDP group” Event Type “25 Future use” Sub-type = “0” When Change To “On or OFF” When Related To “All” Id = “ | 0” Action string: IF %OP(%udd(1),=,1) @01CB M0090 %1.ref %2.ref Send message type 90 to node 1 AlphaPro device (CB/203 = AlphaPro device number) with info about stations to be swapped. $DISCON_ST %1.ref 0 STOP ENDIF $DSPL %1.ref U18 0312 ‘Free Se Disabled' Error message if Free Seating not active
Display messages
The user gets information from the display when the free seating feature is started. If the swap is valid, the user will see “Please wait x” in the display of both stations. When the swap is completed the displays will show “Swap completed x”.
Error codes
If the user feeds the feature with an invalid directory number, there will be shown an “Invalid number/xxx” message, followed with an error code. 4 => Directory number are not a station. 9 => Directory number 1 is not a global member in a remote node 10 => Directory number 2 is not a global member in a local node 12 => Can't swap same Directory number 13 => Directory number 1 defined with wrong feature. 14 => Directory number 2 defined with wrong feature. If AlphaPro and the communication module (WACS) is not running the user will not receive any display messages.