The LISTDATA command displays information about ESE-VOLs or pools in the storage system. Pool information refers to information about pools for Dynamic Provisioning for Mainframe. Information about other pools is not displayed. The following table lists the parameters for the LISTDATA command.
| Type | Function | Description | |
|---|---|---|---|
| VOLSPACE | DEVICE | Displays information about ESE-VOLs in the device to which the command was issued. | |
| SUBSYSTEM | Displays information about ESE-VOLs in the storage system to which the command was issued. | ||
| ALL | Displays information about ESE-VOLs in all connected storage systems. If the display range is not specified, ALL is set. | ||
| EXTENTPOOL CONFIG |
SUMMARY | Displays summary information about all pools. | |
| EXTENTPOOL ID (ID) |
- | Displays detailed information about the specified pool ID. | |
| MAPVOLUME* | Displays all ESE-VOLs associated with the pool in bit map format, in addition to the detailed information about the specified pool ID. | ||
| MAPVOLUME* | - | Displays all ESE-VOLs associated with the pool in bitmap format. | |
| * When you specify MAPVOLUME, specify the ESE-VOLs that belong to the pool. If SOM 1256 is enabled and the pool has ESE-VOLs for which even and odd numbers are mixed for the associated CU number and the pool ID, you need to run the command twice. Run the command by specifying the ESE-VOLs for which the associated CU numbers are even numbers. Also, run the command by specifying the ESE-VOLs for which the associated CU numbers are odd numbers. | |||
The following is an example of using the LISTDATA command. In this example, the command is issued to the volume whose VOLSER number is FCF6B6.
Display example of the LISTDATA command for ESE-VOL information
LISTDATA VOLSPACE VOLUME(FCF6B6) UNIT(3390)
When you issue this command, the specified ESE-VOL information is displayed as follows:
Display example of the LISTDATA command for ESE-VOL information
2107 STORAGE CONTROL
VOLUME SPACE REPORT
STORAGE FACILITY IMAGE ID 002107.985.IBM.75.0000000GZY11
SUBSYSTEM ID X'0A00'
..........STATUS...........
EXTENT
DEVICE VOLSER CAPUSED CAP POOL ID SAM
152F FCF6B6 1008 1182006 0004 ESE
Note that information might not be displayed if there is an I/O on the target volume. In this case, run the command again or retry at a time when there is no I/O.
The following table shows the items displayed by the LISTDATA command for ESE-VOL information.
| Item | Description |
|---|---|
| DEVICE | Device number recognized by the host |
| VOLSER | Serial number of a volume |
| CAPUSED1 | Number of cylinders allocated to this ESE-VOL, including control areas and reserved capacity When the subscription limit is set, the reserved page capacity is not included. Even if the pages are released by the User Directed Space Release function, the reserved page capacity is not added to the free space of the pool. The areas used for ESE-VOLs are allocated by page unit (44.8 Cyl per page). The number of cylinders is rounded up to the nearest integer and displayed. |
| CAP1 | Capacity of this ESE-VOL (the number of cylinders) |
| EXTENT POOL ID1 | Pool ID |
| SAM2 | Volume attribute ESE: ESE-VOL |
Notes:
|
|
Example of the LISTDATA command for pool information (summary)
LISTDATA EXTENTPOOLCONFIG VOLUME(FCF6B6) UNIT(3390) SUMMARY
When you issue this command, the summary information of all pools is displayed as follows.
Display example of the LISTDATA command for pool information (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
SGC BACKUP VOLUMES CONFIGURED: NO
The following table shows the items displayed by the LISTDATA command for pool information (summary).
| Item | Value | Description |
|---|---|---|
| REPOSITORY FULL WARNING PERCENTAGE | - | The value obtained by subtracting the warning value of the user-defined threshold from 100. |
| EXT POOL FULL WARNING PERCENTAGE | - | The value obtained by subtracting the warning value of the user-defined threshold set from 100. This item displays the same value as REPOSITORY FULL WARNING PERCENTAGE. |
| FIXED BLOCK EXT POOL | NO (fixed) | NO is displayed. |
| REPOSITORY CONFIGURED | YES | A TSE-VOL exists. |
| NO | A TSE-VOL does not exist. | |
| EXTENT POOL AT WARNING PERCENTAGE | YES | The warning value of the user-defined threshold is reached. |
| NO | The warning value of the user-defined threshold is not reached. Alternatively, the used pool capacity becomes full after the user-defined threshold warning value was reached. | |
| SGC BACKUP VOLUMES CONFIGURED | NO (fixed) | NO is displayed. |
Example of the LISTDATA command for pool information (detail)
LISTDATA EXTENTPOOLCONFIG VOLUME(FCF6B6) UNIT(3390) EXTENTPOOLID(0)
When you issue this command, the pool information of the specified pool is displayed as follows:
Display example of the LISTDATA command for pool information (detail)
2107 STORAGE CONTROL
EXTENT POOL CONFIGURATION REPORT
STORAGE FACILITY IMAGE ID 002107.900.HTC.95.000000090526
......EXTENT POOL ID 007D SUMMARY............
REPOSITORY FULL WARNING PERCENTAGE: 30
EXT POOL FULL WARNING PERCENTAGE: 30
EXTENT POOL STATUS
FIXED BLOCK EXT POOL: NO
REPOSITORY CONFIGURED: NO
EXTENT POOL AT WARNING PERCENTAGE: NO
SGC BACKUP VOLUMES CONFIGURED: NO
...EXTENT POOL 007D DETAILED REPORT VERSION 1....
EXTENT POOL REPOSITORY STATUS
REPOSITORY AT WARNING PERCENTAGE: NO
REPOSITORY FULL: NO
SIZE ALLOCATED
EXTENT POOL 5022080 222925
REPOSITORY 0 0
The following table shows the items displayed by the LISTDATA command for pool information (detail).
| Item | Value | Description |
|---|---|---|
| REPOSITORY FULL WARNING PERCENTAGE | - | The value obtained by subtracting the warning value of the user-defined threshold from 100. |
| EXT POOL FULL WARNING PERCENTAGE | - | The value obtained by subtracting the warning value of the user-defined threshold from 100. This item displays the same value as REPOSITORY FULL WARNING PERCENTAGE. |
| FIXED BLOCK EXT POOL | NO (fixed) | NO is displayed. |
| REPOSITORY CONFIGURED | YES | A TSE-VOL exists. |
| NO | No TSE-VOLs exist. | |
| EXTENT POOL AT WARNING PERCENTAGE | YES | The warning value of the user-defined threshold is reached. |
| NO | The warning value of the user-defined threshold is not reached. Alternatively, the used pool capacity becomes full after the user-defined threshold warning value was reached. | |
| SGC BACKUP VOLUMES CONFIGURED | NO (fixed) | NO is displayed. |
| REPOSITORY AT WARNING PERCENTAGE | YES | The warning value of the user-defined threshold is reached. |
| NO | The warning value of the user-defined threshold is not reached. Alternatively, the used pool capacity becomes full after the user-defined threshold warning value was reached. | |
| REPOSITORY FULL | YES | The used pool capacity is full. |
| NO | The used pool capacity is not full. | |
| EXTENT POOL SIZE | - | Pool capacity (the number of cylinders) |
| EXTENT POOL ALLOCATED | - | The number of cylinders allocated to the pool. The number of allocated pages is converted to the number of cylinders because cylinders are allocated to the pool area page by page. The number of cylinders for one page is 44.8 Cyl. |
| REPOSITORY SIZE | - |
If TSE-VOLs are included, the capacity of the pool (the number of cylinders, and the same value as EXTENT POOL SIZE) is displayed. If no TSE-VOL is included, 0 (zero) is displayed. |
| REPOSITORY ALLOCATED | - |
If TSE-VOLs are included, the number of cylinders allocated to the pool (the same value as EXTENT POOL ALLOCATED) is displayed. The number of cylinders for one page is 44.8 Cyl. If no TSE-VOL is included, 0 (zero) is displayed. |
Example of the LISTDATA command for pool information (ESE-VOLs in bit map format)
LISTDATA EXTENTPOOLCONFIG VOLUME(QA7E00) UNIT(3390) EXTENTPOOLID(127) MAPVOLUME
When you issue this command, the pool information of the specified pool is displayed as follows. The meanings of the displayed items are described in the previous table and the table following the next examples.
Display example of the LISTDATA command for pool information (ESE-VOLs in bit map format)
2107 STORAGE CONTROL
EXTENT POOL CONFIGURATION REPORT
STORAGE FACILITY IMAGE ID 002107.900.HTC.95.000000090526
......EXTENT POOL ID 007F SUMMARY............
REPOSITORY FULL WARNING PERCENTAGE: 30
EXT POOL FULL WARNING PERCENTAGE: 30
EXTENT POOL STATUS
FIXED BLOCK EXT POOL: NO
REPOSITORY CONFIGURED: NO
EXTENT POOL AT WARNING PERCENTAGE: NO
SGC BACKUP VOLUMES CONFIGURED: NO
...EXTENT POOL 007F DETAILED REPORT VERSION 1...
EXTENT POOL REPOSITORY STATUS
REPOSITORY AT WARNING PERCENTAGE: NO
REPOSITORY FULL: NO
SIZE ALLOCATED
EXTENT POOL 3346560 717
REPOSITORY 0 0
ESE
VOLUME MAP
--------------------------------- VOLUME BIT MAP -------------
LSS 0 - 1F 20 - 3F 40 - 5F 60 - 7F 80 - 9F
------- --------- --------- --------- --------- ---------
X'00FD' FFFF 0000 0000 0000 0000 0000 0000 0000 0000 0000
-------------------------------
A0 - BF C0 - DF E0 - FF
--------- --------- ---------
0000 0000 0000 0000 0000 0000
NOTE:1 BIT REPRESENTS SPACE EFFICIENT CKD OR FB VOLUME.
THE BIT POSITION IN HEX NUMBER REPRESENTS VOLUME NUMBER.
AN "LSS" ROW IS ONLY DISPLAYED IF AT LEAST ONE BIT IS ON IN THIS
ROW.
MAPPING FROM DEVICE TO VOLUME BIT MAP
HOST SUBSYSTEM
CONFIGURATION CONFIGURATION
------------- --------------
DEV VOLSER SSID LSS VOL
------------- --------------
7E00 QA7E00 B6FD 00FD 0000
7E01 QA7E01 B6FD 00FD 0001
7E02 QA7E02 B6FD 00FD 0002
7E03 QA7E03 B6FD 00FD 0003
7E04 QA7E04 B6FD 00FD 0004
7E05 QA7E05 B6FD 00FD 0005
7E06 QA7E06 B6FD 00FD 0006
7E07 QA7E07 B6FD 00FD 0007
7E08 QA7E08 B6FD 00FD 0008
7E09 QA7E09 B6FD 00FD 0009
7E0A QA7E0A B6FD 00FD 000A
7E0B QA7E0B B6FD 00FD 000B
7E0C QA7E0C B6FD 00FD 000C
7E0D QA7E0D B6FD 00FD 000D
7E0E QA7E0E B6FD 00FD 000E
7E0F QA7E0F B6FD 00FD 000F
The following table shows the items displayed by the LISTDATA command for pool information (ESE-VOLs in bit map format).
| Item | Description | |
|---|---|---|
| VOLUME BIT MAP | LSS | Displays the CU numbers of the ESE-VOLs that belong to the pool. |
|
00-1F to E0-FF |
Displays the LDEV numbers of the ESE-VOLs that belong to the pool. If an ESE-VOL exists, the bit that corresponds to the LDEV number is set. Example: When the LDEV number is 0x00, the following value is displayed: 8000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 Example: When the LDEV number is 0xFF, the following value is displayed: 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0001 |
|
|
MAPPING FROM DEVICE TO VOLUME BIT MAP |
DEV | Displays the addresses (on the host configuration) of the LDEVs that belong to the pool. |
| VOLSER | Displays the VOLSER values (on the host configuration) of the LDEVs that belong to the pool. | |
| SSID | Displays the SSIDs of the LDEVs that belong to the pool. | |
| LSS | Displays the CU numbers of the LDEVs that belong to the pool. | |
| VOL | Displays the LDEV numbers of the LDEVs that belong to the pool. | |