z/VM: CP Commands and Utilities Reference - z/VM - IBM

XSPOOL GATHER
Usage Notes
Responses
1754 z/VM: CP Commands and Utilities Reference
1. Try to set up your procedures so that XSPOOL GATHER processes
automatically each time CMS is IPLed.
2. This command does not process any spool files itself. All processing is done in
an XSPOOL service virtual machine. These XSPOOL service virtual machines
must be included in each system’s OUTPUT spool file exclusion list, in the
installation macro CSEUSER EXCLOUT.
3. Spool files cannot be gathered if they:
v Are in user or system hold
v Are locked by any system on the other side of the complex
v Have information in the FLASH or MODIFY name fields and are on PRT or
PUN queues
v Have TAG text and the NOTAG parameter has been entered.
4. If the user ID that issued the XSPOOL GATHER command is logged onto more
than one system in the complex, no spool files can be gathered.
5. If EXECs have been modified incorrectly or the service virtual machine receives
an incorrect request from a source other than the XSPOOL EXEC, you receive
error messages XSPOOL110 or XSPOOL112.
During its processing, there is no normal response to the XSPOOL GATHER
command.
When the command has been processed, the XSPOOL service virtual machine
sends one of the following messages unless you specify the NOMSG option:
XSPOOL001 -- nnnn FILES GATHERED
XSPOOL100 -- parm IS NOT A VALID PARAMETER FOR THE
XSPOOL GATHER COMMAND
XSPOOL101 -- NO FILES GATHERED - NO XSPOOL SERVICE
VIRTUAL MACHINE IS AVAILABLE
XSPOOL102 -- NO FILES GATHERED - NO ASSOCIATED
SYSTEMS ARE ACTIVE
Responses from the XSPOOL service virtual machine are sent using the MSGNOH
command. You receive them asynchronously after the XSPOOL GATHER command
is processed.