Processing

With the ZONERENAME command, you can rename a specified distribution or target zone. SMP/E supports the following variations of renaming:

Distribution zone to distribution zone
Target zone to target zone
Distribution zone to target zone

The rename operation itself is very simple. Before doing it, however, SMP/E makes sure the correct parameters have been entered and that the rename request is valid. If any of the checks fail, an error message is issued, and the rename operation is terminated. The following checks are made:

oldzonename and newzonename must not be the same.
The new zone must not already exist in the data set it is to reside in.
A GLOBALZONE ZONEINDEX entry for the new zone name must not already exist.
If TOTYPE(TARGET) is specified:
- The GLOBALZONE ZONEINDEX entry for the old zone name must be a distribution zone.
- The NEWDATASET operand must also be specified, and the SAMEDATASET operand must not be specified.
If NEWDATASET is specified, the data set name specified in the NEWDATASET operand must not be the same as the data set value for the old zone name.
If SAMEDATASET is specified, a GLOBALZONE ZONEINDEX entry must already exist for the old zone name.
No cross-zone subentry from the zone being renamed refers to the new zone name.

If all validity checking is successful, the renaming can be done. The following operations are done to rename a zone:

A GLOBALZONE ZONEINDEX entry is added for the new zone name. The data set name is the same as either the value in the old zone (if SAMEDATASET was specified) or the name specified in the NEWDATASET operand. The zone type is the same as the old zone type unless the TOTYPE(TARGET) operand is coded, in which case the type is set to TARGET.
A zone definition entry (either TARGETZONE or DLIBZONE entry) is created for the new zone; the zone definition for the old zone is taken as a base.
If the RELATED operand or the OPTIONS operand, or both, were specified, that information is used in the zone definition entry; otherwise, that data remains as is in the old zone.
The old zone definition entry is deleted.
If the SAMEDATASET operand is specified, the ZONEINDEX entry for the old zone is deleted.