f

Obbligatorio

Percorso e nome del file di testo contenente le informazioni necessarie per l’invio o il controllo degli SMS (di seguito definito file richiesta). Il file deve avere un nome univoco e deve corrispondere all’ID richiesta da inoltrare al server SMS.

Per definire l’ID richiesta va bene un qualsiasi contatore. Ad esempio il file potrebbe chiamarsi “000000000001.ini” ed essere incrementato ad ogni esecuzione di AreaSMS, sia per l’invio che per il controllo.

Se nel parametro non si specifica il percorso ma solo il nome del file, AreaSMS cerca il file nella propria cartella di lancio.

u

Obbligatorio

Utente da utilizzare per la connessione al server SMS.

p

Obbligatorio

Password da utilizzare per la connessione al server SMS.

s

Opzionale

Indirizzo email del supporto tecnico da contattare (da parte di KPNQWEST) in caso di problemi sorti nell’invio degli SMS. Se non definito in questo parametro, viene utilizzato come indirizzo email  “progra@es2000.it”.

t

Opzionale

Numero di tentativi di esecuzione della procedura di controllo: fatti gli n tentativi, il programma produce i file risposta anche se l’operazione di invio non risulta ancora terminata. L’intervallo di tempo fra un tentativo e l’altro è di 10 secondi. Il valore predefinito è 5. Impostando il valore 0, il controllo non viene effettuato.

v

Opzionale

Può assumere i valori:

0: non viene visualizzata la finestra di debugging (valore predefinito). In questo caso l’applicazione agisce in background e termina una volta effettuato l’invio o il controllo.

1: viene visualizzata una finestra di debugging. In questo caso l’applicazione deve essere chiusa manualmente dall’operatore.

AZIONE

Obbligatorio

Deve avere il valore 1.

TESTOSMS

Obbligatorio

Il testo dell’SMS da inviare (può essere lungo al massimo 160 caratteri).

NUMERISMS

Obbligatorio

I numeri di telefono a cui inviare l’SMS.

Il numero deve essere privo del prefisso internazionale (probabilmente è una limitazione imposta dal provider).

Possono essere specificati più numeri di telefono separati da virgola, ad esempio: 335453534,338345353

TENTATIVI

Opzionale

Il numero di tentativi da fare per l’invio. Il valore predefinito è 5.

Fra un tentativo e l’altro AreaSMS attende 10 secondi.

AZIONE

Obbligatorio

Deve avere il valore 2.

IDSMS

Obbligatorio

E’ L’id dell’SMS così come viene ritornato dal server dopo l’invio e salvato nel file risposta (vedi più avanti).

ESITO

Sempre presente

Può assumere i valori:

OK : la richiesta di invio è stata inoltrata al server con successo (attenzione, non è detto che l’invio dell’SMS venga effettuato dal server con successo!).

NO: non è stato possibile inoltrare la richiesta di invio al server.

ERRORE

Presente solo in caso di ESITO = NO

Il parametro contiene l’errore riscontrato da AreaSMS (ad esempio parametri di lancio non validi, mancata connessione al server) o dal server medesimo.

IDSMS

Presente solo in caso di ESITO = OK

E’ l’Id dell’SMS da utilizzare come parametro in una successiva richiesta di controllo.

ESITO

Obbligatorio

Può assumere i valori:

OK : la richiesta di controllo è stata inoltrata al server con successo (attenzione, l’esito è relativo alla richiesta di controllo, non all’invio degli SMS, che è presente nel file .dtl descritto in seguito).

NO: non è stato possibile inoltrare la richiesta di controllo al server.

AreaSMS ripete il tentativo di controllo 30 volte, con intervalli di 10 secondi (totale 5 minuti) prima di ritornare con esito negativo.

ERRORE

Opzionale

Presente solo in caso di esito NO.

Il parametro contiene l’errore riscontrato da AreaSMS (ad esempio parametri di lancio non validi, mancata connessione al server) o dal server medesimo.