Introduction

Unlike other messaging system which passively transports data, Net2MAX supports active messages that perform an unlimited number of actions.

Action Messages "tell" Net2MAX applications what actions to perform at what time or under what conditions. It is the first time a messaging standard has been developed for both "human to machine" and "machine to machine" communications.

This Action Messages are designed to be very concise so they can be input from handheld devices like mobile phones and PDAs very easily. Their concise nature also allows them to operate over bandwidth limited transports like SMS and instant messaging clients.

Basic Structure

The structure for an Action Message is very simple: (xxxxxxxx)

where xxxxxx is the Action Message. Everything inside the () within a text message are treated as Action Message and will be processed by Net2MAX as commands from you to it.

If there are already () within the text message then, the Action Message will be of the format (OZxxxxxxx) where xxxxxxxx is the Action Message. Whenever Net2MAX sees (OZxxxxxxx) it will ignore all () - leaving them alone as user data and not commands to it.

Detail Format

The xxxxxxx is made up of a number of 5 optional components

(ActionTime OutputType OutputTarget ActionType ActionTarget)

There are actually NO space in an Action Message, spaces above are shown for clarity purposes - separating out different components of an Action Message.

An example a of text message:

"(E92117) How are you?"

Received by Net2MAX via SMS, email, ICQ or whatever medium, will initiate an Action that will send an Email to OZnumber 92118 with the content of "How are you?"

Note that in the example, there is no ActionTIme, ActionType, ActionTarget. Only the OutputType E and OutputTarget 92117 are specified. (OutputType OutputTarget).

Also note that, the sample message is the same as "How are you? (E92117)" and the same as "How (E92117) are you?". The location of the Action Message within a text message does not matter.

The text message that the Action Message is in (whatever text surrounding the Action Message) is always passed to the Output Target.

Within ( ) or (OZ )

Action Messages can be embedded in any text message and be transported by any mechanism that support text (e.g. email, SMS, web, WAP etc.)

Action messages are formed by having commands between ( and ) characters. If the user already has data that contains ( and ) characters in the same message, then they have to use (OZ to start off the Action Message. The commands will then be between (OZ and ) and the ( without OZ behind will be ignored and they are assumed to be user data. Otherwise by default "(" will be processed as the start of an Action Message.

Format:

1. ( )
2. (OZ)
   Note that ( ) is the default format.

Example:

If the message body contains:

• (OZE91136) Net2MAX will send a message to the email address of 91136
  
• (E91136)(E91138) Net2MAX will send a message to the email address of 91136 and 91138
  
• (OZE91136)(E91138) Net2MAX will ONLY send a message to the email address of 91136

Output Type

Action Messages can send the output or the result of an action to a number of different devices.

Format:

1. P=Phone
2. F=Fax
3. E=Email
4. S=SMS
5. I=ICQ
6. J=Jabber
7. C=Chat
8. O=OZvoice alert message

Example:

If the message body contains:

(P91136) Net2MAX will send a text-to-speech message to the phone numebr of 91136

(F91136) Net2MAX will send a text-to-image message to the fax number of 91136

(E91136) Net2MAX will send a text message to the email address of 91136

(S91136) Net2MAX will send a text message to the mobile number of 91136

Output Target

For each device the output target or destination must be specified. This
can be a real destination number like a phone number or an OZnumber.

By specifying an OZnumber, the appropriate destination for that OZmember will be used automatically. That is the the phone number, email address, etc. from the OZmember profile (ozmember_slow) will be selected as required, the sender does NOT need to know or remember any phone numbers or email addresses, etc. of the target OZmember.

Format:

1. OZnumber
2. Real Destination - in between **
If not specified, the default output target is OZnumber of Sender

Example:

(E91136) Net2MAX will send a text message to the email address of 91136

(E*test@oztell.com*) Net2MAX will send a text message to the email
address of test@oztell.com

(P*61292176000*) Net2MAX will send a text-to-speech message to the phone number +61292176000

Action Type

A number of Actions have been defined with more actions to be added as required. If not specified, then there is not action and the message becomes a standard passive message that got send to the Output Target.

Format:

A=Account - accounts operation
U=URL - URL operation
C=Calendar - calendar operation
M=Mailbox - mailbox operation

Example:

(E91136A) Net2MAX will send a text message to the email address of 91136 containing the balance in her OZaccount

(PA) Net2MAX will send an voice message to phone number of Sender containing the balance in her OZaccount

(F91136C) Net2MAX will send a fax message to the fax number of 91136 containing the calendar events for today

(SM) Net2MAX will send an SMS message to mobile number of Sender containing the titles of emails in her Inbox

Action Target

Each Action listed above (A, U, C, M) needs a target to perform the action to.
If not specified, then the target is the output target.
If output target is not specified either, the target becomes the sender of the message.

Formats for Account actions (A):

1. ActionTarget=OZnumber - Return OZaccount Balance of the OZnumber
2. ActionTarget=OZnumber - Return OZvendor Balance of the Sender OZnumber, if supplied OZnumber is an OZvendor
3. ActionTarget=OZnumber*Amount - Transfer from Sender OZnumber to supplied OZnumber (must be an OZvendor) If not specified, the default ActionTarget is OZnumber of Sender

Examples of Account actions (A):

(E91136A)Net2MAX will send a text message to the email address of 91136 containing the balance in her OZaccount

(PA) Net2MAX will send an voice message to phone number of Sender containing the balance in her OZaccount

(PA91138) Net2MAX will send an voice message to phone number of Sender containing the balance in 91138's OZaccount

(P91136A91138) Net2MAX will send an voice message to phone number of 91136 containing the balance in 91138's OZaccount

(FA9138*10) Net2MAXwill transfer from Sender's OZaccount to 91138's OZaccount thensending a confirmation to the Sender's fax number.

Formats for URL actions (U):

1. ActionTarget=OZnumber - Return result of accessing the URL in OZmember Profile. If not specified, the default ActionTarget is OZnumber of Sender
2. ActionTarget=*URL* - Return result of accessing a URL defined by
Sender If not specified.
The default ActionTarget is HTTP of OZnumber of
Sender

Examples for URL actions (U):

(E91136U91138) Net2MAX will get the results from the URL defined by 91138 and send to 91136's email address
(E91136U*www.oztell.com*)Net2MAX will get the results from www.oztell.com and send to 91136's email address

Formats of Calendar actions ( C ):

There are three calendars for each OZmember (personal,
public, action)
1. ActionTarget=Empty - Return the events from all three calendars of the Sender for today
2. ActionTarget=OZnumber - Return the events from the public calendar of the OZnumber for today
3.ActionTarget=*Date - Return the events from all 3 calendars of the Sender for supplied Date
4. ActionTarget=OZnumber*Date - Return the events from the public calendar of the OZnumber for supplied Date
5. ActionTarget=*Date*Time*Timezone*Repeat*Offset*Duration*Type - Return confirmation of inserting/deleting an event either in the public or personal calendar (delete if duration is negative)
Default values are the same as ActionTime. Duration default is 15 minutes and Type default is Public calendar (P=Public, M=Member, A=Action, 'A' for query only).

Examples of Calendar actions ( C ):

(FC) Today's calendar for the sender will be faxed to her mobile
(S91138C91136) Today's calendar for 91136 will be sent to 91138's mobile via SMS
(S91138C91136*030123) 23-Jan-2003's calendar for 91136 will be sent to 91138's mobile via SMS
(EC*030123*1315****15*M) Book an appointment in the public calendar on 23-Jan-2003 starting at 1:15pm local time and lasts for the default 15 minutes.

Formats of Mailbox actions (M):

Subject lines of mails in the OZinbox can be retrieved
1. ActionTarget=Empty - return subject lines of unread mails in the Sender's OZinbox
2. ActionTarget=1 - return subject lines of read mails in the Sender's OZinbox

Examples of Mailbox actions (M):

(SM) Send an SMS of the subject lines of unread mails.

There are circumstances when you may wish to leave the 'Sender' parameter empty but embed this information into the text command. For example:
(A91121 123456)(E91142)some message
The sender's oznumber and ozsignature is given as 91121, 123456. If authenticated, the above command shall send 91142 an email with the email body "some message".

3. Circumstance when 'Sender' may be empty
The 'Sender' field can ONLY be empty if the recipient is a user of OZcontact. When sending message to a OZcontact user, the calling program may not pass the oznumber of the Sender. If this is the case, fee is deducted from the recipient's account if the process incurs any fee.

Action Message Addresses

The following addresses are for EXPERIMENTIAL purposes only. Not for production use. You should set up your own accounts to process your own Action Messages.

For SMS
(1) Send text message to: +61 410 311 070
(2) The mobile phone number for sending the SMS will be used to look up your OZnumber - which will be set as the Sender of the Action Message.

For Email
(1) Send text message to: xoztralia@oztralia.com
(2) Put your OZnumber and OZsignature in the Subject
(3) Put the Action Message in the Body
(4) Once verified the OZnumber in the subject will be set as the Sender of the Action Message.

For ICQ
(1) Send text message to: xoztralia (nick name) or 340609719
For MSN
For Jabber xoztralia