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.