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

QUERY FILES
Usage Notes
Responses
Messages
1. Privilege class G users can enter QUERY FILES to display the number of spool
files they own or have generated. Privilege class D users can enter QUERY
FILES to display all spool files in the system, or all files that belong to a
particular user of that system.
2. If the user ID option is used with the XFER option by a class D user, the
specified user ID is treated as the originator of the files. The result is a count of
the files generated by the first user, and includes those files owned by the user
specified after the XFER option.
For example, if a class D user enters query files user1, a count is returned of
the files that USER1 owns.
If a class D user enters query files xfer user2, a count is returned of the files
that USER2 owns, but did not generate.
If a class D user enters query files user1 xfer user2, a count is returned of
the files generated by USER1 and owned by USER2.
3. In a CSE complex, if the AVAIL operand is not specified, this command displays
information about all files in the system on which the command is processed. If
the AVAIL operand is specified, this command does not display information
about files that are locked by another system.
Response 1:
For the class D user:
FILES: {nnnnnnn} RDR, {nnnnnnn} PRT, {nnnnnnn} PUN
{ NO} { NO} { NO}
where nnnnnnn is the number of spool files of each type.
For the class G user:
FILES: {nnnn} RDR, {nnnn} PRT, {nnnn} PUN
{ NO} { NO} { NO}
where nnnn is the number of spool files of each type.
Note: If a class G user issues QUERY FILES (or if a privileged user issues
QUERY FILES *), and if that user has more than 9999 rdr, prt, or pun files,
the response will still only show 9999 files.
HCP003E Invalid option - {option|command
contains extra option(s) starting with
option}
HCP042E User userid spoolid nnnn does not exist
HCP053E userid not in CP directory
HCP364E No alternate userid is currently set.
802 z/VM: CP Commands and Utilities Reference
HCP413E Command processing cannot complete
due to a spool paging error.
HCP422E The same option was specified twice.
HCP423E The function requested is incompatible
with a previously specified operand.
HCP475I Fatal I/O error trying to read directory
from volid [for user userid]