The SendNtfn.exe utility (sdk_installdir/SendNtfn.exe) is a Windows utility that allows you to send and manage notifications. Specifically, it allows you to:
The SendNtfn.exe utility is designed primarily for prototyping and testing applications that send notifications. For production applications, it is recommended that you use the COM interface or the C++ Notification API, which are described in the UP.SDK Developer's Guide.
To use the SendNtfn.exe utility to send secure notifications, you must first obtain and install a certificate as described in Requesting certificates with CertMaker.
When you start SendNtfn.exe, it display the window shown in Figure 2-2.
FIGURE 2-2. SendNtfn.exe utility
The following table describes the fields in the SendNtfn window.
| Field | Description |
|---|---|
Specify the name of the host on which the UP.Link Messenger is running. The Messenger is the UP.Link server component that handles notifications. | |
Specify the notification URL. For prefetch notifications, this is the URL of the digest that will be preloaded into the phone's cache; for alerts, this is the URL that will be fetched when the user requests the alert from the phone's status card. The URL must be hosted on the domain for which the certificate was issued. For more information, see Requesting certificates with CertMaker. | |
The ID of the subscriber to whom the notification is addressed. | |
Set the expiration period of the notification to the given number of seconds. If the UP.Link server cannot deliver the notification within this period of time, the notification will expire. If you set this field to 0, the expiration period defaults to the maximum allowed by the UP.Link server--which is 60 days by default. | |
Specify the alert title string. This field is required when adding an alert; it is ignored otherwise. | |
A string specifying the type of signal to issue to the subscriber. It consists of four characters, representing the device-dependent signal, sound, visual signal, and vibration signal, respectively. You can specify several values for each type of signal:
The dash ( | |
Specify a full path to the file containing the certificate and key. | |
Specify the password to use when decrypting the certificate file. This is the password you provided when you ran the CertMaker utility. | |
Specifies whether to require that the secure (HTTPS-based)
If the check box is ON, it disables failover to
If the check box is OFF, the non-secure (HTTP-based) | |
Select the character set to use for the alert title string (the default value is US-ASCII). |