QUERY VIRTUAL PCIFUNCTION

Read syntax diagramSkip visual syntax diagram Query Virtual1 PCIFunction ALLvpfidvpfid1-vfpif2
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 PCIFUNCTION to display the status of PCI functions accessible to your virtual machine.

Operands

ALL
specifies all virtual PCI functions accessible to your virtual machine
vpfid
vpfid1-vpfid
specifies a virtual PCI function ID or a range of virtual PCI function IDs whose status is to be queried. Specify a PCI function ID as 8 hexadecimal digits. You may omit leading zeros. The total number of virtual PCI functions specified cannot exceed 256.

Responses

Response 1:

If you enter QUERY VIRTUAL PCIFUNCTION, you will see something like:
PCIF 00000003 ON 00000021 ENABLED  10GbE RoCE
PCIF 00000004 ON 00000046 DISABLED 10GbE RoCE
PCIF 00000005 ON 00000058 ENABLED  10GbE RoCE
PCIF 00000006 ON 00000024 ERROR    10GbE RoCE
The first number is the virtual PCI function ID. The next number is the real PCI function ID followed by the state of the PCI function and the type of PCI function.
The state of the function is one of the following:
BLOCKED
PCI function blocked
DISABLED
PCI function available for use by the configuration but not enabled
ENABLED
PCI function available for use by the configuration and enabled
ERROR
Error detected by z/PCI facility
PERMERR
Error recovery for PCI function unsuccessful

Messages

  • HCP002E Invalid operand - operand
  • HCP009E Invalid range - range
  • HCP022E A virtual PCI function ID was not supplied or it was invalid.
  • HCP040E PCI function vpfid does not exist
  • HCP1003E vpfid not found.
  • HCP5780E Adjunct does not support the command subcommand command
  • HCP6000E The range of PCI function ids cannot exceed 256.