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.
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
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.
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.
Do 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.
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.
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:
This is the sysid of the CMAS to which the Web User Interface server is connected.
This tells you if your Web User Interface server is using the secure sockets layer (SSL), as defined by the TCPIPSSL Web User Interface server initialization parameter.
This is the TCP/IP port number specified on the TCPIPPORT Web User Interface server initialization parameter.
This is the TCP/IP host name specified on the TCPIPHOSTNAME Web User Interface server initialization parameter.
This is the name of TCPIPSERVICE being used by the Web User Interface, if you are using CICS Transaction Server for OS/390®, or later release.
This is the status of TCPIPSERVICE being used by the Web User Interface, if you are using CICS Transaction Server for OS/390, or later release.
This is the dotted decimal IP address of the TCPIPSERVICE being used by the Web User Interface, if you are using the CICSPlex SM element of CICS Transaction Server.
If you press PF12 to return to the control panel, message EYUVS0906I is issued on the control panel indicating that the operation is complete.
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.
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
An explanation of some of the fields shown in Figure 17 follows:
If you press PF12 to return to the control panel, message EYUVS0906I is issued.
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.
To 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.
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
Fill in the blank fields as follows:
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.
To 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.
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
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.
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.
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.
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 ]]