COBHTTPD
Contents
1. www cobtools com Page 31 COBHTTPD Users Manual Manejo de sessiones COBHTTPD nos permite manejar sesiones con el fin de recuperar un valor de una variable la siguiente vez que el usuario accese al mismo programa Como es sabido el protocolo http solo regresa el contenido de una consulta Una vez que el contenido es regresado al navegador se pierde la conexi n entre el servidor y el cliente De tal manera que la siguiente vez que se realiza la consulta a otro documento se hace una conexi n nueva y los datos no se pasan de una consulta a otra Aun cuando se trate del mismo documento Para evitar este problema COBHTTPD maneja sesiones las cuales permiten grabar valores y pasarlos de consulta en consulta durante el tiempo que dure la sesi n Las sesiones siempre se crean y se actualizan en cada consulta Para grabar un valor en una sesi n desde nuestro programa COBOL debemos de crear una marca con el siguiente formato lt SESSION SAVE variable valor gt Ejemplo lt session save clave 1953 gt Desde dentro de nuestro programa COBOL generar amos la instrucci n de la siguiente manera STRING lt Q session save clave MEM CLAVE gt 7 DELIMITED BY SIZE INTO MEM LINEA WRITE R CGI 0UT FROM MEM LINEA Para recuperar el valor que hemos grabado en la sesi n debemos de tomar el valor como un par metro de entrada Es decir registrarlo en la Configuraci n d2. Start button Inicia el serivicio cuando se haya instalado previamente y no se este ejecutando en este momento Stop button Detiene el servicio cuando se este ejecutando www cobtools com Page 11 COBHTTPD Users Manual Username Es el usuario para ejecutar el servicio El usuario necesita existir en el sistema actual Se puede poner de la forma Ausuario Password Es el password para el usuario Recuerda o anota tu usuario y password por que cuando se salve la configuraci n para el servicio nunca volver a ser mostrada por razones de seguridad Y este dato no es grabado en el archivo de configuraci n cobhttpd dat Boton Projects Este bot n permite acceder a la configuraci n de los proyectos la cual ser explicada en la siguiente secci n www cobtools com Page 12 COBHTTPD Users Manual Configuraci n Proyectos Los proyectos son grupos de programas que necesitan ser accesados desde el Internet Un proyecto contiene datos para los programas COBOL que son miembros de la misma aplicaci n COBOL Para indicar que proyecto usar en el url el formato es http www tudominio com cobpdf proid PROYECTO La funci n cobpdf en la llamada a este url ser explicada mas adelante lo m s importante ahora es la manera como indicar el ID del proyecto Este ID es nico y global siempre llamaremos a nuestro proyecto con este ID y es universal y no podr ser modificado despu s de registrarlo so
3. definidos en la forma HTML con las marcas INPUT Diferencia entre contenido HTML y PDF Para contenido html usar cobcgi proid pro amp prog prog Para contenido pdf usar cobpdf proid pro amp prog prog En ambos casos el archivo a generar debe de llamarse tal y como nos indique la variable HTTP OUTPUT esta variable se explica mas adelante en el registro HTTP CONTROL www cobtools com Page 27 COBHTTPD Users Manual Recibiendo datos de entrada en nuestro programa COBOL Hasta este momento nuestro programa COBOL recibe dos registros de datos 01 HTTP CONTROL 02 HTTP PROJECT 02 HTTP PROGRAM 02 HTTP OUTPUT 02 HTTP ERROR 02 HTTP ERROR MSG U U tu U fv aa nn OCCURS 5 TIMES 01 HTTP DATA INP 02 HTTP DATA INPX PIC X 4096 Estos dos registros se encuentran ya definidos en el archivo LS HTTP FDT que se encuentra en el directorio COBOL dentro de COBHTTPD tambi n va en cada ejemplo ya que se necesita para compilar los programas HTTP CONTROL El primer registro HTTP CONTROL contiene algunos datos importantes para nuestro programa y que son pasados de COBHTTPD hacia nuestro programa COBOL que ser ejecutado HTTP PROJECT es el c digo del proyecto al que pertenece nuestro programa que se esta ejecutando Nos puede servir dentro de nuestro programa para hacer enlaces hacia urls y colocar el mismo c digo de proyecto que en el archivo html externo HTTP PROGRAM es el nombre del progra
4. en otra computadora y corres el servidor y estar s seguro que te funcionara Para una instalaci n r pida sigue las instrucciones 1 Desempaca el archivo cobhttpd zip en tu directorio preferido c cobhttpd es una buena opci n Con esta instalaci n obtienes los siguientes directorios httpdoc Directorio para todos los documentos e im genes httpdoc reports Directorio para los reportes generados por cobhttpd Xml Directorio para los archivos definiciones de proyectos y programas Cobol El directorio con los programas COBOL que sirven de interfase entre tu aplicaci n COBOL y COBHTTPD 2 Define tu directorio temporal como por ejemplo c temp 3 Esto es todo para una instalaci n a continuaci n realiza la configuraci n del programa en la siguiente secci n podr s encontrar toda la informaci n necesaria para esta tarea www cobtools com Page 8 COBHTTPD Users Manual Configuraci n General Para la configuraci n necesitas correr el programa cfgcobhttpd exe toda la configuraci n se hace con este programa Este programa no necesita ning n par metro solo ejec talo Primero iniciaremos con los datos generales para el programa estos son Web Server port Puerto para Server Este dato define el puerto TCP IP por el cual el servidor servir las peticiones de los clientes Si ahora tienes instalado ya un servidor web corriendo en tu computadora entonces necesit
5. entrada para nuestro programa COBOL Nosotros no podemos saber el valor que tiene este archivo pero podemos indicarlo como par metro y cobhttpd sustituir esta variable con el nombre donde nos dejo los valores de los campos Para cada compilador de COBOL tenemos un peque o programa que se usa como puente entre cobhttpd y nuestros programas COBOL Este programa es diferente para cada compilador www cobtools com Page 14 COBHTTPD Users Manual Ejemplos e Para ejecutar un proyecto en el directorio F APPS ACCOUNT e Desarrollado con Acucobol el runtime es RUNCBL EXE y este runtime esta en el directorio C ACU e El ID del proyecto es account Code project account Directory work F APPS ACCOUNT Runtime Command C acu runcbl exe w 9 httpdir cobol httpacu chbx filevar Si en nuestra instalaci n colocamos cobhttpd en c cobhttpd Es lo mismo si ponemos C acu runcbl exe w c cobhttpd cobol httpacu cob filevar Pero recuerda no siempre el directorio de instalaci n podr ser c cobhttpd Si en alguna otra instalaci n ponemos cobhttpd en d cobhttpd tendremos que cambiar todos nuestros proyectos hacia este directorio El subdirectorio cobol es donde por default colocamos los programas internos para cada compilador Nosotros desarrollamos un programa para cada compilador En este caso el dato filevar que el programa cobol recibe es como par metro y el programa puente hace varias cosas con el antes d
6. guia de los pasos mas importantes para desarrollar un Proyecto WEB con Power COBOL 5 www cobtools com Page 17 COBHTTPD Users Manual Runtime Type En este bloque debemos definir el tipo de Runtime que tenemos para correr nuestros programas las opciones son MSDOS WIN 16 WIN 32 Es muy importante seleccionar la opci n adecuada ya que COBHTTPD ejecuta cada uno de estos tipos de runtime de manera diferente y el seleccionar una opci n incorrecta puede ocasionar que COBHTTPD se quede colgado Si nuestro runtime es para MsDos y trabaja en modo texto seleccionamos MSDOS En cambio el Runtime es para Windows 3 11 debemos escoger WIN 16 Y por ultimo es es un runtime para Windows 98 o superior escojeremos WIN 32 Process Show Este bloque es para especificarle a COBHTTPD como correr el runtime en ocasiones al ejecutar un runtime este autom ticamente muestra una ventana que se abre al ejecutar este programa Si deseamos hacer que esta ventana no se muestre seleccionaremos la opci n HIDE algunos runtimes necesitan una configuraci n especial para indicarle que no muestre esta ventana inicial tal es el caso de RMCOBOL Por otro lado si dese ramos desplegar alg n tipo de dato para poder depurar nuestro programa al estar haciendo pruebas deberemos de escoger la opci n SHOW moment neamente y de esta manera podremos ver los despliegues que hacemos con nuestro programa Hay que aclarar que en un servidor ya trabaja
7. llamada desde formas html solo coloca la direcci n en el ACTION de una marca FORM lt form method POST action cobpdf proid PRO prog PROG gt definici n de campos de la forma lt form gt Para gente que conoce poco de html si ves en el action podr s ver que no escrib el url completo Esto no es necesario por que el browser se encarga de expandir este url con el nombre del dominio de donde descargo este html y con el puerto del webserver A esto se le conoce como direcci n relativa www cobtools com Page 26 COBHTTPD Users Manual Pero si tienes el html de la forma en un web Server diferente y solo buscas correr tus programas COBOL con el servidor cobhttpd entonces tu POST podr a verse as lt form method POST action http www tudominio com cobpdf proid PRO amp prog PROG gt definici n de campos de la forma lt form gt A esta direcci n se le conoce como direcci n absoluta Si quieres pasar un dato pero este dato no tiene campo INPUT dentro de la forma html puedes pasar este dato como parte del url ejemplo lt form method POST action http www tudominio com cobpdf proid PRO amp prog PROG amp func add gt En este ejemplo el campo func Este campo es pasado al programa PROGNAME y este programa necesita tener definido este campo func en su lista de campos tambi n Cuando nuestro programa COBOL se ejecute func tambi n le llegara igual que los campos que est n
8. num rico entonces es necesario definir la cantidad de enteros y decimales que tendr Tambi n indicar si necesitamos el signo Al final hacemos clic en el bot n OK para agregar el nuevo campo Como modificar un campo par metro Primero seleccionamos el campo que se desea modificar Hacemos clic en el men Edit gt Modify parameter Cambiamos la informaci n del campo en la carpeta Parameter Hacemos clic en el bot n OK Una vez que hemos terminado de hacer las modificaciones necesarias a nuestro archivo de proyecto xml grabaremos el archivo con la opci n del men File gt Save Para terminar de usar el editor xml nos salimos con la opci n File gt Exit www cobtools com Page 24 COBHTTPD Users Manual Ejecutando el programa Server COBHTTPD Para ejecutar el programa cobhttpd y ponerlo a escuchar peticiones de los clientes browser se ejecuta uno de los siguientes programas Cobhttpd exe Si el Windows es Windows 98 NT 200 XP y actualmente no se ejecuta como servicio Cobhttpd_svc exe Se ejecuta autom ticamente si el Windows es NT 2000 XP y se ha configurado como servicio Este programa se ejecuta al arrancar el Windows En Windows 98 puedes configurar para que tu programa se corra autom ticamente y se coloque en el systray Para abrir la ventana del programa en este modo hacer doble clic en el icono y la ventana principal del programa ser abierta Si se a optado para ejecutar cobhttpd como ser
9. 15 02 MKEY IN PIC 9 05 02 MKEY FIN PIC 9 05 02 BKEY PIC 9 05 PROCEDURE DIVISION NICIO MOVE HTTP DATA INP TO REG INTERNO MOVE HTTP OUTPUT TO WF CGI OUT De esta manera usamos los campos de REG INTERNO en nuestro programa www cobtools com Page 29 COBHTTPD Users Manual Como generar la salida a entregar al cliente Ya sea generando contenido HTML o generando un reporte para ser entregado como PDF debemos de grabar el contenido en un archivo texto COBHTTPD nos indicara como se debe de llamar el archivo texto que debemos generar Este nombre de archivo nos llegara al programa en la variable HTTP OUTPUT Esta variable tiene el nombre del archivo Si no generamos el contenido con este nombre el resultado no ser entregado al cliente que solicito la consulta Ahora desde COBOL podemos utilizar la siguiente declaraci n para crear este archivo INPUT OUTPUT SECTION FILE CONTROL SELECT IMPRESO ASSIGN TO INPUT OUTPUT WF REPORT ORGANIZATION IS LINE SEQUENTIAL FILE STATUS IS STAT IMP DATA DIVISION FILE SECTION FD IMPRESO LABEL RECORDS ARE OMITTED 01 LINEA PIC X 500 WORKING STORAGE SECTION 77 WF REPORT PIC X 150 77 STAT IMP PIC X LINKAGE SECTION COPY LS HTTP FDT PROCEDURE DIVISION USING HTTP CONTROL HTTP DATA INP 000 INICIO MOVE HTTP OUTPUT TO WF REPORT OPEN OUT
10. COBHTTPD Users Manual COBHTTPD Servidor de Aplicaciones para COBOL Manual del Usuario Ver 2 40 www cobtools com Page 1 COBHTTPD Users Manual INDICE e E 3 Como trabaja est Programa cai 4 COBHTTPD Archivos y Programas eater eenen ande 5 COBHTTPD Director OS scales 6 Direct rio de lastalaci n sunt 6 Directorio de Doc ii id 6 Direct rio de Reportes tii iia 7 Directo o de Temporales tsmesasiia acia 7 Direct rio AM Luna led 7 COn aia 9 E A keen 9 Autor CON ai in 11 Configuraci n PrOyECtOS uan 13 Compiladores COBOL SOPOHa dns 16 ACUCOBOL interface httpacu cbX ssesessessssessessseresseressessrtesteessrrsserssseesseeeseresee 16 RMCOBOL interface httHprmis COD sisisi eirean E E aiea 16 MSCOBOL 5 interface httpms5 exe veias 16 POWER COBOL 3 interface httppwc3 exe sins 17 POWER COBOL 85 interface httppw85 exe am 17 POWER COBOL 5 interface httppw5 exe nnie eden 17 Baton Edit XML tada lea 19 Formato del archivo de interfase AM tarda 20 Editor XML eisereen eee E E E E E A a i a 22 Ejecutando el programa Server COBHTTPD tonnen bedtnin 25 Eje cutando los program s COBOL aK E E 26 Generando Contenido HTML sncssoinsseersnevenaersorseorsnnatndandrenraddaonnnesdanwidenndeondndodanneeddanansde 26 Generando Reportes PDE wenende eeen 26 Acceso directo ad 26 Llamando desde archivos ATM essent entrees sid es 26 Diferencia entre contenido HTML Y PDB nessen 27 Recibiendo datos de entrada en nu
11. HTML como reportes en formato PDF www cobtools com Page 3 COBHTTPD Users Manual Como trabaja este programa Primero un pequefio ejemplo 1 El usuario visita la pagina para ver un reporte y recibe una forma html para llenarla con los datos necesarios para crear el reporte 2 El usuario llena la forma y la postea hacia el servidor 3 El servidor corre el programa COBOL apropiado y convierte el archivo a PDF 4 El servidor regresa el archivo PDF a el usuario y este es visualizado en el I explorer o Netscape COBHTTPD siempre regresa los reportes en formato PDF por las siguientes razones PDF es universal Existe un plugin para tu browser preferido No necesitas ning n programa especial para ver tus reportes Puede ser impreso en cualquier impresora Puede ser visualizado en diferentes plataformas Windows Linux Unix COBHTTPD te ayuda a convertir tus programas COBOL para trabajar en Internet porque todos los par metros que tu programa necesita son recibidos por la LINKAGE SECTION Por que el protocolo http trabaja con datos pero estos datos no son formateados no contiene el tipo de informaci n y no son delimitados por un tama o por esto COBHTTPD necesita conocer los programas que ser n publicados en Internet y necesita conocer el tama o de los datos que recibir de entrada para trabajar As que antes de que un programa pueda ser usado es necesario definir en COBHTTPD y es necesario que se
12. PUT IMPRESO WRITE LINEA FROM lt html gt lt head gt WRITE LINEA FROM lt title gt ejemplo html lt title gt WRITE LINEA FROM lt head gt WRITE LINEA FROM W www cobtools com Page 30 COBHTTPD Users Manual WRITE LINEA FROM lt body gt WRITE LINEA FROM lt center gt WRITE LINEA FROM lt hl1 gt Primer prueba html lt hi gt WRITE LINEA FROM lt center gt WRITE LINEA FROM lt body gt WRITE LINEA FROM lt html gt CLOSE IMPRESO STOP RUN END PROGRAM En este peque o ejemplo hacemos solamente un desplegado de un letrero que debe de decir Primer prueba html Todas las marcas utilizadas aqu son html asi que no debe de haber ningun problema con esa parte Lo interesante primero es e Utilizamos el archivo LS HTTP FDT para obtener todas las variables que nos entrega COBHTTPD e Utilizamos el nombre del archivo que nos llega en HTTP OUTPUT e Creamos el archivo con el contenido deseado Para crear contenido PDF es id ntico solo que las marcas que usaremos para crear un reporte PDF deben ser las mismas marcas que para crear un reporte para COBVIEW Hay que recordar que los reportes que se visualizan en Windows con COBVIEW pueden ser tambi n creados para internet y visualizados en formato PDF que es la raz n por la que se hace esta conversi n
13. a un nuevo programa en el archivo xml actual New parameter Inserta un nuevo campo en el programa actualmente seleccionado Modify Modifica el programa o el campo actualmente seleccionado La vista actual del editor de xml es la siguiente XML File ES lol xj File Edit bs A BEB Tree Programs Program Parameter E browsel func mkey ini mkeyfin bkey 01 LS DATA INPUT X 15 915 X 50 ADDRESS X 50 CITY X 30 TELEPHONE X 30 HOMEPAGE X 40 EMAIL X 40 www cobtools com Page 22 COBHTTPD Users Manual Cuenta tambi n con un tool bar superior para realizar las operaciones mas importantes del programa New Program Crea un nuevo programa igual que la opci n del men New Parameter Crea un nuevo campo par metro 1gual que en men Modify program o parameter Permite modificar el elemento seleccionado actualmente View Linkage Con este bot n podemos ver una estructura de la LINKAGE SECTION de como se recibir en nuestro programa Podemos incluso marcar y copiar el contenido y pegarla en nuestro programa Edit code for import fields Permite editar el registro de campos de entrada para el programa utilizando la sintaxis COBOL para una f cil edici n de campos tambi n es posible copiar el contenido del registro directamente desde el programa fuente COBOL Save file Graba el archivo xml Delete program Elimina el programa seleccionado Help Mue
14. an definidos los datos de entrada para este programa todo puede ser echo con el configurador de COBHTTPD www cobtools com Page 4 COBHTTPD Users Manual COBHTTPD Archivos y Programas Los programas que son parte de la suite cobhttpd son CFGCOBHTTPD EXE Este programa es el Configurador de cobhttpd Con este programa puedes modificar toda la informaci n para que cobhttpd pueda trabajar Puedes modificar el puerto TCP IP a escuchar directorios de trabajo programas y campos de entrada COBHTTPD EXE Este programa es el que se necesita ejecutar para correr el servidor y atender peticiones de los clientes Cuando este programa corre el servidor estar listo para trabajar COBHTTPD_SVC EXE Este programa es una versi n especial para funcionar en Windows 2000 XP como servicio Un servicio no necesita que Windows entre a una sesi n por que el programa corre desde que Windows inicia As si un servidor Windows es reiniciado y nunca se acceda a una sesi n de usuario el servidor COBHTTPD estar listo para trabajar COBHTTPD_INT EXE Este programa es una interface entre el COBHTTPD cuando este funcionando como servicio ya que un servicio no tiene intervencion con el usuario este programa nos ayudara para monitorear los accesos que se hacen y que programas se ejecutan nos sirve para cuando estemos haciendo pruebas COBVIEWHTTP EXE Este programa convierte los reportes generados por tus programas COBOL a PDF y regresarlo
15. as de COBHTTPD ejemplo C COBHTTPD CGILIB Necesitas estudiar tambi n el manual de esta librer a para que puedas comprender el uso de cada archivo de c digo que contiene y cuando necesitas usar uno y otro www cobtools com Page 34
16. as definir un puerto diferente al 80 El puerto 80 es el puerto de default para los servidores http tu puedes definir alg n puerto que no este siendo usado por otro programa Si defines el puerto 8080 entonces podr s acceder por medio de tu browser a la siguiente direcci n http www tudominio com 8080 http tu direccion ip 8080 si lo accesas desde la lan http localhost 8080 si lo accesas desde la propia computadora Default document Es el primer documento que enviara el servidor cuando no se indique ning n archivo a leer desde el browser Default index html Ejemplo si visitas la siguiente direcci n http www tudominio com directorio El cobhttpd primero buscara el archivo index html si este existe en este directorio entonces lo regresara como resultado al browser del lado del cliente Document Dir Este es el directorio de default para los archivos html y los reportes auto generados Default c cobhttpd httpdoc Nota Puedes cambiar el Document Dir hacia otro diferente ejemplo c httpdoec pero recuerda que cuando copies la instalaci n actual a otra computadora necesitas copiar tambi n todos los directorios para que trabaje correctamente www cobtools com Page 9 COBHTTPD Users Manual TEMP Directory Define el directorio de archivos temporales Default c temp Este directorio no es creado por el programa de configuraci n necesita ser creado manualmente Allow external Developmen
17. bre todo si ya lo usamos en nuestras formas html La nica manera de ejecutar un programa es indicando a que proyecto pertenece Este viene siendo como el nombre de tu aplicaci n siempre es el mismo y nunca cambia Cuando tu inicias a usar este ID en tus llamadas ser dif cil cambiarlo mas adelante Lista de proyectos Projects Configuration 10 O x httpdie Irkemal dirctory where Fitpview exe is installed Add Mod y Delete Ext nie s A Var Mode Code Project f C SETE Descripcion bHtipd Demostrabo E Drectory work Runtime Command XML interface fle 57 a gt Botones principales Datos del proyecto Botones para datos La pantalla de configuraci n de proyectos contiene los siguientes componentes lista de proyectos Esta es la lista de los proyectos definidos Cuando haces clic en alg n proyecto de la lista todos los Datos del proyecto se muestran pero no es posible modificarlos porque el proyecto solo es seleccionado Para hacer alguna acci n es necesario hacer clic al bot n apropiado antes www cobtools com Page 13 COBHTTPD Users Manual e Add Permite insertar un nuevo proyecto en la lista de proyectos Cuando se selecciona este bot n los datos del proyecto se ponen en blanco y se activan para introducir datos e Modify permite modificar los datos del proyecto actualmente seleccionado Cuando se selecciona este bot n los datos se activan para modificarse e Delet
18. de runtime para ejecutar los programas COBOL Debido a que es autoejecutable el programa interface lo ejecutaremos directamente Ejemplo de Runtime Command httpdir cobol httpms5 exe filevar www cobtools com Page 16 COBHTTPD Users Manual POWER COBOL 3 interface httppwc3 exe Este compilador no necesita de runtime para ejecutar los programas COBOL Debido a que es autoejecutable el programa interface lo ejecutaremos directamente Ejemplo de Runtime Command httpdir cobol httppwe3 exe filevar POWER COBOL 85 interface httppw85 exe Al igual que el anterior no necesita runtime este se usa para programas compilados en Power COBOL 3 usando el COBOL 85 Ejemplo de Runtime Command httpdir cobol httppw85 exe filevar Estas dos interfaces anteriores han sido creados para Power COBOL 3 los dos utilizan los programas que se van a llamar como DLL de tal manera que hay que crear todos los programas en estos compiladores como DLL para que estas interfaces las puedan ejecutar POWER COBOL 5 interface httppw5 exe Esta interface no necesita de runtime ya que se manda a llamar directamente el programa de interface Ejemplo httpdir cobol httppwc5 filevar Con esto se define que el proyecto sera de POWER COBOL 5 y la ejecucion de los programas ya se llevara a acabo en el directorio donde se indicaron que estos seral alojados Si descarga los ejemplos para este compilador encontrara una
19. e Permite eliminar el proyecto actualmente seleccionado Despu s de hacer clic en este bot n el proyecto se elimina y se desaparece de la lista de proyectos e Exit Cierra esta ventana y regresa a la pantalla principal de configuraci n Datos del proyecto Code Project Es el ID del proyecto Necesitar ser nico y de preferencia no cambiarlo mas adelante Description Es una descripci n corta del proyecto Directory work Es el directorio donde tus programas COBOL se alojan Siempre que tu programa COBOL se vaya a ejecutar el directorio se cambia a este antes de que tu programa se ejecute Runtime command Es el programa que ejecuta tu programa COBOL Si tu compilador COBOL genera programas auto ejecutables no hay ning n problema solo tenemos que hacer una llamada directa al primer programa a ejecutar Normalmente se necesitan pasar par metros especiales al runtime y al programa COBOL para ejecutar Existen dos variables que pueden ser usadas para hacer cambios especiales en este dato Johttpdir y filevar htpdir nos va a indicar el directorio de instalaci n de cobhttpd Claro que tambi n se podr a usar el directorio directo ejemplo c cobhttpd en lugar de usar la variable Pero si cambiamos de directorio de instalaci n en otra computadora tendremos que modificar nuestros proyectos para corregir la ruta Este problema se resuelve con esta variable filevar es el archivo de datos que contiene los datos de
20. e COBHTTPD como variable de entrada de nuestro programa y declararlo en el registro para poder tener el valor siempre que se entre a nuestro programa Dicho de otra manera la variable siempre nos llegara como par metro y dentro de nuestro programa debemos de actualizar este valor con la instrucci n SESSION SAVE para que la pr xima vez que se entre al mismo programa nos llegue este valor Otra soluci n para resolver este tipo de problemas es que siempre enviemos el valor dentro del url del programa as se pasa un valor como par metro incluido en la misma direcci n www cobtools com Page 32 COBHTTPD Users Manual Incluir archivos externos COBHTTPD tambi n permite incluir archivos externos Debido a que son de gran ayuda ya que podemos agrupar algunas librerfas o rutinas en un archivo externo e incluirlo en cada pagina HTML que generemos Estos archivos pueden ser partes de c digo HTML o bien rutinas Javascript que podemos necesitar en nuestra pagina web que generemos Para hacer esto usamos la siguiente marca especial de COBHTTPD lt COPY nombre de archivo ext gt El nombre de archivo debe de ir encerrado entre comillas o ap strofos La ubicaci n f sica del archivo siempre debe de ser a partir del directorio donde se esta ejecutando el programa Es decir el directorio que tenga configurado el Proyecto en la configuraci n del COBHTTPD para correr los programas del proyecto Si deseas meter por ejem
21. e ejecutar el programa COBOL de tu aplicaci n Ejemplo 2 El mismo ejemplo pero utilizando RMCOBOL en CARM Runtime command C rm runcobol httpvar cobol httprm cob a filevar www cobtools com Page 15 COBHTTPD Users Manual Compiladores COBOL soportados A continuaci n se detallan los diferentes programas que se utilizan para cada compilador soportado por COBHTTPD adem s ponemos un ejemplo de c mo quedar a la linea de Runtime Command ACUCOBOL interface httpacu cbx El programa de interface a utilizar es httpacu cbx y fue creado usando acucobol ver 3 2 se le pasa como par metro la variable filevar Ejemplo de Runtime Command c acu runcbl exe b w httpdir cobol httpacu cbx filevar Puedes utilizar el par metro b para indicar que queremos ejecutar el programa como background es decir si acucobol marca alg n error este lo env a como salida de desplegado y lo podemos ver en la consola del COBHTTPD Tambi n puedes agregar el par metro e archivo para crear un archivo de errores para monitorear si tu programa aborta de alguna manera y revizar el archivo y ver el error registrado RMCOBOL interface httprm5 cob Esta interface para RMCOBOL es para versi n 5 36 Ejemplo de Runtime Command c rm runcobol exe httpdir cobol httprm5 K A filevar En este compilador la variable filevar se pasa como par metro MSCOBOL 5 interface httpms5 exe Este compilador no necesita
22. e vida antes de que cobhttpd borre este archivo Directorio de Temporales Este directorio es necesario para crear archivos propios para la operaci n del programa Este directorio contiene pequefios archivos creados por cobhttpd y accesados por tus programas COBOL para la conversi n de datos y para la creaci n del reporte que posteriormente ser convertido a PDF Por defualt nosotros usamos C TEMP o D TEMP para esto es mejor tener un directorio de 8 letras como m ximo para los compiladores COBOL de MSDOS Este directorio es depurado por cobhttpd igual que con el Directorio de Reportes Directorio XML Este directorio contiene la definici n XML de los proyectos y programas que son publicados en el Internet Recuerda que cada programa necesita ser definido antes de que se pueda trabajar con l en Internet Cada proyecto contiene un archivo con todos los programas Por default el directorio necesita existir dentro del Directorio de Instalaci n y necesita sea llamado xml Los archivos xml son mantenidos autom ticamente por el programa de configuraci n del cobhttpd www cobtools com Page 7 COBHTTPD Users Manual Instalaci n Este programa no contiene un programa de instalaci n este programa fue hecho para Desarrolladores de software Y como programador necesitaras conocer que cambios hace el programa a tu sistema operativo Y si necesitas copiar la instalaci n solo copias el directorio a la misma ruta
23. el numero lleva signo El valor del elemento es el nombre del campo que se usara en la forma html Ejemplo lt field type X size 10 gt NOMBRE lt field gt www cobtools com Page 20 COBHTTPD Users Manual Ejemplo completo lt httpview gt lt program name prog01 gt lt field type X size 10 gt NOMBRE lt field gt lt field type X size 20 gt APELLIDO lt field gt lt program gt lt program name prog02 gt lt field type 9 int 3 gt PAGINI lt field gt lt field type 9 int 3 gt PAGFIN lt field gt lt program gt lt httpview gt prog01 Fuente de la interfase 01 DATA INPUT 02 INPUT NOMBRE PIC X 10 02 INPUT APELLIDO PIC X 10 Prog02 Fuente de la interfase 01 DATA INPUT 02 PAGINI PIC 9 03 02 PAGFIN PIC 9 03 www cobtools com Page 21 COBHTTPD Users Manual Editor XML Este editor es parte de cobhttpd y puede ser accesado desde el bot n Edit xml Cuando se hace clic en este bot n el archivo xml del proyecto actual es abierto y es cargado en el editor xml El archivo es mostrado en modo de Arbol El editor de xml contiene las siguientes opciones de men File New Crea un nuevo archivo xml en blanco limpia el contenido actual Open Abre un archivo xml existente Save Salva el contenido actual en el archivo Exit Cierra el editor de xml Edit New program Insert
24. estro programa COBOL eneen 28 ATT CONTROL tarada 28 ETET DAAN RS 29 Como generar la salida a entregar al cliente nennen venneeeneeenneeenveenveeenn 30 Manejo dS SeSSIOnES vda 32 Incluir archi OSO ia 33 Introducci n a la librer a CGILIB einstein 34 www cobtools com Page 2 COBHTTPD Users Manual Descripci n COBHTTPD es un servidor de Aplicaciones para COBOL Con este programa puedes correr en forma remota alg n programa COBOL Contiene tambi n un Servidor de Reportes para visualizar reportes por medio de Internet Este Servidor de reportes trabaja con una versi n especial de COB VIEW para convertir los reportes a PDF y envi rselos al servidor COBHTTPD COBHTTPD trabaja tambi n como servidor web porque usa el protocolo http para recibir y enviar los datos del cliente y hacia el cliente navegador COBHTTPD no es solo un programa puente para ejecutar programas COBOL COBHTTPD es un programa completo no necesitas de alg n programa externo para que funcione de manera total y no necesita de alg n DLL o librer a externa para trabajar COBHTTPD no necesita una instalaci n especial para trabajar por que trabaja en Windows 98 2000 XP y 2003 y la instalaci n es manual por que tu copias el programa donde tu deseas y el directorio es definido por ti De esta manera tu siempre conocer s donde se colocan los archivos del programa Muy importante para los programadores COBHTTPD puede regresar tanto contenido
25. explorador del cliente y el explorador debe tener la opci n de aceptar cookies de lo contrario las variables permanentes no se podr n reusar y siempre tendr n un valor inicial de cero Expire Cookies mm Este dato indica el tiempo de vida que tendr un cookie el tiempo que se configure aqu es en minutos es muy importante definir un tiempo de vida adecuado Por ejemplo si una instalaci n tiene un tiempo de vida de 30 minutos cuando una persona accese a una aplicaci n con su password esta sesi n quedaria abierta durante los 30 minutos hay que tambi n colocar una opci n para cerrar la sesi n manualmente y asegurarnos que los usuarios la seleccionen para que se cierre la sesi n y no esperar 30 minutos para que el COBHTTPD lo haga autom ticamente www cobtools com Page 10 COBHTTPD Users Manual Not Autoexpire cookies Si marcamos esta casilla le decimos a COBHTTPD que siempre que se use la aplicaci n se renueve el tiempo de vida de la sesi n as si definimos un tiempo de vida de 10 minutos mientras el usuario este usando la aplicaci n se le renovaran los 10 minutos nuevamente Si no se marca esta opci n entonces la sesi n durara 10 o 30 minutos aun cuando el usuario siga usando la aplicaci n y se morir la sesi n despu s de ese tiempo y tendr a que volver a hacer LOGIN con su usuario y password Domain Este dato actualmente no se utiliza la idea es poder definir un nombre del dominio para ident
26. ificar los cookies en el explorador pero actualmente no debe de llevar nada Es para uso futuro Autorun Config Autorun on windows start Si se marca esta opci n cobhttpd autom ticamente se ejecuta al iniciar Windows Esta funci n necesita que el usuario inicie sesi n en Windows por que todos los programas que s auto ejecutan inician cuando el usuario inicia sesi n Put in systray Esta opci n permite que cuando se ejecuta el programa cobhttpd se coloque de manera invisible en la barra de tareas en ejecuci n systray Si no se marca el programa se ejecuta y se abre la ventana de ejecuci n en modo visible Run as NT Service Esta opci n aparece solo si la computadora donde es instalado cobhttpd es Windows 2000 2003 o XP Si se marca esta opci n entonces el programa cobhttpd correr como un servicio de NT El servidor cobhttpd se ejecutar cuando Windows inicie aun si el usuario no a iniciado sesi n Cuando esta opci n es marcada las opciones Autorun on windows start y put in systray son desactivadas y todos los datos del bloque Run as service se activan Bloque Run as service Install button Instala el programa cobhttpd como servicio en esta computadora Solamente podr ser activado una vez Para hacer clic en este bot n se necesitan los datos username y password Uninstall button Con este bot n se desinstala el cobhttpd como servicio cuando se haya instalado anteriormente
27. ma que se esta ejecutando y nos puede servir para hacer librer as externas y hacer referencia hacia el programa que se esta ejecutando y no tener que poner el nombre del programa fijo si es que nuestra librer a sirve para diferentes programas HTTP OUTPUT Es el nombre del archivo que debemos de generar con nuestro contenido html que deseamos HTTP ERROR Es un c digo de error que podemos regresar a COBHTTPD cualquier numero diferente de 0 es un error no usado por el momento HTTP ERROR MSG Es un arreglo de 5 renglones donde podremos colocar un mensaje textual para regresar al cliente en caso de que el programa necesite informar alg n error al ser este HTML es necesario regresar el error como par metro Trabaja en conjunto con HTTP ERROR no usado por el momento www cobtools com Page 28 COBHTTPD Users Manual HTTP DATA INP Este segundo registro es un solo campo de 4 kb de tama o En este campo nos llegaran los diferentes valores que nuestro programa COBOL necesita para funcionar Al ser de un m ximo de 4 K podemos incluso recibir grandes cantidades de datos para realizar operaciones de Actualizaci n de archivos Ya en nuestro programa hacemos la divisi n de campos declarando un registro en la WORKING STORAGE y solo movemos este registro a nuestro registro interno para tener la divisi n real Ejemplo WORKING STORAGE SECTION 01 REG INTERNO 02 MFUNC PIC X
28. ndo en linea debemos escoger siempre HIDE www cobtools com Page 18 COBHTTPD Users Manual Bot n Edit XML Con este bot n se puede editar el archivo xml con un peque o editor de xml integrado en cobhttpd Cuando se hace clic en este bot n aparece el editor de xml donde puedes realizar las siguientes Operaciones Insertar nuevos programas Modificar programas ya existentes Agregar campos a los programas Eliminar un programa o alg n campo La otra manera de modificar el archivo xml es edit ndolo directamente con alg n editor de textos En las siguientes dos secciones explicare primero como es el formato interno del archivo xml posteriormente en detalle explicare las funciones completas del editor xml www cobtools com Page 19 COBHTTPD Users Manual Formato del archivo de interfase XML El archivo de interfase xml tiene primero un elemento root httpview ejemplo lt httpview gt Definici n de programas lt httpview gt Definici n de Programas Cada programa necesita tener el elemento lt program gt con los siguientes par metros Name nombre programa ejemplo lt program name prog01 gt definici n de campos lt program gt Campos de un programa Los campos se definen con la marca lt field gt Par metros Type tipo de campo los valores son 9 n meros X alfanum rico Size Tama o del campo Int Cantidad de enteros Dec Cantidad de decimales Sign Indica si
29. ntos y el Directorio de documentos es c cobhttpd httpdoc entonces podr s colocar archivos especiales dentro del directorio c cobhttpd httpdoc website y podr as visualizar los archivos con la siguiente direcci n http www tudominio com website Por default y como mejor practica este directorio estar dentro del Directorio de Instalaci n As si tienes el Directorio de instalaci n hacia DACOBHTTPD pondr s el directorio de documentos hacia D COBHTTPD HTTPDOC As cuando necesites hacer una copia completa de tu sitio solo copias el directorio D COBHTTPD y todos los archivos podr s restaurarlos despu s www cobtools com Page 6 COBHTTPD Users Manual Directorio de Reportes Este directorio es para almacenar los archivos PDF que son visualizados por los browsers Porque este directorio necesita ser accesado desde Internet este directorio necesita existir dentro del Directorio de Documentos Por default nosotros llamamos a este directorio reports as que si nosotros tenemos nuestro Directorio de Documentos hacia D COBHTTPD HTTPDOC y nuestro Directorio de Reportes es reports el directorio completo en nuestro sistema seria D COBHTTPD HTTPDOC REPORTS Y todos los reportes podr an ser accesados desde Internet de la forma http www tudominio com reports reporte pdf Este directorio es depurado por cobhttpd alg n reporte generado y publicado en este directorio tiene solo 5 horas d
30. plo todos tus archivos de JavaScript en un directorio llamado js este deberia de estar dentro del directorio de programas del proyecto As para incluir un archivo llamado formas js que se guardo en el directorio js la l nea para COBHTTPD debe de ser lt COPY js formas js gt Con esta l nea COBHTTPD va a sustituir este texto por el contenido del archivo formas js Esto lo hace de manera autom tica www cobtools com Page 33 COBHTTPD Users Manual Introducci n a la librer a CGILIB CGILIB es una librer a para crear programas tipo CGI desde COBOL y creada espec ficamente para usarse con COBHTTPD Esta librer a consta de una serie de archivos que se incluyen en nuestro programa COBOL y con base en puras llamadas a p rrafos COBOL podremos crear contenido HTML de manera din mica Las capacidades de CGILIB son Crear contenido HTML sin escribir ninguna marca de este lenguaje Poder crear tablas para dar formato a nuestras pantallas Crear formas para captura y presentaci n de datos en HTML Librer a para crear un BROWSER y poder navegar a trav s de los registros de un archivo Poder crear botones y links a urls e Creaci n de temas para poder cambiar la apariencia de nuestro programa con solo indicar el nombre del nuevo tema e Manejo f cil de Formas templates creadas con editores de html Los archivos de esta librer a se encuentran ubicados en el directorio CGILIB dentro del directorio de program
31. s al servidor para que este a su vez los regrese al Navegador del cliente COBHTTPD DAT Este archivo contiene la informaci n de la configuraci n del programa cobhttpd Contiene toda la informaci n general Todos estos programas necesitan existir en el mismo directorio ejemplo CACOBHTTPD Pero tu puedes poner tu instalaci n de COBHTTPD donde tu desees Para COBHTTPD no es importante donde sea instalado www cobtools com Page 5 COBHTTPD Users Manual COBHTTPD Directorios El programa COBHTTPD necesita de los siguientes directorios para trabajar Directorio de Instalaci n Este directorio contiene todos los programas de cobhttpd y el archivo de configuraci n Por default y para este documento usaremos CACOBHTTPD Directorio de Documentos Este directorio contendr todos los archivos que ser n publicados en el servidor web Estos archivos publicados podr n ser archivos html archivos gif jpg y todos los archivos que se necesiten para crear tus formas html Este directorio podr ser visto con tu browser cuando visites el sitio ejemplo http www tudominio com Si tu puerto es el 80 entonces esta direcci n mostrara los archivos que existen en el directorio de documentos El primer documento visualizado ser el Documento de default registrado en la configuraci n de cobhttpd por default nosotros lo llamamos index html Si tienes un subdirectorio website dentro del Directorio de docume
32. stra una ventana de ayuda Flechas arriba y abajo Con estas flechas de direcci n puedes colocar un campo arriba o hacia abajo para la definici n correcta en tu registro de la LINKAGE SECTION Cuando seleccionas un programa diferente aparece en la parte inferior el contenido completo del registro de campos tal y como lo recibira nuestro programa COBOL Como agregar un nuevo programa Para esta operaci n seleccionamos la opci n del men Edit gt New program o hacemos clic en el bot n New Program Autom ticamente cambiara hacia la carpeta Program En esta carpeta solo tenemos activo el dato name Despu s de teclear el nombre del programa hacemos clic en el bot n OK para agregar el programa al rbol XML Despu s de insertar nuestro nuevo programa podremos seleccionarlo e insertarle los campos que necesitemos www cobtools com Page 23 COBHTTPD Users Manual Como modificar un programa Primero necesitamos seleccionar el programa que queremos modificar Despu s hacemos clic en la opci n del men Edit gt Modify program El nico dato que podemos cambiar es el nombre del programa Name Como insertar un nuevo campo par metro Primero seleccionamos el programa donde queremos insertar el campo Despu s clic en el bot n New Parameter o en la opci n del men Edit gt New Parameter Llenamos la forma de datos para el nuevo campo Name Type X or 9 Size Si nuestro nuevo campo se define como
33. t OBSOLETA Habilita a COBHTTPD para trabajar con el editor COBEDIT este editor tiene la particularidad de que puedes crear proyectos web y autom ticamente actualizar tu archivo de proyecto agregando los programas que crees en COBEDIT y ademas actualizar tu lista de variables para que no necesites crearlas manualmente con el programa de configuraci n Por seguridad debes deshabilitar esta opci n cuando instales un servidor web en una maquina conectada a Internet Allow show Directory on Web Si se marca esta opcion se mostrara el directorio de archivos y carpetas en el web en caso de que no existiera el archivo de Default a mostrar Solo usarla en la fase de desarrollo y desctivarla en los servidores que trabajan en linea Show warnings in HTML mode Muestra los mensajes de error en el browser si es que alg n error ocurre errores como no se encontr el archivo XML Directorio de proyecto no existe programa no existe Si este dato no es marcado el error no es mostrado y la ejecuci n del programa es detenida Save Activiy LOG Si se marca esta casilla cobhttpd genera un archivo de log con los eventos ocurridos como un GET a un archivo ejecuci n de un programa un POST de una forma html etc El nombre del archivo es cobhttpd log y se aloja en el Directorio de Instalaci n Bloque Cookies COBHTTPD necesita manejar cookies para poder mantener variables permanentes por sesi n Una sesi n almacena un peque o dato en el
34. vicio entonces arrancara sin necesidad de hacer LOGON en la computadora pero al correr asi no tendremos manera de hacer un monitoreo de nuestros programas COBOL que se van ejecutando Para hacer un monitoreo de los accesos cuando este funcionando como servicio usamos el programa cobhttpd_int exe este se conectara con el programa servicio y mostrara unicamente los accesos que se realicen www cobtools com Page 25 COBHTTPD Users Manual Ejecutando los programas COBOL Existen dos maneras de ejecutar un programa COBOL El modo a utilizar depender del tipo de contenido a regresar Generando Contenido HTML Si deseamos regresar contenido HTML usaremos http www tudominio com cobcgi proid PRO amp prog PROG amp F1 value Generando Reportes PDF Si deseamos regresar un report PDF a el navegador utilizaremos el modo http www tudominio com cobpdf proid PRO amp prog PROG amp F 1 value Acceso directo Desde el campo direcci n en el web browser puedes correr un programa de la siguiente manera http www tudominio com cobpdf proid PRO amp prog PROG amp F 1 value Con este dato puedes correr un programa llamado PROG en el proyecto PRO y recibir el campo F1 con el valor indicado en value Recuerda que si definiste un puerto diferente al 80 entonces necesitas indicar este puerto en tu Server ejemplo si defines el puerto 83 http www tudominio com 85 cobpdf proid XXXXXXX Llamando desde archivos HTML Para una
Download Pdf Manuals
Related Search
COBHTTPD cobhttpd