DB2XTool2  
di Antoon van Os


 
Programma di utilità open source per il DB2 del System i

Il successore 2008 del famoso db2xtool

 
   Conversione di file database nei formati PC

DB2XTool2 è un programma di utilità open source scritto in RPG-ILE e CL-ILE da un appassionato che desidera restare anonimo.

Il programma consente di convertire un file database in uno stream file IFS in uno dei formati PC specificati qui di seguito.

Formati PC supportati e programmi PC corrispondenti:
comandoformato
dell'stmf
programma
PC
RUNEXCEL.csvExcel
RUNIEX.htmlInternet browser primario
RUNXML.xmlInternet browser primario
RUNNOTEPAD.txtNotepad

Se lanciato da un lavoro interattivo 5250, il programma - dopo aver generato lo stream file partendo dal file database specificato - lancia un comando PC che attiva il programma PC opportuno facendogli leggere lo stream file.

In alternativa, questo programma può essere invocato a seguito di una richiesta HTTP (per esempio, elaborata da un CGI) e generare un stream file visualizzabile tramite un'opportuno collegamento (link) disposto nell'HTML di risposta. Per esempio, se lo stream file generato fosse un CSV, premendo il collegamento se ne provocherebbe la visualizzazione tramite Excel.
In tal caso bisognerà però ricordarsi di aggiungere la direttiva HTTP:
   AddType application/x-excel .csv
Ecco un piccolo esempio.

   Prerequisiti
  • OS/400 Rilascio 5.3 o successivo
  • Libreria QIWS (5722SS1 opzione 12 - Host Services)
  • Libreria QSQL (Numero prodotto 5722ST1 opzione *BASE - DB2 Query Manager and SQL Development Kit)
  • Libreria QRPGLE (Numero prodotto 5722WDS opzione 31 - Compiler - ILE RPG IV)
  • IBM iSeries Access for Windows (Client Access)

   Installazione
  • scompattare il file PC db2xtool2.zip
  • trasmettere in binario il file PC db2xtool2.savf
    nel file di salvataggio qgpl/db2xtool2
  • rstlib lib(db2xtool2) dev(*savf) savf(qgpl/db2xtool2)
  • strrexprc srcmbr(install) srcfile(db2xtool2/qrexsrc)
Nota 1- La procedura REXX install alla fine del lavoro emette il comando DB2XSAV. Questo comando consente di salvare - a livello di profilo utente - i parametri dell'ultimo comando RUNEEXCEL/RUNIEX/RUNNOTEPAD/RUNXML utilizzato. I parametri salvati vengono reimpostati nel successivo comando dello stesso tipo lanciato dallo stesso profilo utente.
Il comando DB2XSAV può essere eseguito in qualunque momento.

   Funzionamento in ambiente interattivo
  1. Attivare sul PC una unità di rete connessa con il System i
  2. Sul System i attivare una sessione di emulazione 5250 del Client Access; questo fa in modo che il comando STRPCO (emesso dai programmi di DB2XTOOL2) possa funzionare
  3. Immettere i comandi
    -chgcurlib db2xtool2
    -addlible db2xtools
  4. Immettere uno dei comandi qui di seguito specificati.

I comandi fondamentali sono quattro:
Comando Converte
il DB in
Invoca
il programma PC
RUNExcel .csv stream file Excel
RUNIEX .html stream file default Internet browser
RUNNOTEPAD .txt stream file Notepad
RUNXML .xml stream file default Internet browser

Tutti i comandi hanno testo di aiuto.

Tutti i comandi hanno un parametro critico:

  • Servername (SERVERNAME) - Qui va specificato l'indirizzo IP del System i.
    In alternativa si può immettere il nome DNS del System i, purchè il PC sia in grado di capirlo decodificandone l'indirizzo IP.
    • Se il parametro SERVERNAME viene lasciato in bianco, il comando PC - che farebbe partire il relativo programma PC - non viene emesso.
    • Se il lavoro è un lavoro batch, il comando PC non viene emesso.
    Si noti che lo stream file IFS - contenente lo script HTML/CSV/TXT/XML - viene comunque sempre generato e può essere successivamente visualizzato tramite HTTP (a patto che siano state predisposte le direttive HTTP indispensabili) oppure scaricato tramite FTP.

   Funzionamento in ambiente batch
I quattro comandi di cui sopra possono essere eseguiti anche in ambiente batch (per esempio, da parte di un programma WEB).
In questi casi il comando PC non viene eseguito, ma lo stream file IFS viene comunque sempre generato.

Ancora un comando ...
Il comando RUNWINAPP - emesso in ambiente interattivo di emulazione 5250 - consente di emettere sul PC il comando specificato. In pratica si consiglia di utilizzarlo per attivare il browser Internet su una data URL.

   Scarico
Per scaricare DB2XTOOL2, basta premere il bottone "Download now".
E' però obbligatorio registrarsi al sito Easy400, se questo ancora non è stato fatto.

download now

 
contact us prendi contatto