Merge Data from Prior Version (MRGPRVNS)

How to Get There

Prompt the command MRGPRVNS.

What it Does

The installation program installs Powertech Exit Point Manager for IBM i 7, but does not automatically import information from a previous version. The previous version exit programs remain active, allowing you to continue to use it as you become familiar with version 7 (as long as you do not activate Powertech Exit Point Manager for IBM i 7). Once you’ve familiarized yourself with Powertech Exit Point Manager for IBM i 7, use the Merge Previous NS (MRGPRVNS) command to merge rules from your previous version to version 7. You should review these rules and make any modifications necessary before activating version 7.

Merging data from a previous version of Powertech Exit Point Manager for IBM i does not automatically activate version 7. You must still run the activation process on Powertech Exit Point Manager for IBM i 7 to start using it. See Reactivating Powertech Exit Point Manager for IBM i After an Upgrade (below).

NOTE: The files PLKCAP, PLKCAPCNT, and LNSCAP can be very large due to extensive data retention, and may extend the duration of the merge as Powertech Exit Point Manager for IBM i converts data to the new data format. To expedite the merge process, we recommend clearing these files using CLRPFM. (These files include captured data that is essentially a duplicate of the Audit data for reporting. Captured transactions can go back years/decades and may not be relevant to current traffic.)

Options

Force Run option

Specifies that certain limitations in the migration are to be bypassed. This is useful if you have performed a migration once, made some changes, and need to run the migration again. Normally, the migration is allowed to be executed only once.

*NONE This value indicates that no options are being specified. The migration performs normally.
*FORCE This value indicates that the migration should be allowed to proceed even if it has been run already.
Database conversion options (CVTOPTS)

This parameter contains some settings you may use to limit the amount of data migrated to the new version. This is a multi-part parameter consisting of the following elements:

Add missing data: Specify *ADD to add data to the new version that is in the prior version but is missing from the new version. Specifying *NOADD will not migrate missing data from the prior version.
Update existing data: Specify *UPDATE to update data in the new version that exists in the prior version but is different to that in the prior version. Specifying *NOUPDATE will Leave the data in the new version alone.
Delete extra data Specify *DELETE to remove data from the new version that does not exist in the prior version. Specifying *NODELETE will leave the data in the new version alone.
Convert reporting users (CVTAUTH)

Reporting-only users were registered as members of a particular Authorization List in prior versions. Newer versions of Powertech Exit Point Manager for IBM i employ the internal Product Security functions contained in Central Administration to control access to parts of the software.

*NO This value indicates that no users will be transferred from the reporting Authorization List.
*YES This value indicates that the members of the reporting Authorization List named in the CVTAUTL() parameter will be attached to the Product Security Role you name on the CVTROLE() parameter.
Authorization list (CVTAUTL)

Specifies the name of the Authorization list whose member users will be attached to the Role you name in the CVTROLE() parameter.

*VERDFT This value indicates that the standard reporting Authorization list present in the prior version of the software will be used.
name Specify the name of a different Authorization list to use.
"Reports-only" Role name (CVTROLE)

Specifies the name of the Product Security Role to which the members of the Authorization list will be attached. You must have already created this Role in Product Security in Central Administration; this command will not create it for you.

name Specify the name of the Product Security Role to which the members of the Authorization list will be attached.

Command Keys

F3 (Exit): Exit the screen without processing any pending changes.

F4 (Prompt): Displays a list of possible values.

F5 (Refresh): Refreshes the screen and resets all available text fields.

F9 (All Parameters): Shows all available parameters.

F11 (Keywords): Displays command keywords on the entry fields.

F12 (Cancel): Exit the screen without processing any pending changes.

F13 (How to use this display): Shows help for the prompt display or associated display you are currently using.

F14 (Command string): Displays the command string based on the panel configuration.

F15 (Error messages): Displays error messages.

F16 (Command complete): Submits the command.

F24 (More keys): Exit the screen without processing any pending changes.