Information Retrieval

Transcript

1 I C A R O/400 Information Retrieval IBM Application System/400 Guida per il programmatore (ICARO, IcaroPc, IcaNet) Versione 4.0 Marzo 2004

2

3 Gaetano SAVONA Versione Marzo 2004 SAP sas Via dei Nebrodi, 55 Palermo (Italy)

4

5 Informazioni su questo manuale Questo manuale illustra come installare, avviare e lavorare con ICARO/400 per risolvere la indicizzazione totale di testi liberi non strutturati su IBM AS/400. Questo manuale è stato realizzato da SAP sas - Italy. Il copyright è della SAP sas e non ha alcun legame o obbligazione con la IBM company. I seguenti termini o logo, usati in questo manuale sono marchi registrati della IBM International Business Machine corporation: IBM ImagePlus AS/400 OS/2 PS/2 Personal System/2 SAA OfficeVision/ ICARO/400 è un prodotto della SAP sas. Dr. Gaetano Savona; Per ulteriori informazioni contattare TIS Text Information Systems, Svizzera - centro internazionale di supporto e distribuzione del prodotto ICARO: T.I.S SA, Kybourg 1, CH 1700, Fribourg Tel. (00 41 ) fax (00 32) oppure SAP sas., via dei Nebrodi 55, Palermo (Italy), Tel. (091) , Fax (091) sapsas@tin.it sito A CHI SI RIVOLGE QUESTO MANUALE Questo manuale è indirizzato all'amministratore delle banche dati, ai progettisti delle banche dati ed ai programmatori per lo sviluppo di procedure di backup e restore automatizzate, per la realizzazione di interfacce utente per facilitare l'interrogazione, per integrare banche dati ed applicazioni utente con banche dati ICARO, per realizzare interfacce web ed integrazioni con oggetti multimediali. I gestori di banche dati ed i programmatori ICARO devono avere una conoscenza di base dell'application System/400 (IBM AS/400) e delle procedure per la sicurezza dell'as/400. ICARO Guida Programmatore i

6 Informazioni collegate On Line e stampate Il Programmatore e l'amministratore troverà in questo manuale ed anche nella Guida 'on line' le istruzioni fondamentali per realizzare applicazioni di information retrieval personalizzate e per integrare applicazioni utente con ICARO utilizzando le A.P.I. (Application Programming Interface) qui descritte. Inoltre, il programmatore dovrebbe leggere il manuale "ICARO: Guida per l'utente" per sapere come installare l'applicazione ICARO, definire una banca dati, e gestire e ricercare documenti. Altre informazioni si trovano in una banca dati ICARO on line o sul nastro del prodotto in licenza ICARO. Altri manuali SAP/TIS ed IBM contengono informazioni correlate: TIS ICARO-ImagePlus Interface - administration TISDOCi04 TIS ICARO-ImagePlus Interface - User's guide TISDOCi05 SAA ImagePlus/400 System Administrator's Guide SC SAA ImagePlus/400 General information manual GC SAA ImagePlus/400 Planning and installation Guide GC SAA ImagePlus Workfolder application facility/400 Message and codes SC SAA ImagePlus Workfolder application facility/400 Programming interfaces SC PS/2 ImagePlus Workstation Program Operation Guide SC SAA ImagePlus/400 Workstation Program/2 Programmers Guide ICARO - Guida utente ii ICARO Guida Programmatore

7 I n d i c e Introduzione I-1 Capitolo 1. Richiamo delle applicazioni ICARO Iniziare una sessione ICARO, creazione ambiente di lavoro (CRTAUTUSE) e chiusura corretta della sessione Richiamo del video di logon Richiamo del Menu Principale Richiamo del Menu DEFICA (Definire ICARO) Richiamo del Menu Gestione tabelle Richiamo del Menu Gestione del Dizionario Richiamo del Menu Funzioni Operative Capitolo 2. Richiamo delle funzioni di ICARO Aprire la sessione ICARO Richiamo menu gestione documenti: TEXGES Richiamo funzione gestione di un documento: TEXGESDOC Richiamo funzione interrogazione documenti: TEXINQ Creazione procedure per l'amministrazione delle banche dati Richiamare la riorganizzazione della banca dati: TXTRIORGA. 2-5 Salvataggio di una banca dati: SAVEDBICA Salvataggio di tutte le banche dati: SAVEDB Salvataggio degli oggetti multimediali di una banca dati SAVDBIFS. 2-7 Salvataggio procedure.exe della directory IFS. SAVIFS Ripristinare una banca dati: RSTDBICA Ripristino degli oggetti multimediali di una banca dati RSTDBIFS. 2-9 Ripristino procedure.exe delle directory IFS. RSTIFS 2.9 Ricostruzione (totale) indici banca dati: SUBIDXTOT/IDXTOT Ricostruzione (parziale) indici banca dati: SUBIDXWOR/IDXWOR Aggiornamento indici: SUBAGDOC/TEXUPDOC Emissione su stampa o su file del dizionario TEXT08Px ICARO Guida Programmatore iii

8 Capitolo 3. Gestione documenti Struttura dei file di ICARO: File TEXRAAA e TEXDAAA File di lavoro TEWRAAA e TEWDAAA File assegnazione numero identificativo:texaret e TEXAGAN Selezione di un documento da revisionare: TEXT Assegna o proteggi il contenuto di un campo: EXTAUT Definire un help sui campi formattati: EXTHF Definire un help sui singoli paragrafi: EXTHP Routine controllo contenuto dei campi formattati: EXTCOF Routine controllo contenuto dei paragrafi: EXTCOP Routine controllo cancellazione documento: EXTDEL Routine di EXIT nella gestione di docum.: il tasto F20 EXTGES) 3-14 Routine dopo l'aggiornamento del documento: EXTCLDOC 3-15 Modifica videata/program di gestione campi formattati: TEZAAA 3-16 Importare docum.office (.doc,.html, rft, txt) EXTIMPO/EXTIMPO Esportare verso l office (.doc,.rft,.html,.txt) EXTEXPO 3-19 Tre metodi per esportare documenti ICARO a office Importare un membro di file sorgente: TEXT15T Importare un documento office in un file ICARO: TEXT16T Capitolo 4. Leggere un campo o paragrafo Lettura di un campo formattato: TEWSFFF Lettura campo variabile (2000 o 9999 car.): TEWSPPP/TEWSPP9 4-2 Lettura campo variabile (senza limite di lunghezza): TEWS Lettura delle righe di intestazione di un paragrafo RTVINPAR. 4-4 Invertire un campo arabo: ARAB iv ICARO Guida Programmatore

9 Capitolo 5. Altre routine Controllo termini di un campo o di righe di testo TEXT21R Accesso a tabelle di riferimento ICARO: TEXT Duplica una tabella di riferimento ICARO: DUPTAB Accesso alla lista di banche dati autorizzate: TEX05A Reperire il codice di lingua di un utente: RTVLANGU Allocare /bloccare una banca dati: LCKDB Verifica dei lavori attivi in una banca dati: TESTJOB Rilascia le librerie di lavoro utente WICA000xxx: INQDLTSP Visualizzazione di un membro di file sorgente: TEXMSGP Modifica righe membro source TXTTOPCX Testare l ambiente di lavoro (batch/interattivo) TYPEJOB Marginare un testo : TEXT13CB Capitolo 6. Caricare/scaricare una banca dati a) caricare documenti via batch ADDDOC/ADDDOCB. 6-1 Formato file di input (TEWLOG) b) Reperire documenti RTVDOC/RTVDOCB. 6-7 Formato di file di output (TEWLOG) Applicazioni Recupero/svuotamento/caricamento documenti Banche dati parallele Recuperare/unire informazioni esterne Creare una sotto banca dati Modificare globalmente campi/paragrafi specifici Capitolo 7. Programma guida: TEXBAT Il sorgente TEXBAT Routine SELOP Routine WRKDOC Routine GESDOC Routine di RESET Routine AGGDOC ICARO Guida Programmatore v

10 Capitolo 8. Autorizzazioni Assegnare ad un utente un profilo di riferimento: TXADUP Modifica, per un profilo, delle limitazioni di accesso a documenti (CHGQRYLMT) Capitolo 9. Interrogazione su banche dati Quadro generale Esempio dell'interfaccia di interrogazione. (TURBO INQDIR) Esempio di exit per banca dati (programma EXTINQ Descrizione delle routine API Apertura della sessione di interrogazione INQOPNSP. 9-3 Attivazione banca dati: INQSETDB. 9-3 Formulazione interattiva della domanda: INQR Programma per la formulazione della domanda: PGMxxx Formulazione di domanda in modo batch INQSNQRY. 9-7 Controllo domanda: INQCHK Attivazione formato visualizzazione/stampa TEXINQF/INQSETFO 9-10 Reperire il risultato della domanda - RTVRSL Visualizza lista delle ricorrenze dell'ultima domanda: INQDSPOC Selezione del tipo di output del risultato: INQDSPOP 9-12 Visualizzazione dei documenti estratti: INQDSPDO Visualizza lista abbreviata documenti: INQDSPLI/INQDSPLX Stampa dei documenti estratti: INQSNPRT Procedura di estrazione dei documenti: INQEXCES Routine di EXIT di visualizzazione documenti: EXTINQ Visualiz. documento con numero. di riferimento: DSPDOC Chiusura di una sessione di interrogazione INQDLT Esempi di navigazione ipertestuali Modifica una procedura di estrazione per aggiornare direttamente un data base utente vi ICARO Guida Programmatore

11 Altre routine Reperire le banche dati attive per l interrogazione e l ultimo numero di livello RTVOPNDB Reperire alcuni termini di una banca dati RTVTERM Capitolo 10. Ricorsività di programmi La routine CRTRCR Capitolo 11. Esempi di estrazione/trasferimento dati Istogramma di frequenza (TEXDIAALF TEXDIANUM) Trasferire su PC il file risultato di una procedura di estrazione. EXTEXPD Realizzare prospetti con totali o calcoli dopo l'interrogazione Converti un membro source/text Management in RTF, HTML o ASCII con output in un membro source e in un file system AS.....TXTTOPC Converti ed esporta un membro source/text Management in RTF, HTML o ASCII in un file system AS, server di rete o pc locale DOCTOPC Importa e converti un documento office.doc rtf htm in un membro di file source. DOCTOAS Trasferim. da server PC a IFS AS400 e viceversa PCTOPC 11-9 Convertire un documento ICARO, nel formato di visualizzazione, in un membro di file source. DOCTOMBR Leggere il contenuto di una DIR e trasferirla in un membro source RTVDIR Funzioni windows (.exe.bat) utilizzabili dall utente BROWSER.bat visualizzazione documenti e oggetti multimediali COPIA.exe copia oggetti documenti e multimediali EXEWORD.bat lancio del word di uno specifico docum TXTCONV.exe e LISTACONV. Exe conversione documenti SCAN2PDF.exe scansione documenti in formato pdf Capitolo 12. Paragrafi in modalità protetta (campi formatati) Introduzione Regole di codifica dei paragrafi Generazione dei programmi per la gestione in modalità protetta ) Compilazione dei paragrafi ) Assegnazione attributi di controllo ) Crea un testo di help per il paragrafo ) Personalizzazioni del display file e dei programmi generati Immissione dei dati e controlli nei paragrafi in modalità protetta Eliminare la gestione protetta per un paragrafo Routine di lettura o aggiornamento di un campo formattato di un ICARO Guida Programmatore vii

12 paragrafo a gestione protetta TEWSXXX viii ICARO Guida Programmatore

13 Capitolo 13. Immagini / Telex / Fax Esempi forniti con ICARO Metodo generale per lo scanner Metodo generale per la visualizzazione Prove di TEST con le banche dati dimostrative a) Visualizzazione immagini e file multimediali b) Acquisizione Immagini (scansione) L'integrazione ImagePlus Visualizza immagini di documenti ICARO in pagine Html Integrazione Telex Capitolo 14. Ottimizzazione: indicizzazione/spazio disco Per ottimizzare l'attività di indicizzazione Per ottimizzare lo spazio su disco Capitolo 15. ICAROPc/ICANET note tecniche Le API AS/400 per personalizzare box WINDOWS o pagine HTML Il Flusso dell applicazione ICAROPc/ICANET la procedura di Exit call ICALOGON Invio di una box o menu iniziale da host -MEXTINQ la funzione STRBOX Righe di intestazione box Righe di testo e campi di input Definizione dei bottoni Attributi campi di input Box in sovrapposizione o in sostituzione -Liste record Lista delle librerie la funzione STRQRY la funzione di navigazione il pgm PEXTINQ la procedura di Exit call ICALOGOF Esempi di interrogazione diretta con link da Pagine HTML ICARO Guida Programmatore ix

14 Capitolo 16 La libreria ICAWIN: API per Windows per l interfaccia grafica ICAROPc Informazioni sulla libreria ICAWin Descrizione dell'ambiente Le strutture dati di Icawin Le funzioni di ICAWin ICA_Init ICA_RMsg ICA_RTxt ICA_LDBA ICA_RtFdDB ICA_RtTbLT ICA_RtTbLD ICA_RtvDiz ICA_SndQry ICA_RtvOcc ICA_DSPLI ICA_DSPDO ICA_RtvNav ICA_Call ICA_End L interfaccia di accesso ai programmi esterni Capitolo 17 L interfaccia INTERNET Informazioni sui moduli IcaNET e IcaBWS Il modulo ICANET Descrizione dell'ambiente Le variabili di inizializzazione di IcaNet11 ed il file dei messaggi IcaNet11.str Il file di accounting Account.ica I programmi di IcaNet INLogon.exe INIProc.exe INLMsg.exe INSelDB.exe INNote.exe x ICARO Guida Programmatore

15 INQuery.exe INQryRes.exe INOcc.exe INOption.exe La libreria statica CGITools.obj La libreria statica ICAPage.obj Il modulo IcaBWS Descrizione dell'ambiente IcaBWS Le sezioni del file SessionF.ica General Logon InitProc UserMessage DBNote DBSelect TableList Table Dictionary Query QueryResult Occurence Navigation NavigationMenu Logoff ICARO Guida Programmatore xi

16

17 INTRODUZIONE. L Ambiente operativo Per una buona operatività del software è necessario quanto segue: che il sottosistema QICARO sia fatto partire preferibilmente alle IPL di sistema; aggiungere, a tal fine, nel programma di start il comando: STRSBS ICA$BAS/QICARO. RLSJOBQ ICA$BAS/QICAIMM RLSJOBQ ICA$BAS/ICARO RLSJOBQ ICA$BAS/ICARO1 All avvio del sottosistema QICARO viene lanciato automaticamente il lavoro RSTSPC che provvede a chiudere eventuali aree di lavoro WICA000xxx connessi a lavori chiusi in modo anomalo. Che non vengano rimosse dalla lista delle librerie, nelle funzioni di exit controllate dall utente, le librerie di lavoro che il software ICARO o le sue routine aggiungono nella lista delle librerie. Le librerie utilizzate dal software sono generalmente ICA$BAS (contenente programmi e files applicativi), WICA000xxx (libreria di lavoro assegnata alla sessione utente) e ICA$xxx (con xxx tra 001 e librerie contenenti I files delle banche dati). NOTE SULLE AREE DI LAVORO. Per ciascuna sessione di lavoro ICARO viene associato a ciascun terminale o lavoro una libreria contenete I files temporanei per l interrogazione di banche dati o per processi di gestione. Nel sistema verranno create un certo numero di librerie di lavoro denominate WICA000xxx (con xxx tra 001 e 330) come duplica della libreria modello WICA$W. Il numero di librerie precreate sono corrispondenti al numero che l utente ha impostato nel menu di definizione ICARO opzione 10 (livello medio di attività). Questo numero dovrebbe essere corrispondente al numero massimo di sessioni (utenti) CONTEMPORANEAMENTE attivi. ICARO Guida Programmatore I - 1 Introduzione

18 L associazione terminale - area di lavoro viene effettuata dalla procedura CRTAUTUSE che assegna la prima libreria WICA000xxx disponibile al terminale che ha iniziato la sessione. Il programmatore deve quindi curare: di immettere nei propri programmi o Menu che utilizzeranno Api o funzioni ICARO, il richiamo iniziale della procedura CALL ICA$BAS/CRTAUTUSE; di immettere nei propri programmi, prima del comando SIGNOFF, il richiamo della procedura di chiusura della sessione ICARO: CALL ICA$BAS/INQDLTSP ( ). Questa procedura renderà disponibile la libreria di lavoro WICA000xxx per altri utenti ATTENZIONE: La procedura INQDLTSP deve essere richiamata esclusivamente prima del comando SIGNOFF. Difatti, l esecuzione di tale procedura non produrrà alcuna disallocazione dell area WICA000xxx se il JOB risulterà attivo. Se il programmatore non provvederà a rilasciare le aree di lavoro per le sessioni di terminali che chiudono con SIGNOFF è probabile che in breve si esauriranno le librerie di lavoro WICA000xxx disponibili. In questo caso, automaticamente verrà avviato il lavoro INQRSTSP che provvederà a forzare la chiusura di quelle sessioni non più attive nel sistema. Viceversa, se il numero di sessioni ICARO contemporaneamente aperte supera il valore impostato dall utente, ICARO provvede a creare altre librerie di lavoro WICA000xxx (da 001 a massimo 330) e ad estendere il valore massimo impostato dall utente. Se le api o funzioni scritte dall utente sono eseguite all interno di uno dei menu ICARO (TEXMAN, TEXMAN2, DEFICA, RGZICA) non necessita avviare la procedura CRTAUTUSE essendo questa automaticamente avviata da questi menu. Se i menu ICARO (TEXMAN TEXMAN2 DEFICA o RGZICA) sono richiamati con lo switch U8 impostato a 0 non necessita eseguire alcuna procedura INQDLTSP in quanto i suddetti menu, prima del signoff, provvederanno ad eseguire la procedura di disallocazione dell area di lavoro. Al contrario, se da un menu utente si richiama uno dei menu ICARO con lo switch U8 impostato al valore 1 o una funzione di interrorrogazione, occorrerà, NEL PROGRAMMA O MENU UTENTE, prima del SIGNOFF (QUINDI COME ULTIMA ISTRUZIONE), immettere il comando CALL ICA$BAS/INQDLTSP ( ) (vedere la routine INQDLTSP).. Introduzione I - 2 ICARO Guida Utente

19 Capitolo 1. Richiamo delle applicazioni ICARO Iniziare una sessione ICARO (creazione ambiente di lavoro): CRTAUTUSE Per avviare una sessione ICARO prima del richiamo di una qualsiasi delle API ICARO o una delle funzioni ICARO, è necessario creare l ambiente di lavoro associata alla sessione di lavoro con il seguente comando: CALL ICA$BAS/CRTAUTUSE Con questo comando verrà eseguito: la creazione della libreria temporanea WICA000XXX (XXX tra ) associata al al lavoro. Questa libreria è una duplica della libreria modello WICA$W contenente I files di lavoro; il comando WRKLIB WICA* consente di visualizzare le librerie di lavoro WICA000xxx utilizzate. la creazione dell'user space SPICA in QTEMP relativa alle autorizzazioni concesse all utente; la creazione in QTEMP di una data area WRKICA contenente, nei primi 10 caratteri il nome della libreria di lavoro assegnata al job (WICA000xxx). L'ambiente di lavoro per una sessione utente rimarrà aperta, fino a che l'utente, prima del SIGNOFF del terminale o della fine del job non avvia il comando di chiusura e rilascio CALL ICA$BAS/INQDLTSP ( ). Eccezione: Se un utente inizia a lavorare con ICARO richiamando i menu di ICARO TEXMAN, TEXMAN2, DEFICA o RGZICA, il comando CRTAUTUSE è richiamato implicitamente dai menu. Chiudere una sessione / rimozione dell'ambiente di lavoro Un ambiente di lavoro è chiuso e rilasciato (disponibile così per un altro utente) dalla procedura INQDLTSP. Prima del rilascio della libreria temporanea WICA000XXX, i files relativi al giornale delle interrogazioni effettuate dall'utente (INQD e INQR) verranno aggiunti ai files del giornale generale delle interrogazioni (INQD$ e INQR$) in ICA$BAS. La procedura INQDLTSP è sottomessa nei seguenti casi: - Viene richiamata da un applicazione utente; - Dopo la chiusura di uno dei menu ICARO (TEXMAN, TEXMAN2, RGZICA, DEFICA) richiamato con il jobswitch impostato a Alla partenza del sottosistema QICARO per ciascun lavoro terminato. - Attraverso la procedura TXTRIORGA. ICARO Guida programmatore 1-1 Richiamo Applicazioni

20 Richiamo del video di logon di ICARO Per richiamare il menu iniziale eseguire: CHGJOB SWS(' ') CHGJOB SWS(' ') CALL ICA$BAS/TEXMAN oppure Nel richiamare TEXMAN, il valore SWS ' ' pone la sessione terminale in stato di SIGNOFF quando l'utente esce da ICARO. Con il valore ' ' l'utente ritornerà al programma o menu chiamante o alla videata da cui ICARO è stato richiamato. Se l utente utilizza delle interfacce grafiche e desidera non ricevere i messaggi di attesa (finestre senza risposta, ad esempio Attendere ) può mettere in ON anche lo SWS sette prima di chiamare il menu; in tal modo i messaggi del tipo Attendere, lavoro in esecuzione non verranno inviati. Exit utente - Exit1 - dal video di logon di ICARO Nome del programma: CAMERA Parametri: nessuno Dal video di logon di ICARO, si può richiamare l'exit1 (programma CAMERA) mediante l'opzione 3. La descrizione dell'opzione 3 sulla videata di Logon può essere modificata o personalizzata dal gestore del prodotto in ognuna delle lingue previste (menu DEFICA opzione 1, definizione prodotto ICARO --> opzione 4, modifica descrizione richiamo menu utente). Se la descrizione dell'opzione 3 è rimossa, non sarà mostrata l'opzione 3 nel video di Logon. L'opzione 3 è controllata dall'icaro security. Con l'exit1 (richiamo du un programma o menu di nome CAMERA scritto dall'utente) l'utente può accedere ad un suo programma per l'accesso a banche dati esterne, videate definite per l'utente o altre applicazioni. Richiamo Applicazioni 1-2 ICARO Guida Programmatore

21 Richiamo del menu principale ICARO Per richiamare il menu iniziale eseguire: CHGJOB SWS(' ') CHGJOB SWS(' ') CALL ICA$BAS/TEXMAN2 oppure Nel richiamare TEXMAN2, il valore SWS ' ' pone la sessione del terminale in stato di SIGNOFF quando l'utente esce da ICARO. Con il valore SWS ' ' l'utente ritornerà al programma o menu chiamante o alla videata da cui ICARO è stato richiamato. Exit utente - Exit2 - dal menu principale di ICARO Nome del programma: MENUUTE Parametri: nessuno Dal menu principale di ICARO, si può richiamare un Exit (programma MENUUTE) mediante l'opzione 9. La descrizione dell'opzione 9 del menu principale può essere modificata e personalizzata dal gestore del prodotto in tutte le lingue previste dal prodotto (menu DEFICA opzione 1, definizione prodotto ICARO --> opzione 4 modifica descrizione richiamo menu utente). Se la descrizione dell'opzione 9 è rimossa, non sarà visibile sul menu principale. L'opzione 9 è controllata dall'icaro security. Con l'exit2 (richiamo del programma MENUUTE scritto dall'utente) l'utente può accedere ad un suo programma o menu per l'accesso a banche dati esterne, videate definite per l'utente o altre applicazioni. Richiamare il menu ICARO DEFICA (Definire ICARO) Per richiamare il menu (corrispondente all'opzione 7 del menu Principale) eseguire: CHGJOB SWS(' ') CHGJOB SWS(' ') CALL ICA$BAS/DEFICA oppure Nel richiamare DEFICA, il valore SWS ' ' pone la sessione terminale in stato di SIGNOFF quando l'utente esce da ICARO. Con il valore SWS ' ' l'utente ritornerà al programma o menu chiamante o alla videata da cui il menu è stato richiamato. ICARO Guida programmatore 1-3 Richiamo Applicazioni

22 Richiamare il menu ICARO RGZICA (Gestione operativa delle banche dati) Per richiamare il menu (corrispondente all'opzione 8 del menu Principale) eseguire: CHGJOB SWS(' ') CHGJOB SWS(' ') CALL ICA$BAS/RGZICA oppure Nel richiamare RGZICA, il valore SWS ' ' pone la sessione terminale in stato di SIGNOFF quando si lascia ICARO. Con il valore ' ' l'utente ritornerà al programma o menu chiamante o alla videata da cui il menù è stato richiamato. Richiamare il menu ICARO "Gestione tabelle" Per richiamare il menu (corrispondente all'opzione 3 del menu Principale) eseguire, in ambiente interattivo: (l'esecuzione del comando CRTAUTUSE deve essere stato avviato almeno una volta nella sessione): CALL ICA$BAS/TEXTAB PARM(&CODDB) (se le tabelle di riferimento devono essere richiamate da un programma) oppure CALL ICA$BAS/TEXTAB PARM(X'yyyF') (dove yyy è 000 oppure un codice valido di banca dati) se le tabelle di riferimento devono essere richiamate dalla linea di comando)... CHGLIB CURLIB(*CRTDFT) parametri: &CODDB Tipo: *DEC Len: 3 è un parametro numerico di 3 cifre inizializzato a 0 (zero) se si vuole mostrare la lista delle banche dati autorizzate o con un codice esistente di banca dati per mostrare il menu per la specifica banca dati. Richiamo Applicazioni 1-4 ICARO Guida Programmatore

23 Richiamare il menu ICARO "Gestione del dizionario ICARO": Per richiamare il menu (corrispondente all'opzione 5 del menu Principale) eseguire, in ambiente interattivo: (l'esecuzione del comando CRTAUTUSE deve essere stato avviato almeno una volta nella sessione): CALL ICA$BAS/TEXVCB PARM(&CODDB) (se la gestione del dizionario deve essere richiamata da un programma) oppure CALL ICA$BAS/TEXVCB PARM(X'yyyF') (dove yyy è 000 oppure un codice valido di banca dati) se la gestione del dizionario deve essere richiamato da una linea di comando... CHGLIB CURLIB(*CRTDFT) parametri: &CODDB Tipo: *DEC Len: 3 è un parametro numerico di 3 cifre inizializzato a 0 (zero) se si vuole mostrare la lista delle banche dati autorizzate o con un codice esistente di banca dati per mostrare il menu per la specifica banca dati. Richiamo del menu ICARO "Funzioni operative" per il controllo delle stampe Per richiamare il menu (corrispondente all'opzione F6 del menu Principale) eseguire, in ambiente interattivo:... CALL ICA$BAS/TEXOPE RMVLIBLE ICA$BAS ICARO Guida programmatore 1-5 Richiamo Applicazioni

24 Pagina vuota Richiamo Applicazioni 1-6 ICARO Guida Programmatore

25 Capitolo 2. Richiamo delle funzioni di ICARO (Richiamo delle funzioni di ICARO da un'altra applicazione o da un interfaccia utente speciale) Aprire/chiudere una sessione di ICARO/Creare l'ambiente di lavoro Prima di richiamare una qualsiasi delle API ICARO o una delle funzioni esterne ad ICARO, per es. da un applicazione dell'utente, deve essere aperta una sessione di ICARO con il seguente comando: CALL ICA$BAS/CRTAUTUSE Vedi capitolo 1 per le note su questo comando. Richiamo del menu di gestione documenti (interattivo) : TEXGES Dopo aver aperto la sessione di ICARO con il comando CRTAUTUSE, per richiamare, da un proprio menu o da un programma utente, la funzione di gestione documenti (opzione 1 del menu) eseguire i seguenti comandi: CALL ICA$BAS/TEXGES PARM(&DBNBR) (se il programma deve essere richiamato da programma utente) oppure (CL o interattivamente): CALL ICA$BAS/TEXGES PARM(X'yyyF') (dove yyy è ØØØ o un codice valido di banca dati) per richiamare il programma da una linea di comando). Parametri: &DBNR Tipo: *DEC Lung: 3 è un parametro numerico di 3 cifre inizializzato a Ø (zero) per mostrare la lista delle banche dati autorizzate all'utente o con un codice esistente di banca dati di cui avviare la gestione dei documenti. esempio: CALL ICA$BAS/TEXGES PARM(X'ØØØF') (per visualizzare e selezionare dalla lista di banche dati autorizzate) CALL ICA$BAS/TEXGES PARM(X'ØØ5F') (per accedere direttamente alla 'gestione documenti' per la banca dati ØØ5.) ICARO Guida programmatore 2-1 Richiamo Funzioni