DEVACT


The DEVACT control statement requests the Device Activity Report.

DEVACT
[TYPE={ALL|DASD|TAPE|COMM|GRAPH|UNITR|CHRDR}]
[STORGRP={(*|xxxxxxxx[:xxxxxxxx]1,…,xxxxxxxx[:xxxxxxxx]16)}]
[,RANGE=(xxxxx[:xxxxx]1,…,xxxxx[:xxxxx]16)]
[,ORDER={LCU|DEVICE|STORGRP}]

You can define a specific class of device for this report, or the Device Activity Report is generated for each class of device encountered in the input data.

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

Parameters

The parameters for the DEVACT control statement are as follows:

TYPE=

Specifies the class of device for which the Device Activity report is to be produced

The default is ALL, unless the STORGRP parameter is present, in which case the default is DASD.

STORGRP=

Specifies up to 16 SMS storage group names, or ranges of names, to be reported

Storage group names must be one to eight alphanumeric characters. Ranges of names are specified as two names separated by a colon (:). The first name in a range must precede the second in the standard collating sequence.

Single names and multiple ranges of names can be specified, separated by commas.

STORGRP=* can be used to indicate that ALL storage groups are to be reported. (STORGRP=* is the default.)

RANGE=

Specifies up to 16 devices or device ranges to be reported

Device addresses must be entered as either three, four, or five-digit hexadecimal values. Device ranges are specified as two addresses separated by a colon (:).

The first address in a range must be less than the second address. Single devices and multiple ranges can be specified, separated by commas.

ORDER=

Specifies the order in which devices are reported

  • If LCU is specified, devices are reported by Logical Control Unit number and device number.
  • If STORGRP is specified, the order is storage group name and device number.
  • If DEVICE is specified, the order is strictly by device number.

The default is LCU, unless the STORGRP parameter is present, in which case the default is STORGRP.

Usage notes

The TYPE, STORGRP, and RANGE parameters are filters; that is, they are used to select the devices which are to be reported. Filtering is additive, meaning that if two or more filters are specified, the data must pass all filters to be included in the report. For example, if TYPE=TAPE,RANGE=(100:300) is specified, only tape devices whose numbers are between 100 and 300 are reported.

However, when STORGRP= is specified, any TYPE parameter is ignored and TYPE=DASD is forced.

When the STORGRP parameter is used, only those devices pertaining to the named storage groups are included in the report. If no storage group names are found in the input data, the following message is issued:

CMF07830: NO DATA AVAILABLE FOR THIS REPORT

When the RANGE parameter is used, only those devices specified are included in the report. If none of the specified device addresses are found in the input data, message CMF07830 is issued.

When both STORGRP= and RANGE= are specified, a device must meet both criteria in order to be reported. If none do, message CMF07830 is issued.

Examples

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

Example
DEVACT TYPE=DASD

This example produces the Device Activity Report for all DASD devices.

Example
DEVACT RANGE=(5600,19000:1A000)

This example produces the Device Activity Report for the following: device 5600 and devices 19000 to 1A000.

Example
DEVACT  STORGRP=*

This example produces the Device Activity Report for all DASD devices that are in SMS storage groups. The report is ordered by the storage group.

Example
DEVACT  STORGRP=(Y:Z,BMC)

This example produces the Device Activity Report for all DASD devices belonging to storage groups whose names are within the rangeY toZ, and for the storage group named BMC. This report is arranged by storage group names.

Example
DEVACT  STORGRP=(ADAMANT:ZZTOP),ORDER=DEVICE

This example produces the Device Activity Report for all DASD devices belonging to storage groups whose names are within the range ADAMANT to ZZTOP. This report is arranged by device number, not by storage group names.


 

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