QUERY VIRTUAL LINES

Read syntax diagramSkip visual syntax diagram Query Virtual1 LInes EXTended
Notes:
  • 1 This operand is required for privilege class G users who also have privilege class B.

Authorization

Privilege Class: G

Purpose

Use QUERY VIRTUAL LINES to display the status of all of your virtual communications lines.

Usage Notes

  1. The QUERY LINES, QUERY LINKS, and QUERY VIRTUAL LINES commands share the two possible abbreviations LI and LIN. 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 of Q LI specify Q 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.