Actions

Difference between revisions of "SEND MAIL"

From Zenitel Wiki

 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
{{AI}}
 
{| border="1"   
 
{| border="1"   
 
|-
 
|-
 
!style="background:#ffdead;" width="90pt" colspan="2"|SEND_MAIL
 
!style="background:#ffdead;" width="90pt" colspan="2"|SEND_MAIL
 
!style="background:#ffdead;" width="100pt"|0x0031
 
!style="background:#ffdead;" width="100pt"|0x0031
!style="background:#ffdead;" width="30pt"|49
+
!style="background:#ffdead;" |49
!style="background:#ffdead;" width="100pt"|AMC 05.00
+
!style="background:#ffdead;" |AMC 05.00
 
|-
 
|-
|colspan="3"|'''$SM L101 L102'''<br\>'''$SM L101 L102 U100 NM18 GV U1'''<br\>'''$SM L101 L102 U100 NM26 GV U0'''<br\>'''$SM L101 L102 U100 NM17 GV U1 'my name' U0'''||colspan="2"|''Call Request mail (from AMC 08.11)''<br\>''Call Request mail''<br\>''‘Temperature Alarm’''<br\>''Call request, user defined name text''
+
|colspan="3"|'''$SM L101 L102'''<br />'''$SM L101 L102 U100 NM18 GV U1'''<br />'''$SM L101 L102 U100 NM26 GV U0'''<br />'''$SM L101 L102 U100 NM17 GV U1 'my name' U0'''||colspan="2"|''Call Request mail (from AMC 08.11)''<br />''Call Request mail''<br />''‘Temperature Alarm’''<br />''Call request, user defined name text''
 
|-
 
|-
|colspan="5"|Send a predefined mail message to an intercom station.<br\><br\>  
+
|colspan="5"|Send a predefined mail message to an intercom station.<br /><br />  
From AMC 08.11 most parameters can be left out.  Default values correspond to Normal priority Call Request.<br\>
+
From AMC 08.11 most parameters can be left out.  Default values correspond to Normal priority Call Request.<br />
 
[[AlphaNet]]:  Be aware of which exchange fills in default parameters, see page 70. <br> Also see [[SEND_TXT_MAIL]].
 
[[AlphaNet]]:  Be aware of which exchange fills in default parameters, see page 70. <br> Also see [[SEND_TXT_MAIL]].
 
|-
 
|-
|align=center|1||[[NET_OBJ_REF]]<br\>{[[ECL_STATION]]}||colspan="3"|Sending station.<br\>Null value allowed (e.g.for technical alarms).
+
|align=center|1||[[NET_OBJ_REF]]<br />{[[ECL_STATION]]}||colspan="3"|Sending station.<br />Null value allowed (e.g.for technical alarms).
 
|-
 
|-
|align=center|2||[[NET_OBJ_REF<br\>{[[ECL_STATION]],<br\>[[ECL_ST_GROUP]]}]]||colspan="3"|Receiving station or local group.<br\>.<br\>.
+
|align=center|2||[[NET_OBJ_REF]]<br />{[[ECL_STATION]],<br />[[ECL_ST_GROUP]]}||colspan="3"|Receiving station or local group.<br />.<br />.
 
|-
 
|-
|align=center|3||[[UINT1]]<br\>(optional 08.11)||colspan="3"|Mail Priority 0 - 255<br\> [[#Mail priority|see below:]] <br> Default value: 100.
+
|align=center|3||[[UINT1]]<br />(optional 08.11)||colspan="3"|Mail Priority 0 - 255<br /> [[#Mail priority|see below:]] <br> Default value: 100.
 
|-
 
|-
|align=center|4||[[NET_OBJ_REF]]<br\>{[[NRF_LOCAL_DIRNO]]<br\>[[ECL_MAIL]]<br\>[[ECL_MAIL]]}<br\>(optional 08.11)||colspan="3"|Which Mail Message or Null if no message.  See [[Predefined AlphaCom mails]].<br\>-> Mail message with directory number.<br\>-> Call Request, mail individ 17 (alarm) and 18 (normal).<br\>-> Technical alarm, mail individ 19­-30. <br\>Default value: 18.
+
|align=center|4||[[NET_OBJ_REF]]<br />{[[NRF_LOCAL_DIRNO]]<br />[[ECL_MAIL]]<br />[[ECL_MAIL]]}<br />(optional 08.11)||colspan="3"|Which Mail Message or Null if no message.  See [[Predefined AlphaCom mails]].<br />-> Mail message with directory number.<br />-> Call Request, mail individ 17 (alarm) and 18 (normal).<br />-> Technical alarm, mail individ 19­-30. <br />Default value: 18.
 
|-
 
|-
|align=center|5||[[NET_OBJ_REF]]<br\>(optional 08.11)||colspan="3"|Extra parameter (time / date / phone number) in [[DIGIT_STRING]] format. <br\>Default value: Null.  
+
|align=center|5||[[NET_OBJ_REF]]<br />(optional 08.11)||colspan="3"|Extra parameter (time / date / phone number) in [[DIGIT_STRING]] format. <br />Default value: Null. <br> (From 13.1.3.1) Custom Voice message for call request as parameter. Format N!!<message id>. Note : L<dirno> (e.g. L8194) is not supported. 
 
|-
 
|-
|align=center|6||[[UINT1]]<br\>(optional 08.11)||colspan="2"|Mail Flags: [[#Mail flags|see below]]<br\>Default value: 1.||AMC 07.00
+
|align=center|6||[[UINT1]]<br />(optional 08.11)||colspan="2"|Mail Flags: [[#Mail flags|see below]]<br />Default value: 1.||AMC 07.00
 
|-
 
|-
|align=center|7||[[TEXT16]]<br\>(optional 07.60)||colspan="2"|Name of sending station (16 character).<br\>Default value:  Sending station’s name.||AMC 07.00
+
|align=center|7||[[TEXT16]]<br />(optional 07.60)||colspan="2"|Name of sending station (16 character).<br />Default value:  Sending station’s name.||AMC 07.00
 
|-
 
|-
|align=center|8||[[UINT1]]<br\>(optional 07.60)||colspan="2"|User Defined Properties ([[UDP]]) of the sending station. <br\>Default value: 0. <br\>Note:  If Parameter 7 is used, this parameter MUST be filled in also.||AMC 07.00
+
|align=center|8||[[UINT1]]<br />(optional 07.60)||colspan="2"|User Defined Properties ([[UDP]]) of the sending station. <br />Default value: 0. <br />Note:  If Parameter 7 is used, this parameter MUST be filled in also.||AMC 07.00
 
|-
 
|-
|align=center|9||[[UINT1]]<br\>(optional)||colspan="3"|Hop Count.  [[AlphaNet]]:  Used to avoid endless mail forwarding.  Incremented by [[AMC]], discarded when too large.<br\>Default value: 0.
+
|align=center|9||[[UINT1]]<br />(optional)||colspan="3"|Hop Count.  [[AlphaNet]]:  Used to avoid endless mail forwarding.  Incremented by [[AMC]], discarded when too large.<br />Default value: 0.
 
|-
 
|-
 
|colspan="2"|Response:||colspan="3"|[[SEND_MAIL_ACK]], [[SET_CALL_REQ_MODE]]
 
|colspan="2"|Response:||colspan="3"|[[SEND_MAIL_ACK]], [[SET_CALL_REQ_MODE]]
Line 46: Line 47:
  
 
* = 110  Default priority for mail upon fire alarm.
 
* = 110  Default priority for mail upon fire alarm.
* >= 120 Threshold: Receiver gets [[Urgent Feature Reminder]] tone (repeated dut-dut-dut)
+
* >= 120 Threshold: Receiver gets [[Urgent feature reminder]] tone (repeated dut-dut-dut)
 
* = 140  Default priority for "high priority" Call Requests  (dirno 622)
 
* = 140  Default priority for "high priority" Call Requests  (dirno 622)
 
* = 141  Def. pri. for "high pri." Call Requests alternative text (dirno 624)
 
* = 141  Def. pri. for "high pri." Call Requests alternative text (dirno 624)
Line 60: Line 61:
 
* bit 3 (value 4) = Display the mail in Idle on normal stations. (MAIL_FLAG_IDLE_SHOW)
 
* bit 3 (value 4) = Display the mail in Idle on normal stations. (MAIL_FLAG_IDLE_SHOW)
  
* bit 4 (value 8) = If a call request with this flag is deleted from one station, then delete all call request mails from all station with same source address. (MAIL_FLAG_ALL_CREQ_DEL, new in AMC 10.22)
+
* bit 4 (value 8) = Ringing group functionality. If a call request with this flag is deleted from one station, then delete all call request mails from all stations with the same source address. If the requester station exit call request mode, the mail is deleted. (MAIL_FLAG_ALL_CREQ_DEL, new in AMC 10.22)
  
 +
* bit 5 (value 16) = If priority is in the private ringing mode range use UK style ringing pattern. (MAIL_FLAG_PRIV_RING_UK, new in AMC 10.22)
 +
 +
== Related articles ==
 +
[[Send Mail command $SM and Cancel Mail command $CANM used in AlphaNet (Event Handler)]]
  
 
[[AlphaNet_Data_Protocol#Station_Mail_Operations|Back to AlphaNet message list]]
 
[[AlphaNet_Data_Protocol#Station_Mail_Operations|Back to AlphaNet message list]]
 +
[[Category: ACDP messages]]
 +
[[Category: DP Commands]]

Latest revision as of 11:57, 30 June 2022

AI.png
SEND_MAIL 0x0031 49 AMC 05.00
$SM L101 L102
$SM L101 L102 U100 NM18 GV U1
$SM L101 L102 U100 NM26 GV U0
$SM L101 L102 U100 NM17 GV U1 'my name' U0
Call Request mail (from AMC 08.11)
Call Request mail
‘Temperature Alarm’
Call request, user defined name text
Send a predefined mail message to an intercom station.

From AMC 08.11 most parameters can be left out. Default values correspond to Normal priority Call Request.
AlphaNet: Be aware of which exchange fills in default parameters, see page 70.
Also see SEND_TXT_MAIL.

1 NET_OBJ_REF
{ECL_STATION}
Sending station.
Null value allowed (e.g.for technical alarms).
2 NET_OBJ_REF
{ECL_STATION,
ECL_ST_GROUP}
Receiving station or local group.
.
.
3 UINT1
(optional 08.11)
Mail Priority 0 - 255
see below:
Default value: 100.
4 NET_OBJ_REF
{NRF_LOCAL_DIRNO
ECL_MAIL
ECL_MAIL}
(optional 08.11)
Which Mail Message or Null if no message. See Predefined AlphaCom mails.
-> Mail message with directory number.
-> Call Request, mail individ 17 (alarm) and 18 (normal).
-> Technical alarm, mail individ 19­-30.
Default value: 18.
5 NET_OBJ_REF
(optional 08.11)
Extra parameter (time / date / phone number) in DIGIT_STRING format.
Default value: Null.
(From 13.1.3.1) Custom Voice message for call request as parameter. Format N!!<message id>. Note : L<dirno> (e.g. L8194) is not supported.
6 UINT1
(optional 08.11)
Mail Flags: see below
Default value: 1.
AMC 07.00
7 TEXT16
(optional 07.60)
Name of sending station (16 character).
Default value: Sending station’s name.
AMC 07.00
8 UINT1
(optional 07.60)
User Defined Properties (UDP) of the sending station.
Default value: 0.
Note: If Parameter 7 is used, this parameter MUST be filled in also.
AMC 07.00
9 UINT1
(optional)
Hop Count. AlphaNet: Used to avoid endless mail forwarding. Incremented by AMC, discarded when too large.
Default value: 0.
Response: SEND_MAIL_ACK, SET_CALL_REQ_MODE

Mail priority

Parameter 3

  • = 30 Default priority for standard mail (sent from conversation, 7 + 66x; or 8)
  • >= 60 Threshold: Receiver gets notification tone(single dut-dut-dut)
  • = 80 Default priority for tech. alarm mail messages (RCI strings).
  • >= 100 Threshold: Received Mail event generated on receiver (changeable : ex_profile. glob_const.queue_ind_priority)
  • = 100 Default priority for "low priority" Call Requests (dirno 623)
  • = 101 Default priority for "low priority" Call Requests alternative text (dirno 625)
  • = 110 Default priority for mail upon fire alarm.
  • >= 120 Threshold: Receiver gets Urgent feature reminder tone (repeated dut-dut-dut)
  • = 140 Default priority for "high priority" Call Requests (dirno 622)
  • = 141 Def. pri. for "high pri." Call Requests alternative text (dirno 624)
  • >= 150 Threshold: Receiver gets ring tone (changeable : ex_profile.glob_const.priv_ring_mail_pri)

Mail flags

Parameter 6 is a combination of any the following bits/flags:

  • bit 1 (value 1) = the mail is a call request. The station receiving the mail will respond with SET_CALL_REQ_MODE to the sender station. (MAIL_FLAG_CALL_REQUEST)
  • bit 2 (value 2) = the mail is sent to a group of stations and you want the mail deleted from all queues once the mail has been read by a station. (MAIL_FLAG_GROUP_DELETE)
  • bit 3 (value 4) = Display the mail in Idle on normal stations. (MAIL_FLAG_IDLE_SHOW)
  • bit 4 (value 8) = Ringing group functionality. If a call request with this flag is deleted from one station, then delete all call request mails from all stations with the same source address. If the requester station exit call request mode, the mail is deleted. (MAIL_FLAG_ALL_CREQ_DEL, new in AMC 10.22)
  • bit 5 (value 16) = If priority is in the private ringing mode range use UK style ringing pattern. (MAIL_FLAG_PRIV_RING_UK, new in AMC 10.22)

Related articles

Send Mail command $SM and Cancel Mail command $CANM used in AlphaNet (Event Handler)

Back to AlphaNet message list