At line 1 added 189 lines |
%%(display:none) |
{{{ |
WikiUp |
}}} |
/% |
[{TableOfContents }]\\ |
!!! COPY PREVISTE NELLA FUNZIONE <£DMS> . . 3\\ |
!!! OBIETTIVO\\ |
Avvicinare l'UTENTE FINALE alla diagnostica applicativa, uno strumento che se ben utilizzato aiuta a capire meglio i |
problemi che la gestione del Sistema Informativo Aziendale puo' causare. |
Per poter realizzare l'obbiettivo la funzione £DMS e' stata applicata a due diverse aree e precisamente: |
- All'elaborazione dei dati in modo interattivo |
All'UTENTE FINALE verra' fornita una completa e dettagliata informazione sulla messaggistica applicativa evidenziata |
dai controlli formali effettuati sui dati immessi a video. |
- All'elaborazione dei dati in modo differito; |
Le funzioni utilizzate in modo differito avranno un tabulato che segnalera' all'UTENTE |
FINALE le anomalie riscontrate durante l'elaborazione dei dati. |
N.B. Il tabulato potra' elencare fino ad un massimo di 100 anomalie per elaborazione. |
!!! FUNZIONI\\ |
B£DMS1CL reperimento messaggio |
B£DMS1 visualizzazione messaggi |
Un programma interattivo a finestre per la visualizzazione dei messaggi di primo livello,da dove e' possibile |
richiamare per ognuno diessi il messaggio di secondo livello. |
- finestra messaggi di primo livello |
- finestra messaggi di sec. livello |
. COMANDO OS/400 "CHGMSGD" |
Record video per la manutenzione del messaggio e dei suoi attributi. La manutenzione e' permessa solo ad utenti con |
classe *PGMR o *QSECOFR. |
B£DMS2 stampa messaggi |
Un programma batch per segnalare le anomalie riscontrate durante l'elaborazione differita dei dati. |
!!! COPY PREVISTE NELLA FUNZIONE <£DMS>\\ |
£DMSE Definizione delle schiere di lavoro |
£DMSI Definizione delle variabili di lavoro |
£DMS Composta dalle seguenti routine: |
£DMSC1 |
Dichiarazione e inizializzazione delle variabili |
2 £DMSC2 |
Se il reperimento avviene da Msgf AS/400: |
Memorizzazione del messaggio e del Msgf in £D1 |
Memorizzazione dei valori associati al messaggio in £D2 |
Se il reperimento avviene da Pgm RPG: |
Memorizzazione del codice messaggio (PGM) in £D1 |
Memorizzazione del testo del messaggio (PGM) in £D3 |
3 £DMSC3 |
Visualizzazione o stampa dei messaggi memorizzati |
4 £DMSC4 |
Visualizzazione del primo messaggio applicativo memorizzato |
5 £DMSC5 |
Reperimento messaggi applicativi 6 £DMSC6 |
Concatenazione automatica variabili variabili associate al messaggio |
!!! COME UTILIZZARE LA FUNZIONE\\ |
1) Dichiarare: |
. con la COPY £DMSE le schiere di lavoro; |
. con la COPY £DMS le strutture necessarie al funzionamento, che sono qui brevemente riassunte: |
la routine di inizializzazione delle |
variabili; |
2 la routine di memorizzazione; 3 la routine di gestione a video o su stampa dei messaggi memorizzati; |
4 la routine di gestione a video del primo messaggio di errore; |
(Solo per applicazioni interattive) 5 la routine di reperimento del messaggio applicativo messaggio di errore; 6 la |
routine di concatenazione delle variabi- li associate al messaggio di errore |
2) Richiamare la routine di inizializzazione delle variabili di lavoro: |
. Se si sta sviluppando una funzione BATCH, la routine andra' richiamata una sola volta e dall'inizio del programma, |
nella fase delle operazioni preliminari. |
. Se si sta sviluppando una funzione ON LINE, la routine andra' richiamata ogni volta che si inizieranno per la |
videata in gestione, i con trolli formali sui dati immessi a video. |
3) Ad ogni anomalia, con il richiamo alla apposita routine, si memorizzera'il messaggio e le sue caratteristiche. |
4) Infine: |
. Per i programmi ON LINE: |
Dopo aver effettuato i controlli, sara' richiamata la routine per l'emissione del primo messaggio di errore. |
Solo a richiesta dell'UTENTE FINALE, (per esempio attraverso un tasto comando) sara' richiamata la routine per la |
gestione interattiva dei messaggi. |
(Preimpostando il parametro di entrata con il valore ONLINE "V"). |
. Per i programmi BATCH: |
La routine per la stampa dei messaggi, sara'richiamata una sola volta e alla fine dell'elaborazione. |
(Preimpostando il parametro di entrata con il valore BATCH "S"). |
!!! DATI TECNICI SULLE STRUTTURE\\ |
. COPY ----> £DMSE |
Sono definite tutte le schiere di lavoro. |
£D1: |
Numero elementi....: 100 da 17 bytes |
Struttura elemento.: CCCCCCCMMMMMMMMMM (C=Codice messaggio (Dalla 1 alla 7)) (M=Message file AS/400 (Dalla 8 alla |
17)) |
Esempio: |
....5...10.....17 |
BAS0020MSGBA |
BAS0030MSGBA |
£D2: |
Numero elementi....: 100 da 45 bytes |
Struttura elemento.: nn XXXX nn XX .. |
(nn= lunghezza fisica variabile) (X = Variabile) |
Regola inserimento.: |
. nn |
(Spazio + dimensione a due caratteri) |
. XXXX |
(Spazio + Variabile) |
(Dalla 1 alla 45) |
Esempio: |
nn XXXXXX nn XXXXXXXXXXXXXXX |
921010 30 SMEUP |
....5...10...15...20...25...30...35...40...45 |
06 921020 30 SANTA ROMEA SPA |
£D3: |
Numero elementi....: 100 da 80 bytes |
Struttura elemento.: PGMnnnnXXXXX...........X (PGM=I primi 3 caratteri dovranno essere sempre 'PGM'; cio' servira' |
alle routines per identificare un messaggio gestito internamente al programma) |
(nnnn=Saranno i caratteri identificativi del messaggio d'errore; Per default farli coincidere con la posizione del |
messaggio all'interno della schiera) |
(X..X=Sara' il vero e proprio testo di errore) |
Esempio: |
....5...10...15...20...25...30...35...40...45 |
PGM0001Codice non trovato in archivio |
PGM0002Data formalmente errata |
. COPY ----> £DMSI |
Sono definite le variabili di lavoro. |
. £DMS1M |
(Testo 1° messaggio di errore) |
. £DMS1L |
(Messaggio di 1° livello restituito dalla retrive) |
. £DMS2L |
(Messaggio di 2° livello restituito dalla retrive) |
. £DMSST |
(Concatenazione variabili associate al singolo messaggio) |
. COPY ----> £DMSC1 |
E' la routine di inizializzazione delle variabili. |
£D: |
Puntatore elemento di schiera. |
£D1: |
Schiera codice messaggio. Se il reperimento avviene da un Membro messaggi AS/400 contiene anche il rispettivo Msgf. |
£D2: |
Schiera valori associati al messaggio. |
Utilizzata solo se il reperimento avviene da un membro messaggi AS/400. |
£D3: |
Schiera codici e testi messaggi di errore. |
Utilizzata solo se il reperimento avviene dall'interno di un pgm RPG. |
£DMSNR |
Valore incrementato ad ogni registrazione, per sovrapporlo poi al puntatore £D ogni qualvolta si voglia indicare un |
elemento di schiera. |
£DMSTP |
Tipo reperimento messaggio (Da Msgf o da Pgm). |
Se i primi 3 bytes sono uguali a 'PGM', rilevo la descrizione del messaggio dalla schiera dichiarata internamente al |
programma. |
£DMSTR |
Tipo retrive da Msgf: |
G= Senza passaggio delle variabili. |
(Programmatore). |
X= Con passaggio delle variabili. |
(Utente). |
£DMSME |
Codice messaggio da reperire e memorizzare. |
£DMSVA |
Stringa di valori da associare al messaggio da memorizzare. |
£DMSEL |
Contiene la descrizione del messaggio reperito opportunamente dall'elemento di schiera. |
Attenzione !! |
Il valore di questo campo determina il reperimento da pgm RPG anziche'da Msgf. |
£DMSVS |
Indica se l'elaborazione dei messaggi memorizzati deve essere interattiva (V=a video) oppure diffe- rita (S=su |
stampa). |
£DMSFI |
Nome del Message file AS/400 da dove reperire il messaggio e i suoi attributi. |
Se si sta utilizzando un messaggio definito internamente al programma, questa variabile deve essere formattata a |
blanks. |
. COPY ----> £DMSC2 |
E'la routine di memorizzazione. |
In ingresso deve ricevere: |
1) Codice del messaggio (Obbligatorio) |
2) Nome del Message File AS/400 (Obbligatorio se non e' definito un Msgf di default) |
3) Stringa di valori da associare al messaggio (Facoltativo; utilizzabile solo se il reperimento avviene da un membro |
Messaggi |
AS/400) |
. COPY ----> £DMSC3 |
E' la routine di gestione a video o su stampa dei messaggi memorizzati; |
In ingresso deve ricevere obbligatoriamente: |
1) Il parametro guida per elaborare i messaggi memorizzati o in modo ON LINE o in modo BATCH. |
. COPY ----> £DMSC4 |
E' la routine di emissione a video, del primo messaggio di errore. |
In ingresso non riceve nessun parametro |
In uscita restituisce: |
£DMS1M |
Codice messaggio |
£DMS1L |
Testo di primo livello |
£DMS2L |
Testo di secondo livello |
(Solo se reperimento da message file) |
. COPY ----> £DMSC5 |
E' la routine di reperimento messaggi applicativi da Message file AS/400. |
. COPY ----> £DMSC6 |
E' la routine di concatenazione automatica variabili associate al messaggio file AS/400. |