Default language.

DEVICE

DEVICE
[CLASS=TAPE|COMM|DASD|GRAPH|UNITR|CHRDR|CTC]
[,RANGE=(xxxxx[:xxxxx]1,…,xxxxx[:xxxxx]32)]
[SG={(xxxxxxxx[:xxxxxxxx]1,…,xxxxxxxx[:xxxxxxxx]16)}]
[VOLUME={(xxxxxxxx[:xxxxxxxx]1,…,xxxxxxxx[:xxxxxxxx]32)}]

Related topic

Using-the-CMFMON-write-facility

Overview

This control statement collects data on specified devices. If no operands are specified, data is collected for all online devices. Data is recorded in SMF79 subtype 9 records.

Important

Device data is available only when the CMF Extractor is active with the DEVICE statement in CPM mode. CMFMON collects data only for devices that the CMF Extractor is monitoring. When data is returned, it reflects activity that occurred during the current CMF recording interval.

Parameters

This statement has the following parameters:

CLASS

Limits the data collected to devices of the specified type; the default is to collect data for all devices

Possible values are as follows:

  • TAPE
    magnetic tape devices
  • COMM
    communications devices
  • DASD
    direct access storage devices
  • GRAPH
    graphics devices
  • UNITR
    unit record devices
  • CHRDR
    character reader devices
  • CTC
    channel-to-channel adapters

RANGE

Specifies a range of devices to be measured. Device numbers can be between 3 and 5 digits in length.

The range can consist of a list of single device addresses, a list of device ranges (xxxxx:xxxxx), or a combination of both.

You can specify up to 32 devices or device ranges.

When defining a device number that contains the subchannel set ID, then the specified range will only be monitored on the defined subchannel set. When subchannel set ID is not defined, the specified range will be monitored on all subchannel sets.

Examples
  • DEVICE RANGE=(0AAAA:0BBBB)
    This will monitor devices in the following ranges: 0AAAA:0BBBB
  • DEVICE RANGE=(CCCC:DDDD)
    This will monitor devices in the following ranges:
    • 0CCCC:0DDDD
    • 1CCCC:1DDDD
    • 2CCCC:2DDDD
    • 3CCCC:3DDDD

SG

Up to 16 storage groups or ranges of storage groups for which data is collected; the default is to collect data for all storage groups

VOLUME

Limits the data collected to devices on which the specified volumes is mounted

Up to 32 volumes or ranges of volumes can be specified. The default is to collect data for all volumes.

Examples

DEVICE RANGE=(04999:06500,A1FF:B000,14000)

The CMFMON Write Facility samples the following: device 14000, devices 04999 to 06500, and devices 0A1FF to 0B000, 1A1FF to 1B000, 2A1FF to 2B000, 3A1FF to 3B000.

DEVICE CLASS=DASD,SG=SGROUP01

Data is collected on the DASD devices in storage group SGROUP01.

DEVICE VOLUME=BAB030

Data is collected on the device on which volume BAB030 is mounted.

DEVICE CLASS=COMMDEVICE CLASS=CTC

Two records are produced per interval: one for communications devices, and one for channel-to-channel adapters. This example is equivalent to specifying CLASS=COMM on the CMF Extractor DEVICE statement.



 

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