This page gives guidance on the Installation and Execution of the CICS Transaction Server for OS/390 CWI HOMEPAGE converter program. This program is a sample program, written in COBOL, to serve a default homepage through the CWI system.
When installed, this sample will deliver a default homepage when the following URL format is supplied:
http://your.CICS.system:your.port/
To use the HOMEPAGE sample you need to:
1. Create new PDS to store your default homepage HTML file
2. Upload INDEX.HTM to your MVS or OS/390 and follow the instructions below.
These instructions explain how to use the sample HOMEPAGE COBOL program. When combined with a few changes to the CWI analyzer program, it will serve a graphic image through the CWI, from a URL such as http://your.CICS.system:your.port/. HOMEPAGE is a CWI converter program. No application logic program is invoked as all processing is done within the ENCODE section of the converter.
if rl = 1 move 'HOMEPAGE' to wbra-converter-program move 'CWBA' to wbra-alias-tranid move low-values to wbra-server-program move URP-OK to wbra-response move 0 to wbra-reason EXEC CICS RETURN END-EXEC end-if.What this analyser code does is compare the resource-length to 1 then proceeds accordingly. In other words, if the URL requested is equal to '/' then it will set the converter program to be HOMEPAGE, the alias transaction as CWBA, and sets no server-program. Then issues an early return to CICS.
Reinstall the analyzer and ensure that your modified analyzer is the one being used by the CWI. This can be done by updating the URM in your TCPIPSERVICE (corresponding to your port number) with your new converter, closing your CICS TCPIP link (by CEMT SET TCPIP CLO), reinstalling your updated TCPIPSERVICE, and reopening your CICS TCPIP link (by CEMT SET TCPIP OPE).
If all the above works correctly you should now be able to point
your favourite web browser at the following URL:
http://your.CICS.system:your.port/
and receive the default HTML homepage, INDEX, on your favourite Web browser.