Usage notes

1. Do not use SCOPY for a queue manager that is running because results will be unpredictable. We can avoid doing this accidentally by using DISP=OLD in the page set DD statement.

2. When you use SCOPY, you do not need to specify a queue manager name.

3. If you want to operate on a range of page sets, repeat the SCOPY function for each page set.

4. The function operates only on local queues and only for persistent messages.

5. A SCOPY PSID function is considered successful only if it successfully copies all the queues on the page set that have messages; empty queues are ignored. If the page set has no queues with messages, the SCOPY function fails, and no data is written to the data set.

6. If you try to copy an empty queue explicitly by SCOPY QUEUE, data indicating this is written to the sequential data set, and the copy is considered to be a success. However, if you attempt to copy a nonexistent queue, the SCOPY function fails, and no data is written to the data set.

7. If the SCOPY function fails, no further CSQUTIL functions are attempted.

8. To use the SCOPY function more than once in the job, specify different DDnames and data sets for each invocation of the function, or specify a sequential data set and DISP=MOD in the DD statements.