Implementing CICSPlex Part 3 – Convert an Existing CICS into a WUI

The WUI, or Web User Interface, is the “console” for the CICSPlex. Originally a TSO interface was supported, but now there is only the WUI. There are several good sources that show how to create a WUI, including Dave Williams’ excellent article on MainframeZone.com, but some may not wish the overhead of another region and would prefer to use an existing region; a TOR is a good logical choice. However, be aware that the WUI runs auxtrace constantly (regardless of what you may have in the SIT or overrides), so you’ll be adding that activity to a region within which you choose to implement the WUI. To avoid constant changes of auxtrace files, you’ll probably want to reallocate the trace datasets for the WUI to be pretty large. If the tracing activity is a concern, then you’ll want to choose a different region, or create a new region for the WUI.

Start-up JCL

As in the CMAS, you’ll need the SEYUAUTH library in the STEPLIB concatenation and the SEYULOAD library in the DFHRPL concatenation. You’ll want to allocate a SYSOUT DD for EYULOG.

SIT and Overrides

In the DFHSIT table, or its SYSIN overrides, add the CPSMCONN parameter and set it to WUI. Add an INITPARM and set it to (EYU9VKEC=’ENU’,EYU9VWAN=’ENU1′); if you already have an INITPARM, then add the EYU9VKEC and EYU9VWAN parameters. Make sure that TCP is set to YES.

WUI Repository

Allocate a VSAM dataset to serve as the WUI repository:

//DELWREP  EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
DELETE YOUR.EYUWREP
SET MAXCC=0
/*
//DEFWREP  EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
DEFINE CLUSTER(NAME(YOUR.EYUWREP)-
INDEXED -
CYL(5 1) -
SHR(2)-
CISZ(8192) -
SPANNED -
VOLUME(your-volume)) -
DATA(NAME(YOUR.EYUWREP.DATA)-
RECORDSIZE(8192 32000) -
KEYS(20 20)) -
INDEX(NAME(YOUR.EYUWREP.INDEX))
/*

Add a EYUWREP DD to the start-up JCL, with DISP=SHR.

CICSPlex Parms

You’ll need a dataset to contain the CICSPlex-specific parms for the WUI:

NAME(wui-name),
CICSPLEX(CICSPlex-name),
CMASSYSID(CMAS-id)

Set NAME to match what you put in for WUINAME in the CMAS repository, and CICSPLEX must be set to the same value as that in your CMAS’ CICSPlex parms, and CMASSYSID must be set to the SYSIDNT of the CMAS. You’ll probably want to add  a SEC parameter and set it to NO initially, and set security after you have basic functionality.

Add a EYUPARM DD to the start-up JCL pointing to your parm file and member, with DISP=SHR.

WUI Parms

The WUI will need a WUI parm dataset defined, with the following parameters:

TCPIPHOSTNAME(tcpip-host-name)
TCPIPPORT(port-number)
DEFAULTCMASCTXT(cmas-name)
DEFAULTCONTEXT(CICSPlex-name)
DEFAULTSCOPE(scope)
AUTOIMPORTDSN(YOUR.SEYUVIEW)
AUTOIMPORTMEM(EYUEA*)

Set TCPIPHOSTNAME to the host name for your MVS image, and TCPIPPORT to the port number you wish for the WUI to use. Once this region is up, you can access the WUI by pointing a browser to http://tcpip-host-name:port-number .

Set DEFAULTCMASCTXT to the the CMAS name (same value as the CMAS name in your CMAS parms), and set DEFAULTCONTEXT to the CICSPlex name to the Plex name (same value as WUIPLEX in your CMAS repository). You will probably want to set DEFAULTSCOPE to the CICSPlex name, as you’ll probably prefer the scope of the WUI views to default to the entire CICSPlex than a specific CICS or group of CICS systems.

The last two entries can be removed after the initial successful start-up of the region. They specify to load the English “views” from the SEYUVIEW dataset. You can modify these or code your own views and load them later.

Add a EYUWUI DD to the start-up JCL pointing to this dataset, with DISP=SHR.

That’s it for the WUI. Start it up, and it should connect to your CMAS. Load your browser and point it to the host name and port number, and you should see the shell of a CICSPlex. Next time we’ll look at adding CICS regions to the new CICSPlex.

Follow theCICSguy on twitter here

Advertisements

2 responses to “Implementing CICSPlex Part 3 – Convert an Existing CICS into a WUI

  1. Many Thanks! These posts are great. We had a class on this that left me brain dead; but I’ve found these posts to be at exactly the right tone to quickly pick up what’s going on. It’s a bit ironic that I found this info on CICS by googling. Nice work and thanks again.

    • Thanks for the feedback! Always rewarding when I hear that one of my posts was helpful to someone. Good luck with your CICSPlex project! Please keep us posted on how it goes.

      Steve

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s