QUERY ALLOC
Authorization
Privilege Class: D
Purpose
Use QUERY ALLOC to display the number of cylinders or pages that are allocated, in use, and available for DASD volumes attached to the system.
Operands
- ALL or *
- tells CP you want allocation information for all system volumes. This is the default.
- volid
- specifies one or more volume identifiers (volume IDs) for which you want information displayed. You can specify specific or generic volume IDs. To specify a generic volume ID, use the wildcard character (*) as the last character of a string. CP compares the string with the beginning of all volume IDs on the system and gives you information about all volume IDs whose first few characters match the string.
- DRCT
- specifies that you want specific detailed information, including extent start and end cylinders or pages, and cylinder or page allocation, displayed for the DRCT extents on the specified volumes.
- MAP
- specifies that you want specific detailed information, including extent start and end cylinders or pages, and cylinder or page allocation, displayed for all CP use extents on the specified volumes.
- PAGE
- specifies that you want specific detailed information, including extent start and end cylinders or pages, and page allocation, displayed for the PAGE extents on the specified volumes.
- SPOOL
- specifies that you want specific detailed information, including extent start and end cylinders or pages, and page allocation, displayed for the SPOOL extents on the specified volumes.
- TDISK
- specifies that you want specific detailed information, including extent start and end cylinders or pages, and cylinder or page allocation, displayed for the TDISK extents on the specified volumes.
Usage Notes
- For options PAGE, SPOOL, TDISK, and DRCT, if volid1 is not supplied, information is displayed for all CP-owned volumes that have space of that type allocated on them. For the MAP option, if volid1 is not supplied, information is displayed for all CP use extents on all CP-owned volumes that have any CP use extents.
- If QUERY ALLOC PAGE, QUERY ALLOC SPOOL, QUERY ALLOC TDISK, QUERY ALLOC DRCT, or QUERY ALLOC MAP commands are issued through DIAGNOSE code X'08' and the user requests the response returned in a buffer, complete volume information (volid and rdev) will be displayed for each extent displayed on the volume. This allows easier parsing of the command output by application execs or programs.
- Volids PAGE, SPOOL, TDISK, DRCT, MAP, and EXEC should be treated as restricted and should not be used for CP-owned volumes. If any of these volids are used, the corresponding new option will not be available. For example QUERY ALLOC PAGE will default to the QUERY ALLOC volid syntax if volid PAGE is defined to CP.
- Pattern wildcard characters (*) are allowed only as the last character of the volid.
- If space on a CP-owned volume is re-allocated while the volume is still attached to the system and a subsequent system IPL or the commands DETACH rdev FROM SYSTEM and ATTACH rdev TO SYSTEM do not occur, QUERY ALLOC may report incorrect information for that volume. This will occur until the system is IPLed or the device is DETACHed and re-ATTACHed to the system.
- The chnprg field of the Query Alloc response in combination with other device/control unit hardware information can be used to determine if performance problems may be occurring. Severe performance degradation may occur on a device to which CP issues CKD channel programs (because of the presence of filler records) if the device is attached to an ECKD-capable control unit by way of an ESCON or non-synchronous interface. The problem can be corrected by formatting the DASD using the NO FILLER option of ICKDSF.
Examples
QUERY ALLOC
displays cylinder or page
information about all system volumes. QUERY ALLOC ALL
displays cylinder or
page information about all system volumes. QUERY ALLOC VOL001
displays
cylinder or page information about a single system volume whose volid is
VOL001. QUERY ALLOC VOL001 DASD99
displays cylinder or page information
about two system volumes whose volids are VOL001 and DASD99.
QUERY ALLOC VOL*
displays cylinder or page information about all system
volumes whose volids begin with the three characters VOL.
QUERY ALLOC VOL* DASD*
displays cylinder or page information about all
system volumes whose volids begin with the three characters VOL or the
four characters DASD. QUERY ALLOC PAGE VOL001
displays detailed PAGE
extent information for a single system volume whose volid is VOL001.
QUERY ALLOC PAGE VOL001 DASD99
displays detailed PAGE extent information
for two system volumes whose volids are VOL001 and DASD99.Responses
Response 1:
DASD rdev volid type format{-chnprg} (UNITS IN units)
TDISK TOTAL=nnnnnnnnnnn INUSE=nnnnnnnnnnn AVAIL=nnnnnnnnnnn
PAGE TOTAL=nnnnnnnnnnn INUSE=nnnnnnnnnnn AVAIL=nnnnnnnnnnn
SPOOL TOTAL=nnnnnnnnnnn INUSE=nnnnnnnnnnn AVAIL=nnnnnnnnnnn <,DR>
DRCT TOTAL=nnnnnnnnnnn INUSE=nnnnnnnnnnn AVAIL=nnnnnnnnnnn <,ACTIVE>
<IPL NUCLEUS ACTIVE ON VOLUME volidn>
is displayed for each CP-owned volume.- rdev
- is the real device number of the CP-owned volume.
- volid
- is the volume identification of the CP-owned volume.
- type
- shows the DASD device type (for example, 3380).
- format
- identifies the type of device (CKD or FBA).
- <-chnprg>
- identifies the type of channel program that CP issues to the device (CKD or ECKD). This field is only displayed for CKD devices. The type of channel programs issued to a CKD device depends on the device type, the control unit to which it is attached, and if the device was formatted with filler records. CP will issue CKD channel programs to a 3380 attached to an ECKD capable control unit if it was formatted using the FILLER option of ICKDSF (filler records exist). CP will issue ECKD channel programs to the same device/control unit combination if it was formatted with the NO FILLER option of ICKDSF. For best performance, the type of channel programs that CP issues to the device should match the interface of the control unit to which it is attached. See the usage notes section for more details.
- units
- identifies the units of nnnnnnnnnn in the response for this volume. units is set to CYLINDERS for CKD devices and PAGES for FBA devices.
- nnnnnnnnnnn
- shows the number of cylinders or pages allocated in each category. For PAGE and SPOOL, when units is set to CYLINDERS, a cylinder is considered "in use" when at least one page in it is in use. Calculating a percentage used - (INUSE * 100) / (INUSE + AVAIL) - will therefore usually yield a larger and less accurate result than the percentage used shown in the following responses.
- <,ACTIVE>
- appears on the DRCT response line if that volume contains the currently active user directory.
- <,DR>
- appears on the TDISK, PAGE, or SPOOL response line if CP is currently not allocating space of that type on that volume.
- <IPL NUCLEUS ACTIVE ON VOLUME volid>
- appears as the final response line if the volume containing the active IPL nucleus was one of those for which cylinder or page allocation information was displayed.
EXTENT EXTENT TOTAL PAGES HIGH %
VOLID RDEV START END PAGES IN USE PAGE USED
----- ---- ---------- ---------- ------ ------ ------ ----
volid rdev nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% <DR>
nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% <DR>
nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% <DR>
volid rdev nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% DUMP <DR>
nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% DUMP <DR>
volid rdev - - - - - - SHARED
volid rdev - - 0 0 0 0% NOT FOUND
------ ------ ----
SUMMARY pppppp pppppp ppp%
usable pppppp pppppp ppp%
DRAINING pppppp pppppp ppp%
- is the response for QUERY ALLOC PAGE and QUERY ALLOC SPOOL.
- volid
- is the volume identification of the CP-owned volume.
- rdev
- is the real device number of the CP-owned volume.
- nnnnnn
- is the starting or ending cylinder or page number of the extent. For CKD volumes, this number is in cylinders. For FBA volumes, this number is in pages. The abbreviations K, M, G, T and P are used to indicate Kilo, Mega, Giga, Tera and Peta, for example, nnnnnK.
- pppppp
- is the total number of pages in the extent, the number of pages in use in the extent, or the highest page number in use in the extent. The abbreviations K, M, G, T and P are used to indicate Kilo, Mega, Giga, Tera and Peta, for example, pppppK.
- ppp
- is the percentage of pages in use in the extent.
- DUMP
- indicates that this SPOOL extent is reserved for DUMP use only.
- SHARED
- indicates the volume is owned by another system in the same SSI cluster. This system cannot
allocate or release space on the volume, but it can read spool data from areas previously allocated
and written to by the owning system. No allocation data can be displayed for this volume. Notes:
- The SHARED response line will be displayed only for QUERY ALLOC SPOOL or QUERY ALLOC MAP, unless that volume was specifically requested.
- A zero (0) will be displayed in the TOTAL, IN USE, HIGH, and % USED fields of this line.
- <DR>
- indicates the extent is draining. If DR is indicated, CP is currently not allocating space of that type on that volume. Draining applies only to TDISK, PAGE, and SPOOL space.
- NOT FOUND
- indicates that no CP-owned extents of the requested allocation type (PAGE or SPOOL) were found
on the specified volid. The volid is the
volid operand specified on the QUERY ALLOC command that was issued. It
can, therefore, be a wildcard volid specifier, in which case it indicates
that no CP-owned extents of the requested type were found on any volume with a
volid matching the wildcard volid specifier. In
this case, the rdev is displayed as *. Notes:
- Leading zeros are not displayed for nnnnnn, pppppp and ppp.
- Volid and rdev are only displayed for the first extent on the volume, unless the command was issued using DIAGNOSE code X'08' and the response was requested in the user's buffer. In this case volid and rdev are displayed on every response line.
- The summary response lines (including the footer line) are displayed only when information for all system volumes is displayed (the default ALL or * was specified as the only operand) and some space of the requested type was found. The SUMMARY line gives system-wide total, in-use, and percent in-use values, including both usable and draining space. The usable line gives system-wide total, in-use, and percent in-use values, excluding any space not generally usable for the specified type (either draining for the specified type, or for the type SPOOL, reserved for dump use only). The DRAINING line is displayed only if draining space of the specified type (that would otherwise be generally usable) was found. The DRAINING line gives system-wide total, in-use, and percent in-use values for all draining volumes that are draining for the specified type (and for type SPOOL, not reserved for dump use only).
Response 3:
EXTENT EXTENT %
VOLID RDEV START END TOTAL IN USE HIGH USED
----- ---- ---------- ---------- ------ ------ ------ ----
volid rdev nnnnnnnnnn nnnnnnnnnn nnnnnn nnnnnn nnnnnn ppp% <DR>
nnnnnnnnnn nnnnnnnnnn nnnnnn nnnnnn nnnnnn ppp% <DR>
volid rdev nnnnnnnnnn nnnnnnnnnn nnnnnn nnnnnn nnnnnn ppp% ACTIVE
volid rdev - - - - - - SHARED
volid rdev - - 0 0 0 0% NOT FOUND
------ ------ ----
SUMMARY <nnnnnn nnnnnn ppp% CKD>
<nnnnnn nnnnnn ppp% FBA>
usable <nnnnnn nnnnnn ppp% CKD>
<nnnnnn nnnnnn ppp% FBA>
DRAINING <nnnnnn nnnnnn ppp% CKD>
<nnnnnn nnnnnn ppp% FBA>
- is the response for QUERY ALLOC DRCT and QUERY ALLOC TDISK.
- volid
- is the volume identification of the CP-owned volume.
- rdev
- is the real device number of the CP-owned volume.
- nnnnnn
- is the starting or ending cylinder or page number of the extent, the total number of cylinders or pages in the extent, the number of cylinders or pages in use in the extent, or the highest cylinder or page number in use in the extent. For CKD volumes, this number is in cylinders. For FBA volumes, this number is in pages. The abbreviations K, M, G, T and P are used to indicate Kilo, Mega, Giga, Tera and Peta, for example, nnnnnK.
- ppp
- is the percentage of cylinders or pages in use in the extent.
- ACTIVE
- indicates this DRCT extent contains the currently active user directory.
- SHARED
- indicates the volume is owned by another system in the same SSI cluster. This system cannot
allocate or release space on the volume, but can read spool data from areas previously allocated and
written to by the owning system. No allocation data can be displayed for this volume. Notes:
- The SHARED response line will be displayed only for QUERY ALLOC SPOOL or QUERY ALLOC MAP, unless that volume was specifically requested.
- A zero (0) will be displayed in the TOTAL, IN USE, HIGH, and % USED fields of this line.
- <DR>
- indicates the extent is draining. If DR is indicated, CP is currently not allocating space of that type on that volume. Draining applies only to TDISK, PAGE, and SPOOL space.
- NOT FOUND
- indicates no CP-owned extents of the requested allocation type (TDISK or DRCT) were found on the
specified volid. The volid is the
volid operand specified on the QUERY ALLOC command that was issued. It
can, therefore, be a wildcard volid specifier, in which case it indicates
that no CP-owned extents of the requested type were found on any volume with a
volid matching the wildcard volid specifier. In
this case, the rdev is displayed as *. Notes:
- Leading zeros are not displayed for nnnnnn and ppp.
- Volid and rdev are only displayed for the first extent on the volume, unless the command was issued using DIAGNOSE code X'08' and the response was requested in the user's buffer. In this case, volid and rdev are displayed on every response line.
- The summary response lines (including the footer line) are displayed only when information for
all system volumes is displayed (the default ALL or * was specified as the only operand) and some
space of the requested type was found. The summary information gives system-wide total, in-use, and
percent in-use values. The summary information is divided into three sections: SUMMARY, usable, and
DRAINING. If DRCT was specified, only the SUMMARY section is displayed. If TDISK was specified, the
SUMMARY and usable sections are displayed. The DRAINING section is displayed only if draining TDISK
space was found. If DRCT was specified, the SUMMARY section gives system-wide total, in-use, and
percent in-use values.
If TDISK was specified,the SUMMARY section gives system-wide total, in-use, and percent in-use values (including both usable and draining TDISK space); the usable section gives system-wide total, in-use, and percent in-use values (excluding any space on volumes that are draining for TDISK); and the DRAINING section gives system-wide total, in-use, and percent in-use values for all draining volumes that are draining for TDISK.
The first line of each section is a summary of all CKD volumes, and the information is displayed in cylinders. The second line of each section is a summary of all FBA volumes and the information is displayed in pages. If no information was displayed for CKD volumes, then no CKD summary line is displayed; only the FBA summary line is displayed. If no information is displayed for FBA volumes, then no FBA summary line is displayed; only the CKD summary line is displayed.
EXTENT EXTENT % ALLOCATION
VOLID RDEV START END TOTAL IN USE HIGH USED TYPE
----- ---- ---------- ---------- ------ ------ ------ ---- -------------
volid rdev nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% PAGE <DR>
nnnnnnnnnn nnnnnnnnnn nnnnnn nnnnnn nnnnnn ppp% DRCT ACTIVE
nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% SPOOL <DR>
nnnnnnnnnn nnnnnnnnnn nnnnnn nnnnnn nnnnnn ppp% TDISK <DR>
nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% SPOOL <DR>
volid rdev nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% SPOOL DUMP <DR>
nnnnnnnnnn nnnnnnnnnn nnnnnn nnnnnn nnnnnn ppp% DRCT
nnnnnnnnnn nnnnnnnnnn pppppp pppppp pppppp ppp% SPOOL DUMP <DR>
volid rdev - - - - - - SHARED
volid rdev - - 0 0 0 0% NOT FOUND
- is the response for QUERY ALLOC MAP.
- volid
- is the volume identification of the CP-owned volume.
- rdev
- is the real device number of the CP-owned volume.
- nnnnnn
- is the starting or ending cylinder or page number of the extent, the total number of cylinders or pages in the extent, the number of cylinders or pages in use in the extent, or the highest cylinder or page number in use in the extent. For CKD volumes, this number is in cylinders. For FBA volumes, this number is in pages. The abbreviations K, M, G, T and P are used to indicate Kilo, Mega, Giga, Tera and Peta, for example, nnnnnK.
- pppppp
- is the total number of pages in the extent, the number of pages in use in the extent, or the highest page number in use in the extent. The abbreviations K, M, G, T and P are used to indicate Kilo, Mega, Giga, Tera and Peta, for example, pppppK.
- ppp
- is the percentage of pages (for all FBA response lines and for CKD PAGE and SPOOL response lines) or cylinders (for CKD DRCT and TDISK response lines) in use in the extent.
- PAGE
- indicates the extent is of CP-use allocation type PAGE.
- SPOOL
- indicates the extent is of CP-use allocation type SPOOL.
- DRCT
- indicates the extent is of CP-use allocation type DRCT.
- TDISK
- indicates the extent is of CP-use allocation type TDISK.
- DUMP
- indicates this SPOOL extent is reserved for DUMP use only.
- ACTIVE
- indicates this DRCT extent contains the currently active user directory.
- SHARED
- indicates the volume is owned by another system in the same SSI cluster. This system cannot
allocate or release space on the volume, but it can read spool data from areas previously allocated
and written to by the owning system. No allocation data can be displayed for this volume. Notes:
- The SHARED response line will be displayed only for QUERY ALLOC SPOOL or QUERY ALLOC MAP, unless that volume was specifically requested.
- A zero (0) will be displayed in the TOTAL, IN USE, HIGH, and % USED fields of this line.
- <DR>
- indicates the extent is draining. If DR is indicated, CP is currently not allocating space of that type on that volume. Draining applies only to TDISK, PAGE, and SPOOL space.
- NOT FOUND
- indicates no CP-owned extents (allocation type PAGE, SPOOL, TDISK, or DRCT) were found on the
specified volid. The volid is the
volid operand specified on the QUERY ALLOC command that was issued. It
can, therefore, be a wildcard volid specifier, in which case it indicates
that no CP-owned extents of the requested type were found on any volume with a
volid matching the wildcard volid specifier. In
this case, the rdev is displayed as *. Notes:
- Leading zeros are not displayed for nnnnnn, pppppp and ppp.
- Volid and rdev are only displayed for the first extent on the volume, unless the command was issued using DIAGNOSE code X'08', and the response was requested in the user's buffer. In this case, volid and rdev are displayed on every response line.
- Any volume extents not displayed by QUERY ALLOC MAP are allocated as PERM and PARM space.
Messages
- HCP013E Conflicting option - option
- HCP1002E Volume identifier volid does not exist.