QUERY ALLOC

Read syntax diagramSkip visual syntax diagram Query ALLOC ALL1*volidDRCTMAPPAGESPOOLTDISKALL*volid
Notes:
  • 1 The operands ALL and * have the same function of requesting CP allocation information for all system volumes.

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

  1. 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.
  2. 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.
  3. 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.
  4. Pattern wildcard characters (*) are allowed only as the last character of the volid.
  5. 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.
  6. 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

Examples of QUERY ALLOC commands:
   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.
Response 2:
                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:
  1. The SHARED response line will be displayed only for QUERY ALLOC SPOOL or QUERY ALLOC MAP, unless that volume was specifically requested.
  2. 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:
  1. Leading zeros are not displayed for nnnnnn, pppppp and ppp.
  2. 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.
  3. 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:
  1. The SHARED response line will be displayed only for QUERY ALLOC SPOOL or QUERY ALLOC MAP, unless that volume was specifically requested.
  2. 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:
  1. Leading zeros are not displayed for nnnnnn and ppp.
  2. 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.
  3. 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.

Response 4:
                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:
  1. The SHARED response line will be displayed only for QUERY ALLOC SPOOL or QUERY ALLOC MAP, unless that volume was specifically requested.
  2. 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:
  1. Leading zeros are not displayed for nnnnnn, pppppp and ppp.
  2. 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.
  3. 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.