COGV56 - Wrapper Gestione DDT / Bolle Uscita¶

Panoramica¶

Programma wrapper per la gestione delle bolle di uscita (DDT). Smista l'esecuzione verso il programma appropriato in base alla configurazione aziendale: versione grafica (COGV50W), versione per pasticcerie (ARTD50W) oppure versione a carattere (COGV56C).

Tipo: Wrapper interattivo (non accede direttamente a file).

Menu	Percorso
Magazzino	Uscite > Bolle Accompagnatorie > Gestione
Vendite	Bolle Vendita > Gestione

Struttura del programma¶

File e tabelle utilizzati¶

Nessun file utilizzato direttamente. Il programma opera esclusivamente come dispatcher.

Copybook principali¶

Copybook	Descrizione
wgrave.cpy	Gestione errori gravi
wnscr.cpy	Variabili per gestione finestra/maschera
wopenf.cpy	Variabili per apertura file / parametri operatore
wstato.cpy	Variabili di stato file
cogazien.cpy	Dati azienda corrente
utilncnf.cpy	Struttura per lettura configurazioni RNEWCONF
linku30.cpy	Parametri di interfaccia per COGU30 (gestione bolle)
wcont.cpy / wcont1.cpy	Area di comunicazione standard (stringhe)
utilu30b.cpy	Parametri linkage per chiamata da COGU30
mmmask.cpy	Routine gestione maschere
stato.cpy / stato1.cpy	Routine gestione stato file
winmsg.cpy	Routine messaggistica finestre
util1.cpy	Routine di utilita' generali

Chiamate a sottoprogrammi (CALL)¶

Programma	Scopo
RNEWCONF	Lettura configurazione `uscite / versione-programmi-ddt` e `abilita / gestione-pasticcerie`
C$NARG	Verifica numero argomenti ricevuti in linkage
COGV50W	Gestione bolle uscita versione grafica
ARTD50W	Gestione bolle uscita versione pasticcerie
COGV56C	Gestione bolle uscita versione a carattere

Logica di elaborazione¶

Flusso principale¶

Inizializzazione: salva il program-id, verifica il numero di argomenti ricevuti tramite C$NARG. Se riceve 2 argomenti (chiamata da COGU30), copia i dati di linkage; altrimenti inizializza la struttura locale.
Lettura configurazione: legge due chiavi RNEWCONF:
uscite / versione-programmi-ddt: determina se usare la versione grafica ("GRAFICA") o a carattere.
abilita / gestione-pasticcerie: determina se usare il programma specifico per pasticcerie ("S").
Scelta del programma:
Se versione "GRAFICA":
- Se gestione pasticcerie = "S" -> chiama ARTD50W (con cancel all prima e dopo la chiamata per pulizia memoria)
- Altrimenti -> chiama COGV50W, impostando "V" nella terza posizione di wo-parametro per indicare la modalita' variazione
Se versione diversa -> chiama COGV56C (versione a carattere)
Passaggio parametri da COGU30: se il programma e' stato invocato da COGU30 (controllo su u30b-caller e u30b-called), i parametri di linkage vengono passati al programma chiamato. Altrimenti viene effettuata una chiamata senza parametri aggiuntivi.
Ritorno: al termine, se il programma era stato chiamato con 2 argomenti, restituisce i dati di linkage aggiornati.

Note tecniche¶

La copybook linku30.cpy viene inclusa due volte: una nella working-storage con prefisso rinominato (link-w-u30), una nella linkage con nomi originali (link-u30). Questo permette di lavorare con una copia locale dei dati.
Per la versione pasticcerie viene eseguito cancel all sia prima che dopo la chiamata ad ARTD50W per assicurare il rilascio completo della memoria.
Il campo wo-parametro (3:1) viene impostato a "V" nella versione grafica per segnalare modalita' variazione (distinguendo da inserimento).
Le righe marcate con 050225 (5 febbraio 2025) indicano l'aggiunta della gestione pasticcerie.