Default language.

SHARDEV

The SHARDEV control statement requests the Shared Device Activity Report.

SHARDEV
[TYPE=(BOTH|DASD|TAPE)]
[,RANGE=(xxxxx[:xxxxx]1,…,xxxxx[:xxxxx]16)]
[,OFFLINE=(NO|YES)]
[,REPORT=DETAIL|SUMMARY]
[,SORT=VOLSER|DEVNUM]

The Shared Device Activity Report requires data from multiple MVS systems. To collect synchronous data from all systems sharing devices, BMC Software recommends using the SYNCH=SMF parameter of the Extractor REPORT control statement.

The SHARDEV statement uses data collected by the DEVICE Extractor control statement.

Related topics

DEVICE-Extractor-control-statements

Shared-Device-Activity-Report

DATETIME

REPORT

SHIFT

SYSPLEX

Report-control-statements-Analyzer


Important

  • To specify which systems on which devices are shared, you must include the SYSPLEX control statement with RPTS=COMBINED. Issuing the SHARDEV control statement without the controlling SYSPLEX statement results in an error message.
  • To produce interval type reports, you must specify each interval to be reported by using the startshift, endshift time pairs on the SHIFT control statement. You cannot specify RPTS=INTERVAL on the SHIFT statement.
  • To match the logical device on various systems to a physical device, the Analyzer attempts to match devices using the 28-byte device ID, which is returned from self-describing devices. If the device ID contains only zeros, DASD devices are matched using the volume serial number and tape devices are matched using the device address. If a device cannot be matched by using any of these criteria, it does not appear in the report.
  • BMC Software recommends that you use the DATETIME statement to generate a more meaningful report. Without this statement, all records are accepted from each system, regardless of their date/time, which could result in a report that contains many hours or days of data from one system and only a few minutes of data from another system.

Parameters

The parameters for the SHARDEV control statement are as follows:

TYPE=

Specifies whether DASD, tape, or both DASD and tape devices should be included in the report; the default is BOTH

RANGE=

Specifies which devices are reported

Device addresses must be entered as either three, four, or five-digit hexadecimal values. You can specify either the device address or a range of device addresses on this parameter.

The report contains a detail line for each system that shared the device during the reporting interval. Up to 16 devices or ranges of devices can be specified.

If the RANGE parameter is not specified, all shared devices are reported.

OFFLINE=

Specifies whether offline devices should be included in the report; the default is OFFLINE=YES

REPORT=

Specifies the type of report

  • If SUMMARY is specified, one line of information per device appears in the report; it summarizes activity from all of the systems.
  • If DETAIL is specified, additional lines per device appear in the report; each line displays activity from an individual system. The default is DETAIL.

SORT=

Sorts report data

  • If VOLSER is specified, report data is sorted by volser.
  • If DEVNUM is specified, report data is sorted by device number.

If you do not specify the SORT= parameter, report data is sorted by volser.

Examples

The following examples illustrate the use of the SHARDEV control statement.

Example
SYSPLEX SUBPLEX=*,RPTS=COMBINED
SHARDEV

This example produces a Shared Device Activity Report that lists all DASD and tape devices shared between all systems.

Example
SYSPLEX SUBPLEX=*,RPTS=COMBINED
SHARDEV RANGE=(2140,2145)

This example produces a Shared Device Activity report for the two devices at addresses 2140 and 2145.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*