Troubleshooting
Problem
This document provides an overview of the GO DISKTASKS menu interface.
Resolving The Problem
The Disk Space Tasks menu (GO DISKTASKS) provides the option for collecting disk space information to help show how storage is being used on your system. After collecting the information, you can specify what information to include in a report and then print the report.
After you have collected the disk space information and have determined where you are using unnecessary space, you can use the available options to work with the libraries, folders, or objects.
For information about how to reduce the amount of storage used, refer to IBM technote N1019466 Reducing System ASP Disk Space / Storage Used
Note: You must have a user class of *SECOFR to see all options.
Available Options
Option 1 - Collect Disk Space Information
Select this option to schedule when to submit the job that collects information about the disk space. You can collect the information on a specific day and time, weekly, or monthly. If possible, this collection should be scheduled at a time when the system is least busy due to the function capturing information on all inactive objects.
Note: The Collect Disk Space Information option on the DISKTASKS menu does not have an option to collect data for an Independent Auxiliary Storage Pool (IASP). The recommended way to collect data for an IASP is by using the RTVDSKINF command and specify the IASP device name on the ASPDEV parameter, which can either be submitted to batch or scheduled to run using either the IBM i job scheduler, or the Advanced Job Scheduler. Alternatively, you can get the Collect Disk Space Information option on the DISKTASKS menu to collect IASP data by changing the default value for the ASPDEV parameter on the RTVDSKINF command before starting the collection. Here is the command to change the default to collect data for IASP nnnnnnn - QSYS/CHGCMDDFT CMD(RTVDSKINF) NEWDFT('ASPDEV(nnnnnnn)'). After collecting data for the IASP, if you then wish to collect data for *SYSBAS, you will need to change the default parameter back using QSYS/CHGCMDDFT CMD(RTVDSKINF) NEWDFT('ASPDEV(*SYSBAS)').
Option 2 - Print Disk Space Information
After collecting the disk space information, you can select this option to print the information. You can specify the type of information to include in the report, such as the following:
Notes:
1. If printing IASP information, the recommended method is to use PRTDSKINF RPTTYPE(*LIB) ASPDEV(nnnnnnn). Alternatively, if you want to use the Print Disk Space Information option of the DISKTASKS menu, you can either rename the QUSRSYS/QAEZDISK file to a temporary name, or delete it, and then rename the file QUSRSYS/QAEZDnnnnnnn to QUSRSYS/QAEZDISK. If you wish to switch back to *SYSBAS, you will need to rename the files back the way they were.
2. If these options are not listed with the GO DISKTASKS command, your user profile does not have the proper authority to run them. Either sign on with QSECOFR, or modify your user profile via the CHGUSRPRF command. The user profile is required to have a *SECOFR user class. To use the options, the user must have *ALLOBJ special authority to use Option. 1 and must have *USE authority to both the PRTDSKINF command and the QUSRSYS/QAEZDISK file to use Option 2.
3. Approximately 3% available space is suggested to generate the output, though more space can be required. The report will show the allocation of disk space across the system. The collection can take up to several hours.
4. Prior to running GO DISKTASKS option 1 to Collect disk space information, make sure your user profile exists in OS/400 System Distribution Directory Entry. Use the Work with Directory Entries (WRKDIRE) command to add the necessary user profile or display entries. Otherwise, it does not retrieve all information on system objects before ending, and GO DISKTASKS option 2 to Print disk space information does not have what it needs to produce output for the Specific object information portion of the report.
It is also suggested not to run the disk space collection when the system is experiencing a heavy workload. The job cannot collect object information on objects in use and locks the objects while collecting information on them, which leads to file contention situations (locking and seize issues). Running the collection during off-peak times is suggested.
To gather the data, on an operating system command line, type the following:
GO DISKTASKS
Press the Enter key. Select Option 1 to Collect disk space information. Press the Enter key.
Specify 1=Date/Time and press the Enter key.
Date . . . . . . . . . . . . . . . . . . *CURRENT
Time . . . . . . . . . . . . . . . . . . *CURRENT
Press the Enter key. (Note the message, Data collection schedule successfully changed.)
To verify the job is active, on an operating system command line, type the following:
WRKACTJOB SBS(QSYSWRK)
Press the Enter key. Find the CMD-RTVDSKINF job:
Opt Subsystem/Job User Type CPU % Function Status
__ QEZDKSPDT AJMAC BCH 1.5 CMD-RTVDSKINF RUN
To print the report after the DISKTASKS job completes, on an operating system command line, type the following:
GO DISKTASKS
Press the Enter key. Select Option 2, Print disk space information, and press the Enter key. Select Option 1 next to System summary information to initiate.
Sample Report
Disk Space Report
5722SS1 V6R1M0 060210 10/11/10 11:26:27 CDT
System Information
Information collected . . . . . . . . . : 07/15/10 10:27:26 Machine type-model . . . . . . . . . . . : 9406-520
System serial number . . . . . . . . . . : 10-xxxxx
Total disk space on system in 1,000,000
bytes . . . . . . . . . . . . . . . . : 105495 Customize options specified for this report:
Main storage size in megabytes . . . . . : 944 Report type . . . . . . . . . . . . . : *SYS
Asp device . . . . . . . . . . . . . . : *SYSBAS
% of Size in
Description Disk 1,000,000 bytes
User libraries 8.36 8822.13
User directories 52.66 55553.78
Folders and documents .00 1.38
QSYS 2.50 2637.00
Other IBM libraries 6.25 6595.77
Licensed Internal Code 3.11 3279.50
Temporary space 1.66 1748.75
Unused space 23.89 25201.58
System internal objects .37 393.53
Objects not in a library .00 .00
TOTAL 98.80 104233.42
Disk Space Report
5722SS1 V6R1M0 060210
System Information*
% of Size in
Description Disk 1,000,000 bytes
Server items reported:
History files .00 1.45
Journal receivers .08 80.52
User profiles .03 35.77
Configuration information .00 1.31
System help (QHLPSYS) .04 42.02
Calendars .00 1.83
System directories .00 3.13
Document files .00 2.28
OfficeVision items reported:
Enrollment .00 .00
Mail files .00 .00
Text search .00 .00
Personal directories .00 .00
Licensed Internal Code:
LIC and tables 2.92 3077.40
Dump space .00 4.19
Error logs .00 4.83
Trace tables .00 .00
VLIC logs .18 188.75
VLIC control blocks .00 4.33
Disk Space Report
5722SS1 V6R1M0 060210
System Information*
% of Size in
Description Disk 1,000,000 bytes
Space used by system internal objects:
Additional configuration information .00 .11
Communications .01 7.20
Data base .04 37.33
Manage jobs .24 253.97
Monitor performance .00 .00
Folders .00 .11
Mail .00 .00
iSeries .01 8.71
S/36 Environment .00 .11
Security .00 2.51
SNADS and object distribution .00 .52
Spool .07 76.32
Cross component .00 4.67
Product installation .00 .11
Recovery of information .00 .42
Obsolete .00 .00
Internal system journals .00 .00
Miscellaneous items reported:
Printer output & Spooling (QSPL) .71 750.32
Replaced object library (QRPLOBJ) .00 1.83
Storage affected by RCLSTG .00 .00
Reclaim storage library (QRCL) .00 .08
* * * * * E N D O F L I S T I N G * * * * *
After you have collected the disk space information and have determined where you are using unnecessary space, you can use the available options to work with the libraries, folders, or objects.
For information about how to reduce the amount of storage used, refer to IBM technote N1019466 Reducing System ASP Disk Space / Storage Used
Note: You must have a user class of *SECOFR to see all options.
Available Options
Option 1 - Collect Disk Space Information
Select this option to schedule when to submit the job that collects information about the disk space. You can collect the information on a specific day and time, weekly, or monthly. If possible, this collection should be scheduled at a time when the system is least busy due to the function capturing information on all inactive objects.
Note: The Collect Disk Space Information option on the DISKTASKS menu does not have an option to collect data for an Independent Auxiliary Storage Pool (IASP). The recommended way to collect data for an IASP is by using the RTVDSKINF command and specify the IASP device name on the ASPDEV parameter, which can either be submitted to batch or scheduled to run using either the IBM i job scheduler, or the Advanced Job Scheduler. Alternatively, you can get the Collect Disk Space Information option on the DISKTASKS menu to collect IASP data by changing the default value for the ASPDEV parameter on the RTVDSKINF command before starting the collection. Here is the command to change the default to collect data for IASP nnnnnnn - QSYS/CHGCMDDFT CMD(RTVDSKINF) NEWDFT('ASPDEV(nnnnnnn)'). After collecting data for the IASP, if you then wish to collect data for *SYSBAS, you will need to change the default parameter back using QSYS/CHGCMDDFT CMD(RTVDSKINF) NEWDFT('ASPDEV(*SYSBAS)').
Option 2 - Print Disk Space Information
After collecting the disk space information, you can select this option to print the information. You can specify the type of information to include in the report, such as the following:
o | Library |
o | Folder |
o | Owner |
o | Specific object |
o | System summary |
1. If printing IASP information, the recommended method is to use PRTDSKINF RPTTYPE(*LIB) ASPDEV(nnnnnnn). Alternatively, if you want to use the Print Disk Space Information option of the DISKTASKS menu, you can either rename the QUSRSYS/QAEZDISK file to a temporary name, or delete it, and then rename the file QUSRSYS/QAEZDnnnnnnn to QUSRSYS/QAEZDISK. If you wish to switch back to *SYSBAS, you will need to rename the files back the way they were.
2. If these options are not listed with the GO DISKTASKS command, your user profile does not have the proper authority to run them. Either sign on with QSECOFR, or modify your user profile via the CHGUSRPRF command. The user profile is required to have a *SECOFR user class. To use the options, the user must have *ALLOBJ special authority to use Option. 1 and must have *USE authority to both the PRTDSKINF command and the QUSRSYS/QAEZDISK file to use Option 2.
3. Approximately 3% available space is suggested to generate the output, though more space can be required. The report will show the allocation of disk space across the system. The collection can take up to several hours.
4. Prior to running GO DISKTASKS option 1 to Collect disk space information, make sure your user profile exists in OS/400 System Distribution Directory Entry. Use the Work with Directory Entries (WRKDIRE) command to add the necessary user profile or display entries. Otherwise, it does not retrieve all information on system objects before ending, and GO DISKTASKS option 2 to Print disk space information does not have what it needs to produce output for the Specific object information portion of the report.
It is also suggested not to run the disk space collection when the system is experiencing a heavy workload. The job cannot collect object information on objects in use and locks the objects while collecting information on them, which leads to file contention situations (locking and seize issues). Running the collection during off-peak times is suggested.
To gather the data, on an operating system command line, type the following:
GO DISKTASKS
Press the Enter key. Select Option 1 to Collect disk space information. Press the Enter key.
Specify 1=Date/Time and press the Enter key.
Date . . . . . . . . . . . . . . . . . . *CURRENT
Time . . . . . . . . . . . . . . . . . . *CURRENT
Press the Enter key. (Note the message, Data collection schedule successfully changed.)
To verify the job is active, on an operating system command line, type the following:
WRKACTJOB SBS(QSYSWRK)
Press the Enter key. Find the CMD-RTVDSKINF job:
Opt Subsystem/Job User Type CPU % Function Status
__ QEZDKSPDT AJMAC BCH 1.5 CMD-RTVDSKINF RUN
To print the report after the DISKTASKS job completes, on an operating system command line, type the following:
GO DISKTASKS
Press the Enter key. Select Option 2, Print disk space information, and press the Enter key. Select Option 1 next to System summary information to initiate.
Sample Report
Disk Space Report
5722SS1 V6R1M0 060210 10/11/10 11:26:27 CDT
System Information
Information collected . . . . . . . . . : 07/15/10 10:27:26 Machine type-model . . . . . . . . . . . : 9406-520
System serial number . . . . . . . . . . : 10-xxxxx
Total disk space on system in 1,000,000
bytes . . . . . . . . . . . . . . . . : 105495 Customize options specified for this report:
Main storage size in megabytes . . . . . : 944 Report type . . . . . . . . . . . . . : *SYS
Asp device . . . . . . . . . . . . . . : *SYSBAS
% of Size in
Description Disk 1,000,000 bytes
User libraries 8.36 8822.13
User directories 52.66 55553.78
Folders and documents .00 1.38
QSYS 2.50 2637.00
Other IBM libraries 6.25 6595.77
Licensed Internal Code 3.11 3279.50
Temporary space 1.66 1748.75
Unused space 23.89 25201.58
System internal objects .37 393.53
Objects not in a library .00 .00
TOTAL 98.80 104233.42
Disk Space Report
5722SS1 V6R1M0 060210
System Information*
% of Size in
Description Disk 1,000,000 bytes
Server items reported:
History files .00 1.45
Journal receivers .08 80.52
User profiles .03 35.77
Configuration information .00 1.31
System help (QHLPSYS) .04 42.02
Calendars .00 1.83
System directories .00 3.13
Document files .00 2.28
OfficeVision items reported:
Enrollment .00 .00
Mail files .00 .00
Text search .00 .00
Personal directories .00 .00
Licensed Internal Code:
LIC and tables 2.92 3077.40
Dump space .00 4.19
Error logs .00 4.83
Trace tables .00 .00
VLIC logs .18 188.75
VLIC control blocks .00 4.33
Disk Space Report
5722SS1 V6R1M0 060210
System Information*
% of Size in
Description Disk 1,000,000 bytes
Space used by system internal objects:
Additional configuration information .00 .11
Communications .01 7.20
Data base .04 37.33
Manage jobs .24 253.97
Monitor performance .00 .00
Folders .00 .11
Mail .00 .00
iSeries .01 8.71
S/36 Environment .00 .11
Security .00 2.51
SNADS and object distribution .00 .52
Spool .07 76.32
Cross component .00 4.67
Product installation .00 .11
Recovery of information .00 .42
Obsolete .00 .00
Internal system journals .00 .00
Miscellaneous items reported:
Printer output & Spooling (QSPL) .71 750.32
Replaced object library (QRPLOBJ) .00 1.83
Storage affected by RCLSTG .00 .00
Reclaim storage library (QRCL) .00 .08
* * * * * E N D O F L I S T I N G * * * * *
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000C4BAAU","label":"IBM i"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0;7.4.0;7.5.0"}]
Historical Number
23380156
Was this topic helpful?
Document Information
More support for:
IBM i
Component:
IBM i
Software version:
7.3.0, 7.4.0, 7.5.0
Operating system(s):
IBM i
Document number:
644435
Modified date:
09 October 2024
UID
nas8N1019469
Manage My Notification Subscriptions