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