ISPF tables for Universal Information Exchange

The internal format of the ISPF table data set that contains the Universal Information Exchange (UIE) studies and their associated data changes from version to version. If you are an existing UIE user, each of the TSO users that has executed the UIE version 1.x.00 ISPF front end has created some or all of the following data sets:

userid.userprf.E2TB1x00
userid.userprf.E2FT1x00
userid.userprf.E2CT1x00
userid.userprf.E2MT1x00

The userid.userprf.E2CT1x00 and userid.userprf.E2MT1x00 data sets contain temporary data and can be safely deleted at any time. userid.userprf.E2FT1x00 data set contains the JCL that was created as a result of the ISPF file tailoring that occurs whenever you invoke Option 5, Build the job and command input stream, from the Universal Information Exchange Main Menu. Any JCL that is generated by the UIE version 1.x.00 ISPF front end is stored in this data set.

You might have one or more members of that partitioned data set that you want to copy over to the corresponding UIE version 1.x.00 data set. The data set userid.userprf.E2TB1x00 contains the five tables that contain all of your existing studies and their associated data. The member names are as follows:

E2KTCMD
 E2KTDSN
 E2KTJCL
 E2KTREL
 E2KTSYS

When a TSO user invokes the UIE version 1.x.00 ISPF front end for the first time, the product allocates a data set named userid.userprf.E2TB1x00 and primes it with the data for a single default study. After you have tested the new version for a reasonable period, you can follow this simple process to convert your old studies to the new format if you want to retain them. Use any of the standard z /OS methods for copying partitioned data set members to copy all five members of userid.userprf.E2TB1x00 to the new userid.userprf.E2TB1x00. ISPF Option 3.3 is probably the easiest method to use. BMC recommends that you:

• Do not attempt to convert your existing ISPF tables.
• Be certain to copy all five members and be sure to specify REPLACE when you do the copy.
• Invoke the Universal Information Exchange version 1.x.00 ISPF front end.

You will see the BMC legal disclaimer and then the following message:

If the conversion succeeds, the Universal Information Exchange Main Menu version 1.x.00 is displayed along with the following message:

If the conversion fails, you will see the following message:

Re-running MVUIE in debug mode by using the following form of the command might give you more information:

After the failure message, the Universal Information Exchange ISPF front end exits. If this does occur, contact BMC Customer Support for help. After you have converted your existing studies, they will no longer work properly in any older version of UIE.