File thmail.txt - Rev 1.1 - 29.09.95

Questo file contiene la descrizione del programma thmail.exe (rev 1.1).

Il programma thmail permette di gestione OFF-LINE del data-base dei messaggi
dell'ottimo TSTHOST; l'uso del programma e' molto semplice, accetta parametri
sulla linea di comando (command-line).

Il programma permette di listare, leggere e cancellare uno o piu' messaggi
secondo uno specifico criterio di ricerca che consente di:
 - specificare l'indirizzo destinazione
 - specificare l'indirizzo sorgente
 - specificare la BBS sorgente
 - specificare il tipo dei messaggi (P o B)
 - specificare lo stato dei messaggi (N Y K F)
 - specificare una stringa da cercare nei titoli
 - specificare un numero assoluto di messaggio.

Chiamando il programma senza nessun parametro viene visualizzata la seguente
schermata di Help:

  THMAIL - Rev 1.10 - (c) Massimo Benemeglio - IW0FEI

  Uso del programma:
  >thmail <cmd> ['!'<from>] ['+'<to>] ['@'<route>] [<title>]
                ['-t'<type>] ['-s'<status>'] ['-#'<num>] [-p]
    <cmd>    l = list, r = read, k = kill
    <from>   indirizzo di provenienza
    <to>     indirizzo destinazione
    <route>  indirizzo di routing
    <title>  sottostringa da cercare nel titotlo
    <type>   tipo del messaggio ( P B )
    <status> stato del messaggio ( N Y K F )
    <num>    numero del messaggio
    -p       disabilita la paginazione dello schermo

Il programma deve risiedere nella directory di TSTH (grazie a I5WNN).

Per paginazione si intente una visualizzazione dei dati con possibilit di
scrolling, questa opzione  attivata per default e pu essere disabilitata
inserendo lo switch '-p' sulla linea di comando. In quest'ultimo caso i
dati scorreranno nello schermo senza pause, ci pu essere utile se si vuole
"ridirigere" l'output su di un file o su una stampante, per avere ad esempio
un listato di tutti i bollettini personali sulla stampante bisogna digitare:

    >thmail l -tp -p >prn

Da notare che la paginazione  attiva solo per il 'listing' e per il 'reading',
non  attiva per il kill dei messaggi.


Spero che la schermata di help sia sufficiente, comunque senza dilungarmi in
noiose spiegazioni faccio un po' di esempi di uso:

- Lista tutti i messaggi provenienti dal BBS IK0GDH:
    >thmail l @IK0GDH

- Lista tutti i messaggi provenineti dal BBS IK0GDH e diretti a IW0FEI:
    >thmail l @IK0GDH +IW0FEI

- Lista tutti i messaggi provenineti dal BBS IK0GDH e diretti a IW0FEI che
  siano solo personali:
    >thmail l @IK0GDH +IW0FEI -tP

- Lista tutti i messaggi in stato K (Killed):
    >thmail l -sK

- Lista il messaggio numero 124:
    >thmail l -#124

- Lista tutti i bollettini indirizzati a @TSTH provenienti da IK1GKJ:
    >thmail l -tP !IK0GKJ @TSTH

Gli esempi sono stati fatti con il comando di listing ('l') ma si possono
ripetere sia con il comando di lettura 'r' che di cancellazione 'k'

- Legge il messaggio numero 124:
    >thmail r -#124

- Cancella tutti i bollettini indirizzati a @TSTH provenienti da IK1GKJ:
    >thmail k -tP !IK0GKJ @TSTH

- Cancella tutti i messaggi in stato 'K':
    >thmail k -sK

*** ATTENZIONE: il programma va usato Off-Line, con questo intendo dire che deve
    essere usato FUORI da TSTH cioe' con TSTH non in esecuzione, questo perche'
    non so' (solo il buon Mario, IK1GKJ lo sa') cosa fa TSTH se qualcuno cambia
    run-time il data-base dei messaggi.

Note finali:
------------
- Purtroppo ho dovuto usare il carattere '+' e il carattere '!' per definire
  rispettivamente il destinatario e il mittette, sarebbe stato ovviamente
  meglio usare i caratteri '>' e '<', ma il DOS (e anche altri S.O.) usa
  tali caratteri per il ridirezionamento dell'input e dell'output.

- L'uso del programma e' a rischio e pericolo di chi lo fa', io l'ho provato
  con la versione 1.41 di TSTH e non ha mai dato risultati catastrofici.

- Il programma e' completamente FREEWARE a patto di non modificare questo
  file o il programma stesso.
  Sono disponibili (per chiunque e' interessato) i sorgenti, scritti in
  linguaggio C (BC 3.1).

Scusate eventuali errori ed orrori (anche di ortografia) e spero vivamente di
non aver immesso in rete un programma inutile.

Un ringraziamento a I5WNN (Lido)  per i suggerimenti dati.

73 de iw0fei.


Storia delle versioni:
----------------------

1.0 - Versione originale

1.1 - Aggiunta la paginazione sul list e read (non per il kill), switch sulla
      linea di comando '-p'
