Michele Liberi software

Michele Liberi
mail: mliberi@gmail.com
cell: +393485211456
telegram: @MicheleLiberi

liberix Indice analitico

c23, contabilità in partita doppia

La prima versione di C23 risale al 1986. A quei tempi ero ancora all'università, ma andavo già in giro per conto di un'azienda ad installare programmi di contabilità, vendite, magazzino, paghe.

Programmi di cui non ricordo il nome, pieni di bug, e che creavano molti più problemi di quanti ne risolvevano.

Decisi di scrivere un programma ben fatto per gestire la contabilità in partita doppia, che poi ho usato per 25 anni, fino al 2011.

Dal 2012 ho smesso di usare la versione DOS e ho riscritto tutto con tecnologie più moderne (applicazione web).

C23 funziona in modalità testo, cioè in un terminale alfanumerico, e si controlla da tastiera.

La struttura dell'applicazione è a menu, per cui il lancio delle varie funzionalità avviene navigando un sistema ad albero.

I dati vengono salvati in un insieme di file che, tutti assieme, costituiscono un dataset consistente.

Il dataset può essere criptato, la password di accesso deve essere fornita a C23 in fase di apertura.

Particolare attenzione è stata posta in fase di progettazione alla robustezza del dataset, in modo che i dati non si possano corrompere anche in casi di caduta accidentale del programma (ad esempio per spegnimento improvviso del PC per mancanza di corrente elettrica).

L'albero dei menu contiene molte foglie organizzate in vari livelli, riporto un paio di printscreen del menu principale e di un sottomenu.


Generalità

-------------------- Descrizione Generale -------------------- Il programma C23 è stato scritto da M.Liberi nel 1986 ad uso esclusivamente personale, questo manuale si riferisce alla seconda versione scritta nel 1991 che migliora la prima sotto molti aspetti. Con C23 mi sono posto l'obiettivo la gestione dei conti personali e della famiglia in maniera semplice e, nello stesso tempo, sofisticata. La selezione delle funzioni del programma viene guidata attraverso scelte a menu per cui è estremamente semplice. Ogni singola registrazione giornaliera DEVE essere bilanciata ovvero la somma delle entrate e delle uscita deve essere uguale, questo significa che viene gestita la partita doppia. Le registrazioni contabili vengono inserite per data usando la prima nota, e possono essere riprese per data o per codice conto. Ogni singola voce viene infatti associata ad un codice conto appartenente al PIANO DEI CONTI che viene strutturato e personalizzato a piacere. Il piano dei conti ha una struttura gerarchica a tre livelli: Conti, Sottoconti e Schede contabili. Le singole voci di registrazione interessano sempre e solo le schede contabili. I sottoconti riportano i totali attivi e passivi delle schede contabili che li compongono e meccanismo analogo vale per i conti. Il piano dei conti riporta i totali progressivi a due livelli: annuale e periodico. La scelta della durata dei periodi è assolutamente arbitraria, in quanto il riporto dei progressivi periodici a quelli annuali viene fatta soltanto attivando una specifica funzione e quindi in tempi arbitrari. Alla partenza il programma effettua automaticamente un salvataggio di tutti gli archivi. Se il programma non termina regolarmente (ad esempio per una caduta di tensione) si devono ripristinare i vecchi archivi e ripetere tutte le operazioni effettuate nell'ultima seduta(vedi: parametri di attivazione). È disponibile una tabellina Lotus-Like con il riepilogo delle entrate e delle uscite mese per mese, ed un block notes elettronico per ricordare scadenze e/o impegni importanti. È possibile memorizzare una password che il sistema chiederà in fase di avviamento, tale password è settabile e diversa per ogni "data set" per cui ogni utente può avere la propria contabilità , la propria password e la propria copia di archivi di lavoro. Una volta entrati nel sistema è possibile compiere qualunque operazione. Il data base viene completamente crittografato per cui è impossibile accedere ai dati contabili se non utilizzando il programma C23. La configurazione dei colori è completamente personalizzabile e modificabile data-set per data-set, per cui è possibile utilizzare sia monitor a colori che monitor in bianco e nero. In qualunque momento durante le operazioni è possibile oscurare lo schermo con la semplice battuta di un tasto (ALT'=') ad evitare eventuali occhi indiscreti. È sempre disponibile il tasto di PANICO, premendo ESC è possibile uscire da qualunque funzione e tornare alla situazione precedente. ----------------------------- Requisiti Hardware e Software ----------------------------- Hardware: Processore : qualunque Intel dal 8088 al 80486. Memoria RAM : Il programma utilizza circa 100k dei 640 del DOS per il codice. È comunque obbligatoria la presenza di altra memoria disponibile per l'allocazione degli indici. Questo ammontare dipende dalla dimensione degli archivi. Si sconsiglia una configurazione con meno di 256k disponibili. N.B. Se durante il lavoro il programma non fosse più in grado di allocare memoria terminerebbe in modo anomalo e sarebbe indispensabile ripristinare l'ultimo salvataggio. (cfr. "Condizioni d'errore") Hard Disk : Tutto il pacchetto sta benissimo anche in un floppy disk da 360k, è tuttavia consigliabile che il DATA-SET sia installato su Hard Disk per motivi di performance. Le basi di dati crescono dinamicamente man mano che vengono inseriti i dati. N.B. Se durante il funzionamento venisse a mancare lo spazio disco, il programma termina in modo anomalo e si perde il lavoro dell'ultima sessione. È quindi opportuno mantenere sempre un margine di spazio disco libero. (cfr. "Condizioni d'errore") Software: Qualunque versione del DOS posteriore alla 2.00 --------------------- Descrizione dei file --------------------- Il pacchetto C23 è composto dai seguenti file: C23.EXE Il programma in formato eseguibile C23.DOC Questo file C23.MNU Files di dati contenente la struttura dei menu. Alla partenza del sistema DEVE essere nella stessa dir in cui si trova C23.EXE. In caso contrario verrà visualizzato un messaggio di errore. Alla partenza del sistema verranno creati uno o più DATA-SET ognuno dei quali ingloba una contabilità . Questi file possono risiedere in una qualunque delle directory del sistema. Per utilizzare uno di questi DATA-SET vedere l'opzione di attivazione -d. Ogni DATA-SET contiene i seguenti file. PCVARS.C23 Lock file per la partenza del sistema PIACON.C23 Base dati Piano dei Conti PRIMNO.C23 Base dati registrazioni Prima Nota PIACON.CDX File di Indici per l'accesso al Piano dei Conti PRIMNO.CDX File di indici per l'accesso alla Prima Nota Ad ognuno di essi può corrispondere un file di Backup creato automaticamente alla partenza del sistema se non è stata specificata l'opzione -r. Se i file di backup sono assenti non è possibile utilizzare l'opzione -t.(Cfr. Parametri di attivazione) Essi sono: PCVARS.K23 Backup di PCVARS.C23 PIACON.K23 Backup di PIACON.C23 PRIMNO.K23 Backup di PRIMNO.C23 PIACON.KDX Backup di PIACON.CDX PRIMNO.KDX Backup di PRIMNO.CDX ------------- Installazione ------------- Per l'installazione del prodotto è sufficiente mettere il file C23.EXE ed il file C23.MNU in una delle directory specificate nella variabile di sistema PATH (vedi manuale del DOS), creare una directory per il data set, posizionarsi sulla directory appena creata, e richiamare il programma. Ad esempio, dare i seguenti comandi: C:> mkdir \c23 ; Crea la dir che conterrà il programma C:> mkdir \c23\1992 ; Crea la dir che conterrà il data set C:> \c23\c23 -d\c23\1992 ; Attiva il programma A questo punto il sistema chiederà se si vuole che venga creato un nuovo Data-Set nella directory corrente e, in caso di risposta affermativa, il data-set verrà creato.

PRIMO APPROCCIO AL SISTEMA

In questa sezione si tratta delle modalità di lavoro con il programma a livello generale. ----------------------- Sintassi di attivazione ----------------------- Il programma viene fatto partire digitando da linea comandi del DOS: C:> C23 [Opzioni] Le possibili opzioni sono le seguenti: -h Visualizza una schermata di help sull'uso delle opzioni; Il programma con questa opzione non verrà attivato. -t Ripristina la situazione all'ultimo salvataggio. Il ripristino viene preceduto da una richiesta di conferma dell'effettiva volontà di riportarsi alla situazione precedente l'ultimo salvataggio effettuato. Se l'ultima uscita dal programma era stata anomala, ad esempio per una caduta di tensione, è questo l'unico modo per far ripartire il sistema. -r NON effettua il salvataggio in partenza, in caso di danni non sarà possibile effettuare un ripristino della situazione precedente. Si consiglia di utilizzare questa opzione solo quando si attiva il programma per la sola consultazione degli archivi. -dDIR Usa come directory di lavoro la directory DIR, se questo parametro viene omesso viene usata la directory corrente. Se nel data set è specificata una Password, questa verrà richiesta prima di iniziare le operazioni (Cfr. Impostazione Password) ------------------------- Selezione delle funzioni ------------------------- Tutte le funzioni del programma vengono selezionate tramite scelte guidate a menu. Ogni menu presenta le voci con a fianco un numero ed eventualmente una sequenza di "$". Una sola delle voci a menu visualizzate viene presentata in "reverse": è la voce selezionata. Le voci che hanno a fianco una sequenza di "$" sono i punti di accesso a degli ulteriori menu, le altre sono le funzioni del programma. La selezione di una voce di menu può avvenire in due modi: - Selezione diretta: si effettua premendo il tasto funzionale (Fx) corrispondente al numero di voce che si vuole selezionare. - Selezione normale: con le frecce o direttamente con i numeri mettere in reverse la voce da selezionare, indi premere il tasto RETURN. Per tornare ad un livello di menu precedente bisogna battere il tasto ESC, con il tasto HOME si torna da qualunque punto al menu principale. Riepilogando i tasti attivi per la selezione sono i seguenti: F1..Fn Tasti funzionali per la selezione diretta 1..n Selezione della voce corrispondente RETURN Selezione del campo in reverse ESC Ritorno al menu precedente HOME Ritorno al menu principale ----------------- Ingresso dei dati ----------------- Tutte le operazioni di Input vengono effettuate tramite procedure che ne controllano e verificano la correttezza. Esistono tre specifiche funzioni di ingresso dati per i vari tipi di dati: date, campi numerici ed alfanumerici. In ogni caso la dimensione del campo di ingresso è fissata a priori ed evidenziata a video. ENTER,ESC o qualunque tasto funzionale terminano l'input. N.B. È sempre attivo il tasto ALT= che oscura lo schermo fin che non viene di nuovo premuto ALT= ---- Date ---- Il campo data può variare dal 1/1/1924 al 31/12/2099. Il campo viene già inizializzato con una data e proposto nella forma (es.) 'Dom 26 Gen 1992'. Per editarlo sono disponibili i seguenti tasti: Left,Right --> Giorno Precedente/Successivo Up,Down --> Mese Precedente/Successivo PgUp,PgDn --> Anno Precedente/Successivo TAB,Shift-TAB --> Settimana Precedente/Successiva Home,End --> Inizio/Fine Mese ^Home,^End --> Inizio/Fine Anno ALT-R --> Ripristino Valore Default ALT-G --> Data Corrente di Sistema ALT-N --> Entra in modo 'Numerico' In modo 'Numerico' la data viene battuta nella forma ggmm. L'anno rimane quello corrente. Al termine si ritorna sempre in modalità 'Normale' da dove la data potrà essere accettata. In questa modalità sono accettati i seguenti tasti: ESC --> Ignora quanto scritto e ritorna RET --> Accetta la data (se valida) e ritorna BckSp --> Cursore indietro 0..9 --> Immette una cifra; se ultima ritorna -------------- Campi Numerici -------------- I campi numerici sono immessi da destra a sinistra come avviene normalmente nelle calcolatrici. Anche in questo casi il campo viene proposto già con un default che può essere modificato o sovrascritto. I tasti ammessi sono i seguenti: RET --> Accetta ed esce - --> Cambio segno ALT-R --> Ripristino valore iniziale BckSp --> Annulla ultima cifra . --> Immette punto decimale (ove previsto) 0..9 --> Immette la cifra In alcune situazioni il punto decimale non viene accettato in quanto il valore che si sta immettendo deve essere forzatamente intero. ------------------ Campi Alfanumerici ------------------ I campi alfanumerici sono immessi come normalmente avviene in un editor, tenendo presente che, dipendentemente dal contesto, possono essere accettati soltanto alcuni caratteri. Sono disponibili i seguenti comandi di EDITING. <--,--> : Movimento cursore Home : Cursore all'inizio della stringa End : Cursore alla fine della stringa Del : Cancella carattere al cursore BckSp : Cancella carattere precedente Alt-R : Ripristino Valore di Default ALT-K : Azzera la stringa ALT-L : Cancella dal cursore alla fine

DESCRIZIONE DELLE FUNZIONI

In questa sezione sono descritte dettagliatamente le funzioni selezionabili tramite menu. ------------------------- Gestione della prima nota ------------------------- Le funzioni in questa sezione trattano dei movimenti in Prima Nota. La prima nota è l'unica via per IMMETTERE registrazioni contabili nel sistema. La registrazione viene immessa per DATA e consta, al più , di 128 linee. Ogni linea ha i seguenti campi: Codice conto : deve essere un codice di tre cifre già PRESENTE sul piano dei conti. Descrizione : Campo libero per la descrizione del movimento. Entrate/Uscite: Campo numerico ad identificare l'importo del movimento. Non possono essere specificate sia entrate che uscite. Ogni registrazione (= insieme delle linee con la stessa data) deve essere bilanciata, ovvero la somma delle entrate e delle uscite deve essere nulla. Vediamo ora le singole funzioni per la gestione della prima nota: ------------------------------- Inserzione e Modifica Movimenti ------------------------------- Al richiamo di questa funzione apparirà una opportuna maschera video e sarà richiesta la data della registrazione. Immessa la data verranno visualizzati i movimenti già registrati. Nel caso la data sia antecedente la data di ultima chiusura di periodo verrà visualizzato un messaggio, ma sarà possibile fare qualunque operazione sulla registrazione. I dati contabili immessi verranno contabilizzati nel periodo corrente e riportati sui progressivi annuali solo in corrispondenza dell'operazione di chiusura Mensile (cfr). Apparirà un menu sull'ultima riga dello schermo, la selezione della funzione avviene spostando il cursore sulla voce desiderata e premendo il tasto ENTER. Sono tuttavia attivi altri tasti che controllano la finestra di visualizzazione dei movimenti. Home : Si visualizza la prima pagina di movimenti. End : Si visualizza l'ultima pagina di movimenti. Up : Scorrimento verso l'alto di una riga Down : Scorrimento verso il basso di una riga PgUp : Scorrimento verso l'alto di 16 righe PgDn : Scorrimento verso il basso di 16 righe <- -> : Selezione voce del menu Le voci del menu sono le seguenti: Aggiungi: Inserisce una nuova linea alla registrazione. Il cursore si porterà sulla prima riga non occupata. Si devono a questo punto immettere i campi di Input. Per passare da "Entrate" ad "Uscite" e viceversa basta premere ENTER lasciando a zero l'altro campo. Completata l'immissione dell'ultimo dei campi richiesti verrà nuovamente proposta la linea menu. Modifica: Consente di variare una delle linee della registrazione. Immesso il numero della linea che si intende variare, si dovranno modificare i campi relativi con le stesse modalità della funzione Aggiungi. Per non modificare alcuna riga immettere un numero inesistente. Cancella: Consente di eliminare una delle righe della registrazione. Il programma richiederà semplicemente il numero della riga da eliminare. Per non eliminare alcuna riga immettere un numero inesistente. Fine : Salva sul DB i dati immessi per la registrazione corrente. Tutte le operazione su descritte infatti lavorano su una copia in memoria della registrazione e l'effettivo salvataggio si ha solo selezionando questa voce. Al salvataggio vengono aggiornati anche tutti i dati di Bilancio, quindi l'operazione contabile è , a tutti gli effetti, già consolidata. Se la registrazione non è bilanciata questa funzione non può aver luogo, ma viene notificato qual è l'importo mancante per il bilanciamento dell'operazione. Quit : Consente di tornare al menu precedente senza salvare le modifiche fatte nell'ultima sessione. --------------------------- Modifica descrizione schede --------------------------- Tramite questa funzione è possibile modificare le descrizioni delle linee di registrazione relative ad una scheda contabile. Si differenzia dalla funzione descritta precedentemente per il fatto che: 1) NON consente la variazione di dati contabili quindi l'aggiornamento degli archivi è molto più veloce. 2) Consente di selezionare le righe per codice conto e per intervallo di date di registrazione. Verranno richiesti: il codico conto, la data minima e massima per la selezione dei movimenti. Si potranno quindi modificare le descrizioni che vengono presentate in ordine cronologico. Per terminare premere il tasto ESC. ----------------------- Cancellazione movimenti ----------------------- Questa funzione permette di annullare TUTTI i movimenti con una certa data di registrazione. Dopo aver immesso la data verrà richiesta conferma. ---------------------------- Gestione del piano dei conti ---------------------------- In questa sezione sono descritte le funzioni che permettono di gestire il PIANO DEI CONTI. Esso è una struttura gerarchica organizzata su tre livelli in cui sono presenti tutti i codici dei conti su cui si effettueranno movimenti. Il codice del conto può essere di uno, due o tre caratteri alfanumerici ([0..9,A..Z]). I conti con codice di una lettera sono detti CONTI, quelli con due lettere sono detti SOTTOCONTI e quelli con tre lettere sono le SCHEDE CONTABILI. Le schede contabili sono gli unici conti su cui è legale fare dei movimenti, i SOTTOCONTI ed i CONTI servono solo per raggruppare le schede contabili in gruppi e sottogruppi. A titolo di esempio osserviamo la seguente struttura: P Patrimoniale PA Liquidità PAB Banca PAC Conto Cassa PD Debitori e Creditori PDA Alessandro PDB Berto In essa possiamo osservare che i sottoconti PA e PD dipendono gerarchicamente dal conto P, le schede contabili PAB e PAC dipendono dal conto PA e le schede contabili PDA e PDB dipendono gerarchicamente dal conto PD. Movimenti contabili potranno essere imputati solo alle schede contabili PAB, PAC, PDA e PDB mentre sottoconti e conti riporteranno solo i totali rispettivamente delle schede contabili e dei conti che sono gerarchicamente inferiori. Per una descrizione più dettagliata di questo meccanismo si rimanda ad un testo elementare di contabilità in partita doppia. Di seguito le funzioni che operano sul piano dei conti. ---------------- Inserzione conto ---------------- È possibile mediante questa funzione inserire un nuovo codice nel piano dei conti. Un sottoconto può essere inserito solo se esiste il corrispondente conto, ed una scheda contabile se esiste il relativo sottoconto. Inserito il codice verrà richiesta la descrizione del conto, sottoconto o scheda. Il codice è ovviamente univoco per cui non è possibile inserire una seconda volta un codice già esistente. Inserito il codice, se accettato, il sistema richiederà la descrizione del conto. Quest'ultima potrà , in un secondo tempo essere modificata con la funzione "Modifica Conto" (cfr). Il codice conto, d'altra parte, non è modificabile in quanto rappresenta la CHIAVE di accesso al piano dei conti. La sola operazione possibile è la cancellazione. -------------- Modifica conto -------------- Con questa funzione è possibile modificare la descrizione di un conto, sottoconto o scheda contabile. Verranno visualizzati anche i dati associati al conto, ma non è possibile la loro variazione. ------------------- Cancellazione conto ------------------- È possibile con questa funzione eliminare un conto dal piano dei conti. L'operazione è possibile solo se non ci sono movimenti contabili associati. NON BASTA che i totali siano a zero. A tal proposito far riferimento alla sezione relativa alle chiusure contabili. --------------------------- Le stampe e visualizzazioni --------------------------- Questa sezione è dedicata a tutte quelle attività di reporting ed interrogazione dei data bases per le quali giornalmente inserite i vostri dati. È possibile avere l'output delle interrogazioni a video, sullo standard output del DOS,direttamente su stampante od anche memorizzate su un file su disco. La selezione della unità di output avviene mediante la funzione "Selezione del file di output", descritta più avanti. Se il file di output non è il video all'atto dell'attivazione della maschera relativa all'interrogazione che intendete fare comparirà una scritta lampeggiante indicante appunto su quale unità sarà diretto l'output. Nel caso di output a video è possibile regolare la velocità di scorrimento dei dati premendo un tasto numerico tra 0 e 9. Il tasto 0 permette la massima velocità di scorrimento, il tasto 9 la minima. La velocità di scorrimento iniziale può essere impostata tramite le funzioni di setup (cfr). Vediamo in dettaglio quali sono le stampe ottenibili da C23: - Prima Nota: Le due funzioni che seguono estraggono i dati per la stampa dai movimenti registrati in prima nota. - Stampa Registrazioni: Vengono stampati tutti i movimenti con data compresa tra le due indicate. - Ricerca per descrizione: Accesso sequenziale al file e selezione dei singoli movimenti attraverso il campo descrizione. Viene richiesta la stringa da cercare che può contenere le seguenti WildCards. ^,$ --> Inizio,Fine stringa * --> stringa arbitraria ? --> carattere singolo arbitrario c --> Il carattere c /c --> il carattere speciale c (anche all'interno di []) [xy-z] --> Carattere nell'insieme specificato (da-a). [^xy-z]--> Carattere NON nell'insieme specificato - Piano dei conti Dal piano dei conti si possono ottenere diversi report, vediamoli in dettaglio. Per ognuno di essi, il programma chiederà i limiti, minimo e massimo, di codici conto fra i quali operare l'attività richiesta. - Struttura del Piano dei Conti: Viene semplicemente visualizzata la struttura del piano dei conti, ovverro tutti i codici conto, con la relativa descrizione. - Bilancio Analitico: Oltre ai dati della struttura del piano dei conti vengono stampate le ENTRATE ed USCITE sia annuali che periodiche per ogni conto. - Bilancio Annuale: In questa funzione le entrate ed uscite annuali e periodiche vengono sommate tra loro, per cui si ha una situazione globale aggiornata. - Bilancio di Periodo: Vengono stampati solo i dati relativi all'ultimo periodo, ovvero solo i dati relativi ai movimenti effettuati DOPO l'ultima chiusura di periodo. - Schede Contabili In questo menu sono raggruppate le funzioni di reporting relative alle schede contabili. Le funzioni sono le seguenti: - Stampa movimenti scheda contabile: Questa è la principale e fondamentale delle tre funzioni. La selezione avviene sia per codice conto ( da un minimo ad un massimo) che per data (minima, massima). Consente di stampare tutti i movimenti presenti in prima nota, raggruppati per codice conto, tra i limiti fissati. - Calcolo Interessi su scheda contabile: Richiede in input un codice conto ed un tasso di interesse su base annua. Genera una tabellina degli interessi maturati su ogni operazione di una scheda contabile e calcola il montante totale fino alla data corrente. Il tasso proposto come default è configurabile tramite le funzioni di SetUp (cfr). - Prospetto consumi Benzina Richiede in input il codice conto della scheda carburante ed il punto di riferimento (serbatoio pieno o vuoto). Questa funzione è disegnata appositamente per avere i dati relativi al consumo dell'auto o della moto. Per funzionare richiede che i dati nel campo DESCRIZIONE di ogni movimento del conto selezionato siano formattati in un modo particolare. Se ciò non avviene la funzione si interromperà con un messaggio di errore. La formattazione dei campi deve essere la seguente: 1) campo numerico: prezzo della benzina 2) campo numerico intero opzionale: kilometraggio al momento del rifornimento. Il dato verrà interpretato diversamente in funzione del punto di riferimento selezionato: P) al KM indicato serbatoio pieno R) al KM indicato serbatoio in riserva. I due campi possono essere separati da qualunque stringa di caratteri non numerici. - Prospetto Riepilogativo Annuale Stampa il prospetto lotus-like definito con la funzione "Riepilogo annuale dei guadagni" (cfr). --------------------- Selezione FILE output --------------------- È possibile, con questo menu, scegliere quale file di output utilizzare per le stampe. Verrà proposto un nuovo menu composto dalle seguenti voci: - Impostazione corrente ? Scegliendo questa voce verrà visualizzato su quale device saranno dirette le successive stampe. La stessa informazione verrà proposta, nel caso l'output non sia il video, anche quando si selezionerà una qualunque stampa. - Video L'output sarà diretto a video. È questa l'impostazione di Default alla partenza del programma. - Standard output del DOS L'output delle stampe andrà sul file selezionato. Notare che per utilizzare questa opzione alla partenza del sistema bisogna assegnare da linea comandi DOS un file che sia standard output con la sintassi: c:> C23 [opzioni] >Nomefile In questo modo è possibile dirigere l'output su stampante, su porta seriale ecc. Notare anche che è questo l'unico modo di ottenere stampe su una stampante non vista come "PRN:". Per maggiori dettagli ed informazioni si rimanda ad un manuale sul DOS. - Stampante L'output sarà diretto sulla stampante collegata al sistema vista dal DOS come "PRN:". Nel caso la stampante sia scollegata o spenta o comunque in condizione d'errore verrà visualizzato un messaggio di errore. - File su disco Potrete dirigere le stampe su un qualunque file DOS. Basterà specificarne il nome completo. In ogni caso il contenuto del file non verrà cancellato e le righe di stampa saranno semplicemente accodate. --------------------- Form Feed file output --------------------- Spedisce un carattere di avanzamento pagina sul file di output. È utile nel caso questo sia la stampante od un file su disco, assolutamente inutile se collegato al video. -------- Chiusure -------- In questa sezione sono descritte le funzioni di chiusura contabile. Sono previsti due tipi di chiusura: - Chiusura Mensile: Con questa funzione si azzerano tutti i saldi del periodo corrente dopo averli sommati a quelli dell'anno corrente. Non vengono toccati in alcun modo i movimenti in prima nota. - Chiusura annuale: Questa funzione è altamente DISTRUTTIVA per i data-bases: si consiglia di utilizzarla solo dopo aver letto attentamente le istruzioni qui riportate. Vengono azzerati tutti i dati SIA periodici CHE annuali; viene completamente azzerata la prima nota. Si consiglia di utilizzare questa funzione per inizializzare gli archivi per il nuovo anno DOPO AVER SALVATO i dati dell'anno corrente. --------------------- Controlli su DATA-SET --------------------- In questa sezione sono descritte le funzioni relative allo stato del Data-Base. Le funzioni sono le seguenti: -------------------- Controllo Prima Nota -------------------- Accesso sequenziale a TUTTI i Record del DB Prima-Nota. Al termine saranno disponibili i seguenti dati: N. di Record presenti = Linee di Prima-Nota memorizzate N. di Record cancellati (ma fisicamente presenti) Lunghezza della Lista Libera: questo dato deve corrispondere con il numero di record cancellati. ------------------------- Controllo Piano dei Conti ------------------------- Accesso sequenziale a TUTTI i Record del DB Piano dei Conti. Al termine saranno disponibili i seguenti dati: N. di Record presenti = Conti presenti sul Piano dei Conti N. di Record cancellati (ma fisicamente presenti) Lunghezza della Lista Libera: questo dato deve corrispondere con il numero di record cancellati. --------------------------- Controllo indici Prima Nota --------------------------- Accesso sequenziale alla struttura indici della prima Nota. Al termine saranno disponibili i seguenti dati: N. di Nodi (=Chiavi di accesso) presenti. Il numero di chiavi presenti è uguale al numero di registrazioni in Prima Nota inteso non come numero di linee registrate, ma come numero di giorni in cui c'è qualche linea registrata. La chiave di accesso è infatti la DATA di registrazione. Profondità dell'albero. Fornisce una indicazione del numero massimo di accessi alla struttura ad indici per accedere ad un dato. La struttura viene BILANCIATA ogni volta che gli indici vengono caricati in memoria, ovvero ogni volta che il programma viene avviato, per consentire l'accesso ai dati con il minimo numero di accessi in memoria. Memoria disponibile. Indica quanta parte della memoria centrale è ancora disponibile per la memorizzazione di indici. Se questa dato diventa troppo piccolo (minore di 1024 bytes) occorre USCIRE dal programma e farlo RIPARTIRE con una quantità maggiore di RAM disponibile (cfr. documentazione sul DOS). -------------------------------- Controllo indici Piano dei Conti -------------------------------- Accesso sequenziale alla struttura indici della prima Nota. Al termine saranno disponibili dati del tutto analoghi a quelli descritti per la funzione "Controllo indici Prima Nota" (cfr). La chiave di accesso, in questo caso, è il codice conto nel piano dei conti. ----------------------- Controllo integrità DB ----------------------- Attivando questa funzione il programma eseguirà una serie di controlli incrociati di integrità dei Data Bases. Eventuali anomalie verranno segnalate. Tali anomalie non dovrebbero MAI! verificarsi in quanto ciò implicherebbe un errore nel programma. Tuttavia in una simile evenienza è opportuno SALVARE il DB e contattare l'autore del programma. IMPORTANTE! In caso di anomalie bisogna immediatamente riportare la situazione all'ultimo backup attivando il programma con l'opzione -t (cfr. Sintassi di attivazione) ----- Setup ----- Le funzioni di Set Up hanno lo scopo di memorizzare in maniera permanente sul Data Base alcuni parametri di funzionamento del programma stesso. I valori di default si riferiscono ai valori che assume ognuno di questi parametri all'atto della creazione del Data Set. La creazione avviene, dopo la conferma dell'utente, quando il sistema non trova il DATA-SET nella directory specificata alla partenza. Per ognuno di questi parametri c'è una funzione in questo menu: - Intestazioni - Titolo menu principale È l'intestazione del menu principale, può essere cambiata così da poter riconoscere e distinguere un DATA-SET dall'altro con un semplice colpo d'occhio al momento in cui il programma viene attivato. Default='**** MENU PRINCIPALE ****' - Intestazione Stampe Tutte le funzioni di stampa hanno come prima linea del proprio output il contenuto di questo parametro. Default='Michele LIBERI, Via Fornaci 206/7, 35100 Padova. Tel 049-8933056' - Password setup Data l'importanza di questa funzione alla sua attivazione verrà richiesta la vecchia password. Alla partenza del sistema, se è stata impostata una password, questa verrà richiesta PRIMA di iniziare le operazioni. Per disabilitare questa funzione occorre impostare la password a '' (Stringa Vuota). Default=[stringa vuota] - Data Corrente È la data del giorno. Viene usata dal sistema per calcolare altri parametri per il corretto funzionamento delle funzioni di stampa, e proposta come default nella funzione di immissione o modifica di movimenti in prima nota (cfr), dalla funzione di cancellazione movimento in prima nota (cfr), dalla funzione di stampa dei movimenti in prima nota (cfr). Viene salvata insieme al data-set ed è indipendente da quella di sistema. Default= 1 Gen 1924 - Velocità scorrimento stampe È il valore utilizzato dalle funzioni di stampa per la velocità di scorrimento dei dati a video. Tale velocità di scorrimento può essere anche regolata durante lo scorrimento premendo i tasti da 0 (vel. massima) a 9 (vel. minima). Default=0 - Numero decimali per stampe Questo valore viene utilizzato da tutte le funzioni di stampa per impostare il numero di decimali dei numeri. Default=2 - Tasso Interesse su C/C Questo parametro viene utilizzato dalla funzione di calcolo degli interessi come valore da presentare come default. Default=8.25 - Conto CASSA Questo parametro viene utilizzato dalla funzione di Saldo Cassa (cfr) per accedere al Piano dei Conti - Colori È possibile memorizzare i colori di sfondo e dei caratteri per le schermate dei menu e quelle di lavoro. Per modificare i colori dei menu scegliere semplicemente le voci corrispondenti, per i colori delle schermate di lavoro comparirà una schermata di esempio e premendo i tasti freccia si potranno vedere a video direttamente i colori selezionati. ------------------------- Saldo Cassa - data ultima ------------------------- Con questa funzione è possibile avere, in modo sintetico ed immediato, i dati importanti dello stato dei lavori. Vengono visualizzati i seguenti dati: 1) il saldo del conto cassa 2) la data corrente 2) la data della prima registrazione in prima nota 3) la data dell'ultima registrazione in prima nota 4) la data dell'ultima chiusura di periodo ------------------------------ Riepilogo annuale dei guadagni ------------------------------ Attivando questa funzione vi troverete di fronte ad un prospetto riepilogativo delle entrate ed uscite nell'arco dell'anno. Potrete immettere i dati relativi ad ENTRATE ed USCITE complessive del mese muovendo il cursore ed immettendo le cifre come indicato nel paragrafo "Immissione di dati numerici". Tutti gli altri dati presenti nel prospetto verranno automaticamente ed immediatamente calcolati e visualizzati. ----------- Block Notes ----------- Come su un block notes cartaceo potrete scrivere i vostri appunti su impegni, scadenze, particolarità da ricordare sulle pagine di questo block notes elettronico. Ogni pagina occupa l'intero schermo del computer e su di essa si può scrivere come normalmente scrivete utilizzando un editor. Per i comandi di editing si fa riferimento alla sezione "Ingresso dei dati - Dati alfanumerici" (cfr). Sono attivi i seguenti comandi: up : sposta il cursore alla riga superiore down : sposta il cursore alla riga inferiore Alt-I : Inserisce una riga vuota alla posizione corrente. L'ultima riga della pagina verrà persa. Alt-D : Elimina la riga corrente dal block notes. Viene inserita una riga vuota in fondo alla pagina.

REFERENZE TECNICHE

Questa sezione è dedicata a chi voglia sapere in dettaglio come è organizzato il data base su cui si basa questo programma. ---------------------- Strutture dati interne ---------------------- In questo paragrafo tratteremo in dettaglio di come è strutturato il DATA-SET spiegando, campo per campo, come sono definiti i dat contenuti nei singoli file. Il programma è stato scritto utilizzando il Turbo Pascal per cui nel seguito useremo termini del Pascal per spiegare i tipi di dato contenute nei singoli record. PCVARS.C23: Questo file ha una importanza fondamentale perchè in esso è salvato lo STATO del programma e di alcuni parametri degli altri file. La sua stessa ESISTENZA è importante perchè dice al programma che il data set è stato correttamente salvato su disco. Infatti durante l'esecuzione del programma parte dei dati viene mantenuta in memoria per aumentare l'efficienza dell'intero sistema. Questi dati vengono scaricati sui file soltanto al termine delle operazioni. È un file che contiene i suoi dati in formato binario per cui è fortemente sconsigliato apportare una qualsivoglia modifica. In esso sono memorizzati i seguenti campi: Titolo menu principale Intestazione delle stampe Data corrente interna del sistema Data ultima chiusura di periodo Lista libera record cancellati in Prima nota Lista libera record cancellati nel piano dei conti Password di accesso crittografata La velocità di scorrimento delle stampe a Video Numero di decimali da usare nelle stampe Tasso default da usare per il calcolo di interessi C/C Codice per il conto CASSA Colori da usare per i menu, per la cornice Colori da usare per lo schermo di lavoro Riepilogo annuale dei guadagni Appunti del Block Notes PIACON.C23: Questo file contiene le singole entrate del piano dei conti. È un file di record ognuno dei quali ha il seguente formato: Deleted: Boolean; { Indicatore se cancellato } Pcic: STRING3; { Codice conto } Descr: STRING25; { Descrizione } Ep,Up,Ea,Ua: Real; { Entrate Uscite, periodo anno } Skp: Word { Puntatore al primo movimento nella scheda } PRIMNO.C23: Questo file contiene le singole registrazioni in prima nota. È un file di record ognuno dei quali ha il seguente formato: Deleted: Boolean; { Indicatore se cancellato } Data: Word; { data di registrazione } Cc: STRING3; { Codice conto } Desc_Pn: STRING25; { Descrizione Movimento } Nlire: Real; { Importo con segno del movimento } Nxt_Pn,Nxt_Sk: word { Puntatori } PIACON.CDX, PRIMNO.CDX: Questi file contengono gli indici di accesso ai dati dei file su menzionati. Vengono caricati in memoria alla partenza del sistema e ivi mantenuti fino al termine del programma. Ogni record indice è così definito: Key: Word; { Chiave di ricerca } Point: Word; { Puntatore all'informazione } L,R: Link { Puntatori interni } ------------------- Condizioni d'errore ------------------- Nonostante abbia posto la massima cura nel gestire le situazioni di possibile errore, ci sono situazioni in cui il programma non può fare correttamente il suo lavoro. Stampa un messaggio di errore ed esce. Ci sono due categorie di errori: gli errori che si verificano alla partenza del sistema e quelli che si verificano durante il funzionamento. La differenza è sostanziale in quanto nel primo caso non si ha MAI perdita di dati, nel secondo caso invece per ripristinare la situazione è necessario ripartire dall'ultimo salvataggio per cui i dati inseriti nell'ultima sessione di lavoro sono persi. Di seguito l'elenco dei possibili errori: ALLA PARTENZA: Memoria insufficiente: Ci sono meno di 100k liberi di RAM nella parte bassa ed il DOS non riesce a caricare il programma. Bisogna liberare memoria togliendo i programmi residenti. Troppi file aperti: Ci sono troppi file aperti ed il DOS non è in grado di soddisfare ulteriori richieste di apertura. Editare il file CONFIG.SYS ed inserire una linea FILES=xxx con xxx maggiore del valore precedentemente impostato. Non trovo C23.MNU: Il file che contiene la struttura dei menu non è nella stessa directory in cui risiede il programma C23.EXE. Spostare il file nella directory corretta. DURANTE IL LAVORO: Formato non corretto di PCVARS.C23: Il file è stato modificato o il disco è difettoso per cui il programma non riesce a leggere le variabili di stato correttamente. Heap Overflow Error: Il Programma ha utilizzato tutta la memoria disponibile. In caso di poca memoria disponibile, conviene tenere questo parametro sotto controllo. La quantità di memoria disponibile la si può rilevare mediante la funzione "Controllo indici ..." (cfr) Disk Write Error: Il programma ha cercato di scrivere su disco, ma non c'era più spazio. Anche in questo caso conviene tenere un margine di sicurezza sul disco che contiene il DATA-SET. Printer Error: Avviene quando la stampante viene spenta mentre il programma sta stampando. Arrivare a questa condizione è difficile in quanto il programma rileva se la stampante è non pronta PRIMA di iniziare a stampare. Se volete interrompere la stampa premete PRIMA il tasto ESC.

INDICE

INDICE pag Generalità ..........................................................1 Descrizione generale...............................................1 Requisiti Hardware e Software......................................3 Descrizione dei file...............................................4 Installazione......................................................5 Primo approccio al sistema...........................................6 Sintassi di attivazione............................................6 Selezione delle funzioni...........................................7 Ingresso dei dati..................................................8 Date.............................................................8 Campi numerici...................................................9 Campi alfanumerici...............................................9 Descrizione delle funzioni..........................................10 Gestione della prima nota.........................................10 Inserzione e Modifica Movimenti.................................11 Modifica descrizione schede.....................................12 Cancellazione movimenti.........................................12 Gestione del piano dei conti......................................13 Inserzione conto................................................14 Modifica conto..................................................14 Cancellazione conto.............................................14 Le stampe e visualizzazioni.......................................15 Prima Nota......................................................15 Stampa Registrazioni..........................................15 Ricerca per descrizione.......................................15 Piano dei conti.................................................15 Struttura del Piano dei Conti.................................15 Bilancio Analitico............................................16 Bilancio Annuale..............................................16 Bilancio di Periodo...........................................16 Schede Contabili................................................16 Stampa movimenti scheda contabile.............................16 Calcolo Interessi su scheda contabile.........................16 Prospetto consumi Benzina.....................................16 Prospetto Riepilogativo Annuale.................................17 Selezione FILE output...........................................17 Impostazione corrente ? ......................................17 Video.........................................................17 Standard output del DOS.......................................17 Stampante.....................................................17 File su disco.................................................17 Form Feed file output...........................................17 Chiusure..........................................................18 Chiusura di periodo.............................................18 Chiusura annuale................................................18 Controlli sul DATA-SET............................................19 Controllo PRIMA NOTA............................................19 Controllo PIANO DEI CONTI.......................................19 Controllo indici PRIMA NOTA.....................................19 Controllo indici PIANO DEI CONTI................................20 Controllo Integrità Data Base..................................20 Setup.............................................................21 Intestazioni....................................................21 Titolo menu principale........................................21 Intestazione Stampe...........................................21 Password........................................................21 Data Corrente...................................................22 Velocità scorrimento stampe....................................22 Numero decimali per stampe......................................23 Tasso Interesse su C/C..........................................23 Conto CASSA.....................................................23 Colori..........................................................23 Saldo Cassa - data ultima.........................................23 Riepilogo annuale dei guadagni....................................23 Block Notes.......................................................23 Referenze tecniche..................................................24 Strutture dati interne............................................24 Condizioni d'errore...............................................26 Indice..............................................................28

(c) M. Liberi, last updated: 2026-06-28