Expanding a page set (COPYPAGE) on z/OS®
Use the COPYPAGE function to copy one or more page sets to a larger page set.
Use the COPYPAGE function to copy one or more page sets to a larger page set. All queues and messages on the page set are copied. If you copy page set zero, all the IBM® MQ object definitions are also copied. Each page set is copied to a destination data set that must be formatted as a page set. Copying to a smaller page set is not supported.
If you use this function, you must modify the page set definition in the started task procedure to reflect the change of the name of the data set on which the new page set resides.
To use the COPYPAGE function, define DDnames in the range CSQS0000 through CSQS0099 for the source data sets, and define DDnames for the target data sets from CSQT0000 through CSQT0099.
Keywords and parameters
There are no keywords or parameters.
Example
- Set up the required DDnames, where:
- CSQP0005, CSQP0006
- Identify the destination data sets. These DDnames are used by the FORMAT function.
- CSQS0005, CSQS0006
- Identify the source data sets containing the two page sets you want to copy.
- CSQT0005, CSQT0006
- Identify the destination data sets (page sets), but this time for the COPYPAGE function.
- Format the destination data sets, referenced by DDnames CSQP0005 and CSQP0006, as page sets using the FORMAT function.
- Copy the two existing page sets onto the new page sets using the COPYPAGE function.
Usage notes
- You cannot use COPYPAGE on page sets of a queue manager that is running.
- Using COPYPAGE involves stopping the queue manager. This results in the loss of nonpersistent messages.
- Before you use COPYPAGE, the new data sets must be preformatted as page sets. To do this, use the FORMAT function, as shown in Figure 1.
- Ensure that the new (destination) data sets are larger than the old (source) data sets.
- You cannot change the page set identifier (PSID) associated with a page set. For example, you cannot 'make' page set 03 become page set 05.
- Failure of this function does not prevent other CSQUTIL functions from being attempted.
- If you attempt to use the COPYPAGE function after the queue manager has terminated abnormally,
the page sets might not have been closed properly. If a page set has not been closed properly, you
cannot successfully run the COPYPAGE function against it.
To avoid this problem, run the AMS VERIFY command before using the COPYPAGE function. The AMS VERIFY command might produce error messages. However, it does close the page sets properly, so that the COPYPAGE function can complete successfully.
For more information about the AMS VERIFY command, see the z/OS DFSMS Access Method Services for VSAM manual.
- See Defining a page set to be larger than 4 GB for information on using the EXTENDED attribute on the DATACLAS parameter.