CHANGE

Purpose

CHANGE is a powerful command that you can use to make changes to many data sets at once. Using CHANGE is much faster than making changes to individual data sets in the dialog, so you should use it whenever possible to save time.

The following syntax diagram shows the primary keywords for the CHANGE command. Each of these keywords is separately documented, along with their unique parameters, in the following topics.

Syntax


CHANGE

>>-+-CHANGE-+--+-DSNAME-------+--------------------------------><
   '-CH-----'  +-DSNAME *HLQ*-+   
               +-DSNTYPE------+   
               +-LVOL---------+   
               +-MCAT---------+   
               +-PVOL---------+   
               +-RENAME-------+   
               +-SECOND-------+   
               +-SMS----------+   
               '-SPACE--------'

Parameters

DSNAME: Renames one or more data sets. See CHANGE DSNAME for details.
DSNAME *HLQ*: Changes the high-level qualifier for one or more data sets. See CHANGE DSNAME *HLQ* for details.
DSNTYPE: Allows changing between PDS and PDSE or HFS and zFS data sets. See CHANGE DSNTYPE for details.
LVOL: Reassigns one or more data sets to a different logical volume. See CHANGE LVOL for details.
MCAT: Overrides the dialog's requirement for one or more data sets to be defined in the system's master catalog. See CHANGE MCAT for details.
PVOL: Reassigns one or more data sets to a different physical volume. See CHANGE PVOL for details.
RENAME: Overrides for one or more data sets the dialog's restriction on renaming the data set. See CHANGE RENAME for details.
SECOND: Change secondary allocation of data sets with shipped value of 0. See CHANGE SECOND for details.
SMS: Changes the SMS management status of one or more data sets. See CHANGE SMS for details.
SPACE: Changes the space attributes for one or more data sets. See CHANGE SPACE for details.

Processing

The general procedure for using the CHANGE command is:

Decide which data sets you want to change
Pick a characteristic of those data sets for which you can display a list of desired data sets. You will probably want to pick a characteristic that eliminates as many unwanted data sets as possible.
Enter the desired CHANGE command on the resulting display list
Based on the parameters specified on the CHANGE command, the dialog checks the data sets in the current display list and returns a candidate list of data sets that are eligible to be changed by the command. At this point, changes are only simulated; no data sets have actually been changed.
Determine whether to:
- Commit the changes as shown in the display (by pressing Enter or End)
- Exclude particular data sets from the candidate list before committing the changes (by identifying the data sets to be excluded with the X line command and then pressing Enter or End), or
- Cancel the change request (by entering the ISPF CANCEL command and pressing Enter).
Unless you cancel the change request, the CHANGE command will apply the specified change to all selected data sets (that is, all the data sets on the list that you did not exclude).

Note: The CHANGE command may be abbreviated as CH.