Exporting WUI definitions

Use the COVC export function to export WUI data repository definitions to an external file. The file can be used as a backup to the WUI from which it was extracted, and can also be distributed to other WUI regions for replicating your customized WUI environment around your CICSplex.

The file can be either an MVS™ sequential data set, or a member of an MVS partitioned data set (PDS).

If the export target is an MVS sequential data set, then it should have the definition attributes of:
Record format: VB
Logical record length: 32000
Block size: 32004
If the export target is a member of a PDS, then it should have the definition attributes of:
Record format: VB
Logical record length: 32000
Block size: 32760
When the export operation is complete, then the target file is an offline backup for the records that are exported, and can be used in subsequent import operations in other WUI regions to migrate your WUI definitions around your CICSplex.
Note: Unlike the import operation (where you can select to import from a PDS member or from an extrapartition TD queue), export operations must be only executed against a TD queue name.

If you customize your WUI panel configuration, and want to flow that configuration to other WUI regions in your CICSplex (for the purposes of view consistency or WUI version migration), you must use the COVC transaction to export WUI definitions so that you can distribute definitions to other WUI servers or transfer definitions when you upgrade to a new release.

Sample definitions are supplied for the COVI and COVE extrapartition TD queues. If you want to export different elements of your WUI definitions to different data sets, then you must provide alternative TD queues (and related data sets) as the targets for each export operation. If you execute consecutive export requests to the same target TD queue, then each operation overwrites the contents of the previous one.

To export definitions from the WUI repository select the Export option from the control panel or use the command COVC EXPORT. This opens the COVC Export panel, as shown in Figure 1.
Figure 1. 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 | MAp | User | All   
                                                                              
  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    
Complete the blank fields in the Export panel as follows:
  • The Output TDQ Name is the name of the extrapartition transient data queue where the definitions are be exported to, for example, COVE.
  • Type in one of the following Types:
    MEnu
    to export only menus
    Viewset
    to export only view sets
    User
    to export only user objects
    MAp
    to export only map objects.
    USERGrp
    to export only user group profiles.
    All
    to export all types of definitions.
    Note: Exporting any of the Types requires READ or 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
  • Name is the specific or generic name of the object that is to be exported. The convention for using generic names, when exporting, is:
    • An asterisk (*) represents any number of characters. It must be the last or only character in the string. For example:
      • EYU* means all definitions that have a name beginning with the characters EYU
      • * means all definitions

      If the object being exported contains an asterisk (*) as part of its name, then it can be exported only generically. For example, if there are 3 objects *GROUP1, GROUP*2 and GROUP3, a Name value of * must be used to export *GROUP1 (and objects GROUP*2 and GROUP3 are also exported).

      A Name value of GROUP* could be used to export object GROUP*2 (which also causes GROUP3 to be exported).

  • The Lock option enables you to apply a lock to exported definitions. When locked definitions are subsequently imported into a repository, they cannot be modified or deleted by using the view editor. Locked definitions cannot be unlocked: they can be removed only by using the delete option on the Import panel:
    NONE
    Do not lock unlocked definitions. Existing locked definitions are exported as locked definitions.
    LOCK
    Lock all exported definitions.
    Note: If you overwrite a set of unlocked definitions with a locked set, the only way to remove the locks is to re-import a set of unlocked definitions to overwrite the locked set. For this reason, you might want to keep a backup set of unlocked definitions before you replace them with a locked set.

When all the fields are complete, press Enter to export the view or menu definitions.

Message EYUVS0919I is issued on the Export panel, which indicates 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 must 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 definitions 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.

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



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