Web Cobol

PREMESSA Lambiente di sviluppo Web Cobol compila dei file .wc (web cobol : html+cobol) in file .wcp (web cobol pages : binari) che sono dei binari ACUCobol a tutti gli effetti i quindi eseguibili esclusivamente tramite il runtime ACUCobol-GT. Tutto lhtml utilizzato viene compilato allinterno del file .wcp e non necessario quindi che venga distribuito. I file compilati con Web Cobol possono essere eseguiti tramite i pi comuni web server presenti sul mercato (IIS,APACHE,ecc..) e su tutti i sistemi operativi supportati dal runtime ACUCobol-GT. Web Cobol sfrutta tutte le caratteristiche del compilatore ACUCobol-GT ed dunque compatibile al 100% con le applicazioni ACUCobol-GT standard. Lambiente di sviluppo pu essere installato e utilizzato in sistemi operativi Microsoft Windows o in sistemi operativi Linux con emulatore Wine.

INSTALLAZIONE E CONFIGURAZIONE Prerequisiti: Sistema Operativo Microsoft Windows o sistema operativo Linux con emulatore Wine. Internet Information Services (IIS) o APACHE. ACUCobol-GT 4 o superiore. Dreamweaver 7 o superiore facoltativo (pu essere utilizzato un qualsiasi altro editor per lo sviluppo di pagine web dinamiche) Configurazione Debugger: Connection: - Port : Porta TCP utilizzata dal debugger. Cambiare il valore proposto solamente se la porta 7237 gi utilizzata da un altro servizio. - User : Indicare il nome di un utente che ha i permessi per poter eseguire il compilatore dal browser e creare file nelle cartelle del progetto wc ( consigliato indicare lutente di windows corrente). - Password : Indicare la password relativa allutente scelto. Note: Lutente in questione serve per rendere possibile la compilazione del file wc direttamente dal browser tramite lisapi (wcisapi.dll). - Test Logon : Verifica la validit dellutente inserito. - Use https prefix : Selezionare il flag se si sta lavorando in un server web con protocollo SSL.

General: -

Compiler : Indicare il percorso completo del compilatore ACUCobol-GT Runtime : Indicare il percorso completo del runtime ACUCobol-GT Check debugger activity : avverte con un messaggio html sul browser qualora il debugger non fosse in esecuzione. Automatic execution : Selezionare il flag per far eseguire in automatico il debugger allavvio di sistema. Generate .bat file for Apache on : Genera un file .bat per ogni file wcp compilato, con la possibilit di utilizzare un template personalizzato (utilizzare la variabile @FILENAME@ allinterno del template per ottenere il path completo del file .wcp). Lopzione Unix imposta i caratteri di fine riga appropriati per il sistema operativo.

Folder:
-

Temporary folder: il debugger crea dei file temporanei che vengono creati per default nella stessa cartella che contiene il sorgente wc. Indicare una cartella diversa qualora si voglia modificare il comportamento di default.

Configurazione IIS: 1. 2. 3. 4. Eseguire Internet Information Services Entrare nelle propriet del Sito web Predefinito Selezionare Home directory Configurazione In Mapping premere il tasto Aggiungi ed inserire : Il runtime:

Il filtro isapi:

Configurazione APACHE: E importante sottolineare il fatto che in APACHE non pu essere eseguito il debug, ma possono essere solamente eseguiti i file .wcp attraverso il lancio dei relativi .bat autogenerati. SINTASSI WEB COBOL WEB DIVISION Un file .wc deve iniziare sempre con la WEB DIVISION allinterno della quale vanno inserite della parole chiave che servono per pilotare il debugger. Elenco dei valori possibili: Esegue il debug del file wcp compilato. Se viene specificato anche and show-html viene mostrato lhtml prodotto dal file in una finestra apposita. <percorso completo del file di configurazione runtime> : Indicare leventuale file di configurazione da passare al runtime per il lancio del programma in modalit debug.
EDIT-INPUT-VALUE : Genera una pagina che permette di editare i valori che il file wcp deve accettare. SHOW-INPUT-VALUE QUERY-STRING IS CONFIGURATION-FILE IS DEBUG-SOURCE [AND SHOW-HTML]:

: Genera una pagina dove vengono mostrati i valori passati al file wcp.

<stringa> : La stringa indicata viene passata in automatico al file wcp in query-string (Esempio: "variabile1=valore1&varaibile2=valore2").

di ubicazione delle copy> : Indica al compilatore ACUCobol-GT dove si trovano i file delle copy utilizzate nel file wc.
COPY-PATH IS <cartella

TAG @WebCobol.Include Il tag @WebCobol.Include pu essere inserito in qualsiasi posizione e mostra le seguenti propriet : FilePath=<file da includere> : Include un qualsiasi file esterno. Variables=<lista di variabili e valori> : Definizione delle variabili contenute nel file incluso nel formato : VAR1=VALORE1|VAR2=VALORE2 . Quando allinterno del file da includere viene posizionata una variabile tra @ (es : @VAR1@) il precompilatore vi sostituisce il suo valore (es : VALORE1). Separator=<carattere di separazione delle variabili> : Separatore di variabili. Di default vale '|'. LabelId=<stringa> : Indica la porzione del file da includere che deve essere copiata. LabelBegin (deve essere inserito nel file da includere): Definisce l'inizio di una porzione allinterno del file da includere. LabelEnd (deve essere inserito nel file da includere) : Definisce la fine di una porzione allinterno del file da includere. Note : I tag FilePath, LabelId , Variables, Separator vanno indicati tutti sullo stesso rigo. WEB FORM Allinterno della working-storage section viene definito un livello 01 di tipo web-form che viene poi inizializzato, come prima cosa, allinterno della PROCEDURE DIVISION:

DREAMWEAVER CONFIGURAZIONE Per configurare Dreamweaver occorre eseguire Macromedia Extension Manager e dal men File > Install Extension, selezionare il file WebCobol.mxp che si trova nella della directory Plugin allinterno della directory dinstallazione.

START UP Per creare un nuovo progetto entrare nel menu File > New , nella scheda General selezionare nella colonna di sinistra Dynamic page e a destra Web Cobol ed infine premere il pulsante Create.

COMPILAZIONE FILE Per compilare il file da dentro Dreamweaver occorre premere F12 a file .wc aperto. Se la prima volta che si esegue questa operazione vi verr mostrata la finestra in figura sulla quale si dovr premere il pulsante Yes.

Vi verr mostrata quindi una finestra di configurazione dove si dovranno impostare i percorsi in cui compilare il file e la radice dell URL con cui eseguire gli stessi sul browser web predefinito. Nelle figure seguenti vi un esempio che indica come directory di destinazione dei file compilati C:\WCP e come radice dell URL da richiamare per lesecuzione http://localhost/wcp/.

IMPORTANTE: Nellesempio seguente si dato per scontato che la cartella C:\WCP fosse una risorsa condivisa con il web server (directory virtuale). COMPILATORE MANUALE Vengono messi a disposizione due modi per compilare: 1) A riga di comando tramite il file cwc.exe che accetta i seguenti paramentri :
-o <output file> : Indica il file che deve essere generato -e <errors file> : Indica il file che deve contenere gli eventuali errori -cc <cobol compiler> : Indica il percorso del compilatore AcuCobol ccbl32.exe -bat<compatibility:0=windows;1=unix> <template file> : Indica se deve essere generato il .bat per Apache con che compatibilit e usando quale template

2) Tramite Projects Builder che consente di definire pi progetti e di compilarli tutti contemporaneamente.

ESEMPI Se non si cambia il percorso di installazione proposto dal setup (C:\Programmi\WebCobol) gli esempi verranno installati nella cartella C:\Programmi\WebCobol\Samples che dovr essere opportunamente configurata. Configurarzione directory Samples in IIS: Le figure seguenti illustrano le propriet che deve avere la directory C:\Programmi\WebCobol\Samples:

Configurarzione directory Samples in APACHE: Per configurare APACHE sar sufficiente inserire le seguenti righe nel file di configurazione httpd.conf:
ScriptAlias /wcp/ "C:/Programmi/WebCobol/Samples/" <Directory "C:/Programmi/WebCobol/Samples"> AllowOverride None Options ExecCGI Order allow,deny Allow from all </Directory>