LOCATE VPCI

Read syntax diagramSkip visual syntax diagram LOCate VPCI userid*vpfidvpfid1-vpfid2

Authorization

Privilege Class: C, E

Purpose

Use LOCATE VPCI to display the address of a user's virtual PCI function block and its associated control blocks.

Operands

userid
*
identifies the virtual machine to which the function or functions are currently attached. The specified user must be logged onto the system. If you are locating a VPCI for your own virtual machine, you may specify your user ID as an asterisk (*).
vpfid
vpfid1-vpfid2
specifies a virtual PCI function ID or a range of PCI function IDs whose control block addresses are to be displayed. Specify a PCI function ID as 8 hexadecimal digits. You may omit leading zeros. The total number of PCI functions specified cannot exceed 256.

Responses

Response 1:

PCIF     VPCI     RPCI
nnnnnnnn nnnnnnnn nnnnnnnn
Where:
PCIF
shows the virtual PCI function ID
VPCI
shows the host logical storage address of the corresponding virtual PCI block.
RPCI
shows the real PCI function block address of the real PCI function associated with this virtual PCI function.

Examples

Example 1:

If you enter a LOCATE VPCI * 17 command, you may see something like this: 
PCIF     VPCI     RPCI
00000017 012E8708 02E36288

Messages

  • HCP002E Invalid operand - operand
  • HCP009E Invalid range - range
  • HCP020E Userid missing or invalid
  • HCP022E A virtual PCI function ID was not supplied or it was invalid.
  • HCP045E userid not logged on
  • HCP5780E Adjunct does not support the command subcommand command
  • HCP6000E The range of PCI function ids cannot exceed 256.
  • HCP6720I No items found to satisfy selection criteria