PTF ACG Express 1.2.1 (25 Febbraio 2008)
In data 25 Febbraio vengono pubblicate alcune PTF di ACG Express per far fronte ad un
adeguamento di legge (comunicazione IVA 2008).
Esse si applicano alla versione 1.2.1 di ACG Express alla quale sono state applicate le PTF
pubblicate fino al 14 Febbraio 2008.
Le PTF coinvolte sono:
o COJ121005 (Console di Amministrazione): deve essere installata solo se sono già state
installate le precedenti PTF dei prodotti pubblicate fino al 14 febbraio 2008 e il database è stato
migrato con la PTF GAJ121002.
o GAJ121004 (Modulo Base): contiene le modifiche ad alcuni oggetti delle librerie
ACG_OBJV3, IVALP33002, i file messaggi ACGMSG e NLSMSG, gli oggetti necessari alla
migrazione
o GBJ121004 (Gestione Archivi): contiene, oltre ad alcune correzioni, gli aggiornamenti
necessari al funzionamento dell’adeguamento di legge
o CAJ121002 (Contabilità aziendale): contiene gli aggiornamenti relativi alla comunicazione
IVA 2008
Per installare questo insieme di PTF prcedere nel modo seguente:
o Scaricare dal sito le PTF
o Intallare la PTF COJ121005 seguendo le istruzioni indicate nella lettera di accompagnamento
ATTENZIONE: tale PTF deve essere installata solo se sono già state installate le PTF
pubblicate a Gennaio 2008 e il database è stato migrato con la PTF GAJ121002
o Installare le altre PTF
o Poiché questo insieme di PTF prevede la modifica di alcuni elementi del database, sarà
necessario eseguire anche la migrazione dei dati, messa a disposizione dalla Console di
Amministrazione appena aggiornata (effettuare un back-up del database prima di procedere
alla migrazione e leggere il capitolo “Dettagli relativi alla migrazione” riportato più avanti)
Per questo si richiede di leggere con attenzione quanto di seguito riportato.
Ad oggi, una PTF della Console di Amministrazione che prevede una migrazione del database
porta i programmi di migrazione specifici che migrano il database dal livello immediatamente
precedente: è per questo che si richiede di applicare tutte le PTF precedenti dei moduli
applicativi e di migrare i dati con procedure preesistenti, prima di installare la PTF della
Console.
In particolare la migrazione prevista con questo gruppo di PTF, prevede che le librerie dati da
migrare siano già a livello 1.2.1 migrato attraverso la PTF GAJ121002.
Questo significa, per esempio, che un database che si trovasse a versione 1.2.0 deve prima
essere migrato a versione 1.2.1, poi alla versione corrispondente alla PTF GAJ121002 e poi alla
versione attuale.
Una volta fatte le opportune considerazioni su quanto appena riportato, si può procedere con la
migrazione dei dati utilizzando l’apposito pannello messo a disposizione dalla Console
Amministrativa.
Si ricorda che, all’interno di un’istanza di DB2 in cui sono stati creati/migrati i dati, le librerie
DAT, COM e GRP devono essere allo stesso livello delle librerie di produzione. Dunque, se
vengono migrate le librerie di un Sistema Informativo, devono essere migrate anche le librerie
DAT, COM, GRP del Sistema Informativo ACGJUSER, che rappresentano comunque il
riferimento di base e le loro descrizioni vengono usate in alcuni casi, anche dai programmi
applicativi.
Dettagli relativi alla migrazione
Per quanto riguarda la migrazione è importante sapere quanto segue:
L’adeguamento delle libreria dei dati può essere eseguita soltanto se l’utente effettua il backup del database di partenza utilizzando le funzioni proprie del DB2.
La procedura di migrazione avverte l’utente chiedendo se abbia effettuato il back-up dei dati
ma NON ESEGUE ALCUNA OPERAZIONE AUTOMATICA DI SALVATAGGIO.
L’operazione di back-up dei dati è dunque fondamentale anche perchè la procedura di
migrazione non recupera i dati precedenti in caso di malfunzionamento.
Nel caso si venga a creare una situazione di errore durante la procedura di migrazione, una
volta individuate le cause del malfunzionamento e dopo aver effettuato le correzioni dovute, la
procedura dovrà essere chiamata di nuovo a partire dal database salvato in precedenza.
Per effettuare la migrazione, dopo aver installato le PTF secondo quanto descritto in precedenza,
occorre eseguire i seguenti passi:
o Assicurarsi che che nessun utente utilizzi l’applicazione
o back-up dei database da migrare
o Avvio della Console di Amministrazione 1.2.1 aggiornata l’ultima PTF. Nella pagina di login
indicare
 Percorso di “caravel.xml.properties” e system.xml.properties” relativi all’applicazione a
versione 1.2.1 associata ai database da migrare
 Percorso della cartella “data” all’interno della nuova Console 1.2.1 appena aggiornata
(dove sono presenti i dati relativi al nuovo database)
 Effettuare l’operazione di “Login” e attendere il messaggio di accesso avvenuto. A
questo punto sarà disponibile la pagina “Migrazione”
o Nella pagina “Migrazione” sarà visualizzato l’elenco dei Sistemi Informativi (ognuno con la sua
terna di librerie) presenti sul database: selezionare uno di quelli che deve essere migrato. Come
informazione aggiuntiva si rende noto che, in questa pagina, nella colonna che indica il release
dei Sistemi Informativi possono risultare riportate le seguenti indicazioni:
 V01R02M012 indica che il database era stato migrato con la migrazione della PTF
GAJ121002
 V01R02M011 indica che il database proviene da un’installazione del database attraverso
la Console di Amministrazione del precedente aggiornamento
 Se la dicitura è “V01R02M01I” o “V01R02M01M” allora questo Sistema Informativo
non può essere migrato con questa procedura di migrazione ma deve passare per il
livello precedente
o Usare il bottone di avvio della procedura di migrazione. Attendere il pannello che indica l’esito
della migrazione
La procedura carica prima i dati necessari alla migrazione vera e propria. In particolare carica nel
database le librerie MIG (con dati e programmi generici di migrazione, sostituendo quelli
precedenti) e MIG1211213 (con dati e programmi specifici della migrazione da 1.2.1 di Gennaio
2008 a 1.2.1 di Febbraio 2008).
La migrazione non prevede modifiche ai tracciati record degli archivi applicativi ma le seguenti
operazioni:
o Aggiunta di 2 record nel file ASTA300F
o Modifica del dizionario DIZACGV3 per aggiunta di un nuovo campo
o modifica della DS PTSOC2
o Sostituzione di ACGMSG e NLSMSG
o Sostituzione della libreria IVALP33002
Una volta conclusa la migrazione e dopo aver controllato che si sia conclusa correttamente si potrà
lavorare con l’applicazione che vedrà pertanto le correzioni apportate al database migrato.
Si informa che i log relativi alla migrazione possono essere reperiti in varie locazioni a seconda del
tipo di informazione che si vuole avere: nelle cartelle “log” e “Database\errors” all’interno della
cartella di installazione di ACG Express (Console di Amministrazione), e nella cartella indicata nel
system.xml.properties dell’applicazione usata per lanciare la migrazione.