Questi documenti vengono generati automaticamente dal sistema con la scansione dei sorgenti cmd, bat e job. Si veda src.job: Script Batch. I documenti job vengono prodotti se è presente il tag @job nella descrizione del sorgente. Si veda anche Scansione Testata dei Job. Il documento job rappresenta la visione utente del lavoro. La visione tecnica viene mantenuta nel documento src. Trattandosi di documenti automatici è, come sempre, buona norma limitare la complessità delle descrizioni utilizzando i link per agganciare documenti più completi. Gli argomenti che devono essere affrontati sono:
- Gli obiettivi e la logica del lavoro vengono normalmente documentati facendo riferimento a:
- Requisiti di vario genere.
- Funzioni del Disegno Logico.
- File prodotti
- Stampe prodotte.
- Caratteristiche operative del lavoro che riguardano essenzialmente:
- Chi dovrebbe lanciare il lavoro.
- Quando dovrebbe essere lanciato il lavoro.
- Cosa fa il lavoro
- Quanto dura, o per lo meno come si rapporta la sua durata.
- Quali conflitti esistono con altri lavori.
- Cosa bisogna fare in caso di caduta.
Vi sono due possibili livelli di documentazione:
- 1° livello: Creare la descrizione del lavoro e in particolare:
- I link funzionali.
- Modalità operative, con particolare cura sul restart.
- 2° livello: Completare la descrizione del lavoro:
- Link alle mappe relative ai parametri di lancio.
- Link ai file prodotti.
- Link alle stampe prodotte.
I link verso comprendono i seguenti dcl:
- dsg, disegno funzionale. In genere si tratta di collegare uno o più documenti che riportano la logica funzionale che il lavoro implementa.
- uui, gestione utente del job.
- uui, parametri di lancio.
- daf, files prodotti.
- rpt, stampe prodotte.
I link da comprendono i seguenti dcl:
- dst, documentazione tecnica del job.
- uui, voce di menu che lo esegue.
Non sono migrabili
e-mail