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).
Record format: VB
Logical record length: 32000
Block size: 32004
Record format: VB
Logical record length: 32000
Block size: 32760
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.
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
- 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).
- An asterisk (*) represents any number of characters. It must be
the last or only character in the string. For example:
- 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.