VARY PCIFUNCTION

Read syntax diagramSkip visual syntax diagram VARY ONlineOFFline PCIFunction rpfidrpfid1-rpfid2

Authorization

Privilege Class: B

Purpose

Use VARY PCIFUNCTION to configure or deconfigure a PCI function.

Operands

ONline
configures a PCI function.
OFFline
deconfigures a PCI function.
PCIFunction
used for specifying PCI function(s).
rpfid
rpfid1-rpfid2
specifies a real PCI function ID or a range of PCI function IDs that are to be enabled or disabled for the user. Specify a PCI function ID as a 1- to 8-digit hexadecimal number between X'00000000' and X'7FFFFFFF'. The total number of PCI functions specified cannot exceed 256.

Responses

Response 1:

rpfid varied {online }
             {offline}
indicates that the specified real PCI function ID is now online or offline.

Response 2:

rpfid already {online }
              {offline}
indicates that the specified real PCI function ID is already online or offline.

Response 3:

nnn PCI function(s) specified; nnn PCI function(s) successfully varied {online }
                                                                       {offline}
is a summary response indicating how many PCI functions were successfully varied online or offline.

Response 4:

PCI function rpfid not varied online; PCI function could not be configured.
indicates that the PCI function specified to be varied online could not be configured.

Response 5:

PCI function rpfid not varied offline; PCI function could not be 
   deconfigured.
indicates that the PCI function specified to be varied offline could not be deconfigured.

Messages

  • HCP002E Invalid operand - operand
  • HCP009E Invalid range - range
  • HCP021E A real PCI function ID was not supplied or it is invalid.
  • HCP040E PCI function {rpfid} does not exist
  • HCP040E PCI function {rpfid} attached to userid.
  • HCP1163I PCI function rpfid cannot be allowed online because PCI support is not enabled for the system.
  • HCP1163I PCI function rpfid initialization has failed; return code rc, response code respcode.
  • HCP1167E PCI function rpfid cannot be brought online because it is of an unknown type.
  • HCP6000E The range of PCI function IDs cannot exceed 256.
  • HCP6790I VARY processing halted. The next function that would have been processed is rpfid