QUERY IOPRIORITY
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
- 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.
- 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