DEVICE (Extractor control statements)

The DEVICE control statement causes the BMC AMI Ops Monitor for CMF Extractor to measure specified devices for busy and wait status, I/O activity, online and offline times, and volume activity.

DEVICE [ALL]
[,RANGE=(xxxxx[:xxxxx]1,...,xxxxx[:xxxxx]8)]
[,CLASS={DASD|TAPE|UNITR|CHRDR|GRAPH|COMM}]
[,EXCEPT=(xxxxx[:xxxxx]1,...,xxxxx[:xxxxx]8)]
[,OFFLINE={NO|YES}]
[,SAMPLE={1500|nnnn}]

Important

If you want SMF type 74-1 records that are compatible with those produced by RMF, you must specify the CLASS parameter.

Parameters

The parameters for the DEVICE control statement are:

ALL=	Specifies that all online devices in the system are to be measured. The ALL parameter is ignored when CLASS is specified.
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. Device addresses must be entered as either three, four, or five-digit hexadecimal values. You can specify up to eight devices or device ranges. The first device specified for a device range must be a physically attached device. Important The RANGE parameter is ignored when CLASS is also defined in the DEVICE statement. 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
CLASS=	Specifies a class of device to be sampled Only one class can be specified per DEVICE statement. Only the EXCEPT, OFFLINE, and SAMPLE parameters are valid with CLASS. Parameters ALL and RANGE are ignored when CLASS is specified. Important This parameter must also be specified for CMF Online and OpsM for z/OS. If you want SMF type 74 records that are compatible with those produced by RMF, you must specify the CLASS parameter. TAPE—magnetic tape devices (UCBTBYT3 is X'80') COMM—communications equipment (UCBTBYT3 is X'40') DASD—direct access storage devices (UCBTBYT3 is X'20') GRAPH—graphics devices (UCBTBYT3 is X'10') UNITR—unit record devices (UCBTBYT3 is X'08') CHRDR—character reader devices (UCBTBYT3 is X'04') Important If ALL, RANGE, and CLASS are not specified, all online DASDs and tape devices are measured. If a device class other than TAPE or DASD is specified and RMF I/O monitoring is not active, the DEVICE sampler invokes start/stop I/O monitoring through BBXS.
EXCEPT=	Specifies a range of devices to be excluded from measurement activity. 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. This exclusion applies only to the specification on this control statement and has no effect on prior or subsequent control statements. You can specify a maximum of eight devices or device ranges. Device addresses must be entered as either three, four, or five-digit hexadecimal values. 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 EXCEPT=(0AAAA:0BBBB) This will exclude monitoring of devices in the following ranges: 0AAAA:0BBBB DEVICE EXCEPT=(CCCC:DDDD) This will exclude monitoring of devices in the following ranges: 0CCCC:0DDDD 1CCCC:1DDDD 2CCCC:2DDDD 3CCCC:3DDDD
OFFLINE=	Specifies whether data will be collected for offline devices The default is NO. Activity for online devices is always collected. If OFFLINE=NO is specified, activity will be collected for devices that are varied online after the sampler has started.
SAMPLE=	Specifies the number of milliseconds between data gathering cycles for this group of devices The default is 1500. Acceptable values are 20 to 9999.

Examples

Example

DEVICE ALL,EXCEPT=(104,20F,313:41F,70A)

The CMF Extractor samples all online devices (except device addresses 104, 20F, 313 through 41F, and 70A) at the default interval.

Example

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

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

Example

DEVICE RANGE=(201,204:305),SAMPLE=1000

The CMF Extractor samples device addresses 201 and 204 through 305 once every second.

Example

DEVICE SAMPLE=1000

All online DASD and tape devices are measured once per second.

Example

DEVICE SAMPLE=2000,CLASS=UNITR

The CMF Extractor samples all unit record devices every two seconds.

Example

DEVICE CLASS=DASD

The CMF Extractor samples online DASDs only, at the default interval.

Example

DEVICE CLASS=TAPE

The CMF Extractor samples all magnetic tape devices, including all offline-to-online activity, at the default frequency.

Monitoring modes	Any number of DEVICE control statements can be specified for each monitoring mode, continuous (CPM) or intermittent (IPM). Different sample rates can be specified in each DEVICE statement; a high sampling rate can be specified for one device group, and a low rate can be specified for a less active group. However, a single device can be specified only once for each monitoring mode; subsequent duplicate specifications for a device are ignored.
Sampler and record types	The DEVICE statement controls the DEVS sampler, which produces SMF type 74-1 records and CMF type 240-05 user records.
Analyzer statements and reports	CMFSUM DEVACT PERFSUM, PERFORM SHARDEV	CMF Summary Report Device Activity Report Performance Summary Report Shared Device Activity Report
Other BMC Software products	The DEVICE control statement must be defined in the hilevel.UBBPARM CMFxPMxx member, for BMC AMI Ops Monitor for z/OS data collector.

DEVICE (Extractor control statements)

Parameters

Examples

On this page