QUERY IOPRIORITY

Read syntax diagramSkip visual syntax diagram Query IOPRIORity userid*SYSTEM

Authorization

Privilege Class: A, E

Purpose

Use QUERY IOPRIORITY to display a user's I/O priority settings or the I/O priority range available to CP.

Operands

userid
*
specifies the user identification of the virtual machine whose I/O priority range is to be displayed. You can specify an asterisk (*) to display information about your own virtual machine.
SYSTEM
notifies CP to display information about the I/O priority range available to CP.

Usage Notes

  1. The initial I/O priority settings for a user can be specified by the IOPRIORITY statement in the user's directory entry. If an IOPRIORITY statement is not found and LPAR I/O Priority Facility is enabled, LOGON processing requests RELATIVE I/O priority range with a low value of 0 and a high value of 0. The user's effective range is computed based on the I/O priority range available to CP.
  2. The I/O priority settings of a user can be changed by the SET IOPRIORITY command. For more information about this command, see SET IOPRIORITY.

Responses

Response 1:

The following is the response to QUERY IOPRIORITY SYSTEM:
LPAR I/O Priority Facility is not installed. Simulated range is 0 to 255
indicates that the LPAR I/O Priority Facility is not installed, but CP is simulating a range from 0 to 255.
LPAR I/O Priority Facility is not enabled
indicates that the LPAR I/O Priority Facility is installed but not enabled for your local partition (LPAR). CP is simulating a range from 0 to 255.
LPAR I/O Priority Facility is enabled. Range is nnn to mmm
indicates that the LPAR I/O Priority Facility is installed and enabled for your local partition (LPAR). nnn is the lowest I/O priority available to your logical partition and mmm is the highest.

Response 2:

One of the following is the response to QUERY IOPRIORITY userid:

userid   REQUESTED RANGE nnn mmm ABSOLUTE
         EFFECTIVE RANGE xxx yyy- 
or
userid   REQUESTED RANGE nnn mmm RELATIVE
         EFFECTIVE RANGE xxx yyy 
userid
is the user ID whose I/O priority settings are being displayed.
REQUESTED RANGE nnn mmm
indicates the low and high values of the I/O priority range requested for this user.
ABSOLUTE
RELATIVE
indicates the type of range that was requested for this user.
EFFECTIVE RANGE xxx to yyy
indicates the low and high values of the I/O priority range that CP will allow this user to use.

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - command contains extra option(s) starting with option}
  • HCP020E Userid missing or invalid
  • HCP045E userid not logged on