> 8.3 | OTAP Parameters

> There is a set of parameters that control the OTAP procedures. These parameters can either be set by AT command (AT^SJOTAP, refer to [1] during the production of the device, or by SM (see Section 8.4) during operation of the device in the field. None of the parameters, which are set by AT command, can be overwritten by SM.

> • | JAD File URL: the location of the JAD file is used to install or update procedures. The JAD file needs to be located on the net (e.g. http://someserver.net/somefile.jad or http://192.168.1.2/somefile.jad ).

> • | Application Directory: this is the directory where a new application (JAD and JAR file) is installed. The delete operation deletes this directory completely. When entering the application directory with AT^SJOTAP or a short message ensure that the path name is not terminated with a slash. For example, type "a:" or "a:/otap" rather than "a:/" or "a:/otap/". See examples provided in Chapter 6.

> • | http User: a username used for authentication with the http server.

> • | http Password: a password used for authentication with the http server.

> • | Bearer: the network bearer used to open the HTTP/TCP/IP connection, either GPRS or CSD.

> • | APN or Number: depending on the selected network bearer this is either an access point name for GPRS or a telephone number for CSD.

> • | Net User: a username used for authentication with the network.

> • | Net Password: a password used for authentication with the network.

> • | DNS: a Domain Name Server’s IP address used to query hostnames.

> • | NotifyURL: the URL to which results are posted. This parameter is only used when the MIDlet-Install-Notify attribute or MIDlet-Delete-Notify attribute is not present in descriptor.

> There are parameters that can only be set by AT command:

> • | SM Password: it is used to authenticate incoming OTAP SMs. Setting this password gives an extra level of security.

> Note: If a password set by AT command, all SMs must include this password

> • | Ignore SM PID (TC65 only): when setting this the PID in received SMs is ignored.

> • | Hide HTTP authentication parameters (TC65 only): this allows to hide the http authentication parameters in the at^sjotap read command and the otap tracer.

> Table 10: | Parameters and keywords

> Parameters | Max. Length AT | Keyword SM | Install/update | delete
> JAD File URL | 100 | JADURL | mandatory | unused
> Application Directory | 50 | APPDIR | mandatory | mandatory
> HTTP User | 32 | HTTPUSER | optional | unused
> HTTP Password | 32 | HTTPPWD | optional | unused
> Bearer | -- | BEARER | mandatory | optional/P
> APN or Number | 65 | APNORNUM | mandatory for CSD | optional/P
> Net User | 32 | NETUSER | optional | optional/P
> Net Password | 32 | NETPWD | optional | optional/P
> DNS | -- | DNS | optional | optional/P
> Notify URL | 100 | NOTIFYURL | optional | optional/P
> SM Password | 32 | PWD | optional | optional
> Ignore SM PID | -- | -- | -- | --
> Hide HTTP authentication parameters | -- | -- | -- | --

> The length of the string parameters in the AT command is limited (see Table 10), the length in the SM is only limited by the maximum SM length.
> The minimum set of required parameters depends on the intended operation (see Table 10).
> “optional/P” indicates that this parameter is only necessary when a POST result is desired.