VARY PCIFUNCTION
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