QUERY VIRTUAL CONSOLE

Read syntax diagramSkip visual syntax diagram Query Virtual CONsole EXTended

Authorization

Privilege Class: G

Purpose

Use QUERY VIRTUAL CONSOLE to display status of the console device accessible to your virtual machine.

Responses

Response 1:

CONS vdev {ON [netname.]luname} {TERM  } {STOP } [VSM userid]
          {ON GRAF rdev}        {NOTERM} {START} [HOST userid [FROM ipadr]]
          {ON LDEV ldev}
          {ON LINE rdev}
          {ON SYSC     }
          {DISCONNECTED}
 
vdev CL c {CONT  } {HOLD  } {CPY  *nnn} {READY   }
          {NOCONT} {NOHOLD} {COPY  nnn} {NOTREADY} FORM userform
 
vdev TO userid {RDR} DIST distcode  FLASHC ccc DEST dest
               {PRT}
               {PUN}
 
vdev FLASH name CHAR char [char[char[char]]] MDFY cmod n FCB fcb LPP nnn
 
vdev {3215} {EOF  } {OPEN spoolid} {KEEP  } {MSG  }
     {3270} {NOEOF} {CLOSED      } {NOKEEP} {NOMSG}
 
{NAME fname ftype  }
{NONAME            }
 
[vdev SUBCHANNEL = vsub ]
vdev
is the virtual machine console.
[netname.]luname
is an SNA/CCS terminal (controlled by a VTAM® service machine) that is the virtual console of this virtual machine. It is the name from the VTAM definition of the terminal as an SNA logical unit. The netname. is a network qualifier followed by a period delimiter, and is only present when the the EXTended option is specified and the VSM supports network qualified names.
rdev
is the real or logical device number associated with the virtual console if the console is not disconnected.
ON GRAF rdev
ON LINE rdev
ON LDEV ldev
is the real or logical device number of the virtual console if the console is not disconnected.
ON SYSC
identifies the system console as being associated with the virtual console.
DISCONNECTED
indicates that the console is disconnected.
TERM
NOTERM
indicates whether terminal output is or is not produced when console spooling is in effect.
START
STOP
indicates whether console spooling has been started or stopped for the device.
VSM userid
provides the user ID of the VTAM service machine managing the device.
HOST userid
provides the user identifier of the virtual machine managing the logical device.
FROM ipadr
provides the IP address of the TCP/IP Telnet client associated with the logical device.

An IPv4 address is displayed in dotted-decimal format.

Example: 9.130.44.144

An IPv6 address is displayed in compressed format (:: designates multiple 16-bit groups of zeros).

Example: The following is an IPv6 address: 
F802:0000:0000:0000:0000:0000:0A00:0001
This address is displayed in compressed format as: 
F802::A00:1
CL c
identifies the class of spool file created on this device.
CONT
NOCONT
controls the continuous spooling option. For output files, CONT causes all CLOSE requests to be ignored unless specified with the EOF override option.
HOLD
NOHOLD
controls the HOLD status. For output devices, HOLD prevents files from being punched or printed on a real device by putting a USER HOLD status on the file. If you specify NOHOLD, you override the spool device HOLD option and prevent the file from being placed in HOLD status.
CPY *nnn
COPY nnn
specifies the number of file copies you want printed or punched when the file is produced. When the optional asterisk (*) is specified, the 3800 printer copies each page from the spooled output files nnn times before going on to the next page. If a file is not spooled to the 3800 printer, the function performed by specifying the asterisk (*) is ignored, and duplication occurs normally.
READY
NOTREADY
indicates whether the device is in a ready or not-ready status. The status can be changed by the READY and NOTREADY commands.
FORM userform
identifies the form associated with the device and assigned to the spool files as they are created.
TO userid
identifies the virtual machine that receives spool files created on the device.
RDR
PRT
PUN
identifies the spool file queue onto which spool files created on this device are placed. Unless changed by the SPOOL or CLOSE command, output normally goes to the PRT queue for a console spool file.
DIST distcode
identifies the distribution code for spool files created on this device.
FLASHC ccc
identifies the flash count for the file.
DEST dest
identifies the destination value to be assigned to each spool file created on the device. If the destination value has not been changed by a SPOOL command, the default is OFF.
FLASH name
identifies the forms overlay frame superimposed on the output pages if the file is printed on the 3800 printer.
CHAR char
identifies the name of the character set or sets used to generate output if the file is printed on the 3800 printer.
MDFY cmod
identifies the copy modification module used to alter output text if the file is printed on the 3800 printer.
n
identifies the copy modification character set number.
FCB fcb
identifies the forms control buffer used in the vertical formatting of a page if the file is printed on the 3800 printer.
LPP nnn
identifies the lines per page setting for the virtual printer where the console output will be generated. The value can be a decimal number in the range 30 to 255, or 'OFF', which indicates that internal defaults will be used.
3215
3270
identifies the virtual console device type. A 3270 device type is only supported if the user is logged on at a real 3270.
EOF
NOEOF
EOF closes, or NOEOF leaves open, the spool file on the specified device, regardless of the CONT setting for the device.
OPEN spoolid
CLOSED
indicates that a spool file (spoolid) has been created on the console and that the file is still open (OPEN), or indicates that no spool file is open on the device (CLOSED).
KEEP
NOKEEP
controls the KEEP status, which indicates whether the current spool file is to be placed in user HOLD after processing. For output files, the KEEP status is placed on the spool file. After it is transcribed at the real printer or punch, the file is assigned user HOLD status, and is not purged. The file's KEEP status is retained. Specify NOKEEP to override the current KEEP setting for the device so that KEEP is not set on the spool file.
MSG
NOMSG
indicates whether you want to be informed about file printing and punching. If you specify MSG, you are informed of file printing and punching. The message is sent to you when the file begins printing or punching on a real device. This message is not sent if you enter SET IMSG OFF. Specify NOMSG to reset the MSG option.
NAME fname ftype
NONAME
identifies the file name and file type, if any, to be assigned to spool files created on the device.
vsub
identifies the virtual subchannel number.

Messages

  • HCP003E Invalid option - option
  • HCP263E Too many operands were supplied for this command.
  • HCP1003E {CP module name|rdev|ldev} {is|was} not found.