QUERY IO_OPT

Read syntax diagramSkip visual syntax diagram Query IO_OPT1 FOR*FOR*USERuserid2
Notes:
  • 1 If QUERY IO_OPT is executed with the AT command, the userid operand is required.
  • 2 Only Class B users can specify this operand.

Authorization

Privilege Class: B, G

Purpose

Use QUERY IO_OPT to determine the current status of all I/O options for a virtual machine. The setting for I/O options are controlled by the SET IO_OPT command.

Operands

USER userid
*
specifies an individual user for which the I/O options status is to be reported.

An asterisk (*), which is the default, specifies the virtual machine (user ID) from which the command is issued.

If QUERY IO_OPT is executed with the AT command, userid operand is required.

Usage Notes

  1. When the setting for all users is OFF, that virtual machine I/O option is disabled for all virtual machines, including any new users that may logon, regardless of the individual setting.

    When the setting for all users is ON, then the individual user setting determines whether I/O options are enabled or disabled for the requested user ID.

  2. The default setting for the UID I/O option is to be set ON for all users and each virtual machine. When this option is ON for a virtual machine, two real PCI functions with the same UID value cannot be attached to the same virtual machine.
  3. The default setting for the ENFORCE_BY_VOLID I/O option is determined by the ENFORCE_BY_VOLid configuration statement. When this option is ON, CP enforces attachment of DASD devices by their VOLIDs.

Responses

Response 1:

If you enter QUERY IO_OPT with an userid or *, you will see something like:
ALL USERS SET IO_OPT UID – {OFF}
                           {ON}
        ENFORCE_BY_VOLID – {OFF}
                           {ON)

OPTION SETTINGS FOR {userid}:

OPTION SETTING
UID    {ON}   
       {OFF}
The first section of the response displays the setting for all I/O options for all users. The second section of the response displays the settings for all I/O options for the virtual machine specified.
OPTION
displays the I/O options which are set to be enabled/disabled.
SETTING
displays the individual user setting.

Messages

  • HCP002E Invalid operand - operand
  • HCP007E Invalid userid - userid
  • HCP020E Userid missing or invalid
  • HCP045E userid not logged on
  • HCP263E Too many operands were supplied for this command