Licenza d'uso

Il presente programma, inclusa la documentazione tecnica che lo accompagna, è concesso in uso dalla Dynamica s.r.l. alle condizioni che seguono.

Il mancato invio alla DYNAMICA s.r.l. - Piazza Emilia n. 5 - 20129 Milano - del modulo allegato, debitamente firmato, importa l'automatica risoluzione della concessione in uso del presente programma.

Il programma non può essere né installato né usato contemporaneamente su più elaboratori. Ogni installazione del programma richiede una nuova copia ottenibile dalla Dynamica s.r.l. o da un suo distributore/rivenditore autorizzato.

Il dischetto (o supporto magnetico atto allo scopo) contenente il programma può essere riprodotto in copia soltanto per tutelare i dati in esso contenuti, contro perdite e deterioramenti. Il diritto di utilizzazione non è trasmissibile né cedibile a terzi salvo autorizzazione della Dynamica s.r.l. che risulti da atto scritto. Le stesse restrizioni si applicano alla documentazione tecnica, sia essa stampata su carta sia memorizzata su supporto magnetico.

Qualsiasi atto od omissione in violazione dei diritti d'autore e/o di privativa sul programma di cui la DYNAMICA s.r.l. è titolare esclusiva, ivi inclusa la riproduzione non autorizzata del programma e l'alienazione e/o l'acquisizione, anche gratuite, di copie non autorizzate dello stesso, sarà perseguita legalmente ai sensi della legge, 22 Aprile n. 633, cos`ì come modificata dal D.L. 29 Dicembre 1992 n. 518.

La violazione delle clausole che precedono comporta automaticamente la risoluzione, senza preavviso, del diritto di utilizzo sia del software sia della documentazione e conseguentemente annulla ogni diritto alla partecipazione a qualsiasi forma di aggiornamento del programma.

L'assistenza tecnica sarà fornita ai soli possessori di copie originali del programma, nei limiti e nei termini da stabilirsi sulla base degli accordi contrattuali complementari alla fornitura del programma effettuata sia a mezzo distributori/rivenditori sia direttamente.

Le nuove versioni del programma potranno essere richieste dagli utenti già in possesso del programma ad un prezzo di favore. Tale richiesta dovrà pervenire alla Dynamica s.r.l. nei tempi e nei modi da essa prestabiliti.

La Dynamica s.r.l. garantisce che il materiale da essa fornito si trova nelle migliori condizioni di impiego e si obbliga a sostituire le parti eventualmente difettose previa loro restituzione e a fronte di richiesta per iscritto da effettuarsi entro 7 gg. dal verificarsi del difetto.

È esclusa qualunque altra responsabilità da parte della Dynamica s.r.l. per ogni altro danno, diretto o indiretto, conseguente all'impiego degli oggetti forniti (ivi inclusi programmi, supporti magnetici e documentazione) che sia diverso o più ampio della sostituzione del materiale stesso, ai sensi del paragrafo che precede.

La Dynamica s.r.l. non assicura l'idoneità del materiale fornito per impieghi specifici o con programmi particolari, salvo esplicito impegno scritto.

In ogni caso, al presente accordo si applicano le norme vigenti nella nazione in cui il programma è stato acquistato.

Salvo diversa deroga di competenza stabilita in specifico contratto, per controversie ove la Dynamica s.r.l. sia convenuta è competente il Foro di Milano.

Nelle controversie promosse dalla Dynamica s.r.l., alla stessa è data facoltà di ricorrere sia al proprio Foro sia a quello dell'utente, a propria insindacabile scelta.

1. Introduzione

Funzione primaria del pacchetto di comunicazione Cux (Communication Utility eXtended) è di consentire la realizzazione di sistemi di comunicazione operanti attraverso linee commutate o dedicate asincrone (ad esempio RS232 o X28).

Cux può essere usato sia in modo interattivo presentando un prompt di comando sia in modo batch eseguendo un programma memorizzato in un file. In ambedue i casi si hanno a disposizione i medesimi comandi. Inoltre molte delle operazioni condotte da Cux possono essere direttamente impostate dalla linea di comando.

Progettato per la massima semplicità d'uso, Cux richiede peraltro un periodo di studio e prove al fine di poter sfruttare al meglio tutte le sue capacità. L'approccio consigliato è quello di mettere in opera in primo luogo una connessione locale (tra due computer) via seriale RS232 con cui sperimentare i diversi comandi, in seguito aggiungere gli eventuali modem e, dopo essersi accertati del corretto funzionamento dell'installazione, procedere alla realizzazione dell'applicazione in cui il programma dovrà operare.

Un'applicazione per Cux è composta da un insieme di script (o file batch in MsDos) e di programmi Cux. Un programma Cux è un insieme di file contenenti comandi.

La realizzazione di applicazioni telematiche con Cux richiede, oltre allo studio del programma stesso, una profonda analisi dell'organizzazione di tutto il servizio che si intende realizzare. Inoltre occorre che il sistemista proceda ad uno studio delle componenti di base dei servizi telematici e dei sistemi hardware e software coinvolti.

1.1 Caratteristiche di Cux 3.8

La nuova release 3.8 di Cux presenta alcune novità importanti che ne fanno uno strumento di comunicazione se possibile ancor più duttile e versatile: il notevole ampliamento del linguaggio, la possibilità di eseguire comandi remoti in ambiente MsDos e l'introduzione di un motore fax sono sicuramente gli aspetti più evidenti delle novità apportate al pacchetto.

Per quanto riguarda il linguaggio, occorre sottolineare in primo luogo l'introduzione di variabili e macro: la visibilità delle variabili di environment, l'introduzione di variabili predefinite e la possibilità per l'utente di definire nuove variabili, costituiscono ora un punto di forza del pacchetto, permettendo la creazione di applicazioni automatizzate generalizzabili e personalizzabili in maniera semplice ed efficace. L'uso delle macro, inoltre, semplifica ulteriormente le poche operazioni manuali richieste nelle applicazioni automatizzate cos`ì prodotte.
Altro aspetto rilevante delle modifiche apportate al linguaggio è dato dall'ampliamento dei comandi: da quelli di sistema (più che raddoppiati) a quelli per il controllo dell'elaborazione batch (praticamente raddoppiati). Ma anche la classe dei comandi per la gestione dei protocolli è stata ampliata, aumentando di circa un terzo i comandi disponibili ed introducendo la gestione diretta interna di altri protocolli, quali Kermit e Zmodem.

Ancora, la possibilità di eseguire comandi remoti in ambiente MsDos rappresenta un'ulteriore adeguamento di Cux alle aspettative di un completo prodotto di comunicazione.
Ma attenzione: il supporto all'esecuzione di comandi remoti in ambiente MsDos rappresenta un add on da richiedere esplicitamente in quanto non viene fornito col pacchetto base.

Altro add on importante ` il modulo FAX, ovvero il motore fax per la ricezione e la spedizione di fax in formato G3 sia in alta sia in bassa risoluzione. Anche tale modulo è da richiedere esplicitamente in quanto non fa parte del pacchetto base.

1.2 Usi di Cux in MsDos

Il sistema operativo MsDos è un sistema intrinsecamente monotasking e perciò tutti gli usi di Cux sono strettamente legati al fatto che il programma operante è anche l'unico ad avere l'intero controllo del sistema. In generale il quadro operativo su una stazione MsDos vede Cux attivo in risposta o in chiamata, e a seguito della connessione è possibile eseguire in successione i diversi comandi (si veda Uso di Cux in modalità batch) trasferendo momentaneamente il controllo ad applicazioni esterne per processare (o preparare) file da inviare o ricevere. Un caso particolare è rappresentato dal comando `REMOTE' che consente la ridirezione della linea di comando propria dell'MsDos; anche in questo caso il controllo viene trasferito al sistema operativo, salvo il fatto che Cux resta operante per ciò che riguarda la gestione della linea di comunicazione. L'uso previsto, e consigliato, è che le stazioni MsDos vengano utilizzate al più come satelliti (eventualmente remoti) di sistemi Unix/Xenix in quanto questi ultimi consentono un miglior sfruttamento del programma facendolo, per esempio, operare su più linee contemporaneamente. Nulla vieta comunque di usare Cux come strumento per collegare tra loro sistemi MsDos per il trasferimento di file. Discorso a parte merita invece l'eventuale uso di Cux con sistemi di windowing e gestione delle sessioni.

1.3 Usi di Cux in Unix/Xenix

La disponibilità di un sistema con capacità di operare in modo multitasking amplia notevolmente le possibilità e le varianti di messa a punto di servizi con il prodotto. Inoltre Cux è perfettamente allineato con le caratteristiche di modularità possedute da tutti i programmi che compongono la base operativa della famiglia di sistemi operativi Unix/Xenix. Ad esempio Cux risulta perfettamente integrabile nel sistema di stampa (spooler), può essere incluso nelle tabelle temporali di cron o può essere attivato

1.4 Usi di base

Accesso a banche dati o a login remoti.

Cux è dotato di una capacità di emulazione terminale limitata e basata su quella disponibile con il sistema su cui operate: sotto MsDos via `ansi.sys', sotto Unix/Xenix attraverso l'emulazione del terminale da cui si opera. Grazie ai comandi di ricezione selettiva ed invio di stringhe `RSTRING' e `STRING' è possibile realizzare sistemi completamente automatizzati di accesso. Durante la sessione di lavoro è sempre possibile operare trasferimenti di file. Un caso particolare è costituito dagli usi per assistenza remota per cui sono previsti alcuni comandi che permettono l'accesso al sistema remoto con attivazione da parte dell'utente (`REMOTE').

Trasmissione e Ricezione file.

Sia il sistema operativo MsDos che la famiglia di sistemi Unix/Xenix utilizzano il file quale oggetto minimale per gestire, referenziare e manipolare aggregati di dati. Cux è nato proprio allo scopo di poter scambiare file con elevata certezza di integrità. Oltre ai protocolli propri il programma dispone di comandi (`SPAWN') che permettono di aggiungerne altri liberamente definibili dall'utente. Fino ad oggi Cux è stato impiegato con successo nello scambio di dati di elevata importanza economica o informativa.

A partire dagli usi di base sopra elencati è possibile costruire combinazioni complesse di operazioni. All'utente che non ha mai avuto esperienze con programmi di comunicazione si ricorda però che Cux è solo il componente di base necessario alla realizzazione di servizi. La progettazione, l'implementazione e la manutenzione di sistemi informativi complessi richiede un'opera di pianificazione e studio che va ben oltre la conoscenza del prodotto. L'approccio sicuramente più profiquo è quello di dedicare particolare attenzione allo studio pratico del problema, con una adeguata sperimentazione del pacchetto.

2. Uso rapido di Cux

La procedura di installazione di Cux è quella standard dei prodotti Dynamica, ovvero richiede di estrarre i dati dal supporto e di eseguire un programma di inizializzazione e configurazione, in questo caso denominato `init.cux'. Tale procedura è automatizzata tanto per gli ambienti MsDos e Os/2, quanto per quelle versioni dell'ambiente Unix/Xenix in cui sia disponibile il programma di sistema `custom'.

Per maggiori informazioni sulla procedura di installazione si veda il capitolo Installazione nelle appendici.

Ad installazione avvenuta digitare al prompt del sistema operativo utilizzato il seguente comando seguito da un <ENTER>:

cux

Vi verrà cos`ì presentato il prompt di comando:

CUX>

A questo punto potete utilizzare il programma in maniera interattiva: se digiterete il comando `STAT' seguito da un <ENTER> otterrete la visualizzazione dello stato iniziale di startup; il comando `HELP' visualizzerà la lista dei comandi disponibili più una breve descrizione; il comando `INIT' vi permetterà di caricare un tipo di modem (ad esempio `HAYES_COMP'), mentre il comando `EXIT' vi consentirà di terminare il programma tornando al prompt del sistema operativo.

Per maggiori dettagli sull'uso del programma Cux e sui suoi comandi si vedano i capitoli Opzioni sulla linea di comando e Comandi.

3. Opzioni sulla linea di comando

Cux può essere chiamato scrivendo dopo il nome una serie di parametri. In questo modo è possibile alterare il comportamento di default del programma (consultate la sezione `Default' di questo capitolo). È consigliabile, qualora una certa configurazione debba essere ripetuta molte volte, produrre dei file batch in cui sia codificata in modo opportuno e definitivo la linea di comando completa di opzioni.

Oppure, ma solo a partire dalla versione 3.8 del prodotto, esiste la possibilità di elencare le opzioni desiderate nel file `cux.arg' il quale deve essere situato o nella directory `/etc/default' o nella directory corrente (quella dalla quale viene lanciato Cux). La sintassi di tale file richiede che le opzioni siano elencate una per riga e senza spazi tra l'identificativo dell'opzione e il parametro, oppure su due righe, e in tal caso su una riga deve comparire l'identificativo dell'opzione e sulla riga seguente il valore dell'opzione alla quale l'identificativo si riferisce. Sono ammesse eventuali linee di commento, le quali però devono obbligatoriamente iniziare con il carattere `#'. Il file `cux.arg' non può contenere più di 100 righe, a parte le righe di commento che non hanno limiti. Questo significa che adottando il primo formato (opzioni su una riga) possono essere impostate al più 100 opzioni, mentre adottando il secondo formato ne possono essere impostate al più 50.
I seguenti due esempi sono equivalenti ed illustrano la possibilità di utilizzare indifferentemente uno dei due formati indicati:

Esempio 1 # impostazione linea -prtty00 # impostazione baud -bd19200 # impostazione lunghezza record -LE1024 # impostazione finestratura -WI32 # impostazione ritardo interpacchetto -PK1 # impostazione protocollo -ptZMODEM # impostazione modem -moHAYES_COMP # impostazione numero telefonico -nu1234567890

Esempio 2 # impostazione linea -pr tty00 # impostazione baud -bd 19200 # impostazione lunghezza record -LE 1024 # impostazione finestratura -WI 32 # impostazione ritardo interpacchetto -PK 1 # impostazione protocollo -pt ZMODEM # impostazione modem -mo HAYES_COMP # impostazione numero telefonico -nu 1234567890

Attenzione: le opzioni presenti nel file `cux.arg' sono prioritarie rispetto alle opzioni passate sulla linea di comando. Questo significa che se ad esempio nel file `cux.arg' è presente l'impostazione dei baud a 19200 e si invoca Cux passando sulla linea di comando l'opzione `-bd4800' verranno impostati i baud a 19200 e non a 4800 !

A partire dalla versione 4.0 è possibile indicare con l'opzione `-ARG' un file generico, non necessariamente di nome `cux.arg' e non necessariamente posto nella directory `/etc/default' o nella directory corrente. In questo caso non deve essere specificata nessun'altra opzione.

3.1 Uso e significato delle opzioni

Sulla linea di comando è possibile specificare una serie di opzioni che permettono di configurare il programma per il tipo di connessione desiderata. Queste opzioni si possono dividere nelle seguenti tre classi:

• Modalità operativa.
• Trasmissione immediata.
• Opzioni di configurazione.

3.1.1 Modalità operativa

Le opzioni disponibili per questa classe sono esclusive; ciò significa che è possibile dare sulla linea comando una e solamente una tra le opzioni che sono descritte qui di seguito:

-aa

Specificando questa opzione il programma si predispone per rispondere ad un modem chiamante (autoanswer).

-adNumero

Specificando questa opzione il programma si collega via modem al numero telefonico specificato.

-ca

Grazie a questa opzione il programma si collegherà con un altro programma chiamante per comunicare via computer con l'altro utente; sul video apparirà ciò che l'altro utente sta scrivendo.

-cc

Linea diretta via seriale senza modem.

-cdNumero

Specificando questa opzione il programma si collegherà via modem con un host e si comporterà come un terminale remoto.

-fcFile

Se viene specificata questa opzione, il programma non entrerà immediatamente in modo comandi bens`ì andrà ad eseguire i comandi descritti in File; solo al termine di queste operazioni entrerà in modo comandi (per maggiori chiarimenti consultare il capitolo Comandi).

-ma

In questo caso la connessione della linea con il modem chiamante è già stata effettuata manualmente dall'utente, il quale deve essere sicuro che l'emittente che sta chiamando trasferirà dati via modem. Questa opzione si ricollega all'esempio descritto nell'opzione successiva, poiché prima di mettere in atto la connessione descritta occorre che i due interlocutori si accordino su quale dei due assumerà il ruolo di modem chiamante (specificando l'opzione `-md') e quale invece di modem chiamato (specificando, appunto, questa opzione).

-md

In questo caso la chiamata del numero è manuale; questo significa che la connessione è stata effettuata direttamente dall'utente il quale è sicuro che il ricevente sia collegato e pronto a ricevere dati via modem. L'opzione è particolarmente utile quando due interlocutori, già connessi via telefono, debbano, nel corso di una telefonata, scambiarsi dati via computer. In pratica il modem può operare sulla stessa linea telefonica senza interruzione della linea stessa.

Le opzioni `-aa', `-ad', `-cc', `-ma' e `-md' devono venire obbligatoriamente utilizzate con una delle opzioni descritte nella sezione `Trasmissione immediata'.

3.1.2 Trasmissione immediata

Le opzioni disponibili per questa classe sono esclusive; ciò significa che è possibile dare sulla linea comando una e solamente una tra le opzioni che sono descritte qui di seguito:

-frFile

Specifica il nome da dare al file ricevuto.

-ftFile

Specifica il nome del file da spedire.

-xrFile

Specifica il path completo dei file da ricevere.

-xtFiles

Specifica il nome dei file da spedire.

Cux riconosce i due metacaratteri `*' e `?', ma in ambiente Unix/Xenix è necessario che siano posti tra i doppi apici (`"'), come nell'esempio riportato qui sotto.

cux -xt"*.c"

Omettendo gli apici l'espansione dei metacaratteri verrà invece effettuata dal processore di comandi in uso.

3.1.3 Opzioni di configurazione

-ARGFile

Indica di leggere le opzioni di configurazione dal file File.

-bN

Specifica la lunghezza, in bit, del dato. Valori validi per N sono 5, 6, 7 e 8. Il default è 8.

-bdBaud

Specifica il baud rate. Sono valori validi:
50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200 e 38400.
Solo per ambiente MsDos vengono considerati validi anche i seguenti valori:
2000, 3600, 7200, 23040, 28800, 57600, 115200.
Per Os/2 sono considerati validi solo questi valori:
110, 150, 300, 600, 1200, 2400, 4800, 9600, 19200.
Il default è 9600.

-diVideo

Imposta il tipo di emulazione (Unix/Xenix) o il tipo di scheda video (MsDos). Se non viene specificata tale opzione Cux desume il tipo di video utilizzato dalle variabili di environment `DYNA' e `TERM'. Se queste variabili non sono definite viene effettuata una ricerca automatica nel file `dynatype'. Se anche tale ricerca non ha successo viene impostata per default l'emulazione `DUMB'. Per maggiori informazioni consultate le appendici Il file Dynacap e L'enviroment.

-ecN

Abilita/disabilita l'eco dei caratteri sullo schermo. N può essere uno dei due numeri 0 o 1: se N è uguale a 0 l'eco è disabilitato, mentre se è uguale a 1 l'eco è abilitato. L'impostazione di quest'opzione è utile quando l'host o il programma a cui si è collegati non effettua l'eco dei caratteri battuti in interattivo (half-duplex). Per default l'eco è disabilitato (N=0).

-fsFile

Specifica il nome del file da utilizzare per tenere memoria di tutte le operazioni eseguite in conversazionale. Se File viene omesso il nome del file sarà per default `cux.txt'.

-lfN

Abilita/disabilita il linefeed automatico. N può essere uno dei due numeri 0 o 1: se N è uguale a 0 il linefeed automatico è disabilitato, mentre se è uguale a 1 è abilitato. Questa opzione è utile quando l'host o il programma a cui si è collegati in interattivo ad ogni pressione del tasto <return> rimanda l'eco di un carriage return riportando il cursore all'inizio della riga. Abilitando invece l'opzione `-lf' il cursore verrà posizionato all'inizio della riga successiva. Per default il linefedd automatico è disabilitato (N=0).

-loLogfile

Se specificata, questa opzione attiva il log file delle transazioni eseguite. Se viene specificato Logfile, questo sarà il nome del file contenente l'output di log. Per maggiori informazioni consultate il comando `LOG' nel capitolo Comandi e l'appendice Il file di log.

-luByte

Assume significato solo in ambiente MsDos e imposta le dimensioni in byte del buffer di input di comunicazione. Byte può essere un qualsiasi valore compreso tra 128 e 10000. Per default Byte=2048.

-l2Byte

Assume significato solo in ambiente MsDos e imposta le dimensioni in byte del buffer di output di comunicazione. Byte può essere un qualsiasi valore compreso tra 128 e 10000. Per default Byte=2048. Se Byte è inferiore a 128, il buffer non viene utilizzato e l'output sulla linea di comunicazione funziona in polling invece che ad interrupt.

-moModem

Definisce il tipo di modem utilizzato. Se l'opzione è omessa il programma ricerca il tipo di modem dalla variabile di environment `MODM'; se anche questa variabile non è definita allora il programma assume come tipo lo standard Hayes. Per maggiori informazioni consultate le appendici Il file Modmcap e L'environment.

-mu

Specificando questa opzione il programma dopo il copyright non produrrà nessun output sullo schermo. Questo è utile quando si utilizza Cux in programmi batch.

-nuNumero

Indica il numero telefonico da chiamare. È possibile specificare l'eventuale prefisso nel seguente modo:

prefisso/numero

Se il tempo di commutazione delle centraline telefoniche è elevato ed è causa di errori o timeout in fase di collegamento, si consiglia di inserire tra ogni cifra del numero il carattere `/' che introduce sul modem un ritardo (allo scopo consultare il manuale del modem da voi utilizzato) nella composizione del numero successivo al `/' stesso.

-pParità

Specifica il tipo di parità. I parametri validi sono i seguenti:

n nessuna (default) e even o odd m mark s space

Per default non è abilitata alcuna parità (Parità=n).

-prPorta

Permette di specificare la porta di comunicazione. Se Porta vale `CLOSE' il programma parte non utilizzando alcuna porta. Se tale opzione viene omessa dalla versione 4.0 il programma parte non utilizzando alcuna porta, come se fosse stato invocato con l'opzione `-prCLOSE'. Con le versioni precedenti alla 4.0 programma utilizza la prima porta trovata libera tra quelle abilitate nel file sercap. Con l'opzione `-prAUTO' si ottiene il vecchio comportamento forzandone la ricerca.

-ptProtocollo

Permette di definire il tipo di protocollo da utilizzare per trasferire file. I parametri validi sono i seguenti:

CUXTXT

Protocollo Cuxtxt (default)

CUXBIN

Protocollo Cuxbin

CUXENC

Protocollo Cuxenc

XMODEM

Protocollo Xmodem

XMODEMC

Protocollo Xmodem con controllo CRC.

XMODEM1K

Protocollo Xmodem con blocco di 1024 byte.

XMODEM1KC

Protocollo Xmodem con blocco di 1024 byte e controllo CRC.

YMODEM

Protocollo Ymodem.

YMODEM1K

Protocollo Ymodem con blocco di 1024 byte.

YMODEMC

Protocollo Ymodem con controllo del CRC.

YMODEM1KC

Protocollo Ymodem con blocco di 1024 byte e controllo CRC.

ZMODEM

Protocollo Zmodem.

KERMIT

Protocollo Kermit.

XON

Protocollo handshake di Xon/Xoff abilitato.

XOFF

Protocollo handshake di Xon/Xoff disabilitato.

(Per maggiori informazioni consultare l'appendice Protocolli supportati).

-rm

Cancella in progressione i file spediti correttamente.

-stN

Specifica il numero di bit di stop: N può valere 1 o 2. Il default è 1.

-un

Normalmente Cux cancella tutti quei file che sono arrivati incompleti o errati. Specificando questa opzione tali file verranno mantenuti nella forma in cui sono arrivati. Si sconsiglia l'uso di questa opzione se non strettamente necessaria.

-Bl

Assume significato solo in ambiente Unix/Xenix e impone di effettuare una open bloccante della linea di comunicazione. L'esecuzione si sblocca non appena viene rilevata la portante. Attenzione che tale opzione è disponibile solo nella versione 3.8 di Cux: a partire dalla versione 3.8a quest'opzione è stata sostituita dalla capability `Ob' nel file `sercap' (cfr.).

-Bz

Se presente indica di eliminare, in modalità conversazionale, i caratteri nulli provenienti dalla linea.

-CK

Disabilita i test sui numeri telefonici e non converte i separatori in virgole secondo lo standard Hayes. Utile con l'impiego di pacchetti di rete che richiedono di specificare il numero internet come indirizzo dell'host al posto del numero telefonico.

-CR

Se specificata, questa opzione comunica al programma che i file batch da utilizzare (specificati eventualmente dall'opzione `-fc') sono crittografati.

-DT

Assume significato solo in ambiente Unix/Xenix e indica di usare come linea seriale standard input e standard output. Inoltre abilita automaticamente il mute (cfr. opzione `-mu' e il comando `MUTE'). Utile se il Cux deve essere lanciato da `inetd' per eseguire uno script (cfr. opzione `-fc').

-EC

A partire dalla release 3.8, Cux garantisce che in caso di file transfer il valore di ogni byte di controllo di un pacchetto abbia un valore diverso da ogni possibile valore assunto dai byte delimitatori del pacchetto stesso. Questa caratteristica elimina la possibilità, per quanto remota, di conflitti a livello di trasporto dovuti alla impredicibilità intrinseca dei valori che assumeranno alcuni particolari byte di controllo. Di conseguenza, per garantire la compatibilità con le versioni precedenti di Cux è indispensabile specificare tale opzione la quale indica di non utilizzare questa nuova feature.

-EX

Forza l'uscita dal programma in caso di terminazione dell'esecuzione batch. In tal caso il programma ritorna con codice di errore 4.

-II

Abilita lo swap sul comando `SYSTEM' con blocco degli interrupt.
Per la sua esecuzione Cux utilizza circa 420k di memoria, con la conseguenza che, ad ogni uscita temporanea sulla shell di sistema, la memoria disponibile sarà 420k in meno della memoria totale esistente. Specificando l'opzione `-II' è però possibile recuperare questi 420k di memoria attraverso l'abilitazione di un meccanismo di swapping che fa uso di particolari routines dovute a R. Brown, il quale ha posto come unica condizione per l'uso di tali routines l'inserimento della seguente frase: "This product uses the SPAWNO routines by Ralf Brown to minimize memory use while shelling to DOS and running other programs." L'impiego di tale opzione ha tuttavia due controindicazioni, vale a dire:

1. il problema della velocità dello swapping (si veda a questo proposito l'uso della variabile `SWAPDIR' nel capidolo L'Environment dell'appendice `Common Features');
2. il problema del tipo di memoria usata per lo swapping (si veda a questo proposito l'uso della variabile `SWAPTYPES' nel capidolo L'Environment dell'appendice `Common Features');
3. il problema del blocco degli interrupt di seriale, poiché se è in corso dell'I/O sulla linea di comunicazione al momento dell'uscita sulla shell di sistema, questo andrà perso.

-JS

Abilita jumpscroll su sistemi grafici.

-KCtx_start,tx_stop,rx_start,rx_stop

Imposta i caratteri di start e stop per il protocollo Kermit. tx_start, tx_stop, rx_start e rx_stop rappresentano il valore decimale rispettivamente dei caratteri di inizio e fine trasmissione e di inizio e fine ricezione. Tali caratteri si possono omettere in modo progressivo a partire dal fondo.

-KK

Normalizza i nomi di file nel caso di trasferimento con protocollo Kermit.

-LERecord

Imposta la lunghezza del record in fase di trasmissione dati (cfr. il comando `LENREK'). Record può assumere un qualsiasi valore numerico compreso tra 32 e 1024 inclusi. Per default Record=128.

-LN

Assume significato solo in ambiente Unix/Xenix e impone di non rispettare i link tra file in fase di ricezione.

-LPPrinter

Permette di indicare un device di stampa (Printer) diverso dal default (`PRN:' per MsDos e `lp' per Unix/Xenix) e una stampante o un programma di stampa diverso da `PRINT' per Windows (ad es. su rete `\\server\printer').

-MY

Comunica al programma di utilizzare come linea di comunicazione la stessa linea su cui si è agganciati come terminale. Questa opzione abilita automaticamente il comando `MUTE' (Per maggiori informazioni consultare il capitolo Comandi). Attenzione che in ambiente MsDos tale opzione può essere utilizzata soltanto col comando `REMOTE' attivo.

-NL

In ambiente MsDos abilita la possibilità di utilizzare per i file nomi più lunghi di 14 caratteri. In ambiente Unix/Xenix/Windows, invece disabilita tale possibilità.

-NT

Non usa file temporanei in ricezione.

-PKMillisec

Imposta l'intervallo di attesa (espresso in millisecondi) tra la trasmissione di due pacchetti successivi con protocolli finestrati (cfr. comando `PKDELAY'). Per default Millisec=0.

-SA

Abilita il file di log per il salvataggio dei comandi inviati al modem e relative risposte (cfr. comando `CMDSAVE'). Tale opzione è accettata solo se è stato attivato anche il log generale (cfr. opzione `-lo' e comando `LOG'). Il file prodotto avrà lo stesso nome del file di log generale ma estensione `.SAV'.

-SD

Abilita la scrittura della data nella visualizzazione delle istruzioni decodificate attivata tramite il comando `SHOW' (cfr.).

-TITick

Imposta il numero di tick per il refresh video automatico durante l'esecuzione del comando `REMOTE' in ambiente MsDos. Per default ha valore 18, cioè 1 secondo. Il minimo impostabile è 9, il massimo 180. Il refresh manuale può essere invece effettuato tramite il carattere associato alla capability `E4' (cfr. Il file modmcap).

-TSString

Imposta la stringa per i file transfer (cfr. comando `STAR').

-WIFinestra

Imposta le dimensioni della finestra in fase di trasmissione dati (cfr. il comando `WINDOW'). Finestra può assumere un qualsiasi valore numerico compreso tra 0 e 128 inclusi. Per default Finestra=0.

-WO

Riporta le dimensioni della finestra al valore originario in caso di modifica in fase di ricezione dati. Cux infatti eredita le dimensioni della finestra impostate dal trasmettitore. Specificando quest'opzione il valore della finestra viene invece riportato al valore originario.

-XX

Assume significato solo in ambiente Unix/Xenix e disabilita il protocollo Xon/Xoff che per default è abilitato. La gestione del controllo di flusso (handshake) non è relativa alla linea di comunicazione sulla quale Cux è operativo, bens`ì al terminale sul quale il programma è in modalità interattiva.

-ZZ

Abilita la messaggistica e l'help in lingua inglese.

3.2 Default

Per default il programma assume uno stato equivalente alla sua chiamata con i seguenti parametri:

cux -bd9600 -b8 -st1 -pn -ec0 -lf0 -ptcuxtxt

Ciò equivale a dire al programma di definire le seguenti combinazioni:

-bd9600

Baud rate a 9600 baud/sec.

-b8

Dimensioni del dato a 8 bit.

-st1

Numero di stop bit uguale a 1.

-pn

Parity none (nessuna).

-ec0

Echo disabilitato.

-lf0

Line feed automatico disabilitato.

-ptcuxtxt

Protocollo utilizzato Cuxtxt.

Inoltre, se possibile, vengono determinati in maniera automatica la porta di comunicazione, il tipo della scheda video e il tipo di modem utilizzato.

3.3 Stati di uscita del programma

Il programma ritorna un errorlevel uguale a zero se termina correttamente, uguale a uno in caso di errore di chiamata, uguale a quattro in caso di terminazione forzata di un file batch (cfr. opzione `-EX') e uguale a 5 in caso di errore di esecuzione di un batch (cfr. le istruzioni `GOTO', `GOTONUM' e `JUMP' nel capitolo Comandi). Inoltre è possibile specificare da modo comandi o in un file batch un diverso livello di errore grazie ai comandi `BYE', `EXIT' e `QUIT' (cfr. il capitolo Comandi).

4. Comandi

In questo capitolo vengono spiegati tutti i comandi del Cux che possono venire specificati in interattivo o in un file batch. Quando si lavora interattivamente si avrà un prompt come nell'esempio che segue e si dovrà digitare i comandi manualmente.

CUX>

Per un miglior uso interattivo dei comandi consigliamo di consultare l'appendice Barre.

Attenzione: a partire dalla release 3.8, il linguaggio di Cux dispone anche di variabili e macro.
Pertanto, in tutto il presente capitolo, ogniqualvolta ci si riferisce a comandi o a parametri di comandi, si sottintende la possibilità che si tratti di variabili o di macro alle quali è stato assegnato come valore quello, rispettivamente, di un comando o di un parametro.

4.1 Formato delle spiegazioni

Ogni comando di questo capitolo verrà spiegato utilizzando il seguente formato:

• Spiegazione del comando.
• Esempio.
• Eventuali note aggiuntive.

Ogni esempio avrà il seguente formato:

CUX> COMANDO ( Commento )

Tutti i comandi di questo capitolo avranno esempi di uso in interattivo. Per gli esempi di utilizzo di comandi in file batch occorre consultare il capitolo Uso di Cux in modalità batch.

In ambienti Unix/Xenix è possibile utilizzare il metacarattere tilde (`~') con lo stesso significato del processore di comandi `csh' o `ksh'. Con questo metacarattere è possibile omettere la `home-directory' dell'utente che sta utilizzando il programma. Cos`ì ad esempio:

# cd /u/utente/prova/prova2

equivale a scrivere

# cd ~/prova/prova2

nel caso l'utente `utente' abbia la `home-directory' in `/u/utente'.

Attenzione: tutti i comandi sono stati scritti in maiuscolo per motivi estetici, ma in realtà l'uso del maiuscolo o del minuscolo è indifferente nella digitazione dei comandi, delle variabili e delle macro.

4.2 Classi di comandi

I comandi di Cux possono essere raggruppati nelle seguenti classi:

Comandi generali

Sono comandi di carattere generale, i quali possono essere utilizzati in vari ambiti operativi. Fanno parte di questa classe `EXIT' e `MUTE'.

Controllo linea di comunicazione

Sono comandi dedicati alla configurazione della linea di comunicazione utilizzata. Fanno parte di questa classe `BAUD' e `BIT'.

Controllo linea modem

Sono comandi che consentono di operare sulla linea di comunicazione in congiunzione con un modem o un apparato esterno di comunicazione. Fanno parte di questa classe `ANSWER' e `INIT'.

Conversazionale

Sono comandi che consentono la configurazione e l'uso di Cux per essere utilizzato come terminale virtuale. Fanno parte di questa classe `CONV' e `STDOUT'.

Protocolli

Sono comandi che consentono la configurazione e l'uso di Cux per effettuare trasferimenti di file. Fanno parte di questa classe `PROTOC' e `SEND'.

Comandi di sistema

Sono comandi che permettono di operare sul sistema operativo utilizzato. Possono essere utilizzati per uscite temporanee sulla shell di sistema o per lanciare programmi dall'interno di Cux stesso. Fanno parte di questa classe `SYSTEM' e `SPAWN'.

Comandi di controllo per file batch

Sono comandi che permettono di operare in modalità batch, consentendo il controllo degli stati di terminazione delle operazioni e il trasferimento del controllo, anche condizionale, ad altri programmi Cux. Fanno parte di questa classe `BATCH' e `IFER'.

Comandi di gestione fax

Sono i comandi che implementano il motore fax fornito con il Cux 3.8 e permettono di ricevere e spedire fax in formato G3, di controllare se la connessione è avvenuta con un fax e di impostare il modem in modalità fax. Fanno parte di questa classe `RECFAX' e `SENDFAX'.

Comandi di gestione voice

Sono i comandi che implementano la gestione della modalità voice introdotta a partire dalla versione 4.0 di Cux. Fanno parte di questa classe `RECVOICE' e `SENDVOICE'.

4.3 Comandi generali

BYE

Il comando `BYE' è identico ai comandi `EXIT' e `QUIT'.

CUX> BYE ( Termina il programma )

EXIT

Il comando `EXIT' termina le operazioni e, se specificato in un file batch, termina il file batch e anche il programma. È possibile specificare il tipo di errorlevel indicando il numero dopo il comando. Se non viene specificato nessun numero, tale comando rende un errorlevel uguale a zero.

CUX> EXIT 2 ( Termina il programma )

In questo esempio il programma renderà come errorlevel il valore due.

FILE

Seleziona il file da trasmettere, ricevere, cancellare o utilizzare per salvare la trasmissione conversazionale, altrimenti nei comandi dove è richiesto un nome di file viene utilizzato il nome di default (`cux.txt').

CUX> PROTOC CUXENC ( Definisce il protocollo ) CUX> FILE cux386.exe ( Cambia il nome file di default ) CUX> REC ( Riceve cux386.exe )

Occorre prestare attenzione all'uso di questo comando perché se dopo il primo `REC' ne eseguiamo un altro senza cambiare il nome in `FILE', il vecchio file verrà sovrascritto dal nuovo.

HELP

Specificando questo comando verrà mostrato sullo schermo l'elenco dei comandi disponibili con una breve spiegazione del comando. È possibile scrivere semplicemente `?' al posto di `HELP'.

CUX> HELP ( Richiesta di aiuto ) Elenco dei comandi disponibili ALINE : Risposta manuale ANSWER : Risposta automatica : : XSEND : Invio di più file Battere <enter> per continuare CUX>

La visualizzazione dell'elenco dei comandi può essere interrotta per mezzo del tasto <DEL>.

LOG

Abilita o disabilita la generazione dei file di log. Questi file hanno come nome di default `cuxlog.RTX'. L'abilitazione si ottiene facendo seguire a `LOG' il parametro `ON', mentre la disabilitazione si ottiene facendo seguire il parametro `OFF'. È anche possibile scegliere il nome del file di log mettendone il nome al posto del parametro `ON', come nell'esempio che segue:

CUX> LOG ON ( Abilita la generazione del file di log ) .......... ( con nome `cuxlog.RTX' ) CUX> LOG OFF ( Disabilita la generazione del file di log ) .......... CUX> LOG infos ( Abilita la generazione del file di log ) .......... ( con nome `infos.RTX' )

Come si può vedere, l'abilitazione della generazione dei file di log è automatica se si imposta il nome del file di log. Non è invece possibile cambiare il nome del file di log attraverso il comando `FILE'. Attenzione: l'estesione del file di log è forzata a `.RTX'.

Per la struttura del file di log si veda l'appendice Il file di log.

MUTE

Elimina l'eco dei comandi a video e tutte le segnalazioni. Questo comando è utile quando si lavora in modalità batch per non visualizzare tutta la sequenza delle operazioni.

CUX> MUTE ON ( Abilita il mute ) CUX> REC ( Riceve un file ) CUX> MUTE OFF ( Disabilita il mute ) CUX> EXIT ( Termina il programma )

Naturalmente se si lavora in interattivo i comandi digitati verrano tutti visualizzati, mentre non verranno visualizzati eventuali messaggi di errore o di termine corretto delle operazioni. Fanno eccezione i comandi `STAT', `WORD' e `HELP' che permettono di ottenere ugualmente l'output a video anche con il `MUTE' abilitato.

PROMPT

Imposta il prompt del programma alla stringa passata come parametro. Per default il prompt è la stringa:

CUX>

Il nuovo valore da assegnare segue le regole del comando `STRING' (cfr.) sui caratteri ammessi.

CUX> PROMPT "CUX:$HOST> " ( Imposta il nuovo prompt ) CUX:AIX>

In questo esempio si suppone che la variabile `HOST' sia definita e valga `AIX', ad indicare per esempio il nome della macchina sulla quale è in esecuzione il programma.

QUIT

Il comando `QUIT' è identico ai comandi `BYE' e `EXIT'.

CUX> QUIT ( Termina il programma )

In questo esempio il programma renderà come errorlevel il valore di default (zero).

SHOW

Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' abilita la visualizzazione delle istruzioni decodificate, le quali vengono visualizzate su standard error. L'abilitazione della visualizzazione si ottiene facendo seguire a `SHOW' il parametro `ON', mentre la disabilitazione della visualizzazione si ottiene facendo seguire il parametro `OFF'. Da sottolineare che tale visualizzazione è indipendente dall'abilitazione dell'eco dei comandi a video (cfr. comando `MUTE'), nel senso che è possibile abilitarla anche se il programma è in modalità muta.

Se è stata specificata l'opzione `-SD' (cfr. capitolo Opzioni) viene visualizzata anche la data e l'ora accanto ad ogni istruzione.

CUX> MUTE ON ( Disabilita l'eco dei comandi a video ) CUX> SHOW ON ( Abilita l'eco delle istruzioni decodificate ) ..........

STAT

Visualizza lo stato del programma. L'output del comando è il seguente:

CUX> BAUD 19200 ( Definisce il baud rate ) CUX> PROTOC cuxbin ( Specifica il protocollo ) CUX> FILE prova.txt ( Specifica il nome del file ) CUX> REPEAT 1 ( Numero di ritrasmissioni ) CUX> STAT ( Visualizza lo stato del programma )

Cux: stato del programma - Versione 3.8 Cuxpath: File: prova.txt Log: cuxlog Protocollo: CUXBIN Porta: ttyF00 AutoLf: OFF Cmdsave: OFF Lunghezza record: 128 Baud: 19200 Autosave: OFF Dtr: OFF Window: 0 Parity: NONE CrLf: OFF Interr: ON Pkdelay: 0 Bit: 8 Duplex: FULL Mute: OFF Ctrl-X: 3 Stop: 1 Echo: OFF Newcux: ON Ritrasmissioni: 1 CtsRts: OFF Print: OFF Show: OFF Convers.nibble: OFF Buffer: 2048 Stdout: OFF Crypt: OFF Path Ymodem: OFF Padchar: 0 Debug: 0 Modem: HAYES Padnum: 0 Log: OFF Numero: Trasm.delay: 0 Errore: 0 Registri: 12 Trasm.trasparente: OFF Return: 0 Ring: 1 Tabulat: 8 Modemctl: OFF Contatore: 0 Timeout: OFF Connesso: OFF CUX>

WORD

Questo comando riporta a video le stringhe assegnate alle capability di gestione del modem correntemente impostato. La prima colonna corrisponde alla capability definita nel file `modmcap', mentre l'ultima corrisponde al valore associato alla capability in questione. Per maggiori informazioni consigliamo di consultare l'appendice Il file Modmcap.

CUX> WORD Elenco parametri di configurazione (HAYES) Ok = OK M0 = CONNECT M3 = CONNECT 300 : : : : : : E1 = 315 E2 = 323 E3 = 324 E4 = 12 CUX>

La visualizzazione dell'elenco dei comandi può essere interrotta per mezzo del tasto <DEL>.

WRLOG

Permette di aggiungere una riga nel file di log corrente passando i tre parametri necessari: stato, numero e stringa.

• stato: uno fra i seguenti caratteri

  S start O ok E error A abort X altro

• numero: un qualsiasi valore numerico compreso tra -2147483648 e 2147483647.
• stringa: una qualsiasi stringa alfanumerica racchiusa tra una coppia di doppi apici `"'.

       CUX> WRLOG O 345 "stringa di prova"
       .......... 

4.4 Controllo linea di comunicazione

BAUD

Specifica il baud rate. Sono valori validi:

50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200, 38400.

Solo per Unix/Linux sono supportati anche i seguenti valori:

57600, 115200, 230400.

Solo per ambiente MsDos sono considerati validi anche i seguenti valori:

2000, 3600, 7200, 23040, 28800, 57600, 115200.

Per Os/2 sono considerati validi solo questi valori:

110, 150, 300, 600, 1200, 2400, 4800, 9600, 19200.

CUX> BAUD 19200 ( Definisce il baud rate ) CUX> PARITY none ( Specifica il tipo di parità ) CUX> BIT 8 ( Numero di bit per parola ) CUX> PORT tty2g ( Porta di comunicazione da usare ) CUX> CONV ( Entra in conversazionale ) .......... CUX> EXIT ( Termine operazioni )

BIT

Definisce il numero di bit per la word. Modificatori validi sono i seguenti:

5 Caratteri da 0 a 31 6 Caratteri da 0 a 63 7 Caratteri ASCII da 0 a 127 8 Caratteri da 0 a 255

L'uso dei protocolli Xmodem e Ymodem forza la trasmissione a otto bit (cfr. l'appendice Protocolli).

CUX> BIT 7 ( Specifica le dimensioni della word ) CUX> PROTOC YMODEM ( Definisce il tipo di protocollo ) CUX> SEND ( Spedisce un file )

Come vedete nell'esempio sopra descritto il protocollo Ymodem forza la word a otto bit, e se vogliamo entrare in conversazionale con un altro programma dobbiamo rispecificare le dimensioni della word. Se prima di lanciare il comando `SEND' avessimo digitato `BIT 7' la trasmissione del file sarebbe risultata errata.

BREAK

Invia un break sulla linea, come nel seguente esempio:

CUX> BIT 8 ( Definisce la word ) CUX> PARITY NONE ( Definisce il tipo di parità ) CUX> BAUD 9600 ( Specifica il baud rate ) CUX> PORT tty2g ( Specifica la porta da utilizzare ) CUX> BREAK ( Manda un break sulla linea ) ..........

BYPASS

Apre la linea di comunicazione indicata come parametro, mettendola in bypass con la linea correntemente aperta. Sostanzialmente il comando permette di realizzare un passante grazie al quale è possibile trasferire i dati in arrivo dalla linea principale alla linea in bypass, e i dati in arrivo dalla linea in bypass alla linea principale.

Se è abilitata la produzione del file di log (cfr. comando `LOG') vengono salvati in tale file tutti i dati trasferiti, prefiggendoli con `<' o `>', a seconda della linea di provenienza. Se i dati non sono caratteri ASCII visualizzabili vengono scritti gli equivalenti valori esadecimali.

È possibile interrompere il passante per mezzo del tasto <DEL> o tramite l'istruzione `TRAP'.

CUX> PORT tty2f ( Specifica la porta da utilizzare ) CUX> BYPASS tty2g ( Specifica la seconda porta ) ..........

In questo esempio tutti i dati provenienti dalla linea `tty2f' verranno inviati alla linea `tty2g' e tutti i dati in arrivo dalla linea `tty2g' verranno inviati alla linea `tty2f'.

Attenzione: tale comando imposta il flag di errore (cfr. i comandi `IFER' e `IFNOER') in caso di errore nell'apertura della linea o in caso di caduta di portante ma solo se è abilitato il controllo della portante stessa (cfr. il comando `MODEMCTL'.

CLEAR

Il comando `CLEAR' reinizializza il buffer di seriale eliminando tutti i caratteri eventualmente presenti. Si consiglia di usare questa opzione qualora durante delle operazioni di trasferimento di dati vi fossero delle difficoltà dovute a disturbi di linea.

.......... CUX> PROTOC XMODEM ( Protocollo da utilizzare ) CUX> CLEAR ( Pulizia del buffer di seriale ) CUX> FILE pippo.txt ( Imposta il file ) CUX> SEND ( Lo spedisce ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

CLOSE

Chiude la porta correntemente aperta. Per impostare una nuova porta occorre utilizzare il comando `PORT'.

CUX> PORT tty00 ( Imposta la porta da utilizzare ) CUX> CONV ( Entra in conversazionale ) .......... CUX> CLOSE ( Chiude la porta corrente ) CUX> PORT tty01 ( Imposta una nuova porta da utilizzare ) CUX> FILE pippo.txt ( Imposta il file ) CUX> SEND ( Lo spedisce ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

CTS

Abilita o disabilita il protocollo di handshake hardware Cts/Rts.

CUX> CTS ON ( Abilita il protocollo Cts/Rts ) .......... CUX> CTS OFF ( Disabilita il protocollo Cts/Rts ) ..........

Per maggiori informazioni consultare l'appendice Protocolli.

DUMP

Il comando `DUMP', disponibile solo per ambiente MsDos, permette di visualizzare sullo schermo il contenuto del buffer di comunicazione in formato ASCII, mentre i caratteri speciali vengono visualizzati con i simboli standard (ad esempio <NUL> per lo 0).

CUX> DUMP ( Visualizza il buffer di comunicazione ) .........

DUMPOLD

Il comando `DUMPOLD', disponibile solo per ambiente MsDos, permette di visualizzare sullo schermo il contenuto del buffer di comunicazione già scaricato nell'identico formato del comando `DUMP'.

CUX> DUMPOLD ( Visualizza il buffer di comunicazione ) ..........

MAXBUF

Specifica le dimensioni in byte del buffer di input di comunicazione, e può essere un qualsiasi valore compreso tra 128 e 65535. Deve però essere almeno il doppio della lunghezza del record del protocollo scelto (cfr. comando `LENREK').
I seguenti protocolli forzano la lunghezza del record a 1024 byte, e di conseguenza occorre impostare `MAXBUF' ad almeno 2048 byte (che corrisponde al default):

XMODEM1K

Protocollo Xmodem con blocco di 1024 byte.

YMODEM1K

Protocollo Ymodem con blocco di 1024 byte.

XMODEM1KC

Protocollo Xmodem con blocco di 1024 byte e controllo CRC.

YMODEM1KC

Protocollo Ymodem con blocco di 1024 byte e controllo CRC.

       CUX> LENREK 512              ( Specifica la lunghezza del record  )
       CUX> PROTOC XMODEM1K         ( Definisce il tipo di protocollo    )
       CUX> MAXBUF 127              ( Definisce le dimensioni del buffer )

       Buffer sottodimensionato rispetto al record
       Lunghezza buffer non accettabile

       CUX> MAXBUF 1024             ( Definisce le dimensioni del buffer )

       Buffer sottodimensionato rispetto al record

       CUX> MAXBUF 2048             ( Definisce le dimensioni del buffer )
       CUX> SEND                    ( Spedisce un file                   )
       .........

Nel caso di linee Tcp/Ip imposta il buffer associato alla socket aperta.

PARITY

Specifica la parità. Valori validi sono:

• ODD
• EVEN
• MARK (Richiede che la word abbia dimensione minore di 8 bit)
• SPACE (Richiede che la word abbia dimensione minore di 8 bit)
• NONE

       CUX> BIT 8
       CUX> PARITY NONE      ( Definisce il tipo di parità               )
       ..........
       CUX> PARITY MARK      ( Definisce il tipo di parità               )
       Errore di Ioctl
       CUX> BIT 7            ( Specifica le dimensioni della word        )
       CUX> PARITY MARK      ( Definisce il tipo di parità               )
       ..........

PORT

Seleziona la porta di comunicazione indicata come parametro fra quelle elencate ed abilitate nel file `sercap'.

CUX> PORT COM1 ( Seleziona la porta da utilizzare ) ........

A partire dalla versione 3.8a Cux permette di accedere anche ai servizi di rete tramite le socket.

Le socket sono sostanzialmente un'interfaccia per i programmi applicativi al livello di trasporto di una rete che utilizza la suite di protocolli Tcp/Ip.

Tramite le socket è quindi possibile realizzare connessioni e comunicazioni non seriali ma di rete. Una delle caratteristiche di tali comunicazioni è l'implementazione di uno schema rigido in cui ogni estremo della connessione può assumere solo uno di due modi operativi prefissati, server o client, ciascuno caratterizzato dall'esecuzione di una ben precisa serie di operazioni. Si parla perciò di processo server o processo client a seconda della modalità operativa della connessione stabilita dal processo in questione. Un processo server opera in ascolto su un canale di comunicazione, accettando richieste quando queste sono rilevate. Un processo client si connette con un processo server su un canale di comunicazione noto a priori.

N.B: occorre precisare una differenza di terminologia che può ingenerare confusione: mentre in questo manuale si usano indifferentemente i termini porta e linea per indicare una linea di comunicazione quale definita nel file `sercap', nel mondo del networking si intende generalmente per port l'indirizzo numerico, ovvero un identificativo, di un servizio di rete.

Per effettuare una connessione di rete via socket occorre dunque:

1. Utilizzare una porta configurata opportunamente nel file `sercap'. A tale scopo si rimanda al capitolo Il file sercap nelle Appendici.
2. Specificare la modalità della connessione, se server o client. Nel primo caso occorre specificare solo un servizio (port) mentre nel secondo caso occorre specificare un servizio e una macchina (host), quest'ultima tramite il suo nome di rete o il suo indirizzo internet. Entrambi questi parametri sono facoltativi: se omessi vengono impostati quelli definiti nel file `sercap' relativi alla porta selezionata (cfr. capability `Nm' e `So' nel capitolo Il file sercap nelle Appendici).

Nel seguente esempio si vuole effettuare una connessione di rete via socket in modo client collegandosi con l'host il cui indirizzo internet è 172.16.1.1 sul servizio (port) 3005. Si noti l'utilizzo della porta `sercap' `TCP_C'.

CUX> PORT TCP_C 3005 172.16.1.1 ........

Nel seguente esempio si vuole invece aprire una connessione di rete via socket in modo server sul servizio (port) 3005. Si noti qui l'utilizzo della porta `sercap' `TCP_S'.

CUX> PORT TCP_S 3005 ........

A partire dalla versione 4.0 Cux implementa internamente il protocollo telnet. Questo significa che è possibile collegarsi alla porta 23 (porta standard per il servizio telnet) e gestire direttamente la connessione. Ovviamente in tal caso la porta utilizzata da Cux deve essere configurata in modo client.

CUX> PORT TCP_C 23 ........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

RSTRING

Attende una stringa sulla linea di comunicazione (tipicamente inviata con il comando `STRING') visualizzandola a video. Il comando può essere opzionalmente seguito da uno o due parametri, per indicare un tempo massimo di attesa (espresso in secondi) e/o una stringa specifica da attendere. Al ritorno del comando la variabile predefinita `WORD' conterrà la stringa ricevuta.

Inoltre, la stringa da attendere, se indicata, può essere racchiusa tra una coppia di doppi apici `"'. Se la stringa non viene racchiusa tra una coppia di doppi apici il programma assume implicitamente che la stringa sia terminata dal carattere `CR'. Se invece la stringa da attendere viene racchiusa tra una coppia di doppi apici il programma attende esattamente la stringa specificata, senza il carattere terminatore `CR'. In questo secondo caso se la stringa termina con un `CR', tale carattere deve essere esplicitamente specificato all'interno della stringa stessa. Se sono usati i doppi apici sono infatti ammessi anche dei caratteri speciali, tra i quali appunto il `CR'. Per la sintassi della stringa tra apici vedere il comando `STRING'.

Il comando senza parametri determina l'entrata nello stato di ricezione illimitata di una stringa qualsiasi, purché tuttavia terminata dal carattere `CR'. In tal caso il comando ritorna solo se e quando viene ricevuto il carattere `CR'.

CUX> RSTRING ( Attesa illimitata di una stringa qualsiasi )

Se è presente un solo parametro ed è numerico il programma assume che si tratti di un tempo di attesa, e in tal caso il comando ritorna solo dopo la ricezione di una stringa qualsiasi (ma terminata con `CR') oppure dopo il tempo di attesa specificato. Se invece l'unico parametro presente non è numerico oppure è numerico ma è racchiuso tra una coppia di doppi apici il programma assume che si tratti di una stringa specifica da attendere, e in tal caso il comando ritorna solo se e quando viene ricevuta la stringa specificata.

CUX> RSTRING 10 ( Attesa di 10 secondi di una stringa qualsiasi ) CUX> RSTRING ok ( Attesa illimitata della stringa 'ok\r' ) CUX> RSTRING "10" ( Attesa illimitata della stringa '10' )

Se sono presenti due parametri il primo deve essere numerico, ad indicare il tempo di attesa, mentre il secondo viene assunto come la stringa da attendere.

CUX> RSTRING 10 ok ( Attesa di 10 secondi della stringa 'ok\r' ) CUX> RSTRING 10 "10" ( Attesa di 10 secondi della stringa '10' )

A partire dalla release 3.8 di Cux è stata introdotta la ricezione multivia: è cioè possibile indicare più stringhe, purché separate dalla virgola `,'. In questo caso il comando, se non ritorna per timeout, ritorna solo se e quando viene riconosciuta una tra le stringhe indicate. Al ritorno del comando la variabile predefinita `WHICH' conterrà il numero relativo alla posizione della stringa riconosciuta (1 per la prima stringa, 2 per la seconda e cos`ì via) mentre la variabile predefinita `WORD' conterrà la stringa ricevuta. Nel seguente esempio si suppone di ricevere la stringa ricezione:

CUX> RSTRING esempio,di,ricezione,multivia ricezione CUX> MESG $WHICH 3 CUX> MESG $WORD ricezione

Se è indicato un tempo massimo di attesa e il comando ritorna perché questo è stato superato, viene impostato il flag di errore (cfr. i comandi `IFER' e `IFNOER') e il flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT').

Se è stato disabilitato l'eco a video dei comandi (cfr. il comando `MUTE'), il comando `RSTRING' non visualizza i dati ricevuti. Tuttavia se viene attivata la modalità di salvataggio tutto ciò che viene ricevuto fino al ritorno del comando viene salvato su file (cfr. il comando `SAVE').

A partire dalla versione 3.8b il comando `RSTRING' risente anche dell'impostazione dell'eco locale (cfr. il comando `ECHO'): se questo è abilitato (`ECHO'=`on'), il comando `RSTRING' scrive sulla linea di comunicazione ogni carattere ricevuto dalla linea stessa.

A partire dalla versione 4.0 di Cux tale comando può terminare con errore, quindi impostando il flag di errore (cfr. i comandi `IFER' e `IFNOER'), anche in caso di caduta di portante.

In ogni caso e qualsiasi sia la forma con cui è usato il comando, è possibile terminare l'attesa in interattivo premendo il tasto <DEL>. In tal caso il comando ritorna con il flag di errore impostato (cfr. i comandi `IFER' e `IFNOER').

Altra possibiltà per l'interruzione dell'attesa è data dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

STOP

Questo comando permette di impostare il numero di bit di stop. I valori accettabili sono 1 (default) o 2.

CUX> STOP 2 ( Imposta i bit di stop ) ..........

Se si utilizza coma parità `MARK' o `SPACE' la somma dei bit di stop e dei bit della word (cfr. comando `BIT') non deve essere superiore a otto.

STRING

Con questo comando viene mandata una stringa terminata da un `CR' sulla linea di comunicazione. Se la stringa è racchiusa tra doppi apici (`"') sono ammessi i seguenti caratteri speciali:

\r CR \n LF \b BACKSPACE \g BELL \l FORMFEED \\ \ \" " \OOO caratteri speciali, dove OOO rappresenta qualunque numero ottale.

Inoltre se la stringa è racchiusa tra doppi apici il `CR' finale è inviato solo se specificato esplicitamente.

CUX> STRING "In questo caso il 'CR' viene inviato \r" CUX>

UNGET

Mette nel buffer di comunicazione il carattere indicato come parametro o un `NUL' se non è indicato alcun parametro. È possibile indicare come parametro anche un carattere speciale, nel qual caso sono seguite le stesse regole del comando `STRING' (cfr.) sui caratteri ammessi. Nel seguente esempio si suppone di ricevere dalla linea come primo carattere una `A':

CUX> RSTRING "A","B","C","D" CUX> GOTONUM L_ERR,L_A,L_B,L_C,L_D .......... CUX> LABEL L_A CUX> UNGET "A" CUX> CALL batch_a ..........

L'esecuzione salta quindi all'etichetta denominata `L_A' in cui viene rimesso nel buffer di comunicazione il carattere `A' e viene poi chiamato il batch `batch_a'.

XOFF

Sblocca l'Xon/Xoff sulla linea in input, ovvero simula l'arrivo dalla linea di comunicazione del carattere di Xon che in genere è il carattere <CTRL><Q>.

.......... CUX> XOFF ..........

Per maggiori spiegazioni si rimanda al paragrafo Protocollo Xon/Xoff nell'appendice Protocolli.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

XRSTRING

Il comando `XRSTRING' è simile al comando `RSTRING' con la differenza fondamentale che invece di attendere la ricezione di una stringa inviata via `STRING' attende la ricezione di un blocco di dati inviato dal comando `XSTRING'.

I parametri accettati da questo comando sono due: il primo indica il tempo massimo (espresso in secondi) entro il quale deve giungere la stringa attesa (superato questo tempo il comando uscirà impostando il flag di timeout); il secondo rappresenta la stringa attesa. Entrambi i parametri sono opzionali; unica attenzione va prestata al timeout che, se presente, deve essere il primo parametro specificato.

Se la stringa attesa viene passata al comando racchiusa tra doppi apici, il comando non si aspetta il carattere `CR' di terminazione. Tale carattere, in questo caso, dovrebbe essere specificato esplicitamente all'interno della stringa (cfr. `STRING').

È possibile terminare l'attesa di ricezione in interattivo tramite il tasto <DEL>.

Mentre la condizione per un'uscita corretta del comando `RSTRING' è la ricezione di una qualunque sottostringa non vuota della stringa indicata come parametro, la condizione per un'uscita corretta del comando `XRSTRING' è la ricezione di una sottostringa iniziale non vuota della stringa specificata. Ad esempio, la seguente ricezione via `RSTRING' riesce:

Sistema remoto CUX> STRING "A-UNO-B" Sistema locale CUX> RSTRING "UNO"

mentre la seguente ricezione via `XRSTRING' fallisce:

Sistema remoto CUX> XSTRING "A-UNO-B" Sistema locale CUX> XRSTRING "UNO"

Riesce invece la seguente ricezione via `XRSTRING':

Sistema remoto CUX> XSTRING "UNO-B" Sistema locale CUX> XRSTRING "UNO"

Un'altra differenza rispetto al comando `RSTRING' è data dal fatto che il comando `XRSTRING' non produce nessun output a video. È comunque possibile salvare ciò che si è ricevuto grazie al comando `SAVE'.

Il comando `XRSTRING' risulta utile qualora si voglia costruire un meccanismo di identificazione equivalente al login in ambienti Unix/Xenix. Quello che segue è un tipico esempio di utilizzo di tale comando.

...... CUX> FILE xrstring.txt ( Inizializzazione file ) CUX> SAVE ON ( Inizio memorizzazione su file ) CUX> XRSTRING 60 ( Attende una stringa ) CUX> SAVE OFF ( Termine salvataggio su file ) CUX> IFOUT BATCH TERMINE.CUX ( Per timeout esegue un batch ) ......

Attenzione: il timeout passato come parametro, per assumere significato, deve avere un valore minimo di 20 secondi. Qualora si indicasse un timeout minore del valore minimo si attenderà ugualmente per 20 secondi prima di terminare con un eventuale segnalazione di errore. Lo stesso discorso vale anche per i multipli di 20 secondi.

Attenzione: lo stato di uscita del comando `XRSTRING' influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER') se viene interrotto tramite il tasto <DEL>, e influisce sul valore del flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT') se esce per timeout.

È anche possibile che l'attesa venga interrotta dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

Analogamente al comando `RSTRING', a partire dalla release 3.8 di Cux è stata introdotta la ricezione multivia anche per il comando `XRSTRING', con sintassi e modalità del tutto analoghe a quelle descritte nel caso del comando `RSTRING'.

XSTRING

Con questo comando viene mandata una stringa terminata da un `CR' sulla linea di comunicazione. A differenza del comando `STRING' non viene trasmessa come stringa ma come blocco controllato di dati. Questo significa che mentre il comando `STRING' si cura di inviare una stringa, il comando `XSTRING' si cura che la stringa inviata venga ricevuta. In altri termini, il comando `STRING' ritorna dopo aver inviato la stringa sulla linea di comunicazione, mentre il comando `XSTRING' ritorna solo dopo che la stringa è stata ricevuta.

I parametri accettati da questo comando sono due: il primo indica il tempo massimo (specificato in secondi) entro il quale si dovrà riuscire ad inviare la stringa (superato questo tempo il comando uscirà con errore); il secondo rappresenta la stringa da inviare. Entrambi i parametri sono opzionali; unica attenzione va prestata al timeout che, se presente, deve essere il primo parametro specificato. Inoltre vi è una limitazione sulla lunghezza della stringa che non può superare i 128 caratteri.

Se la stringa da inviare viene passata al comando racchiusa tra doppi apici, non sarà terminata automaticamente dal carattere `CR'. Tale carattere, in questo caso, dovrebbe essere specificato esplicitamente all'interno della stringa (cfr. `STRING').

...... CUX> XSTRING 60 "START" ( Invia la stringa 'START'. ) ( Il comando deve avere ) ( successo entro 60 secondi. ) CUX> IFER GOTO ERRORE ( Su errore salta alla label. ) CUX> CONV ( Entra in conversazionale. ) ......

Attenzione: il timeout passato come parametro, per assumere significato, deve avere un valore di almeno 35 secondi; qualora si indicasse un timeout minore del valore minimo si attenderà ugualmente per 35 secondi prima di terminare con un'eventuale segnalazione di errore. Lo stesso discorso vale anche per i multipli di 35 secondi.

Attenzione: lo stato di uscita del comando `XSTRING' influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER') se viene interrotto tramite il tasto <DEL>, e influisce sul valore del flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT') se esce per timeout.

Come nel caso del comando `XRSTRING', anche nel caso del comando `XSTRING' è possibile che l'attesa venga interrotta dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

4.5 Controllo linea modem

ALINE

Connette la linea in risposta (answer) senza attendere gli squilli: in pratica esce dalla modalità comandi per entrare in modalità dati e attende che si connetta un modem.

CUX> BAUD 9600 ( Definisce il baud rate ) CUX> PORT ttya2 ( Definisce la porta da utilizzare ) CUX> HANGUP ON ( Aggancia la linea telefonica ) CUX> MESG ABBASSARE RICEVITORE ( Messaggio ) CUX> ALINE ( Si connette con la linea ) .......... CUX> REC pippo ( Riceve il file 'pippo' ) .......... CUX> ASK ALZARE RICEVITORE E BATTERE ENTER ( Richiesta input ) CUX> COMMAND ( Ritorna in modalità comandi ) CUX> HANGUP OFF ( Sgancia la linea telefonica ) ..........

In questo esempio si era già collegati a voce con un interlocutore, il quale vuole spedire un file; si dovrà allora specificare la velocità di trasmissione e la porta; successivamente, dopo aver specificato il comando `HANGUP ON', abbassare la cornetta e digitare il comando `ALINE'. Al termine delle operazioni volendo riprendere la conversazione telefonica si dovrà, prima di dare il comando `COMMAND', alzare la cornetta.

Se il comando è preceduto dal comando `RESETFAX' può agganciare anche un fax.

Se il comando è preceduto dal comando `RESETVOICE' alza la linea.

Se viene riconosciuta una delle stringhe previste assegna alla variabile predefinita `WHICH' il numero corrispondente e ne lascia copia nella variabile predefinita `WORD'. Per l'elenco delle stringhe previste e dei numeri corrispondenti vedere il comando `DIAL'.

Vedere anche l'opzione `-ma' nel capitolo Opzioni sulla linea di comando.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER'), del flag di riconoscimento di connessione fax (cfr. il comando `IFFAX') e del flag di riconoscimento di connessione voice (cfr. il comando `IFVOICE').

ANSWER

Attende una chiamata da parte di un altro modem. La risposta automatica avverrà dopo `n' squilli, dove `n' è il valore associato al comando `RING'.

CUX> RING 4 ( Specifica il numero di squilli ) CUX> ANSWER ( Attende una chiamata ) ......... CUX> COMMAND ( Ritorna in modalità comandi ) CUX> NOANSWER ( Termina l'autoanswer ) ..........

È possibile anche indicare un tempo massimo di attesa, espresso in secondi, e se entro tale tempo non avviene una chiamata il comando esce con errore.

......... CUX> ANSWER 120 ( Attende una chiamata entro 120 secondi ) .........

Se il comando è preceduto dall'istruzione `RESETFAX' può agganciare anche un fax (cfr. la capability `Af' del file `modmcap').

Se il comando è preceduto dall'istruzione `RESETVOICE' alza la linea.

Se è riconosciuta una delle stringhe previste viene assegnata alla variabile predefinita `WHICH' il numero corrispondente e alla variabile predefinita `WORD' la stringa corrispondente. Per l'elenco delle stringhe previste e dei numeri corrispondenti si veda il comando `DIAL'.

Vedere anche l'opzione `-aa' nel capitolo Opzioni sulla linea di comando.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER'), del flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT'), del flag di riconoscimento di connessione fax (cfr. il comando `IFFAX') e del flag di riconoscimento di connessione voice (cfr. il comando `IFVOICE').

CMDSAVE

Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' abilita la produzione di un file di log per il salvataggio dei comandi inviati per la negoziazione TELNET (dalla versione 4.0) o al modem e relative risposte, mentre se impostato a `OFF' la produzione di tale file di log è disabilitata. L'abilitazione si ottiene facendo seguire a `CMDSAVE' il parametro `ON', mentre la disabilitazione si ottiene facendo seguire il parametro `OFF'.

Attenzione che l'abilitazione è accettata solo se è abilitato anche il file di log generale (cfr. opzione `-lo' e comando `LOG'). Il file di log cos`ì prodotto ha estensione `.SAV' e nome uguale al nome del file di log generale che ha estensione `RTX'.

.......... CUX> CMDSAVE ON ( Abilita il log del colloquio col modem ) ..........

La funzionalità di questo comando è del tutto analoga a quella dell'opzione `-SA' (cfr.).

COMMAND

Il comando `COMMAND' permette di passare dalla modalità dati alla modalità comandi.

CUX> DIAL 1234567 ( Chiama il numero specificato ) .......... CUX> COMMAND ( Ritorna in modalità comandi ) CUX> IFER COMMAND ( In caso di errore riprova ) CUX> HANGUP OFF ( Sgancia la linea telefonica ) CUX> IFER HANGUP OFF ( In caso di errore riprova ) CUX> EXIT ( Termina il programma )

In questo esempio prima entriamo in modalità dati per collegarci con un numero telefonico poi, dopo aver svolto eventuali operazioni in modalità dati, se vogliamo rientrare in modalità comandi è necessario digitare il comando `COMMAND'. Tale comando occorre normalmente utilizzarlo dopo i comandi `ALINE', `ANSWER', `DIAL', `DLINE'.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

DIAL

Chiama il numero passato come parametro o, se non è specificato alcun parametro, chiama il numero impostato precedentemente tramite il comando `NUMBER'. Se però il comando è usato senza parametri e se non è stato precedentemente impostato alcun numero per mezzo del comando `NUMBER', il comando `DIAL' ritorna con errore.

CUX> NUMBER 5555555 ( Specifica il numero telefonico ) CUX> DIAL ( Chiama il numero di NUMBER ) .......... CUX> DIAL 55555666 ( Chiama il numero scelto ) ..........

Se viene indicato un numero come parametro non viene modificato il numero specificato per mezzo del comando `NUMBER' (è possibile vedere tale numero tramite il comando `STAT').

Se preceduto dal comando `RESETFAX' può chiamare anche un fax.

Se preceduto dal comando `RESETVOICE' chiama a voce ed esce per cornetta alzata dal capo opposto della linea.

A partire dalla versione 4.0 è stata introdotta la possibilità di effettuare chiamate multinumero, ovvero di specifire più numeri da chiamare in successione fino a quando uno di questi risulti libero. Per maggiori dettagli si veda il comando `NUMBER'.

Se la linea è occupata esce subito, altrimenti tenta di chiamare per il numero di volte previsto (cfr. capability `Nm' nel file `modmcap').

Il file `modmcap' permette di assegnare le stringhe di risposta prodotte dal modem a specifiche capability. Tali stringhe possono riguardare sia il tipo di connessione effettuata sia un eventuale errore riscontrato dal modem. In entrambi i casi il comando `DIAL' assegna alla variabile predefinita `WORD' la stringa corrispondente all'evento occorso. Solo invece nel caso di connessione effettuata correttamente assegna alla variabile predefinita `WHICH' il numero corrispondente alla stringa riconosciuta (nei casi di errore la variabile `WHICH' non viene modificata). Le stringhe di connessione, infatti, sono numerate progressivamente da 0 a 28 ed ognuna è associata ad una particolare capability. Per un elenco completo di tali capability si rimanda alla sezione Guida di riferimento dell'appendice Il file modmcap.

Nel caso ad esempio di linea occupata, il comando `DIAL' esce subito assegnando alla variabile predefinita `WORD' la stringa associata alla capability `Bu' definita nel file `modmcap', tipicamente la stringa `BUSY'. O ancora, nel caso di un modem configurato per linee americane, in cui il modem attende il cosiddetto dial tone, il comando `DIAL' esce assegnando alla variabile predefinita `WORD' la stringa associata alla capability `Li' definita nel file `modmcap', tipicamente la stringa `NO DIAL TONE'.

Nel caso invece di una connessione effettuata correttamente a 9600 baud, il comando `DIAL' assegna alla variabile `WORD' la stringa `CONNECT 9600' e alla variabile `WHICH' il valore `7'.

Di seguito è riportata la definizione delle stringhe di connessione nel caso di modem di tipo HAYES. È importante sottolineare che il numero di riferimento è costante, ovvero indica l'n-esima risposta, mentre la stringa corrispondente è relativa al modem caricato e può quindi variare con esso.

1. CONNECT
2. CONNECT 300
3. CONNECT 600
4. CONNECT 1200
5. CONNECT 2400
6. CONNECT 4800
7. CONNECT 9600
8. CONNECT 19200
9. CONNECT 14400
10. CONNECT 28800
11. CONNECT 300 MNP
12. CONNECT 1200 MNP
13. CONNECT 2400 MNP
14. CONNECT 38400
15. CONNECT 48000
16. CONNECT 57600
17. CONNECT 64000
18. CONNECT 76800
19. CONNECT 115200
20. CONNECT 12000
21. CONNECT 7200
22. CONNECT PEP UUCP
23. CONNECT PEP KERMIT
24. CONNECT PEP XMODEM
25. CONNECT PEP
26. CONNECT FAX
27. CONNECT VOICE
28. CONNECT 1200/75
29. NO CARRIER
30. ERROR
31. ABORTED
32. NO ANSWER
33. NO DIAL TONE
34. BUSY
35. TIME OUT
36. TRYING TO CONNECT
37. +FHNG:

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER') e del flag di riconoscimento di connessione fax (cfr. il comando `IFFAX').

DLINE

Permette di connettere la linea in originate senza dover comporre il numero, presupponendo che vi sia già la linea attiva (cfr. il comando `ALINE').

CUX> HANGUP ON ( Aggancia la linea ) CUX> MESG ABBASSARE RICEVITORE ( Messaggio ) CUX> DLINE ( Si connette in originate ) CUX> SEND prova.tex ( Spedisce il file specificato ) .......... CUX> ASK ALZARE IL RICEVITORE E BATTERE ENTER ( Richiesta input ) CUX> COMMAND ( Ritorna in modalità comandi ) CUX> HANGUP OFF ( Sgancia la linea telefonica )

In questo esempio due persone stanno parlando via telefono quando una decide di trasmettere un file dati con il modem: specifica allora la porta di comunicazione di uscita, la velocità del proprio modem, digita il comando `HANGUP ON' (e solo a questo punto può abbassare la cornetta) e si connette in originate (comando `DLINE') entrando automaticamente in modalità dati. A questo punto possono venire svolte tutte le operazioni relative a questa modalità come trasmissione e ricezione di file, sempre che dall'altra parte della linea telefonica sia pronto un altro Cux in attesa (con il comando `ALINE').

Se il comando è preceduto dal comando `RESETFAX' può agganciare anche un fax.

Se il comando è preceduto dal comando `RESETVOICE' alza la linea.

Se viene riconosciuta una delle stringhe previste assegna alla variabile predefinita `WHICH' il numero corrispondente e ne lascia copia nella variabile predefinita `WORD'. Per l'elenco delle stringhe previste e dei numeri corrispondenti vedere il comando `DIAL'.

Vedere anche l'opzione `-md' nel capitolo Opzioni sulla linea di comando.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER') e del flag di riconoscimento di connessione fax (cfr. il comando `IFFAX').

HANGUP

Il comando `HANGUP' permette di agganciare o sganciare la linea telefonica.

A partire dalla versione 4.0 di Cux, il comportamento di tale comando è stato leggermente modificato: se era stato dato in precedenza uno tra i comando `RESETFAX' o `RESETVOICE', il comando `HANGUP' non riporta il modem allo stato normale: per fare ciò bisogna usare il comando `RESETDATA' (cfr).

CUX> HANGUP ON ( Aggancia la linea telefonica ) CUX> ALINE ( Si connette in risposta ) .......... CUX> COMMAND ( Ritorna in modalità comandi ) CUX> HANGUP OFF ( Sgancia la linea telefonica )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

INIT

Il comando `INIT' viene utilizzato per caricare i parametri del modem. Se specificato senza nessun parametro considererà come modem utilizzato quello definito dalla variabile di environment `MODM', se tale variabile è definita, altrimenti è possibile definire il tipo di modem da utilizzare specificandolo come parametro. Naturalmente il tipo di modem deve essere tra quelli compresi nel file `modmcap'.

CUX> INIT ( Carica i parametri del modem di default ) Caricato: HAYES CUX> INIT 1200CT ( Carica i parametri del modem scelto ) Caricato: 1200CT CUX> RESET ( Inizializza il modem )

Nell'esempio il primo modem di cui vengono caricati i parametri è quello di default cioè quello specificato nella variabile di environment `MODM' (vedere anche le appendici Il file Modmcap e L'environment), successivamente carichiamo i parametri di un modem Smarteam 1200; infine con il comando `RESET' viene inizializzato il tipo di modem scelto.

Se nella descrizione del modem caricato è presente la capability booleana `Nu' tutti i comandi di gestione del modem vengono ignorati, nel senso che escono (ritornano) immediatamente con il flag di errore azzerato come se fossero stati accettati dal modem, anche se in tal caso al modem non viene inviato nessun comando (cfr. Il file Modmcap).

MDIAL

Chiama il numero specificato dal comando `NUMBER' o passato come parametro per connettersi in fonia (non trasmette dati).

CUX> NUMBER 123456789 ( Specifica il numero telefonico ) CUX> MDIAL ( Si connette in fonia ) CUX> ASK ALZARE RICEVITORE E BATTERE ENTER ( Richiesta input ) CUX> HANGUP OFF ( Sgancia la linea )

Dopo il comando `MDIAL' si può sollevare il ricevitore. Per parlare senza interferenze del modem occorre digitare il comando `HANGUP OFF'.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

MODEMCTL

Abilita controllo della portante durante l'esecuzione dei comandi `CONV', `REMOTE' e `SPAWN'. Ammette come parametro uno dei due valori (`ON') e (`OFF').

Se il controllo della portante è abilitato (`MODEMCTL ON'), in ambiente Unix/Xenix la caduta della portante durante l'esecuzione di una delle suddette istruzioni determina l'uscita dell'istruzione in questione con il flag di errore impostato (cfr. i comandi `IFER' e `IFNOER').

Attenzione: dopo l'esecuzione dei comandi `CONV', `REMOTE' e `SPAWN' e/o dopo esser caduta di portante, il comando viene riportato nello stato di default `OFF'.

In ambiente MsDos il comando `MODEMCTL' assume significato solo in coppia con i comandi `CONV' e `REMOTE', nel senso che con controllo di portante abilitato (`MODEMCTL ON') la caduta della portante durante l'esecuzione del comando `CONV' determina l'uscita dal conversazionale con il flag di errore impostato (cfr. i comandi `IFER' e `IFNOER'), mentre la caduta della portante durante l'esecuzione del comando `REMOTE' provoca un boot della macchina. In entrambi i casi viene anche modificato il valore di tale comando, il quale è automaticamente riportato a `OFF'.

Se invece il controllo della portante è disabilitato (`MODEMCTL OFF'), la caduta della portante non ha alcun effetto su tali istruzioni.

CUX> MODEMCTL ON ( Abilita il controllo della portante ) CUX> CONV ( Entra in conversazionale ) CUX> IFER GOTO RICHIAMA ( Se cade la portante richiama )

Attenzione: per un corretto funzionamento il device utilizzato deve gestire il contollo modem, deve cioè sentire un'eventuale caduta di portante e segnalarla al processo (in tal caso al Cux) che è associato alla linea. Inoltre occorre anche che il cavo abbia un controllo modem corretto (allo scopo si vedano le appendici Il file Sercap e Cavi e connessioni RS232).

NOANSWER

Impedisce le operazioni di autoanswer che generalmente iniziano con il comando `ANSWER'. È obbligatorio, per poter utilizzare questo comando, essere in modalità comandi. Se si è invece in modalità dati occorre prima specificare l'istruzione `COMMAND'. Il comando `ANSWER' può essere utilizzato indipendentemente dal comando `ANSWER' se il modem soddisfa almeno una delle seguenti condizioni:

• È in autoanswer.
• Ha un interruttore hardware posizionato sull'autoanswer.
• Ha la possibilità di mantenere uno switch software nella propria memoria.

       CUX> RING 4                  ( Specifica il numero di squilli     )
       CUX> ANSWER                  ( Attende una chiamata               )
       .........
       CUX> COMMAND                 ( Ritorna in modalità comandi        )
       CUX> NOANSWER                ( Impedisce l'autoanswer             ) 
       ..........

NUMBER

Seleziona il numero telefonico da chiamare (cfr. anche i comandi `DIAL' e `MDIAL'). Nel numero è possibile introdurre dei caratteri di ritardo a patto che facciano parte dei seguenti:

/ , ( ) - .

Il valore può essere programmato con il registro `S8' nella configurazione del modem (cfr. l'appendice Il file Modmcap). In ogni caso tutti i caratteri vengono trasformati in maniera trasparente in virgole (,) in modo che possano essere comprese dai modem standard Hayes.

CUX> NUMBER 1234567 ( Specifica il numero da chiamare ) CUX> NUMBER 1,2,3,4,5,6,7 ( Specifica il numero da chiamare ) CUX> NUMBER 1/2,3(4)5-6.7 ( Specifica il numero da chiamare ) CUX> DIAL ( Chiama il numero scelto ) ..........

A partire dalla versione 4.0 è possibile specificare un elenco di numeri separati dal carattere `|': in tal caso qualora il primo numero risulti occupato verrà automaticamente tentato il secondo e cos`ì via fino a quando un numero risulti libero oppure siano stati tentati tutti i numeri nell'elenco.

CUX> NUMBER 1234567|7654321 ( Specifica i numeri da chiamare ) CUX> DIAL ( Chiama uno tra i numeri indicati ) ..........

All'interno del numero si possono inserire anche i seguenti caratteri:

P T W R N @ !

i quali assumono dei significati particolari a seconda del modem impiegato (a questo riguardo occorre consultare il manuale del modem da voi utilizzato); solitamente sono standard solo i caratteri `T' (tone) e `P' (pulse) che indicano rispettivamente la composizione del numero a toni e ad impulsi. Un tipico uso di questi due caratteri è quando si utilizzano dei centralini interni che effettuano la comunicazione a toni mentre la rete telefonica esterna è a impulsi. Si può, quindi, ovviare a questo problema operando come nell'esempio che segue:

.......... CUX> NUMBER T13/P1234567 ( Specifica il numero da chiamare ) CUX> DIAL ( Chiama il numero scelto ) ..........

Nell'esempio viene prima composto il numero 13 del centralino a toni, quindi viene effettuata una pausa, e infine il resto del numero viene composto ad impulsi.

NUMREG

Imposta il numero di registri del modem. Per default il numero di registri è 12 (che è anche il minimo per i modem Hayes e compatibili), mentre il massimo è 255 e dipende dal tipo di modem utilizzato.

CUX> NUMREG 256 ( Specifica il numero di registri ) Numero di registri non accettabile CUX> NUMREG 255 ( Specifica il numero di registri ) ..........

REG

Il comando `REG' permette di visualizzare su video il contenuto dei registri del modem utilizzato.

CUX> REG ( Mostra il contenuto dei registri ) Registro 0 = 0. Registro 1 = 0. Registro 2 = 43. Registro 3 = 13. Registro 4 = 10. Registro 5 = 8. Registro 6 = 3. Registro 7 = 50. Registro 8 = 2. Registro 9 = 0. Registro 10 = 50. Registro 11 = 70. CUX>

Per il significato dei registri standard consultate l'appendice Il file Modmcap e il manuale del vostro modem.

RESET

Inizializza il modem utilizzato; questo comando vi segnalerà l'errore se il tipo di modem che voi utilizzate è diverso da quello inizializzato con il comando `INIT' o da quello contenuto dalla variabile di environment `MODM' (a tale proposito si veda anche la capability modmcap `Re').

CUX> INIT HAYES ( Carica i parametri del modem scelto ) CUX> RESET ( Inizializza il modem ) Comando non accettato dal modem. CUX> INIT HAYES_COMP ( Carica i parametri del modem scelto ) CUX> RESET ( Inizializza il modem scelto ) Modem inizializzato.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

RESETDATA

Inizializza il modem utilizzato in modalità dati (a tale proposito si veda anche la capability modmcap `Td'.

CUX> INIT HAYES_VOICE ( Carica i parametri del modem scelto ) CUX> RESETDATA ( Inizializza il modem scelto ) Modem inizializzato.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

RING

Definisce il numero di squilli (minimo uno) da attendere prima di rispondere ad una chiamata.

CUX> RING 0 ( Definisce il numero di squilli ) Numero di squilli non accettabile. CUX> RING 1 ( Definisce il numero di squilli ) CUX> ANSWER ( Entra in autoanswer ) .......... CUX> COMMAND ( Ritorna in modalità comandi ) CUX> NOANSWER ( Esce dall'autoanswer )

4.6 Conversazionale

AUTOLF

Attiva o disattiva il linefeed automatico. Questo comando è utile quando l'host o il programma a cui si è collegati in interattivo ad ogni pressione del tasto <ENTER> rimanda l'eco di un carriage return riportando il cursore sempre all'inizio della riga. Specificando il comando `AUTOLF ON' il cursore sarà posizionato all'inizio della riga successiva. È possibile specificare il linefeed automatico sulla linea comando, utilizzando l'opzione `-lf' (Vedere il capitolo Opzioni sulla linea di comando).

CUX> AUTOLF OFF ( Disabilita il linefeed automatico ) ..........

BOTTON

Abilita (ON) o disabilita (OFF) la visibilità dei bottoni di default abilitata.

Comando disponibile solo per le versioni per ambienti grafici.

CONV

Entra in modalità conversazionale. Questo significa che, a seconda delle inizializzazioni operate prima di questo comando, ci si potrà collegare, via modem o via seriale diretta, con un altro programma o con un host. Se ci si collega con un host il programma si comporterà come un terminale remoto; mentre se ci si collega con un altro programma si potrà comunicare con un altro utente. In questo caso, in generale, vedrete apparire sul video ciò che l'altro utente sta scrivendo e non quello che scriverete voi. Questo comando richiama le funzionalità delle opzioni `-cd' e `-ca' descritte nel capitolo Opzioni sulla linea di comando. Durante la modalità conversazionale è possibile utilizzare i seguenti tasti con il seguente significato:

F1 Uscita dal conversazionale. F9 Disattivazione autosave. F10 Attivazione autosave. CTRL-L Refresh video (solo per `REMOTE' in MsDos).

I tasti sopra citati sono quelli di default, ma possono venire modificati cambiandoli opportunamente nel file `modmcap' (cfr. a proposito nell'appendice Il file Modmcap il paragrafo Capability Cux).

È anche possibile salvare tutto ciò che voi eseguite mentre operate in conversazionale utilizzando i comandi `FILE' e `SAVE'.

Il comando `CONV' può essere opzionalmente seguito da una stringa di caratteri (per la sintassi cfr. il comando `STRING'), ed in tal caso la ricezione di tale stringa dalla linea di comunicazione determina l'uscita automatica dal conversazionale.

CUX> PARITY NONE ( Specifica il tipo di parità ) CUX> BIT 8 ( Definisce il numero di bit ) CUX> BAUD 9600 ( Definisce il baud-rate ) CUX> PORT tty1a ( Specifica la porta utilizzabile ) CUX> FILE conver.txt ( Specifica il file di default ) CUX> SAVE ON ( Entra in autosave ) CUX> MODEMCTL ON ( Abilita il controllo della portante ) CUX> CONV "fine" ( Entra in conversazionale, dal quale ) .......... ( esce alla ricezione della stringa ) .......... ( 'fine' ) ..........

Il comando ritorna impostando la variabile predefinita `WHICH' ad uno dei due valori 1 o 0 a seconda che l'uscita dal conversazionale sia stata determinata rispettivamente dalla ricezione della stringa specificata o per mezzo del tasto di uscita dal conversazionale.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore solo se il comando `MODEMCTL' viene posto a `ON', indicando in tal caso la caduta della portante (cfr. i comandi `IFER' e `IFNOER').

CRLF

Questo comando viene usato da tutti i protocolli ad eccezione di Cuxbin e Cuxenc ed è utile per il trasferimento di file tra ambienti diversi. Il comando `CRLF' ha un comportamento differente a seconda del sistema operativo utilizzato. In MsDos attiva o disattiva (default) la conversione `CR-LF' in `LF' in trasmissione e `LF' in `CR-LF' in ricezione; mentre in Unix/Xenix esegue il procedimento inverso.

.......... CUX> CRLF ON ( Attiva la conversione CR-LF ) CUX> SEND ( Spedisce il file di default ) .......... CUX> CRLF OFF ( Disattiva la conversione CR-LF ) ..........

DYNATERM

Tale comando, disponibile solo in ambiente MsDos, permette di chiamare l'emulatore di terminale Dynaterm in modo automatico. È possibile specificare dei parametri, i quali devono essere dati nella sintassi prevista dal programma Dynaterm. In ogni caso vengono passati per default all'emulatore i seguenti parametri: -m -q5 -l -b -d -s -p -z [-u] [-x] [-C] [-E] [-L] [-N] [-P] [-U] -k -g [-j] -o. Alla fine dell'esecuzione dell'emulatore la variabile predefinita `RETURN' conterrà il codice di uscita.

CUX> DYNATERM ( Invoca l'emulatore ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

DUPLEX

Attiva l'half o il full duplex e ammette come parametro una delle due stringhe `HALF' o `FULL'. Se si specifica il comando `DUPLEX HALF' si abilita automaticamente l'eco locale (cfr. comando `ECHO') mentre non è vero il viceversa.

CUX> DUPLEX HALF ( Attiva l'half-duplex ) .......... CUX> DUPLEX FULL ( Attiva il full-duplex ) CUX> ECHO OFF ( Disattiva l'eco locale )

ECHO

Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' attiva l'eco dei caratteri digitati a video, mentre se impostato a `OFF' l'eco dei caratteri digitati è disattivato. L'attivazione di questo comando è utile quando l'host o il programma a cui si è collegati non effettua l'eco dei caratteri battuti in interattivo, e normalmente questo avviene quando si è in half-duplex.

CUX> ECHO ON ( Attiva l'eco dei caratteri ) .......... CUX> ECHO OFF ( Disattiva l'eco dei caratteri )

A partire dalla versione 3.8b l'abilitazione dell'eco locale ha un effetto collaterale sul comando `RSTRING' (cfr.), nel senso che, qualora venga abilitato (`ECHO'=`on'), ogni carattere ricevuto dalla linea di comunicazione per mezzo dell'istruzione `RSTRING' viene scritto sulla linea stessa.

LOADBTN

Carica nuovi bottoni indicando, come unico parametro, il file di descrizione, per esempio:

CUX> LOADBTN modem ( carica un ste di bottoni )

Il comando cercherà il file indicato nella directory corrente e nella directory ETC

Comando disponibile solo per le versioni per ambienti grafici.

PRINT

Se attivato questo comando stampa tutte le operazioni eseguite durante il conversazionale. In ambiente MsDos questa stampa viene eseguita in tempo reale, mentre in ambiente Unix/Xenix viene eseguita solo dopo aver digitato il comando `PRINT OFF' inviando i dati allo spooler di sistema. Nel caso in cui si esca da Cux ciò verrà eseguito automaticamente.

CUX> PARITY NONE ( Specifica il tipo di parità ) CUX> BIT 8 ( Definisce le dimensioni del dato ) CUX> BAUD 9600 ( Specifica il baud-rate ) CUX> PORT tty1a ( Definisce la porta da utilizzare ) CUX> PRINT ON ( Attiva la stampa delle operazioni ) CUX> CONV ( Entra in conversazionale ) .......... CUX> PRINT OFF ( Disattiva la stampa )

RESIZE

Ridimensiona la finestra e necessita come parametri obbligatori il numero di colonne e il numero di righe.

.......... CUX> RESIZE 40 25 ( Dimezza la larghezza della finestra ) .......... CUX> RESIZE 80 25 ( Finestra di dimensioni standard )

Comando disponibile solo per le versioni per ambienti grafici.

SAVE

Permette, se attivato, di salvare tutte le operazioni eseguite durante il conversazionale e tutti i dati ricevuti dalla linea di comunicazione tramite i comandi `RSTRING' e `XRSTRING'.

.......... CUX> FILE prova.txt ( Definisce il file di default ) CUX> SAVE ON ( Attiva l'autosave ) CUX> CONV ( Entra in conversazionale ) .......... CUX> SAVE OFF ( Disattiva l'autosave )

STDOUT

Se attivato, questo comando permette di ottenere un output trasparente su standard output. Questo significa che eventuali sequenze di escape vengono interpretate dal terminale e non da Cux come avviene quando questa opzione viene disattivata (`STDOUT OFF').

.......... CUX> STDOUT ON ( Attiva l'output trasparente ) CUX> CONV ( Entra in conversazionale ) .......... CUX> STDOUT OFF ( Disattiva l'output trasparente )

In ambienti Unix/Xenix premendo i tasti di funzione vengono restituite le stringhe di escape previste per quel terminale, mentre in MsDos vengono restituite, in modo fisso, le seguenti:

F1 <ESC>[M S_F1 <ESC>[Y BS <BACKSPACE> F2 <ESC>[N S_F2 <ESC>[: LEFT <ESC>[D F3 <ESC>[O S_F3 <ESC>[a RIGHT <ESC>[C F4 <ESC>[P S_F4 <ESC>[b INS <ESC>[L F5 <ESC>[Q S_F5 <ESC>[c DEL <RUBOUT> F6 <ESC>[R S_F6 <ESC>[d HOME <ESC>[H F7 <ESC>[S S_F7 <ESC>[e END <ESC>[F F8 <ESC>[T S_F8 <ESC>[f PGUP <ESC>[I F9 <ESC>[U S_F9 <ESC>[g PGDN <ESC>[G F10 <ESC>[V S_F10 <ESC>[h UP <ESC>[A F11 <ESC>[W S_F11 <ESC>[i DOWN <ESC>[B F12 <ESC>[X S_F12 <ESC>[j C_LEFT <ESC>[W C_F1 <ESC>[k A_F1 <ESC>[` C_RIGHT <ESC>[X C_F2 <ESC>[l A_F2 <ESC>[~ C_HOME <ESC>[u C_F3 <ESC>[m A_F3 <ESC>[% C_END <ESC>[v C_F4 <ESC>[n A_F4 <ESC>[( C_PGUP <ESC>[i C_F5 <ESC>[o A_F5 <ESC>[# C_PGDN <ESC>[j C_F6 <ESC>[p A_F6 <ESC>[$ A_1 <ESC>[x C_F7 <ESC>[q A_F7 <ESC>[; A_2 <ESC>[y C_F8 <ESC>[r A_F8 <ESC>[. A_3 <ESC>[z C_F9 <ESC>[s A_F9 <ESC>[+ A_4 <ESC>[@ C_F10 <ESC>[t A_F10 <ESC>[* A_5 <ESC>[[ C_F11 <ESC>[u A_F11 <ESC>[) A_6 <ESC>[\ C_F12 <ESC>[v A_F12 <ESC>[} A_7 <ESC>[] S_TAB <ESC>[Z A_8 <ESC>[^ A_MINUS <ESC>[` A_9 <ESC>[_ A_PLUS <ESC>[{ A_0 <ESC>[w

TAB

Comando per settare di quanti spazzi a destra deve spostarsi il cursore alla ricezione del carattere `TAB' che di default sono 8.

4.7 Protocolli

CPJ

Comando per ricezione e trasmissione ordini e mancanti con protocollo proprietario. Ha come parametri obbligatori il file da inviare e il file da ricevere e come opzionali:

NCDATA

nessun controllo sull'ultimo campo del record dati;

NCEND

nessun controllo sul record finale;

NCOFF

nessun controllo sulle offerte;

NCHEAD

nessun controllo sull'header;

NCRIS

nessun controllo sui record di risposta;

NCCODE

nessun controllo sui codici farmaceutici;

NCSEQ

nessun controllo sulla sequenza logica dei record;

NCUUU

conferma la disponibilità.

Se si vuole ricevere le AAAAA in testa conviene usera un `RSTRING' con opportuno timeout prima del comando `CPJ'.

Il comando da la possibilità di effettuare un controllo sulla riuscita della trasmissione modificando il valore della variabile `WHICH':

0 non è stato spedito l'ordine; 1 non è arrivato il mancante; 2 le transazioni sono andate a buon fine; 3 la richiesta di disponibilità non è stata terminata, ma il file è stato ricevuto.

Col comando `DELTRANS' si stabilisce il delay tra un record e l'altro nella fase di invio dell'ordine.

Abbinandolo al comando `CMDSAVE' si può salvare l'intero transito della linea nell'usuale file .SAV se il log è abilitato è consigliato disabilitare protocollo xon/xoff.

Attenzione: setta il flag di errore (cfr. i comandi `IFER' e `IFNOER').

N.B.: il comando è disponibile solo su specifica richiesta.

CPJREC

Comando per la ricezione ordini con protocollo proprietario. Ha come parametro obbligatorio il file da ricevere e come opzionali gli stessi del comando `CPJ' con in più:

NCACK

evita un ACK di troppo a conferma del record di chiusura;

NCCLEAN

ripulirsce la linea fino al primo CRLF o 4 secondi di attesa;

NCDUP

elimina i record doppi consecutivi.

Se si vuole inviare le AAAAA in testa conviene usare un `STRING'.

Nella variabile `WORD' è presente il record di testa dal quale è possibile ricavarne i dati del chiamante.

Attenzione: setta il flag di errore (cfr. i comandi `IFER' e `IFNOER').

N.B.: il comando è disponibile solo su specifica richiesta.

CPJSEND

Comando per l'invio mancanti con protocollo proprietario. Ha come parametro obbligatorio il file da inviare e come opzionali gli stessi del comando `CPJ' con in più:

NCSKIP

se il file non contiene la prima riga in quanto uguale a quella del comando `CPJREC';

PDELAY=nn

delay tra le stringhe fittizie in attesa di mancante (default 20).

Il comando modifica il valore della variabile `WHICH' che se vale:

1 richiesta di disponibilità affermativa.

Nella variabile `WORD' deve essere messa la stringa da inviare per esempio `900'.

Attenzione: setta il flag di errore (cfr. i comandi `IFER' e `IFNOER').

N.B.: il comando è disponibile solo su specifica richiesta.

CTRLX

Nel caso di file-transfer con uno tra i protocolli Xmodem o Ymodem tale comando permette di definire il numero di <CTRL><X> necessari per interrompere il protocollo; questo valore è usato internamente in quanto nell'uso di Cux il carattere di `ABORT' è comunque il <DEL>, che per default produrrà un numero di 3 <CTRL><X> inviati sulla linea.

CUX> CTRLX 3 ( Specifica il numero di ctrl-x ) .........

DELTRANS

Il comando `DELTRANS' permette di specificare il ritardo in tick di sistema tra un carattere e l'altro trasmessi sulla linea dal comando `TRANSMIT' nello stato di `TRANSPARENT ON'. Valori accettabili vanno da 0 a 255 (Vedere la variabile `HZ' nell'appendice L'environment); l'unità di misura è il diciottesimo di secondo. Nello stato di `TRANSPARENT OFF' il valore specificato viene invece utilizzato come ritardo interlinea.

CUX> DELTRANS 2 ( Specifica il ritardo ) ..........

Attenzione: a partire dalla versione 3.8b il comando `DELTRANS' è stato modificato, nel senso di esprimere un ritardo non più tra due successivi caratteri ma tra due successivi blocchi di caratteri, dove il blocco è determinato dal comando `LENREK'.

LENREK

Il comando `LENREK' permette di definire la lunghezza del record durante le fasi di trasmissione dei file. La lunghezza in questione corrisponde al numero di byte da trasferire in ogni blocco e per default è definito a 128, mentre i valori selezionabili variano da 32 a 8192. Nel caso di utilizzo di pseudo-tty si consiglia di impostare le dimensioni del record a 128 byte, mentre nel caso di utilizzo di socket le dimensioni consigliate sono di 8192 byte.

Attenzione: il protocollo Kermit non può utilizzare record di lunghezza superiore a 91 byte. Qualunque valore maggiore di 91 assegnato al record viene riportato comunque al valore massimo accettabile.

Attenzione: i seguenti protocolli forzano la lunghezza del record a 1024 byte:

XMODEM1K

Protocollo Xmodem con blocco di 1024 byte.

YMODEM1K

Protocollo Ymodem con blocco di 1024 byte.

XMODEM1KC

Protocollo Xmodem con blocco di 1024 byte e controllo CRC.

YMODEM1KC

Protocollo Ymodem con blocco di 1024 byte e controllo CRC.

       CUX> PROTOC CUXENC             ( Specifica il tipo di protocollo  )
       CUX> LENREK 512                ( Definisce lunghezza record       )
       CUX> MAXBUF 1024               ( Definisce dimensioni del buffer  )
       CUX> DIAL 555,5555             ( Chiama il numero scelto          )
       CUX> SEND prova.bin            ( Spedisce il file scelto          )
       CUX> MAXBUF 2048               ( Definisce dimensioni del buffer  )
       CUX> PROTOC XMODEM1KC          ( Specifica il tipo di protocollo  )
       ..........
       CUX> COMMAND                   ( Ritorna in modalità comandi      )

Attenzione: sino alla versione 3.8b la lunghezza massima del record era di 1024 byte.

LOWERNAME

Tale comando permette di minuscolizzare i path dei nomi di file in fase di ricezione.

CUX> LOWERNAME ( Minuscolizza i pathname ) CUX> XREC /usr/tmp/ ( Riceve i file ) ..........

MAX_K

Imposta il massimo valore in Kbyte di file trasmissibili per ogni singolo comando `XSEND' o ricevibili per ogni singolo comando `XREC' ma solo su protocolli Cux. Per default vale 0, ad indicare che non esistono limiti.

CUX> PROTOC CUXENC ( Imposta il protocollo per file transfer ) CUX> MAX_K 50 ( Imposta il massimo valore in 50 Kbyte ) CUX> XSEND /usr/tmp/ ( Trasmette i file ) ..........

NEWCUX

Ammette come parametro uno dei due valori `ON' e `OFF'. Se impostato a `OFF' forza Cux ad usare protocolli compatibili con le versioni precedenti alla 3.8, mentre se impostato a `ON' permette di utilizzare il nuovo metodo di codifica dei dati.

A partire dalla versione 3.8, infatti, Cux garantisce che in caso di file transfer il valore di ogni byte di controllo di un pacchetto abbia un valore diverso da ogni possibile valore assunto dai byte delimitatori del pacchetto stesso. Questa caratteristica elimina la possibilità, per quanto remota, di conflitti a livello di trasporto dovuti alla impredicibilità intrinseca dei valori che assumeranno alcuni particolari byte di controllo.

Di conseguenza, per garantire la compatibilità con le versioni precedenti di Cux è indispensabile impostare a `OFF' tale opzione la quale indica di non utilizzare questa nuova feature.

CUX> NEWCUX OFF ( Forza la compatibilità sui file ) ( transfer con le versioni precedenti ) ..........

La funzionalità di questo comando è del tutto analoga a quella dell'opzione `-EC' (cfr.).

Attenzione però che tale comando assume significato solamente in relazione ai protocolli Cux.

NIBBLE

Abilita o disabilita (default) la trasmissione di file binari con protocolli Xmodem e Ymodem spezzando ogni byte in due parti (che vengono chiamate appunto nibble); l'uso di questo meccanismo implica il raddoppio del tempo di trasmissione.

CUX> PROTOC XMODEM ( Specifica il tipo di protocollo ) CUX> NIBBLE ON ( Abilita trasmissione binari ) CUX> SEND pippo.exe ( Trasmette il file scelto ) .......... CUX> NIBBLE OFF ( Disabilita trasmissione binari ) CUX> SEND pippo.txt ( Trasmette il file scelto )

Attenzione: l'uso di tale comando ha significato solo per file transfer con protocolli Xmodem e Ymodem.

OOB

Questo comando assume significato solo su linee Tcp/Ip e permette di inviare il carattere indicato come parametro come dato out-of-band. Valori accettabili per il carattere vanno da 0 a 255.

CUX> OOB 32 ( Invia come out-of-band uno spazio ) ..........

PADCHAR

Imposta il carattere di padding e può essere un qualunque valore della tavola ASCII compreso tra 0 e 127 inclusi. Per default assume valore 0. L'uso di un carattere di padding e la possibilità di definire tale carattere in modo parametrico è impiegata dal protocollo Kermit nella fase iniziale di contrattazione (cfr. la sezione Controllo delle operazioni relativa al protocollo Kermit nell'appendice Protocolli).

CUX> PADCHAR 32 ( Imposta come carattere di padding lo spazio ) ..........

PADNUM

Imposta il numero di caratteri di padding e può essere un qualsiasi numero compreso tra 0 e 999 inclusi. Per default assume valore 0. Anche tale comando, come già il comando `PADCHAR' (cfr.), trova impiego con il protocollo Kermit, il quale prevede la possibilità di definire parametricamente nella fase di contrattazione iniziale il numero dei caratteri di padding (cfr. la sezione Controllo delle operazioni relativa al protocollo Kermit nell'appendice Protocolli).

CUX> PADNUM 16 ( Imposta il numero di caratteri di padding ) ..........

PATH

Abilita o disabilita la trasmissione del path completo dei file trasferiti con uno tra i protocolli Ymodem, Zmodem e Kermit; se abilitata sulla macchina ricevente verrano create le directory opportune. Per default la trasmissione del path è disabilitata.

CUX> PROTOC YMODEM ( Specifica il tipo di protocollo ) CUX> PATH ON ( Abilita trasmissione del path ) CUX> SEND /u/utente/pippo.txt ( Trasmette il file scelto ) CUX> PATH OFF ( Disabilita trasmissione del path )

PKDELAY

Aggiunge un ritardo espresso in millisecondi al termine della trasmissione di un singolo pacchetto di una window al fine di evitare una collisione tra pacchetti quando si utilizzano protocolli finestrati (cfr. il comando `WINDOW'). Il ritardo desiderato deve essere indicato come parametro e può essere un qualsiasi valore numerico compreso tra 0 (default) e 128 inclusi.

CUX> WINDOW 128 ( Numero di pacchetti per window ) CUX> PKDELAY 1 ( Imposta il ritardo tra pacchetti )

PROTOC

Definisce il tipo di protocollo. Valori accettabili sono i seguenti:

CUXTXT

Protocollo Cuxtxt (default).

CUXBIN

Protocollo Cuxbin.

CUXENC

Protocollo Cuxenc.

XMODEM

Protocollo Xmodem.

XMODEMC

Protocollo Xmodem con controllo CRC.

XMODEM1K

Protocollo Xmodem con blocco di 1024 byte.

XMODEM1KC

Protocollo Xmodem con blocco di 1024 byte e controllo CRC.

YMODEM

Protocollo Ymodem.

YMODEM1K

Protocollo Ymodem con blocco di 1024 byte.

YMODEMC

Protocollo Ymodem con controllo del CRC.

YMODEM1KC

Protocollo Ymodem con blocco di 1024 byte e controllo CRC.

ZMODEM

Protocollo Zmodem.

KERMIT

Protocollo Kermit.

XON

Protocollo di handshake Xon/Xoff abilitato.

XOFF

Protocollo di handshake Xon/Xoff disabilitato.

       CUX> PROTOC XON               ( Specifica il tipo di protocollo   )
       CUX> CONV                     ( Entra in conversazionale          )
       ..........
       CUX> PROTOC XOFF              ( Disabilita il protocollo Xon      )
       ..........

Se viene abilitato il protocollo di handshake Xon/Xoff per mezzo del comando

CUX> PROTOC XON

allora viene automaticamente disabilitato qualsiasi altro protocollo per file-transfer eventualmente abilitato in precedenza. Attenzione però che in tal caso eventuali operazioni di `REC', `SEND', `XREC' e `XSEND' vengono effettuate automaticamente con protocollo Cuxenc.

Se invece il protocollo di handshake Xon/Xoff viene disabilitato per mezzo del comando

CUX> PROTOC XOFF

allora viene automaticamente impostato il protocollo di file-transfer al valore di default Cuxtxt.

L'utilizzo del protocollo di handshake Xon/Xoff è raccomandato qualora si voglia utilizzare Cux come emulatore di terminale, poiché la selezione di altri tipi di protocolli quasi sicuramente produrrebbe perdita di caratteri sulla linea di comunicazione.

Se nella trasmissione di file viene utilizzato uno dei protocolli Cux (Cuxtxt, Cuxbin o Cuxenc) è del tutto indifferente per il ricevitore quale protocollo utilizzare, purché faccia parte di uno dei tre protocolli appena citati.

Inoltre il protocollo Zmodem riconosce e si adegua ai protocolli Ymodem e Xmodem, mentre il protocollo Ymodem riconosce e si adegua al protocollo Xmodem. È quindi possibile per il trasmettitore specificare ad esempio il protocollo Xmodem e per il ricevitore specificare uno tra i protocolli Zmodem o Ymodem: in tal caso il ricevitore si adeguerà automaticamente al protocollo Xmodem scelto dal trasmettitore. Un discorso del tutto analogo vale nel caso in cui il trasmettitore specifichi il protocollo Ymodem e il ricevitore il protocollo Zmodem: in tal caso il ricevitore si adeguerà automaticamente al protocollo Ymodem scelto dal trasmettitore.

Infine, se si utilizzano altre combinazioni di protocolli deve esserci invece una completa concordanza tra il protocollo utilizzato dal trasmettitore e quello utilizzato dal ricevitore (Vedere i comandi `REC', `XREC', `SEND' e `XSEND').

REC

Questo comando permette di ricevere un file; è possibile specificare il nome del file da assegnare al file ricevuto definendolo come parametro oppure utilizzando il nome specificato dal comando `FILE'. È anche possibile assegnare come nome un path completo, purché tutte le directory specificate esistano.

CUX> PROTOC XMODEM ( Specifica il tipo di protocollo ) CUX> REC /usr/pippo.txt ( Riceve il file scelto )

Il file-transfer può essere interrotto dalla ricezione di un segnale opportunamente intercettato (cfr. comando `TRAP'), ma solo se viene utilizzato uno dei protocolli Cux.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

REPEAT

Il comando `REPEAT' permette di definire il numero di ripetizioni, in caso di errore, del trasferimento di un blocco di dati. Nel caso in cui l'errore persista per tutte le ripetizioni definite, la trasmissione viene interrotta e viene segnalato l'errore.

CUX> REPEAT 3 ( Definisce il numero ripetizioni ) CUX> PROTOC CUXENC ( Specifica il tipo di protocollo ) CUX> SEND pippo.txt ( Trasmette il file scelto ) Errore di trasmissione CUX>

Attenzione: a partire dalla release 3.8 tale comando influisce anche sulla sincronizzazione, vale a dire sul timeout di aggancio iniziale, dei protocolli Cux. In altri termini influisce sul tempo in cui ad esempio un comando `XREC' attende l'inizio di una ricezione di file prima di uscire con errore (a tale proposito si veda anche la capability `Rt' nel capitolo dedicato a Il file modmcap).

SEND

Questo comando permette di trasmettere un file scelto. È possibile specificare il nome del file da trasmettere definendolo come parametro oppure utilizzando il nome specificato dal comando `FILE'. È anche possibile assegnare come nome un path completo purché tutte le directory (e il file) esistano.

CUX> PORT COM1 ( Imposta la porta ) CUX> BAUD 19200 ( Specifica il baud rate ) CUX> BIT 8 ( Dimensioni della word ) CUX> PARITY NONE ( Definisce il tipo di parità ) CUX> PROTOC CUXENC ( Specifica il tipo di protocollo ) CUX> SEND prova.exe ( Trasmette il file ) ..........

Il file-transfer può essere interrotto dalla ricezione di un segnale opportunamente intercettato (cfr. comando `TRAP'), ma solo se viene utilizzato uno dei protocolli Cux.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

STAR

Seguito da un'arbitraria stringa di caratteri, permette di selezionare il messaggio da visualizzare in caso di file transfer. Normalmente Cux visualizza durante un file transfer una serie di caratteri `*' proporzionale al numero di pacchetti di dati inviati o ricevuti. La visualizzazione di tali asterischi è comunque disattivata se l'eco dei comandi a video è stato inibito (cfr. comando `MUTE'). La stringa selezionata tramite il comando `STAR' verrà invece visualizzata anche se l'eco dei comandi a video è stato disabilitato e sostituisce gli usuali `*'. Il comando senza alcun parametro riporta alla situazione di default con la visualizzazione degli asterischi.

CUX> MUTE ON ( Disabilita l'eco dei comandi ) CUX> STAR File-transfer... ( Seleziona la stringa ) CUX> XREC . ( Riceve i file ) File-transfer... CUX>

La funzionalità di questo comando è del tutto analoga a quella dell'opzione `-TS' (cfr.).

TRANSMIT

Il comando `TRANSMIT' permette di inviare un file ASCII sulla linea di comunicazione; si presuppone che a ricevere il file vi sia un programma in attesa del file trasmesso (se sulla linea di comunicazione vi è un Cux in conversazionale vedrete scorrere il file sullo schermo). È possibile specificare il nome del file da trasmettere definendolo come parametro oppure utilizzando il nome specificato dal comando `FILE'. Il funzionamento di tale comando dipende anche dai comandi `TRANSPARENT' e `DELTRANS'.

A partire dalla versione 4.0 tale comando è stato modificato in modo da visualizzare una stringa di caratteri che permetta di tracciare l'avanzamento del trasferimento dei dati (cfr. comando `STAR').

CUX> PARITY NONE ( Specifica il tipo di parità ) CUX> BIT 8 ( Definisce le dimensioni del dato ) CUX> PROTOC XON ( Specifica il tipo di protocollo ) CUX> FILE prova.txt ( Specifica il file di default ) CUX> TRANSMIT ( Trasferisce il file )

Per evitare perdite di caratteri e garantire un corretto funzionamento del comando si consiglia di impostare il protocollo di handshake Xon/Xoff (cfr. comando `PROTOC'). Occorre tuttavia prestare attenzione al fatto che il file da trasmettere contenga esclusivamente caratteri ASCII, dal momento che l'eventuale occorrenza del carattere di Xoff (in genere <CTRL><S>) determinerebbe il blocco del trasferimento in attesa di un successivo carattere di Xon (in genere <CTRL><Q>) che tuttavia non può arrivare (a questo proposito si veda però il comando `XOFF'). Se il file dovesse contenere anche caratteri non-ASCII si può utilizzare, se possibile, il protocollo di handshake hardware Cts/Rts. Attenzione: lo stato di uscita di questo comando e la mancanza del file da trasmettere influiscono sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

TRANSPARENT

Il comando `TRANSPARENT' permette di definire la modalità di trasmissione utilizzata dal comando `TRANSMIT'. Le modalità disponibili sono le seguenti:

Trasmissione a caratteri

Selezionabile digitando `TRANSPARENT ON'; utile quando a ricevere sia un programma che deve interpretare il file trasferito.

Trasmissione a righe

Selezionabile digitando `TRANSPARENT OFF' (default); utile quando a ricevere sia un programma che viene utilizzato solitamente con utenti interattivi (BBS o banche dati). In questa modalità ad ogni fine riga viene aggiunto un `CR'.

       CUX> BIT 8                   ( Definisce le dimensioni del dato   )
       CUX> PROTOC XON              ( Specifica il tipo di protocollo    )
       CUX> FILE prova.txt          ( Specifica il file di default       )
       CUX> TRANSPARENT ON          ( Attiva trasmissione a caratteri    )
       CUX> DELTRANS 3              ( Introduce un ritardo               )
       CUX> TRANSMIT                ( Trasferisce il file                )
       ...........

UNLINK

Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' forza Cux a cancellare in progressione i file spediti correttamente, mentre se impostato a `OFF' i file spediti correttamente non vengono rimossi. L'attivazione della rimozione automatica si ottiene facendo seguire a `UNLINK' il parametro `ON', mentre la disabilitazione della rimozione automatica si ottiene facendo seguire il parametro `OFF'.

CUX> UNLINK ON ( Forza Cux a rimuovere i file ) CUX> XSEND . ( spediti correttamente ) ..........

La funzionalità di questo comando è del tutto analoga a quella dell'opzione `-rm' (cfr.).

UPPERNAME

Tale comando permette di maiuscolizzare i path dei nomi di file in fase di ricezione.

CUX> UPPERNAME ( Maiuscolizza i pathname ) CUX> XREC /usr/tmp/ ( Riceve i file ) ..........

WINDOW

Solitamente i protocolli Cux spediscono un singolo pacchetto di una lunghezza prefissata dal comando `LENREK', e per ognuno di essi attendono la risposta in relazione all'esito del trasferimento del pacchetto. Purtroppo questo meccanismo, su modem half-duplex molto veloci o su reti a commutazione di pacchetto, provoca delle attese che vanno ad influire sul tempo di trasmissione, mentre l'ideale sarebbe trasferire molti pacchetti ed avere una singola risposta sull'esito del trasferimento. È stato cos`ì introdotto il comando `WINDOW' che permette di specificare il numero di pacchetti (finestra) che si vogliono trasferire prima di ricevere la risposta. Il comando ha la sintassi:

window finestra

dove finestra deve essere un numero intero compreso tra 0 e 128 inclusi.

Ciò che rende maggiormente interessante il comando `WINDOW' è la sua interazione con il comando `LENREK': grazie infatti ad una corretta inizializzazione dei parametri associati ai due comandi è possibile ottenere transfer-rate decisamente migliori. Occorre tuttavia cercare, in maniera del tutto sperimentale, le giuste dimensioni della finestra con pacchetti più lunghi possibile.

Un altro comando che interagisce con il comando `WINDOW' è il comando `PKDELAY', il quale viene utilizzato per ridurre al minimo i rischi di collisione tra pacchetti, tipici quando si imposta una lunghezza di pacchetto troppo ampia rispetto ai limiti del sistema.

Nell'esempio che segue abbiamo voluto indicare dei valori tipici qualora si utilizzino dei modem con velocità superiori a 9600 baud:

CUX> WINDOW 32 ( Numero di pacchetti per window ) CUX> LENREK 256 ( Lunghezza di un singolo pacchetto ) CUX> PKDELAY 0 ( Ritardo in ms tra pacchetti ) ...........

Attenzione: fino alla release 3.7 di Cux, nel caso di trasmissione monofile sia il ricevitore che il trasmettitore devono aver definito la stessa dimensione della finestra, mentre nella trasmissione multifile è il trasmettitore a decidere le dimensioni e a comunicarle al ricevitore.
A partire invece dalla release 3.8 di Cux, sia nel caso della trasmissione monofile sia nel caso della trasmissione multifile è sempre il trasmettitore a decidere le dimensioni della finestra e a comunicarle al ricevitore.

Con il comando:

CUX> WINDOW 0 ( Numero di pacchetti per window )

si torna alla modalità di default di una risposta per ogni singolo pacchetto, disabilitando cioè la finestratura.

Occorre tuttavia sottolineare che non ogni protocollo permette la finestratura nel trasferimento dei pacchetti. Tra i protocolli implementati in Cux, oltre a quelli proprietari Cuxtxt, Cuxbin e Cuxenc, solamente il protocollo Zmodem offre questa possibilità (cfr. la sezione dedicata ai protocolli Cux e al protocollo Zmodem nell'appendice Protocolli). Di conseguenza solo per questi protocolli ha senso specificare una finestra diversa da zero.

Attenzione: questo comando è stato introdotto con la versione 3.7 di Cux e il suo utilizzo con versioni precedenti del programma provoca degli errori di trasmissione.

XREC

Riceve più file trasmessi tramite l'istruzione `XSEND'. Il comando `XREC' può essere opzionalemnte seguito da un parametro che indica la directory in cui porre i file ricevuti. Se non è specificato alcun parametro i file ricevuti verranno posti nella stessa directory dalla quale sono stati trasmessi. Eventuali directory inesistenti verranno opportunamente create.

.......... CUX> PROTOC YMODEM ( Specifica il tipo di protocollo ) CUX> XREC /usr/tmp ( Riceve i file nella directory /usr/tmp ) ..........

Il file-transfer può essere interrotto dalla ricezione di un segnale opportunamente intercettato (cfr. comando `TRAP'), ma solo se viene utilizzato uno dei protocolli Cux.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

XSEND

Permette di inviare più file; la selezione dei file può essere effettuata utilizzando uno o più pattern in cui sono ammessi anche i metacaratteri asterisco (`*') e punto interrogativo (`?').

CUX> PROTOC CUXENC ( Specifica il tipo di protocollo ) CUX> XSEND \usr\bin\*.exe ( Spedisce i file scelti )

Il file-transfer può essere interrotto dalla ricezione di un segnale opportunamente intercettato (cfr. comando `TRAP'), ma solo se viene utilizzato uno dei protocolli Cux.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

4.8 Comandi di sistema

BOOT

Questo comando, attivo solo in ambiente MsDos, permette di effettuare un boot a freddo della macchina.

CUX> BOOT ( Effettua un boot ) ..........

Attenzione: la caduta della portante durante l'esecuzione del comando `REMOTE' determina un boot della macchina, ma solo se è stato precedentemente impostato il controllo modem per mezzo del comando `MODEMCTL ON'.

CAT

Visualizza il file specificato come parametro. È possibile interrompere la visualizzazione del file per mezzo del tasto <DEL>.

CUX> CAT pippo.txt ( Visualizza il file pippo.txt ) ..........

Dalla versione 4.0 il comando può essere interrotto per mezzo del tasto <DEL> o dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

CD

Cambia la directory corrente a quella indicata come parametro. Se la directory non esiste oppure (in ambiente Unix/Xenix) esiste ma non si hanno i permessi opportuni per permetterne l'accesso viene impostato il flag di errore.

CUX> CD .. ( Cambia la directory corrente ) CUX>

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

CHROOT

Questo comando, attivo solo in ambiente Unix/Xenix, permette di cambiare la directory root. Se non si hanno i permessi opportuni per permettere l'operazione viene impostato il flag di errore.

CUX> CHROOT /tmp ( Imposta la nuova root directory a /tmp ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

CLS

Pulisce lo schermo.

CUX> CLS ( Pulisce lo schermo ) CUX>

CMP

Confronta due file, specificati come parametri, per determinare se sono uguali. Se i due file sono diversi viene impostato il flag di errore, altrimenti il flag di errore viene azzerato. Tramite questo comando possono essere confrontati sia file di testo sia file binari.

CUX> CMP pippo.txt pluto.txt ( Confronta il file pippo.txt ) .......... ( con il file pluto.txt. ) CUX> IFER GOTO DIFFERENTI ( Se sono diversi salta alla ) .......... ( etichetta DIFFERENTI. )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

COPY

Copia di file. Tale comando permette di copiare un file su un altro file o di copiare più file in una directory.

CUX> COPY file1 file2 ( Copia il file file1 in file2 ) .......... CUX> COPY f* /tmp ( Copia tutti i file che iniziano ) .......... ( con f nella directory /tmp)

Dalla versione 4.0 il comando può essere interrotto per mezzo del tasto <DEL> o dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

DIR

Elenca i file indicati come parametro. Se non è specificato alcun parametro elenca il contenuto della directory corrente.

CUX> DIR /etc ( Elenca la directory /etc ) .......... CUX> DIR /etc/h* ( Elenca i file che iniziano con h ) .......... ( nella directory /etc ) CUX> DIR ( Elenca la directory corrente ) ..........

DISPLAY

Tale comando, disponibile solo in ambiente MsDos, permette di abilitare o disabilitare il display locale con il comando `REMOTE'. Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' sulla macchina locale non viene visualizzato lo svolgimento della sessione remota, mentre se impostato a `OFF' lo svolgimento della sessione remota viene visualizzato.

Se impostato a `ON' viene forzato ad `ON' anche il comando `KEYBOARD'

CUX> DISPLAY ON ( Abilita il video remoto )

DRIVE

Questo comando, attivo solo in ambiente MsDos, permette di cambiare il drive corrente. Il nuovo drive da impostare deve essere passato come parametro e può essere opzionalmente seguito dal carattere `:'.

.......... CUX> DRIVE A: ( Imposta come drive corrente il drive A: ) CUX> PWD ( Visualizza la directory corrente ) A:\ CUX> DRIVE C ( Imposta come drive corrente il drive C: ) ..........

ERASE

Cancella il file indicato come parametro o, se nessun file viene specificato, cancella il file di default (cfr. comando `FILE'). È possibile utilizzare, nel nome del file, i metacaratteri asterisco (`*') e punto interrogativo (`?'), specificando in tal modo un pattern che può indicare un insieme di file.

CUX> SYSTEM ls ( Esegue il comando Unix 'ls' ) pluto.doc pippo.txt cux.txt CUX> ERASE ( Cancella il file di default ) CUX> SYSTEM ls ( Esegue il comando Unix 'ls' ) pluto.doc pippo.txt CUX> ERASE *.txt ( Cancella i file con estensione 'txt' ) CUX> SYSTEM ls ( Esegue il comando Unix 'ls' ) pluto.doc ..........

EXIST

Il seguente comando effettua un test sull'esistenza del file specificato come parametro.

È possibile utilizzare, nel nome del file, i metacaratteri asterisco (`*') e punto interrogativo (`?'), specificando in tal modo un pattern che può indicare un insieme di file.

È possibile inoltre specificare come parametro anche `.' o `..', col significato di controllare l'esistenza di almeno un file nella directory corrente o nella directory padre rispettivamente.

Se il file o i file indicati esistono il flag di errore viene azzerato, mentre se il file o i file indicati non esistono il flag di errore viene impostato.

CUX> EXIST pippo.txt ( Testa l'esistenza del file pippo.txt ) CUX> IFER GOTO NOFILE ( Se il file non esiste salta alla ) .......... ( etichetta NOFILE )

CUX> EXIST pippo.* ( Testa l'esistenza di un file di nome ) ( pippo con qualsiasi estensione. ) CUX> IFER GOTO NOFILE ( Se non esiste alcun file con tale nome ) .......... ( salta alla etichetta NOFILE. )

CUX> EXIST . ( Testa l'esistenza di almeno un file. ) CUX> IFER GOTO NOFILE ( Se non esiste nessun file salta alla ) .......... ( etichetta NOFILE. )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

FDIR

Elenca i file indicati come secondo parametro e mette l'output del comando nel file indicato come primo parametro. Se non è specificato alcun parametro elenca il contenuto della directory corrente.

CUX> FDIR /tmp/outfile /etc ( Elenca la directory /etc e mette ) .......... ( l'output nel file /tmp/outfile ) CUX> FDIR /tmp/outfile ( Elenca la directory corrente e ) .......... ( mette l'output in /tmp/outfile )

KEYBOARD

Tale comando, disponibile solo in ambiente MsDos, permette di abilitare o disabilitare la tastiera della macchina locale con il comando `REMOTE'. Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' la tastiera della macchina locale viene disabilitata, mentre se impostato a `OFF' la tastiera della macchina locale rimane abilitata.

Tale comando viene forzato ad `ON' se il comando `DISPLAY' è impostato ad `ON'.

CUX> KEYBOARD ON ( Abilita la tastiera rmeota ) ..........

ICONIFY

Il seguente comando, disponibile solo in ambienti grafici, permette di iconificare e deiconificare la finestra in cui è in esecuzione il programma. Se il programma è iconificato il comando lo deiconifica, altrimenti lo iconifica.

CUX> ICONIFY ( Iconifica il programma ) CUX> CALL FILE ( Esegue il batch indicato ) CUX> ICONIFY ( Deiconifica il programma )

KILL

Invia kill (segnali) ad un processo. Ha come primo parametro il tipo di kill che si vuole inviare (cfr. `TRAP') e come secondo il pid del processo (cfr. i comandi `PS' e `SETPGRP'). Comando non disponibile solo per l'ambiente MsDos.

I tipi di kill vanno distinti per sistemi operativi. Per gli ambienti Unix/Xenix sono disponibili:

ZERO (verifica l'esistenza del processo) KILL (termina il processo) ILL TRAP ABRT (o IOT) EMT BUS SEGV SYS PIPE TERM USR1 USR2

Per gli ambienti Windows95/98/NT sono possibili solo:

ZERO (verifica l'esistenza del processo) KILL (termina il processo)

Per esempio:

CUX> KILL KILL 100 ( Uccide il processo con pid 100 ) CUX> KILL ZERO 100 ( Test di esistenza sel processo 100 ) CUX> KILL TERM 100 ( Invia un TERM al processo 100 )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

MKDIR

Crea la directory passata come parametro. Se la directory esiste già oppure (in ambiente Unix/Xenix) non esiste ma non si hanno i permessi opportuni per permetterne la creazione, viene impostato il flag di errore.

CUX> MKDIR /usr/tmp/ ( Crea la directory /usr/tmp ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

MOVE

Sposta e/o ridenomina file.

CUX> MOVE file1 file2 ( Ridenomina il file file1 in file2 ) .......... CUX> MOVE f* /tmp ( Sposta tutti i file che iniziano ) .......... ( con f nella directory /tmp)

Dalla versione 4.0 il comando può essere interrotto per mezzo del tasto <DEL> o dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

PAGE

Visualizza file di testo a schermate di 20 righe seguite da una pausa. Per visualizzare la schermata successiva occorre battere il tasto <ENTER>. È possibile interrompere la visualizzazione del file per mezzo del tasto <DEL> seguito da <ENTER>.

CUX> PAGE help.txt ( Visualizza il file help.txt )

Dalla versione 4.0 il comando può essere interrotto per mezzo del tasto <DEL> o dalla ricezione di un segnale debitamente intercettato (cfr. comando `TRAP').

PASSWD

Il comando richiede due parametri, che rappresentano nell'ordine utente e password, e verifica la correttezza di tale coppia di stringhe con riferimento al file `cuxpwd', il quale ha lo stesso formato del file `/etc/passwd' di sistema. Il comando imposta la variabile `WORD' alla password crittografata, la quale viene generata anche se non esistente, e la variabile `FROM' a tutta la riga letta dal file `cuxpwd'.

Il file `cuxpwd' viene cercato nella directory indicata dalla variabile di environment `ETC'.

CUX> PASSWD demo demo123 ( Verifica che l'utente demo abbia ) .......... ( come passord la stringa demo123 ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

PS

Elenca i processi correntemente attivi. Se è specificato un paramentro questo viene preso come il nome di un file in cui scrivere l'output del comando. Comando non disponibile solo per l'ambiente MsDos.

CUX> PS /usr/tmp/proc ( Scrive l'elenco dei processi sul file ) .......... ( /usr/tmp/proc ) CUX> PS ( Scrive l'elenco dei processi a video ) ..........

PWD

Visualizza il path della directory corrente.

CUX> PWD ( Visualizza la directory corrente ) /usr/utente CUX> CD prove ( Cambia directory ) CUX> PWD ( Visualizza la directory corrente ) /usr/utente/prove

In ambiente MsDos è disponibile anche il comando `DRIVE' per spostarsi sui diversi drive disponibili, e il comando `PWD' visualizza anche il nome del drive.

CUX> DRIVE A: ( Imposta il drive corrente ad A: ) CUX> PWD ( Visualizza la directory corrente ) A:/ CUX> CD prove ( Cambia directory ) CUX> PWD ( Visualizza la directory corrente ) A:/prove

REMOTE

Comando per l'esecuzione remota di programmi interattivi. In sostanza, questo comando permette ad un utente che lavora su un'altra macchina di lavorare sulla vostra. È possibile eseguire un applicativo oppure concedere l'utilizzo in interattivo della vostra macchina e l'esecuzione continua finché non termina il processo oppure (ma solo in ambiente Unix/Xenix) finché non la interrompete premendo il tasto <DEL>. In questo modo chi è in ricezione si vedrà apparire il prompt della shell della vostra macchina.

Se il comando `REMOTE' non è seguito da alcun parametro viene eseguita la shell di default (`command.com' in MsDos o la shell indicata dalla variabile di environment `SHELL' in Unix/Xenix). Se invece è seguito da un parametro verrà eseguito il programma indicato dal parametro specificato.

In ambiente Unix/Xenix il comando da lanciare può essere opzionalmente preceduto dalla durata massima, espressa in minuti, dell'esecuzione del comando stesso.

CUX> BAUD 19200 ( Definisce il baud-rate ) CUX> PORT tty2g ( Specifica la porta ) CUX> REMOTE 20 sh ( Esegue una shell per 20 minuti ) .......... ( per l'utente remoto )

In questo esempio vi collegate con la porta `tty2g' e lanciate in esecuzione la shell di sistema per un tempo massimo di 20 minuti.

A differenza di altri prodotti, che permettono l'esecuzione remota solo tra due PC MsDos, Cux permette di operare in situazioni eterogenee in cui i sistemi comunicanti possono essere indifferenemente due PC MsDos, due host Unix/Xenix o un PC MsDos e un host Unix/Xenix. In tale situazione si è reso necessario ricorrere ad un trattamento uniforme del video e della tastiera, in modo da rendere trasparenti le differenze tra un PC e un terminale ai programmi che devono utilizzare l'esecuzione remota offerta da Cux. Da qui la decisione di trattare anche un PC come un terminale.

In ambiente MsDos, quindi, il comando da lanciare può essere opzionalmente preceduto dal tipo di terminale da emulare, purché racchiuso tra una coppia di apici semplici (`''). Se tale parametro viene omesso verrà impostata per default l'emulazione `ansico' (per l'elenco delle emulazioni possibili si veda il file `dynacap.xen' fornito col dischetto di installazione. Per maggiori spiegazioni consultare la parte Unix/Xenix dell'appendice Il file dynacap). Non è invece possibile specificare un tempo massimo per l'esecuzione remota.

CUX> REMOTE 'dynaco' command ( Esegue il command.com ) .......... ( con emulazione dynaco )

Sempre in ambiente MsDos occorre sottolineare l'esistenza di un meccanismo di refresh automatico a tempo del video, il cui intervallo può essere modificato tramite l'opzione `-TI' (cfr. il capitolo Opzioni). È inoltre disponibile un carattere, definito dalla capability `modmcap' `E4' e per default <CTRL><L>, per effettuare il refresh manuale.

Nel caso occorra utilizzare tasti non disponibili (si pensi ad esempio ad un terminale Hazeltine non dotato dei tasti funzione) sarà necessario comporre manualmente le sequenze di caratteri corrispondenti. Ad esempio nel caso di un'emulazione ansi, al tasto di funzione `F1' corrisponde la sequenza <ESC><O><P>. Saranno quindi da digitare in successione i tre caratteri visti, avendo l'accortezza di rispettare i tempi definiti dalla variabile di environment `DYNAESC' nel caso tale variabile sia definita (cfr. l'appendice L'environment).

Sempre in ambiente MsDos, l'esecuzione di tale comando determina la creazione nella directory indicata dalla variabile di environment `ETC' del file `cuxrem.adr' contenente gli indirizzi degli interrupt di tastiera, video e seriale, nonchè il nome della porta utilizzata. Tale file è indispensabile nel caso si voglia lanciare un Cux con l'opzione `-MY', tipicamente per effettuare del file-transfer utilizzando la stessa linea di comunicazione usata per stabilire la connessione tra due macchine (per maggiori spiegazioni sull'uso di tale opzione si veda il capitolo Il Cux come server remoto). Attenzione a non rimuovere e/o manomettere tale file, dal momento che una sua eventuale modifica, anche casuale, può compromettere l'uso corretto del programma, con conseguenze impredicibili.

Se il programma eseguito termina con un codice di errore diverso da zero l'istruzione `REMOTE' ritorna con il flag di errore impostato. Inoltre, al termine dell'esecuzione remota la variabile predefinita `RETURN' contiene il codice di uscita del comando remoto eseguito.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER'). Inoltre, ma solo in ambiente Unix/Xenix, lo stato di uscita del comando influisce anche sul valore del flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT').

Attenzione: in ambiente MsDos la caduta di portante durante l'esecuzione di tale comando e con il controllo di portante abilitato (cfr. comando `MODEMCTL') determina un reboot della macchina su cui è in esecuzione il comando `REMOTE'.

A partire dalla versione 4.0 è possibile utilizzare tale comando anche su linee Tcp/Ip.

RENAME

Ridenomina il file passato come primo parametro con il nome passato come secondo parametro. In ambiente Unix/Xenix se non si hanno i permessi opportuni per permettere l'operazione viene impostato il flag di errore.

CUX> RENAME file.txt pluto.txt ( Rinomina file.txt in pluto.txt )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

RMDIR

Rimuove la directory passata come parametro. Se la directory non esiste oppure (in ambiente Unix/Xenix) esiste ma non si hanno i permessi opportuni per permetterne la rimozione viene impostato il flag di errore.

CUX> RMDIR /usr/tmp ( Rimuove la directory /usr/tmp ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

RSYSTEM

Tale comando è del tutto equivalente al comando `SYSTEM' (cfr.) ad eccezione del fatto che su sistemi grafici ridirige l'input e l'output del programma nella finestra del programma stesso.

SETPGRP

Questo comando, non disponibile solo in ambiente MsDos, permette di eseguire un processo in modo asincrono (background) rispetto al Cux in esecuzione, ovvero senza che il Cux ne attenda la terminazione. Il processo lanciato viene posto in un suo proprio gruppo di processi e la variabile predefinita `PIDCHILD' contiene il pid (cfr. comando `PS') dell'ultimo processo eseguito per mezzo del comando `SETPGRP'.

Attenzione che non è possibile utilizzare metacaratteri o simboli di ridirezione dell'I/O o di pipe che non verrebbero interpretati ma passati direttamente al programma specificato !

CUX> SETPGRP script1 ( Esegue il comando indicato ) CUX> LET pid1 $PIDCHILE ( Ne salva il pid ) CUX> SETPGRP script2 ( Esegue il comando indicato ) CUX> LET pid2 $PIDCHILE ( Ne salva il pid ) ..........

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

SHELL

Esce momentaneamente dal programma e ritorna al sistema operativo. Per rientrare nel programma occorre digitare `exit'. È anche possibile digitare `!!' al posto di `SHELL'.

.......... CUX> SHELL ( Esce dal programma ) Battere 'exit' per rientrare nel programma. C:> dir .......... C:> exit 2 CUX> !! ( Esce dal programma ) Battere 'exit' per rientrare nel programma. ..........

Al rientro nel programma la variabile predefinita `RETURN' conterrà il codice di uscita del programma di sistema eseguito, che nell'esempio precedente è 2.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

SPAWN

Questo comando è simile al comando `REMOTE' con la differenza che il suo utilizzo è rivolto a programmi che non necessitano di un controllo interattivo. Un suo tipico uso è rappresentato dalla trasmissione di file con protocolli esterni. Richiede un parametro, ovvero il nome del comando da eseguire. In ambiente Unix/Xenix il nome del comando può essere opzionalmente preceduto da un timeout espresso in minuti, timeout oltre il quale il processo lanciato viene terminato forzatamente.

A partire dalla release 3.8 il comando `SPAWN' assume significato anche in ambiente MsDos, dove rende disponibile a programmi esterni la gestione della linea di comunicazione effettuata dal Cux. A tale scopo serve ricordare che sono supportate esclusivamente le chiamate standard dell'interrupt 14 del BIOS (initialize, write, read, getstatus). Per maggiori spiegazioni si rimanda ai manuali e al Technical reference dell'MsDos.

Qui di seguito viene riportato un esempio d'uso del comando `SPAWN' in ambiente Unix/Xenix. Tale esempio descrive l'utilizzo del protocollo Zmodem come protocollo esterno.

CUX> CONV ( Entra in conversazionale ) sz pippo.txt CUX> SPAWN 20 rz ( Esegue il comando rz ) ( con un timeout di 20 minuti ) rz ready. To begin transfer, type "sz file" to your modem program Incoming: pippo.txt 8704 4767120520 100644 Receveing pippo.txt BIN w CUX>

Al termine dell'esecuzione la variabile predefinita `RETURN' conterrà il codice di uscita del programma eseguito.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER'). Inoltre, ma solo in ambiente Unix/Xenix, lo stato di uscita del comando influisce anche sul valore del flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT').

A partire dalla versione 4.0 è possibile utilizzare tale comando anche su linee Tcp/Ip.

SPOOLER

Gestione spooler di stampa. Nella versione per Windows95/98/NT, se non indicati parametri, fornisce l'elenco delle stampanti. Il primo parametro è il file da stampare, mentre il secondo la stampante. Se omesso questo parametro il file fiene dirottato sulla stampante di default.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

SYSTEM

Permette di eseguire un comando del sistema operativo utilizzato. Se non è seguito da alcun parametro si comporta come il comando `SHELL' (cfr.) lanciando la shell del sistema operativo utilizzato. Altrimenti il primo parametro indica il comando di sistema da eseguire e ogni altro parametro presente oltre al nome del comando viene passato come argomento al comando di sistema in questione. Al termine dell'esecuzione del comando indicato il controllo ritorna al Cux e la variabile predefinita `RETURN' contiene il codice di ritorno (errorlevel) del comando di sistema eseguito. È anche possibile digitare `!' al posto di `SYSTEM'.

CUX> SYSTEM ls ( Elenco directory ) pippo.txt CUX> SYSTEM echo Prima prova > prova.txt ( Crea un file ) CUX> CAT prova.txt ( Lo visualizza ) Prima prova CUX> ! ls ( Elenco directory ) prova.txt pippo.txt CUX> ! exit 2 CUX> MESG $RETURN 2 CUX>

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

TOUCH

Crea il file vuoto passato come parametro. Attenzione che se il file esiste già il contenuto originario viene perso. Inoltre, in ambiente Unix/Xenix, se non si hanno i permessi opportuni per permetterne la creazione viene impostato il flag di errore.

CUX> TOUCH prova.txt ( Crea il file prova.txt vuoto )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

USER

Questo comando, attivo solo in ambiente Unix/Xenix, permette di cambiare utente, passando a quello del parametro specificato, il quale deve essere una stringa alfanumerica corrispondente ad un utente conosciuto dal sistema. Per eseguire il comando occorre tuttavia essere root o comunque avere privilegi equivalenti.

CUX> USER demo ( Imposta lo user-id )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

4.9 Comandi di controllo per file batch

ASK

Visualizza la stringa data come parametro e attende una stringa come risposta (terminata da un <ENTER> o da un `\n'). La stringa digitata come risposta viene assegnata alla variabile `WORD'. Inoltre, se la stringa è un numero il suo valore verrà posto nel contatore interno, il quale altrimenti viene azzerato.

La stringa da visualizzare può essere opzionalmente preceduta da un timeout, espresso in secondi. In tal caso se l'istruzione esce per timeout, ovvero se non viene digitata nessuna stringa entro il tempo specificato come timeout, viene impostato il flag di errore (cfr. i comandi `IFER' e `IFNOER') e il flag di timeout (cfr. i comandi `IFOUT' e `IFNOOUT').

Se non viene specificato alcun timeout, l'attesa della stringa di risposta si intende infinita.

Se la stringa data è racchiusa tra doppi apici (`"') sono ammessi i soliti caratteri speciali (cfr. comando `STRING').

CUX> ASK 5 <Enter> per continuare ( Attende una risposta ) <Enter> per continuare ( per non più di 5 secondi ) ........... CUX> IFOUT GOTO ERRTIMEOUT ( In caso di timeout salta ) ( alla routine opportuna )

Attenzione: nel caso CUX lavori in modalità HALF DUPLEX il comando `ASK' visualizzerà a video `*' in sostituzione dei caratteri digitati.

BATCH

Questo comando, speculare all'opzione `-fc', permette di eseguire una serie di istruzioni del Cux contenute in un file, detto appunto batch, il quale deve essere specificato come parametro. Il file indicato viene cercato inizialmente nella directory corrente e, se tale ricerca non ha successo, viene cercato nella directory specificata dalla variabile di environment `CUXPATH', se tale variabile è definita. Se il file specificato non esiste viene tentata la ricerca del file con lo stesso nome ma con estensione `.cux', e ancora prima nella directory corrente e successivamente nella eventuale directory indicata dalla variabile `CUXPATH'.

Il comando ritorna con il flag di errore impostato se tutti questi tentativi di ricerca non hanno successo, oppure se il file esiste e viene trovato ma contiene errori sintattici che ne precludono l'esecuzione, oppure ancora se è attiva la lettura di file di comandi crittografati e il file che si vuole eseguire non è crittografato.

Al termine delle istruzioni contenute nel file si può ritornare al Cux o al sistema operativo: questa differenza è dovuta alla possibilità di terminare un file di comandi con l'istruzione `END' o con una tra le istruzionii `BYE', `EXIT' o `QUIT'. È anche possibile digitare `@' al posto di `BATCH'.

CUX> BATCH prova.cux ( Esegue il file batch scelto ) ..........

Durante l'esecuzione di un file batch è possibile evitare la visualizzazione di un comando mettendogli come prefisso il carattere `#'. Se ad esempio un file batch contiene l'istruzione

CUX> #MUTE ON ( Disabilita l'eco dei comandi a video )

il comando in questione non viene visualizzato.

Per ulteriori informazioni sull'uso dei file batch si rimanda alla spiegazione relativa alla variabile di environment `CUXPATH' contenuta nell'appendice L'environment.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

CALL

Trasferisce l'elaborazione al sottoprogramma Cux indicato come parametro. Il ritorno al chiamante si ottiene col comando `RETURN'. La ricerca del file da eseguire avviene secondo le stesse regole riportate a proposito del comando `BATCH'.

Come per il comando `BATCH', il comando ritorna con il flag di errore impostato se i tentativi di ricerca del file da eseguire non hanno successo, oppure se il file esiste e viene trovato ma contiene errori sintattici che ne precludono l'esecuzione, oppure ancora se è attiva la lettura di file di comandi crittografati e il file che si vuole eseguire non è crittografato.

Inoltre, al ritorno dal sottoprogramma la variabile predefinita `RETURN' conterrà il codice di ritorno del sottoprogramma eseguito.

Da sottolineare che tale comando preserva lo stato del contatore interno.

CUX> CALL prova.cux ( Esegue il file batch scelto ) CUX> IFER GOTO errore ............ CUX> LABEL errore ............

Per ulteriori informazioni riguardo all'uso dei file batch si rimanda alla spiegazione relativa alla variabile di environment `CUXPATH' contenuta nell'appendice L'environment.

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

COM

Dopo aver specificato questo comando è possibile digitare una serie di informazioni di commento che non verrano interpretate dal Cux. Questo comando è utile nei file batch per inserire delle annotazioni sulle operazioni che verranno eseguite.

CUX> COM Esempio di commento ...........

Sottolineiamo che le informazioni di commento devono essere tutte sulla riga che inizia con l'istruzione `COM'. Nel caso si vogliano inserire commenti che non possono essere contenuti tutti nella stessa riga occorrerà inserire più righe di commento, come nel seguente esempio:

CUX> COM Esempio di commento CUX> COM suddiviso in due righe ...........

COMPARE

Confronta lessicograficamente due stringhe e assegna alla variabile predefinita `WHICH' il valore codificato dell'esito del confronto, ovvero uno tra i valori 0, 1 e 2, a seconda che la prima stringa risulti lessicograficamente uguale, maggiore o minore della seconda. Da sottolineare che una o entrambe le stringhe possono essere variabili. In tal caso il confronto sarà effettuato con il contenuto della variabile o delle variabili.

CUX> LET A bello CUX> COMPARE $A ballo CUX> MESG $WHICH 1 CUX> COMPARE $A bullo CUX> MESG $WHICH 2 CUX> COMPARE $A bello CUX> MESG $WHICH 0 ..........

COMPAREN

Confronta algebricamente due stringhe numeriche e assegna alla variabile predefinita `WHICH' il valore codificato dell'esito del confronto, ovvero uno tra i valori 0, 1 e 2, a seconda che la prima stringa risulti algebricamente uguale, maggiore o minore della seconda. Ogni stringa non numerica assume il valore numerico 0 (zero). Da sottolineare che una o entrambe le stringhe possono essere variabili. In tal caso il confronto sarà effettuato con il contenuto della variabile o delle variabili.

CUX> LET A 10 CUX> COMPAREN $A 20 CUX> MESG $WHICH 2 CUX> COMPAREN -10 pippo CUX> MESG $WHICH 1 ..........

COMPUTE

Calcola un'espressione algebrica assegnando il valore alla variabile specificata, secondo la sintassi:

compute var expr

Il comando deve cioè essere seguito dalla variabile nella quale memorizzare il risultato del calcolo (var) e dall'espressione algebrica da calcolare (expr). Nel caso l'espressione da calcolare expr non sia algebricamente corretta (ad esempio `3 / 0') viene impostato il flag di errore. Sono ammesse le seguenti operazioni:

• addizione (`+')
• sottrazione (`-')
• moltiplicazione (`*')
• divisione (`/')
• resto della divisione intera (`%')

       CUX> LET A 10
       CUX> COMPUTE VAR ( $A + 5 ) * 2
       CUX> MESG $VAR
       30
       CUX> LET VAR X
       CUX> COMPUTE $VAR ( $A + 5 ) * 2
       CUX> MESG $X
       30

CRYPT

Ammette come parametro uno dei due valori `ON' e `OFF' (default). Se impostato a `ON' abilita l'esecuzione esclusivamente di batch crittografati, mentre se impostato a `OFF' possono essere eseguiti solamente batch non crittografati. Se è impostato a `ON' il programma segnala come errore ogni tentativo di eseguire un batch non crittografato. Se invece il comando è impostato a `OFF' il risultato di un tentativo di eseguire un batch crittografato non è predicibile, dal momento che il programma tenterà comunque di eseguire il batch riga per riga; il risultato più probabile è la visualizzazione del messaggio di errore `Comando sconosciuto!' alla lettura di ogni riga del batch in questione, anche se non è da escludere la probabilità (per quanto remota) che il risultato della crittografazione venga a corrispondere ad un comando o ad una macro dotata di senso, nel qual caso la riga del batch verrà eseguita!

CUX> CRYPT ON ( Abilita la crittografazione )

Per la crittografazione dei file di comandi deve essere usato il programma `cuxcrypt' fornito col dischetto di installazione del prodotto. Tale programma ha la seguente sintassi:

cuxcrypt sorgente destinazione

ovvero legge in input un file di comandi in chiaro (`sorgente') e scrive in output un file di comandi crittografato (`destinazione'). Da sottolineare che possono essere crittografati esclusivamente file di tipo ASCII, ovvero nei sorgenti da crittografare non possono essere presneti caratteri con codice ASCII minore di 32. Il metodo di crittografazione adottato utilizza un algoritmo di conversione dei caratteri che si automodifica in continuazione ottenendo in uscita un file ASCII completamente diverso, ma visualizzabile su un terminale video.

Attenzione: possono essere crittografati solo sorgenti di dimensioni non superiori ai 64 Kbyte.

Il programma `cuxcrypt' deve essere usato in congiunzione con l'opzione `-CR' al lancio del Cux, oppure, in alternativa, con il comando `CRYPT'.

Se si vuole impiegare un file di comandi crittografato occorre procedere quindi secondo i seguenti passi:

1. Creare il file di comandi (ad esempio `prova.cux') con un qualsiasi programma editor.
2. Crittografare il file con il programma `cuxcrypt' producendo ad esempio il file `prova.cry':

   cuxcrypt < prova.cux > prova.cry

3. Lanciare Cux con la seguente linea di comando:

   cux -CR -fc prova.cry

   Oppure, alternativamente, lanciare Cux e dal prompt del programma dare i seguenti comandi:

   CUX> CRYPT ON CUX> CALL prova.cry

DEBUG

Introduce un ritardo in secondi tra l'esecuzione dei comandi; in questo modo è possibile controllare l'esecuzione di ogni singolo comando di un file batch per trovare eventuali errori in fase di debugging.

CUX> DEBUG 5 ( Introduce un ritardo di 5 secondi ) ............ CUX> DIAL connect (2400) CUX> CONV ...........

DECCOUNT

Decrementa il contatore interno; se dopo questa operazione il contatore è uguale a zero viene cambiato il valore del flag di errore.

.......... CUX> SETCOUNT 5 ( Inizializza il contatore ) CUX> LABEL TENTATIVO ( Definisce la label TENTATIVO ) CUX> DIAL ( Effettua una chiama ) CUX> IFNOER BATCH conv.cux ( In caso di successo esegue ) ( il batch conv.cux ) CUX> DECCOUNT ( Decrementa il contatore ) CUX> IFNOER GOTO TENTATIVO ( Se contatore diverso da zero ) ( torna a TENTATIVO ) CUX> COMMAND ( Torna in modalità comandi ) CUX> HANGUP OFF ( Sgancia la linea ) CUX> EXIT ( Esce da Cux )

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

DELAY

Il comando `DELAY' permette di introdurre un ritardo del numero di secondi indicato come parametro. Il massimo ritardo specificabile è 100000000.

CUX> PROTOC CUXENC ( Specifica il tipo di protocollo ) CUX> SEND pippo.exe ( Trasmette il file ) CUX> DELAY 15 ( Introduce un ritardo di 15 secondi ) CUX> SEND pippo.com ( Trasmette il file ) ..........

DOSPATH

Converte tutti i caratteri `/' (slash) occorrenti nella variabile indicata come parametro in caratteri `\' (backslash).

CUX> LET VAR /usr/varie/tmp ( Imposta la variabile ) CUX> DOSPATH VAR ( La converte ) CUX> MESG $VAR ( La visualizza convertita ) \usr\varie\tmp ..........

END

Termina il file batch e ritorna al prompt del Cux.

GET

Legge dal file indicato come primo parametro e assegna alla variabile indicata come secondo parametro la riga indicata come terzo parametro. La numerazione delle righe inizia da 1. Il file deve essere di tipo sequenziale a righe di caratteri terminate da newline. Il comando imposta il flag di errore se il file o la riga non esistono. Se ad esempio il file `pippo' contiene le righe

prima riga di prova seconda riga di prova prima terza di prova

per caricare nella variabile `VAR' il contenuto della seconda riga occorre dare il seguente comando:

CUX> GET pippo VAR 2 ( Legge la riga indicata ) CUX> MESG $VAR ( La visualizza ) seconda riga di prova

Attenzione: lo stato di uscita di questo comando influisce sul valore del flag di errore (cfr. i comandi `IFER' e `IFNOER').

GOTO

Istruzione di salto ad una label (cfr. comando `LABEL'). Il comando deve essere seguito dal nome dell'etichetta a partire dalla quale dovrà continuare l'esecuzione del batch. Se l'etichetta specificata non esiste il programma termina con errorlevel 5.

CUX> GOTO ETICHETTA ........... CUX> LABEL ETICHETTA CUX> MESG "Sono alla label ETICHETTA" Sono alla label ETICHETTA ..........

GOTONUM

Comando di salto condizionato ad una label, a seconda del valore della variabile predefinita `WHICH'. Il comando deve essere seguito dai nomi delle etichette, separati solo dalla virgola: il flusso dei comandi salterà alla prima etichetta se `WHICH' vale 0, alla seconda etichetta se `WHICH' vale 1, e cos`ì di seguito.

Dalla versione 4.0 se `WHICH' ha un valore superiore al numero delle etichette specificate salterà alla etichetta `GOTOERROR'. Se l'etichetta puntata da `GOTONUM' non esiste il programma termina con errorlevel 5.

CUX> LET WHICH 1 ( Imposta la variabile WHICH ) CUX> GOTONUM OK,NONE ( Istruzione di salto condizionale ) .......... CUX> LABEL NONE ( In tal caso salta alla label NONE ) ..........

Tale comando trova un'importante applicazione in combinazione con la ricezione di stringhe multivia (cfr. comandi `RSTRING' e `XRSTRING'). I comandi `RSTRING' e `XRSTRING' impostano le variabili predefinite `WHICH' e `WORD' in base alla stringa ricevuta (`WORD' contiene la stringa ricevuta mentre `WHICH' contiene il numero relativo alla stringa ricevuta, ovvero 0 se non è riconosciuta alcuna delle stringhe indicate oppure 1 per la prima stringa, 2 per la seconda e cos`ì via). Avendo quindi l'accortezza di anteporre nel comando `GOTONUM' una label per la gestione del caso in cui non è stata riconosciuta alcuna stringa, è possibile costruire procedure di salto condizionato in base alla ricezione di una particolare stringa.

.......... CUX> RSTRING "a","b","c","d","e" CUX> GOTONUM L_ERR,L_A,L_B,L_C,L_D,L_E ..........

In questo esempio il flusso delle istruzioni salterà all'etichetta relativa alla stringa ricevuta, ovvero salterà all'etichetta `L_ERR' se non viene ricevuta nessuna stringa tra quelle indicate, salterà all'etichetta `L_A' se viene ricevuta la stringa `a', salterà all'etichetta `L_B' se viene ricevuta la stringa `b', e cos`ì di seguito.

IFER

Questo comando assume un significato solo in relazione alle istruzioni che hanno la possibilità di modificare il valore del flag di errore. Deve essere seguito da uno o più parametri che rappresentano il comando da eseguire nel caso il flag di errore sia impostato. L'istruzione `IFER' è utile per verificare lo stato di uscita di un comando, ma occorre fare attenzione che tra l'esecuzione del comando da controllare e l'esecuzione dell'istruzione `IFER' non vengano eseguiti altri comandi che possano modificare il valore del flag di errore.

.......... CUX> SEND pippo.txt ( Trasmette il file specificato ) CUX> IFER BATCH pluto.cux ( Se vi è errore esegue il batch ) ..........

IFNOER

Questo comando assume un significato solo in relazione alle istruzioni che hanno la possibilità di modificare il valore del flag di errore. Deve essere seguito da uno o più parametri che rappresentano il comando da eseguire nel caso il flag di errore sia azzerato. Anche tale istruzione, come già l'istruzione `IFER', è utile per verificare lo stato di uscita di un comando, e anche in tal caso occorre fare attenzione che tra l'esecuzione del comando da controllare e l'esecuzione dell'istruzione `IFNOER' non vengano eseguiti altri comandi che possano modificare il valore del flag di errore.

.......... CUX> SEND pippo.txt ( Trasmette il file specificato ) CUX> IFNOER BATCH pluto.cux ( Se non vi è errore esegue il batch ) ..........

IFNOOUT

Questo comando assume un significato solo in relazione alle istruzioni che hanno la possibilità di modificare il valore del flag di timeout. Deve essere seguito da uno o più parametri che rappresentano il comando da eseguire nel caso il flag di timeout sia azzerato. L'istruzione `IFNOOUT' è utile per verificare lo stato di uscita di un comando, ma occorre fare attenzione che tra l'esecuzione del comando da controllare e l'esecuzione dell'istruzione `IFNOOUT' non vengano eseguiti altri comandi che possano modificare il valore del flag di timeout.

.......... CUX> RSTRING 10 OK ( Attende per 10 secondi la stringa ) CUX> IFNOOUT BATCH pluto.cux ( Se la riceve esegue il batch ) ..........

IFOUT

Questo comando assume un significato solo in relazione alle istruzioni che hanno la possibilità di modificare il valore del flag di timeout. Deve essere seguito da uno o più parametri che rappresentano il comando da eseguire nel caso il flag di timeout sia impostato. Anche tale istruzione, come già l'istruzione `IFNOOUT', è utile per verificare lo stato di uscita di un comando, e anche in tal caso occorre fare attenzione che tra l'esecuzione del comando da controllare e l'esecuzione dell'istruzione `IFOUT' non vengano eseguiti altri comandi che possano modificare il valore del flag di timeout.

.......... CUX> RSTRING 10 OK ( Attende per 10 secondi la stringa ) CUX> IFOUT BATCH pluto.cux ( Se non la riceve esegue il batch ) ..........

INCCOUNT

Incrementa il contatore interno; se dopo questa operazione il contatore è uguale a zero viene impostato il flag di errore.

CUX> PROTOC CUXTXT ( Definisce il tipo di protocollo ) CUX> SETCOUNT -3 ( Inizializza il contatore interno ) CUX> LABEL START ( Imposta l'etichetta di riferimento ) CUX> REC file.txt ( Riceve un file di testo ) CUX> IFNOER GOTO OK ( Se corretto salta alla label OK ) CUX> INCCOUNT ( Incrementa il contatore ) CUX> IFNOER GOTO START ( Se il contatore non vale 0 riprova ) CUX> GOTO ERR ( Se invece vale 0 salta alla label ERR ) .............

Nell'esempio sopra descritto viene tentata per tre volte al massimo la ricezione di un file di testo.