The CICSPlex SM Web User Interface transaction (COVC)

A CICSPlex® SM Web User Interface server controller transaction (COVC) is supplied for use by an administrator with a terminal connected to the Web User Interface server CICS® region.

The functions of this transaction are:

If you run the COVC transaction, with no further input, that is by typing COVC followed by no other command, you are presented with the CICSPlex SM Web User Interface control panel, as shown in Figure 15.

Figure 15. CICSPlex Web User Interface control panel
 COVC                CICSPlex SM Web User Interface Control             EYUVCTR 
                                                                               
                             1. Start Server                                   
                             2. Stop Server                                    
                             3. Status Details                                 
                             4. User Sessions                                  
                                                                               
                             5. Import                                         
                             6. Export                                         
                                                                               
                             7. Trace Flags                                    
                                                                               
  CICSPlex SM, an element of CICS Transaction Server for z/OS, Ver 2 Rel 3     
              Licensed materials - Property of IBM. 5697-E93                   
          (C) Copyright IBM Corp. 1994, 2001. All rights reserved              
                                                                               
Current Status : Ready                                       Time : 19:01:51   
Applid         : IYCQSTGW                                    Date : 02/27/2001 
                                                                               
                                                                               
                                                                               
                                                                               
PF   1 Help      3 Exit                                          12 Return     
                                                                                                                         

Starting and stopping the Web User Interface server

If the Web User Interface server has not already been started during PLT processing you can start it by selecting the Start Server option from the control panel. Message EYUVS0900I is issued on the control panel indicating that the Web User Interface server Start has been requested.

To stop the Web User Interface server select the Stop Server option from the control panel. Message EYUVS0901I is issued on the control panel indicating that the Web User Interface server Stop has been requested.

Note:
Stopping the Web User Interface server using the COVC transaction shuts down the CICS system acting as the Web User Interface server on completion of the COVC transaction.

You can also start the Web User Interface server by issuing the following command:

COVC START

and stop the Web User Interface server by issuing:

COVC STOP

You can issue the COVC START and COVC STOP commands from the CICS terminal or from the console using the MVS™ Modify command.

If you attempt to start the Web User Interface server when it has already started, message EYUVS0902W is issued indicating that the Web User Interface server is currently active. Similarly, if you attempt to stop the Web User Interface server when it has already stopped, message EYUVS0903W is issued indicating that the Web User Interface server is currently inactive.

Start of changeDo not use CEMT, the CICS Explorer®, or the WUI CICSRGN view to shut down a WUI server region. If you use these methods, CICSPlex SM cleanup does not take place. In this situation, you might receive messages EYUXS0910I, EYUXS1014I, EYUXS1019W and EYUXS1016E along with an SVC dump with a title similar to the following:

EYU9XSTR Dump,jobname,applid,sysname,LMAS,COVA,0000000,TRCV,EYU9XSTR,dd/mm/yyyy,hh:mm:ss

In addition to the SVC dump, API resources might be orphaned, as noted by the EYUXS1019W message.End of change

Displaying status details

To display the Web User Interface server status details, select the Status Details option from the control panel. You are presented with the Status Details panel, as shown in Figure 16.

Figure 16. Status Details panel
COVC                CICSPlex SM Web User Interface Control             EYUVCTS 
                                                                               
                                Status Details                                 
                                                                               
         CMAS Sysid            : QSTX                                          
         Server Sysid          : QSGW                                          
         CICSPlex SM Release   : 0210                                          
                                                                               
         Secure Sockets        : No                                            
         Port                  : 05126                                         
         Hostname              : MVSXX.COMPANY.COM                             
                                                                               
         TCP/IP Service Name   : EYUWUI                                        
         TCP/IP Service Status : Open                                          
         TCP/IP Address        : 127.10.10.12                                  
                                                                               
Current Status : Ready                                       Time : 19:04:49   
Applid         : IYCQSTGW                                    Date : 02/27/2001 
                                                                               
                                                                               
                                                                               
                                                                               
PF   1 Help      3 Exit                                          12 Return     
                                                                                                                     

An explanation of some of the fields shown in Figure 16 follows:

If you press PF12 to return to the control panel, message EYUVS0906I is issued on the control panel indicating that the operation is complete.

Viewing user sessions

To view information about user sessions, select the User Sessions option from the control panel. This opens the User Sessions panel, as shown in Figure 17.

Start of changeFigure 17. User sessions panel
COVC                CICSPlex SM Web User Interface Control             EYUVCTU
                                                                               
                                 User Sessions                    Page  1 of  1
                                                                               
 Current No. of Users :   1                     Inactive Timeout :    30 (mins)
 Maximum No. of Users :  20                                                    
                                                                               
    Userid    USERGrp   Inact  TimeA   Win D  ClientIp                  Status 
                                                                               
    OPS1      OPSWUI1       4    3:17   7     10.10.10.25                        
    WUIADM    ADMWUIG       0    2:04   1     10.10.10.3                      
    MONCNSL   MONITOR       0    1:59   3     10.10.10.74               ENDING
                                                                               

                                                                               
                                                                               
 Current Status : Ready                                       Time : 11:29:05  
 Applid         : IYCSZGW0                                    Date : 10/19/2004
                                                                               
                                                                               
                                                                               
                                                                               
 PF   1 Help      3 Exit                  7 Up        8 Down      12 Return    
End of change

An explanation of some of the fields shown in Figure 17 follows:

Maximum No. of Users
This is the maximum number of concurrent users allowed and is the value specified for the MAXUSERS initialization parameter.
Inactive Timeout
This is the period after which inactive user sessions are terminated and is the value specified for the INACTIVETIMEOUT initialization parameter. When inactive timeout is reached the user session is terminated.
Userid
The user ID of the user signed on to the Web User Interface.
Start of changeUserGrpEnd of change
Start of changeThe user group to which the user belongs.End of change
Start of changeInactEnd of change
The period that the user session has been inactive.
Start of changeTimeAEnd of change
The period that the user has been logged on.
Start of changeWinEnd of change
The number of windows that this user session currently has opened. This number is incremented every time the user selects the New window or View Editor button in the navigation frame, or the New Editor or New Home window button in the View Editor.
Note:
This number is not necessarily decremented when the user closes a window. Closed windows remain active until the resources are reclaimed.
Start of changeDEnd of change
Start of changeThe data interface used indicator.End of change
Start of changeClientIPEnd of change
The client browser or proxy TCP/IP address.
Start of changeStatusEnd of change
Start of changeThe purge status indicator.End of change

If you press PF12 to return to the control panel, message EYUVS0906I is issued.

Terminating a user session

You can terminate a user session from the User Sessions panel by typing P for purge, or F for force purge, against the userid then pressing enter. Message EYUVS0912I is issued on the User Sessions panel indicating that the purge request was successful. A message is also written to the EYULOG when the user session is terminated.

Note:
Terminating a user using the force purge command results in an AEXY abend and may also result in some resources not being reclaimed.

Importing view set or menu definitions

Start of changeTo import definitions into the Web User Interface repository, select the Import option from the control panel. This opens the Import panel, as shown in Figure 18.

Figure 18. Import panel
 COVC                CICSPlex SM Web User Interface Control             EYUVCTI
                                                                              
                                   Import                                     
                                                                              
                                                                              
      Input TDQ Name  :             Name of extrapartition TDQ for import     
                                                                              
      Type            : MENU        Menu | Viewset | USERGrp | User | All     
                                                                              
      Import option   : SKIP        Skip | Overwrite | DELETE                 
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
Current Status : Initializing                                Time : 08:53:57  
Applid         : CICSHW61                                    Date : 09/12/2004
                                                                              
                                                                              
                                                                              
                                                                              
PF   1 Help      3 Exit                                          12 Return                                  
End of change

Fill in the blank fields as follows:

Input TDQ Name
Enter the name of the extrapartition transient data queue where the definitions are currently held, for example COVI. See CICS Transaction Server for z/OS® Installation Guide for more information.
Start of changeTypeEnd of change
Start of changeType in one of the following:
Menu
to import only menus
Viewset
to import only view sets
User
to import user objects
UserGrp
to import user group profiles
All
to import all resource types.
End of change
Import option
Enter the action you want the server to take if a duplicate definition is found in the input data set: whether existing definitions are to be preserved, overwritten , or deleted:
SKIP
If you specify SKIP, only definitions for view sets or menus that do not already exist in the input data set are imported.
OVERWRITE
If you specify OVERWRITE, definitions for any view sets or menus that already exist in the input data set are overwritten.
DELETE
Removes matching definitions of the selected type from the repository data set. For example, to selectively remove records from the repository, you can export the objects you want to remove and then use exported file with the import delete function to remove them.
Note:
You can have a view set and menu with the same name.

Press Enter to start the operation.

Message EYUVS1016I is issued to mark the start of the import operation and EYUVS0916I is issued on the Import panel to indicate its successful completion.

If the import fails, complete view set and menu definitions that have already been read successfully remain in the repository but the failing definition and any that follow are not imported. Message EYUVS0917E is issued to indicate that the import has failed and a message is written to the EYULOG of the Web User Interface server or the operator log.

You can import only those view sets and menus for which you have update access. Resources for which you do not have the necessary access are skipped and EYULOG message EYUVS1014W is issued. See Controlling access to Web User Interface resources for guidance on setting levels of access to view sets and menus.

For more information about importing see Importing and exporting.

If you press PF12 to return to the control panel, message EYUVS0906I is issued.

Exporting view set or menu definitions

Start of changeTo export view set or menu definitions from the Web User Interface repository select the Export option from the control panel. You are presented with the Export panel, as shown in Figure 19.

Figure 19. Export panel
COVC                CICSPlex SM Web User Interface Control             EYUVCTE
                                                                              
                                   Export                                     
                                                                              
                                                                              
  Output TDQ Name :                    Name of extrapartition TDQ for export  
                                                                              
  Type            : MENU               Menu | Viewset | USERGrp | User        
                                                                              
  Name            : *                  Specific or generic name of a          
                                       definition to export                   
                                                                              
  Lock option     : NONE               None | LOCK                            
                                                                              
                                                                              
                                                                              
Current Status : Ready                                       Time : 08:58:55  
Applid         : CICSHW61                                    Date : 09/12/2004
                                                                              
                                                                              
                                                                              
                                                                              
PF   1 Help      3 Exit                                          12 Return    
End of change

Fill in the blank fields in the Export panel as follows:

When you have completed all the fields, press Enter to export the view or menu definitions.

Note:
If the same TDQ is used for export more than once, for example, to export menus then views, the second export overwrites the first or is appended to it, depending on how the TDQ is defined.

Message EYUVS0919I is issued on the Export panel indicating that the export was successful and how many objects were written across. If the export fails, the data in the TDQ that you were writing to is incomplete so should be discarded. Message EYUVS0920E is issued indicating that it has failed and a message is written to the EYULOG of the Web User Interface server.

You can export only those view sets and menus for which you have read or update access. Resources for which you do not have the necessary access are skipped and EYULOG message EYUVS1015W is issued. See Controlling access to Web User Interface resources for more information.

For more information about exporting see Importing and exporting.

If you press PF12 to return to the control panel, message EYUVS0906I is issued.

Setting trace flags

Attention: It is recommended that you activate trace only at the request of IBM® support center personnel.

To set trace flags dynamically, select the Trace Flags option from the control panel. You are presented with the Trace Flags panel, as shown in Figure 20.

Figure 20. Trace flags panel
COVC                CICSPlex SM Web User Interface Control             EYUVCTT
                                                                              
                                 Trace Flags                                  
                                                                              
Overtype the trace, enter to update.                                          
                                                                              
                                1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3   
              1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1   
Trace Flags : Y Y N N N N Y N N N Y N Y N Y N N N N N N N N N N N N N N N Y   
                                                                              
                                                                              
                                                                              
                                                                              
                                                                              
Aux. Trace Status : Started                                                   
                                                                              
Current Status : Ready                                         Time : 08:26:46
Applid         : IYCQCTA5                                      Date : 02/27/2001
                                                                              
                                                                              
                                                                              
                                                                              
PF   1 Help      3 Exit                                          12 Return    
                                                                                                             

You can control the amount of trace information produced by setting any of the appropriate trace flags. Thirty one independent trace flags are provided and you can overtype any of the flags, with Y or N, and press enter to change the settings.

[[ Contents Previous Page | Next Page Index ]]