Difference between revisions of "SEND MAIL"
From Zenitel Wiki
(Added description of new mail flags, moved the description of the mailflags to seperate section.) |
(Document mail priorities) |
||
| Line 16: | Line 16: | ||
|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\>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 page 17.<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 page 17.<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. | ||
| Line 34: | Line 34: | ||
|} | |} | ||
<p> | <p> | ||
| + | ==Mail priority== | ||
| + | Parameter 3 | ||
| + | |||
| + | * = 30 Default priority for standard mail. | ||
| + | * >= 60 Threshold: Receiver gets notification tone(single dut-dut-dut) | ||
| + | * = 80 Default priority for tech. alarm mail messages. | ||
| + | |||
| + | * = 100 Default priority for "low priority" Call Requests | ||
| + | * = 101 Default priority for "low priority" Call Requests alternative text | ||
| + | |||
| + | * = 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 | ||
| + | * = 141 Def. pri. for "high pri." Call Requests alternative text | ||
| + | * >= 150 Threshold: Receiver gets ring tone (changeable : ex_profile.glob_const.priv_ring_mail_pri) | ||
| + | |||
==Mail flags== | ==Mail flags== | ||
Parameter 6 is a combination of any the following bits/flags: | Parameter 6 is a combination of any the following bits/flags: | ||
Revision as of 12:42, 26 June 2007
| SEND_MAIL | 0x0031 | 49 | AMC 05.00 | |
|---|---|---|---|---|
| $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 | Call Request mail (from AMC 08.11)<br\>Call Request mail<br\>‘Temperature Alarm’<br\>Call request, user defined name text | |||
| Send a 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\> AlphaNet: Be aware of which exchange fills in default parameters, see page 70 | ||||
| 1 | NET_OBJ_REF<br\>{ECL_STATION} | Sending station.<br\>Null value allowed (e.g.for technical alarms). | ||
| 2 | [[NET_OBJ_REF<br\>{ECL_STATION,<br\>ECL_ST_GROUP}]] | Receiving station or local group.<br\>.<br\>. | ||
| 3 | UINT1<br\>(optional 08.11) | Mail Priority 0 - 255<br\> see below: Default value: 100. | ||
| 4 | NET_OBJ_REF<br\>{NRF_LOCAL_DIRNO<br\>ECL_MAIL<br\>ECL_MAIL}<br\>(optional 08.11) | Which Mail Message or Null if no message. See page 17.<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. | ||
| 5 | NET_OBJ_REF<br\>(optional 08.11) | Extra parameter (time / date / phone number) in DIGIT_STRING format. <br\>Default value: Null. | ||
| 6 | UINT1<br\>(optional 08.11) | Mail Flags: see below<br\>Default value: 1. | AMC 07.00 | |
| 7 | TEXT16<br\>(optional 07.60) | Name of sending station (16 character).<br\>Default value: Sending station’s name. | AMC 07.00 | |
| 8 | UINT1<br\>(optional 07.60) | 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 | |
| 9 | UINT1<br\>(optional) | Hop Count. AlphaNet: Used to avoid endless mail forwarding. Incremented by AMC, discarded when too large.<br\>Default value: 0. | ||
| Response: | SEND_MAIL_ACK, SET_CALL_REQ_MODE | |||
Mail priority
Parameter 3
- = 30 Default priority for standard mail.
- >= 60 Threshold: Receiver gets notification tone(single dut-dut-dut)
- = 80 Default priority for tech. alarm mail messages.
- = 100 Default priority for "low priority" Call Requests
- = 101 Default priority for "low priority" Call Requests alternative text
- = 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
- = 141 Def. pri. for "high pri." Call Requests alternative text
- >= 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) = 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)