IBM i Installation - UCHGRLS (Change Release Tag) Program

Owned by
Former user (Deleted)
Last updated: Nov 29, 2022 by
IT Stonebranch
Version comment
2 min read

Currently, IBM i runs Workload Automation 5.1.1.   These pages provide information for that version.

Overview

All installations of Workload Automation for IBM i, except an upgrade for maintenance, place the Workload Automation for IBM i commands in the product library (UNVPRD511) 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 UNVPRD511. 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 = 511.

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

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

UCHGRLS Examples

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



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



This example runs UCHGRLS to change the 0UNV511 commands in QSYS to the default names and to tag the 0UCM121 and 0UEN121 commands in QSYS with 121.



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