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.

The view definition data comprises:
  • 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.

View sets that are exported and imported with COVC import function have specific file definition requirements:
  • 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:

  1. Select the Import option from the control panel or use the COVC IMPORT command to open the Import panel.
  2. 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                                  
  3. Type in the name of the extrapartition Transient Data queue where the definitions are currently held; for example, COVI.
  4. 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.
  5. Press Enter to start the operation.

To import definitions from a partitioned data set:

  1. Select the Import option from the control panel or use the COVC IMPORT command to open the Import panel.
  2. 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                                  
  3. 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.
  4. 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.
  5. 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.



eyuadak.html | Timestamp icon Last updated: Sunday, 4 June 2017