Create the Web User Interface server region on the same MVS image
as your CMAS MP. The Web User Interface server region is a managed application
system (MAS) and is managed by the local CMAS.
Figure 1. Create a WUI server region on System A to interact with
the CMAS MP
- Create a MAS that will act as the WUI server.
- Add JCL DD statements for the following data sets: EYUWUI, EYUWREP,
EYULOG, and EYUCOVI.
- EYUWUI
- Data set that contains the WUI server initialization parameters.
- EYUWREP
- Data set that contains the WUI server repository.
- EYULOG
- The CICSPlex SM output log.
- EYUCOVI
- The WUI server import data set. A sample can be found in member EYUEUX01
in the data set CICSTS31.CPSM.SEYUVIEW.
- Specify the mandatory WUI server system initialization parameters.
- Set a value for the TCPIPHOSTNAME (name)
parameter. The parameter specifies the TCP/IP host name of the
WUI server. This is normally the host name and domain name of the MVS system
(that is, a fully-qualified name). This host name is used by the WUI to construct
URLs depending on the client's HTTP version and the value of the TCPIPHTTPHOST WUI
server parameter.
Note that the WUI does not support names longer than 32
characters. If required, you can use the address of the server using the dotted
decimal notation. For example, '127.0.0.1'.
- Set a value for the TCPIPPORT(value)
parameter. The parameter specifies the number of the port that
you have allocated for the WUI to run on.
- Specify the value for the INITPARM system
initialization parameter. Use the format:
INITPARM=(EYU9VKEC='xxx',EYU9VWAN='yyyy')
where xxx represents the language of the Web User Interface
server, and yyyy represents the code page of the client.
For example, if your chosen language is English, you would code as follows: INITPARM=(EYU9VKEC='ENU',EYU9VWAN='ENU1')
For
a list of language identifiers, see ../dfha1/dfha1b00223#eyuadie.
- There are a number of other optional system initialization parameters
that you can specify. A full list is detailed in ../dfha1/dfha100.htm#eyuadih. For
the purposes of this learning path, you will need to specify the following:
- Set a value for the AUTOIMPORTTDQ(tdq_name)
parameter. The parameter specifies the name of the CICS extrapartition
transient data queue that the server should use to import the menu and view
sets automatically during server initialization. There is no automatic default,
but you can use the queue name COVI (DD name EYUCOVI), which is defined in
the CSD group EYU310GW.
You should only specify this parameter when starting
the WUI server for the first time.
- Edit the CICS system initialization table to include the following
parameters:
- CPSMCONN=WUI
- GRPLIST=list_name where list_name is
the name of the list that includes the group EYU310G1.
- GRPLIST=list_name where list_name is
the name of the list that includes the group EYU310GW.
- Create the Web User Interface server repository. The
server repository is a VSAM data set that is used to store the Web User Interface
server's view and menu definitions. You can use the IDCAMS utility to create
a VSAM file for these definitions, replacing &DSHLQ with
the data set high level qualifier.
/*
//*----------------------------------------------------------
//* Define New WUI Server Repository
//*----------------------------------------------------------
//DEFWREP EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER ( -
NAME( &DSHLQ.EYUWREP ) -
VOLUMES(&DSVOL) -
STORCLAS( STANDARD ) -
RECORDS( 5000 5000 ) -
CONTROLINTERVALSIZE( 8192 ) -
SPANNED -
INDEXED -
SHAREOPTIONS( 2 ) -
) -
DATA ( -
NAME( &DSHLQ.EYUWREP.DATA ) -
KEYS( 20 20 ) -
RECORDSIZE( 8192 32000 ) -
) -
INDEX ( -
NAME( &DSHLQ.EYUWREP.INDEX ) -
)
/*
Sample JCL is also provided in SEYUINST and is called EYUJWREP.
- Start the Web User Interface server region. This should
automatically import the Web User Interface views into the server repository. Look for the following message EYUVS0002I CICSPlex SM
Web User Interface initialization complete.
You can have a WUI server on each MVS image to spread the workload.
This is particularly useful where you are supporting multiple languages or
more than 50 users.