Set Upgrade Environment (SETUPGENV)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Set Upgrade Environment (SETUPGENV) command prompts the user for information that is required to help the user plan for and perform the upgrade. The information that is gathered is stored in library QUPGRADE.

Top

Parameters

Keyword Description Choices Notes
UPGENV Upgrade environment Character value, *NEW, *UPGENVID Required, Positional 1
TGTRLS Target release Character value Optional, Positional 2
TGTPRC Target processor Character value, *DFT Optional, Positional 3
MERGE Merge with Advanced/36 *NO, *YES Optional, Positional 4
UPGENVID Upgrade environment identifier Name, *SRLNBR Optional, Positional 5
Top

Upgrade environment (UPGENV)

Specifies whether a new upgrade environment is being created or if you want to work with an existing environment.

*NEW
Specifies a new upgrade environment is being created.
*UPGENVID
Specifies that you want to work with an existing upgrade environment. The identifier of the existing upgrade environment is specified in the upgrade environment identifier field.
Top

Target release (TGTRLS)

Specifies the target release to which you intend to upgrade. This field is only valid when the Upgrade Environment (UPGENV) value is *NEW.

target-release
Specify the release level in the format VxRxMx. Valid values depend on the current version, release, and modification level, and they change with each new release.
Top

Target processor (TGTPRC)

Specify the feature code of the iSeries processor you expect for your target system. This field is only valid when the Upgrade Environment (UPGENV) value is *NEW.

The processors listed are the valid target processors for upgrading your source iSeries system. Other valid processors may be entered but the upgrade would represent an unsupported upgrade.

*DFT
Specifies the smallest processor necessary to provide similar performance to that of the source system.
target-processor
Specifies the four digit feature code of the target processor. Valid values depend on the source and target releases.
Top

Merge with Advanced/36 (MERGE)

Indicates whether System/36 operating system (SSP) will be running as guest on the target system. This field is only valid when the Upgrade Environment (UPGENV) value is *NEW

*NO
Indicates this system will not be merged with a System/36
*YES
Indicates this system will be merged with a System/36
Top

Upgrade environment identifier (UPGENVID)

Specifies the identifier associated with an upgrade environment. You may develop several upgrade environments as you are planning the order for your upgrade. Each environment may use different values and upgrade methods to help you decide which upgrade method and approach is best for you and your business. Only one upgrade environment will be used for upgrade preparation and the upgrade.

*SRLNBR
Specifies the default name for the upgrade environment. The upgrade environment identifier for this environment will be the serial number of this system appended to the letter 'Q', for example, Q0100A12.
upgrade-environment-identifier
Specifies a character name as the upgrade environment identifier.
Top

Examples

None
Top

Error messages

Unknown
Top