Parameters

The parameters are:

DELETE

Specifies that the system is to remove one or more local page data sets from system use. The system migrates the in-use slots of the deleted data set(s) to other page data sets.

REPLACE

Specifies that a local page data set is to be replaced by a newly-opened data set of equal or greater size. The new data set must previously have been formatted and cataloged. It can be on a different type of device then the original data set. REPLACE fails if an I/O error occurs on either data set. The system migrates the in-use slots from the old data set to the new data set, then remove the old data set from system use.

DRAIN

Specifies that one or more local page data set are to be made read-only. When the current tasks complete, the in-use slots are freed during normal system operation. When you plan a PAGEDEL DELETE or REPLACE operation as part of a system reconfiguration, by allowing the data sets to drain (quiesce) before issuing the DELETE or REPLACE, you will reduce the number of in-use page data sets to migrate. You can make a data set that is draining read/write again by issuing a PAGEADD command for the data set.

PAGE=dsname[,dsname]...

The name of one or more local page data sets. If dsname is not the name of an in-use local page data set, the system issues messages IEE201I and IEE202I.

(dsname,rdsname)[(dsname,rdsname)]...

The name of one or more data sets to be replaced by the new data set name(s). If any data set name you specify as (dsname) is not the name of an in-use local page data set, if any data set name you specify as (rdsname) is in use, the system issues messages IEE201I and IEE202I.

Example 1:

PD DELETE,PAGE=page3

Example 2:

PD DELETE,PAGE=sys1.page01,sys1.page02,page3

Example 3:

PD REPLACE,PAGE=(sys1.page01,sys1.page04)

Example 4:

PD REPLACE,PAGE=(sys1.page01,sys1.page02),(page3,page7)