Creating and customizing the WUI data set

Use DFHISTAR to create and customize your Web User Interface (WUI) server data sets, according to the parameters that you set when you submit the DFHISTAR job.

DFHISTAR postinstallation members for a WUI

When you run DFHISTAR, with a SCOPE of POST or ALL, it creates the following postinstallation members for a CICSPlex® SM Web User Interface (WUI) server in the XDFHINST library:

EYUWUIDS – creates and starts all the data sets for a WUI. EYUWUIDS includes steps to delete the data sets so that you can rerun the job, if required. These deletions are expected to fail the first time that you run the job. EYUWUIDS contains the following steps:
- DELWREP deletes the CICSPlex SM WUI data repository, EYUWREP.
- DEFWREP defines the CICSPlex SM WUI data repository, EYUWREP.
- DELCOVDS deletes the WUI import and export data sets, EYUCOVI and EYUCOVE
- DEFCOVDS defines the WUI import and export data sets, EYUCOVI and EYUCOVE
- JES3DELA and JES3DEFA are included if you specify the DFHISTAR JES=JES3 option. They delete and define the CICS® local catalog, the global catalog, and the local request queue.
- DELREGDS deletes the CICS data sets.
- DEFTRACE defines the CICS auxiliary trace data sets, DFHAUXT and DFHBUXT.
- DEFHTML defines the CICS DFHHTML data set.
- DEFDMPS defines the CICS transaction dump data sets, DFHDMPA and DFHDMPB.
- DEFTSTD defines the CICS auxiliary temporary storage data set, DFHTEMP.
- DEFINTD defines the CICS intrapartition transient data set, DFHINTRA.
- DEFLCD defines the CICS local catalog, DFHLCD.
- INITLCD uses the DFHCCUTL utility to start the CICS local catalog.
- DEFGCD defines the CICS global catalog, DFHGCD.
- INITGCD uses the DFHRMUTL utility to start the CICS global catalog.
- DEFLRQ defines the CICS local request queue data set, DFHLRQ.
- JES3DELA and JES3DELB are included if you specify the DFHISTAR JES=JES3 option. They delete and define the CICS DFHCSD data set.
- DELCSD deletes the CICS DFHCSD data set.
- DEFCSD defines the CICS DFHCSD data set.
- INITCSD uses the DFHCSDUP utility to start the DFHCSD data set.
EYUJWREP – creates the WUI data repository, EYUWREP. EYUWUIDS includes steps to delete and define EYUWREP. You can run EYUJWREP if you want to delete and define only EYUWREP but none of the other data sets for a WUI.
- DELWREP: delete the CICSPlex SM WUI data repository, EYUWREP.
- DEFWREP: define the CICSPlex SM WUI data repository, EYUWREP.
EYUWUISP – CICS system initialization parameter overrides for a WUI.
EYUWUI0P – CICSPlex SM EYUPARM parameters for a WUI.
EYUWUIIN – CICSPlex SM EYUWUI parameters for a WUI.
EYUWUIP – starts a WUI.
EYUWUIJ – invokes EYUWUIP.

If you use the default values for the CICSPlex SM parameters, the EYUWUIP PROC statement is shown in the following code sample:

EYUWUIP  PROC DSNCSD='CICSTS54.CPSM.WUINCM01.DFHCSD',         
    RGNHLQ='CICSTS54.CPSM.WUINCM01',                  
    CICSHLQ='CICSTS54.CICS',                       
    CPSMHLQ='CICSTS54.CPSM',                       
    PRMLIB='CICSTS54.XDFHINST',    
    CICSPRM=EYUWUISP,                 CICS Parameters         
    CPSMPRM=EYUWUI0P,                 CPSM Parameters         
    WUIPRM=EYUWUIIN                   WUI Parameters

Customizing postinstallation jobs using DFHISTAR

You can use DFHISTAR to generate copies of the WUI postinstallation jobs for a different CICS region. Use the DFHISTAR SELECT parameter to specify a new name for a copy of a postinstallation job. It has this format:

SELECT jobname newname

jobname: Is the name of the job you that want to regenerate
newname: Is the name for the new copy.

You can specify more than one SELECT parameter to select multiple jobs to be regenerated in a single run of the DFHISTAR job. When you include a SELECT parameter in the DFHISTAR job, only those jobs specified by the SELECT are generated.

For a WUI with the name WUINCM02 and a CICS system identifier of WU02, which connects to a CMAS with the name CMAS02 and CICS system identifier CM02, you can change your DFHISTAR parameters to specify these options:

CMASNAME CMAS02
CMSSYSID CM02
WUIPLEX WUIPCM02
WUINAME WUINCM02
WUISYSID WU02
TCPIPHST TCP/IP host name for this WUI
TCPIPPRT TCPIP port number for this WUI 
SELECT EYUWUIDS WU02WUDS             JCL to create the data sets for WUINCM02 	
SELECT EYUWUISP WU02WUSP             CICS SIT overrides for WUINCM02
SELECT EYUWUI0P WU02WU0P             CICSPlex SM EYUPARM parameters for WUINCM02
SELECT EYUWUIIN WU02WUIN             CICSPlex SM EYUWUI parameters for WUINCM02
SELECT EYUWUIJ  CW02WUIJ             JCL statement
SELECT EYUWUIP  CW02WUIP             PROC statement

You can then start the WUI WUINCM02, using the procedure EYUWUIP with these commands:

START EYUWUIP, DSNCSD='CICSTS54.CPSM.WUINCM02.DFHCSD', 
RGNHLQ='CICSTS54.CPSM.WUINCM02', CICSHLQ='CICSTS54.CICS', 
CPSMHLQ='CICSTS54.CPSM', PRMLIB='CICSTS54', CICSPRM=WU02WUSP, CPSMPRM=WU02WU0P, 
WUIPRM=WU02WUIN

If you are using EYUWUIJ to start the WUI, edit it to specify these values:

CICSPRM=WU02WUSP, CSMPRM=WU02WU0P, WUIPRM=WU02WUIN