How to make an MVS CICS Web Interface Home Page.


This page gives guidance on the Installation and Execution of the CICS/ESA CWI INTROC converter program. This program is a sample which will create a default homepage for your CWI system.

To use the INTROC sample you need to:

1. Create a page of HTML to use as your homepage, call it INDEX and put it in the HTML PDS on MVS. A sample homepage has been provided for you to use if you wish.
2. Upload INTROC.COB to your MVS or OS/390 system and follow the instructions below.

These instructions explain how to use a sample COBOL program that will when combined with a few changes to the CWI analyzer program serve a default home page such as http://your.cics.system/ without the need for a converter, tranid or CICS program being specified in the URL. INTROC is a CWI converter only, no application logic program is invoked as all processing is done within the ENCODE section of the converter.


This is just one method of setting up a home page using your CWI host system. INTROC will quite simply serve the single HTML page INDEX. No processing is done other than using the template manager to recover the page from the PDS pointed to by your DFHHTML DD statement. The Home Page may contain links to your other CWI resources, graphics or whatever.

Installation Notes

Design and create your homepage named INDEX and place it in the DFHHTML DD PDS. A sample homepage (INDEX.HTM) is provided with this support pack. If you wish to use INDEX.HTM then upload it to the MVS HTML templates PDS as member INDEX using your normal procedures.

Compile and link edit the COBOL program INTROC using your normal CICS compile procedures.

Update your CICS System Definition (CSD) dataset with the INTROC program definition, using the CSD input file provided (CA84CSD).

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 'INTROC ' 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.

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 INTROC the alias transaction as CWBA and sets no server-program.

Reinstall the analyzer and ensure that your modified analyzer is the one being used by the CWI. This can be done using option 2 from the CWBC transaction and setting the converter name to your new converter. Press enter twice to save this change then disable and reenable the CWI (option 1 from CWBC).

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/ and you will receive the HTML page INDEX at the browser.