QUERY VIRTUAL LINES
Authorization
Privilege Class: G
Purpose
Use QUERY VIRTUAL LINES to display the status of all of your virtual communications lines.
Usage Notes
- The QUERY LINES, QUERY LINKS, and QUERY VIRTUAL LINES commands share the two possible
abbreviations
LI
andLIN
. If you are authorized to issue these commands, we recommend that you specify at least 4 character abbreviations of the LINES or LINKS operand to ensure that you invoke the intended command. For example, instead ofQ LI
specifyQ LINE
.
Responses
Response 1:
LINE vdev {ON LINE rdev} [SUBCHANNEL = vsub]
{ENABLED }
{DISABLED }
is returned for each of your communications lines.- vdev
- identifies the virtual device number of the communication line.
- ON LINE rdev
- shows the real (rdev) device dialed into, or attached to, this virtual machine.
- ENABLED
- shows the status of a virtual communication line that is enabled.
- DISABLED
- shows the status of a virtual communication line that is disabled.
- vsub
- identifies the virtual subchannel number.
Response 2:
CONS vdev {ON LINE rdev } [SUBCHANNEL = vsub]
{ON GRAF rdev }
{ON LDEV ldev }
{ON [netname.]luname VSM userid}
{ON SYSC }
{DISCONNECTED }
is returned for your virtual console if your virtual console is conmode 3215.- vdev
- identifies the virtual device number of the communication line.
- ON LINE rdev
- ON GRAF rdev
- ON LDEV ldev
- shows the real (rdev) or logical (ldev) device that is logged onto this virtual machine.
- ON [netname.]luname
- identifies an SNA/CCS terminal (controlled by the VTAM® service machine) that is logged onto this virtual machine. It is the name taken 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.
- VSM userid
- identifies the user ID of the VTAM service machine managing the device.
- ON SYSC
- identifies the system console as the real device that is logged onto this virtual machine.
- DISCONNECTED
- indicates that the real device is disconnected.
- vsub
- identifies the virtual subchannel number. This value is displayed only if the real device that is logged onto this virtual machine is other than the system console.
Messages
- HCP003E Invalid option - option
- HCP040E Device {rdev|vdev|ldev} does not exist
- HCP263E Too many operands were supplied for this command.