Actions

Difference between revisions of "SEND MAIL"

From Zenitel Wiki

(Added description of new mail flags, moved the description of the mailflags to seperate section.)
Line 1: Line 1:
{| border="1" align=left
+
{| border="1"
 
|-
 
|-
 
!style="background:#ffdead;" width="90pt" colspan="2"|SEND_MAIL
 
!style="background:#ffdead;" width="90pt" colspan="2"|SEND_MAIL
Line 22: Line 22:
 
|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.  
 
|-
 
|-
|align=center|6||[[UINT1]]<br\>(optional 08.11)||colspan="2"|Mail Flags:<br\>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. <br\>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. <br\>Combinations of bits allowed.<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
Line 33: Line 33:
 
|-
 
|-
 
|}
 
|}
 +
<p>
 +
==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)

Revision as of 12:21, 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\>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 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)