Log di sistema¶
Panoramica¶
Il sistema di log di Eurocoge traccia le operazioni su tre livelli:
- Log di processo (LOGPROC) — eventi applicativi generati dai programmi durante l'esecuzione: accessi, messaggi, errori, segnalazioni
- Log su archivi (LOGAGREC/LOGAGFLD) — variazioni puntuali sui record e sui singoli campi delle tabelle soggette a log
- Log generale (VIEWLOGG) — vista unificata e cronologica di tutti i tipi di log per un operatore/postazione
| Programma | Righe | Funzione |
|---|---|---|
| LOGPROC1 | 3.454 | Log di processo — dettaglio |
| LOGPROC2 | 1.632 | Log di processo — sintesi |
| GESLOG1 | 2.233 | Log variazione archivi |
| GESLOG2 | — | Dettaglio variazione record |
| GESLOG3 | 1.947 | Log variazione campo |
| GESLOG4 | 1.375 | Cancellazione/pulizia log |
| GESLOG5 | 2.229 | Log generale su arco temporale |
| CLEARLOG | — | Cancellazione schedulata log (batch) |
Menu: Sistema > Utility > Log
Archivi coinvolti¶
LOGAGREC — Log variazioni sui record¶
Registra un record per ogni operazione (inserimento, modifica, cancellazione) su un record di una tabella soggetta a log.
| Campo | Tipo | Descrizione |
|---|---|---|
| LGR-FILE | X(20) | Nome file/tabella |
| LGR-ID-RECORD | 9(12) | Id progressivo del record (raccordo via LOGIDREC) |
| LGR-DATA | 9(08) | Data operazione (YYYYMMDD) |
| LGR-ORA | 9(08) | Ora operazione (HHMMSSCC) |
| LGR-OPERAZIONE | X(01) | "I"=Inserimento, "M"=Modifica, "C"=Cancellazione |
| LGR-OPERATORE | 9(05) | Codice operatore |
| LGR-PROGRAMMA | X(08) | Programma che ha eseguito l'operazione |
| LGR-POSTAZIONE | X(08) | Postazione di lavoro |
| LGR-ESEGUITO | X(01) | "S" = elaborato/eseguito |
Chiavi di accesso:
| Chiave | Composizione | Uso |
|---|---|---|
| LGR-CHIA1 (primaria) | FILE + ID-RECORD + DATA + ORA | Modifiche progressive su un record |
| LGR-CHIA2 | OPERATORE + DATA + ORA + FILE + ID-RECORD | Modifiche per operatore in ordine cronologico |
| LGR-CHIA3 | FILE + DATA + ORA + ID-RECORD | Modifiche cronologiche su un file |
LOGAGFLD — Log variazioni sui singoli campi¶
Registra il valore di ogni campo modificato, associato all'operazione in LOGAGREC.
| Campo | Tipo | Descrizione |
|---|---|---|
| LFL-FILE | X(20) | Nome file/tabella |
| LFL-ID-RECORD | 9(12) | Id progressivo del record |
| LFL-ID-FLD | 9(04) | Id campo (definito in SCRMAPDB) |
| LFL-DATA | 9(08) | Data operazione |
| LFL-ORA | 9(08) | Ora operazione |
| LFL-DATO-LEN | 9(04) | Lunghezza del dato memorizzato |
| LFL-DATO | X(var) | Contenuto del campo dopo la modifica (max 2000 byte) |
Chiavi di accesso:
| Chiave | Composizione | Uso |
|---|---|---|
| LFL-CHIA1 (primaria) | FILE + ID-RECORD + ID-FLD + DATA + ORA | Modifiche progressive su un campo |
| LFL-CHIA3 | FILE + ID-RECORD + DATA + ORA + ID-FLD | Modifiche cronologiche su un record |
LOGIDREC — Raccordo chiave-id¶
Associa un id progressivo numerico a ciascun record di una tabella, per ridurre la dimensione delle chiavi in LOGAGREC e LOGAGFLD.
| Campo | Tipo | Descrizione |
|---|---|---|
| LRR-FILE | X(20) | Nome file/tabella |
| LRR-ID | 9(12) | Id progressivo assegnato |
| LRR-CHIAVE | X(200) | Chiave reale del record |
Chiavi di accesso:
| Chiave | Composizione | Uso |
|---|---|---|
| LRR-CHIA1 (primaria) | FILE + ID | Ricerca per id |
| LRR-CHIA2 | FILE + CHIAVE | Ricerca per chiave reale |
LOGPROC — Log su processi¶
Registra eventi di processo: accessi a funzioni, messaggi, segnalazioni, errori.
| Campo | Tipo | Descrizione |
|---|---|---|
| LPRC-DATA | 9(08) | Data operazione |
| LPRC-ORA | 9(08) | Ora operazione (HHMMSSCC) |
| LPRC-PROGRAMMA | X(20) | Programma che ha generato l'evento |
| LPRC-OPERATORE | 9(05) | Codice operatore |
| LPRC-POSTAZIONE | X(08) | Postazione di lavoro |
| LPRC-PROG | 9(04) | Progressivo (disambigua operazioni nello stesso centesimo) |
| LPRC-PROCEDURA | X(30) | Procedura collegata all'evento |
| LPRC-PROCEDURA-PADRE | X(30) | Procedura padre |
| LPRC-ID-PROCESSO | 9(08) | Id processo server |
| LPRC-STATION-ID | X(12) | Station id |
| LPRC-CLIENT | X(30) | Nome client + id processo client |
| LPRC-MACHINE-NAME | X(30) | Nome macchina |
| LPRC-DOC1-TIP | X(04) | Tipo documento principale |
| LPRC-DOC1-KEY | X(30) | Chiave documento principale |
| LPRC-DOC2-TIP | X(04) | Tipo documento secondario |
| LPRC-DOC2-KEY | X(30) | Chiave documento secondario |
| LPRC-TIPO | X(01) | Tipo segnalazione (vedi sotto) |
| LPRC-LIVELLO | 9(05) | Livello segnalazione (riservato) |
| LPRC-MSG-LEN | 9(04) | Lunghezza messaggio |
| LPRC-DEEP-PROC | 9(02) | Livello profondita' procedura annidata |
| LPRC-MSG | X(var) | Testo del messaggio (max 2000 byte) |
Tipi di segnalazione (LPRC-TIPO):
| Codice | Significato |
|---|---|
| I | Informazione |
| W | Errore non grave (warning) |
| E | Errore grave |
| S | Critico di sistema (segnalazione a Eurosystem2000) |
| C | Critico per cliente (segnalazione a cliente) |
| A | Richieste a video |
| M | Messaggi non critici |
| R | Report: segnalazioni da evidenziare su un'elaborazione |
Tipi documento utilizzati (DOC1-TIP, DOC2-TIP):
| Codice | Descrizione |
|---|---|
| AI | Intervento di assistenza |
| AC | Chiamate di assistenza |
| DMC | Documenti di magazzino a cliente |
Log di processo — LOGPROC1 / LOGPROC2¶
LOGPROC2 — Sintesi¶
Consultazione dei log di processo con filtri di ricerca.
Menu: Sistema > Utility > Log > Log di processo > Sintesi
LOGPROC1 — Dettaglio¶
Audit trail dettagliato con tracking campo per campo (usa LOGAGFLD e LOGIDREC).
Menu: Sistema > Utility > Log > Log di processo > Dettaglio
Dispone anche di una funzione "log generale" che riassume in ordine cronologico le operazioni di un singolo utente in un arco temporale, cercando su tre tipologie di log:
- Log di accesso a funzioni
- Log di procedura
- Log di aggiornamento tabella
Log variazione archivi — GESLOG1¶
Funzionalita'¶
Consultazione delle modifiche effettuate sulle tabelle soggette a log. Supporta tre modalita' di ricerca:
- Per chiave diretta — tutti gli aggiornamenti di un singolo record
- Per inizio chiave ("inizia per...") — aggiornamenti di un insieme di record con chiave parziale
- Tutti i record di un file in un arco temporale
Filtri¶
| Filtro | Obbligatorio | Descrizione |
|---|---|---|
| Archivio | Si' | Nome tabella (10 caratteri) |
| Chiave | No | Chiave di ricerca (fino a 200 caratteri). F8=aiuto ACCKEY per composizione guidata |
| Operatore | No | Codice operatore che ha eseguito la modifica |
| Periodo aggiornamento | No | Da data / a data |
| Operazione | No | Inserimento / Modifica / Cancellazione / Tutto |
Griglia risultati¶
| Colonna | Provenienza |
|---|---|
| Id record | LGR-ID-RECORD |
| Chiave record | LRR-CHIAVE (da LOGIDREC) |
| Data | LGR-DATA |
| Ora | LGR-ORA (HH:MI:SS:CC) |
| Operatore | LGR-OPERATORE (codice + descrizione) |
| Programma | LGR-PROGRAMMA |
| Postazione | LGR-POSTAZIONE |
| Operazione | LGR-OPERAZIONE (I/M/C) |
Tasti funzione¶
- F8 Dettaglio — apre GESLOG2 per il dettaglio dei campi variati sul record selezionato
- F5 Analisi — apre GESLOG5 con l'operatore/postazione della riga selezionata e un arco temporale di +/- 2 secondi attorno all'ora dell'evento
Elaborazione¶
La ricerca su LOGAGREC avviene su chiavi diverse a seconda del filtro:
| Modalita' | Chiave usata | Note |
|---|---|---|
| Chiave diretta | LGR-CHIA1 | Usa LGR-ID-RECORD ottenuto da LOGIDREC |
| "Inizia per" | LRR-CHIA2 su LOGIDREC | Per ogni id trovato, posiziona su LOGAGREC via LGR-CHIA1 |
| Senza chiave (tutti i record) | LGR-CHIA2 oppure LGR-CHIA3 | Filtro su periodo richiesto |
Dettaglio variazione record — GESLOG2¶
Funzionalita'¶
Mostra il dettaglio delle variazioni di tutti i campi per una specifica operazione su un record. Riceve in input: nome file, id record, data e ora aggiornamento.
Testata (read-only)¶
Archivio, chiave, operatore (codice + descrizione), programma, postazione, data/ora aggiornamento.
Griglia risultati¶
| Colonna | Provenienza |
|---|---|
| Id campo | LFL-ID-FLD |
| Nome campo | Da SCRMAPDB (FDB-FILE + FDB-PROG) |
| Descrizione | FDB-ETICHETTA (da SCRMAPDB) |
| Dato precedente | LFL-DATO del record precedente in LOGAGFLD |
| Dato attuale | LFL-DATO del record corrente in LOGAGFLD |
Elaborazione¶
- Scorre SCRMAPDB su FDB-CHIA2 per tutti i campi del file
- Per ogni campo, cerca in LOGAGFLD via LFL-CHIA1 il record corrispondente a data/ora in input
- Se il record esiste, aggiunge una riga in griglia con il "dato attuale"
- In un secondo passaggio, per ogni riga cerca il record precedente in LOGAGFLD per ottenere il "dato precedente"
Conversione tipi dato¶
La visualizzazione del contenuto dei campi dipende dal tipo dato registrato in SCRMAPDB:
| Tipo | Descrizione | Formato visualizzazione |
|---|---|---|
| 01 | Alfanumerico | Cosi' com'e' |
| 16 | Numerico standard | zzz.zzz.zzz.zzz,zzzzzz- (blank when zero) |
| 03 | Numerico segnato | Come tipo 16 |
| 12 | comp-4 | Conversione via CONVCOMP, poi come tipo 16 |
| 11 | comp-4 con segno | Come tipo 12 |
| DT | Data | GG/MM/AAAA |
| H1 | Ora 4 cifre | HH:MI |
| H2 | Ora 8 cifre | HH:MI:SS:CC |
F8 Dettaglio — apre GESLOG3 per lo storico del singolo campo selezionato.
Log variazione campo — GESLOG3¶
Funzionalita'¶
Consultazione dello storico di modifiche su un singolo campo di un archivio. L'ordinamento principale e' per data/ora aggiornamento.
Filtri¶
| Filtro | Obbligatorio | Descrizione |
|---|---|---|
| Archivio | Si' | Nome tabella (10 caratteri) |
| Chiave | Si' | Chiave di ricerca (fino a 200 caratteri) |
| Campo | Si' | Nome campo (UPPER) |
| Periodo aggiornamento | No | Da data / a data |
Griglia risultati¶
| Colonna | Provenienza |
|---|---|
| Id campo | LFL-ID-FLD |
| Nome campo | Da SCRMAPDB |
| Data | LFL-DATA |
| Ora | LFL-ORA (HH:MI:SS:CC) |
| Operatore | LGR-OPERATORE (da LOGAGREC) |
| Programma | LGR-PROGRAMMA |
| Postazione | LGR-POSTAZIONE |
| Operazione | LGR-OPERAZIONE (I/M/C) |
| Dato | LFL-DATO (visualizzato come in GESLOG2) |
Elaborazione¶
L'elaborazione passa per un file di transito. La ricerca su LOGAGFLD varia in base ai filtri:
- Se indicato il campo: scorre LFL-CHIA1 filtrando sul campo richiesto
- Se non indicato il campo: scorre LFL-CHIA3 filtrando sul periodo
Per ogni record letto si posiziona su LOGAGREC per recuperare operatore, programma e operazione.
Log generale su arco temporale — GESLOG5¶
Funzionalita'¶
Consultazione di tutti gli aggiornamenti su tutte le tabelle soggette a log in un determinato arco temporale, filtrati per operatore e postazione.
Caso d'uso tipico: un aggiornamento anomalo viene rilevato su una tabella; con GESLOG5 si isola un arco temporale ristretto per individuare l'insieme delle modifiche effettuate dallo stesso operatore/postazione.
Filtri (tutti obbligatori)¶
| Filtro | Descrizione |
|---|---|
| Operatore | Codice operatore |
| Postazione | Codice postazione |
| Data aggiornamento | Data da esaminare |
| Arco temporale | Da ora ... a ora (HH:MI:SS:CC) |
Griglia risultati¶
Identica a GESLOG1, con l'aggiunta della colonna File (LGR-FILE).
Elaborazione¶
Ricerca su LOGAGREC via LGR-CHIA2 (operatore + data + ora), poi filtro sulla postazione indicata. Creazione del file di transito e visualizzazione.
F8 Dettaglio — apre GESLOG2 per il dettaglio dei campi variati.
Cancellazione log — GESLOG4¶
Funzionalita'¶
Pulizia dei log di una singola tabella o di tutte le tabelle loggate. Supporta due criteri temporali in alternativa:
- Periodo — cancella i log relativi a un intervallo di date
- Giorni da lasciare — mantiene solo gli ultimi N giorni di log
Se nessun criterio temporale e' indicato, cancella tutto.
Filtri¶
| Filtro | Obbligatorio | Descrizione |
|---|---|---|
| Archivio | No | Nome tabella (10 caratteri). Se vuoto, tutte le tabelle |
| Periodo | No | Da data / a data |
| Giorni da lasciare | No | Alternativo al periodo |
| Solo modifiche senza aggiornamenti | No | Se spuntato, cancella solo le operazioni "Modifica" senza variazione di campi |
Contatori (read-only)¶
- Id record esaminati
- Id record cancellati
- Log record cancellati (LOGAGREC)
- Log campi cancellati (LOGAGFLD)
I contatori si aggiornano ogni 1.000 cancellazioni su LOGAGREC.
Modalita' di chiamata¶
GESLOG4 puo' essere chiamato da altri programmi via linkage:
| Campo linkage | Descrizione |
|---|---|
| GESLOG4-CALLED | "GESLOG4" |
| GESLOG4-CALLER | Nome programma chiamante |
| GESLOG4-OPERAZIONE | "CANCELLA" = interattivo, "CANCELLA-SILENT" = batch senza interazione |
| GESLOG4-FILE | Nome logico del file |
| GESLOG4-GIORNI | Numero giorni da mantenere |
La modalita' "CANCELLA-SILENT" e' progettata per l'esecuzione da schedulatore (COGSKP) tramite CLEARLOG.
Cancellazione schedulata — CLEARLOG¶
Programma batch (non a menu) che automatizza la pulizia periodica dei log. Puo' essere innescato da LANCIO o dallo schedulatore COGSKP.
Elaborazione¶
- Cancellazione log archivi: scorre COGFILES; per ogni file con FIL-LOG = "X" e FIL-GIORNI-LOG > 0, chiama GESLOG4 in modalita' "CANCELLA-SILENT"
- Cancellazione log procedura: chiama GESLPRC passando il numero di giorni configurati (giorni-log-processo)
VIEWLOGG — Consultazione generale log¶
Funzionalita'¶
Vista unificata e cronologica di tutte le operazioni effettuate da un singolo utente, aggregando tre tipologie di log:
- Log di accesso a funzioni
- Log di procedura
- Log di aggiornamento tabella
L'utilita' di questa funzione e' proporzionale al numero di log attivi nel sistema.
Filtri (tutti obbligatori)¶
| Filtro | Descrizione |
|---|---|
| Operatore | Codice operatore |
| Postazione | Codice postazione |
| Periodo | Da data/ora a data/ora |
Griglia risultati¶
L'area di dettaglio contiene un componente ad albero e una griglia con le seguenti colonne:
| Colonna | Ambito | Descrizione |
|---|---|---|
| Data evento | Tutti | Data di registrazione |
| Ora evento | Tutti | Ora di registrazione |
| Programma | Tutti | Nome programma che ha generato l'evento |
| Operatore | Tutti | Codice operatore |
| Postazione | Tutti | Codice postazione |
| Prog | Processo | Progressivo di registrazione |
| Procedura | Processo | Nome procedura collegata |
| Procedura padre | Processo | Nome procedura padre |
| Id processo | Processo | Id processo server |
| Station id | Processo | Station id |
| Client | Processo | Nome client + id processo client |
| Machine name | Processo | Nome macchina |
| Tipo documento 1 | Processo | Tipo documento principale (vedi tipi documento) |
| Chiave documento 1 | Processo | Chiave documento principale |
| Tipo documento 2 | Processo | Tipo documento secondario |
| Chiave documento 2 | Processo | Chiave documento secondario |
| Tipo segnalazione | Processo | I/W/E/S/C/A/M/R |
| Messaggio | Processo | Testo dell'evento |
F3 Gestione — quando la registrazione e' collegata a un documento, apre il documento in gestione.
Relazioni tra archivi¶
SCRMAPDB (mappa campi)
|
v
LOGIDREC ---------> LOGAGREC ---------> LOGAGFLD
(chiave reale (1 record per (1 record per campo
-> id numerico) operazione modificato per
su un record) operazione)
LOGPROC
(eventi di processo,
messaggi, segnalazioni)
Il flusso di scrittura log e' gestito dai programmi applicativi: ogni operazione su una tabella soggetta a log genera un record in LOGAGREC e, per le modifiche, un record in LOGAGFLD per ogni campo variato. LOGIDREC funge da indice di raccordo tra la chiave reale del record e l'id numerico usato in LOGAGREC/LOGAGFLD, per contenere la dimensione dei file di log.