|
|
|
The Shared Device Activity inquiry provides an overall
picture of the I/O activity for the DASD and magnetic tape
devices that are shared between systems in a sysplex. For
each shared device the report contains one line for each
system that has access to it, and an additional summary line
showing the device activity contributed by all systems in the
sysplex.
INTENDED USE:
The report produces a listing of all systems that have access
to a DASD or magnetic tape device, and a summary line
reflecting the device activity for the entire sysplex. This
summary line can assist with the investigation of bottlenecks
caused by a device delay in the sysplex. The system lines
show each system's share in the bottleneck.
The summary device activity rate and utilization show the
total load on the device. The individual system values show
the share of each system.
REPORT FORMAT:
See Section 3.1.1.18 for an example of the output generated
by the Shared Device Activity report.
DATA SOURCE (file/timespan):
HARDVA at the DETAIL, DAYS, WEEKS or MONTHS timespan.
DATA ELEMENTS USED AND CALCULATIONS:
Consult the SAS source code used to generate this report
in sharedprefix.MICS.SOURCE member:
o @RMFSDV1 - for all systems generating the SMF type 74
subtype 1 record.
HOW TO PRODUCE THE REPORT:
o Enter the CA MICS Workstation Facility (MWF).
o Choose option 2, CA MICS Information Center Facility
(MICF).
o Choose option 2, Database Inquiries.
o Select RMFLPS, whose Catalog Group is PERFORM.
o Complete the MICF Execution panel. (If you are not
familiar with MICF, see the MICF User Guide and the MICF
Reference Guide.)
o Complete the specification panel illustrated below.
(Descriptions of the fields follow the panel.)
+----------------------------------------------------------------------+ |------------ Post Processor Shared Device Activity Report ----------| | Command ===> | | | | Composing Inquiry: RMFLPS - Post Processor Shared Device Act. | | Database ===> ___________ | | Cycle(s) ===> __ - __ | | Timespan ===> ______ (DETAIL/DAYS/WEEKS/MONTHS) | | | | Data Selection: | | dd mmm yy dd mmm yy dd mmm yy dd mmm yy | | Date ===> __ ___ __ - __ ___ __ __ ___ __ - __ ___ __ | | Hour ===> __ - __ | | Zone ===> _ _ _ _ _ _ _ _ _ | | Sysid ===> ____ ____ ____ ____ ____ ____ ____ ____ ____ ____ | | | | Summarization Break Variable ===> ________ | | Summarization Technique ===> _________ (DETAIL or COMPOSITE) | | | | SAS Subsetting Statements ===> | | _______________________________________________________________ | | | | Specify Extended Options ===> N (Y/N/R) | +----------------------------------------------------------------------+
Database - Required. No default.
Specify up to six database unit IDs (the IDs of the
CA MICS database units from which the files are read).
If CA MICS files exist in only one database unit, this
parameter is set automatically. To display a selection
list of valid database unit IDs, specify ? (question
mark).
Cycle(s) - Required. Defaults to 01.
00-99 in either data entry field; leading zeros are
inserted automatically. The CA MICS files cycle
(specify first field) or cycle range (specify both
fields) for the inquiry execution.
Timespan - Required. Defaults to DAYS.
The timespan of the CA MICS database from which the
primary input files are selected. See Chapter 3 for a
listing of file requirements by report. The CA MICS
required input files must be available at the specified
timespan.
Date - Optional. No default.
Up to two date ranges in DD MMM YY format. The first
value in each date range is the starting date and the
last value is the ending date. The ending date must be
higher than the starting date. The date ranges should
not overlap, but you can specify the higher range
before the lower range. An input observation is
selected if its date value is greater than or equal to
the starting date and is less than or equal to the
ending date of any specified date range.
Hour - Optional. No default.
An hour range from 0 to 23. The first value is the
starting hour and the last value is the ending hour.
The ending hour must be higher than the starting hour.
An input observation is selected if its hour value is
greater than or equal to the starting hour and is less
than or equal to the ending hour of the specified hour
range.
Zone - Optional. No default.
One-character zone value from 1 to 9. You can specify
up to nine zone values. An input observation is
selected if its zone value is equal to any of the
specified values.
SYSID - Optional. No default.
1-4 character SYSID value. You can specify up to ten
SYSIDs. An input observation is selected if its SYSID
value is equal to any of the specified values.
Summarization Break Variable - Optional. No default.
Data element name to be used as control-break variable.
Valid entries are STARTTS, HOUR, ZONE, DAY, WEEK,
MONTH, YEAR, and SYSID. CA MICS summarization
facilities are used to preprocess the files used by the
report programs. These facilities allow that a data
element be defined as a control-break variable, and
that the summarized file(s) are sorted so the break
variable is last in the sort key list. A single
summarized observation is then written from multiple
observations, with the same break variable value,
whenever the break variable value changes.
Summarization Technique - Required. Defaults to DETAIL.
Specify DETAIL to cause the input files to be processed
and reported in date/time order, or COMPOSITE to force
ALL occurrences of the same value of the summarization
break variable to be summarized and reported together.
See section 3.1.2.1.4 for a more detailed explanation
of the summarization control techniques.
SAS Subsetting Statements - Optional. No default.
Free-form user-supplied SAS code. During the creation
of the work files used to generate the reports,
user-defined SAS code may be included to modify or
subset the data.
IMPORTANT: No validity checking is done on the
user-defined code. If it contains syntax or logic
errors, the inquiry will either terminate abnormally or
will produce unpredictable results.
Examples of valid statements:
IF SYSID EQ "SYS1";
IF DEVTYPE EQ: "3390";
Specify Extended Options - Required. Defaults to N (No).
This parameter is used to specify extended options
parameters for the inquiry function. It is displayed
at the bottom of the panel. Specify Y to display the
Extended Options Menu. Extended options parameters are
used to perform additional selections for the report
being defined. Extended options are never required;
default values are provided. A flag will appear to the
right of this parameter if ANY extended option has been
specified. To restore the extended options to their
default values, specify R (Reset).
o Optionally, complete the extended option panel
illustrated below. (Descriptions of the fields follow
the panel.)
+----------------------------------------------------------------------+ |--------------- Post Processor Shared Device Activity Report -------| | Command ===> | | | | Extended Options for: RMFLPS - Post Processor Shared Device Act. | | | | Include the Following Device Classes in Report: | | Direct Access Storage Devices (DASD) ===> Y (Y/N) | | Magnetic Tape Devices (TAPE) ===> Y (Y/N) | | | | Additional Devices to Include in Report: | | Device Number List ===> ____ ____ ____ ____ ____ ____ ____ | | or/and | | Device Range(s) ===> ____ - ____ ____ - ____ ____ - ____ | | | | Devices to Exclude from Report: | | Device Number List ===> ____ ____ ____ ____ ____ ____ ____ | | or/and | | Device Range(s) ===> ____ - ____ ____ - ____ ____ - ____ | +----------------------------------------------------------------------+
Include the Following Device Classes in Report:
Specify N for the classes of devices you do not want to
see in your report. The default report includes both
DASD and TAPE device classes.
Additional Devices to Include in Report:
You can specify up to seven individual device addresses
or/and four device address ranges, in hexadecimal, to
include in your report, regardless of the device class
they belong to. For example, you can produce a report
containing all your DASD devices and only specific
magnetic tape units in the range of B500 to B5FF. The
extended options will look like:
+-------------------------------------------------------+ | Include the Following Device Classes in Report: | | Direct Access Storage Devices (DASD) ===> Y (Y/N) | | Magnetic Tape Devices (TAPE) ===> N (Y/N) | | | | Additional Devices to Include in Report: | | Device Number List ===> ____ ____ ____ ____ | | or/and | | Device Range(s) ===> B500 - B5FF ____ - ____ | +-------------------------------------------------------+
Devices to Exclude from Report:
You can specify up to seven individual device addresses
or/and four device address ranges, in hexadecimal, to
exclude from the report. For example, you can produce
a report containing all your shared DASD devices except
the ones in the range of 1700 to 17FF. The extended
options will look like:
+-------------------------------------------------------+ | Include the Following Device Classes in Report: | | Direct Access Storage Devices (DASD) ===> Y (Y/N) | | Magnetic Tape Devices (TAPE) ===> N (Y/N) | | | | Additional Devices to Include in Report: | | Device Number List ===> ____ ____ ____ ____ | | or/and | | Device Range(s) ===> ____ - ____ ____ - ____ | | | | Devices to Exclude from Report: | | Device Number List ===> ____ ____ ____ ____ | | or/and | | Device Range(s) ===> 1700 - 17FF ____ - ____ | +-------------------------------------------------------+
USAGE CONSIDERATIONS:
This inquiry provides a user exit that you can use to perform
additional data selection from the CA MICS database. To
invoke this exit, you must first copy the shared inquiry into
your private MICF catalog, then select it for modification.
Finally code SAS statements in the SELECT macro, bracketed by
the %MACRO and %MEND statements.
The default for the SELECT macro is null. This macro is
invoked when the observations are read from the specified
CA MICS file(s). You can use it to delete observations from
the data as it is selected. For example, in a system
activity study, you might want to exclude test systems
starting with a T from the analysis. You would then code
the following:
%MACRO SELECT;
IF SYSID NE: 'T';
%MEND SELECT;
Note that you do not have to code the %MACRO and %MEND
statements, as they are already provided for you.
IMPORTANT: You must code each specified SAS statement in
accordance with the syntax of the SAS Macro Language, as
described in the SAS manuals. No validity checking is done
on the defined code. If the user code contains syntax or
logic errors, the inquiry will either terminate abnormally or
will produce unpredictable results.
************************************************************
** Note: This report cannot be produced if the CA MICS **
** database contains essential data elements only.**
************************************************************
| Copyright © 2012 CA. All rights reserved. | Tell Technical Publications how we can improve this information |