/
IBM i Installation - UCHGRLS (Change Release Tag) Program

IBM i Installation - UCHGRLS (Change Release Tag) Program

Owned by Stonebranch (Deactivated)
Last updated: Oct 01, 2024 by Tony Partin

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

All installations of Universal Agent for IBM i, except an upgrade for maintenance, place the Universal Agent for IBM i commands in the product library (UNVPRD770) and the IBM i QSYS library.

Starting with the 3.2.0 release of Universal Products for IBM i, the command names in QSYS are tagged with the Workload Automation for IBM i version / release / modification number.

To maintain consistency across releases, you may prefer to use untagged names in your production environment. The UCHGRLS (Change Release Tag) program lets you change command names in the IBM i QSYS library from tagged to untagged.

Using UCHGRLS

UCHGRLS resides in UNVPRD770. It provides two parameters, SETTAGVRM and RMVTAGVRM.

  • SETTAGVRM specifies the release number of the release to be tagged.
  • RMVTAGVRM specifies the release number of the tag to be removed.

Removing the tags changes the command names in QSYS to the normal production command names. (See UCHGRLS Examples below.)

For a new installation, specify the following UCHGRLS command options and their values:

  • Set tags (SETTAGVRM) option; value = *NEW.
  • Remove tags (RMVTAGVRM) option; value = 770.

This changes the tagged command names in QSYS to the untagged command names in UNVPRD770.

For an upgrade installation (from a pre-7.7.0 release to 7.7.0), UCHGRLS tags the pre-7.7.0 release command names in QSYS with the version / release / modification number of that release (for example, 770). See Object Inventory Lists for tagged command name details.

UCHGRLS Examples


This example runs UCHGRLS with the default values, following installation of 0UNV770 with 0UNV511 existing on the system.


UNVPRD770/UCHGRLS


This example runs UCHGRLS to revert back to 0UNV511 for the default names in QSYS with 0UNV770 installed. (This should be done prior to re-installing 0UNV770, assuming that 0UNV511 remains installed on the system.)


UNVPRD770/UCHGRLS SETTAGVRM(770) RMVTAGVRM(511)


This example runs UCHGRLS to change the 0UNV770 commands in QSYS to the default names and to tag the STRUCM511 and STRUEN511 commands in QSYS with 511.


UNVPRD770/UCHGRLS SETTAGVRM(511) RMVTAGVRM(770)


This example runs UCHGRLS to set the 0UNV770 commands in QSYS to the default names, where 0UNV770 is the first Universal Agent installation on an IBM i system.


UNVPRD770/UCHGRLS SETTAGVRM(*NEW) RMVTAGVRM(770)

Related content