The CICS Transaction Server for OS/390 CWI default Homepage


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.


Here's what to do:

Installation Notes

1. Create a PDS (eg ISHORE.TEMPLATE.HTML) with undefined length records (eg Record format: U, Record length: 0, Block size: 32760) to store the homepage HTML file. Add a DD statement to your CICS JCL to point to this PDS (eg //MYHTML DD DSN=ISHORE.TEMPLATE.HTML,DISP=SHR).
2. Copy or move INDEX.HTM to this PDS, renaming it as INDEX. This file should be transferred to this PDS using FTP, or any other file transfer method with which you are familiar, specifying the ASCII option when transferring it.
3. Translate, compile and link-edit the HOMEPAGE COBOL program, using your normal CICS COBOL compile procedures, ensuring it is accessible by CICS through the DFHRPL DD statements in the CICS JCL.
4. Update your CICS System Definition (CSD) dataset with the HOMEPAGE program and INDEX doctemplate definitions, using the CSD input file provided; CA8C.CSD.
5. Add the following COBOL code to the COBOL analyzer (DFHWBAOX) or write equivalent code in your preferred analyzer language. It should appear after the 'Validate Resource Length' comment and before the comparrison to 'WBADX-MIN-RESOURCE-LENGTH' is made.

        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).

Back to the top


Execution

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.

Back to the top