| 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. |
