COUNTS|STATUS|PINNED|DSTATUS|ACCESSCODE|+SPACEEFFICIENTVOL|EXTENTPOOLCONFIG

specifies that an operator message with the remote access code is issued or if any of the following reports are printed:

• Subsystem counters report
• Subsystem status report
• Pinned track to data set cross reference report
• Device status report
• Space efficient volume status report
• Extent pool configuration status report

COUNTS

specifies that a Subsystem Counters report be printed. This parameter is the default. Abbreviation: CNT

Note: COUNTS can be used with DEVICE, SUBSYSTEM, or ALL.

STATUS

specifies that a Subsystem Status report be printed.

Abbreviation: STAT

Note:

1. STATUS can be issued to an offline device by using the UNITNUMBER parameter.
2. STATUS can be used with WTO parameters
3. The data returned on a 3990 IDCAMS LISTDATA STATUS command equals the total cache size. The data returned on a 2105 or 2107 control unit only returns the CACHEing information associated with the device. The complete size of CACHE must have 2 device requests done, one for each cluster of the control unit. See APAR OA34771 for more details.

PINNED (*)

specifies that a Pinned Data Status report be printed. The basic syntax is :

 LISTDATA PINNED FILE(XYZ) ALL|SUBSYSTEM|DEVICE

Abbreviation: PIN

Note:

1. PINNED can be used with DEVICE, SUBSYSTEM, or ALL.
2. PINNED DEVICE can be issued to an offline device by using the UNITNUMBER parameter.
3. The LISTDATA PINNED report produced in z/OS® V1R10 identifies a range of pinned tracks associated with a data set. In prior releases the report listed each individual track and its associated data set name.
4. In z/OS V1R10, a 28-bit cylinder address, X'CCCCcccH', is used in the display. The 'ccc' are the high order 12-bits of the cylinder address and 'CCCC' are the low order 16-bits of the cylinder address. The 'H' is the 4-bit track address. The 'F' column in the display with an '*' value will designate when a 28-bit cylinder address is greater than 65535 (X'FFFF').

DSTATUS (*)

specifies that a Device Status report with device identifier, channel connection addresses (CCA), and director-to-device connection (DDC) addresses is printed.

Abbreviation: DSTAT

Note:

1. DSTATUS can be used with DEVICE, SUBSYSTEM, or ALL.
2. DSTATUS does not show offline devices. To show offline devices, use the STATUS and UNITNUMBER parameters.

ACCESSCODE

specifies that the remote access authorization code is sent to the operator's console in message IDC01557I. The WTO message is issued for all storage clusters in the Storage Control.

Abbreviation: ACODE

Note:

1. ACCESSCODE can also be used with the 3990 and 9390 Models 1 and 2.
2. ACCESSCODE can be issued to an offline device by using the UNITNUMBER parameter.
3. On the operator panel, the storage cluster modem switch must be set to Enable for the storage cluster to which the command is directed. If the modem switch is not set to Enable, the Storage Control does not generate a remote support access code and IDC21558I is issued.
4. The remote support access code can be used to establish one remote support session within one hour of the time the code is generated. If a remote support session is not established within one hour, the Storage Control invalidates the remote support access code.
5. RACF* READ access authority to the FACILITY class resource STGADMIN.IDC.LISTDATA.ACCESSCODE is required to use the ACCESSCODE parameter.
6. The storage cluster modem switch must be in the ENABLE position to generate an access code.

SPACEEFFICIENTVOL(*)

specifies a report of the Space Efficient (SE) status of the Space Efficient volume or volumes specified by DEVICE, SUBSYSTEM or ALL. A scope of DEVICE will report the SE volume status of the device where the command was issued. A scope of SUBSYSTEM will report the SE volume status for every online Space Efficient Volume attached to the LSS where the addressed device is attached. A scope of ALL will report the SE status of every online space efficient volume. If no scope is specified, 'ALL' will be used as the default.

Note that if a FlashCopy® withdraw with space release was done recently prior to generating the LISTDATA report, the report might make it look as if there is still repository space consumed. This is because the release is done asynchronously as a lower priority task in the control unit.

Abbreviation: SEV|SEVOL|SEVOLUME

Note: SPACEEFFICIENTVOL can be used with DEVICE, SUBSYSTEM, or ALL.

EXTENTPOOLCONFIG(*)

specifies a configuration status report of the extent pools configured to the subsystem.

Abbreviation: EPC|EPCONFIGURATION|EPCONFIG

DEVICE|SUBSYSTEM|ALL

specifies the scope of the Subsystem Counters report, Pinned Track report, or the Service Status report. One of these parameters is specified when the COUNTS, PINNED, or DSTATUS parameter is specified.

DEVICE

specifies that only the addressed device is included in the Subsystem Counters report, Pinned Track report, or the Device Status report. Abbreviation: DEV

SUBSYSTEM

specifies that all devices within the subsystem are included in the Subsystem Counters report, Pinned Track report, or Device Status report. Abbreviation: SSYS or SUBSYS

ALL

specifies that all devices on all like Storage Control models are included in the Subsystem Counters report, Pinned Track report, or the Device Status report. ALL is the default parameter when the COUNTS, DSTATUS or PINNED parameter is specified.

LEGEND|NOLEGEND

specifies whether a legend be printed at the completion of the requested report.

LEGEND

specifies that the headings and any abbreviations used in the report are listed. LEGEND can be specified for all printed reports. Abbreviation: LGND

NOLEGEND

specifies that the headings and any abbreviations used in the report are not listed. NOLEGEND is the default parameter value. Abbreviation: NOLGND

OUTFILE(ddname)

specifies the name of a DD statement identifying the data set used to contain the report. For ddname, substitute the name of the DD statement identifying the data set. Abbreviation: OFILE

OUTDATASET(dsname)

specifies the name of the alternate target data set. For dsname, substitute the name of the data set to be used. The data set name must be cataloged. Abbreviation: ODS or OUTDS

Note:

1. Erase the previous alternate target data set before specifying the OUTDATASET parameter. If you do not erase the old data set, your reports can be inaccurate. If a report seems to be in error, compare the time field with the time the job was submitted.
2. OUTFILE or OUTDATASET can be specified for all printed reports.

WTO

WTO as used with LISTDATA STATUS specifies that information on the overall condition of the subsystem is sent to the system console and a full report is printed. For 3990 or 9390, other status messages can appear on the system console. That is, a message indicating the status of NVS and DASD fast write appears. If the addressed device is one of a duplex pair, a status message on the pair appears. Abbreviation: None

LSS(lssid)

This subparameter of the DEVICE parameter specifies the FB LSS for which the space efficient volume status request is being issued. The valid value for lssid is a two hexidecimal character number in the range 00-FE. The CKD addressed device specified in the VOLUME or FILE or UNITNUMBER keyword provides orientation to a Storage Facility where the desired fixed block device resides in the device to where the CKD channel program is issued against.

FBDEV(devicenumber)

specifies the device for which the space efficient volume status report is requested. This is a subparameter of the DEVICE parameter. This device resides in the FB LSS identified in the LSS keyword. The valid value for devicenumber is two hexadecimal characters in the range 00-FF.

SUMMARY|EXTENTPOOLID(id)

specifies a summary report or a detailed report for a specific Extent Pool. The SUMMARY report will provide a summary report for each of the Extent Pools configured on the subsystem. A detailed report for a specific Extent Pool can be obtained by specifying EXTENTPOOLID on the request. A volume map report for Space Efficient CKD or FB volume(s) in either all of the even LSS’s or all of the odd LSS’s can be obtained by specifying MAPVOLUME with EXTENTPOOLID on the request.

MAPVOLUME

specifies a volume map report for Space Efficient CKD or FB volume(s) associated with a specific Extent Pool. The volume map will contain either all of the even LSS's or all of the odd LSS's devices depending on the EXTENTPOOLID used in the request.

Use the following rules for specifying parameters for space efficient volume status report and extent pool configuration report.