Use the z/VM® CP ATTACH command to make PCI functions available to z/VM guests.
Before you begin
The PCI function must be configured in the partition in which the z/VM hypervisor runs, see Online and configuration state.
The z/VM system must be configured to support PCI functions. For more information, see the section about PCIe functions in z/VM: CP Planning and
Administration, SC24-6271.
Live-guest migration of a z/VM guest within a z/VM single system image (SSI) is not possible if the z/VM virtual machine has a directly attached PCI function.
About this task
The steps that follow describe z/VM CP commands as issued from a CMS session in a z/VM guest virtual machine. Using the vmcp command, you can issue these CP commands from a Linux instance that runs as a guest in that z/VM guest virtual machine.
Procedure
- Optional:
Confirm that the PCI function to be attached to the z/VM guest is available to your z/VM system.
From a
z/VM user ID with administrator privileges, issue:
#CP QUERY PCIFUNCTION
The output lines begin with PCIF followed by the FID of the
PCI function in hexadecimal notation.
-
Attach the PCI function by issuing a CP ATTACH command of this form:
#CP ATTACH PCIFUNCTION <fid> TO <zvm_userid>
Where:
- <fid>
- is the function ID of the PCI function as used in the hardware configuration and as shown by the CP QUERY command.
- <zvm_userid>
- is the z/VM user ID of the z/VM guest virtual machine.
You can map the FID in the partition to an FID of your choice in the z/VM guest virtual machine. To map to a different FID, append the CP command with TO <vm_fid> to use <vm_fid> within the guest.
Example:
#CP ATTACH PCIFUNCTION 8CA TO P3VM5LZ1
What to do next
For more information about managing PCI functions on z/VM, see z/VM: CP Commands and
Utilities Reference, SC24-6268.