MODIFY PCIFUNCTION

Notes:

¹ The logical partition specified here must also appear in the ACCess_list.
² The maximum number of logical partition names you can specify depends on the capabilities of your machine.

Authorization

Privilege Class: B

Purpose

Use MODIFY PCIFUNCTION to modify a real PCI function in the I/O configuration.

Operands

rpfid: is the real function identifier of the PCI function you are modifying. The rpfid must be a 1- to 8-digit hexadecimal number between X'00000000' and X'7FFFFFFF'. The maximum value of the rpfid is model dependent and your machine likely supports a lower maximum value.
ADD_partition: tells CP that you want to add one or more logical partitions to the list of logical partitions that have access to this PCI function.
CONDITIONAL_DELete: tells CP that you want to delete one or more logical partitions from the list of logical partitions that have access to this PCI function, but only if the PCI function is not presently configured to any logical partition in the I/O configuration.
DELete_partition: tells CP that you want to delete one or more logical partitions from the list of logical partitions that have access to this PCI function regardless of whether the PCI function is presently configured to any logical partition in the I/O configuration.
ACCess_list pname: specifies the name(s) of the logical partition(s) for which access to this PCI function is being added or deleted. The maximum number of logical partition names you can specify depends on the capabilities of your machine. Each pname must be a 1- to 8-digit character alphanumeric string.
INITial_access pname: specifies the name of the logical partition that will have initial access to this PCI function.
Note: When a logical partition is specified with the INITial_access parameter, it must also be specified as part of the ACCess_list.

Usage Notes

After successfully entering this command, you will have changed the software's view of the I/O configuration and part of the hardware's view: the active I/O configuration in the hardware system area (HSA). You should also change the other part of the hardware's view: the active I/O configuration data set (IOCDS) file on the support element (SE) hard disk.
To change the IOCDS file on the SE hard disk, you must:
1. Update the IOCP source file.
2. Run the IOCP utility against the updated IOCP file. If the IOCP utility runs without errors, it downloads the new IOCDS file to the SE hard disk.
3. Issue the SET IOCDS_ACTIVE command to make the new IOCDS file the active file that the processor will use during the next power-on reset (POR).
For more information about changing real PCI functions in your I/O configuration, see z/VM: I/O Configuration.
To define a PCI function to the system, use the DEFINE PCIFUNCTION command.
To delete an existing PCI function on the system, use the DELETE PCIFUNCTION command.
To display the status of one or more real PCI functions, use the QUERY PCIFUNCTION command.

Responses

Response 1:

To add access to a PCI function for two partitions, enter the following:

modify pcif 43 add init vm6 acc vm6 vm9
PCI function configuration change completed successfully
Ready;

Response 2:

To delete access from a PCI function for two partitions, enter the following:

modify pcif 43 del acc vm3 vm5
PCI function configuration change completed successfully
Ready;

Messages

HCP864E Partition pname not found
HCP1006E Command processing cannot complete because the system does not support the Dynamic-I/O-for-I/O-adapters facility.
HCP6805E Cannot find RDEV for TYPE 1 subchannel
HCP6806E Dynamic I/O change request for PCI function failed with return code nnnn
HCP6809E This processor does not support dynamic I/O changes
HCP6815E Command failed in the channel subsystem
HCP6818E Modify command failed. PCI function rpfid is not offline.
HCP6819E A dynamic I/O command is currently executing for user userid