Use the IDCAMS LISTDATA command to display information about a TSE-VOL or a pool in the storage system. The only pool information displayed is for Dynamic Provisioning for Mainframe.
The following table shows the LISTDATA command parameters for viewing information about a TSE-VOL or pool. For more information about this command, see the IBM® z/OS® DFSMS Access Method Services Commands.
|
Parameter 1 |
Parameter 2 |
Description |
|---|---|---|
|
SPACEEFFICIENTVOL |
DEVICE |
Displays information about the space-efficient device specified by the command (for example, the TSE-VOL). |
|
SUBSYSTEM |
Displays information about all space-efficient devices in the storage system specified by the command. |
|
|
ALL |
Displays information about all space-efficient devices in all connected storage systems. ALL is selected by default when the range is not specified. |
|
|
EXTENTPOOLCONFIG |
SUMMARY |
Displays summary information for all pools. |
|
EXTENTPOOLID (ID) |
Displays detailed information about the specified pool. |
|
|
MAPVOLUME |
- |
Displays all TSE-VOLs associated with pools, as bitmaps. |
The following example shows the LISTDATA command for volume FCF6B6. For descriptions of the VOLUME and UNIT parameters, see the IBM® z/OS® DFSMS Access Method Services Commands.
LISTDATA SPACEEFFICIENTVOL VOLUME(FCF6B6) UNIT(3390)
TSE-VOL output from the LISTDATA displays as:
2107 STORAGE CONTROL
SPACE EFFICIENT VOLUME REPORT
STORAGE FACILITY IMAGE ID 002107.900.HTC.75.000000064561
SUBSYSTEM ID X'150D'
..........STATUS...........
REPOSITORY REPOSITORY
DEVICE VOLSER SPACE CONSUMED SIZE EXT POOL ID SIZE
F6B6 FCF6B6 2 1113 007F 5197
TOTAL NUMBER OF SPACE EFFICIENT VOLUME(S): 1
|
Item |
Description |
|---|---|
|
DEVICE |
The device number recognized by the host. |
|
VOLSER |
The serial number of a volume. |
|
REPOSITORY SPACE CONSUMED |
The number of cylinders allocated to this TSE-VOL. The areas used for TSE-VOLs are allocated by page unit (44.8 Cyl per page). The number of cylinders is rounded up to the nearest integer and displayed. |
|
SIZE |
The configured capacity (number of cylinders) of the TSE-VOL. |
|
EXT POOL ID |
A pool ID. |
|
REPOSITORY SIZE |
The effective capacity of the pool (number of cylinders) to which this TSE-VOL is physically provisioned. |
|
TOTAL NUMBER OF SPACE EFFICIENT VOLUME(S) |
The number of TSE-VOLs in the storage system. |
The following example displays the summary information for all pools.
LISTDATA EXTENTPOOLCONFIG VOLUME(FCF6B6) UNIT(3390) SUMMARY
2107 STORAGE CONTROL
EXTENT POOL CONFIGURATION REPORT
STORAGE FACILITY IMAGE ID 002107.900.HTC.75.000000064561
......EXTENT POOL ID 0002 SUMMARY............
REPOSITORY FULL WARNING PERCENTAGE: 30
EXT POOL FULL WARNING PERCENTAGE: 30
EXTENT POOL STATUS
FIXED BLOCK EXT POOL: NO
REPOSITORY CONFIGURED: YES
EXTENT POOL AT WARNING PERCENTAGE: NO
EXTENT POOL FULL: NO
|
Item |
Description |
|
|---|---|---|
| REPOSITORY FULL WARNING PERCENTAGE | Indicates the threshold percentage at which a warning is issued when repository usage reaches the specified percentage. | |
| EXT POOL FULL WARNING PERCENTAGE | Indicates the threshold percentage at which a warning is issued when the extent pool usage reaches the specified percentage. | |
| EXTENT POOL AT WARNING PERCENTAGE | Displays YES if the extent pool usage has exceeded the warning threshold; otherwise NO. | |
|
FIXED BLOCK EXT POOL |
NO (fixed) |
The fixed block pool is not displayed. NO is displayed. |
|
REPOSITORY CONFIGURED |
YES (fixed) |
If the pool exists, YES is displayed. |
|
EXTENT POOL FULL |
YES |
The pool usage amount is 100%. |
|
NO |
The pool usage amount is not full. |
|
The following command displays information for the specified pool ID.
LISTDATA EXTENTPOOLCONFIG VOLUME(FCF6B6) UNIT(3390) EXTENTPOOLID(0)
2107 STORAGE CONTROL
EXTENT POOL CONFIGURATION REPORT
STORAGE FACILITY IMAGE ID 002107.900.HTC.75.000000064561
......EXTENT POOL ID 0000 SUMMARY............
REPOSITORY FULL WARNING PERCENTAGE: 30
EXT POOL FULL WARNING PERCENTAGE: 30
EXTENT POOL STATUS
FIXED BLOCK EXT POOL: NO
REPOSITORY CONFIGURED: YES
EXTENT POOL AT WARNING PERCENTAGE: NO
EXTENT POOL FULL: YES
...EXTENT POOL 0000 DETAILED REPORT....
EXTENT POOL REPOSITORY STATUS
REPOSITORY AT WARNING PERCENTAGE: NO
REPOSITORY FULL: YES
SIZE ALLOCATED
EXTENT POOL 8915 8915
REPOSITORY 8915 8915
|
Item |
Description |
|
|---|---|---|
| REPOSITORY FULL WARNING PERCENTAGE | Indicates the threshold percentage at which a warning is issued when repository usage reaches the specified percentage. | |
| EXT POOL FULL WARNING PERCENTAGE | Indicates the threshold percentage at which a warning is issued when the extent pool usage reaches the specified percentage. | |
| EXTENT POOL AT WARNING PERCENTAGE | Displays YES if the extent pool usage has exceeded the warning threshold; otherwise NO. | |
|
FIXED BLOCK EXT POOL |
NO (fixed) |
The fixed block pool is not displayed. NO is displayed. |
|
REPOSITORY CONFIGURED |
YES (fixed) |
If the pool exists, YES is displayed. |
|
EXTENT POOL FULL |
YES |
The pool usage amount is 100% (full). |
|
NO |
The pool usage amount is not full. |
|
|
REPOSITORY FULL |
YES |
The pool usage amount is 100% (full). |
|
NO |
The pool usage amount is not full. |
|
|
EXTENT POOL SIZE |
- |
The effective capacity of the pool (in cylinders). |
|
EXTENT POOL ALLOCATED |
- |
The number of cylinders allocated to the pool. The pool is allocated in pages. This value is created by converting the number of allocated pages into the number of cylinders. The number of cylinders for one page is 44.8 Cyl, which is displayed as an integer rounded up. |
|
REPOSITORY SIZE |
- |
The effective capacity of the pool (in cylinders). This is the same value as the EXTENT POOL SIZE. |
|
REPOSITORY ALLOCATED |
- |
The number of cylinders allocated to the pool. This is the same value as the EXTENT POOL ALLOCATED. The number of cylinders for one page is 44.8 Cyl, which is displayed as an integer rounded up. |