IBM i Installation - Product Removal
Currently, Universal Agent 7.7.0 for IBM i does not include Universal Command (UCMD) or Universal Data Mover (UDM). Customers who require those components should use an older version of Workload Automation for IBM i. The latest version containing those components is 5.1.1. Older versions of Workload Automation for IBM i can be installed alongside version 7.7.0.
Overview
This page provides processes for the removal of current (7.7.0) and previous (5.1.1 or earlier) releases of Universal Agent for IBM i.
If you remove the currently installed release before installing or re-installing a 5.1.1 release, the removal process deletes the default command reference library, UNVCMDREF, in which the command reference files are located.
If you remove the currently installed release after installing or re-installing a 5.1.1 release, UNVCMDREF is not deleted.
To keep your command reference files from being deleted, rename UNVCMDREF and change the library owner. Release 5.1.1 will let you specify this library - or any library - as your command reference library via the CMD_REFERENCE_DIRECTORY option.
Before removing a 5.1.1 release, check CMD_REFERENCE_DIRECTORY in the Universal Command server member (UCMDS) of the Workload Automation configuration file (UNVCONF) - located in the product library (UNVPRD511); an alternate command reference library previously may have been selected. If it has, manually clear and delete the default command reference library, UNVCMDREF, after removing the 5.1.1 release.
Warning
If the UCHGRLS command was used to rename the 511-tagged names to normal production names (see UCHGRLS (Change Release Tag) Program), you must perform the following steps prior to uninstalling either 5.1.1, 5.1.0, 4.3.0, 4.2.0, 4.1.0, 3.2.0, 3.1.1, or 1.2.1:
Step 1 | Run the UCHGRLS command to temporarily rename the 5.1.1 Workload Automation commands in QSYS to the 511-tagged names and the tagged names of the older product to the normal production names. Without this step, Workload Automation may no longer run as expected. |
---|---|
Step 2 | After removal of the older product is complete, use the *NEW option with the UCHGRLS command to change the 511-tagged names back to the normal, production names. |
Universal Encrypt 1.2.1
Note
Before performing this uninstall, read the Overview, above.
You must uninstall Universal Encrypt 1.2.1 before uninstalling Universal Command 1.2.1.
The user ID used for uninstalling Universal Encrypt must have authority to delete all Universal Encrypt product-related objects.
To uninstall Universal Encrypt, perform the following steps:
Step 1 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UEN121) |
---|---|
Step 2 | If the following message displays, use the DSPJOBLOG command to identify the problem: |
Universal Command 1.2.1
Note
Before performing this uninstall, read the Overview, above.
Before uninstalling Universal Command 1.2.1, you must uninstall Universal Encrypt 1.2.1.
The user ID used for uninstalling Universal Command must have *ALLOBJ and *SECADM special authorities.
To uninstall Universal Command, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UBROKER). ===>ENDSBS UBROKER |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UCM121) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |
Universal Products 3.1.1
Note
Before performing this uninstall, read the Overview, above.
The user ID used for uninstalling Universal Products 3.1.1 must have *ALLOBJ and *SECADM special authorities.
To uninstall Universal Products 3.1.1, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UBROKER). ===>ENDSBS UBROKER |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV311) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: |
Universal Products 3.2.0
Note
Before performing this uninstall, read the Overview, above
The user ID used for uninstalling Universal Products 3.2.0 must have *ALLOBJ and *SECADM special authorities.
To uninstall Universal Products 3.2.0, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR320). On the IBM i command line, execute the following command: ===>ENDSBS UNVUBR320 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV320) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |
Universal Products 4.1.0
Note
Before performing this uninstall, read the Overview, above.
The user ID used for uninstalling Universal Products 4.1.0 must have *ALLOBJ and *SECADM special authorities.
To uninstall Universal Products 4.1.0, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR410). ===>ENDSBS UNVUBR410 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV410) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: |
Stonebranch Solutions 4.2.0
Note
Before performing this uninstall, read the Overview, above.
The user ID used for uninstalling Stonebranch Solutions 4.2.0 must have *ALLOBJ and *SECADM special authorities.
To uninstall Stonebranch Solutions 4.2.0, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR420). On the IBM i command line, execute the following command: ===>ENDSBS UNVUBR420 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV420) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |
Stonebranch Solutions 4.3.0
Note
Before performing this uninstall, read the Overview, above.
The user ID used for uninstalling Stonebranch Solutions 4.3.0 must have *ALLOBJ and *SECADM special authorities.
To uninstall Stonebranch Solutions 4.3.0, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR430). On the IBM i command line, execute the following command: ===>ENDSBS UNVUBR430 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV430) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |
Workload Automation 5.1.0
Note
Before performing this uninstall, read the Overview, above.
The user ID used for uninstalling Workload Automation 5.1.0 must have *ALLOBJ and *SECADM special authorities.
To uninstall Workload Automation 5.1.0, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR510). On the IBM i command line, execute the following command: ===>ENDSBS UNVUBR510 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV510) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |
Workload Automation 5.1.1
Note
Before performing this uninstall, read the Overview, above.
The user ID used for uninstalling Workload Automation 5.1.1 must have *ALLOBJ and *SECADM special authorities.
To uninstall Workload Automation 5.1.1, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR511). On the IBM i command line, execute the following command: ===>ENDSBS UNVUBR511 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV511) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |
Universal Agent 7.7.0
Note
Note
Before performing this uninstall, read the Overview, above.
To uninstall Universal Agent 7.7.0, perform the following steps:
Step 1 | If it is active, end the Universal Broker subsystem (UNVUBR770). On the IBM i command line, execute the following command: ===>ENDSBS UNVUBR770 |
---|---|
Step 2 | To remove the licensed program, execute the following command: ===>DLTLICPGM LICPGM(0UNV770) |
Step 3 | If the following message displays, use the DSPJOBLOG command to identify the problem: Correct the problem and repeat Step 2. |