Information Retrieval

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

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

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/400... 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 ) 792302301-003227353819 fax (00 32) 27353819 oppure SAP sas., via dei Nebrodi 55, Palermo (Italy), Tel. (091) 521145, Fax (091) 520194 E-mail sapsas@tin.it sito www.icarosap.it 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

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 SC38-3047 SAA ImagePlus/400 General information manual GC38-3044 SAA ImagePlus/400 Planning and installation Guide GC38-3045 SAA ImagePlus Workfolder application facility/400 Message and codes SC38-3048 SAA ImagePlus Workfolder application facility/400 Programming interfaces SC38-3049 PS/2 ImagePlus Workstation Program Operation Guide SC09-1324 SAA ImagePlus/400 Workstation Program/2 Programmers Guide ICARO - Guida utente ii ICARO Guida Programmatore

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

Capitolo 3. Gestione documenti..................... 3-1 Struttura dei file di ICARO: File TEXRAAA e TEXDAAA.............................. 3-1 File di lavoro TEWRAAA e TEWDAAA...................... 3-2 File assegnazione numero identificativo:texaret e TEXAGAN... 3-3 Selezione di un documento da revisionare: TEXT11.. 3-4 Assegna o proteggi il contenuto di un campo: EXTAUT.. 3-7 Definire un help sui campi formattati: EXTHF... 3-9 Definire un help sui singoli paragrafi: EXTHP... 3-10 Routine controllo contenuto dei campi formattati: EXTCOF.. 3-11 Routine controllo contenuto dei paragrafi: EXTCOP. 3-12 Routine controllo cancellazione documento: EXTDEL... 3-13 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/EXTIMPO2 3-17 Esportare verso l office (.doc,.rft,.html,.txt) EXTEXPO 3-19 Tre metodi per esportare documenti ICARO a office........... 3-20 Importare un membro di file sorgente: TEXT15T.. 3-21 Importare un documento office in un file ICARO: TEXT16T... 3-22 Capitolo 4. Leggere un campo o paragrafo................ 4-1 Lettura di un campo formattato: TEWSFFF................... 4-1 Lettura campo variabile (2000 o 9999 car.): TEWSPPP/TEWSPP9 4-2 Lettura campo variabile (senza limite di lunghezza): TEWS000.. 4-3 Lettura delle righe di intestazione di un paragrafo RTVINPAR. 4-4 Invertire un campo arabo: ARAB.... 4-5 iv ICARO Guida Programmatore

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

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

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

paragrafo a gestione protetta TEWSXXX.............. 12-11 viii ICARO Guida Programmatore

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

Capitolo 16 La libreria ICAWIN: API per Windows per l interfaccia grafica ICAROPc Informazioni sulla libreria ICAWin............................. 16-1 Descrizione dell'ambiente..................................... 16-3 Le strutture dati di Icawin............................. 16-5 Le funzioni di ICAWin............................. 16-20 ICA_Init..................................... 16-20 ICA_RMsg...................................... 16-22 ICA_RTxt........................................ 16-24 ICA_LDBA........................................ 16-26 ICA_RtFdDB........................................ 16-28 ICA_RtTbLT........................................ 16-31 ICA_RtTbLD........................................ 16-33 ICA_RtvDiz........................................ 16-35 ICA_SndQry........................................ 16-38 ICA_RtvOcc........................................ 16-41 ICA_DSPLI........................................ 16-43 ICA_DSPDO........................................ 16-46 ICA_RtvNav........................................ 16-49 ICA_Call........................................ 16-51 ICA_End........................................ 16-53 L interfaccia di accesso ai programmi esterni....................... 16-55 Capitolo 17 L interfaccia INTERNET Informazioni sui moduli IcaNET e IcaBWS........................ 17-1 Il modulo ICANET Descrizione dell'ambiente..................................... 17-3 Le variabili di inizializzazione di IcaNet11 ed il file dei messaggi IcaNet11.str..................................... 17-7 Il file di accounting Account.ica.............................. 17-10 I programmi di IcaNet..................................... 17-11 INLogon.exe..................................... 17-11 INIProc.exe..................................... 17-13 INLMsg.exe..................................... 17-16 INSelDB.exe..................................... 17-17 INNote.exe..................................... 17-19 x ICARO Guida Programmatore

INQuery.exe................................. 17-20 INQryRes.exe..................................... 17-22 INOcc.exe..................................... 17-30 INOption.exe..................................... 17-31 La libreria statica CGITools.obj.................... 17-33 La libreria statica ICAPage.obj.................... 17-35 Il modulo IcaBWS Descrizione dell'ambiente IcaBWS..................... 17-53 Le sezioni del file SessionF.ica........................... 17-54 General................................. 17-54 Logon................................. 17-56 InitProc................................. 17-57 UserMessage................................ 17-58 DBNote................................ 17-58 DBSelect................................ 17-59 TableList................................. 17-59 Table................................ 17-60 Dictionary................................. 17-60 Query................................. 17-61 QueryResult................................. 17-62 Occurence................................. 17-63 Navigation................................. 17-64 NavigationMenu........................... 17-65 Logoff................................. 17-65 ICARO Guida Programmatore xi

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 999 - 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

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

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 001-330) 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 00000000. - Alla partenza del sottosistema QICARO per ciascun lavoro terminato. - Attraverso la procedura TXTRIORGA. ICARO Guida programmatore 1-1 Richiamo Applicazioni

Richiamo del video di logon di ICARO Per richiamare il menu iniziale eseguire: CHGJOB SWS('00000000') CHGJOB SWS('00000001') CALL ICA$BAS/TEXMAN oppure Nel richiamare TEXMAN, il valore SWS '00000000' pone la sessione terminale in stato di SIGNOFF quando l'utente esce da ICARO. Con il valore '00000001' 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 00000010 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

Richiamo del menu principale ICARO Per richiamare il menu iniziale eseguire: CHGJOB SWS('00000000') CHGJOB SWS('00000001') CALL ICA$BAS/TEXMAN2 oppure Nel richiamare TEXMAN2, il valore SWS '00000000' pone la sessione del terminale in stato di SIGNOFF quando l'utente esce da ICARO. Con il valore SWS '00000001' 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('00000000') CHGJOB SWS('00000001') CALL ICA$BAS/DEFICA oppure Nel richiamare DEFICA, il valore SWS '00000000' pone la sessione terminale in stato di SIGNOFF quando l'utente esce da ICARO. Con il valore SWS '00000001' l'utente ritornerà al programma o menu chiamante o alla videata da cui il menu è stato richiamato. ICARO Guida programmatore 1-3 Richiamo Applicazioni

Richiamare il menu ICARO RGZICA (Gestione operativa delle banche dati) Per richiamare il menu (corrispondente all'opzione 8 del menu Principale) eseguire: CHGJOB SWS('00000000') CHGJOB SWS('00000001') CALL ICA$BAS/RGZICA oppure Nel richiamare RGZICA, il valore SWS '00000000' pone la sessione terminale in stato di SIGNOFF quando si lascia ICARO. Con il valore '00000001' 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

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

Pagina vuota Richiamo Applicazioni 1-6 ICARO Guida Programmatore

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