Usage notes
- The queues involved must not be in use when the function is invoked.
- If you want to operate on a range of page sets, repeat the COPY function
for each page set.
- The function operates only on local queues.
- A COPY PSID function is considered successful only if it successfully
copies all the queues on the page set.
- If you try to copy an empty queue (either explicitly by COPY QUEUE or
because there are one or more empty queues on a page set that you are copying),
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, or a page set containing no queues, the COPY function fails, and no
data is written to the data set.
- If COPY fails, no further CSQUTIL functions are attempted.
- To use the COPY 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.
- You need the necessary authority to use the command server queues (SYSTEM.COMMAND.INPUT,
SYSTEM.COMMAND.REPLY.MODEL, and SYSTEM.CSQUTIL.*), to use the DISPLAY
QUEUE and DISPLAY STGCLASS MQSC commands, and to open the queues that you
want to copy with the MQOO_INPUT_EXCLUSIVE and MQOO_BROWSE options.