Importing WUI definitions using COVC
Use the COVC import function to import WUI data repository definitions from an external file. The file can be either an MVS™ sequential data set, or an MVS partitioned data set member.
If the definitions are contained within a sequential file, then that data set must be associated with a CICS® extrapartition data set, and imported via the CICS Transient Data Queue name that the file is linked to. You must use the Import from a TDQ option of the Import command panel. If the definitions are contained within members of an MVS partitioned data set, then the data set and member identifiers can be specified directly on the Import from a data set panel that follows the Import command panel.
- View sets and menus
- WUI map objects
- User objects
- User group profiles
The IBM® supplied set of WUI view and menu definitions are in the SEYUVIEW partitioned data set, and so you need to specify the Import from a data set function from the Import command panel. The advantage of using this import option is that individual member names can be specified on this panel, and so you can selectively restore individual elements of the backed up view set content.
- Sequential files must be defined as:
Record format: VB Logical record length: 32000 Block size: 32004
- Partitioned data sets must be defined as:
Record format: VB Logical record length: 32000 Block size: 32760
Standard transient data queue definitions are provided for the COVE and COVI TD queues, and they associate to the EYUCOVE and EYUCOVI DD names for inclusion in your WUI server JCL. You can use these TDQUEUE definitions as models for further import/export extrapartition queues.
To import definitions from a sequential file associated with an Extra-partition TDQ:
- Select the Import option from the control panel or use the COVC IMPORT command to open the Import panel.
- Select Import from a TDQ on the Import panel
to open the Import a TDQ panel. The following
illustration shows the Import from a TDQ panel:Figure 1. Import from a TDQ panel
COVC CICSPlex SM Web User Interface Control EYUVCTW Import from a TDQ Input TDQ name : Name of extrapartition TDQ for import Type : MEnu | Viewset | USERGrp | User |MAp | All Import option : Skip | Overwrite | DELETE Current Status : Ready Time : 08:53:57 Applid : CICSHW61 Date : 03/27/2007 PF 1 Help 3 Exit 12 Return - Type in the name of the extrapartition Transient Data queue where the definitions are currently held; for example, COVI.
- Complete the other blank fields as follows:
- Type
- Type in one of the following Types:
- MEnu
- To import only menus.
- Viewset
- To import only view sets.
- User
- To import only user objects.
- USERGrp
- To import only user group profiles.
- MAp
- To import only map objects.
- All
- To import all types of definitions.
Note: Importing any of the Types requires UPDATE access to the associated ESM profile:- For MENUs : ESM profile EYUWUI.*.MENU.menuname
- For MAPs : ESM profile EYUWUI.*.MAP.mapname
- For VIEW sets : ESM profile EYUWUI.*.VIEW.viewsetname
- For USERs and USERGRPs : ESM profile EYUWUI.*.USER
- For ALL : All of the above profiles
- Import option
- Enter the action that you want the server to take if a duplicate
definition is found in the input data set. That is, whether existing
definitions are to be preserved, overwritten, or deleted:
- Skip
- If you specify Skip, only the definitions that do not already exist in the input data set are imported.
- Overwrite
- If you specify Overwrite, definitions 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 that you want to remove and then use the 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.
To import definitions from a partitioned data set:
- Select the Import option from the control panel or use the COVC IMPORT command to open the Import panel.
- Select Import from a data set on the Import panel
to open the Import from a data set panel. The
following illustration shows the Import from a data set panel: Figure 2. Import from a data set panel
COVC CICSPlex SM Web User Interface Control EYUVCTI Import from a data set Input data set name : Name of data set for import Input data set member : Member name, trailing * allowed Type : MEnu | Viewset | USERGrp | User |MAp | All Import option : Skip | Overwrite | DELETE Current Status : Readt Time : 08:53:57 Applid : CICSHW61 Date : 27/03/2007 PF 1 Help 3 Exit 12 Return - Type in the name of the data set member that contains the supplied
view and menu definitions to import. You can use an asterisk at the
end of the input string to specify a group of data set members; for
example, EYUEA* imports all of the members whose
name begins with the characters EYUEA, which are all the English language
menus and view sets from the IBM supplied
SEYUVIEW data set.Note: You cannot leave the member name blank. If you do the panel dialog rejects your request. If your intention is to import from a sequential file, then that file must be associated with an extrapartition TD queue, and you must use the Import from a TD Queue subfunction to transfer the records into the WUI data repository.
- Complete the other blank fields as follows:
- Type
- Type in one of the following Types:
- MEnu
- To import only menus.
- Viewset
- To import only view sets.
- User
- To import only user objects.
- USERGrp
- To import only user group profiles.
- MAp
- To import only map objects.
- All
- To import all types of definitions.
Note: Importing any of the Types requires UPDATE access to the associated ESM profile:- For MENUs : ESM profile EYUWUI.*.MENU.menuname
- For MAPs : ESM profile EYUWUI.*.MAP.mapname
- For VIEW sets : ESM profile EYUWUI.*.VIEW.viewsetname
- For USERs and USERGRPs : ESM profile EYUWUI.*.USER
- For ALL : All of the above profiles
- Import option
- Enter the action that you want the server to take if a duplicate
definition is found in the input data set. That is, whether existing
definitions are to be preserved, overwritten, or deleted:
- Skip
- If you specify Skip, only the definitions that do not already exist in the input data set are imported.
- Overwrite
- If you specify Overwrite, definitions 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 that you want to remove and then use the 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.
Import completion:
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 WUI 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.
If you press PF12 to return to the control panel, message EYUVS0906I is issued.