GESLPRC - Aggiornamento log processi¶
Posizione nel menu Programma non a menu Linkage section
| Tipo | Dato | Formato | Contenuto |
|---|---|---|---|
| INPUT | GESLPRC-OPE | x(20) | Operazione da eseguire |
| GESLPRC-PROGRAMMA | x(20) | Nome programma che genera l'evento Se non fornito corrisponde al programma chiamante |
|
| GESLPRC-DOC1-TIP | x(04) | Tipo di documento principale collegato | |
| GESLPRC-DOC1-KEY | x(30) | Chiave documento principale collegato | |
| GESLPRC-DOC2-TIP | x(04) | Tipo di documento secondario collegato | |
| GESLPRC-DOC2-KEY | x(30) | Chiave documento secondario collegato | |
| GESLPRC-MSG | x(2000) | Messaggio | |
| GESLPRC-TIPO | x(01) | Tipo di segnalazione: |
|
| GESLPRC-LIVELLO | 9(01) | Per ora non usato | |
| GESLPRC-PROCEDURA | x(30) | ID Procedura; permette di indicare la procedura che raggruppa più eventi Se non indicato si può assegnare automaticamente con l'operazione apposita |
|
| GESLPRC-DATA | data | Usato per la pulizia del log | |
| GESLPRC-WHEN-COMPILED | x(25) | Contiene il parametro "WHEN-COMPILED" del programma chiamante, e dovrebbe essere registrato all'interno del messaggio sui record di apertura procedura | |
| OUTPUT | GESLPRC-O-DISPONIBILE | x(01) | Restituisce se il log principale indicizzato è disponibile: |
| FILLER | x(500) |
Logica generale Questa routine serve per eseguire la gestione del log di processo (tabella LOGPROC - Log segnalazioni su programmi/procedure) Elaborazione
Operazione: "APRI-PROCEDURA"¶
Descrizione Permette di definire il nome procedura da utilizzare. Se non fornito sarà definita come "programma-data-ora" Chiamata standard
| Dato | Contenuto |
|---|---|
| GESLPRC-OPE | "APRI-PROCEDURA" |
| GESLPRC-PROGRAMMA | Nome programma che genera l'evento Se non fornito corrisponde al programma chiamante |
| GESLPRC-PROCEDURA | Nome procedura da aprire |
| GESLPRC-MSG | Eventuale messaggio di apertura |
Elaborazione Se la procedura non viene passata in input, sarà calcolata automaticamente. Se esiste già una procedura attiva, questa diventerà "procedura padre" (la catena delle procedure sarà memorizzata in una tabella di 100 elementi). Il messaggio standard sarà "Apertura procedura"; se viene passato in input un messaggio sarà accodato.
Operazione: "SCRIVI"¶
Descrizione Memorizzazione di una riga evento Chiamata standard
| Dato | Contenuto |
|---|---|
| GESLPRC-OPE | "SCRIVI" |
| GESLPRC-PROGRAMMA | Nome programma che genera l'evento Se non fornito corrisponde al programma chiamante |
| GESLPRC-DOC1-TIP | Tipo di documento principale collegato |
| GESLPRC-DOC1-KEY | Chiave documento principale collegato |
| GESLPRC-DOC2-TIP | Tipo di documento secondario collegato |
| GESLPRC-DOC2-KEY | Chiave documento secondario collegato |
| GESLPRC-MSG | Messaggio relativo all'evento |
| GESLPRC-TIPO | Tipo di segnalazione: |
| GESLPRC-LIVELLO | Per ora non usato |
Elaborazione Il programma riceve in input le informazioni necessarie al riconoscimento dell'evento e il messaggio relativo. Altre informazioni (operatore, postazione) saranno invece gia' disponibili. Quindi, se il file LOGPROC non esiste, verra' creato. Il file sara' aperto alla prima chiamata e lasciato aperto. Se per qualche motivo viene rilevato un errore durante le operazioni di scrittura, si tentera' di salvare l'evento su un file sequenziale che ha lo stesso formato di LOGPROC. Lo stesso procedimento sara' seguito se in fase di apertura sara' registrato un errore diverso da 35 (ad esempio file corrotto). Per cercare di mantenere il piu' possibile l'integrita' della tabella, per ciascun processo attivo ogni 100 registrazioni si eseguira' una chiusura/riapertura del file stesso. NB: le eventuali registrazioni salvate su file sequenziali saranno quindi recuperate con un processo apposito. Gestione procedura In questa chiamata viene forzata la procedura corrente, e la procedura padre corrente
Operazione: "CHIUDI-PROCEDURA"¶
Descrizione Chiude la procedura corrente, e ripristina la procedura al livello precedente. Chiamata standard
| Dato | Contenuto |
|---|---|
| GESLPRC-OPE | "CHIUDI-PROCEDURA" |
Elaborazione Il programma scorre la tabella con la catena delle procedura, e imposta: * Procedura corrente: la procedura padre * Procedura padre: l'elemento precedente nella apposita tabella.
Operazione: "CONSULTA-PROCEDURA"¶
Descrizione Apre la funzione di consultazione procedura, passando in input la procedura corrente. Se richiesto, sarà passata una procedura diversa Chiamata standard
| Dato | Contenuto |
|---|---|
| GESLPRC-OPE | "CONSULTA-PROCEDURA" |
| GESLPRC-PROCEDURA | Nome procedura da consultare Se vuoto, sarà aperta l'ultima procedura elaborata |
Elaborazione Il programma esegue semplicemente una chiamata a LOGPROC1 passando la procedura in input. Rispetto alla chiamata diretta di LOGPROC1 da parte del programma chiamante, passare attraverso questa procedura dà due vantaggi: * Evita di dover aggiungere la copy di linkage di LOGPROC1 al chiamante * Viene già gestita l'eventuale "non disponibilità" del log procedura principale.
Estratto da documentazione interna ClickUp