QUERY VIRTUAL PCIFUNCTION
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.