AUTOYAPP – Software per scaricare file in YAPP in modo automatico (Software MS-D

[INFORADIO]

AUTOYAPP – Software per scaricare file in YAPP in modo automatico (Software MS-DOS)

Disponibile alla seguente pagina: http://www.forumradioamatori.it/download/download-dos/Packet/Packet.html


* AUTOYAPP 2.0 [018-13/11/94] (C) 1991 1994 by I0FLY - On Line Help - *
------------------------------------------------------------------------
I0FLY - Francesco (Frank) Fiandra
        101, Via Magno Magnini
        I-06127 - Perugia - Italy - JN63ec
-----------------------------------------------------------------------
Per INFO e HELP sul funzionamento di AUTOYAPP 2.0 PSE contattatemi
via bassa allo 075 / 5057134 ore pasti. TNX.
------------------------------------------------------------------------
AUTOYAPP e' scritto in MS VISUAL BASIC ed e' stato testato su:
PC 386Sx/16MHz 1M Ram, PC 486Dx2/66MHz 16MB Ram, TNC2 e KPC2.
Perche' possa funzionare il PC deve essere dotato di MOUSE.
Il video a colori non e' indispensabile ma senza di esso AUTOYAPP
non si apprezza pienamente!
Il dialogo con l'utente puo' avvenire sia in ITALIANO che in INGLESE.

Avviato il programma, dalla prima schermata e' possibile:
- fare click su ENGLISH/ITALIANO per scegliere la lingua di dialogo
con il programma;
- fare click su HELP!/AIUTO e ottenere un aiuto in linea;
- fare click su SET COM per settare i parametri della porta di
comunicazione prima di entrare nel programma;
- fare click su SET TNC per attivare o disattivare l'invio di parametri
e per settare il suffisso del file da mandare al TNC al momento del
lancio del programma oppure alla fine della sua esecuzione;
- fare click su QUIT/ESCE per uscire immediatamente dal programma.

Il testo che segue fa riferimento alla terminologia ITALIANA del
programma.

Alcuni dei files che usa AUTOYAPP per il suo funzionamento devono
risiedere sulla stessa directory dove si trova il programma. Essi sono:
- AUTOYAPP.SET, cioe' il file dove vengono attinti i piu' importanti
parametri per il suo funzionamento;
- i files per il settaggio del TNC (AUTOYAPP.???);
- AUTOYAPP.HLP cioe' il file di AIUTO;
- AUTOYAPP.CON, usato per memorizzare nominativi da connettere
semplicemente cliccandovi su' o usando i tasti cursore e l'invio: essi
sono uno per ogni riga. A programma avviato e' possibile visualizzarlo,
selezionare una riga e inviarla al TNC per la   connessione.
Se la connessione passa per NODI e DIGIPEATER ognuno di questi deve
essere separato da un carattere / (slash). Es:
IR6ANB-2 V IK6ABC/IR0PGC-2/I0FLY-8
vuol dire di connettere prima il nodo IR6ANB-2 usando la stazione
IK6ABC come DIGIPEATER, connettere poi il NODO IR0PGC-2 e quindi
il BBS I0FLY-8.
- AUTOYAPP.TXT, che contiene righe di testo da trasmettere, quando
connessi, selezionandole con i tasti cursore e l'invio o con il mouse.

AUTOYAPP, al momento della sua prima esecuzione, se non esiste, crea
il file AUTOYAPP.SET con i valori di DEFAULT.
Cio' accade anche ogni volta che, lanciato il programma, il file non e'
trovato sulla directory dove si trova AUTOYAPP.EXE.
Detti parametri sono modificabili da programma e il file viene riscritto
ogni volta che cio' accade.
E' ASSOLUTAMENTE SCONSIGLIABILE modificare direttamente AUTOYAPP.SET:
cio' potrebbe portare al cattivo funzionamento del programma e a
risultati imprevedibili!
AUTOYAPP.SET memorizza un parametro per riga e le righe sono numerate:
ogni numero di riga e' seguito da un punto e dal parametro che esso
rappresenta.
Quello che segue e' il file con i parametri di DEFAULT: al momento,
dei 30 previsti, solo i primi 18 sono utilizzati. NOT significa che il
parametro non e' in uso.

001.COM1:
002.9600
003.N
004.8
005.1
006.0
007.4096
008.4096
009.0
010.1000
011.1000
012.10000
013.NOT
014.NOT
015.180
016.ITA
017.INI
018.NOT

Il programma viene distribuito con dei files di esempio - AUTOYAPP.CON
e AUTOYAPP.TXT - che possono essere sostituiti oppure editati con
l'apposita funzione interna di editing (ED) o un qualsiasi altro EDITOR.

SET COM: dalla schermata si puo' subito uscire facendo click su ESCE.
Se si clicca su DEFAULT vengono impostati i seguenti parametri che sono
registrati nel file AUTOYAPP.SET come sopra specificato:

001.COM1:       e' la porta di comunicazione usata (COM1 o COM2);
002.9600        e' la velocita' della porta in BAUD (da 300 a 19200);
003.N           e' la parita';
004.8           e' il numero di BITS;
005.1           e' il numero dei BITS di STOP;
006.0           indica che l'RTS e' attivo (1 = non attivo);
007.4096        e' l'ampiezza in caratteri del buffer di RX;
008.4096        e' l'ampiezza in caratteri del buffer di TX;
009.0           indica che il controllo DCD non e' attivo (se > di 0
                indica il tempo in millisecondi di attesa prima che
                venga emesso un errore di TIMEOUT sul Data Carrier
                Detect);
010.1000        indica il tempo in millisecondi di attesa prima di
                emettere un errore di TIMEOUT sulla linea CTS (Clear
                To Send). il valore 0 indica che la linea non e'
                controllata;
011.1000        come sopra ma per la linea DSR (Data Set Ready);
012.10000       e' il tempo di attesa in millisecondi prima che, in
                caso di malfunzionamento della porta, venga segnalato
                un errore di OPEN della stessa (deve essere circa 10
                volte piu' alto dei due precedenti;
013.NOT         indica che nessun file di parametri viene inviato al
                TNC al momento del lancio del programma. Diversamente,
                con INI, indica che all'inizio deve essere mandato al
                TNC il file il cui prefisso e' AUTOYAPP e il cui
                suffisso e' quello indicato dal parametro numero 17;
014.NOT         indica che nessun file di parametri viene inviato al
                TNC al momento dell'uscita dal programma. Diversamente,
                con END, indica che alla fine deve essere mandato al
                TNC il file il cui prefisso e' AUTOYAPP e il cui
                suffisso e' quello indicato dal parametro numero 18.

In caso di modifica dei parametri della seriale, se si clicca su SALVA,
quelli che seguono rimangono invariati:

015.180         e' il tempo di TIMEOUT, in secondi, durante il
                trasferimento dei FILES in modo YAPP.
016.NOT         Indica che il dialogo con il programma avviene in
                INGLESE. Se si sceglie di dialogare in ITALIANO allora
                esso diventa ITA. Non me ne vogliano gli amici italiani
                se per DEFAULT viene selezionata la lingua  INGLESE:
                avrei piacere che il frutto delle mie fatiche venga
                apprezzato anche all'estero!
017.INI         indica il suffisso per il file di parametri iniziali al
                TNC correntemente scelto e che compare sulla finestra
                di dialogo quando si clicca su SET TNC (INI e' il valore
                di DEFAULT);
018.NOT         indica il suffisso per il file di parametri finali al
                TNC correntemente scelto e che compare sulla finestra di
                dialogo quando si clicca su SET TNC (NOT e' il valore di
                DEFAULT).

NOTA BENE: I parametri CTS e DSR controllano via hardware il flusso dei
dati fra computer e TNC. Essi NON possono essere messi a zero perche'
si avrebbero errori soprattutto nel trasferimento dei files dal proprio
computer verso il corrispondente. AUTOYAPP non usa il controllo software
del flusso (XON/XOFF) perche' ormai tutti i TNC hanno la possibilita' di
essere collegati al computer con tutte le linee della porta (pins da 1
a 7 piu' il 20). Affinche' il controllo hardware del flusso sia
efficiente, i seguenti parametri DEVONO OBBLIGATORIAMENTE essere cosi'
settati sul TNC:

PARITY 0
AWLEN 8
8BITCONV ON
START $00
STOP $00
TXFLOW OFF
TRFLOW OFF
XFLOW OFF
XOFF $00
XON $00

Per un corretto trasferimento dei files e' bene che la porta sia settata
con parita' N, 8 BITS per carattere e 1 BIT di STOP.

SET TNC: dalla finestra si puo' subito uscire selezionando ESCE.
Il prefisso dei files deve essere AUTOYAPP mentre i suffissi possono
essere liberamente scelti. Es: AUTOYAPP.KAM, AUTOYAPP.TNC, AUTOYAPP.INI,
AUTOYAPP.END ecc.; per attivare le funzioni di invio dei parametri
occorre selezionarle mettendo una X con il MOUSE nello spazio apposito.

ESCE: permette di chiudere il programma immediatamente.

INIZIA: il programma si inizializza con tutti i parametri letti dal file
AUTAOYAPP.SET e tenta di aprire la porta seriale. Se questa funzione non
riesce, ad esempio perche' il TNC e' spento, appare una finestra dalla
quale si puo' tornare a cambiare i parametri della seriale, tentare di
nuovo oppure abbandonare definitivamente l'esecuzione.

Una volta entrati nella maschera principale di AUTOYAPP, le varie
funzioni possono essere programmate facendo clic sulle relative parole
chiave poste sull'ultima riga in basso dello schermo. Esse sono:

HELP: attiva questa finestra e da' la possibilita' di scorrere questo
testo di aiuto.
SETCOM: permette il settaggio della porta di comunicazione in qualsiasi
momento purche' il TNC sia in modo CMD (per il settaggio della COM vedi
le note precedenti). Da usare con attenzione pena blocchi imprevisti del
programma!
CONN: attiva una finestra da dove si possono selezionare direttamente
i nominativi da connettere ed avviare immediatamente la connessione.
Quando si e' connessi l'icona e' di colore blu'.
DISC: si apre una finestra da dove ci si puo' disconnettere inviando
CRTL+D (Wild mode-modo selvaggio) oppure inviando B (modo BBS).
SENDTXT: si apre una finestra dalla quale e' possibile scegliere righe
di testo da inviare direttamente al TNC o da trasmettere. Le righe
devono essere selezionate e trasmesse una alla volta. Il file che
contiene le righe e' AUTOYAPP.TXT.
DOS: e' la classica uscita temporanea al DOS (Shell). Dal modo DOS si
torna al programma digitando EXIT.
MH: funziona solo in modo CMD. Fornisce l'elenco delle ultime stazioni
ascoltate dal TNC. Quando si e' connessi l'icona non e' attiva ed e' di
colore grigio chiaro.
PRT: attiva e disattiva la stampa del traffico. Quando la stampa e'
attiva l'icona diventa di colore blu'.
BUFF: attiva la finestra di gestione del BUFFER di RX (180 righe) che
possono essere ripulite, stampate o salvate su disco.
CAPT: attiva una finestra per avviare la cattura su disco del traffico
packet in RX e TX.
DIR: mostra il contenuto del disco.
ED: attiva l'editore di testi incorporato.
REVIEW: permette di rivedere le ultime 180 righe del traffico avvenuto
con possibilita' di paginazione ciclica indietro e avanti tramite gli
appositi pulsanti oppure con i tasti di paginazione ed ESC per
interrompere la revisione.
END: chiude l'esecuzione del programma.
FILES: attiva le schermate per il trasferimento dei files con le
modalita' descritte piu' avanti.
-->: permette di cambiare alcune icone aggiungendo altre funzioni.
L'icona diventa: <--.
<--: riporta attive le icone iniziali e nasconde quelle aggiuntive.
Le funzioni aggiunte sono le seguenti:
VIEW FILE: attiva una finestra dalla quale si possono scegliere e
visualizzare files di testo.
NOKISS: cliccata fa uscire (quasi sempre!) il TNC dal modo KISS.
SET PRG: permette di settare dei parametri essenziali per il
funzionamento del programma.

Il file AUTOYAPP.BUF si ottiene quando il BUFFER di ricezione (180
righe MAX) viene salvato su disco.
Il file AUTOYAPP.CAP si ottiene quando il traffico viene catturato e
salvato su disco.
Il salvataggio del BUFFER su disco e la CATTURA del traffico possono
essere inviati a files con NOMI ANCHE DIVERSI dai sopradetti.
Tutti i suddetti files e QUALSIASI altro file di TESTO di non piu' di
32767 caratteri possono essere editati con la funzione ED.

Trasferimento di files: modalita' operative essenziali
======================================================

Tramite AUTOYAPP e' possibile trasferire files fra due stazioni oppure
da e verso BBS gestiti con software FBB di Jean Paul Raubelat F6FBB.
Lo scambio files con i BBS puo' avvenire in modo manuale oppure in modo
automatico. La funzione di trasferimento files si attiva cliccando sulla
apposita icona (FILES). Si apre una finestra dalla quale e' possibile:
- uscire dalla funzione cliccando su ESCE;
- scegliere se ricevere o trasmettere;
- scegliere se operare manualmente oppure in automatico cioe' in modo
AUTOYAPP. In modo automatico e' possibile solo ricevere avendo come
corrispondente un BBS FBB;
- selezionare il modo di ricezione o trasmissione;
- avviare la scelta effettuata cliccando su OK per passare alla finestra
successiva.

Ricezione files di testo e ASCII da BBS FBB (o compatibili):
------------------------------------------------------------

- selezionare l'icona FILES;
- sulla nuova finestra selezionare RX, Manual, D oppure GET e OK;
- sulla seconda finestra indicare percorso e nome del file remoto, cioe'
  sul BBS, percorso e nome del file locale (dove si vuole depositare e
  come si vuole chiamare sul proprio disco il file che ci si appresta a
  ricevere);
- cliccare sul bottone ASPETTA QUI oppure TORNA per avviare il
  trasferimento. Se si sceglie il primo bottone allora per lasciare la
  finestra a fine trasferimento occorrera' cliccare su FINE. Durante il
  trasferimento la finestra da' all'operatore informazioni e statistiche
  sullo stato di avanzamento dell'operazione.

Ricezione files di Testo, ASCII e BINARI con protocollo YAPP di WA7MBL:
-----------------------------------------------------------------------

Primo caso - il corrispondente NON e' un BBS:

- connettersi con un corrispondente che usi anche esso AUTYOYAPP oppure
  un programma in grado di implementare il protocollo YAPP;
- selezionare l'icona FILES;
- sulla nuova finestra selezionare RX, Manual, Yapp (D) e OK;
- sulla seconda finestra NON occorre indicare percorso e nome del file
  remoto ma basta percorso e nome del file locale (dove si vuole
  depositare e come si vuole chiamare sul proprio disco il file che ci
  si appresta a ricevere);
- cliccare sul bottone ASPETTA QUI oppure TORNA per avviare il
  trasferimento;
- Occorre avviare la fase prima che il corrispondente invii il segnale
  di Pronto a Trasmettere (SI Send Init) altrimnenti il trasferimento
  non parte: occorre cioe' che chi riceve esegua per primo le 
  operazioni iniziali.
- Sono valide le altre considerazioni fatte per l'opzione precedente.

Secondo caso - il corrispondente e' un BBS tipo FBB o compatibile:

- connettersi al BBS;
- selezionare l'icona FILES;
- sulla nuova finestra selezionare RX, Manual, YD (oppure YGET) e OK;
- sulla seconda finestra occorre indicare percorso e nome del file
  remoto e  percorso e nome del file locale (dove si vuole depositare e
  come si vuole chiamare sul proprio disco il file che ci si appresta a
  ricevere);
- cliccare sul bottone ASPETTA QUI oppure TORNA per avviare il
  trasferimento;
- il dialogo con il BBS e' automatico cosi' come automaticamente avviene
  l'eventuale RESUME dei dati dal punto in cui si e' eventualmente
  interrotto un precedente download dello stesso file.

Anche in questi casi vengono evidenziati in tempo reale dati e
statistiche sul trasferimento.

Ricezione multipla e automatica di files di testo, ASCII e BINARI da
BBS FBB con il protocollo YAPP e con RESUME AUTOMATICO):
--------------------------------------------------------------------

- eseguire le operazioni che seguono in modo NON connesso;
- selezionare l'icona FILES;
- sulla nuova finestra selezionare RX, AUTOYAPP e OK.
Sulla seconda finestra occorre indicare:
- Via e BBS da connettere automaticamente; cioe' la sequenza di nodi e
  digipeaters e, in ultimo, il call del BBS. Ogni indicativo e' separato
  dal successivo dal carattere "/" (slash);
- percorso e nome del file o dei files (max 10) che si vogliono
  prelevare visti dal lato BBS;
- percorso e nome da assegnare loro sul proprio disco. Da notare che se
  un nome ed un percorso non vengono indicati allora ad ogni file viene
  dato il nome che ha sul BBS e collocato nella dir dove si trova e
  lavora AUTOYAPP;
- numero massimo dei tentativi di connessione che deve effettuare
  AUTOYAPP in caso di cadute del link;
- ora di inizio del primo tentativo;
- intervallo in minuti fra i tentativi;
- selezionare GO per avviare il processo automatico all'ora stabilita e
  nei modi previsti.
Avviata la procedura, compare a video una nuova finestra dove verranno
evidenziati in tempo reale stato di avanzamento dei trasferimenti e
statistiche sugli stessi.
Sara' sempre possibile interrompere il lavoro cliccando su ESCE.

Trasmissione di files
---------------------

Quanto detto per la ricezione, mutatis mutandis, vale anche per la
trasmissione. Occorrera', ad esempio, essere certi che il corrispondente
sia pronto a ricevere con il protocollo YAPP prima di inziare la
procedura di invio di un file. Ovviamente non e' possibile la
trasmissione multipla e programmata in automatico di piu' files verso
il BBS perche' FBB non lo permette.

Per portare a compimento il programma e' importantissimo conoscere               
le vostre impressioni e i bugs scoperti: PSE fatemi sapere, TNX!

                                         Enjoy ! 73 de Francesco I0FLY