Retrieve Disk Information (RTVDSKINF)

Where allowed to run:
  • Batch job (*BATCH)
  • Batch program (*BPGM)
  • Batch REXX procedure (*BREXX)
  • Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Retrieve Disk Information (RTVDSKINF) command is used to collect disk space information. The collected information is stored in a database file in library QUSRSYS. The file name depends on the auxiliary storage pool (ASP) device for which disk space information is retrieved. If the information was retrieved from the system and basic ASPs, the collected information will be stored in file QAEZDISK. If the information was retrieved from an independent ASP device, the collected information will be stored in file QAEZnnnnn, where 'nnnnn' is the ASP number of the independent ASP. The information will be stored in a data base file member named QCURRENT.

Each time this command is run, existing information in QCURRENT is written over. To save existing information in member QCURRENT, rename file QAEZDISK or QAEZDnnnnn, or copy the member to another file.

To get the most accurate results, this command should be run at a time when there is very little system activity.

Note: Do not rename member QCURRENT within file QAEZDISK or QAEZDnnnnn. If there is more than one member in QAEZDISK or QAEZDnnnnn, the results of running this command can be unpredictable.

Top

Parameters

Keyword Description Choices Notes
ASPDEV ASP device Name, *SYSBAS Optional, Positional 1
Top

ASP device (ASPDEV)

Specifies the auxiliary storage pool (ASP) device for which disk space information is to be retrieved.

*SYSBAS
Disk information for the system ASP and all basic ASPs is retrieved. The system ASP has an ASP number of 1. Basic ASPs have ASP numbers from 2 through 32.
name
Specify the name of the ASP device for which disk space information is to be retrieved. Independent ASP devices have ASP numbers greater than 32. You can submit multiple jobs, each performing RTVDSKINF on a different ASP device, to retrieve disk space information for multiple ASP devices in parallel.
Top

Examples

RTVDSKINF   ASPDEV(*SYSBAS)

This command retrieves disk space information for the system and basic auxiliary storage pools (ASPs), and stores it in member QCURRENT of database file QAEZDISK. Any information in member QCURRENT is overwritten.

Top

Error messages

*ESCAPE Messages

CPF1ED1
Not authorized to collect disk space information.
CPF1ED2
File &1 is in use and cannot be accessed.
CPF1E99
Unexpected error occurred.
Top