QUERY TAG

Read syntax diagramSkip visual syntax diagram Query TAG DEVCONsolePrinterPUnchvdev1FILEspoolid
Notes:
  • 1 vdev must be a console, printer or punch.

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

  1. You can control the format and content of the tag field using the TAG command.
  2. 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.