QUERY TAG
Authorization
Privilege Class: G
Purpose
Use QUERY TAG to display the tag information associated with a specific virtual spool device or file.
Operands
- DEV
- is an optional keyword which VM/ESA accepts for compatibility reasons.
- CONsole
- Printer
- PUnch
- vdev
- specifies the virtual spooling device whose tag information you want to display. You can specify the virtual device number vdev of a device if you want to query the tag information associated with a virtual spooling device at a particular device location.
- FILE spoolid
- specifies that you want to display the tag information associated with a previously closed spool file owned by your virtual machine. The operand spoolid is the system-assigned spool file identifier that belongs to the file.
Usage Notes
- You can control the format and content of the tag field using the TAG command.
- If an external security manager is installed on your system, you may not be authorized to enter this command. For additional information, contact your security administrator.
Responses
Response 1:
type vdev TAG:
tagtext
displays the tag information associated with a virtual spooling device.- type
- identifies the type as PRT, PUN, or CONS.
- vdev
- identifies the virtual device number.
- tagtext
- identifies the tag information associated with the device. This tag information may be up to 136 characters long.
Response 2:
tagtext
- or -
(TAG BLANK)
displays the tag information associated with a specified spool
file.- tagtext
- identifies the tag information associated with the file. This tag information may be up to 136 characters long.
- (TAG BLANK)
- is displayed when the tag is all blanks.
Response 3:
type {vdev } TAG NOT SET
is the response if: - You have not specified tag information for a device
- You have explicitly set the tag field to blanks.
- type
- identifies the type as PRT, PUN, or CONS.
- vdev
- identifies the virtual device number.
Messages
- HCP002E Invalid operand - operand
- HCP016E TAG invalid for specified file type
- HCP022E A virtual device number was not supplied or it was invalid.
- HCP026E Operand missing or invalid
- HCP035E Device type missing or invalid
- HCP040E Device {rdev|vdev|ldev} does not exist
- HCP413E Command processing cannot complete due to a spool paging error.