DEVICE

Read syntax diagramSkip visual syntax diagram
   .-DEVICE(DASD)-----------.   
>>-+------------------------+----------------------------------><
   |         .-,--------.   |   
   |         V          |   |   
   +-DEVICE(---| Type |-+-)-+   
   '-NODEVICE---------------'   

Type

   .-NONMBR-----.  .-DASD---.  .-NOCHRDR-.  .-NOCOMM-.   
|--+------------+--+--------+--+---------+--+--------+---------->
   '-NMBR(nmbr)-'  '-NODASD-'  '-CHRDR---'  '-COMM---'   

   .-NOGRAPH-.  .-NOTAPE-.  .-NOUNITR-.  .-NOSG---.   
>--+---------+--+--------+--+---------+--+--------+-------------|
   '-GRAPH---'  '-TAPE---'  '-UNITR---'  '-SG(sg)-'   

Specifies whether device activity is to be measured. You can request device activity by specifying all devices within one or more classes, or, optionally, one or more specific devices within each class. If you specify DEVICE, however, you must include an option; you need only include the classes you want to add to the default (DASD) or the specific device number you want data for.

Type is one of the following:
  • One or more device numbers:
           ({aaaa          })
    {NMBR} ({aaaa,bbbb:zzzz})/NONMBR
           ({aaaa,bbbb,... })

    NMBR requests specific device numbers, where aaaa, bbbb, and zzzz each represent hexadecimal device numbers. You can omit leading zeros. You can specify any combination of a single device number, in the format aaaa, a list of device numbers, in the format aaaa,bbbb, or a range of numbers in the format bbbb:zzzz, where bbbb is your first number and zzzz is your last number. You can not exceed 32 characters, including commas and colons. When you specify a range of numbers, use a colon as a separator to indicate that the report is to consist of all numbers from bbbb up to and including zzzz.

    NONMBR, when specified, cancels any existing list of device numbers.

  • Any of the following classes:
    CHRDR/NOCHRDR
    Character reader devices
    COMM/NOCOMM
    Communications equipment
    DASD/NODASD
    Direct access storage devices
    GRAPH/NOGRAPH
    Graphics devices
    TAPE/NOTAPE
    Magnetic tape devices
    UNITR/NOUNITR
    Unit record devices
  • One or more storage groups:
         ({aaaaaaaa                  })
    {SG} ({aaaaaaaa,bbbbbbbb,...     })/NOSG
         ({aaaaaaaa,bbbbbbbb:zzzzzzzz})
    SG requests specific storage group names, where aaaaaaaa, bbbbbbbb, and zzzzzzzz each represent 1 to 8 character names. You can specify any combination of a single storage group name, in the format aaaaaaaa, a list of names, in the format aaaaaaaa,bbbbbbbb,..., or a range of names, in the format bbbbbbbb:zzzzzzzz. Your entry can not exceed 32 characters, including commas and colons. When you specify a range of storage group names, use a colon as a separator to indicate that the report is to include all of the names from bbbbbbbb up to and including zzzzzzzz.

    NOSG, when specified, cancels any existing lists of storage group names.

    RMF™ always reports the storage group name of a volume when the volume is a member of a storage group, even if the SG suboption has not been selected. If the volume is added or deleted from a storage group, or if the storage management subsystem is not active, the storage group name may not be reported. If a volume does not belong to a storage group, the storage group field for that volume is blank, and it appears at the top of the report.

Here are some examples of how to specify the DEVICE option.

Examples:
  • To request device reporting for magnetic tape devices 0180, 0183, 0184, 0185, and 0188 as well as all direct access devices and communication equipment, you would specify:
    DEVICE(COMM,NMBR(0180,0183:0185,0188))
    You do not need to specify DASD, because this is the default value.
  • To request device reporting for magnetic tape devices and DASD you would specify:
    DEVICE(TAPE)

    To limit the reporting of DASD, you must specify NODASD and use the NMBR field to identify those devices you want to monitor.

    Note: For more information on non-DASD/TAPE measurement, refer to the CMB parameter in IEASYS in z/OS MVS Initialization and Tuning Reference.
  • If you request the following:
    DEVICE(NODASD, NMBR(0288,0291), SG(PROC01:PROC05))

    the device report is divided into two parts. The first part of the report contains the devices specified by the NMBR suboption and is sorted by LCU and device number. The second part contains the devices specified for the SG suboption and is sorted by storage group and the device numbers within the group. Because you can specify a device on the NMBR suboption that is part of a storage group specified on the SG suboption, some devices might be reported twice.