Create a Web User Interface server region

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 MPThe diagram shows the CMAS
MP EYUCMS1A on System A with links to three local MASs in the CICSplex EYUPLX01
and a link to the WUI server, also on System A.
  1. Create a MAS that will act as the WUI server.
  2. 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.
  3. Specify the mandatory WUI server system initialization parameters.
    1. 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'.

    2. 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.
    3. 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.
  4. 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:
    1. 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.

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