Program Directory per ACG Contabilità Analitica AS/400. Versione 2 R07M01. Numero Programma 5774-G13. Relative al sistema AS/400

Transcript

1 IBM Program Directory per ACG Contabilità Analitica AS/400 Versione 2 R07M01 Numero Programma 5774-G13 Relative al sistema AS/400 Data del Documento: Dicembre 2001 GI

2 Note Leggere attentamente quanto riportato nella sezione Nota a pagina iv prima di utilizzare le informazioni riportate o il prodotto cui si fa riferimento. Questa program directory, datata Dicembre 2001, si applica a ACG Contabilità Analitica Versione 2 R07M01, Program Number 5774-G13 per i seguenti: COMPIDs Numero Feature Sistema AS/400 Nelle ultime pagine della seguente program directory e' riportato un questionario per gli eventuali commenti. Le informazioni inviate alla IBM non sono soggette ad alcun vincolo. La IBM puo' usare e distribuire le informazioni ricevute in qualsiasi modo ritenga opportuno senza con cio' incorrere in alcun obbligo verso di Voi. Copyright International Business Machines Corporation 1998, Tutti i diritti riservati.

3 Indice Nota iv Trademarks e Service Marks iv 1.0 Introduzione AVVERTENZA Materiale disponibile con il programma Materiale Base in formato leggibile dall' elaboratore Materiale opzionale Documentazione del Programma Pubblicazioni del Programma - Materiale Base Pubblicazioni del Programma - Materiale Opzionale Materiale fornito in formato oggetto Materiale fornito in formato sorgente Pubblicazioni utili in fase di installazione del prodotto Assistenza al Programma Assistenza e Manutenzione Programmi Assistenza ai programmi Materiale di supporto Informazioni sull'adeguamento di livello Requisiti software Informazioni sulle modifiche apportate al programma Passi di adeguamento di livello Ulteriori supporti magnetici Considerazioni e requisiti per l'installazione Requisiti di sistema Requisiti del Sistema Operativo Requisiti di Macchina Requisiti Software Riorganizzazione archivi Interfaccia grafica Considerazioni relative al Programma Installazione Installazione di ACG Contabilità Analitica Introduzione Dettaglio della procedura di installazione Avviamento del prodotto ACG Contabilità Analitica Copyright IBM Corp. 1998, 2001 iii

4 7.0 Ambienti Multipli Modulo di commento iv ACG Contabilità Analitica Program Directory

5 Nota Riferimenti contenuti in questa pubblicazione relativi a prodotti, programmi o servizi IBM non implicano che la IBM intenda renderli disponibili in tutti i paesi in cui opera. Qualsiasi riferimento a un programma su licenza IBM o altro prodotto IBM non implica che soltanto essi possano essere utilizzati. Ogni prodotto, programma o servizio equivalente che non violi diritti di proprieta' intellettuale o altri diritti della IBM o di altri puo' essere usato in sostituzione dei prodotti, programmi o servizi forniti dalla IBM. Valutazioni e verifiche operative in relazione ad altri prodotti, programmi o servizi, eccetto quelli espressamente previsti dalla IBM sono di esclusiva responsabilita' dell'utente. La IBM puo' avere brevetti o domande di brevetto che coprono quanto trattato in questo documento; la fornitura di questo documento non implica la concessione di alcuna licenza su di essi. Per informazioni riguardanti la concessione di licenza, scrivere al seguente indirizzo: International Business Machines Corporation IBM Director of Licensing 500 Columbus Avenue Thornwood, New York USA Trademarks e Service Marks I seguenti termini, segnati con (*), utilizzati in questo documento, sono trademarks o service marks della IBM Corporation negli United States o altre nazioni: IBM AS/400 OS/400 RPG/400 I seguenti termini, riportati con doppio asterisco (**), usati in questo documento, sono trademarks di altre compagnie come segue: Nessuno. Copyright IBM Corp. 1998, 2001 v

6 vi ACG Contabilità Analitica Program Directory

7 1.0 Introduzione Questo documento e' indirizzato al personale che effettua la installazione e la manutenzione del programma. Esso contiene informazioni sul materiale e sulle procedure di installazione del prodotto ACG Contabilità Analitica. Si consiglia di leggerlo integralmente prima di effettuare le operazioni ivi descritte e di tenerlo a disposizione per futuri riferimenti. Nota bene: I nuovi utenti del prodotto ACG Contabilità Analitica devono seguire i passi descritti nel capitolo 6.0, Installazione a pagina 25 per installare i programmi e gli archivi sul proprio sistema AS/400 (*). Gli utenti che hanno gia' installato il prodotto ACG Contabilità Analitica ad un livello di rilascio precedente a R07M01 devono seguire i passi descritti nel capitolo 4.0, Informazioni sull'adeguamento di livello a pagina 13 per portare i programmi e gli archivi di prodotto al rilascio R07M01. Questo documento contiene le seguenti sezioni: 2.0, Materiale disponibile con il programma a pagina 4 identifica il materiale base, quello opzionale e la documentazione disponibile con ACG Contabilità Analitica. 3.0, Assistenza al Programma a pagina 11 descrive l'assistenza IBM (*) per il prodotto ACG Contabilità Analitica. 4.0, Informazioni sull'adeguamento di livello a pagina 13 elenca gli APAR (program level) e le PTF (service level) incluse in ACG Contabilità Analitica. Descrive inoltre le operazioni da seguire per effettuare l'adeguamento di livello del programma. 5.0, Considerazioni e requisiti per l'installazione a pagina 20 elenca i requisiti necessari per installare ed utilizzare ACG Contabilità Analitica. 6.0, Installazione a pagina 25 fornisce il dettaglio delle istruzioni per la installazione. Descrive inoltre le procedure per attivare le funzioni di ACG Contabilità Analitica. 7.0, Ambienti Multipli a pagina 30 descrive le modalita' di creazione di piu' Sistemi Informativi. 1.1 AVVERTENZA Per utilizzare questo programma e' necessario disporre del suo "CODICE di AUTORIZZAZIONE" che la IBM Vi ha inviato tramite il servizio Postel. Nel caso in cui il codice non Vi sia ancora pervenuto, Vi preghiamo di contattare il Servizio Clienti della IBM Italia (Num. Verde: ) che provvedera' ad inviarlo via fax. Desideriamo, anche, richiamare la Vostra attenzione su quanto segue: Copyright IBM Corp. 1998,

8 I codici di autorizzazione hanno validita' annuale con scadenza 30 aprile. I nuovi codici saranno inviati, prima di tale scadenza, nel periodo febbraio - marzo Il codice che Vi viene fornito scadra', in particolare, il 30 aprile dell'anno successivo a quello che, nella comunicazione Postel o fax, e' indicato nella colonna "ANNO" 2 ACG Contabilità Analitica Program Directory

9 YEAR 2000 Il Prodotto, utilizzato secondo quanto riportato nella documentazione ad esso associata, e' in grado di elaborare, fornire o ricevere correttamente date in un intervallo comprendente sia il ventesimo che il ventunesimo secolo, a condizione che tutti i prodotti utilizzati con esso (per esempio hardware, software e firmware) siano in grado di gestire e scambiare correttamente le date con il Prodotto stesso. YEAR 2000 e' attivo a partire dal Rilascio 5 Livello di Modifica 0 e non lo e' per i precedenti rilasci. Introduzione 3

10 2.0 Materiale disponibile con il programma Un programma IBM e' identificato da un Numero di Programma ("Program Number") e da uno o piu' numeri di codice ("Feature"). Il "program number" per il programma ACG Contabilità Analitica e' 5774-G13. Le informazioni riguardanti le "Feature" del programma ACG Contabilità Analitica sono incluse nel materiale di annuncio del programma; esse sono altresi' reperibili tramite il rappresentante IBM. La seguente sezione identifica: Il materiale di base disponibile con il programma. Il materiale opzionale disponibile con il programma. 2.1 Materiale Base in formato leggibile dall' elaboratore Il supporto magnetico utilizzato per questo programma contiene tutti i programmi e i dati necessari sia alla installazione che all'adeguamento di livello. Per ulteriori informazioni sulla installazione riferirsi al capitolo 6.0, Installazione a pagina 25. Per ulteriori informazioni sull'adeguamento di livello riferirsi al capitolo 4.0, Informazioni sull'adeguamento di livello a pagina 13. La Figura 1 descrive il/i supporti magnetici. La Figura 2 descrive il contenuto del/i supporti magnetici. Nota: Il/i supporti magnetici ricevuti contengono materiale classificato Restricted Materials of IBM. Figura 1. Supporto/i Magnetici: Materiale Base Medium Numero Volume Numero feature Edichetta esterna 1/1 5387, 5388, 5389, 5390, 5391, 5392, G13R07M01 Figura 2 (Pagina 1 di 2). Contenuto del/i supporto/i magnetico/i File Contenuto RECFM LRECL 1 SAVOBJ identificativo prodotto 2 SAVLIB Controllo installazione 3 SAVLIB Libreria di adeguamento CC2 4 SAVLICPGM Definizione prodotto (parte Base) 5 Libreria programmi eseguibili 6 SAVLICPGM Definizione prodotto (parte 1)-CISC BLK SIZE Number of Elements 4 Copyright IBM Corp. 1998, 2001

11 Figura 2 (Pagina 2 di 2). Contenuto del/i supporto/i magnetico/i File Contenuto RECFM LRECL 7 Libreria programmi sorgenti 8 SAVOBJ Definizione prodotto (parte Base) - RISC 9 SAVLIB Cumulativo RISC 10 SAVLIB Cumulativo CISC BLK SIZE Number of Elements 2.2 Materiale opzionale Non vi e' alcun materiale opzionale per il programma ACG Contabilità Analitica. 2.3 Documentazione del Programma Le seguenti sezioni identificano le pubblicazioni base e quelle opzionali per il programma ACG Contabilità Analitica Pubblicazioni del Programma - Materiale Base La Figura 3 identifica le pubblicazioni base per il programma ACG Contabilità Analitica. Una copia e' inclusa nel materiale base. Per ottenere ulteriori copie addizionali utilizzare il numero di "form" e contattare il proprio rappresentante commerciale IBM. Figura 3. Pubblicazioni del Programma - Materiale Base Titolo Guida Applicativa Numero di "Form" SB Pubblicazioni del Programma - Materiale Opzionale Non vi sono pubblicazioni opzionali. Materiale disponibile con il programma 5

12 2.4 Materiale fornito in formato oggetto Per il programma ACG Contabilità Analitica i seguenti programmi sono forniti solo in formato oggetto: 6 ACG Contabilità Analitica Program Directory

13 Programmi CL BUSP2CL HCGG 1 HCMSG HCMSGDTA HCVG 2 HCVG 4 HCXSETUP HCY 8 HCY52 HCY92 HC 1R HC 2R HC 3R HC 4R HC 5R HC 6R RMVMSG RMVMSGC RMVMSGE SNDMSG SNDMSGPC Programmi RPG: HRAAM HRAAMC HRACA HRACAC HRACM HRACMC HRANSC HRAPI HRAPIC HRAQR HRAQRC HRA 1 HRCHK HRDHC HRDHCC HRELR HRELRSC HRGG 1 HRGG 2 HRGG 3 HRGG 3SC HRG29 HRJCA1CR HRJCM1CR HRKVM HRKVQ HRMG 1 HRMG 1SC HRMG 2 HRMG 2SC HRN 6 HRN1 HRN15 HRN16 HRN16_SC HRN16PRT HRN17PRT HRN2 HRN21 HRN5 HRN6 HRN61 HROAMXR HROAM1CR HROAM1C2 HROAM1SR HROAM1SU HROBSTCR HROBSTCUSC HROBSTG1 HROBSTG3 HROBSTG4 HROBSTG6 HROBSTSU HROBS1CR HROBS1CU HROBS1CUSC HROBS1C2 HROBS1C3 HROBS1C5 HROBS1G4 HROBS1MU HROBS1MUSC HROBS1M3 HROBS1SR HROBS1V HROCA1SR HROCA1SU HROCH1MU HROCH1SR HROCH1SU HROCH1SUSC HROCM1SR HROCM1SU HROHC1CR HROHC1SR HROMA2GK HROMRTGK HROMRTSUSC HROMR1CR HRONS1CR HRONS1CU HRONS1MR HRONS1SR HROPIXR HROPI1CR HROPI1CU HROPI1SR HROPI1SU HROQRXR HROQR1CU HROQR1C2 HROQR1SR HROQR1SU HROTD1CR HROVMTCR HROVM1CR HROVM1CU HROVM1C2 HROVM1C3 HROVM1C4 HROVM1MU HROVM2CR HROVM2CU HROVM2C2 HROVQTCR HROVQTC2 HROVQ1CR HROVQ1C2 HROVQ1C3 HROVQ1MU HROVQ1MUSC HROVQ1SR HROVQ2CR HROVQ2C2 HROVUTSU HROVU1CR HROVU1MU HRQCH HRQJNSAP HRQVM HRQVU HRQ 1 HRQ 2 HRSG 1 HRSG 2 HRTTDC HRUCH HRVBS HRVBSC HRVB HRVB C HRVB1C HRVB4 HRVB4C HROBS1G5 HRVG 2 HRVG 3 HRVVM HRVVMC HRVVQ HRVVQC HRVVU HRVVUC HRY1 HRY12 HRY51 HRY52 HRY53 HRY73 HRY79 HRY8 HRY82 HRY84 HRY84PD HRY84PDC HRY85PD HRY85PDC HRY94 HRY94PD HRY94PDC HRY95 HRZG 2OLD HRZG 3 HR 3W HR 4W NRAAZ NRAAZC NROAZ1SR NROAZ1SU HROBS1G2 HROMR2CR HRONS1C2 HRRCB HRANS HROBSTSUSC HROVM1SR HRY78 HRA 114 HROBS1G1 HROVQ1CU HRY85 HRGG 1SC HROCA1CR HROVQ2CU HRZG 1 HRJNS1CR HROCM1CR HRQJNSCH NROAZ1CR HRN 5 HROMRTSU HRTTD HROBS1C6 HRN17 HRONS1SU HRVB1 HRN95 HROQR1CR HRVG 4 HROBSTCU HROVMTC2 HRXSETUPSI Materiale disponibile con il programma 7

14 2.5 Materiale fornito in formato sorgente Gli oggetti per i quali e' fornito anche il sorgente possono essere modificati dall'utente per adeguarli a proprie specifiche esigenze che non sono soddisfatte dalle funzioni standard del prodotto. Per salvaguardare tali modifiche dalla installazione di PTF di correzione o di rilasci del prodotto successivi alla loro realizzazione, e' necessario utilizzare librerie diverse da quelle standard fornite. La installazione di PTF o rilasci del prodotto sostituisce infatti gli oggetti presenti nelle librerie standard con i nuovi oggetti inviati, e quindi gli oggetti modificati dall'utente andrebbero persi. E' pertanto necessario: copiare i sorgenti che si devono modificare dalla libreria sorgente ACGSCC2 in una propria libreria sorgenti appositamente creata, ed effettuare le modifiche in questa libreria; creare gli oggetti modificati in una propria libreria oggetti appositamente creata; inserire la libreria oggetti con gli oggetti modificati nella lista librerie dei sistemi informativi utilizzati, anteponendola alla libreria oggetti standard ACG_OBJV2. In tal modo gli oggetti modificati non verranno mai sostituiti con gli oggetti di uguale nome ripristinati dalla PTF o dal nuovo rilascio. Naturalmente l'utente dovra' verificare che gli oggetti modificati e creati nella propria libreria oggetti funzionino correttamente anche a fronte delle modifiche apportate agli oggetti standard. Si e' detto precedentemente, che l'utente deve utilizzare librerie proprie sia per le modifiche di sorgenti distribuiti che per le compilazioni degli oggetti modificati, e che tali librerie devono avere nomi diversi da quelli standard ACG. Si ricorda che i nomi standard ACG per le librerie sono: ACG_OBJV2 ACGIxxx ACGOxxx ACGSxxx ACGBxxx ACGDxxx dove: xxx = Acronimo del prodotto, che nel caso specifico e' CC2. Per il programma ACG Contabilità Analitica i seguenti programmi sono forniti in formato sorgente: 8 ACG Contabilità Analitica Program Directory

15 Programmi RPG HRGEXT HRN 4PRT HRR32 HRY31 HR 1B HRG21 HRN11PRT HRR33 HRY32 HR 1G1 HRG22 HRN18PRT HRR41C HRY4 HR 1G2 HRG23 HRRCO HRR41W HRY41 HR 1G3 HRG24 HRR1 HRSG 3 HRY42 HR 1P HRG25 HRR11 HRVG 1 HRY43 HR 1R HRG26 HRR12 HRV 1 HRY65 HR 2A HRG27 HRR13 HRV 2 HRY66 HR 2B HRG31 HRR14 HRW HRY68 HR 2G1 HRG32 HRR15 HRW 1 HRY74 HR 2G2 HRG33 HRR2 HRW 3 HRY74P HR 2G3 HRG34 HRR21 HRW 4 HRY81 HR 2R HRG35 HRR22 HRY 8 HRY83 HR 3A HRICC HRR24 HRY 9 HRY88 HR 3B HRICM HRR25 HRY 9P HRY92 HR 3G HRIPR HRR26 HRY11 HRY93 HR 3R HRIVS HRR27 HRY21 HRY96 HR 3S HRMG 3 HRR28 HRY22 HRY97 HR 4A HRMG 4 HRR29 HRY23 HRY98 HR 4B HRMVA HRR3 HRY24 HRZ 1 HR 4G1 HRM 1 HRR31 HRY25 HRZ 2 HR 4G2 HR 1A HR 4R HRY26 HRZ 3 HR 4G3 HRY27 HRZ 4 Materiale disponibile con il programma 9

16 2.6 Pubblicazioni utili in fase di installazione del prodotto Copia del presente documento e' contenuta all'interno del supporto magnetico. Qualora se ne presentasse la necessita', e' possibile ottenerne la stampa su AS/400, operando nel modo seguente: 1. Se il prodotto e' gia' stato installato correttamente, la stampa puo' essere ottenuta eseguendo il comando: ACG_OBJV2/PDCC2 2. Qualora l'installazione non sia stata ancora effettuata, seguire i seguenti passi: Aprire una sessione di lavoro come utente QPGMR. Montare il supporto magnetico contenente il prodotto nell'apposita unita' nastro. Immettere ed eseguire il comando: RSTOBJ OBJ(PDCC2 ) SAVLIB(ACGICC2) DEV(nome-unita') + OBJTYPE( ALL) RSTLIB(ACG_OBJV2) Immettere ed eseguire il comando: ACG_OBJV2/PDCC2 Nella coda di output associata al profilo QPGMR, e' possibile reperire la stampa della presente Program Directory; il nome del file da stampare e' "PDCC2". 10 ACG Contabilità Analitica Program Directory

17 3.0 Assistenza al Programma Questa sezione descrive l'assistenza IBM disponibile per il programma ACG Contabilità Analitica. 3.1 Assistenza e Manutenzione Programmi Prima di installare ACG Contabilità Analitica, contattare il proprio rappresentante commerciale IBM o il Servizio Clienti della IBM Italia per piu' specifiche informazioni sui servizi disponibili. 3.2 Assistenza ai programmi La IBM fornisce il servizio per la correzione di eventuali errori che fossero contenuti nella versione corrente, non modificata, del programma. Qualsiasi difficolta' si incontri nell'utilizzo del programma va comunicata all'ibm. Se a fronte di malfunzionamenti riscontrati viene richiesto un "APAR" ("Authorized Program Analysis Report"), la segnalazione va corredata da materiale di supporto, note ed altro, come qui appresso indicato. L'assistenza di primo livello e' fornita tramite il Servizio Clienti della IBM Italia (numero verde ), mentre il servizio centrale e' disponibile presso la: IBM Italia S.p.A Application Product Development Center IBM S. PALOMBA Via Ardeatina Km. 22,5 4 Roma Italia 3.3 Materiale di supporto Di seguito sono riportati gli elementi da fornire alla IBM per permetterle la risoluzione di un APAR secondo il tipo di problema: Problema di Programma Definire quale programma e' interessato Indicare se sono state applicate delle PTF ("Problem Temporary Fix") al programma (e quali) Stampare e/o rendere disponibile una copia dell'input e dell'output utilizzati Descrivere l'analisi fatta nell'ambito della problematica relativa all'errore Problema di Documentazione Definire la posizione dell'errore: Titolo del Manuale Copyright IBM Corp. 1998,

18 Numero di pagina Capitolo, Paragrafo, Figura, etc.. Fornire una spiegazione dell'errore Suggerire una possibile correzione 12 ACG Contabilità Analitica Program Directory

19 4.0 Informazioni sull'adeguamento di livello Nella fase di installazione del programma si presume che chi esegue le operazioni sia a conoscenza di: tecniche elementari di gestione del sistema terminologia caratteristica del sistema utilizzo dei terminali e dei supporti esterni presenti parole d'ordine di accesso relative ai profili previsti comandi necessari ad effettuare le verifiche richieste Si raccomanda, inoltre, di leggere attentamente le istruzioni per l'installazione, prima di procedere. Di seguito sono elencate le istruzioni per eseguire l'adeguamento di livello del programma ACG Contabilità Analitica al rilascio R07M Requisiti software L'adeguamento di livello del programma ACG Contabilità Analitica richiede che siano soddisfatti i seguenti prerequisiti software: ACG Modulo Base V2R6M G 1 ACG Gestione Archivi V2R7M G 2 ACG Contabilita' aziendale V2R7M G1 (*) Se invece sono installati ad un rilascio inferiore a quello indicato, al termine della procedura, e' necessario adeguare i suddetti prodotti al livello richiesto. Si ricorda che tali prerequisiti sono validi sia a livello di prodotti installati che a livello librerie dati. 4.2 Informazioni sulle modifiche apportate al programma Il presente rilascio include una serie di modifiche (di tipo migliorativo o a seguito di adeguamenti normativi) e un insieme di correzioni a problemi riscontrati nel precedente rilascio. Le migliorie e le correzioni sono illustrate in dettaglio nel membro sorgente LETTERA del file CC2PTFLIB/LETTERA. Copyright IBM Corp. 1998,

20 4.3 Passi di adeguamento di livello L'adeguamento di livello per il programma "ACG Contabilità Analitica" consiste nella sostituzione di tutti gli eseguibili al livello R05M00 o R06M00 o R07M00 con quelli al livello R07M01 effettuando la disinstallazione e la nuova installazione dei programmi. Nel caso si fosse interessati al mantenimento del livello precedente della libreria dei sorgenti ACGSCC2 e degli eseguibili del prodotto 5774-G13 in ACG_OBJV2, e' necessario effettuarne il salvataggio prima di procedere con le attivita' descritte di seguito. Nota In caso di installazione del prodotto su OS/400 (*) V3 Rel. 7.0 controllare l'autorizzazione ai comandi RSTOBJ, RSTLIB, RSTLICPGM mediante i seguenti comandi: DSPOBJAUT OBJ(RSTOBJ) OBJTYPE(*CMD) DSPOBJAUT OBJ(RSTLIB) OBJTYPE(*CMD) DSPOBJAUT OBJ(RSTLICPGM) OBJTYPE(*CMD) Se l'autorizzazione all'utente *PUBLIC non e' di tipo *EXCLUDE, procedere con il successivo passo di adeguamento di livello; in caso contrario eseguire prima i seguenti passi: 1. Aprire una sessione di lavoro come Utente: QSECOFR 2. Modificare l'autorizzazione *PUBLIC tramite i comandi: EDTOBJAUT OBJ(RSTOBJ) OBJTYPE(*CMD) EDTOBJAUT OBJ(RSTLIB) OBJTYPE(*CMD) EDTOBJAUT OBJ(RSTLICPGM) OBJTYPE(*CMD) inserendo, come autorizzazione per l'utente *PUBLIC il tipo *USE 3. Chiudere la sessione. Qui di seguito vengono riportati i passi da seguire per effettuare l'adeguamento di livello del prodotto ACG Contabilità Analitica. * * I M P O R T A N T E * * Per poter eseguire la migrazione degli archivi del prodotto Contabilita' Analitica su una certa libreria dati e' necessario che gli archivi dei seguenti prodotti siano almeno al livello indicato: Archivi di base (GB2) R7M1 Contabilita' aziendale (CA2) R7M1 Acquisti (AQ2) R7M1 Bollettazione e Fatturaz. (FT2) R7M Ordini (OR2) R7M 14 ACG Contabilità Analitica Program Directory

21 Per conoscere il livello degli archivi di ciascun prodotto e' sufficiente immettere il seguente comando: DSPDTAARA libreria-dati/relxxx dove xxx e' l'acronimo del prodotto ( ad esempio DSPDTAARA ACG_DATV2/RELGB2 ) Informazioni sull'adeguamento di livello 15

22 L'adeguamento degli archivi del prodotto Contabilita' Analitica al livello R07M01 comporta la migrazione dei seguenti archivi: Conversione file da : R7M a R7M1 R5M /R6M a R7M1 BUSP2W1F BUSP2 F MOAN2WWF MOAN2 F MORI2WWF MORI2 F VAAM2 F VAQR2 F VAUM2 F ANDI2 F BUSP2W1F BUSP2 F CTMO2 F DESC2WWF DESC2 F GCAN2 F GDSC2 F GECC2 F GIAN2 F GIFA2 F GMOA2 F GRCC2 F GVAN2 F GVCA2 F HROC2 F MOAN2WWF MOAN2 F MORI2WWF MORI2 F MOSH2W1F MOSH2 F MWSC2 F VAAM2 F VAQR2 F VAUM2 F VSPA2 F VSPM2 F A causa del numero elevato di archivi da migrare i tempi necessari al loro adeguamento puo' essere piuttosto elevato. Siccome tali tempi risultano comunque proporzionali alle dimensioni di tali archivi, potrebbe essere utile, prima di avviare la procedura di migrazione, eliminare da tali archivi dati inutili o obsoleti. 16 ACG Contabilità Analitica Program Directory

23 Prima di avviare l'adeguamento di livello delle librerie dati e' consigliabile effettuarne una copia di salvataggio. L'adeguamento di livello per il programma "ACG Contabilità Analitica" consiste nella sostituzione di tutti gli eseguibili e dei sorgenti al livello R0500 o successivo con quelli al livello R07M01 attraverso i passi di seguito descritti. Queste attivita' non riguardano le librerie dati il cui adeguamento si ottiene attraverso l'esecuzione di passi specifici. Nota. Gli oggetti per i quali e' fornito anche il sorgente possono essere modificati dall'utente per adeguarli a proprie specifiche esigenze che non sono soddisfatte dalle funzioni standard del prodotto. Per salvaguardare tali modifiche dall'installazione di PTF di correzione o di rilasci del prodotto successivi alla loro realizzazione, e' necessario utilizzare librerie diverse da quelle standard fornite. La installazione di PTF o rilasci del prodotto sostituisce infatti gli oggetti presenti nelle librerie standard con i nuovi oggetti inviati, e quindi, gli oggetti modificati dall'utente andranno persi. E' pertanto necessario: copiare i sorgenti che si devono modificare dalla libreria sorgente ACGSCC2 in una propria libreria sorgenti appositamente creata, ed effettuare le modifiche in questa libreria; creare gli oggetti modificati in una propria libreria oggetti appositamente creata; inserire la libreria oggetti con gli oggetti modificati nella lista librerie dei sistemi informativi utilizzati, anteponendola alla libreria oggetti standard ACG_OBJV2. In tal modo gli oggetti modificati non verranno mai sostituiti con gli oggetti di ugual nome ripristinati dalla PTF o dal nuovo rilascio. Naturalmente l'utente dovra' verificare che gli oggetti modificati e creati nella propria libreria oggetti funzionino correttamente anche a fronte delle modifiche apportate agli oggetti standard. Si e' detto precedentemente, che l'utente deve utilizzare librerie proprie sia per le modifiche di sorgenti distribuiti che per le compilazioni degli oggetti modificati, e che tali librerie devono avere nomi diversi da quelli standard ACG. Si ricorda che i nomi standard ACG per le librerie sono: ACG_OBJV2 ACGICC2 ACGOCC2 ACGSCC2 CC2PTFLIB TRAGENOCC2 Informazioni sull'adeguamento di livello 17

24 TRAGENSCC2 1. Operazioni preliminari a. Aprire una sessione di lavoro come Utente: QSECOFR b. Inserire il supporto magnetico nell'apposita unita' 2. Adeguamento di livello degli eseguibili e dei sorgenti Avviare la procedura di adeguamento di livello tramite il comando: ACGGAA/KRSTPTF ACR(CC2) DEV(nome_unita'). I programmi eseguibili vengono installati nella libreria standard ACG_OBJV2. Al momento della esecuzione del comando precedente viene visualizzata la documentazione relativa al rilascio contenente le informazioni per l'installazione e le modifiche, le migliorie, gli oggetti interessati. E' possibile in quel momento interrompere la procedura visualizzare e/o stampare tale documentazione prima di procedere all' adeguamento di livello. Completato questo passo e' possibile cancellare la libreria CC2PTFLIB. Cumulativo CC per As/400 Risc (CC per As/400 Cisc) Sul supporto magnetico e' presente il cumulativo delle PTF emesse per il prodotto fino al 15/11/2001. Per installare il cumulativo: Aprire una sessione di lavoro con il profilo QPGMR. Ripristinare la relativa libreria tramite il comando: RSTLIB SAVLIB(CC227180) DEV(nome_unita') Successivamente stampare le istruzioni di installazione del cumulativo tramite il comando: STRSEU SRCFILE(CC227180/READ.ME) SRCMBR(READ.ME) OPTION(6) ed eseguire i passi riportati in tali istruzioni. Togliere il supporto magnetico dall'unita'. Chiudere la sessione. 3. Adeguamento di livello delle librerie dati Aprire una sessione di lavoro con il profilo QPGMR. Procedere all'adeguamento di livello di tutti le librerie dati in cui sono installati gli archivi del prodotto Contabilita' Analitica tramite il comando: ACGV2MIGDB/STRMIGDB ACR(CC2) LIB(nome_libreria). Per ulteriori dettagli consultare la lettera della procedura di PTF. 18 ACG Contabilità Analitica Program Directory

25 Chiudere la sessione. 4.4 Ulteriori supporti magnetici Non sono previsti ulteriori supporti magnetici contenenti PTF non incluse nel presente rilascio del programma ACG Contabilità Analitica. Informazioni sull'adeguamento di livello 19

26 5.0 Considerazioni e requisiti per l'installazione La seguente sezione elenca i requisiti per installare ed utilizzare il programma ACG Contabilità Analitica. 5.1 Requisiti di sistema Requisiti del Sistema Operativo ACG Contabilità Analitica opera con i Sistemi Operativi AS/400 V3R2, V3R7 e successivi Requisiti di Macchina Il programma ACG Contabilità Analitica e' stato progettato per operare in un sistema con le seguenti caratteristiche: Un sistema IBM AS/400 Almeno un terminale video a 24 righe e 80 colonne con relativa tastiera Una stampante con almeno 132 posizioni di stampa Requisiti Software Le persone che dovranno installare e mantenere il programma ACG Contabilità Analitica devono sapere che i programmi applicativi, scritti in RPG/400 (*) e CL, sono forniti in formato oggetto (OCO, Object Code Only) ed alcuni anche in formato sorgente, tra cui i file video e di stampa. Inoltre devono considerare i seguenti prerequisiti software: 20 Copyright IBM Corp. 1998, 2001

27 Sistema Operativo OS/4 oppure V3R7M (RISC) V3R2M (CISC) ACG Modulo Base V2R6M G 1 ACG Gestione Archivi V2R7M G 2 ACG Contabilita' Aziendale V2R7M G1 E' necessario, inoltre, che i seguenti prodotti, se installati, siano almeno al livello di seguito indicato: ACG Portafoglio Effetti R7M G11 ( ) ACG Tesoreria R7M G12 ( ) ACG Controllo Aziendale R7M G14 ( ) ACG Bollett. e Fatturazione R7M 5774-G3 ( ) ACG Ordini Clienti R7M 5774-G31 ( ) ACG Acquisti R7M G43 ( ) (*) Se invece sono installati ad un rilascio inferiore a quello indicato, al termine della procedura, e' necessario adeguare i suddetti prodotti al livello richiesto. Si ricorda che tali prerequisiti sono validi sia a livello di prodotti installati che a livello librerie dati. Per la compilazione dei programmi distribuiti come sorgenti per eventuali personalizzazioni sono necessari i compilatori: RPG/400 Compiler SQL/400 Compiler. Il materiale di cui sopra puo' essere ordinato tramite il proprio rappresentante commerciale IBM. Considerazioni e requisiti per l'installazione 21

28 5.2 Riorganizzazione archivi Per velocizzare la richiesta di elenco (tasto F4 oppure? sul campo) e' consigliabile effettuare periodicamente una riorganizzazione degli anagrafici della Contabilita' Analitica, mediante l'apposita funzione presente nel menu Utilita'. Per velocizzare l'esecuzione della funzione 'Esecuzione ripartizione' si consiglia di effettuare periodicamente la riorganizzazione fisica (mediante il comando di sistema RGZPFM) dei seguenti archivi: BUSP200F, MORI200F, VAQR200F, VAUM200F, VAAM200F. 22 ACG Contabilità Analitica Program Directory

29 5.3 Interfaccia grafica Dal livello V2R1M3 in poi la Contabilita' Analitica ACG utilizza le nuove DDS avanzate che permettono di ottenere una interfaccia di tipo grafico. Gli aspetti piu' rilevanti di questa innovazione sono: Radio button (selezione singola da una lista); Barra di menu e finestre pull-down (per selezionare azioni). Utilizzo del mouse come dispositivo di puntamento e selezione. In particolare il mouse puo' essere utilizzato per : 1. selezionare una azione dalla barra di menu e da una pull-down; 2. attivare un tasto funzione cliccando con il mouse sulla descrizione del tasto stesso; 3. ottenere l'equivalente del tasto Invio (si ottiene cliccando due volte con il mouse). I prerequisiti richiesti per l'utilizzo del mouse sono: 1. Unita' di controllo dei terminali modello 6050, 2661, 9146, 9148 oppure 5494 release 1.1; 2. Terminale video di tipo INFOWINDOW II corredato di mouse. La Contabilita' Analitica gestisce anche ambienti su cui non e' presente una delle unita' di controllo elencate al punto 1. ed ambienti con terminali non INFOWINDOW II: su tali ambienti il prodotto e' comunque funzionante utilizzando soltanto la tastiera. Considerazioni e requisiti per l'installazione 23

30 5.4 Considerazioni relative al Programma Non sono definiti ulteriori dettagli per il programma ACG Contabilità Analitica. 24 ACG Contabilità Analitica Program Directory

31 6.0 Installazione Questo capitolo descrive dettagliatamente i passi di installazione e attivazione del programma ACG Contabilità Analitica nel caso in cui si installa il prodotto per la prima volta. Nel caso in cui il prodotto risulti gia' installato, seguire i passi dettagliati nel paragrafo 4.3, Passi di adeguamento di livello a pagina 14. Nella fase di installazione del programma si presume che chi esegue le operazioni sia a conoscenza di: tecniche elementari di gestione del sistema terminologia caratteristica del sistema utilizzo dei terminali e dei supporti esterni presenti parole d'ordine di accesso relative ai profili previsti comandi necessari ad effettuare le verifiche richieste 6.1 Installazione di ACG Contabilità Analitica Introduzione Si raccomanda di leggere attentamente le istruzioni per l'installazione, prima di procedere. Nota: Qualora in fase di installazione programmi del prodotto 5774-G13 Contabilita' Analitica ACG V2 venga emesso il messaggio: Il prodotto non risulta abilitato ad essere installato con il valore di QSECURITY = 4. Abilitare il prodotto con il comando KABILSEC. Premere F3 per uscire. e' necessario effettuare i seguenti passi: 1. aprire una sessione di lavoro con profilo QPGMR 2. immettere i seguenti comandi: a. ADDLIBLE ACGGAA b. CALL ACGGAA/IRQ00 3. immettere CC2 nel campo "Acronimo prodotto" 4. immettere Contabilita' Analitica nel campo "Descrizione prodotto" 5. premere INVIO Copyright IBM Corp. 1998,

32 6. premere F3 7. ripetere l'operazione di installazione programmi (opzione 1 del profilo INSTALLA) In caso di installazione del prodotto su OS/400 (*) V3 Rel. 7.0 controllare l'autorizzazione ai comandi RSTOBJ, RSTLIB, RSTLICPGM mediante i seguenti comandi: DSPOBJAUT OBJ(RSTOBJ) OBJTYPE(*CMD) DSPOBJAUT OBJ(RSTLIB) OBJTYPE(*CMD) DSPOBJAUT OBJ(RSTLICPGM) OBJTYPE(*CMD) Se l'autorizzazione per l'utente *PUBLIC non e' di tipo *EXCLUDE, procedere con il successivo passo di installazione; in caso contrario eseguire prima i seguenti passi: Aprire una sessione di lavoro come Utente: QSECOFR Modificare l'autorizzazione *PUBLIC tramite i comandi: EDTOBJAUT OBJ(RSTOBJ) OBJTYPE(*CMD) EDTOBJAUT OBJ(RSTLIB) OBJTYPE(*CMD) EDTOBJAUT OBJ(RSTLICPGM) OBJTYPE(*CMD) inserendo il tipo *USE come autorizzazione per l'utente *PUBLIC Chiudere la sessione Dettaglio della procedura di installazione 1. Operazioni preliminari a. Aprire una sessione di lavoro come Utente: INSTALLA con parola d'ordine: INSTALLA. Compare a terminale il pannello "Installazione prodotti" b. Montare il supporto magnetico ricevuto, sulla appropriata unita' di lettura 2. Installazione programmi eseguibili Sul pannello "Installazione prodotti" immettere la scelta 1 in corrispondenza di "Attivita' di installazione di un prodotto", specificare l'unita' di lettura su cui e' montato il supporto magnetico e premere Invio. Compare a terminale il pannello "Guida Installazione prodotti". Sul pannello "Guida Installazione prodotti" immettere la scelta 1 in corrispondenza di "ACG Contabilità Analitica", e premere Invio; le operazioni successive saranno indicate a terminale. Il mancato soddisfacimento dei prerequisiti Software viene evidenziata a terminale da appositi messaggi che non permettono la prosecuzione delle attivita' di installazione. I programmi eseguibili vengono installati nella libreria standard ACG_OBJV2. Alla fine della installazione dei programmi eseguibili viene emesso automaticamente il pannello relativo al Codice di Autorizzazione all'uso, le cui modalita' di immissione sono di seguito descritte. 26 ACG Contabilità Analitica Program Directory

33 3. Immissione del Codice di Autorizzazione all'uso Il corretto funzionamento di tutte le funzioni del programma e' sottoposto alla verifica di due codici: Il Codice di Autorizzazione all'uso di quindici cifre L'Anno di Validita' che devono essere immessi o contestualmente alla installazione del programma ACG Contabilità Analitica o in una fase successiva. I due elementi del codice vengono forniti dalla IBM secondo due modalita' distinte: Tramite un inoltro postale automatico via servizio POSTEL. Questa comunicazione contiene diverse informazioni e deve essere conservata anche dopo il completamento della installazione. Tramite il Servizio Clienti della IBM Italia, raggiungibile telefonicamente al numero verde , se non e' pervenuta la comunicazione postale. In questo caso occorre fornire le seguenti informazioni: Codice Cliente = Codice Prodotto = 5774-G13 Matricola Sistema = 5 cifre La Matricola Sistema e' reperibile nel pannello emesso automaticamente. Per continuare l'installazione del programma e permettergli di eseguire tutte le sue funzioni e' necessario fornire il Codice di Autorizzazione all'uso e l'anno di Validita'. Se i codici sono noti nel momento della emissione automatica del pannello occorre: premere Invio sul successivo pannello immettere i codici forniti dall'ibm ripetere una seconda volta, per verifica, la immissione degli stessi codici Se invece i codici non sono noti nel momento della emissione automatica del pannello occorre uscire dal pannello con il tasto funzionale allo scopo predisposto. Nota: Immissione differita del Codice di Autorizzazione: Sara' sempre possibile immettere i codici in un secondo momento tramite il comando: ACGGAA/KPWACQ CDPRO('5774-G13') che ripresentera' il pannello Codice di Autorizzazione all'uso sopra descritto. La Immissione differita del Codice di Autorizzazione va utilizzata anche nel caso in cui, durante l'esecuzione delle funzioni del programma, ne venga segnalata la scadenza o la non corretta impostazione. Se, dopo una corretta immissione, si dovessero ancora ricevere segnalazioni di errore, sara' necessario rivolgersi nuovamente all'ibm. Per ogni evenienza Vi consigliamo di conservare i dati qui di seguito elencati: Codice Cliente = Installazione 27

34 Codice Prodotto = 5774-G13 Matricola Sistema = Codice Autorizzazione = Anno di Validita' = Nota: Se il Codice di Autorizzazione all'uso e l'anno di Validita' non sono stati immessi correttamente il prodotto non e' attivato e pertanto non utilizzabile. Proseguire con la installazione. 4. Installazione archivi a. Sul pannello "Guida Installazione prodotti" immettere la scelta 2 in corrispondenza di "ACG Contabilità Analitica", e premere Invio; le operazioni successive saranno indicate a terminale. Gli archivi vengono installati nella libreria dati e nella libreria SQL selezionate dall'utente. I valori standard proposti dal sistema per queste due librerie sono ACG_DATV2 e ACG_SQLV2. E' necessario che, ad ogni libreria dati venga associata una ed una sola libreria SQL. Il codice del Menu iniziale del programma, HC00, viene automaticamente inserito nel Menu iniziale standard ACG2 dell'ambiente. Notare che tutti i messaggi inerenti questa attivita' non sono bloccanti; il codice del Menu iniziale del programma potra' essere inserito manualmente, in ogni ambiente, con la funzione "Manutenzione File Menu" del programma ACG Modulo Base. Si puo' accedere a tale ambiente con il profilo ACG2USER (parola d'ordine ACG2USER) che e' stato creato durante l'installazione del prodotto ACG 'Gestione archivi'. 5. Installazione programmi sorgenti Questo passo non e' necessario per il funzionamento del programma, in quanto i sorgenti (forma simbolica degli eseguibili) vengono distribuiti per consentire eventuali personalizzazioni. Per eseguire l'installazione della libreria dei sorgenti del prodotto e' necessario immettere la scelta 5 in corrispondenza di "ACG Contabilità Analitica" Sul pannello "Guida Installazione prodotti" e premere Invio; le operazioni successive saranno indicate a terminale. I programmi sorgenti vengono installati nella libreria standard ACGSCC2. 6. Cumulativo CC per As/400 Risc (CC per As/400 Cisc) Sul supporto magnetico e' presente il cumulativo delle PTF emesse per il prodotto fino al 15/11/2001. Per installare il cumulativo, ripristinare la relativa libreria tramite il comando: RSTLIB SAVLIB(CC227180) DEV(nome_unita') Successivamente stampare le istruzioni di installazione del cumulativo tramite il comando: 28 ACG Contabilità Analitica Program Directory

35 STRSEU SRCFILE(CC227180/READ.ME) SRCMBR(READ.ME) OPTION(6) ed eseguire i passi riportati in tali istruzioni. Da questo momento non e' piu' necessario avere in linea il supporto magnetico. 7. Operazioni di chiusura a. Sul pannello "Guida Installazione prodotti" terminare con F3 b. Al termine della sessione viene prodotta la stampa del Log delle operazioni eseguite nella coda QEZJOBLOG. Per verificare se inavvertitamente non siano stati notati a terminale eventuali messaggi di anomalie, si consiglia di visualizzarla, da una qualsiasi sessione di lavoro (es. Utente QPGMR), con il comando: WRKSPLF installa. Modifica della lista di librerie Una volta effettuata l'installazione degli archivi e' necessario: 1. aprire una sessione con il profilo ACGMASTER 2. entrare nella funzione Gestione Sistemi informativi 3. selezionare l'opzione 2=Variazione 4. indicare il nome del Sistema informativo (ACG2USER oppure altri sistemi informativi eventualmente creati) 5. modificare la lista di librerie del Sistema informativo aggiungendo il nome della libreria SQL selezionata durante l'installazione archivi. 6.2 Avviamento del prodotto ACG Contabilità Analitica Per l'avviamento del prodotto consultare la Guida Applicativa, Parte 2: Avviamento e Gestione operativa. Si ricorda che prima di procedere ai passi di Avviamento occorre aver memorizzato nel sistema il Codice di Autorizzazione all'uso e l'anno di Validita'. Installazione 29

36 7.0 Ambienti Multipli E' possibile creare piu' Sistemi Informativi, ovvero piu' Data base, o Librerie Dati, in dipendenza delle esigenze applicative. Per installare gli archivi dei programmi desiderati in Librerie Dati diverse da quella propria dell'ambiente proposto, il passo precedentemente descritto di Installazione archivi va ripetuto per ogni ambiente desiderato, ovvero sul pannello "Guida Installazione prodotti", e' sufficiente immettere la scelta 2 in corrispondenza dei programmi desiderati e cambiare, nel pannello successivo, il nome della libreria che viene proposto. La sequenza di installazione degli archivi di piu' programmi in una stessa libreria dati deve rispettare le condizioni di prerequisito. Una volta effettuata l'installazione degli archivi e' necessario: 1. aprire una sessione con il profilo ACGMASTER 2. entrare nella funzione Gestione Sistemi informativi 3. selezionare l'opzione 2=Variazione 4. indicare il nome del Sistema informativo (ACG2USER oppure altri sistemi informativi eventualmente creati) 5. modificare la lista di librerie del Sistema informativo aggiungendo il nome della libreria SQL selezionata durante l'installazione archivi. I passi 4. e 5. vanno ripetuti per tutti i sistemi informativi eventualmente creati Si ricorda che e' necessario associare una ed una sola Libreria SQL ad ogni Libreria Dati creata. Gli eventuali interventi manuali di modifica del file Menu possono essere effettuati tramite la funzione "Manutenzione File Menu" aprendo una sessione di lavoro con il nome Utente al quale e' stato associato il nuovo Sistema Informativo. Tali operazioni possono essere effettuate in qualsiasi momento, anche successivo alla fase di installazione. La installazione del programma ACG Contabilità Analitica e' terminata. 30 Copyright IBM Corp. 1998, 2001

37 Modulo di commento Program Directory per ACG Contabilità Analitica Versione 2 R07M01 Con riferimento alla legge 675/96 sulla tutela della privacy Vi autorizzo ad utilizzare i dati da me riportati nel presente modulo. Questo foglio e' stato predisposto per poter dare la Vostra opinione su questo documento, la sua organizzazione, forma e contenuto. Se desiderate compilarlo, tenere presente che la IBM puo' usare e distribuire le informazioni ricevute in qualsiasi modo ritenga opportuno senza con cio' incorrere in alcun obbligo verso di Voi. Per ciascun punto qui riportato indicare il Vostro livello di soddisfacimento segnando un valore nella scala di valutazione. Per i punti di non applicabilita' indicare N. SCALA DI VALUTAZIONE Molto Molto non soddisfatto <=====================> insoddisfatto applicabile N Valutazione Facilita' di installazione N Contenuto della program directory N Uso dei Programmi di Verifica della installazione N Tempo necessario per installare il prodotto N Leggibilita' ed organizzazione dei capitoli N Necessita' di tutti i passi di installazione N Accuratezza nelle indicazioni fornite nei passi di installazione Livello tecnico delle indicazioni fornite nei passi di installazione N N Facilita' ad avviare l'applicazione dopo la installazione N E' la prima volta che la Vostra societa' installa questo prodotto? Si No Le persone che hanno effettuato la installazione avevano gia' esperienza con altre installazioni di questo prodotto? Si No 31

38 Se si, da quanti anni? 32 ACG Contabilità Analitica Program Directory

39 Se avete qualsiasi commento da fare circa le valutazioni sopra esposte, o su qualsiasi altro aspetto legato alla installazione del prodotto, potete esprimerlo qui di seguito: Per un successivo contatto indicare: Nome e qualifica Societa' Indirizzo Telefono Grazie per la Vs cortese partecipazione. Il Modulo di Commento puo' essere inviato direttamente, o consegnato al Vs rappresentante IBM che lo fara' recapitare al gruppo di sviluppo del programma ACG Contabilità Analitica presso: IBM Italia S.P.A. Application Product Development Center IBM S. PALOMBA Via Ardeatina Km. 22, Roma Italia Modulo di commento 33

40 IBM Stampato in Italia GI