IDENTIFYING INFORMATION
#######################
APPID: wA.
APPID type: OMNA.
Owner: Open Mobile Alliance
Contact: technical-comments@mail.openmobilealliance.org
Registration version: 1.
Registration timestamp: 2005-07-27.
Application description: Instant Messaging and presence services (IMPS).
Application reference: None.

WELL-KNOWN PARAMETERS
#####################
Characteristic/name: APPLICATION/APPID.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: wA.
Interpretation: N/A.
-------
Characteristic/name: APPLICATION/PROVIDER-ID.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: N/A.
Interpretation: N/A.
-------
Characteristic/name: APPLICATION/NAME.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: N/A.
Interpretation: User displayable name for instant messaging and presence service server.
-------
Characteristic/name: APPLICATION/AACCEPT.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: application/vnd.wv.csp+xml;1.3;1.2;1.1;1.0,application/vnd.wv.csp+wbxml;1.3;1.2;1.1;1.0,application/vnd.wv.csp.sms;1.3;1.2;1.1;1.0.
Interpretation: Specifies the WSP content type codes with the version numbers server is supporting.
-------
Characteristic/name: APPADDR/ADDR.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: N/A.
Interpretation: Instant messaging and presence service server address, which may differ based on the used transport binding. Also APPLICATION/ADDR can be used to specify the address, if the parameter APPADDR/ADDRTYPE is not used.
-------
Characteristic/name: APPADDR/ADDRTYPE.
Status: Required.
Occurs: 1/1.
Default value: None.
Used values: "E164".
Interpretation: When the value is omitted, the address type is absolute URI. The "E164" is described below.
-------
Characteristic/name: APPLICATION/TO-PROXY.
Status: Required if use of Proxy supported.
Occurs: 0/*.
Default value: None.
Used values: N/A.
Interpretation: N/A.
-------
Characteristic/name: APPLICATION/TO-NAPID.
Status: Required if direct use of Network Access Point supported.
Occurs: 0/*. 
Default value: None.
Used values: N/A.
Interpretation: N/A.
-------
Characteristic/name: APPAUTH/AAUTHLEVEL.
Status: Required.
Occurs: 0/1.
Default value: "APPSRV".
Used values: "APPSRV".
Interpretation: 
	When the value is omitted, the characteristic contains client credentials 
	for HTTP or WSP authentication. The used values are described below.
-------
Characteristic/name: APPAUTH/AAUTHNAME.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: N/A.
Interpretation: N/A.
-------
Characteristic/name: APPAUTH/AAUTHSECRET.
Status: Optional.
Occurs: 0/1.
Default value: None.
Used values: N/A.
Interpretation: N/A.
-------

APPLICATION-SPECIFIC PARAMETERS
###############################
Characteristic/name: APPLICATION/SERVICES.
Status: Required.
Occurs: 1/1. 
Default value: None.
Used values: IM;PS;GR
Interpretation: High-level supported service list.
	IM - instant messaging
	PS - presence
	GR - groups
-------

Characteristic/name: APPLICATION/CIDPREFIX.
Status: Optional.
Occurs: 0/1. 
Default value: None.
Used values: N/A.
Interpretation: CIDPrefix is a string value containing the provider-specific Client-ID part.
The CIDPrefix in terms of character set MUST follow the Client-ID syntax defined in OMA IMPS standard.
A client upon receiving the CIDPrefix MUST append two hash marks (‘##’) and the internal Client-ID to the CIDPrefix, and MUST use the resulting string as ClientID whenever it accesses the SAP for which the configuration message is valid. The formula that describes the aforementioned concatenation is:
	ClientID = [ <CIDPrefix> + "##" + ] <Internal ClientID>
The CIDPrefix MUST be formatted in a manner that after the concatenation described above the Client-ID remains conformant to the Client-ID syntax that is defined in the OMA IMPS standard.
When CIDPrefix is missing from the configuration message, the client MUST use the internal ClientID without changes.
The OMA IMPS standard allows 200 characters for Client-IDs. In order to guarantee that the generated Client-ID will not exceed this limit, the CIDPrefix MUST NOT be longer than 99 characters, and if the internal (client-implementation-specific) Client-ID is longer than 99 characters, it MUST be truncated.
-------

PARAMETER VALUES
################
Characteristic/name/parameter: APPADDR/ADDRTYPE/E164.
Status: Required.
Interpretation: 
	Used for non IP bearers (e.g. SMS).
--------

EXAMPLE
#######
<characteristic type="APPLICATION">
  <parm name="APPID" value="wA"/>
  <parm name="PROVIDER-ID" value="Some operator"/>
  <parm name="NAME" value="Some IMPS Server"/>
  <characteristic type="APPAUTH">
     <parm name="AAUTHLEVEL" value="APPSRV"/>
     <parm name="AAUTHNAME" value="username"/>
     <parm name="AAUTHSECRET" value="password"/>
  </characteristic>
  <parm name="AACCEPT" value="application/vnd.wv.csp+xml;1.3;1.2;1.1;1.0,application/vnd.wv.csp+wbxml;1.3;1.2;1.1;1.0"/>
  <parm name="ADDR" value="http://123.56.78.90"/>
  <parm name="ADDR" value="https://123.56.78.90"/>
  <parm name="TO-NAPID" value="INTERNET"/>
  <parm name="TO-PROXY" value="123.56.78.90"/>
  <parm name="SERVICES" value="IM;PR;GR"/>
</characteristic>

<characteristic type="APPLICATION">
  <parm name="APPID" value="wA"/>
  <parm name="PROVIDER-ID" value="Another operator"/>
  <parm name="NAME" value="Another IMPS Server"/>
  <characteristic type="APPAUTH">
    <parm name="AAUTHLEVEL" value="APPSRV"/>
     <parm name="AAUTHNAME" value="username"/>
     <parm name="AAUTHSECRET" value="password"/>
  </characteristic>
  <parm name="AACCEPT" value="application/vnd.wv.csp.sms;1.3;1.2"/>
  <characteristic type="APPADDR"/>
     <parm name="ADDRTYPE" value="E164"/>
     <parm name="ADDR" value="+1234567890"/>
  </characteristic>
  <parm name="TO-NAPID" value="SNAP"/>
  <parm name="SERVICES" value="IM;PR"/>
</characteristic>

###END###
