WikiUp

STRUTTURA

Il file B£TAPL0F

Si tratta di un file multimembro in cui ogni membro assume il nome del codice utente. Questo significa che ogni utente alimenta e gestisce una propria sezione del file. Il file viene generato nella libreria SMEUPUIDQ, temporanea... essa viene svuotata giornalmente da un processo schedulato che garantisce il contenimento dei dati. Ogni record del file viene identificato da tre elementi (chiave del file):

• Nome della trace (£TAPNom)
  
• Ora della trace (£TAPTim)
  
• Progressivo automatico
  

Il nome della trace è una semplice stringa descrittiva. L'ora se non impostata è quella all'atto di creazione della trace. Può essere forzata dall'esterno e può non essere un time, questo consente di sovrapporre ogni volta la trace alla sua precedente e di tenere su file solo l'ultima trace generata. Se nell'inizializzazione indico nella variabile £LOGTra il valore LOG attivo la stampa forzando per tale trace la condizione della tabella PGM per l'attivazione del log.

Variabili

• DS di input...
  
  • £TAPDI DS 2500
    
  • £TAPFU 10 Funzione
    
  • £TAPME 10 Metodo
    
  • £TAPNom 30 Nome stampa
    
  • £TAPTim 10 Tempo/Ora
    
  • £TAPLiv 30 Livello
    
  • £TAPTri 30 Tipo riga
    
  • £TAPTra 30 info extra!
    
  • £TAPPar 256 Attributi
    
  • £TAPStr 2048 Contenuto
    
• DS di output...
  
  • £TAPDO DS 12
    
  • £TAP35 1 Indicatori
    
  • £TAP36 1 "
    

Le variabili livello/tipo riga e parametri specificano la tipologia della trace.

Il livello consente di disporre le informazioni in maniera gerarchica. Le informazioni a livelli di profondità maggiore specificano le info dei livelli inferiori. Sono disponibili 6 livelli in tutto. E' previsto il livello '0' per reinizializzare la memoria... va usato alla prima chiamata di aggiunta riga di trace.

Si esemplifica ora come viene generato l'albero dei livelli. I nodi vengono agganciati al nodo precedente di livello superiore. Si ponga di aver creato la seguente sequenza di livelli:

• aggiunta nodo di Livello 1
  
• aggiunta nodo di Livello 2
  
• aggiunta nodo di Livello 2
  
• aggiunta nodo di Livello 2
  
• aggiunta nodo di Livello 1
  
• aggiunta nodo di Livello 2
  
• aggiunta nodo di Livello 3
  
• aggiunta nodo di Livello 3
  
• aggiunta nodo di Livello 1
  
• aggiunta nodo di Livello 2
  

Si otterrà quindi:

La struttura dell'albero generato non dipende quindi da proprietà di tipo dinamico, ma semplicemente dall'ordine di sequenza con cui vengono aggiunti i livelli.

Il tipo riga serve a qualificare la tipologia di informazione.

Gli attributi assegnano a ciascuna riga una proprietà in base alla quale è possibile eseguire dei filtri sui record. La sintassi per l'assegnazione di un attributo è la seguente:

EVAL £TAPPar='NomeAttributo'.TpParam=' "Valore" '

- 'NomeAttributo' | stringa che indica il nome a piacere per l'attributo che verrà visualizzato nella scheda del Trace'n play
- TpParam | Tipo ed eventuale parametro di un oggetto SMEUP corrispondente all'attributo
- ' "Valore" ' | Stringa racchiusa tra " che contiene il valore dell'attributo associato alla riga

E' possibile specificare più attributi per record (come da esempio) accodando gli attributi separati da spazio.

Si indica il Livelli, tipo riga e attributi sono poi usati come filtri nel servizio di analisi della trace su LoocUp.

FUNZIONI e METODI

Di seguito l'elenco dei metodi e delle funzioni previste dalla Trace:

• LOG Gestione Log
  
  • INI Inizializzazione
    
  • CLO Chiusura
    
  • ADD Aggiunta riga di log
    
• DEL Cancellazione
  
  • ALL Tutto
    
  • NAM Per nome stampa
    
  • TIM Per ora
    

E chiaro che la visibilità delle azioni suddette sul file è relativa solo al proprio sottomembro utente di accesso.

Esempi di chiamata:

Creazione/Chiusura/Eliminazione log

Aggiunta righe log