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

2. If the userid option is used with the XFER option, the userid option is treated as
the origin ID of the files. The result is information about the files generated by
the first user and which are owned by the user specified after the XFER option.
If a Class D user enters QUERY PRT USER1, he or she receives information
about the printer files that USER1 owns.
If a Class D user enters QUERY PRT XFER USER2, he or she will receive
information about the printer files that USER2 owns but did not originate.
If a Class D user enters QUERY PRT USER1 XFER USER2, he or she will
receive information about the printer files generated by USER1 but owned by
USER2.
3. For Class D Users:
QUERY READER/PRINTER/PUNCH
v The userid and SYSTEM options are permitted for class D users only.
v If you use a one-to-four digit, all-numeric userid, the QUERY command
produces unpredictable results because it also has a one-to-four digit,
all-numeric spoolid parameter.
v If you specify spoolid, you must also specify userid or an asterisk (*).
4. If DEST is not specified on a command that can select files by DEST, the
destination value of the file is ignored. The AVAIL option limits the files displayed
to include only those files which are currently available to the virtual machine.
When the virtual machine issues a read to the virtual card reader and a reader
file is not already open, the first file which is available is selected. It is possible
for a file not currently available to be on the chain ahead of another which is
available (that is, CP is checkpointing the file). And it is possible that this file
can become available between the time that this QUERY command is issued
and the time that the virtual machine actually issues a read. If it is important that
a particular file be selected on the read, then that file should be placed at the
beginning of the queue with the ORDER command before the read is issued. An
alternative for use in a program is Diagnose X'14' subcode X'2C'. This function
allows a program to choose a particular reader file, order it, and read the first
record all in one operation.
5. The SECLABEL option is valid only when an external security manager (ESM)
is installed and security label checking is enabled.
6. When security label checking is enabled, the ESM is called to verify the user’s
access to each file. If the user is denied access to a specific file, some of the
information about that file must be hidden from the user. The only fields of the
response that will contain information are ORIGINID, FILE, CLASS, HOLD,
DATE and TIME. All other fields contain asterisks. If a security label is not
assigned to the file, the SECLABEL field contains the word NONE.
7. The default date format for certain CP and CMS commands can be set on a
system-wide basis and also for the individual user. The system-wide default
date format is set with the SYSTEM_DATEFORMAT system configuration
statement. The user’s default date format is set with the DATEFORMAT user
directory control statement. The system-wide default and the user’s default can
also be set with the CP SET DATEFORMAT command. The user’s default date
format defaults to the system-wide default. The system-wide and user settings
can be queried with the CP QUERY DATEFORMAT command. The hierarchy of
possible date format settings for the QUERY RDR/PRT/PUN command, from
highest priority to lowest, is:
v QUERY RDR/PRT/PUN command option
v User default
v System-wide default
Chapter 2. CP Commands 947